halfcycle 0.5.1 → 0.5.3

package/dist/index.js

@@ -125,6 +125,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) {
@@ -201,6 +204,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 = [
@@ -210,7 +227,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),
@@ -402,7 +421,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) {
@@ -3139,16 +3160,43 @@ var ownerWaitDeclarationSchema = z23.object({
 var ownerWaitDeclarationsSchema = z23.object({ declarations: z23.array(ownerWaitDeclarationSchema) }).strict();
 var OWNER_WAIT_TOO_MANY = `This project already has ${String(OWNER_WAIT_ADDITIONS_MAX)} things added to what waits for the owner. Ask the owner to take one off on their settings page in the console first; it cannot be done by typing in chat.`;
 
-// ../events/dist/autonomy.js
+// ../events/dist/owner-wait-answer.js
 import { z as z24 } from "zod";
+var ownerWaitShortIdSchema = z24.string().regex(/^[0-9a-f]{8}$/);
+var OWNER_WAIT_ANSWER_ACTS = ["approve", "decline"];
+var ownerWaitAnswerActSchema = z24.enum(OWNER_WAIT_ANSWER_ACTS);
+var ownerWaitChatRequestSchema = z24.discriminatedUnion("act", [
+  z24.object({ act: z24.literal("approve"), wait: ownerWaitShortIdSchema }).strict(),
+  z24.object({ act: z24.literal("decline"), wait: ownerWaitShortIdSchema, note: scopeNoteWireSchema }).strict()
+]);
+function bareOutcome(outcome) {
+  return z24.object({ outcome: z24.literal(outcome) }).strict();
+}
+var ownerWaitChatResultSchema = z24.discriminatedUnion("outcome", [
+  z24.object({
+    outcome: z24.literal("recorded"),
+    act: ownerWaitAnswerActSchema,
+    question: z24.string().min(1)
+  }).strict(),
+  z24.object({ outcome: z24.literal("refused"), problems: z24.array(systemDescriptionProblemSchema).min(1) }).strict(),
+  bareOutcome("not-owner"),
+  bareOutcome("no-owner"),
+  bareOutcome("not-found"),
+  bareOutcome("ambiguous"),
+  bareOutcome("not-offered"),
+  bareOutcome("unavailable")
+]);
+
+// ../events/dist/autonomy.js
+import { z as z25 } from "zod";
 var AUTONOMY_CHANGED_IN = ["console", "chat"];
-var autonomyChangedInSchema = z24.enum(AUTONOMY_CHANGED_IN);
-var autonomySettingsSchema = z24.object({
-  on: z24.boolean(),
+var autonomyChangedInSchema = z25.enum(AUTONOMY_CHANGED_IN);
+var autonomySettingsSchema = z25.object({
+  on: z25.boolean(),
   // whether builds run on their own
-  mayPublish: z24.boolean(),
+  mayPublish: z25.boolean(),
   // whether builds may publish or release without waiting
-  maySpend: z24.boolean(),
+  maySpend: z25.boolean(),
   // whether builds may spend money or sign up without waiting
   changedAt: utcIso8601.nullable(),
   // when the setting last changed; null if never
@@ -3158,37 +3206,37 @@ var autonomySettingsSchema = z24.object({
   message: "says when and where it changed, or neither",
   path: ["changedIn"]
 });
-var autonomyChangeRequestSchema = z24.object({
-  on: z24.boolean(),
+var autonomyChangeRequestSchema = z25.object({
+  on: z25.boolean(),
   // the switch
-  mayPublish: z24.boolean(),
+  mayPublish: z25.boolean(),
   // the publish box
-  maySpend: z24.boolean()
+  maySpend: z25.boolean()
   // the spend box
 }).strict();
 var AUTONOMY_CHAT_ACTS = ["on", "off"];
-var autonomyChatActSchema = z24.enum(AUTONOMY_CHAT_ACTS);
-var autonomyChatRequestSchema = z24.object({
+var autonomyChatActSchema = z25.enum(AUTONOMY_CHAT_ACTS);
+var autonomyChatRequestSchema = z25.object({
   act: autonomyChatActSchema
   // what the owner typed
 }).strict();
-var autonomyChatResultSchema = z24.discriminatedUnion("outcome", [
-  z24.object({
-    outcome: z24.literal("recorded"),
-    on: z24.boolean()
+var autonomyChatResultSchema = z25.discriminatedUnion("outcome", [
+  z25.object({
+    outcome: z25.literal("recorded"),
+    on: z25.boolean()
     // whether builds now run on their own
   }).strict(),
-  z24.object({ outcome: z24.literal("not-owner") }).strict(),
-  z24.object({ outcome: z24.literal("no-owner") }).strict(),
-  z24.object({ outcome: z24.literal("not-offered") }).strict(),
-  z24.object({ outcome: z24.literal("unavailable") }).strict()
+  z25.object({ outcome: z25.literal("not-owner") }).strict(),
+  z25.object({ outcome: z25.literal("no-owner") }).strict(),
+  z25.object({ outcome: z25.literal("not-offered") }).strict(),
+  z25.object({ outcome: z25.literal("unavailable") }).strict()
 ]);
-var autonomyStateSchema = z24.object({
-  on: z24.boolean(),
+var autonomyStateSchema = z25.object({
+  on: z25.boolean(),
   // whether builds run on their own
-  mayPublish: z24.boolean(),
+  mayPublish: z25.boolean(),
   // whether builds may publish or release without waiting
-  maySpend: z24.boolean()
+  maySpend: z25.boolean()
   // whether builds may spend money or sign up without waiting
 }).strict();
 var autonomyStateFileSchema = autonomyStateSchema.extend({
@@ -3197,8 +3245,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 = z24.enum(AUTONOMY_ACTIVITY_KINDS);
-var autonomyActivityRowSchema = z24.object({
+var autonomyActivityKindSchema = z25.enum(AUTONOMY_ACTIVITY_KINDS);
+var autonomyActivityRowSchema = z25.object({
   kind: autonomyActivityKindSchema,
   // what happened
   phase: scopePhaseSchema,
@@ -3211,6 +3259,8 @@ var autonomyActivityRowSchema = z24.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) => {
@@ -3237,6 +3287,9 @@ var autonomyActivityRowSchema = z24.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"] });
   }
@@ -3244,11 +3297,11 @@ var autonomyActivityRowSchema = z24.object({
     ctx.addIssue({ code: "custom", message: "says how to undo it exactly when it can be undone", path: ["how"] });
   }
 });
-var autonomyActivitySchema = z24.object({
-  rows: z24.array(autonomyActivityRowSchema)
+var autonomyActivitySchema = z25.object({
+  rows: z25.array(autonomyActivityRowSchema)
   // newest first
 }).strict();
-var savedIdSchema = z24.string().min(1).max(64).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "must be lower-case letters, digits and single hyphens");
+var savedIdSchema = z25.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}`;
@@ -3269,33 +3322,33 @@ function isGitFolderSegment(segment) {
   return t === ".git" || /^git~\d+$/.test(t);
 }
 var SAVED_PATH_KEPT_IN = ["commit", "copy"];
-var savedPathSchema = z24.object({
-  path: z24.string().max(4096).refine(isProjectRelativePath, { message: "must be a path inside the project" }),
+var savedPathSchema = z25.object({
+  path: z25.string().max(4096).refine(isProjectRelativePath, { message: "must be a path inside the project" }),
   // the file, relative to the project
-  keptIn: z24.enum(SAVED_PATH_KEPT_IN)
+  keptIn: z25.enum(SAVED_PATH_KEPT_IN)
   // in the save's commit, or copied beside this file
 }).strict();
-var savedCommitSchema = z24.string().regex(/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/, "must be a full commit hash");
-var savedBranchSchema = z24.object({
-  name: z24.string().min(1).max(255).refine((n) => !hasControlCharacter(n) && !n.startsWith("-") && !n.includes("..") && n !== "HEAD", {
+var savedCommitSchema = z25.string().regex(/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/, "must be a full commit hash");
+var savedBranchSchema = z25.object({
+  name: z25.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 = z24.object({
+var savedSchema = z25.object({
   id: savedIdSchema,
   // what restore is typed with
   savedAt: utcIso8601,
   // when the copy was made
-  ref: z24.string().min(1),
+  ref: z25.string().min(1),
   // where the saved commit is kept
-  what: z24.string().min(1).max(2e3),
+  what: z25.string().min(1).max(2e3),
   // what the action would have changed, in words
-  paths: z24.array(savedPathSchema),
+  paths: z25.array(savedPathSchema),
   // every saved file
-  branches: z24.array(savedBranchSchema)
+  branches: z25.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 autonomyC8(agent, question, chose) {
@@ -4211,6 +4264,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"],
@@ -6166,13 +6221,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 [
@@ -6181,7 +6356,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) {