kairn-cli 2.9.0 → 2.10.0

package/dist/cli.js

@@ -3590,7 +3590,8 @@ var init_targeting = __esm({
       "refactor": ["architecture", "conventions"],
       "test-writing": ["verification", "commands"],
       "config-change": ["settings", "mcp"],
-      "documentation": ["general"]
+      "documentation": ["general"],
+      "persistence-completion": ["commands", "verification"]
     };
   }
 });
@@ -4909,7 +4910,7 @@ You must output a JSON object matching the SkeletonSpec schema.
 - MCP servers: maximum 6. Prefer fewer.
 - Skills: maximum 3. Only include directly relevant ones.
 - Agents: maximum 5. Orchestration pipeline (/develop) agents.
-- Hooks: maximum 4 (auto-format, block-destructive, PostCompact, plus one contextual).
+- Hooks: maximum 5 (auto-format, block-destructive, PostCompact, memory-persistence, plus one contextual).
 
 If the workflow doesn't clearly need a tool, DO NOT include it.
 Each MCP server costs 500-2000 tokens of context window.
@@ -5189,6 +5190,12 @@ For projects with multi-session workflows, include SessionStart/End hooks that p
 
 This ensures accumulated project knowledge survives session boundaries.
 
+## Persistence Routing Hook
+
+For code projects with autonomy level 3+, include a \`UserPromptSubmit\` hook that routes complex tasks through \`/project:persist\`.
+Generate \`.claude/hooks/persist-router.mjs\` (the routing logic) and add a \`UserPromptSubmit\` hook entry in settings.json that invokes it.
+Also add \`"persistence_routing": "auto"\` (level 3-4) or \`"persistence_routing": "manual"\` (level 1-2) to settings.json.
+
 ## For Code Projects, Additionally Include
 
 - \`/project:plan\` command (plan before coding)
@@ -5226,6 +5233,13 @@ This ensures accumulated project knowledge survives session boundaries.
 - \`/project:prove\` command (runs tests, shows git diff vs main, rates confidence HIGH/MEDIUM/LOW with evidence)
 - \`/project:grill\` command (adversarial code review \u2014 challenges each change with "why this approach?", "what if X input?", rates BLOCKER/SHOULD-FIX/NITPICK, blocks until BLOCKERs resolved)
 - \`/project:reset\` command (reads DECISIONS.md and LEARNINGS.md, proposes clean restart, stashes current work, implements elegant solution)
+- \`/project:persist\` command (persistent execution loop \u2014 reads acceptance criteria from docs/SPRINT.md, works criterion-by-criterion with structured progress tracking in .claude/progress.json, auto-retries on verification failure up to 3 times per criterion, delegates to @grill for review gate before completion, resumes from progress.json if session was interrupted). The command protocol:
+  1. Load or initialize .claude/progress.json from docs/SPRINT.md numbered acceptance criteria
+  2. For each incomplete criterion: implement, run verification (build/test/typecheck/lint), mark PASSED or retry (max 3 attempts per criterion, mark BLOCKED after 3 failures)
+  3. After all criteria attempted: if any BLOCKED report which and why; if all PASSED proceed to review gate
+  4. Review gate: delegate to @grill for adversarial review; fix blockers if found (max 1 fix cycle)
+  5. Persist state: write final progress.json; include progress summary in memory.json for session resume
+  Resume protocol: when progress.json exists, skip PASSED criteria, resume from first non-PASSED criterion, carry forward failure notes from prior attempts.
 
 ## For Research Projects, Additionally Include
 
@@ -5270,7 +5284,7 @@ Return ONLY valid JSON matching this structure:
 \`\`\`json
 {
   "claude_md": "Full CLAUDE.md content (under 150 lines)",
-  "commands": { "help": "...", "develop": "...", "status": "...", "fix": "...", "sprint": "...", "spec": "...", "prove": "...", "grill": "...", "reset": "..." },
+  "commands": { "help": "...", "develop": "...", "status": "...", "fix": "...", "sprint": "...", "spec": "...", "prove": "...", "grill": "...", "reset": "...", "persist": "..." },
   "rules": { "continuity": "...", "security": "..." },
   "agents": { "architect": "...", "planner": "...", "implementer": "...", "fixer": "...", "doc-updater": "...", "qa-orchestrator": "...", "linter": "...", "e2e-tester": "..." },
   "skills": { "skill-name/SKILL": "..." },
@@ -5429,7 +5443,7 @@ Do not add generic filler. Every line must be specific to the user's workflow.
 - Skills: maximum 3. Only include directly relevant ones.
 - Agents: maximum 5. Orchestration pipeline (/develop) agents.
 - Commands: no limit (loaded on demand, zero context cost).
-- Hooks: maximum 4 (auto-format, block-destructive, PostCompact, plus one contextual).
+- Hooks: maximum 5 (auto-format, block-destructive, PostCompact, memory-persistence, plus one contextual).
 
 If the workflow doesn't clearly need a tool, DO NOT include it.
 Each MCP server costs 500-2000 tokens of context window.
@@ -5458,7 +5472,8 @@ Return ONLY valid JSON matching this structure:
     },
     "commands": {
       "help": "markdown content for /project:help",
-      "develop": "markdown content for /project:develop"
+      "develop": "markdown content for /project:develop",
+      "persist": "markdown content for /project:persist"
     },
     "rules": {
       "continuity": "markdown content for continuity rule",
@@ -6535,6 +6550,9 @@ function applyAutonomyLevel(spec) {
   const agents = spec.harness.agents ?? {};
   const docs = spec.harness.docs ?? {};
   const settings = spec.harness.settings ?? {};
+  if (!("persistence_routing" in settings)) {
+    settings.persistence_routing = level >= 3 ? "auto" : "manual";
+  }
   if (level >= 1) {
     if (!("tour" in commands)) {
       commands.tour = TOUR_COMMAND;
@@ -6606,6 +6624,85 @@ var ENV_LOADER_HOOK = {
     command: 'if [ -f .env ] && [ -n "$CLAUDE_ENV_FILE" ]; then grep -v "^#" .env | grep -v "^$" | grep "=" >> "$CLAUDE_ENV_FILE"; fi'
   }]
 };
+var PERSIST_ROUTER_TEMPLATE = `import { readFileSync } from 'fs';
+
+const input = JSON.parse(readFileSync('/dev/stdin', 'utf8'));
+const prompt = (input.prompt ?? '').trim();
+
+// Pass-through patterns (fast exit)
+const PASSTHROUGH = /^(what|how|why|where|when|can you|does|is |show me|find |search |list |\\/project:)/i;
+const SINGLE_FILE = /^(edit|fix the typo|update the comment|change the|rename) .{3,60}$/i;
+
+if (PASSTHROUGH.test(prompt) || SINGLE_FILE.test(prompt) || prompt.length < 20) {
+  process.stdout.write(JSON.stringify({ continue: true }));
+  process.exit(0);
+}
+
+// Check config for routing mode
+let routingMode = 'auto';
+try {
+  const settings = JSON.parse(readFileSync('.claude/settings.json', 'utf8'));
+  routingMode = settings.persistence_routing ?? 'auto';
+} catch { /* default to auto */ }
+
+if (routingMode === 'off') {
+  process.stdout.write(JSON.stringify({ continue: true }));
+  process.exit(0);
+}
+
+// Complexity signals
+const signals = [];
+
+if (/\\b(then|after that|and also|next|finally|step \\d|first .* then)\\b/i.test(prompt)) {
+  signals.push('multi-step');
+}
+if (/\\b(add|implement|build|create|integrate|set up)\\b.*\\b(feature|auth|api|endpoint|page|component|module|service|database|migration)\\b/i.test(prompt)) {
+  signals.push('feature-scope');
+}
+if (/\\b(migrate|convert|replace|upgrade|refactor|rewrite|restructure)\\b/i.test(prompt)) {
+  signals.push('refactor-scope');
+}
+if (/\\b(when .* happens|steps to reproduce|broken|crash|regression|fails when)\\b/i.test(prompt)) {
+  signals.push('bug-with-repro');
+}
+if (/\\b(persist|keep working|don't stop|until done|until .* pass)\\b/i.test(prompt)) {
+  signals.push('explicit');
+}
+if (prompt.split(/\\s+/).length > 50) {
+  signals.push('long-prompt');
+}
+
+const shouldRoute = routingMode === 'manual'
+  ? signals.includes('explicit')
+  : signals.length >= 2 || signals.includes('explicit');
+
+if (shouldRoute) {
+  process.stdout.write(JSON.stringify({
+    continue: true,
+    hookSpecificOutput: {
+      hookEventName: 'UserPromptSubmit',
+      additionalContext: [
+        'PERSISTENCE ROUTING: This task has complexity signals (' + signals.join(', ') + ').',
+        'Execute this using the /project:persist workflow:',
+        '1. Ensure acceptance criteria exist in docs/SPRINT.md (create from this prompt if needed)',
+        '2. Initialize .claude/progress.json',
+        '3. Work criterion-by-criterion until all pass',
+        '4. Run review gate before marking complete',
+      ].join('\\n'),
+    },
+  }));
+} else {
+  process.stdout.write(JSON.stringify({ continue: true }));
+}
+`;
+var PERSIST_ROUTER_HOOK = {
+  matcher: "",
+  hooks: [{
+    type: "command",
+    command: 'node "$CLAUDE_PROJECT_DIR/.claude/hooks/persist-router.mjs"',
+    timeout: 5
+  }]
+};
 function resolveSettings(spec, options) {
   const settings = spec.harness.settings;
   const base = settings && Object.keys(settings).length > 0 ? { ...settings } : {};
@@ -6619,6 +6716,13 @@ function resolveSettings(spec, options) {
     hooks.SessionStart = sessionStart;
     base.hooks = hooks;
   }
+  if (isCodeProject(spec) && (spec.autonomy_level ?? 1) >= 3) {
+    const hooks = base.hooks ?? {};
+    const userPromptSubmit = hooks.UserPromptSubmit ?? [];
+    userPromptSubmit.push(PERSIST_ROUTER_HOOK);
+    hooks.UserPromptSubmit = userPromptSubmit;
+    base.hooks = hooks;
+  }
   const hasIntentHooks = spec.harness.hooks && Object.keys(spec.harness.hooks).length > 0;
   if (hasIntentHooks) {
     const hooks = base.hooks ?? {};
@@ -6710,6 +6814,9 @@ function buildFileMap(spec, options) {
       files.set(".claude/hooks/intent-log.jsonl", "");
     }
   }
+  if (isCodeProject(spec) && (spec.autonomy_level ?? 1) >= 3) {
+    files.set(".claude/hooks/persist-router.mjs", PERSIST_ROUTER_TEMPLATE);
+  }
   return files;
 }
 async function writeEnvironment(spec, targetDir, options) {
@@ -6780,6 +6887,11 @@ async function writeEnvironment(spec, targetDir, options) {
       written.push(".claude/hooks/intent-log.jsonl");
     }
   }
+  if (isCodeProject(spec) && (spec.autonomy_level ?? 1) >= 3) {
+    const p = path5.join(claudeDir, "hooks", "persist-router.mjs");
+    await writeFile(p, PERSIST_ROUTER_TEMPLATE);
+    written.push(".claude/hooks/persist-router.mjs");
+  }
   return written;
 }
 function summarizeSpec(spec, registry) {
@@ -8478,14 +8590,20 @@ var EVAL_TEMPLATES = {
     name: "Intent Routing",
     description: "Test that natural language prompts route to the correct workflow command via intent hooks",
     bestFor: ["feature-development", "full-stack", "api-building"]
+  },
+  "persistence-completion": {
+    id: "persistence-completion",
+    name: "Persistence Completion",
+    description: "Can the agent complete a multi-criterion task using the persistence loop?",
+    bestFor: ["feature-development", "full-stack", "api-building", "maintenance"]
   }
 };
 function selectTemplatesForWorkflow(workflowType) {
   const mapping = {
-    "feature-development": ["add-feature", "test-writing", "convention-adherence", "workflow-compliance", "intent-routing"],
-    "api-building": ["add-feature", "fix-bug", "test-writing", "convention-adherence"],
-    "full-stack": ["add-feature", "fix-bug", "test-writing", "convention-adherence"],
-    "maintenance": ["fix-bug", "refactor", "test-writing", "rule-compliance"],
+    "feature-development": ["add-feature", "test-writing", "convention-adherence", "workflow-compliance", "intent-routing", "persistence-completion"],
+    "api-building": ["add-feature", "fix-bug", "test-writing", "convention-adherence", "persistence-completion"],
+    "full-stack": ["add-feature", "fix-bug", "test-writing", "convention-adherence", "persistence-completion"],
+    "maintenance": ["fix-bug", "refactor", "test-writing", "rule-compliance", "persistence-completion"],
     "debugging": ["fix-bug", "test-writing", "rule-compliance"],
     "qa": ["fix-bug", "test-writing", "add-feature", "workflow-compliance"],
     "architecture": ["refactor", "test-writing", "config-change", "convention-adherence"],
@@ -8506,6 +8624,7 @@ IMPORTANT: For harness-aware templates (convention-adherence, workflow-complianc
 - convention-adherence: Task must require following specific conventions from CLAUDE.md (naming, file structure, patterns). Judge by whether output matches the conventions.
 - workflow-compliance: Task must require using project slash commands or workflow steps defined in .claude/commands/. Judge by whether the agent followed the defined workflow.
 - rule-compliance: Task must create a scenario where .claude/rules/ content is relevant. Judge by whether the agent respected all rules.
+- persistence-completion: Task MUST have 3+ acceptance criteria that require sequential implementation. The task description should be a realistic feature request \u2014 the agent must parse it into criteria. Judge by: (a) all criteria met (progress.json status: complete), (b) structured tracking used (progress.json exists with 3+ criteria), (c) tests pass, (d) review gate executed (progress.json review field present).
 
 These harness-aware tasks are critical \u2014 they test whether the .claude/ environment actually improves agent behavior.