feat(gitflow): hooks in every repo, no per-project step

Global: `make link` generates githooks/ from lib/gitflow.sh and sets git's
global core.hooksPath to ~/.claude/githooks, so every repo on the machine
runs the pre-commit protection and the post-commit / post-merge push, even
one that never ran gitflow init. A repo's own local core.hooksPath still
wins, so hooks/session-start.sh calls `gitflow reconcile-hooks` once per
session and rewrites a .githooks/ that lags the lib (LRN-114 automated);
the pre-commit exemption now covers .githooks/** next to .claude/**.

Per-repo opt-outs for a foreign clone: `git config gitflow.protect false`
(branch model) and `git config gitflow.autopush false` (push). Both, and
the GIT_CONFIG_GLOBAL= / GIT_CONFIG= env bypass, are static deny rules.

`make test` and the two suites that commit on main export
GIT_CONFIG_GLOBAL=/dev/null so the machine's global hooks never fire in
throwaway repos. doctor gains "Git hooks" (global setting, githooks/ equal
to the emitters) and "Scratchpad" (warn when TMPDIR sits on a tmpfs with
usrquota: systemd caps each user at 80% of it, which killed two shells
today, BLK-021). Tests: T18h, T19d, T20 (reconcile), T21 (whitelist and
protect opt-out); this repo's own stale .githooks/ refreshed.
This commit is contained in:
bastien
2026-09-22 16:34:27 +02:00
parent e600394acc
commit f608d34c3e
18 changed files with 324 additions and 33 deletions
+24 -5
View File
@@ -56,13 +56,30 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
hooks next to `pre-commit` that push the current branch after every
commit and merge (`--follow-tags`, 30 s timeout, `GITFLOW_NO_PUSH=1` to
opt out in throwaway repos). A failed push warns loudly and never blocks
the commit. Existing projects get the hooks by re-running
`bash ~/.claude/lib/gitflow.sh install-hook`. Covered by `gitflow-test.sh`
T18 (bare origin: start, commit, opt-out, unreachable origin, finish) and
T19 (installed hooks equal the emitted ones, LRN-114 drift gate).
the commit. Nothing to run per project: `make link` generates `githooks/`
from the lib and sets git's global `core.hooksPath` to
`~/.claude/githooks`, so every repo on the machine runs the three hooks,
and `hooks/session-start.sh` refreshes a repo's own `.githooks/` when it
lags the lib (`gitflow reconcile-hooks`). Per-repo opt-outs for a foreign
clone: `git config gitflow.protect false`, `git config gitflow.autopush
false`. `make doctor` checks both. The pre-commit exemption now covers
`.githooks/**` next to `.claude/**`. `make test` and the suites that
commit on `main` run with `GIT_CONFIG_GLOBAL=/dev/null`, so the global
hooks never fire in throwaway repos. Covered by `gitflow-test.sh` T18
(bare origin: start, commit, opt-outs, unreachable origin, finish), T19
(installed and generated hooks equal the emitted ones, LRN-114 drift
gate), T20 (reconcile) and T21 (whitelist and protect opt-out).
- `hooks/unpushed-guard.sh` on `SessionStart` and `Stop`: a warning when the
branch is ahead of its upstream, has no upstream, or has no `origin`; at
session start also the count of uncommitted changes. Non-blocking.
- `make doctor` gains two sections: "Git hooks" (global `core.hooksPath`
set, generated `githooks/` equal to the emitters) and "Scratchpad": a
warning when `TMPDIR` sits on a tmpfs mounted with `usrquota`. systemd
mounts `/tmp` that way by default and caps each user at 80 % of its
size, so Claude's tool outputs share one quota across every session and
sub-agent, and one fat probe directory kills every shell at once (this
happened twice on 2026-09-22, BLK-021). Fix: launch claude with
`TMPDIR=$HOME/.cache/claude-tmp`.
- `lib/tests/guard-bash.test.sh`: the executable spec of a PreToolUse Bash
guard (transfer tools, sync deletes, recursive `rm` outside the project,
bulk permissions, privilege escalation, disk tools, docker privileges and
@@ -179,7 +196,9 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
docker socket and `-v /:`, and git history destruction (`push --delete`,
`--mirror`, `:ref`, `--force-with-lease`, `branch -D`, `filter-branch`,
`reflog expire`, `stash clear`/`drop`, `clean -f`, `--no-verify`,
`core.hooksPath`). The pipe-to-shell and stash entries left `ask`, which is
`core.hooksPath`, the `GIT_CONFIG_GLOBAL=` / `GIT_CONFIG=` env prefixes
and the per-repo `gitflow.*` opt-outs, which belong to the human). The
pipe-to-shell and stash entries left `ask`, which is
unreliable under auto mode. New `autoMode.hard_deny`: a destructive tool
aimed at a path built from a variable, `~`, `..`, a wildcard, or outside
the project and the temp dir, including as a trace or a rehearsal that a