feat(copilot): capture Copilot sessions from VS Code agent hooks (Preview)

[Soph]

https://entire.io/gh/entireio/cli/trails/601

Summary

Adds capture support for GitHub Copilot sessions driven from VS Code's agent hooks (Preview), on top of the existing Copilot CLI support.

Why a separate hook file

VS Code auto-discovers .github/hooks/*.json and reads Copilot CLI configs by converting lowerCamelCase event names to PascalCase (userPromptSubmitted → UserPromptSubmitted, agentStop → AgentStop). Those converted names are not real VS Code events, so the capture-critical turn hooks never fire from entire.json inside VS Code.

The events whose converted names do line up with a real VS Code event (sessionStart, subagentStop, preToolUse, postToolUse) are already delivered from entire.json. So the new .github/hooks/entire-vscode.json registers only the two that don't round-trip:

VS Code event	Entire verb	Lifecycle
UserPromptSubmit	user-prompt-submitted	TurnStart
Stop	agent-stop	TurnEnd → checkpoint

VS Code uses the command field (not bash); the shared entire hooks copilot-cli <verb> handlers already parse both payload shapes (see compat.go).

Changes

• hooks.go (from gist): InstallHooks / UninstallHooks now also manage the VS Code file; AreHooksInstalled considers it too.
• vscode_hooks.go (new): the install/uninstall/detection implementation. Round-trips unknown fields and event types, removes only Entire-managed entries on uninstall, and deletes entire-vscode.json when nothing user-owned remains.
• vscode_hooks_test.go (new): fresh install, idempotency, force reinstall, user-hook preservation, file deletion when empty, and end-to-end InstallHooks/UninstallHooks coverage.
• README.md / AGENT.md (from gist): docs.

Testing

• mise run fmt && mise run lint — clean
• mise run test — all 6458 unit tests pass

🤖 Generated with Claude Code

---

Note

Low Risk
Scoped to Copilot hook file management under .github/hooks/ with tests; reuses existing copilot-cli hook handlers and payload parsing in compat.go.

Overview
Adds GitHub Copilot in VS Code (agent hooks Preview) to the same entire enable / entire disable flow as Copilot CLI, without changing how CLI hooks in entire.json work.

New hook file .github/hooks/entire-vscode.json registers only UserPromptSubmit and Stop with VS Code’s command field (not CLI bash), because VS Code’s PascalCase mapping from CLI event names never fires the turn hooks from entire.json. Other lifecycle events still come from entire.json inside VS Code to avoid double-firing. Install/uninstall preserves user hooks and unknown JSON fields; uninstall deletes the file when only Entire entries remain.

hooks.go calls the new VS Code install/uninstall helpers and treats the VS Code file as part of “hooks installed” detection when the CLI file is missing or unreadable.

Docs in README and AGENT.md document the second hook location and Copilot VS Code support. vscode_hooks_test.go covers idempotency, force reinstall, user-hook preservation, and end-to-end InstallHooks / UninstallHooks.

^{Reviewed by Cursor Bugbot for commit 5a07d35. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 5a07d35. Configure here.}

[Copilot]

Pull request overview

This PR extends the existing Copilot CLI hook-capture integration to also capture GitHub Copilot sessions launched via VS Code agent hooks (Preview) by managing an additional VS Code-native hook config file under .github/hooks/.

Changes:

• Add VS Code hook file management (.github/hooks/entire-vscode.json) for Copilot VS Code agent hooks.
• Update Copilot hook install/uninstall/detection to consider the VS Code hook file alongside entire.json.
• Add unit tests and documentation updates covering the new VS Code hook file behavior.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
README.md	Documents the new Copilot (VS Code) hook config location and support statement.
cmd/entire/cli/agent/copilotcli/vscode_hooks.go	Implements install/uninstall/detect for the VS Code-native Copilot hook file.
cmd/entire/cli/agent/copilotcli/vscode_hooks_test.go	Adds unit tests for VS Code hook file install/uninstall behavior and preservation rules.
cmd/entire/cli/agent/copilotcli/hooks.go	Wires VS Code hook file management into existing Copilot CLI hook lifecycle.
cmd/entire/cli/agent/copilotcli/AGENT.md	Documents why a separate VS Code hook file is required and how it behaves.