Hooks

Checks for a newer brewcode release (24 h cache), manages the plan symlink and appends the active permission_mode to the systemMessage when the payload has it. It emits no additionalContext, so version info never becomes model instructions.

LATEST.md: the plans dir resolves from local, project, then user plansDirectory (a value outside the project falls back to <config dir>/plans, following CLAUDE_CONFIG_DIR, else ~/.claude). The newest plan by mtime is linked as .claude/plans/LATEST.md only if it is under 60 seconds old; unrelated files and foreign links are preserved. If .claude/plans is itself a symlink out of the project, the hook logs a warning and creates nothing.

Re-anchors plan, original intent and task graph after a compaction, so the session does not start a new task graph on top of the old one. It uses SessionStart additionalContext, because UserPromptSubmit does not fire on an auto-compaction. It reads only this session’s transcript_path (regular file, at most 64 MB) and scans the raw buffer for a few markers, no JSONL parsing.

First match wins:

plan-latest exists because a plan that predates the transcript (after --resume or /clear) leaves no marker to scan. A plain file or foreign symlink never qualifies, so this rung only points at this project’s own latest plan. [TASKS] is appended whenever the transcript contains a TaskCreate, ordered before the plan is acted on; TaskList is the authority, since the built-in reminder can lag.

On source === 'compact' it always injects something once Node.js runs it: every failure inside the hook degrades to [INTENT], and it never names a foreign plan. Without Node.js the launcher skips it silently. The trade-off: with two plans in one session the last recorded plan path wins.

brewcode/hooks/
  session-start.mjs      SessionStart handler
  compact-recall.mjs     SessionStart handler, matcher "compact"
  hooks.json             Event bindings
  lib/utils.mjs          Shared I/O, configuration, logging
  tests/run.sh           Runs every suite (suite-session-start.mjs covers both hooks)

Each hook reads JSON from stdin (readStdin()), writes JSON to stdout (output()) and logs to stderr. Optional permission_mode is a payload signal, not a value to infer. lib/utils.mjs also exports projectRoot(): CLAUDE_PROJECT_DIR when it points at a real path, else the nearest .git or .claude directory above the hook’s cwd, else cwd itself; it never throws.