Files
skillshare/ai_docs/tests/git_hooks_runbook.md
T
Rusty Shackleford 1a2389dea2 feat(hooks): manage Git config hooks (#310)
Git 2.54 added named config hooks, but keeping their registrations and
helper paths consistent across machines still required manual config
edits. Bring them into the same preview, sync, and recovery workflow as
Agent hooks.

- Global and project scope, with linked worktrees sharing the common dir
- Portable helper files, collision detection, and ownership tracking of
  generated files and include.path entries
- Backups and restore preserve unrelated settings and conditional includes
- Management never executes hooks; Git below 2.54 is reported as inactive
  while outputs are still generated
- CLI/API inventory, raw YAML editing in the dashboard, localized docs
2026-10-02 02:56:54 +08:00

27 lines
1.2 KiB
Markdown

# Git hooks execution proof
The Go/CLI/API suites manage configuration and use read-only `git hook list`;
they never execute hooks. `scripts/hooks/git-e2e.sh` is the sole execution proof.
It requires the `/workspace` devcontainer, Git 2.54+ and a fresh `ssenv` HOME.
Do not run it natively or against a user's normal configuration.
Inside the devcontainer:
```bash
cd /workspace
make build
ssenv create git-hooks-proof
ssenv enter git-hooks-proof -- bash /workspace/scripts/hooks/git-e2e.sh
```
The script isolates global/system Git config, XDG paths and Skillshare source.
It creates local repositories and a bare remote, checks commit/amend/push,
config-before-hookdir order, arguments and full stdin per hook, `--no-verify`,
a linked-worktree commit, and portable wrappers using a stub Roborev. Evidence
is retained under the disposable HOME; inspect the final JSON path on failure.
Delete only that disposable environment after inspection with `ssenv`.
For environments where execution is forbidden, validate shell syntax with
`bash -n scripts/hooks/git-e2e.sh` and report execution as skipped. Registration,
management lifecycle and native parser tests remain required.