diff options
| author | Drew Ritter <drew@primeradiant.com> | 2026-08-04 14:55:28 -0700 |
|---|---|---|
| committer | Drew Ritter <drew@primeradiant.com> | 2026-08-04 14:55:28 -0700 |
| commit | 36f3883f4ef1b3ca70307fd05509c9a501d772a3 (patch) | |
| tree | 8e24e5a7bcec57f543d36e5211e5dbacec2c50b1 /hooks/session-start-codex | |
| parent | 05c2393b826dd0f09cd071427e62b42e6c751995 (diff) | |
fix(codex): restore Superpowers after compactioncodex-spinout-fixes
Codex re-fires SessionStart with source "compact" after every context
compaction; the summary keeps progress but sheds the bootstrap and any
active skill's instructions — measured July cause of post-compaction
dispatch drift in long SDD runs (with re-injection: 18/18 hook fires,
66/66 post-compaction dispatch tuples correct in a 12.4h stress run).
Codex discovers skills natively at startup, so the hook is silent
there: the compact re-fire is the one unowned lifecycle point.
Adds the plugin-provided hook (hooks-codex.json + session-start-codex,
compact-only, fails open), wires it into the manifest and package,
documents install/trust behavior, updates codex-tools.md with the
re-grounding fallback, and tests the hook lifecycle, manifest, and
archive contents.
Rebuilt from the July codex-spinout-fixes branch, pared to the hook
core: the dispatch-hints layer it used to ride with is superseded by
the merged 2059-2062/2077-2080 stack and is dropped.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Diffstat (limited to 'hooks/session-start-codex')
| -rwxr-xr-x | hooks/session-start-codex | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/hooks/session-start-codex b/hooks/session-start-codex new file mode 100755 index 0000000..c9e5a6c --- /dev/null +++ b/hooks/session-start-codex @@ -0,0 +1,56 @@ +#!/usr/bin/env bash +# Codex SessionStart hook for the superpowers plugin. +# +# Codex re-fires SessionStart with source:"compact" after every context +# compaction (verified on codex-cli 0.145.0). Compaction replaces the live +# context with a summary, which sheds the using-superpowers bootstrap and any +# active skill's instructions — the measured cause of mid-session dispatch +# drift in long multi-agent runs. This hook re-injects the bootstrap at +# exactly that moment, restoring the same re-injection Claude Code performs +# via its "startup|clear|compact" SessionStart matcher. +# +# On source:"startup" it emits nothing: the native Codex plugin path owns +# session-start injection, and duplicating it here would recreate the +# redundancy that led to the original session-start-codex hook's removal. +# +# Codex injects raw hook stdout into the model's context (verified with +# sentinel probes), so output is plain text — not the JSON envelopes other +# harnesses require of hooks/session-start. +# +# A hook failure must never break a session: every path fails open to empty +# output and exit 0. + +set -u + +payload="$(cat 2>/dev/null || true)" + +# Act only on post-compaction re-fires. Tolerate arbitrary whitespace around +# the JSON colon; anything unparseable falls through to a silent no-op. +if ! printf '%s' "$payload" | grep -qE '"source"[[:space:]]*:[[:space:]]*"compact"'; then + exit 0 +fi + +SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)" +PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)" + +using_superpowers_content="$(cat "${PLUGIN_ROOT}/skills/using-superpowers/SKILL.md" 2>/dev/null)" || using_superpowers_content="" +if [ -z "$using_superpowers_content" ]; then + exit 0 +fi + +# printf instead of heredocs throughout: heredocs hang on bash 5.3+. +# See: https://github.com/obra/superpowers/issues/571 +printf '%s\n' "<EXTREMELY_IMPORTANT>" +printf '%s\n\n' "You have superpowers." +printf '%s\n\n' "**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**" +printf '%s\n' "$using_superpowers_content" +printf '%s\n\n' "</EXTREMELY_IMPORTANT>" +printf '%s\n' "<CONTEXT_RESTORED>" +printf '%s\n' "Your context was just summarized (compacted). The summary preserves your progress but not your working instructions — the files are authoritative." +printf '%s\n' "" +printf '%s\n' "Before your next tool call:" +printf '%s\n' "- Re-read the SKILL.md of any skill you are mid-way through executing. If you are executing subagent-driven-development, re-read skills/subagent-driven-development/SKILL.md." +printf '%s\n' "- On Codex, also re-read skills/using-superpowers/references/codex-tools.md and follow its dispatch rules on every spawn_agent call." +printf '%s\n' "</CONTEXT_RESTORED>" + +exit 0 |
