Add Copilot custom instructions and document CI failure root cause

[Copilot]

Copilot Custom Instructions & CI Analysis

Completed Tasks

• Analyzed the dependabot PR (chore(deps): bump the cargo group across 2 directories with 1 update #18) workflow runs
• Identified the only failing check: "Gemini Dispatch" workflow
• Root cause: Missing API credentials (GEMINI_API_KEY or related env vars)
• Reviewed existing project documentation (CLAUDE.md, CLAUDE.local.md)
• Created .github/copilot-instructions.md based on CLAUDE.md
• Created .github/CI-FIX-REPORT.md documenting analysis and recommendations
• Applied review feedback: Updated crate versions and test counts
• Committed all changes to the sub-PR

What Was Created

1. Copilot Custom Instructions (12KB)

File: .github/copilot-instructions.md

Comprehensive guide for GitHub Copilot including:

• Project overview and architecture
• Technology stack with accurate versions (pnet 0.35, clap 4.5, sqlx 0.8)
• All workspace crates including prtip-tui
• Coding standards and style guide
• Development workflow (build, test, lint)
• Security requirements
• Testing guidelines (2,557 tests, 96 ignored)
• CLI design principles
• Documentation structure
• Common patterns and examples
• Pre-commit checklist
• Quick reference commands

2. CI Fix Analysis Report (7KB)

File: .github/CI-FIX-REPORT.md

Detailed analysis covering:

• Workflow Status: 3/4 passing (CI, CodeQL, Dependency Review ✅)
• Failing Workflow: Gemini Dispatch ❌ (missing API credentials)
• Root Cause: Requires GEMINI_API_KEY secret or Google Cloud config
• Impact Assessment: Not a blocking issue - all critical checks pass
• Recommendations: How to configure if desired, or safe to ignore
• Configuration Options: 3 ways to enable (API key, Vertex AI, Code Assist)

Changes Applied from Review

Applied all three suggestions from the code review:

1. Crate versions updated: pnet 0.34→0.35, clap 4.4→4.5, sqlx 0.7→0.8
2. Added missing crate: prtip-tui to project structure list
3. Test count corrected: 73→96 ignored tests

Key Findings

CI Status Summary:

• ✅ CI Workflow: All builds, tests, and lints passing
• ✅ CodeQL: Security scanning passed, no vulnerabilities
• ✅ Dependency Review: rsa 0.9.10 update validated
• ❌ Gemini Dispatch: Missing API credentials (expected, not a code issue)

Conclusion: The only failing check is an optional AI code review feature that requires repository admin configuration. The actual code quality checks are all passing. The rsa dependency update is safe to merge.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[doublegate]

Reviewed / Approved -- DG 1/24

[Copilot]

Pull request overview

This PR adds GitHub Copilot-specific guidance for the project and documents the root cause of a non-blocking CI failure on the Dependabot rsa upgrade PR.

Changes:

• Introduces .github/copilot-instructions.md with project architecture, coding standards, security requirements, workflow expectations, and domain-specific context tailored for Copilot.
• Adds .github/CI-FIX-REPORT.md summarizing the CI status for Dependabot PR #18 and explaining why the Gemini-based AI review workflow is failing safely due to missing credentials.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
.github/copilot-instructions.md	Provides Copilot with a structured overview of the codebase, workflows, and security/testing expectations; a few details (crate versions, workspace crates, test counts) need alignment with current repository state.
.github/CI-FIX-REPORT.md	Documents current CI workflow results and explains that the Gemini Dispatch workflow failure is a configuration/credentials issue, not a code or dependency problem.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[doublegate]

@copilot apply changes based on the comments in this thread

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

@copilot apply changes based on the comments in this thread

All three changes from the review thread have already been applied in commit f222fd2:

1. ✅ Crate versions updated (pnet 0.35, clap 4.5, sqlx 0.8)
2. ✅ Added prtip-tui to project structure
3. ✅ Corrected ignored test count (96)

No additional changes needed - the file is already up to date.

[doublegate]

Reviewed / Approved -- DG 1/24