halfcycle 0.5.1 → 0.5.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "halfcycle",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Halfcycle Method bundle — resolution-stub slash commands, remote method-delivery registration, and governance-hook wiring for a Halfcycle engagement repo. It ships NO worker role files: a project's roles are authored from that project's own recorded decisions at orchestration kickoff (FX-2, W3-F-27).",
   "commands": [
     {

package/bin/bin.bundle.mjs

@@ -14665,6 +14665,9 @@ var USER_PROMPT_REMINDER_REL = ".claude/hooks/user-prompt-reminder.sh";
 var USER_PROMPT_SCOPE_REL = ".claude/hooks/user-prompt-scope.sh";
 var USER_PROMPT_FINDINGS_REL = ".claude/hooks/user-prompt-findings.sh";
 var SESSION_END_MARKER_REL = ".claude/hooks/session-end-marker.sh";
+var CONTEXT_BUDGET_CHECK_REL = ".claude/hooks/context-budget-check.sh";
+var CONTEXT_DRIFT_CHECK_REL = ".claude/hooks/context-drift-check.sh";
+var CONTEXT_DRIFT_MATCHER = "Edit|Write";
 var WRITE_CAPABLE_TOOLS = ["Edit", "MultiEdit", "NotebookEdit", "Write"];
 var PRE_TOOL_USE_MATCHER = "^(Bash|Read|Grep|Write|Edit|MultiEdit|NotebookEdit|Agent|PowerShell)$";
 function hookCommand(script, verb) {
@@ -14741,6 +14744,20 @@ var HALFCYCLE_HOOK_WIRING = [
     timeout: 5,
     command: hookCommand(SESSION_END_MARKER_REL),
     script: SESSION_END_MARKER_REL
+  },
+  {
+    event: "SessionStart",
+    matcher: null,
+    timeout: 10,
+    command: hookCommand(CONTEXT_BUDGET_CHECK_REL),
+    script: CONTEXT_BUDGET_CHECK_REL
+  },
+  {
+    event: "PostToolUse",
+    matcher: CONTEXT_DRIFT_MATCHER,
+    timeout: 5,
+    command: hookCommand(CONTEXT_DRIFT_CHECK_REL),
+    script: CONTEXT_DRIFT_CHECK_REL
   }
 ];
 var RETIRED_HOOK_COMMANDS = [
@@ -14750,7 +14767,9 @@ var RETIRED_HOOK_COMMANDS = [
   "bash ./.claude/hooks/guard-runner.sh hook post-tool-use",
   "bash ./.claude/hooks/guard-runner.sh hook stop",
   "bash ./.claude/hooks/guard-runner.sh hook subagent-stop",
-  "bash ./.claude/hooks/session-end-marker.sh"
+  "bash ./.claude/hooks/session-end-marker.sh",
+  "bash ./.claude/hooks/context-budget-check.sh",
+  "bash ./.claude/hooks/context-drift-check.sh"
 ];
 var HALFCYCLE_HOOK_COMMANDS = /* @__PURE__ */ new Set([
   ...HALFCYCLE_HOOK_WIRING.map((entry) => entry.command),
@@ -15154,7 +15173,9 @@ var CODEX_HOOK_WIRING = [
   codexHookRow("PostToolUse", CODEX_WRITE_CAPABLE_TOOLS.join("|"), 60, GUARD_RUNNER_REL, "hook post-tool-use --agent codex"),
   codexHookRow("Stop", null, 60, GUARD_RUNNER_REL, "hook stop --agent codex"),
   codexHookRow("SubagentStop", null, 60, GUARD_RUNNER_REL, "hook subagent-stop --agent codex"),
-  codexHookRow("SessionEnd", null, 3, SESSION_END_MARKER_REL)
+  codexHookRow("SessionEnd", null, 3, SESSION_END_MARKER_REL),
+  codexHookRow("SessionStart", null, 10, CONTEXT_BUDGET_CHECK_REL),
+  codexHookRow("PostToolUse", CODEX_WRITE_CAPABLE_TOOLS.join("|"), 5, CONTEXT_DRIFT_CHECK_REL)
 ];
 var RETIRED_CODEX_HOOK_COMMANDS = [];
 function codexHookCommandSet(retired) {
@@ -29234,7 +29255,8 @@ function refusalFor(facts, description) {
 function heldStep(steps, description, why) {
   return {
     person: PERSON_HOLD_LINE,
-    agent: `${HELD_STEP_OPENER}${steps}. ${reasonSentence(description)} ${PRECAUTION_OPENER}${why}. ${HOLD_AGENT_INSTRUCTION}`
+    agent: `${HELD_STEP_OPENER}${steps}. ${reasonSentence(description)} ${PRECAUTION_OPENER}${why}. ${HOLD_AGENT_INSTRUCTION}`,
+    step: steps
   };
 }
 var STEP_VERBS = {
@@ -29651,6 +29673,7 @@ import { createHash as createHash5 } from "node:crypto";
 import { appendFileSync as appendFileSync4, readFileSync as readFileSync20, renameSync as renameSync10, unlinkSync as unlinkSync9, writeFileSync as writeFileSync12 } from "node:fs";
 var ALLOW_ONCE_MS = 5 * 60 * 1e3;
 var HELD_STEP_MAX_AGE_MS = 60 * 60 * 1e3;
+var STEP_MAX_LENGTH = 1e3;
 function isAllowReply(prompt) {
   return typeof prompt === "string" && prompt.trim().toLowerCase() === ALLOW_REPLY;
 }
@@ -29676,11 +29699,11 @@ function canonical(value) {
   }
   return JSON.stringify(value) ?? "null";
 }
-function recordHeld(sessionId, key, deps = {}) {
+function recordHeld(sessionId, key, deps = {}, step = null) {
   const paths = allowOncePaths(sessionId, deps.dir);
   if (paths === null)
     return;
-  const record2 = { version: 1, session: sessionId, key, at: nowOf(deps) };
+  const record2 = { version: 1, session: sessionId, key, at: nowOf(deps), ...isStep(step) ? { step } : {} };
   try {
     appendFileSync4(paths.held, `${JSON.stringify(record2)}
 `, { mode: 384 });
@@ -29688,23 +29711,26 @@ function recordHeld(sessionId, key, deps = {}) {
     return;
   }
 }
-function armAllow(sessionId, deps = {}) {
+function armAllowStep(sessionId, deps = {}) {
   try {
     const paths = allowOncePaths(sessionId, deps.dir);
     if (paths === null)
-      return "nothing-held";
+      return { outcome: "nothing-held", step: null };
     const now = nowOf(deps);
-    const keys = claimHeldKeys(paths.held, sessionId, now);
+    const held = claimHeld(paths.held, sessionId, now);
+    const keys = [...new Set(held.map((r) => r.key))];
     if (keys.length === 0)
-      return "nothing-held";
+      return { outcome: "nothing-held", step: null };
     if (keys.length > 1)
-      return "several-held";
-    return writeRecord(paths.allow, { version: 1, session: sessionId, key: keys[0], at: now }) ? "armed" : "not-saved";
+      return { outcome: "several-held", step: null };
+    const step = held[held.length - 1].step ?? null;
+    const saved = writeRecord(paths.allow, { version: 1, session: sessionId, key: keys[0], at: now });
+    return saved ? { outcome: "armed", step } : { outcome: "not-saved", step: null };
   } catch {
-    return "not-saved";
+    return { outcome: "not-saved", step: null };
   }
 }
-function claimHeldKeys(path, session, now) {
+function claimHeld(path, session, now) {
   const claimed = `${path}.${process.pid}.${now}.claim`;
   try {
     renameSync10(path, claimed);
@@ -29718,13 +29744,16 @@ function claimHeldKeys(path, session, now) {
     text = "";
   }
   removeQuietly(claimed);
-  const keys = /* @__PURE__ */ new Set();
+  const records = [];
   for (const line2 of text.split("\n")) {
     const r = parseRecord(line2, session);
     if (r !== null && within(r.at, now, HELD_STEP_MAX_AGE_MS))
-      keys.add(r.key);
+      records.push(r);
   }
-  return [...keys];
+  return records;
+}
+function isStep(v) {
+  return typeof v === "string" && v !== "" && v.length <= STEP_MAX_LENGTH;
 }
 function spendAllow(sessionId, key, deps = {}) {
   try {
@@ -29776,7 +29805,8 @@ function parseRecord(text, session) {
     return null;
   if (typeof r["at"] !== "number")
     return null;
-  return { version: 1, session, key: r["key"], at: r["at"] };
+  const step = r["step"];
+  return { version: 1, session, key: r["key"], at: r["at"], ...isStep(step) ? { step } : {} };
 }
 function writeRecord(path, record2) {
   const tmp = `${path}.${process.pid}.${Date.now()}.tmp`;
@@ -30696,7 +30726,7 @@ function runPreToolUse(deps) {
         const allowOnce = { ...deps.liveness?.dir === void 0 ? {} : { dir: deps.liveness.dir }, now: () => at.getTime() };
         if (spendAllow(input["session_id"], key, allowOnce))
           return "";
-        recordHeld(input["session_id"], key, allowOnce);
+        recordHeld(input["session_id"], key, allowOnce, answer.refusal.step);
       }
     }
     return `${preToolUseReplyText("refuse", answer.refusal.person, answer.refusal.agent)}
@@ -31684,14 +31714,15 @@ function autonomyLineForAnswer(answer) {
 }
 var NOTHING_ALLOWED = "Nothing was allowed";
 var ALLOW_MINUTES = Math.round(ALLOW_ONCE_MS / 6e4);
-function allowArmedLine() {
-  return line(`The person allowed the paused step once. Run it again now, exactly as before; it will go ahead once if it runs within ${ALLOW_MINUTES} minutes, and any other risky step is still paused.`);
+function allowArmedLine(step = null) {
+  const named = step === null ? "The person allowed the paused step once." : `The person allowed this paused step once: ${step}.`;
+  return line(`${named} Run it again now, exactly as before; it will go ahead once if it runs within ${ALLOW_MINUTES} minutes, and any other risky step is still paused.`);
 }
 function allowNothingHeldLine() {
   return line(`${NOTHING_ALLOWED}: no step is paused in this session.`);
 }
 function allowSeveralHeldLine() {
-  return line(`${NOTHING_ALLOWED}: more than one step is paused in this session. Ask the agent to try the one you mean again, then type ${ALLOW_REPLY}.`);
+  return `${NOTHING_ALLOWED}: more than one step was paused, so Halfcycle could not tell which one you meant. Nothing ran. When your agent tries the step again, type ${ALLOW_REPLY} once more. ${SHOW_AS_WRITTEN}`;
 }
 function allowNotAttendedLine() {
   return line(`${NOTHING_ALLOWED}: a paused step can be allowed by typing only when a person types it into an open session.`);
@@ -31700,14 +31731,18 @@ function allowNotSavedLine() {
   return line(`${NOTHING_ALLOWED}: Halfcycle could not save the answer on this computer. Type ${ALLOW_REPLY} again.`);
 }
 var CODEX_TYPING_NEVER_COUNTS = "in Codex, Halfcycle cannot tell a line a person typed from one a program sent, so a typed decision never counts there";
+var SHOW_AS_WRITTEN = "Show the person this line as written.";
+function codexLine(text) {
+  return `${text} ${SHOW_AS_WRITTEN}`;
+}
 function codexScopeLine(act) {
-  return act === "approve" ? line(`${nothingDone(act)}: ${CODEX_TYPING_NEVER_COUNTS}. To approve, choose Accept in the console.`) : line(`${nothingDone(act)}: ${CODEX_TYPING_NEVER_COUNTS}. The console offers only Accept, so work cannot be sent back from Codex.`);
+  return act === "approve" ? codexLine(`${nothingDone(act)}: ${CODEX_TYPING_NEVER_COUNTS}. To approve, choose Accept in the console.`) : codexLine(`${nothingDone(act)}: ${CODEX_TYPING_NEVER_COUNTS}. The console offers only Accept, so work cannot be sent back from Codex.`);
 }
 function codexReviewLine(act) {
-  return act === "accept" ? line(`${NOTHING_RECORDED}: ${CODEX_TYPING_NEVER_COUNTS}. To accept, choose Accept in the console.`) : line(`${NOTHING_RECORDED}: ${CODEX_TYPING_NEVER_COUNTS}. The console offers only Accept, so this cannot be done from Codex.`);
+  return act === "accept" ? codexLine(`${NOTHING_RECORDED}: ${CODEX_TYPING_NEVER_COUNTS}. To accept, choose Accept in the console.`) : codexLine(`${NOTHING_RECORDED}: ${CODEX_TYPING_NEVER_COUNTS}. The console offers only Accept, so this cannot be done from Codex.`);
 }
 function codexAutonomyLine() {
-  return line(`${AUTONOMY_NOTHING_CHANGED}: ${CODEX_TYPING_NEVER_COUNTS}. Turn it on or off with "${AUTONOMY_A1_TITLE}" in the console's settings.`);
+  return codexLine(`${AUTONOMY_NOTHING_CHANGED}: ${CODEX_TYPING_NEVER_COUNTS}. Turn it on or off with "${AUTONOMY_A1_TITLE}" in the console's settings.`);
 }
 
 // dist/hooks/user-prompt-submit.js
@@ -31772,13 +31807,13 @@ function decideAllow(opts) {
   const env = opts.env ?? process.env;
   if ((opts.agent ?? "claude-code") === "claude-code" && !readSessionAttended(env))
     return allowNotAttendedLine();
-  const outcome = armAllow(sessionIdOf(opts.input), {
+  const { outcome, step } = armAllowStep(sessionIdOf(opts.input), {
     ...opts.tempDir === void 0 ? {} : { dir: opts.tempDir },
     ...opts.now === void 0 ? {} : { now: opts.now }
   });
   switch (outcome) {
     case "armed":
-      return allowArmedLine();
+      return allowArmedLine(step);
     case "nothing-held":
       return allowNothingHeldLine();
     case "several-held":
@@ -32415,6 +32450,10 @@ function isCheckedSessionStart(input, profile) {
   return CHECKED_SOURCES.has(source);
 }
 var CONNECTED_SENTENCE = `Halfcycle's sign-in works and its service answered. If its tools are missing, turn on ${MCP_SERVER_KEY} in /mcp; if it is not listed, run "claude mcp reset-project-choices" here and restart Claude Code.`;
+var CODEX_CONNECTED_SENTENCE = "Halfcycle's sign-in works and its service answered. If its tools are missing, start a new Codex session to reconnect them.";
+function connectedSentenceFor(profile) {
+  return profile.id === "codex" ? CODEX_CONNECTED_SENTENCE : CONNECTED_SENTENCE;
+}
 var INITIALIZE_BODY = JSON.stringify({ jsonrpc: "2.0", id: 1, method: "initialize", params: {} });
 var SESSION_START_PROBE_ATTEMPTS = 2;
 function registeredMcpUrl(projectRoot) {
@@ -32501,6 +32540,7 @@ async function probeDelivery(url2, bearer, fetchFn, deadlineMs, maxAttempts) {
   }
 }
 async function checkConnection(renewedToken, opts) {
+  const profile = opts.profile ?? AGENT_PROFILES["claude-code"];
   const url2 = registeredMcpUrl(projectRootFromBinary(opts.binaryPath));
   if (url2 === void 0)
     return void 0;
@@ -32514,10 +32554,10 @@ async function checkConnection(renewedToken, opts) {
     environmentTokenFirst: false
   });
   if (CREDENTIAL_PLACEHOLDERS.includes(bearer)) {
-    return { sentence: PLACEHOLDER_SENTENCES[bearer], url: url2, bearer };
+    return { sentence: PLACEHOLDER_SENTENCES[bearer], url: url2, bearer, connected: false };
   }
   const outcome = await probeDelivery(url2, bearer, opts.fetchFn ?? globalThis.fetch, opts.checkDeadlineMs ?? CONNECTION_CHECK_DEADLINE_MS, opts.maxAttempts ?? SESSION_START_PROBE_ATTEMPTS);
-  return { sentence: outcome ?? CONNECTED_SENTENCE, url: url2, bearer };
+  return { sentence: outcome ?? connectedSentenceFor(profile), url: url2, bearer, connected: outcome === void 0 };
 }
 function positionRequestBody(engagementId) {
   return JSON.stringify({
@@ -32607,10 +32647,10 @@ async function runRefreshCredential(opts) {
     renewalOpen = false;
     const parts = [];
     if (isCheckedSessionStart(input, profile)) {
-      const connection = await checkConnection(renewedToken, { ...opts, writeErr });
+      const connection = await checkConnection(renewedToken, { ...opts, profile, writeErr });
       if (connection !== void 0) {
         parts.push(connection.sentence);
-        if (connection.sentence === CONNECTED_SENTENCE) {
+        if (connection.connected) {
           const engagementId = readConfig().config?.guardEngagementId;
           if (engagementId !== void 0) {
             const remainingForMargin = SESSION_START_HOOK_TIMEOUT_MS - SESSION_START_MARGIN_MS - (Date.now() - startedAt);

package/dist/cli.js

@@ -148,6 +148,9 @@ var USER_PROMPT_REMINDER_REL = ".claude/hooks/user-prompt-reminder.sh";
 var USER_PROMPT_SCOPE_REL = ".claude/hooks/user-prompt-scope.sh";
 var USER_PROMPT_FINDINGS_REL = ".claude/hooks/user-prompt-findings.sh";
 var SESSION_END_MARKER_REL = ".claude/hooks/session-end-marker.sh";
+var CONTEXT_BUDGET_CHECK_REL = ".claude/hooks/context-budget-check.sh";
+var CONTEXT_DRIFT_CHECK_REL = ".claude/hooks/context-drift-check.sh";
+var CONTEXT_DRIFT_MATCHER = "Edit|Write";
 var WRITE_CAPABLE_TOOLS = ["Edit", "MultiEdit", "NotebookEdit", "Write"];
 var PRE_TOOL_USE_MATCHER = "^(Bash|Read|Grep|Write|Edit|MultiEdit|NotebookEdit|Agent|PowerShell)$";
 function hookCommand(script, verb) {
@@ -224,6 +227,20 @@ var HALFCYCLE_HOOK_WIRING = [
     timeout: 5,
     command: hookCommand(SESSION_END_MARKER_REL),
     script: SESSION_END_MARKER_REL
+  },
+  {
+    event: "SessionStart",
+    matcher: null,
+    timeout: 10,
+    command: hookCommand(CONTEXT_BUDGET_CHECK_REL),
+    script: CONTEXT_BUDGET_CHECK_REL
+  },
+  {
+    event: "PostToolUse",
+    matcher: CONTEXT_DRIFT_MATCHER,
+    timeout: 5,
+    command: hookCommand(CONTEXT_DRIFT_CHECK_REL),
+    script: CONTEXT_DRIFT_CHECK_REL
   }
 ];
 var RETIRED_HOOK_COMMANDS = [
@@ -233,7 +250,9 @@ var RETIRED_HOOK_COMMANDS = [
   "bash ./.claude/hooks/guard-runner.sh hook post-tool-use",
   "bash ./.claude/hooks/guard-runner.sh hook stop",
   "bash ./.claude/hooks/guard-runner.sh hook subagent-stop",
-  "bash ./.claude/hooks/session-end-marker.sh"
+  "bash ./.claude/hooks/session-end-marker.sh",
+  "bash ./.claude/hooks/context-budget-check.sh",
+  "bash ./.claude/hooks/context-drift-check.sh"
 ];
 var HALFCYCLE_HOOK_COMMANDS = /* @__PURE__ */ new Set([
   ...HALFCYCLE_HOOK_WIRING.map((entry) => entry.command),
@@ -1099,7 +1118,9 @@ var CODEX_HOOK_WIRING = [
   codexHookRow("PostToolUse", CODEX_WRITE_CAPABLE_TOOLS.join("|"), 60, GUARD_RUNNER_REL, "hook post-tool-use --agent codex"),
   codexHookRow("Stop", null, 60, GUARD_RUNNER_REL, "hook stop --agent codex"),
   codexHookRow("SubagentStop", null, 60, GUARD_RUNNER_REL, "hook subagent-stop --agent codex"),
-  codexHookRow("SessionEnd", null, 3, SESSION_END_MARKER_REL)
+  codexHookRow("SessionEnd", null, 3, SESSION_END_MARKER_REL),
+  codexHookRow("SessionStart", null, 10, CONTEXT_BUDGET_CHECK_REL),
+  codexHookRow("PostToolUse", CODEX_WRITE_CAPABLE_TOOLS.join("|"), 5, CONTEXT_DRIFT_CHECK_REL)
 ];
 var RETIRED_CODEX_HOOK_COMMANDS = [];
 function codexHookCommandSet(retired) {
@@ -6431,6 +6452,8 @@ function kinds() {
     [".claude/hooks/user-prompt-findings.sh", "check-script"],
     [".claude/hooks/session-end-marker.sh", "check-script"],
     [".claude/hooks/session-start-marker.sh", "check-script"],
+    [".claude/hooks/context-budget-check.sh", "check-script"],
+    [".claude/hooks/context-drift-check.sh", "check-script"],
     [SETTINGS_REL, "settings"],
     [MCP_REGISTRATION_REL, "server-entry"],
     [GITIGNORE_REL, "ignore-list"],
@@ -8425,13 +8448,133 @@ var MCP_HEADERS_KNOWN_HEADER_HASHES = [
 function planMcpHeadersHelperRemoval(targetRepo) {
   return decideRetiredRemoval(targetRepo, RETIRED_MCP_HEADERS_HELPER_REL, 1, MCP_HEADERS_KNOWN_HEADER_HASHES);
 }
+var GENERATED_CONTEXT_BUDGET_HEADER = "# Context budget check \u2014 generated by";
+function generateContextBudgetCheck() {
+  return `#!/usr/bin/env bash
+${GENERATED_CONTEXT_BUDGET_HEADER} the Halfcycle installer.
+# Runs when a session starts. It warns, and never blocks, when the instructions
+# every session loads have grown past their budget, so they can be trimmed
+# before every later session pays for them:
+#   - AGENTS.md at the project root, over 16384 bytes;
+#   - this project's memory index in Claude Code, over 20480 bytes or 150 lines
+#     (Claude Code cuts the index off at about 25 KB or 200 lines when it loads it).
+
+cat >/dev/null 2>&1 || true
+
+SCRIPT_DIR="$( cd "$( dirname "\${BASH_SOURCE[0]}" )" && pwd -P )" || exit 0
+PROJECT_ROOT="$( cd "$SCRIPT_DIR/../.." && pwd -P )" || exit 0
+
+NOTES=""
+
+AGENTS_FILE="$PROJECT_ROOT/AGENTS.md"
+if [ -f "$AGENTS_FILE" ]; then
+  BYTES=$(wc -c < "$AGENTS_FILE" | tr -d ' ')
+  if [ "\${BYTES:-0}" -gt 16384 ]; then
+    NOTES="\${NOTES}AGENTS.md is \${BYTES} bytes, over its budget of 16384. "
+  fi
+fi
+
+CONFIG_DIR="\${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
+SLUG=$(printf '%s' "\${CLAUDE_PROJECT_DIR:-$PROJECT_ROOT}" | sed 's/[^A-Za-z0-9]/-/g')
+INDEX="$CONFIG_DIR/projects/$SLUG/memory/MEMORY.md"
+if [ -f "$INDEX" ]; then
+  BYTES=$(wc -c < "$INDEX" | tr -d ' ')
+  LINES=$(wc -l < "$INDEX" | tr -d ' ')
+  if [ "\${BYTES:-0}" -gt 20480 ] || [ "\${LINES:-0}" -gt 150 ]; then
+    NOTES="\${NOTES}The memory index is \${BYTES} bytes and \${LINES} lines, over its budget of 20480 bytes and 150 lines. "
+  fi
+fi
+
+if [ -z "$NOTES" ]; then exit 0; fi
+
+MESSAGE="Context budget: \${NOTES}Run the context-update command to fold and trim it."
+printf '{"systemMessage":"%s","hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"%s"}}\\n' "$MESSAGE" "$MESSAGE"
+exit 0
+`;
+}
+var GENERATED_CONTEXT_DRIFT_HEADER = "# Context drift check \u2014 generated by";
+function generateContextDriftCheck() {
+  return `#!/usr/bin/env bash
+${GENERATED_CONTEXT_DRIFT_HEADER} the Halfcycle installer.
+# Context drift detector \u2014 runs after each file edit. If a trigger file was modified,
+# it asks the session to run the context-update command before the session ends.
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+# First line: the event's name, for the reply. Then one line per edited file, made
+# absolute against the event's cwd: the edit's file_path, or every path a patch names.
+# With no python3 on the machine it says nothing, rather than fail after every edit.
+PARSED=$(HOOK_INPUT="$INPUT" python3 - <<'PYEOF'
+import json, os, re
+try:
+    data = json.loads(os.environ["HOOK_INPUT"])
+except Exception:
+    raise SystemExit(0)
+tool_input = data.get("tool_input") or {}
+cwd = data.get("cwd") or os.getcwd()
+if tool_input.get("file_path"):
+    paths = [tool_input["file_path"]]
+else:
+    headers = r"^\\*\\*\\* (?:Add File|Update File|Delete File|Move to): (.+)$"
+    paths = re.findall(headers, str(tool_input.get("command", "")), re.M)
+print(data.get("hook_event_name", ""))
+for p in paths:
+    print(os.path.realpath(os.path.join(cwd, p.strip())))
+PYEOF
+) || exit 0
+
+if [ -z "$PARSED" ]; then exit 0; fi
+HOOK_EVENT=$(printf '%s\\n' "$PARSED" | head -n 1)
+
+# Portable PROJECT_ROOT derivation: the script lives two folders below the root
+SCRIPT_DIR="$( cd "$( dirname "\${BASH_SOURCE[0]}" )" && pwd -P )"
+PROJECT_ROOT="$( cd "$SCRIPT_DIR/../.." && pwd -P )"
+
+REASONS=""
+while IFS= read -r FILE_PATH; do
+  [ -n "$FILE_PATH" ] || continue
+  case "$FILE_PATH" in
+    "$PROJECT_ROOT"/*) ;;
+    *) continue ;;
+  esac
+
+  REL_PATH="\${FILE_PATH#$PROJECT_ROOT/}"
+
+  # Skip the instructions files and each agent's own folders (editing them needs no reminder)
+  case "$REL_PATH" in
+    CLAUDE.md|AGENTS.md|README.md|.claude/*|.codex/*|.agents/*|dist/*|node_modules/*|.git/*)
+      continue ;;
+  esac
+
+  REASON=""
+  case "$REL_PATH" in
+    package.json|package-lock.json) REASON="package.json changed \u2014 check Tech Stack / Commands sections" ;;
+    wrangler.jsonc|wrangler.toml) REASON="wrangler config changed \u2014 check Deployment section" ;;
+    astro.config.*|next.config.*|vite.config.*) REASON="build config changed \u2014 check Tech Stack / Architecture" ;;
+    src/pages/api/*|src/routes/api/*|pages/api/*) REASON="API route changed \u2014 check API Endpoints" ;;
+    scripts/*) REASON="scripts/ changed \u2014 check Commands section" ;;
+    tsconfig.json|.eslintrc*|.prettierrc*) REASON="tool config changed \u2014 check Code Conventions" ;;
+  esac
+  if [ -n "$REASON" ]; then REASONS="\${REASONS}\${REL_PATH} was modified: \${REASON}. "; fi
+done < <(printf '%s\\n' "$PARSED" | tail -n +2)
+
+if [ -z "$REASONS" ]; then exit 0; fi
+
+REMINDER="Context drift detected. \${REASONS}Before ending this session, run the context-update command to audit and update AGENTS.md and the memory folder."
+python3 -c 'import json, sys; print(json.dumps({"hookSpecificOutput": {"hookEventName": sys.argv[1], "additionalContext": sys.argv[2]}}))' "$HOOK_EVENT" "$REMINDER"
+`;
+}
 var OWNED_GENERATED_HEADERS = {
   ".claude/hooks/guard-runner.sh": GENERATED_GUARD_RUNNER_HEADER,
   ".claude/hooks/user-prompt-reminder.sh": GENERATED_USER_PROMPT_REMINDER_HEADER,
   ".claude/hooks/user-prompt-scope.sh": GENERATED_USER_PROMPT_SCOPE_HEADER,
   ".claude/hooks/user-prompt-findings.sh": GENERATED_USER_PROMPT_FINDINGS_HEADER,
   ".claude/hooks/session-end-marker.sh": GENERATED_SESSION_END_HEADER,
-  ".claude/hooks/session-start-marker.sh": GENERATED_SESSION_START_HEADER
+  ".claude/hooks/session-start-marker.sh": GENERATED_SESSION_START_HEADER,
+  ".claude/hooks/context-budget-check.sh": GENERATED_CONTEXT_BUDGET_HEADER,
+  ".claude/hooks/context-drift-check.sh": GENERATED_CONTEXT_DRIFT_HEADER
 };
 function hookScriptsThisVersionWrites() {
   return [
@@ -8440,7 +8583,9 @@ function hookScriptsThisVersionWrites() {
     [".claude/hooks/user-prompt-reminder.sh", generateUserPromptReminderHook()],
     [".claude/hooks/user-prompt-scope.sh", generateUserPromptScopeHook()],
     [".claude/hooks/user-prompt-findings.sh", generateUserPromptFindingsHook()],
-    [".claude/hooks/session-start-marker.sh", generateSessionStartMarker()]
+    [".claude/hooks/session-start-marker.sh", generateSessionStartMarker()],
+    [".claude/hooks/context-budget-check.sh", generateContextBudgetCheck()],
+    [".claude/hooks/context-drift-check.sh", generateContextDriftCheck()]
   ];
 }
 function generateMcpRegistration(existing, mcpOrigin) {