aiwcli 0.15.5 → 0.17.0

package/dist/templates/core/.codex/skills/handoff-resume/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: handoff-resume
+description: Resume session from a handoff document. USE WHEN resume handoff OR continue from handoff OR restore session context OR pick up where we left off.
+user-invocable: true
+---
+
+# Handoff Resume
+
+Load and execute the handoff resume workflow from `.aiwcli/_core/skills/handoff-system/workflows/handoff-resume.md`.
+
+**Triggers:** "/handoff-resume", "resume handoff", "continue from handoff", "restore session", "pick up where we left off"

package/dist/templates/core/.codex/skills/meta-plan/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: meta-plan
+description: Prompt amplifier for complex problems. USE WHEN meta-plan OR chain reasoning OR dissect problem OR help me figure out the right approach.
+user-invocable: true
+---
+
+# MetaPlan -- Prompt Amplifier
+
+Load and engage with the reasoning framework at `.aiwcli/_core/skills/meta-plan/workflows/meta-plan.md`. Apply each category as a lens for deeper analysis -- not as steps to execute.
+
+**Triggers:** "meta-plan", "chain reasoning", "dissect problem", "help me figure out the right approach"
+
+**Produces:** An amplified request document (problem decomposition, approaches, trade-offs, risks, recommendation). Does NOT produce implementation steps -- those are the next session's job.

package/dist/templates/core/.devin/AGENTS.md

@@ -0,0 +1,5 @@
+# Devin Notes
+
+On Windows, keep any filesystem paths that appear in `.devin` config text or agent instructions in forward-slash form when they are meant to be read by Devin.
+
+Reason: raw backslash paths like `C:\tmp\foo.txt` are easy for the runtime to preserve but easy for the model-side parser to misread or de-escape. Use `C:/tmp/foo.txt` in human-readable instructions; keep native Windows paths only where a shell or PowerShell command is actually executing them.

package/dist/templates/core/.devin/config.json

@@ -0,0 +1,12 @@
+{
+  "permissions": {
+    "allow": ["read", "edit", "grep", "glob", "exec", "mcp__*"],
+    "deny": [],
+    "ask": []
+  },
+  "read_config_from": {
+    "cursor": true,
+    "windsurf": true,
+    "claude": true
+  }
+}

package/dist/templates/core/.devin/skills/codex/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: codex
+description: Delegate implementation to Codex sub-agents. USE WHEN codex OR send to codex OR codex implement OR hand off to codex OR launch codex OR run codex.
+user-invocable: true
+---
+
+# Codex Workflow
+
+Delegate work to a Codex sub-agent. The launch script handles prompt construction internally — you just run the command and pass the mode/flags.
+
+**IMPORTANT:** Never include the launch command path, script path, or any `.aiwcli/` internal paths in the delegation prompt or inline text arguments. The script constructs Codex's prompt internally. Leaking internal paths into the prompt causes Codex to recurse.
+
+## Command
+
+`bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_core/skills/codex/scripts/launch-codex.ts [flags] <mode>`
+
+**Modes:** `plan` | `--file <path>` | `<inline text...>`
+
+**Flags:** `--model <name>`, `--sandbox <mode>`, `--context <id>`, `--prompt <text>`, `--no-yolo`, `--no-watch`

package/dist/templates/core/.devin/skills/devin/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: devin
+description: "Self-reference guard: you ARE Devin. Do not invoke this skill."
+user-invocable: false
+---
+
+# Devin (Self-Reference Guard)
+
+**You are already running as Devin.** Do not attempt to launch another Devin instance.
+
+If asked to delegate work to Devin, you should perform the work directly — you are the Devin agent.
+
+To delegate to a *different* agent, use the codex skill instead.

package/dist/templates/core/.devin/skills/handoff/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: handoff
+description: Create handoff document to preserve session context for future sessions. USE WHEN handoff OR write a handoff OR create session summary OR document what we did OR end session with notes.
+user-invocable: true
+---
+
+# Handoff
+
+Load and execute the handoff workflow from `.aiwcli/_core/skills/handoff-system/workflows/handoff.md`.
+
+**Triggers:** "/handoff", "write a handoff", "create a session summary", "document what we did", "end session with notes"

package/dist/templates/core/.devin/skills/handoff-resume/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: handoff-resume
+description: Resume session from a handoff document. USE WHEN resume handoff OR continue from handoff OR restore session context OR pick up where we left off.
+user-invocable: true
+---
+
+# Handoff Resume
+
+Load and execute the handoff resume workflow from `.aiwcli/_core/skills/handoff-system/workflows/handoff-resume.md`.
+
+**Triggers:** "/handoff-resume", "resume handoff", "continue from handoff", "restore session", "pick up where we left off"

package/dist/templates/core/.devin/skills/meta-plan/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: meta-plan
+description: Prompt amplifier for complex problems. USE WHEN meta-plan OR chain reasoning OR dissect problem OR help me figure out the right approach.
+user-invocable: true
+---
+
+# MetaPlan -- Prompt Amplifier
+
+Load and engage with the reasoning framework at `.aiwcli/_core/skills/meta-plan/workflows/meta-plan.md`. Apply each category as a lens for deeper analysis -- not as steps to execute.
+
+**Triggers:** "meta-plan", "chain reasoning", "dissect problem", "help me figure out the right approach"
+
+**Produces:** An amplified request document (problem decomposition, approaches, trade-offs, risks, recommendation). Does NOT produce implementation steps -- those are the next session's job.

package/dist/templates/core/.windsurf/workflows/handoff-resume.md

@@ -0,0 +1,9 @@
+---
+description: Resume session from a handoff document
+---
+
+# Handoff Resume
+
+Load and execute the handoff resume workflow from `.aiwcli/_core/skills/handoff-system/workflows/handoff-resume.md`.
+
+**Triggers:** "/handoff-resume", "resume handoff", "continue from handoff", "restore session", "pick up where we left off"

package/dist/templates/{_shared → core}/.windsurf/workflows/handoff.md

@@ -4,6 +4,6 @@ description: Create handoff document to preserve session context for future sess
 
 # Handoff
 
-Load and execute the handoff workflow from `.aiwcli/_shared/skills/handoff-system/workflows/handoff.md`.
+Load and execute the handoff workflow from `.aiwcli/_core/skills/handoff-system/workflows/handoff.md`.
 
 **Triggers:** "/handoff", "write a handoff", "create a session summary", "document what we did", "end session with notes"

package/dist/templates/{_shared → core}/.windsurf/workflows/meta-plan.md

@@ -4,7 +4,7 @@ description: Prompt amplifier for complex problems — analyzes a request throug
 
 # MetaPlan — Prompt Amplifier
 
-Load and engage with the reasoning framework at `.aiwcli/_shared/skills/meta-plan/workflows/meta-plan.md`. Apply each category as a lens for deeper analysis — not as steps to execute.
+Load and engage with the reasoning framework at `.aiwcli/_core/skills/meta-plan/workflows/meta-plan.md`. Apply each category as a lens for deeper analysis — not as steps to execute.
 
 **Triggers:** "meta-plan", "chain reasoning", "dissect problem", "help me figure out the right approach"
 

package/dist/templates/core/hooks-ts/_utils/git-state.ts

@@ -0,0 +1,2 @@
+// Re-export from shared library — canonical location is lib-ts/runtime/git-state.ts
+export { getGitState } from "../../lib-ts/runtime/git-state.js";

package/dist/templates/{_shared → core}/hooks-ts/archive_plan.ts

@@ -6,42 +6,21 @@
  */
 import * as fs from "node:fs";
 import * as os from "node:os";
-import * as path from "node:path";
+import path from "node:path";
 
-import { getContextDir, getProjectRoot } from "../lib-ts/base/constants.js";
-import {
-  loadHookInput, logDebug, logError, logInfo, logWarn, runHookAsync,
-} from "../lib-ts/base/hook-utils.js";
-import { getContextBySessionId } from "../lib-ts/context/context-store.js";
 import {
   archivePlan, extractPlanPathFromResult, findPlanPathInTranscript,
 } from "../lib-ts/context/plan-manager.js";
-
-/** Find the most recent .md file in a directory */
-function mostRecentMd(dir: string): null | string {
-  try {
-    if (!fs.existsSync(dir)) return null;
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-    let best: null | { mtime: number; path: string; } = null;
-    for (const e of entries) {
-      if (!e.isFile() || !e.name.endsWith(".md")) continue;
-      const fullPath = path.join(dir, e.name);
-      const stat = fs.statSync(fullPath);
-      if (!best || stat.mtimeMs > best.mtime) {
-        best = { path: fullPath, mtime: stat.mtimeMs };
-      }
-    }
-
-    return best?.path ?? null;
-  } catch {
-    return null;
-  }
-}
+import {
+  loadHookInput, logDebug, logError, logInfo, logWarn, requireBoundSession, runHookAsync,
+} from "../lib-ts/hooks/hook-utils.js";
+import { getContextDir } from "../lib-ts/runtime/constants.js";
+import { mostRecentMd } from "../lib-ts/runtime/utils.js";
 
 /** Multi-strategy plan path discovery */
-function findPlanPath(payload: Record<string, any>, projectRoot: string): null | string {
+function findPlanPath(payload: Record<string, unknown>, projectRoot: string): null | string {
   const toolResult = payload.tool_result as string | undefined;
-  const toolInput = (payload.tool_input ?? {}) as Record<string, any>;
+  const toolInput = (payload.tool_input ?? {}) as Record<string, unknown>;
   const transcriptPath = payload.transcript_path as string | undefined;
 
   // Strategy 1: Extract from tool result
@@ -100,20 +79,17 @@ async function asyncMain(): Promise<void> {
   }
 
   // Check stop flag
-  if ((payload as any).stop_hook_active) {
+  if ((payload as unknown).stop_hook_active) {
     logDebug("archive_plan", "stop_hook_active set, skipping");
     return;
   }
 
-  const projectRoot = getProjectRoot(payload.cwd);
-  const sessionId = payload.session_id;
-  if (!sessionId) {
-    logWarn("archive_plan", "No session_id");
-    return;
-  }
+  const bound = requireBoundSession("archive_plan", payload);
+  if (!bound) return;
+  const { projectRoot, state } = bound;
 
   // Find plan path
-  let planPath = findPlanPath(payload as Record<string, any>, projectRoot);
+  let planPath = findPlanPath(payload as Record<string, unknown>, projectRoot);
   if (!planPath) {
     logWarn("archive_plan", "Could not locate plan file");
     return;
@@ -130,13 +106,6 @@ async function asyncMain(): Promise<void> {
     return;
   }
 
-  // Find bound context
-  const state = getContextBySessionId(sessionId, projectRoot);
-  if (!state) {
-    logWarn("archive_plan", `No context bound to session ${sessionId}`);
-    return;
-  }
-
   // Archive the plan (async — uses AI for slug generation)
   const [archivedPath, planHash, _planSignature] = await archivePlan(planPath, state.id, projectRoot);
 
@@ -157,3 +126,5 @@ async function asyncMain(): Promise<void> {
 }
 
 runHookAsync(asyncMain, "archive_plan");
+
+

package/dist/templates/core/hooks-ts/codex_explorer.ts

@@ -0,0 +1,160 @@
+#!/usr/bin/env bun
+/**
+ * UserPromptSubmit hook: One-shot Codex codebase exploration for first plan-mode prompt.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+import {
+  emitContext, loadHookInput, logDebug, logInfo, logWarn, runHookAsync,
+} from "../lib-ts/hooks/hook-utils.js";
+import { getOutputDir, getProjectRoot } from "../lib-ts/runtime/constants.js";
+import { codexInferAsync } from "../lib-ts/runtime/inference.js";
+import { CODEX_MODELS } from "../lib-ts/runtime/models.js";
+
+const MAX_PROMPT_CHARS = 8000;
+const SPARK_TIMEOUT_SECONDS = 50;
+const FIRED_FILENAME = ".codex-explorer-fired";
+const MAX_FIRED_LINES = 200;
+const PRUNE_KEEP = 100;
+
+function getCacheFilePath(projectRoot: string): string {
+  return path.join(getOutputDir(projectRoot), FIRED_FILENAME);
+}
+
+function hasSessionFired(sessionId: string, projectRoot: string): boolean {
+  const filePath = getCacheFilePath(projectRoot);
+  try {
+    const content = fs.readFileSync(filePath, "utf8");
+    return content.split("\n").includes(sessionId);
+  } catch {
+    return false;
+  }
+}
+
+function markSessionFired(sessionId: string, projectRoot: string): void {
+  const filePath = getCacheFilePath(projectRoot);
+  const outputDir = getOutputDir(projectRoot);
+
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  fs.appendFileSync(filePath, sessionId + "\n");
+
+  // Prune if over limit
+  try {
+    const content = fs.readFileSync(filePath, "utf8");
+    const lines = content.split("\n").filter(Boolean);
+    if (lines.length > MAX_FIRED_LINES) {
+      const pruned = lines.slice(lines.length - PRUNE_KEEP);
+      fs.writeFileSync(filePath, pruned.join("\n") + "\n");
+      logDebug("codex_explorer", `Pruned fired cache from ${lines.length} to ${pruned.length} entries`);
+    }
+  } catch (error) {
+    logWarn("codex_explorer", `Failed to prune fired cache: ${error}`);
+  }
+}
+
+/**
+ * Parse Codex JSONL output into clean agent message text.
+ * Codex --json returns streaming events; we extract only agent_message text.
+ */
+function parseCodexOutput(raw: string): string {
+  const lines = raw.split("\n").filter(Boolean);
+  const parts: string[] = [];
+  for (const line of lines) {
+    try {
+      const event = JSON.parse(line);
+      if (event.type !== "item.completed") continue;
+      const item = event.item;
+      if (item?.type === "agent_message" && item.text) {
+        parts.push(item.text);
+      }
+    } catch { /* skip non-JSON lines */ }
+  }
+  return parts.join("\n\n") || raw;
+}
+
+function buildExplorerPrompt(userPrompt: string): string {
+  const trimmed = userPrompt.trim();
+  const clipped = trimmed.length > MAX_PROMPT_CHARS
+    ? `${trimmed.slice(0, MAX_PROMPT_CHARS)}...`
+    : trimmed;
+
+  return [
+    "You are a codebase explorer.",
+    "The user is starting planning work in plan mode.",
+    "Search the current repository and identify the most relevant files, patterns, and types.",
+    "",
+    "Focus on:",
+    "- Files likely to require changes",
+    "- Existing utilities/helpers that match the request",
+    "- Key functions, classes, types, and interfaces",
+    "- Relevant tests and configuration files",
+    "",
+    "Return a concise report (maximum ~2000 characters).",
+    "Do not suggest implementation steps. Only report what exists and where.",
+    "",
+    "User prompt:",
+    "---",
+    clipped,
+    "---",
+  ].join("\n");
+}
+
+async function main(): Promise<void> {
+  const payload = loadHookInput();
+  if (!payload) return;
+
+  const permissionMode = payload.permission_mode ?? "";
+  if (permissionMode !== "plan") {
+    logDebug("codex_explorer", `Skip: permission_mode=${permissionMode || "none"}`);
+    return;
+  }
+
+  const prompt = (payload as unknown as { prompt?: string }).prompt?.trim() ?? "";
+  if (!prompt) {
+    logDebug("codex_explorer", "Skip: no prompt");
+    return;
+  }
+
+  const sessionId = payload.session_id;
+  if (!sessionId) {
+    logDebug("codex_explorer", "Skip: no session_id");
+    return;
+  }
+
+  const projectRoot = getProjectRoot(payload.cwd);
+
+  if (hasSessionFired(sessionId, projectRoot)) {
+    logDebug("codex_explorer", `Skip: already fired for session ${sessionId}`);
+    return;
+  }
+
+  const startedAt = Date.now();
+  const explorerPrompt = buildExplorerPrompt(prompt);
+  const result = await codexInferAsync(
+    explorerPrompt,
+    CODEX_MODELS.spark,
+    { sandbox: "read-only", timeout: SPARK_TIMEOUT_SECONDS },
+  );
+  const elapsedMs = Date.now() - startedAt;
+
+  if (!result.success || !result.output) {
+    logWarn(
+      "codex_explorer",
+      `Explorer inference failed after ${elapsedMs}ms: ${result.error ?? "empty output"}`,
+    );
+    return;
+  }
+
+  const cleanOutput = parseCodexOutput(result.output);
+  emitContext(cleanOutput);
+  logInfo("codex_explorer", `Explorer context emitted in ${elapsedMs}ms`);
+
+  markSessionFired(sessionId, projectRoot);
+  logDebug("codex_explorer", `Marked session ${sessionId} as fired`);
+}
+
+runHookAsync(main, "codex_explorer");

package/dist/templates/{_shared → core}/hooks-ts/context_monitor.ts

@@ -3,53 +3,28 @@
  * PostToolUse:* hook: Monitor context window usage, trigger mode transitions,
  * and progressive-save state when context runs low.
  */
-import { getProjectRoot } from "../lib-ts/base/constants.js";
+import { getContextBySessionId, saveState } from "../lib-ts/context/context-store.js";
+import { selectWarningMessage } from "../lib-ts/hooks/context-monitor-logic.js";
 import {
   emitContext, getContextPercentRemaining, hookLog,
-  loadHookInput,
-  logDebug, logDiagnostic, logInfo, logWarn, runHook,
-} from "../lib-ts/base/hook-utils.js";
-import { nowIso } from "../lib-ts/base/utils.js";
-import { getContextBySessionId, maybeActivate, saveState } from "../lib-ts/context/context-store.js";
+  requireBoundSession, logDebug, logDiagnostic, logInfo, runHook, safeMaybeActivate,
+} from "../lib-ts/hooks/hook-utils.js";
+import { nowIso } from "../lib-ts/runtime/utils.js";
 import type { ContextState } from "../lib-ts/types.js";
 
 const WRITE_TOOLS = new Set(["Bash", "Edit", "NotebookEdit", "Write"]);
 
 const SAVE_STATE_THRESHOLD = 60;
 
-const CONTEXT_WARNING_30 = "## Context Window: ~30% Remaining\n\n" +
-  "This session is approaching its context limit. Consider:\n\n" +
-  "- Completing your current task, then pausing for the user to decide next steps\n" +
-  "- If significant work remains, mention that `/aiwcli-shared:handoff` can capture progress " +
-  "for a fresh session\n\n" +
-  "Do not rush or cut corners — finish the current task properly. " +
-  "Just be aware that starting large new tasks may not complete before context runs out.";
-
-const CONTEXT_WARNING_15 = "## Context Window: ~15% Remaining — Wrap Up Now\n\n" +
-  "Context is critically low. After completing your current step:\n\n" +
-  "1. **Stop taking on new work**\n" +
-  "2. Summarize what was accomplished and what remains\n" +
-  "3. Offer to run `/aiwcli-shared:handoff` so progress transfers to a fresh session\n\n" +
-  "Do not start new multi-step tasks. Focus on clean closure.";
-
-const WARNING_THRESHOLDS = [
-  { pct: 15, msg: CONTEXT_WARNING_15 },  // Most urgent first
-  { pct: 30, msg: CONTEXT_WARNING_30 },
-];
-
-/** Transition idle/has_plan → active when implementation tools are used. */
+/** Transition idle/has_staged_work → active when implementation tools are used. */
 function checkAndTransitionMode(
-  state: ContextState,
+  stateId: string,
   toolName: string | undefined,
   permissionMode: string,
   projectRoot: string,
 ): void {
   if (!toolName || !WRITE_TOOLS.has(toolName)) return;
-  try {
-    maybeActivate(state.id, permissionMode, projectRoot, "context_monitor");
-  } catch (error) {
-    logWarn("context_monitor", `maybeActivate failed (non-critical): ${error}`);
-  }
+  safeMaybeActivate(stateId, permissionMode, projectRoot, "context_monitor");
 }
 
 /** Save state snapshot at SAVE_STATE_THRESHOLD. */
@@ -82,38 +57,31 @@ function checkContextWarnings(
     state.last_session = {};
   }
   const fired = state.last_session.context_warnings_fired ?? [];
-
-  for (const { pct, msg } of WARNING_THRESHOLDS) {
-    if (pctRemaining <= pct && !fired.includes(pct)) {
-      emitContext(msg);
-      state.last_session.context_warnings_fired = [...fired, pct];
-      saveState(state.id, state, projectRoot);
-      logInfo("context_monitor", `Context warning emitted at ${pct}% threshold`);
-      return; // One warning per tool call — most urgent fires first
-    }
-  }
+  const warning = selectWarningMessage(pctRemaining, fired);
+  if (!warning) return;
+
+  emitContext(warning.msg);
+  state.last_session.context_warnings_fired = [...fired, warning.pct];
+  saveState(state.id, state, projectRoot);
+  logInfo(
+    "context_monitor",
+    `Context warning emitted at ${warning.pct}% threshold`,
+  );
 }
 
 function main(): void {
-  const payload = loadHookInput();
-  if (!payload) return;
+  const bound = requireBoundSession("context_monitor");
+  if (!bound) return;
 
-  const sessionId = payload.session_id;
-  if (!sessionId) return;
-
-  const projectRoot = getProjectRoot(payload.cwd);
+  const { payload, sessionId, projectRoot } = bound;
   const permissionMode = payload.permission_mode ?? "";
   const toolName = payload.tool_name;
 
   // Initial context lookup
-  let state = getContextBySessionId(sessionId, projectRoot);
-  if (!state) {
-    logDebug("context_monitor", `No context for session ${sessionId}`);
-    return;
-  }
+  let state = bound.state;
 
   // Phase 1: Mode transition for write tools
-  checkAndTransitionMode(state, toolName, permissionMode, projectRoot);
+  checkAndTransitionMode(state.id, toolName, permissionMode, projectRoot);
 
   // Phase 2: Context window check (log only, no warnings emitted)
   const [pctRemaining, tokensUsed, maxTokens] = getContextPercentRemaining(payload);

package/dist/templates/{_shared → core}/hooks-ts/file-suggestion.ts

@@ -4,32 +4,14 @@
  * Outputs a plain JSON array (NOT hookSpecificOutput).
  */
 import * as fs from "node:fs";
-import * as path from "node:path";
+import path from "node:path";
 
-import { getContextFilePath, getContextHandoffsDir, getContextPlansDir, getContextReviewsDir, getProjectRoot } from "../lib-ts/base/constants.js";
-import { loadHookInput, logDebug, logError, runHook } from "../lib-ts/base/hook-utils.js";
 import { getAllContexts, getContextBySessionId } from "../lib-ts/context/context-store.js";
+import { loadHookInput, logDebug, logError, runHook } from "../lib-ts/hooks/hook-utils.js";
+import { getContextFilePath, getContextHandoffsDir, getContextPlansDir, getContextReviewsDir, getProjectRoot } from "../lib-ts/runtime/constants.js";
+import { getMdFilesByMtime } from "../lib-ts/runtime/utils.js";
 import type { ContextState } from "../lib-ts/types.js";
 
-/** Get .md files sorted by mtime descending */
-function getMdFilesByMtime(dir: string): string[] {
-  try {
-    if (!fs.existsSync(dir)) return [];
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-    const mdFiles = entries
-      .filter(e => e.isFile() && e.name.endsWith(".md"))
-      .map(e => {
-        const fullPath = path.join(dir, e.name);
-        const stat = fs.statSync(fullPath);
-        return { path: fullPath, mtime: stat.mtimeMs };
-      })
-      .sort((a, b) => b.mtime - a.mtime);
-    return mdFiles.map(f => f.path);
-  } catch {
-    return [];
-  }
-}
-
 /** Find latest folder-based document (subdirectory with index.md) */
 function getLatestFolderDoc(dir: string): null | string {
   try {
@@ -128,3 +110,4 @@ function main(): void {
 }
 
 runHook(main, "file-suggestion");
+

package/dist/templates/{_shared → core}/hooks-ts/lint_after_edit.ts

@@ -3,11 +3,11 @@
  * PostToolUse:Write|Edit hook: Run linter on edited files, feed errors to Claude.
  * Uses emitContext() for non-blocking context injection — Claude sees errors and self-corrects.
  */
-import { getProjectRoot } from "../lib-ts/base/constants.js";
 import {
-  emitContext, getToolInput, loadHookInput, logDebug, runHook,
-} from "../lib-ts/base/hook-utils.js";
-import { formatLintErrors, getLinterForFile, runLinter } from "../lib-ts/base/lint-dispatch.js";
+  emitContext, logDebug, requireToolInput, runHook,
+} from "../lib-ts/hooks/hook-utils.js";
+import { getProjectRoot } from "../lib-ts/runtime/constants.js";
+import { formatLintErrors, getLinterForFile, runLinter } from "../lib-ts/runtime/lint-dispatch.js";
 
 // Extensions with no lint value
 const SKIP_EXTENSIONS = new Set([
@@ -31,11 +31,9 @@ function shouldSkip(filePath: string): boolean {
 }
 
 function main(): void {
-  const payload = loadHookInput();
-  if (!payload) return;
-
-  const toolInput = getToolInput(payload);
-  if (!toolInput) return;
+  const context = requireToolInput("lint_after_edit");
+  if (!context) return;
+  const { payload, toolInput } = context;
 
   const filePath = toolInput.file_path as string | undefined;
   if (!filePath) return;

package/dist/templates/core/hooks-ts/pre_compact.ts

@@ -0,0 +1,36 @@
+#!/usr/bin/env bun
+/**
+ * PreCompact hook: Save state.json snapshot before context compaction.
+ * Captures git state and session metadata for recovery.
+ */
+import { saveState } from "../lib-ts/context/context-store.js";
+import {
+  logError, logInfo, requireBoundSession, runHook,
+} from "../lib-ts/hooks/hook-utils.js";
+import { getGitState } from "../lib-ts/runtime/git-state.js";
+import { nowIso } from "../lib-ts/runtime/utils.js";
+
+function main(): void {
+  const bound = requireBoundSession("pre_compact");
+  if (!bound) return;
+  const { sessionId, projectRoot, state } = bound;
+
+  const gitState = getGitState(projectRoot);
+
+  state.last_session = {
+    ...state.last_session,
+    session_id: sessionId,
+    saved_at: nowIso(),
+    save_reason: "pre_compact",
+    git_state: gitState,
+  };
+
+  const [ok, err] = saveState(state.id, state, projectRoot);
+  if (ok) {
+    logInfo("pre_compact", `Saved pre-compact snapshot for ${state.id}`);
+  } else {
+    logError("pre_compact", `Failed to save state: ${err}`);
+  }
+}
+
+runHook(main, "pre_compact");