Skip to content

G5: docs/hooks.md architecture umbrella + loop_limit clamp #950

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
cursor merged 1 commit into from
Jul 18, 2026
Merged

G5: docs/hooks.md architecture umbrella + loop_limit clamp #950

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion docs/claude-hooks.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,9 @@
handlers) so repos that already ship Claude Code policy hooks work without a Cursor-format
`hooks.json`. Tracks issue #639.

This is the Claude counterpart to [`docs/cursor-hooks.md`](./cursor-hooks.md).
This is the Claude counterpart to [`docs/cursor-hooks.md`](./cursor-hooks.md). For the
dialect-agnostic architecture (registry, canonical events, async/budget/epoch, spine,
sandbox, UI) see [`docs/hooks.md`](./hooks.md).

## On-disk layout

Expand Down
4 changes: 3 additions & 1 deletion docs/copse-hooks.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,9 @@ vendor translation layer. It also exposes Copse-native knobs the imported dialec

Each hook is a process that receives a JSON payload on **stdin**, may print a JSON response
on **stdout**, and can observe, block, or annotate the action that triggered it. Dialect is
determined by source path (decision 8): `.copse/hooks.json` → the Copse adapter.
determined by source path (decision 8): `.copse/hooks.json` → the Copse adapter. For the
dialect-agnostic architecture (registry, canonical events, async/budget/epoch, spine,
sandbox, UI) see [`docs/hooks.md`](./hooks.md).

The official JSON schema is published at
[`schemas/copse-hooks.schema.json`](../schemas/copse-hooks.schema.json)
Expand Down
5 changes: 4 additions & 1 deletion docs/cursor-hooks.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,9 @@ can observe, block, or annotate the action that triggered it.

This document records the Cursor hooks contract, what Copse honours today, and what
remains for fuller parity. It is the hooks counterpart to
[`docs/cursor-plugins.md`](./cursor-plugins.md).
[`docs/cursor-plugins.md`](./cursor-plugins.md). For the cross-cutting architecture — the
unified registry, canonical events, executors, async/budget/epoch, spine, sandbox, and UI
that are dialect-agnostic — see [`docs/hooks.md`](./hooks.md).

## On-disk layout

Expand Down Expand Up @@ -327,6 +329,7 @@ UPDATE_HOOK_PAYLOAD_SNAPSHOTS=1 npm test
- `src/main/services/hooks/payload-snapshots.test.ts` — dialect wire payload snapshot tests (G4)
- `src/main/services/hooks/__snapshots__/wire-payloads.json` — committed golden wire-payload fixture (G4)
- `src/main/services/exec/child-process-env.ts` — secret-scrubbed env for hook processes
- `docs/hooks.md` — dialect-agnostic hooks architecture umbrella
- `docs/claude-hooks.md` — Claude Code hooks contract
- `docs/cursor-plugins.md` — sibling exploration of Cursor plugin support
- `docs/supply-chain-security.md` — trust boundaries for executed code
Loading
Loading