halfcycle 0.5.1 → 0.5.3

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),
@@ -395,15 +414,15 @@ function readReviewPart(raw) {
   const name = raw["name"];
   const built = raw["built"];
   const decidable = raw["decidable"];
-  const awaitingAnswer2 = raw["awaitingAnswer"];
+  const awaitingAnswer = raw["awaitingAnswer"];
   const sentBack = raw["sentBack"];
   if (!isNonEmptyString(part) || !isNonEmptyString(name))
     return null;
   if (typeof built !== "boolean" || typeof decidable !== "boolean")
     return null;
-  if (typeof awaitingAnswer2 !== "boolean" || typeof sentBack !== "boolean")
+  if (typeof awaitingAnswer !== "boolean" || typeof sentBack !== "boolean")
     return null;
-  return { part, name, built, decidable, awaitingAnswer: awaitingAnswer2, sentBack };
+  return { part, name, built, decidable, awaitingAnswer, sentBack };
 }
 function isPlainObject(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value))
@@ -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) {
@@ -4482,6 +4503,30 @@ var phaseReviewViewSchema = z20.discriminatedUnion("state", [
   phaseReviewOpenSchema,
   phaseReviewClosedSchema
 ]);
+function reviewPartAwaitingAnswer(part) {
+  return part.questions.some((q) => q.agentAnswer === void 0);
+}
+function reviewPartSentBackIn(part, round) {
+  return part.sentBack.some((s) => s.round === round);
+}
+function shownReviewEntryOf(view, shownAt) {
+  const parts = view.parts.map((p) => ({
+    part: p.part,
+    name: p.name,
+    built: p.built,
+    decidable: p.decidable,
+    awaitingAnswer: reviewPartAwaitingAnswer(p),
+    sentBack: reviewPartSentBackIn(p, view.round)
+  }));
+  return {
+    phase: view.phase,
+    number: view.number,
+    round: view.round,
+    reviewVersion: view.reviewVersion,
+    shownAt,
+    parts
+  };
+}
 
 // ../events/dist/build-record-v3.js
 var BUILD_RECORD_V3_FORMAT = "halfcycle-build-record/v3";
@@ -5125,8 +5170,35 @@ function ownerWaitClosedLineOf(item, question2) {
 }
 var OWNER_WAIT_DECLARATIONS_READ_FAILED = "Halfcycle could not read the decisions that waited for you.";
 
-// ../events/dist/pacing.js
+// ../events/dist/owner-wait-answer.js
 import { z as z32 } from "zod";
+var ownerWaitShortIdSchema = z32.string().regex(/^[0-9a-f]{8}$/);
+var OWNER_WAIT_ANSWER_ACTS = ["approve", "decline"];
+var ownerWaitAnswerActSchema = z32.enum(OWNER_WAIT_ANSWER_ACTS);
+var ownerWaitChatRequestSchema = z32.discriminatedUnion("act", [
+  z32.object({ act: z32.literal("approve"), wait: ownerWaitShortIdSchema }).strict(),
+  z32.object({ act: z32.literal("decline"), wait: ownerWaitShortIdSchema, note: scopeNoteWireSchema }).strict()
+]);
+function bareOutcome3(outcome) {
+  return z32.object({ outcome: z32.literal(outcome) }).strict();
+}
+var ownerWaitChatResultSchema = z32.discriminatedUnion("outcome", [
+  z32.object({
+    outcome: z32.literal("recorded"),
+    act: ownerWaitAnswerActSchema,
+    question: z32.string().min(1)
+  }).strict(),
+  z32.object({ outcome: z32.literal("refused"), problems: z32.array(systemDescriptionProblemSchema).min(1) }).strict(),
+  bareOutcome3("not-owner"),
+  bareOutcome3("no-owner"),
+  bareOutcome3("not-found"),
+  bareOutcome3("ambiguous"),
+  bareOutcome3("not-offered"),
+  bareOutcome3("unavailable")
+]);
+
+// ../events/dist/pacing.js
+import { z as z33 } from "zod";
 var CLAUDE_PLANS = Object.freeze([
   Object.freeze({ id: "pro", words: "Pro", startingAgents: 2 }),
   Object.freeze({ id: "max-5x", words: "Max (5\xD7)", startingAgents: 4 }),
@@ -5137,7 +5209,7 @@ var CLAUDE_PLANS = Object.freeze([
   Object.freeze({ id: "not-sure", words: "Not sure", startingAgents: 2 })
 ]);
 var CLAUDE_PLAN_IDS = Object.freeze(CLAUDE_PLANS.map((plan) => plan.id));
-var claudePlanSchema = z32.enum(CLAUDE_PLAN_IDS);
+var claudePlanSchema = z33.enum(CLAUDE_PLAN_IDS);
 var CLAUDE_PLAN_UNKNOWN = "not-sure";
 function claudePlanOf(id) {
   return CLAUDE_PLANS.find((plan) => plan.id === id) ?? CLAUDE_PLANS.find((plan) => plan.id === CLAUDE_PLAN_UNKNOWN) ?? CLAUDE_PLANS[0];
@@ -5146,21 +5218,21 @@ function claudePlanKnown(id) {
   return id !== null && id !== CLAUDE_PLAN_UNKNOWN;
 }
 var CLAUDE_PLAN_SET_IN = ["setup", "console"];
-var claudePlanSetInSchema = z32.enum(CLAUDE_PLAN_SET_IN);
+var claudePlanSetInSchema = z33.enum(CLAUDE_PLAN_SET_IN);
 var KEEP_FREE_PERCENTS = [0, 20];
-var keepFreePercentSchema = z32.union([z32.literal(KEEP_FREE_PERCENTS[0]), z32.literal(KEEP_FREE_PERCENTS[1])]);
+var keepFreePercentSchema = z33.union([z33.literal(KEEP_FREE_PERCENTS[0]), z33.literal(KEEP_FREE_PERCENTS[1])]);
 var PACE_AGENTS_MAX = 20;
 var PACE_WINDOW_KINDS = ["five-hour", "seven-day"];
-var paceWindowKindSchema = z32.enum(PACE_WINDOW_KINDS);
+var paceWindowKindSchema = z33.enum(PACE_WINDOW_KINDS);
 var PACE_WINDOW_WORDS = Object.freeze({
   "five-hour": "5-hour window",
   "seven-day": "weekly window"
 });
 var PACE_STATES = ["full", "slowing", "holding"];
-var paceStateSchema = z32.enum(PACE_STATES);
-var claudePlanRequestSchema = z32.object({ claudePlan: claudePlanSchema }).strict();
-var keepFreeRequestSchema = z32.object({ keepFreePercent: keepFreePercentSchema }).strict();
-var pacingSettingsSchema = z32.object({
+var paceStateSchema = z33.enum(PACE_STATES);
+var claudePlanRequestSchema = z33.object({ claudePlan: claudePlanSchema }).strict();
+var keepFreeRequestSchema = z33.object({ keepFreePercent: keepFreePercentSchema }).strict();
+var pacingSettingsSchema = z33.object({
   claudePlan: claudePlanSchema.nullable(),
   claudePlanSetIn: claudePlanSetInSchema.nullable(),
   keepFreePercent: keepFreePercentSchema
@@ -5168,43 +5240,43 @@ var pacingSettingsSchema = z32.object({
   message: "a plan says where it was given, and only a plan does",
   path: ["claudePlanSetIn"]
 });
-var pacingBasisTaskSchema = z32.object({
+var pacingBasisTaskSchema = z33.object({
   id: buildTaskIdSchema,
-  dependsOn: z32.array(buildTaskIdSchema).max(BUILD_SNAPSHOT_TASK_LIMIT),
-  budgetMinutes: z32.number().int().min(1).max(BUILD_TASK_BUDGET_MAX_MINUTES).optional(),
-  human: z32.boolean()
+  dependsOn: z33.array(buildTaskIdSchema).max(BUILD_SNAPSHOT_TASK_LIMIT),
+  budgetMinutes: z33.number().int().min(1).max(BUILD_TASK_BUDGET_MAX_MINUTES).optional(),
+  human: z33.boolean()
 }).strict();
-var pacingBasisSchema = z32.object({
-  outcome: z32.literal("basis"),
+var pacingBasisSchema = z33.object({
+  outcome: z33.literal("basis"),
   claudePlan: claudePlanSchema.nullable(),
   keepFreePercent: keepFreePercentSchema,
-  settingsUrl: z32.string().min(1),
+  settingsUrl: z33.string().min(1),
   phase: phaseNameSchema.nullable(),
-  tasks: z32.array(pacingBasisTaskSchema).max(BUILD_SNAPSHOT_TASK_LIMIT),
-  medianTaskMinutes: z32.number().nonnegative().nullable(),
-  medianTaskTokens: z32.number().nonnegative().nullable()
+  tasks: z33.array(pacingBasisTaskSchema).max(BUILD_SNAPSHOT_TASK_LIMIT),
+  medianTaskMinutes: z33.number().nonnegative().nullable(),
+  medianTaskTokens: z33.number().nonnegative().nullable()
 }).strict();
-var paceSuggestionSchema = z32.object({
-  number: z32.number().int().min(1).max(PACE_AGENTS_MAX),
-  minutes: z32.number().int().nonnegative().nullable(),
-  pauses: z32.number().int().nonnegative(),
+var paceSuggestionSchema = z33.object({
+  number: z33.number().int().min(1).max(PACE_AGENTS_MAX),
+  minutes: z33.number().int().nonnegative().nullable(),
+  pauses: z33.number().int().nonnegative(),
   claudePlan: claudePlanSchema.nullable(),
   keepFreePercent: keepFreePercentSchema,
-  settingsUrl: z32.string().min(1).nullable(),
+  settingsUrl: z33.string().min(1).nullable(),
   knownWindow: paceWindowKindSchema.nullable()
 }).strict();
 var PACE_NOT_PACED_REASONS = ["not-configured", "unreadable"];
-var paceRunResultSchema = z32.discriminatedUnion("outcome", [
-  z32.object({
-    outcome: z32.literal("paced"),
+var paceRunResultSchema = z33.discriminatedUnion("outcome", [
+  z33.object({
+    outcome: z33.literal("paced"),
     pace: paceStateSchema,
-    number: z32.number().int().min(1).max(PACE_AGENTS_MAX),
-    allowedNow: z32.number().int().nonnegative(),
+    number: z33.number().int().min(1).max(PACE_AGENTS_MAX),
+    allowedNow: z33.number().int().nonnegative(),
     windowKind: paceWindowKindSchema.optional(),
     until: utcIso8601.optional(),
     suggestion: paceSuggestionSchema.optional()
   }).strict(),
-  z32.object({ outcome: z32.literal("not-paced"), reason: z32.enum(PACE_NOT_PACED_REASONS) }).strict()
+  z33.object({ outcome: z33.literal("not-paced"), reason: z33.enum(PACE_NOT_PACED_REASONS) }).strict()
 ]);
 function paceAgentsOf(n) {
   return n === 1 ? "1 agent" : `${String(n)} agents`;
@@ -5289,15 +5361,15 @@ function paceAllowedNowOf(k) {
 var PACE_AGENTS_TOO_MANY = `Run at most ${String(PACE_AGENTS_MAX)} agents at once.`;
 
 // ../events/dist/autonomy.js
-import { z as z33 } from "zod";
+import { z as z34 } from "zod";
 var AUTONOMY_CHANGED_IN = ["console", "chat"];
-var autonomyChangedInSchema = z33.enum(AUTONOMY_CHANGED_IN);
-var autonomySettingsSchema = z33.object({
-  on: z33.boolean(),
+var autonomyChangedInSchema = z34.enum(AUTONOMY_CHANGED_IN);
+var autonomySettingsSchema = z34.object({
+  on: z34.boolean(),
   // whether builds run on their own
-  mayPublish: z33.boolean(),
+  mayPublish: z34.boolean(),
   // whether builds may publish or release without waiting
-  maySpend: z33.boolean(),
+  maySpend: z34.boolean(),
   // whether builds may spend money or sign up without waiting
   changedAt: utcIso8601.nullable(),
   // when the setting last changed; null if never
@@ -5307,37 +5379,37 @@ var autonomySettingsSchema = z33.object({
   message: "says when and where it changed, or neither",
   path: ["changedIn"]
 });
-var autonomyChangeRequestSchema = z33.object({
-  on: z33.boolean(),
+var autonomyChangeRequestSchema = z34.object({
+  on: z34.boolean(),
   // the switch
-  mayPublish: z33.boolean(),
+  mayPublish: z34.boolean(),
   // the publish box
-  maySpend: z33.boolean()
+  maySpend: z34.boolean()
   // the spend box
 }).strict();
 var AUTONOMY_CHAT_ACTS = ["on", "off"];
-var autonomyChatActSchema = z33.enum(AUTONOMY_CHAT_ACTS);
-var autonomyChatRequestSchema = z33.object({
+var autonomyChatActSchema = z34.enum(AUTONOMY_CHAT_ACTS);
+var autonomyChatRequestSchema = z34.object({
   act: autonomyChatActSchema
   // what the owner typed
 }).strict();
-var autonomyChatResultSchema = z33.discriminatedUnion("outcome", [
-  z33.object({
-    outcome: z33.literal("recorded"),
-    on: z33.boolean()
+var autonomyChatResultSchema = z34.discriminatedUnion("outcome", [
+  z34.object({
+    outcome: z34.literal("recorded"),
+    on: z34.boolean()
     // whether builds now run on their own
   }).strict(),
-  z33.object({ outcome: z33.literal("not-owner") }).strict(),
-  z33.object({ outcome: z33.literal("no-owner") }).strict(),
-  z33.object({ outcome: z33.literal("not-offered") }).strict(),
-  z33.object({ outcome: z33.literal("unavailable") }).strict()
+  z34.object({ outcome: z34.literal("not-owner") }).strict(),
+  z34.object({ outcome: z34.literal("no-owner") }).strict(),
+  z34.object({ outcome: z34.literal("not-offered") }).strict(),
+  z34.object({ outcome: z34.literal("unavailable") }).strict()
 ]);
-var autonomyStateSchema = z33.object({
-  on: z33.boolean(),
+var autonomyStateSchema = z34.object({
+  on: z34.boolean(),
   // whether builds run on their own
-  mayPublish: z33.boolean(),
+  mayPublish: z34.boolean(),
   // whether builds may publish or release without waiting
-  maySpend: z33.boolean()
+  maySpend: z34.boolean()
   // whether builds may spend money or sign up without waiting
 }).strict();
 var autonomyStateFileSchema = autonomyStateSchema.extend({
@@ -5346,8 +5418,8 @@ var autonomyStateFileSchema = autonomyStateSchema.extend({
 }).strict();
 var AUTONOMY_STATE_FILE_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
 var AUTONOMY_ACTIVITY_KINDS = ["went-ahead", "waiting", "approved", "closed", "waiting-on-owner"];
-var autonomyActivityKindSchema = z33.enum(AUTONOMY_ACTIVITY_KINDS);
-var autonomyActivityRowSchema = z33.object({
+var autonomyActivityKindSchema = z34.enum(AUTONOMY_ACTIVITY_KINDS);
+var autonomyActivityRowSchema = z34.object({
   kind: autonomyActivityKindSchema,
   // what happened
   phase: scopePhaseSchema,
@@ -5360,6 +5432,8 @@ var autonomyActivityRowSchema = z33.object({
   // whether the agent says it can be undone
   how: statementText(STATEMENT_MAX).optional(),
   // how to undo it, when it can be
+  wait: ownerWaitShortIdSchema.optional(),
+  // the short id the owner types to answer a waiting decision
   at: utcIso8601
   // when it happened
 }).strict().superRefine((row, ctx) => {
@@ -5386,6 +5460,9 @@ var autonomyActivityRowSchema = z33.object({
       });
     }
   }
+  if (row.kind !== "waiting" && row.wait !== void 0) {
+    ctx.addIssue({ code: "custom", message: "only a waiting decision is answered by typing", path: ["wait"] });
+  }
   if (row.kind === "waiting" && (row.undoable !== void 0 || row.how !== void 0)) {
     ctx.addIssue({ code: "custom", message: "a waiting decision has not been made yet", path: ["undoable"] });
   }
@@ -5393,11 +5470,11 @@ var autonomyActivityRowSchema = z33.object({
     ctx.addIssue({ code: "custom", message: "says how to undo it exactly when it can be undone", path: ["how"] });
   }
 });
-var autonomyActivitySchema = z33.object({
-  rows: z33.array(autonomyActivityRowSchema)
+var autonomyActivitySchema = z34.object({
+  rows: z34.array(autonomyActivityRowSchema)
   // newest first
 }).strict();
-var savedIdSchema = z33.string().min(1).max(64).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "must be lower-case letters, digits and single hyphens");
+var savedIdSchema = z34.string().min(1).max(64).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "must be lower-case letters, digits and single hyphens");
 var SAVED_REF_PREFIX = "refs/halfcycle/saved/";
 function savedRefOf(id) {
   return `${SAVED_REF_PREFIX}${id}`;
@@ -5436,33 +5513,33 @@ function isGitFolderSegment(segment) {
   return t === ".git" || /^git~\d+$/.test(t);
 }
 var SAVED_PATH_KEPT_IN = ["commit", "copy"];
-var savedPathSchema = z33.object({
-  path: z33.string().max(4096).refine(isProjectRelativePath, { message: "must be a path inside the project" }),
+var savedPathSchema = z34.object({
+  path: z34.string().max(4096).refine(isProjectRelativePath, { message: "must be a path inside the project" }),
   // the file, relative to the project
-  keptIn: z33.enum(SAVED_PATH_KEPT_IN)
+  keptIn: z34.enum(SAVED_PATH_KEPT_IN)
   // in the save's commit, or copied beside this file
 }).strict();
-var savedCommitSchema = z33.string().regex(/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/, "must be a full commit hash");
-var savedBranchSchema = z33.object({
-  name: z33.string().min(1).max(255).refine((n) => !hasControlCharacter(n) && !n.startsWith("-") && !n.includes("..") && n !== "HEAD", {
+var savedCommitSchema = z34.string().regex(/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/, "must be a full commit hash");
+var savedBranchSchema = z34.object({
+  name: z34.string().min(1).max(255).refine((n) => !hasControlCharacter(n) && !n.startsWith("-") && !n.includes("..") && n !== "HEAD", {
     message: "must be a branch name"
   }),
   // the branch's name
   commit: savedCommitSchema
   // the commit it pointed at
 }).strict();
-var savedSchema = z33.object({
+var savedSchema = z34.object({
   id: savedIdSchema,
   // what restore is typed with
   savedAt: utcIso8601,
   // when the copy was made
-  ref: z33.string().min(1),
+  ref: z34.string().min(1),
   // where the saved commit is kept
-  what: z33.string().min(1).max(2e3),
+  what: z34.string().min(1).max(2e3),
   // what the action would have changed, in words
-  paths: z33.array(savedPathSchema),
+  paths: z34.array(savedPathSchema),
   // every saved file
-  branches: z33.array(savedBranchSchema)
+  branches: z34.array(savedBranchSchema)
   // every saved line of work
 }).strict().refine((s) => s.ref === savedRefOf(s.id), { message: "must be the ref of this save", path: ["ref"] });
 function autonomyA13(accepted, carried) {
@@ -5472,8 +5549,9 @@ function autonomyA14(count, parts, acceptLine) {
   const typed = acceptLine === null ? 'say "review what was built" and type the lines it gives.' : `say "review what was built", then type ${acceptLine} to accept them with those parts, or type the reject line it gives for a task's tests.`;
   return `The phase waits for you: ${String(count)} tests the agents said pass were not run by Halfcycle, so ${namesOf(parts)} wait for you too. Only you can accept or reject those tests. In your own coding agent's session, ` + typed;
 }
-function autonomyA15(count) {
-  return `The phase waits for you: ${String(count)} parts were built without an approved scope, and only you can decide them.`;
+function autonomyA15(count, acceptLine) {
+  const typed = acceptLine === null ? 'say "review what was built" and type the lines it gives.' : `type ${acceptLine} to accept them and close the phase, or say "review what was built" to decide one differently.`;
+  return `The phase waits for you: ${String(count)} parts were built without an approved scope or outside the plan, and only you can decide them. In your own coding agent's session, ${typed}`;
 }
 function namesOf(names) {
   if (names.length <= 1)
@@ -6431,6 +6509,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 +8505,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 +8640,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) {
@@ -14044,20 +14246,14 @@ var CHANGE_WORDS = {
   remove: "planned to be removed",
   "not-in-plan": "not in the plan"
 };
-function awaitingAnswer(part) {
-  return part.questions.some((q) => q.agentAnswer === void 0);
-}
-function sentBackInRound(part, round) {
-  return part.sentBack.some((s) => s.round === round);
-}
 function partStatus(part, round) {
   const settled = settledStatus(part);
   if (settled !== void 0) {
     return part.givenIn === "autonomy" ? `${settled}, ${DECIDED_BY_AUTONOMY_SENTENCE}` : settled;
   }
-  if (awaitingAnswer(part))
+  if (reviewPartAwaitingAnswer(part))
     return "Waiting for the agent's answer";
-  if (sentBackInRound(part, round))
+  if (reviewPartSentBackIn(part, round))
     return "Sent back, waiting for the next round";
   return "Waits for your decision";
 }
@@ -14232,22 +14428,7 @@ var AN3_LINE = "halfcycle review: the answer must be one paragraph of at most 1,
 var AN4_LINE = "halfcycle review: the answer looks like it holds a password or key, so it was not sent. Write it again without it.";
 var AN5_LINE = "halfcycle review: the answer was not accepted. Reword it in plain words and run this again.";
 function shownReviewEntry(view, shownAt) {
-  const parts = view.parts.map((p) => ({
-    part: p.part,
-    name: p.name,
-    built: p.built,
-    decidable: p.decidable,
-    awaitingAnswer: awaitingAnswer(p),
-    sentBack: sentBackInRound(p, view.round)
-  }));
-  return {
-    phase: view.phase,
-    number: view.number,
-    round: view.round,
-    reviewVersion: view.reviewVersion,
-    shownAt,
-    parts
-  };
+  return shownReviewEntryOf(view, shownAt);
 }
 function writeShownReview(engagementId, entry, home) {
   const written = updateShownRecord(engagementId, (current) => ({
@@ -14719,7 +14900,7 @@ function closeStepReport(phase, attempt, engagementId) {
           exitCode = 0;
           break;
         case "autonomy-waits":
-          stdout.push(answer.reason === "unchecked-claims" ? autonomyA14(answer.count, answer.parts.map((p) => p.name), typedAcceptLine(phase)) : autonomyA15(answer.count));
+          stdout.push(answer.reason === "unchecked-claims" ? autonomyA14(answer.count, answer.parts.map((p) => p.name), typedAcceptLine(phase)) : autonomyA15(answer.count, typedAcceptLine(phase)));
           exitCode = 0;
           break;
         default: