feat: Copilot governance engine, VS Code extension, recall parser, and Copilot CLI integration

[bilersan]

Summary

Three-layer governance architecture for VS Code Copilot and full GitHub Copilot CLI integration that closes the governance gap with Claude Code hooks, plus Copilot Chat session parser and Windows compatibility fixes.

Resolves #44
Closes #28
Closes #30
Closes #51
Supersedes #29, #31, #36

Architecture

Layer 1: Behavioral Rules (copilot-instructions.md)

Preventive/advisory rules in the system prompt — session lifecycle, when to call tools, governance response handling.

Layer 2: MCP Governance-in-Response

CheckGovernance() appends contextual warnings to every MCP tool response:

• Session not started → nudge ctx_session_event(start)
• Context not loaded → nudge ctx_status()
• Drift stale (>15min or >5 calls) → nudge ctx_drift()
• Persist nudge (>=10 calls since last write) → nudge ctx_add()
• Violations from detection ring → CRITICAL escalation

Layer 3: VS Code Detection Ring

Extension monitors terminal commands and file edits:

• Terminal watcher: dangerous commands (rm -rf /, git push --force, etc.)
• File edit watcher: sensitive files (.env, .pem, credentials)
• Records violations → MCP escalates with CRITICAL warnings

GitHub Copilot CLI Integration (Phases 1–4)

Phase 1 — Hook Generation

• ctx hook copilot-cli --write generates .github/hooks/ctx-hooks.json
• Dual bash/PowerShell scripts for sessionStart, preToolUse, postToolUse, sessionEnd
• Dangerous command blocking and per-hook timeout control

Phase 2 — Agent Instructions

• AGENTS.md generation with universal agent instructions
• .github/agents/ctx.md custom agent + .github/instructions/context.instructions.md
• Marker-based idempotent merge

Phase 3 — MCP Registration & Session Parser

• Auto-register ctx MCP server in ~/.copilot/mcp-config.json
• CopilotCLIParser for ctx recall with cross-platform session dir detection

Phase 4 — Skills

• 5 skill templates: ctx-status, ctx-recall, ctx-drift, ctx-compact, ctx-next
• Written to .github/skills/<name>/SKILL.md alongside hooks

Feature Matrix

Category	Claude Code	VS Code	Copilot CLI
Context Injection	✅ 6/6	✅ 4/6	✅ 5/6
Hook System	✅ 5/15	✅ 1/15	✅ 10/15
MCP Server (11 tools)	✅	✅	✅
Session Recall	✅ 5/7	✅ 5/7	✅ 5/7
Skills	✅ 37	—	✅ 5
Cross-Platform	✅ 6/9	✅ 8/9	✅ 9/9

Full matrix: specs/copilot-cli-integration.md

Commits

1. fix: Windows cross-platform compatibility — Case-insensitive path comparison
2. feat: Copilot Chat session parser — CopilotParser for ctx recall
3. feat: VS Code extension with MCP integration — @ctx chat participant, detection ring
4. feat: MCP governance engine — CheckGovernance with 5 checks, 24 tests
5. fix: resolve build errors after rebase onto v0.8.0 — Variable rename, import path, entity types
6. feat: Copilot CLI hook generation (Phase 1) — Cross-platform hooks with 8 scripts
7. feat: Phase 2 agent instructions — AGENTS.md, agents/ctx.md, instructions/context.md
8. feat: Phase 3 MCP registration + session parser — mcp-config.json + CopilotCLIParser
9. feat: Phase 4 Copilot CLI skills — 5 embedded skill templates

Testing

• 24 governance tests (all checks, edge cases, violations)
• 39 MCP server tests (all pass including session priming)
• Init/hook integration tests for mcp.json generation
• Compliance tests pass (goconst, gosec, literal newline)

[josealekhine]

@bilersan if you fix the merge conflicts, I will give it a whirl.

Sorry about the 20K-line refactoring; that's partially the reason for the merge conflicts.

Alternatively you can close the PR and re-patch the changes from top-of-tree.

I'm assuming main will be "relatively" stable for a while as I will have lesser "Batman time" from next week onwards ;).

Thanks for all your help 🙏 .