aiwcli 0.12.6 → 0.12.8

package/dist/templates/cc-native/_cc-native/cc-native.config.json

@@ -1,96 +1,96 @@
-{
-  "models": {
-    "providers": {
-      "claude": {
-        "enabled": true,
-        "models": ["sonnet"]
-      },
-      "codex": {
-        "enabled": true,
-        "models": ["gpt-5.1-codex-mini"]
-      }
-    }
-  },
-  "planReview": {
-    "enabled": true,
-    "display": {
-      "maxIssues": 12,
-      "maxMissingSections": 12,
-      "maxQuestions": 12
-    }
-  },
-  "agentReview": {
-    "enabled": true,
-    "timeout": 180,
-    "warnThreshold": 0.01,
-    "maxIssuesPerAgent": 3,
-    "orchestrator": {
-      "enabled": true,
-      "model": "opus",
-      "timeout": 60
-    },
-    "legacyMode": false,
-    "mandatoryAgents": {
-      "always": ["handoff-readiness", "clarity-auditor", "skeptic"],
-      "medium+": ["documentation-philosophy"]
-    },
-    "fallbackByComplexity": {
-      "simple": 0,
-      "medium": 12,
-      "high": 6
-    },
-    "reviewIterations": {
-      "simple": 1,
-      "medium": 3,
-      "high": 5
-    },
-    "highIssueThreshold": 2,
-    "earlyExitOnAllPass": true,
-    "display": {
-      "maxIssues": 12,
-      "maxMissingSections": 12,
-      "maxQuestions": 12
-    }
-  },
-  "agentSelection": {
-    "simple": { "min": 3, "max": 3 },
-    "medium": { "min": 12, "max": 12 },
-    "high": { "min": 6, "max": 6 },
-    "fallbackCount": 3
-  },
-  "agentDefaults": {
-    "model": "sonnet"
-  },
-  "complexityCategories": [
-    "code", "infrastructure", "documentation",
-    "life", "business", "design", "research"
-  ],
-  "sanitization": {
-    "maxSessionIdLength": 32,
-    "maxTitleLength": 50
-  },
-  "planContext": {
-    "enabled": true,
-    "offerClarifyingQuestions": true
-  },
-  "stuckDetection": {
-    "enabled": true,
-    "errorThreshold": 3,
-    "fileEditThreshold": 4,
-    "testFailureThreshold": 3,
-    "cooldown": 10,
-    "maxSuggestions": 3
-  },
-  "rlm": {
-    "hyde": {
-      "enabled": false,
-      "provider": "ollama",
-      "ollamaModel": "qwen2.5:1.5b",
-      "numResponses": 5,
-      "maxTokens": 200,
-      "timeoutMs": 10000,
-      "fallbackToQuery": true,
-      "fallbackToClaude": false
-    }
-  }
-}
+{
+  "models": {
+    "providers": {
+      "claude": {
+        "enabled": true,
+        "models": ["sonnet"]
+      },
+      "codex": {
+        "enabled": true,
+        "models": ["gpt-5.1-codex-mini"]
+      }
+    }
+  },
+  "planReview": {
+    "enabled": true,
+    "display": {
+      "maxIssues": 12,
+      "maxMissingSections": 12,
+      "maxQuestions": 12
+    }
+  },
+  "agentReview": {
+    "enabled": true,
+    "timeout": 180,
+    "warnThreshold": 0.01,
+    "maxIssuesPerAgent": 3,
+    "orchestrator": {
+      "enabled": true,
+      "model": "opus",
+      "timeout": 60
+    },
+    "legacyMode": false,
+    "mandatoryAgents": {
+      "always": ["handoff-readiness", "clarity-auditor", "skeptic"],
+      "medium+": ["documentation-philosophy"]
+    },
+    "fallbackByComplexity": {
+      "simple": 0,
+      "medium": 12,
+      "high": 6
+    },
+    "reviewIterations": {
+      "simple": 1,
+      "medium": 3,
+      "high": 5
+    },
+    "highIssueThreshold": 2,
+    "earlyExitOnAllPass": true,
+    "display": {
+      "maxIssues": 12,
+      "maxMissingSections": 12,
+      "maxQuestions": 12
+    }
+  },
+  "agentSelection": {
+    "simple": { "min": 3, "max": 3 },
+    "medium": { "min": 12, "max": 12 },
+    "high": { "min": 6, "max": 6 },
+    "fallbackCount": 3
+  },
+  "agentDefaults": {
+    "model": "sonnet"
+  },
+  "complexityCategories": [
+    "code", "infrastructure", "documentation",
+    "life", "business", "design", "research"
+  ],
+  "sanitization": {
+    "maxSessionIdLength": 32,
+    "maxTitleLength": 50
+  },
+  "planContext": {
+    "enabled": true,
+    "offerClarifyingQuestions": true
+  },
+  "stuckDetection": {
+    "enabled": true,
+    "errorThreshold": 3,
+    "fileEditThreshold": 4,
+    "testFailureThreshold": 3,
+    "cooldown": 10,
+    "maxSuggestions": 3
+  },
+  "rlm": {
+    "hyde": {
+      "enabled": false,
+      "provider": "ollama",
+      "ollamaModel": "qwen2.5:1.5b",
+      "numResponses": 5,
+      "maxTokens": 200,
+      "timeoutMs": 10000,
+      "fallbackToQuery": true,
+      "fallbackToClaude": false
+    }
+  }
+}

package/dist/templates/cc-native/_cc-native/hooks/CLAUDE.md

@@ -14,19 +14,19 @@
 
 ### Plan Review Architecture
 
-The hook is a thin coordinator (~70 lines) that delegates to `lib-ts/review-pipeline.ts`. The pipeline wires together focused modules:
-
-| Module | Responsibility |
-|--------|----------------|
-| `plan-discovery.ts` | Find plan file, read content, compute hash |
-| `settings.ts` | Load + merge config with defaults, load agent library |
-| `agent-selection.ts` | Mandatory agent resolution, orchestrator-based selection, model assignment |
-| `graduation.ts` | Pass eligibility, pass streaks, graduation threshold, iteration advancement |
-| `output-builder.ts` | Issue truncation, verdict override, context/block message construction |
-| `review-pipeline.ts` | Pipeline orchestrator wiring all modules together |
-| `artifacts/format.ts` | Pure formatting (markdown, JSON, inline summaries) |
-| `artifacts/write.ts` | File I/O for review artifacts |
-| `artifacts/tracker.ts` | Review tracker management |
+The hook is a thin coordinator (~70 lines) that delegates to `plan-review/lib/review-pipeline.ts`. The pipeline wires together focused modules:
+
+| Module | Location | Responsibility |
+|--------|----------|----------------|
+| `plan-discovery.ts` | `lib-ts/` | Find plan file, read content, compute hash |
+| `settings.ts` | `lib-ts/` | Load + merge config with defaults, load agent library |
+| `agent-selection.ts` | `plan-review/lib/` | Mandatory agent resolution, orchestrator-based selection, model assignment |
+| `graduation.ts` | `plan-review/lib/` | Pass eligibility, pass streaks, graduation threshold, iteration advancement |
+| `output-builder.ts` | `plan-review/lib/` | Issue truncation, verdict override, context/block message construction |
+| `review-pipeline.ts` | `plan-review/lib/` | Pipeline orchestrator wiring all modules together |
+| `artifacts/lib/format.ts` | `artifacts/` | Pure formatting (markdown, JSON, inline summaries) |
+| `artifacts/lib/write.ts` | `artifacts/` | File I/O for review artifacts |
+| `artifacts/lib/tracker.ts` | `artifacts/` | Review tracker management |
 
 ### Questions Gate (in review-pipeline.ts)
 
@@ -134,7 +134,7 @@ const context = getContextBySessionId(sessionId, projectRoot);
 if (!context) {
   // Fallback: find single planning context
   const allActive = getAllContexts("active", projectRoot);
-  const planning = allActive.filter((c: any) => c.mode === "active" || c.mode === "has_plan");
+  const planning = allActive.filter((c: any) => c.mode === "active" || c.mode === "has_staged_work");
   if (planning.length === 1) {
     context = planning[0];
   }
@@ -235,13 +235,3 @@ Hooks fail silently on import errors — verify after any import path changes.
 | 2026-02-10 | **Migrated cc-native hooks from Python to TypeScript.** `cc-native-plan-review.ts` (async, parallel agent reviews via `Promise.all()`), `add_plan_context.ts`, `plan_questions_early.ts`. All hooks use `runHook()`/`runHookAsync()` entry points. Library code in `_cc-native/lib-ts/` (18 files). Settings.json updated to use `bun` runner. Python `.py` files kept as fallback until TS hooks verified. |
 | 2026-02-10 | Flipped TS logger stderr default to opt-in (`opts?.stderr === true`). Added `logBlocking()` for intentional stderr visibility. Removed redundant `{stderr: false}` from hook-utils.ts, user_prompt_submit.ts, context_monitor.ts. Added "Hook Error Visibility" section documenting visibility tiers and exit code behavior. |
 | 2026-02-10 | Fixed `debug.py` `context_path` crash. Added local try/catch around `maybeActivate` in `user_prompt_submit.ts` and `context_monitor.ts` to prevent stderr error display on non-critical I/O failures. Removed dead `context_path` from `_emitHookEnd` in `hook-utils.ts`. Added "Error Handling" section to CLAUDE.md. |
-| 2026-02-07 | Handoff staging lifecycle: `has_handoff` mode + `handoff_consumed` flag mirrors plan lifecycle. `save_handoff.py` no longer transitions to idle — stays active for session_end staging. `session_end.py` stages `active→has_handoff` when handoff_path set and not consumed. `session_start.py` restores `has_handoff→active` on /clear. `context_selector.py` has fallback Case 3b for has_handoff. PostToolUse context_monitor matcher simplified from specific tool list to `*`. |
-| 2026-02-07 | Removed PreToolUse:Write matcher from `add_plan_context.py`. Write-time plan nudges were redundant after consolidating enforcement to PreToolUse:Task. Removed `is_plan_file_write()`, `load_plan_context_config()`, `PHASE_B_ENFORCEMENT`, `nudge_write_questions()`, and `project_dir` import. |
-| 2026-02-07 | Question enforcement is now advisory-only (never blocks). `add_plan_context.py` uses `emit_context()` for all question nudges — no `permissionDecision:deny` anywhere. Removed `emit_context_and_block` import and `TASK_ENFORCEMENT_REASON` constant. |
-| 2026-02-07 | Moved question enforcement to PreToolUse:Task (Plan subagent gate). `add_plan_context.py` now handles three events: PostToolUse:AskUserQuestion, PreToolUse:Task (primary gate), PreToolUse:Write (fallback). Added `is_plan_task()`, `is_internal_call()` guard, `TASK_ENFORCEMENT_CONTEXT` constant. Registered `^Task$` command hook in settings.json. |
-| 2026-02-07 | Deleted `plan_accepted.py` (dead code — PostToolUse:ExitPlanMode never fires due to /clear race). Plan field assignment handled by `session_end.py` fallback. Added `plan_consumed` flag to prevent infinite plan re-staging. |
-| 2026-02-07 | Hook lifecycle diagnostics: all hooks now use `run_hook(main, "hook_name")` entry point. Logs HOOK_START/HOOK_END with template origin, event type, duration_ms, and status. Millisecond timestamps in logger. |
-| 2026-02-07 | Unified logger: all diagnostic logging uses `log_debug/log_info/log_warn/log_error` from `_shared/lib/base/logger.py` instead of eprint/print-to-stderr. Updated debugging and error handling docs. |
-| 2026-02-06 | Merged mark_questions_asked.py into add_plan_context.py. Hook now handles both PostToolUse:AskUserQuestion and PreToolUse:Write. Deleted standalone mark_questions_asked.py. |
-| 2026-02-06 | Fixed add_plan_context.py trigger docs (was PostToolUse: EnterPlanMode, is PreToolUse: Write). Added emit_context/emit_context_and_block utility docs. |
-| 2026-02-03 | Initial creation |

package/dist/templates/cc-native/_cc-native/hooks/cc-native-plan-review.ts

@@ -21,7 +21,7 @@ import {
 } from "../../_shared/lib-ts/base/hook-utils.js";
 import { isInternalCall } from "../../_shared/lib-ts/base/subprocess-utils.js";
 import { getProjectRoot, getAiwcliDir } from "../../_shared/lib-ts/base/constants.js";
-import { runReviewPipeline } from "../lib-ts/review-pipeline.js";
+import { runReviewPipeline } from "../plan-review/lib/review-pipeline.js";
 import type { PipelineResult } from "../lib-ts/types.js";
 
 const HOOK = "cc-native-plan-review";

package/dist/templates/cc-native/_cc-native/hooks/enhance_plan_post_subagent.ts

@@ -1,54 +1,54 @@
-#!/usr/bin/env bun
-/**
- * PostToolUse:Task Hook: Plan Quality Review Context
- *
- * Fires after Task tool completes with a Plan subagent. Emits plan quality review guidance
- * as context for the main agent to review the plan before ExitPlanMode.
- *
- * Design:
- * - Never blocks (all errors exit 0)
- * - Emits context via emitContext() — no file mutation
- * - Only fires for Task tool with subagent_type="Plan"
- */
-
-import {
-  loadHookInput,
-  runHook,
-  logInfo,
-  logDebug,
-  emitContext,
-  getToolInput,
-} from "../../_shared/lib-ts/base/hook-utils.js";
-import { isInternalCall } from "../../_shared/lib-ts/base/subprocess-utils.js";
-import { getPlanQualityReviewContext } from "../lib-ts/plan-enhancement.js";
-
-function main(): void {
-  if (isInternalCall()) return;
-
-  const payload = loadHookInput();
-  if (!payload) {
-    logDebug("enhance_plan_post_subagent", "No payload received");
-    return;
-  }
-
-  // Check if this is a Task tool call
-  if (payload.tool_name !== "Task") {
-    logDebug("enhance_plan_post_subagent", `Skipping: tool_name is "${payload.tool_name}", not "Task"`);
-    return;
-  }
-
-  // Check if the Task is spawning a Plan subagent
-  const toolInput = getToolInput(payload);
-  const subagentType = toolInput?.subagent_type;
-  logDebug("enhance_plan_post_subagent", `subagent_type: ${subagentType ?? "undefined"}`);
-
-  if (subagentType !== "Plan") {
-    logDebug("enhance_plan_post_subagent", `Skipping: subagent_type is "${subagentType}", not "Plan"`);
-    return;
-  }
-
-  logInfo("enhance_plan_post_subagent", "Emitting plan quality review context");
-  emitContext(getPlanQualityReviewContext());
-}
-
-runHook(main, "enhance_plan_post_subagent");
+#!/usr/bin/env bun
+/**
+ * PostToolUse:Task Hook: Plan Quality Review Context
+ *
+ * Fires after Task tool completes with a Plan subagent. Emits plan quality review guidance
+ * as context for the main agent to review the plan before ExitPlanMode.
+ *
+ * Design:
+ * - Never blocks (all errors exit 0)
+ * - Emits context via emitContext() — no file mutation
+ * - Only fires for Task tool with subagent_type="Plan"
+ */
+
+import {
+  loadHookInput,
+  runHook,
+  logInfo,
+  logDebug,
+  emitContext,
+  getToolInput,
+} from "../../_shared/lib-ts/base/hook-utils.js";
+import { isInternalCall } from "../../_shared/lib-ts/base/subprocess-utils.js";
+import { getPlanQualityReviewContext } from "../lib-ts/plan-enhancement.js";
+
+function main(): void {
+  if (isInternalCall()) return;
+
+  const payload = loadHookInput();
+  if (!payload) {
+    logDebug("enhance_plan_post_subagent", "No payload received");
+    return;
+  }
+
+  // Check if this is a Task tool call
+  if (payload.tool_name !== "Task") {
+    logDebug("enhance_plan_post_subagent", `Skipping: tool_name is "${payload.tool_name}", not "Task"`);
+    return;
+  }
+
+  // Check if the Task is spawning a Plan subagent
+  const toolInput = getToolInput(payload);
+  const subagentType = toolInput?.subagent_type;
+  logDebug("enhance_plan_post_subagent", `subagent_type: ${subagentType ?? "undefined"}`);
+
+  if (subagentType !== "Plan") {
+    logDebug("enhance_plan_post_subagent", `Skipping: subagent_type is "${subagentType}", not "Plan"`);
+    return;
+  }
+
+  logInfo("enhance_plan_post_subagent", "Emitting plan quality review context");
+  emitContext(getPlanQualityReviewContext());
+}
+
+runHook(main, "enhance_plan_post_subagent");

package/dist/templates/cc-native/_cc-native/hooks/enhance_plan_post_write.ts

@@ -1,52 +1,52 @@
-#!/usr/bin/env bun
-/**
- * PostToolUse:Write Hook: Plan Quality Review Context
- *
- * Fires after Write tool completes. Detects writes to ~/.claude/plans/*.md files
- * and emits plan quality review guidance as context.
- *
- * Design:
- * - Never blocks (all paths exit 0)
- * - Uses normalized path comparison (cross-platform)
- * - Shares prompt logic with SubagentStop hook via plan-enhancement.ts
- * - Emits context via emitContext() — no file mutation
- */
-
-import * as os from "node:os";
+#!/usr/bin/env bun
+/**
+ * PostToolUse:Write Hook: Plan Quality Review Context
+ *
+ * Fires after Write tool completes. Detects writes to ~/.claude/plans/*.md files
+ * and emits plan quality review guidance as context.
+ *
+ * Design:
+ * - Never blocks (all paths exit 0)
+ * - Uses normalized path comparison (cross-platform)
+ * - Shares prompt logic with SubagentStop hook via plan-enhancement.ts
+ * - Emits context via emitContext() — no file mutation
+ */
+
+import * as os from "node:os";
 import * as path from "node:path";
-
-import {
-  loadHookInput,
-  runHook,
-  logInfo,
-  emitContext,
-} from "../../_shared/lib-ts/base/hook-utils.js";
-import { isInternalCall } from "../../_shared/lib-ts/base/subprocess-utils.js";
-import { getPlanQualityReviewContext } from "../lib-ts/plan-enhancement.js";
-
-function main(): void {
-  if (isInternalCall()) return;
-
-  const payload = loadHookInput();
-  if (!payload) return;
-
-  const toolInput = payload.tool_input;
-  if (!toolInput || typeof toolInput !== "object") return;
-
-  const filePath = toolInput.file_path as string | undefined;
-  if (!filePath) return;
-
-  // Normalize paths for cross-platform comparison
-  const normalizedPath = path.normalize(path.resolve(filePath));
-  const plansDir = path.normalize(path.join(os.homedir(), ".claude", "plans"));
-
-  // Check if file is a markdown file in the plans directory
-  if (!normalizedPath.startsWith(plansDir) || !normalizedPath.endsWith(".md")) {
-    return;
-  }
-
-  logInfo("enhance_plan_write", `Detected plan file write: ${filePath}`);
-  emitContext(getPlanQualityReviewContext());
-}
-
-runHook(main, "enhance_plan_post_write");
+
+import {
+  loadHookInput,
+  runHook,
+  logInfo,
+  emitContext,
+} from "../../_shared/lib-ts/base/hook-utils.js";
+import { isInternalCall } from "../../_shared/lib-ts/base/subprocess-utils.js";
+import { getPlanQualityReviewContext } from "../lib-ts/plan-enhancement.js";
+
+function main(): void {
+  if (isInternalCall()) return;
+
+  const payload = loadHookInput();
+  if (!payload) return;
+
+  const toolInput = payload.tool_input;
+  if (!toolInput || typeof toolInput !== "object") return;
+
+  const filePath = toolInput.file_path as string | undefined;
+  if (!filePath) return;
+
+  // Normalize paths for cross-platform comparison
+  const normalizedPath = path.normalize(path.resolve(filePath));
+  const plansDir = path.normalize(path.join(os.homedir(), ".claude", "plans"));
+
+  // Check if file is a markdown file in the plans directory
+  if (!normalizedPath.startsWith(plansDir) || !normalizedPath.endsWith(".md")) {
+    return;
+  }
+
+  logInfo("enhance_plan_write", `Detected plan file write: ${filePath}`);
+  emitContext(getPlanQualityReviewContext());
+}
+
+runHook(main, "enhance_plan_post_write");

package/dist/templates/cc-native/_cc-native/hooks/mark_questions_asked.ts

@@ -1,53 +1,53 @@
-#!/usr/bin/env bun
-/**
- * Mark Questions Asked Hook
- *
- * Tracks when AskUserQuestion tool is used during a session.
- * Used by other hooks to determine if user clarification was gathered.
- *
- * Registered for:
- * - PostToolUse: AskUserQuestion — marks questions asked state for this session
- *
- * Fail-safe: Any error exits 0 (non-blocking).
- */
-
-import { getProjectRoot } from "../../_shared/lib-ts/base/constants.js";
-import {
-  loadHookInput,
-  runHook,
-  logInfo,
-  logDiagnostic,
-} from "../../_shared/lib-ts/base/hook-utils.js";
-import { isInternalCall } from "../../_shared/lib-ts/base/subprocess-utils.js";
-import { markQuestionsAsked } from "../lib-ts/cc-native-state.js";
-
-function main(): void {
-  // Guard: skip for internal subprocess calls (prevents recursive hook execution)
-  if (isInternalCall()) return;
-
-  const payload = loadHookInput();
-  if (!payload) return;
-
-  const toolName = payload.tool_name;
-  const hookEvent = payload.hook_event_name ?? "unknown";
-  logDiagnostic(
-    "add_plan_context",
-    "receive",
-    `tool=${toolName}, event=${hookEvent}`,
-    { inputs: { tool_name: toolName, hook_event: hookEvent } },
-  );
-
-  const projectRoot = getProjectRoot(payload.cwd);
-
-  // PostToolUse: AskUserQuestion — mark that early questions (Phase A) were asked
-  if (toolName === "AskUserQuestion") {
-    const sessionId = String(payload.session_id ?? "");
-    if (sessionId) {
-      markQuestionsAsked(sessionId, projectRoot, "early");
-      logInfo("add_plan_context", `Marked early questions asked for session ${sessionId.slice(0, 8)}...`);
-    }
-    
-  }
-}
-
-runHook(main, "mark_questions_asked");
+#!/usr/bin/env bun
+/**
+ * Mark Questions Asked Hook
+ *
+ * Tracks when AskUserQuestion tool is used during a session.
+ * Used by other hooks to determine if user clarification was gathered.
+ *
+ * Registered for:
+ * - PostToolUse: AskUserQuestion — marks questions asked state for this session
+ *
+ * Fail-safe: Any error exits 0 (non-blocking).
+ */
+
+import { getProjectRoot } from "../../_shared/lib-ts/base/constants.js";
+import {
+  loadHookInput,
+  runHook,
+  logInfo,
+  logDiagnostic,
+} from "../../_shared/lib-ts/base/hook-utils.js";
+import { isInternalCall } from "../../_shared/lib-ts/base/subprocess-utils.js";
+import { markQuestionsAsked } from "../lib-ts/cc-native-state.js";
+
+function main(): void {
+  // Guard: skip for internal subprocess calls (prevents recursive hook execution)
+  if (isInternalCall()) return;
+
+  const payload = loadHookInput();
+  if (!payload) return;
+
+  const toolName = payload.tool_name;
+  const hookEvent = payload.hook_event_name ?? "unknown";
+  logDiagnostic(
+    "add_plan_context",
+    "receive",
+    `tool=${toolName}, event=${hookEvent}`,
+    { inputs: { tool_name: toolName, hook_event: hookEvent } },
+  );
+
+  const projectRoot = getProjectRoot(payload.cwd);
+
+  // PostToolUse: AskUserQuestion — mark that early questions (Phase A) were asked
+  if (toolName === "AskUserQuestion") {
+    const sessionId = String(payload.session_id ?? "");
+    if (sessionId) {
+      markQuestionsAsked(sessionId, projectRoot, "early");
+      logInfo("add_plan_context", `Marked early questions asked for session ${sessionId.slice(0, 8)}...`);
+    }
+    
+  }
+}
+
+runHook(main, "mark_questions_asked");