DSH familySearch GitHub

Seam

tools/post-execute

36 hook, and every one of them rewrites what passes here or advises on it.

Harness

The harness dispatches this seam as a waterfall, and it already has listeners here. The family adds its hooks beside them.

It carries the result before it becomes model content.

Payload
the result, with accept, block, replace, or add context
Power
A listener may replace what it passes on.
Declared
packages/core/tools/src/events.ts:41
  • claude-code-mods
  • hooks-claude-code
  • hooks-codex
  • repeat-tool-reminder
  • spill-policy
  • tool-fs-search

A waterfall listener receives the payload and may return a changed one, so a hook here can rewrite what the model reads next.

Fan

One event, many hands. The same listener list the table below details, drawn as the dispatch it is.

Hook

One row per hook that declares this seam, with the effect it has and the knobs it documents.

Every hook declared on the tools/post-execute seam
HookEffectWhat it doesConfiguration
hook-dsh-ccrrewriteCompresses oversized tool output, caches it, and retrieves it on demand18 knob
hook-dsh-comment-filterrewriteStrips code comments out of read results-
hook-dsh-convention-suggesteradviseNames the repo's conventions before the model breaks them-
hook-dsh-doc-suggesteradviseSuggests the documents a documentation task should touch-
hook-dsh-edit-suggesteradviseSuggests the files an edit is about to touch-
hook-dsh-graph-suggesteradviseWidens a suggestion from a symbol to everything connected to it-
hook-dsh-live-containersrewrite armKeeps live, editable blocks in the system prompt28 knob
hook-dsh-normalize-dashrewrite armTurns every unicode dash into a plain hyphen, live13 knob
hook-dsh-normalize-ellipsisrewrite armTurns the unicode ellipsis into three dots, live13 knob
hook-dsh-normalize-fullwidthrewrite armTurns fullwidth characters back into ASCII, live12 knob
hook-dsh-normalize-invisiblerewrite armRemoves invisible characters from model output13 knob
hook-dsh-normalize-quotesrewrite armTurns curly quotes into straight ones, live12 knob
hook-dsh-normalize-spacesrewrite armTurns exotic spaces into plain spaces, live13 knob
hook-dsh-replay-suggesteradviseShows what the model touched the last time it did this-
hook-dsh-search-suggesteradviseSuggests where to search before the model starts reading-
hook-dsh-test-suggesteradviseSuggests the tests a task should run-
hook-dsh-tool-coachadviseTeaches the model to stop reading files through the terminal17 knob
hook-dsh-workspace-governrewrite armGates workspace changes before they happen10 knob
ets-hook-dsh-ccrrewriteCompresses oversized tool output, caches it, and retrieves it on demand18 knob
ets-hook-dsh-comment-filterrewriteStrips code comments out of read results-
ets-hook-dsh-convention-suggesteradviseNames the repo's conventions before the model breaks them-
ets-hook-dsh-doc-suggesteradviseSuggests the documents a documentation task should touch-
ets-hook-dsh-edit-suggesteradviseSuggests the files an edit is about to touch-
ets-hook-dsh-graph-suggesteradviseWidens a suggestion from a symbol to everything connected to it-
ets-hook-dsh-live-containersrewrite armKeeps live, editable blocks in the system prompt28 knob
ets-hook-dsh-normalize-dashrewrite armTurns every unicode dash into a plain hyphen, live13 knob
ets-hook-dsh-normalize-ellipsisrewrite armTurns the unicode ellipsis into three dots, live13 knob
ets-hook-dsh-normalize-fullwidthrewrite armTurns fullwidth characters back into ASCII, live12 knob
ets-hook-dsh-normalize-invisiblerewrite armRemoves invisible characters from model output13 knob
ets-hook-dsh-normalize-quotesrewrite armTurns curly quotes into straight ones, live12 knob
ets-hook-dsh-normalize-spacesrewrite armTurns exotic spaces into plain spaces, live13 knob
ets-hook-dsh-replay-suggesteradviseShows what the model touched the last time it did this-
ets-hook-dsh-search-suggesteradviseSuggests where to search before the model starts reading-
ets-hook-dsh-test-suggesteradviseSuggests the tests a task should run-
ets-hook-dsh-tool-coachadviseTeaches the model to stop reading files through the terminal17 knob
ets-hook-dsh-workspace-governrewrite armGates workspace changes before they happen10 knob

Read

A seam is the harness event a hook listens on, named area/event. This page lists the hooks the repository declares at this seam, one row per hook, with the effect it has and the configuration it documents. A row marked as an arm is a listener the package's source registers here without documenting it in its README.