Skip to content

Canonicalize the Claude Code web SessionStart hook; add CLAUDE.md#4

Merged
tap merged 1 commit into
mainfrom
claude/session-start-hook-w8ky0p
Jul 22, 2026
Merged

Canonicalize the Claude Code web SessionStart hook; add CLAUDE.md#4
tap merged 1 commit into
mainfrom
claude/session-start-hook-w8ky0p

Conversation

@tap

@tap tap commented Jul 22, 2026

Copy link
Copy Markdown
Owner

Adds the Claude Code web SessionStart hook to the canonical sync set. Motivation: fresh web-session containers clone bare — no submodules, no pre-commit hook — so agent commits bypass the local format layer and fail the clang-format gate only in CI (this happened on tap/TapTools-Max#56's first push). The hook closes the gap at session start: recursive submodule init, pre-commit install against the pinned config, and a hook-environment warm so the container snapshot caches the pinned clang-format.

Mechanism changes, following the existing patterns:

  • .claude/hooks/session-start.sh — the canonical hook (web-only via CLAUDE_CODE_REMOTE, synchronous, idempotent).
  • scripts/sync.sh — distributes the hook script always; creates .claude/settings.json (the registration) only if missing, since repos may extend their settings with repo-specific hooks.
  • drift-check.yml — guards the hook script conditionally, only when both the consumer and the pinned TapHouse ref carry it — so consumers pinning v4 stay green until the next tag advances past this change. settings.json is deliberately unguarded.
  • README — the file table and adoption steps updated.
  • CLAUDE.md — new agent guidance recording the house mechanism (never hand-edit synced consumer copies; the three places a new canonical file touches; the two version knobs; rollout order).

Already synced to consumers on matching branches: tap/ambitap, tap/ambitap-max, tap/sampleratetap, tap/mutap, tap/mutap-max (new PRs), plus alignment commits on the open tap/DspTap#4, tap/TapTools#21, and tap/TapTools-Max#56. The hook was validated by direct execution in all nine repos. Merge this first, then the consumers; tag when you're ready to make the drift guard bite (and bump consumer ref:s in that sweep).

🤖 Generated with Claude Code

https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs


Generated by Claude Code

The hook joins the sync set: fresh web-session containers clone bare
(no submodules, no pre-commit hook), so agent commits could bypass the
local format layer entirely and fail the clang-format gate in CI —
which is exactly what happened on the first tap.tune~ push. The hook
initializes submodules, installs the pinned pre-commit hook, and warms
its clang-format at session start. sync.sh distributes the hook script
(always) and creates .claude/settings.json only if missing, since repos
may extend their settings with repo-specific hooks; drift-check guards
the hook script conditionally — only when both the consumer and the
pinned TapHouse ref carry it, so older pins stay green.

CLAUDE.md records the house mechanism for agents: never hand-edit
synced consumer copies, the three places a new canonical file touches,
the two version knobs, and the rollout order.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
@tap
tap merged commit f53b68b into main Jul 22, 2026
tap added a commit to tap/AmbiTap that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/AmbiTap-Max that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/SampleRateTap that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/MuTap that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/MuTap-Max that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/DspTap that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/TapTools that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/TapTools-Max that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/DspTap that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/TapTools that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/AmbiTap that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/SampleRateTap that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/TapTools-Max that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/AmbiTap-Max that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/MuTap-Max that referenced this pull request Jul 22, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
tap added a commit to tap/MuTap that referenced this pull request Jul 23, 2026
v5 canonicalizes the Claude Code web SessionStart hook (tap/TapHouse#4
merged); this branch already carries the synced hook, so the v5 drift
guard — which now covers it — passes by construction. Both the reusable
workflow ref and the comparison ref move together.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BuUawafae7RR2ySWabuJcs
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant