aiwcli 0.12.6 → 0.12.7

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

@@ -1,76 +1,76 @@
-#!/usr/bin/env bun
-/**
- * CC-Native Plan Review Hook (Thin Coordinator)
- *
- * Claude Code PreToolUse hook that intercepts ExitPlanMode and delegates
- * to the review pipeline for plan quality review.
- *
- * Trigger: ExitPlanMode tool use (PreToolUse)
- * Configuration: _cc-native/cc-native.config.json
- * Output: _output/cc-native/plans/{YYYY-MM-DD}/{slug}/reviews/
- */
-
-import {
-  loadHookInput,
-  runHookAsync,
-  logDebug,
-  logInfo,
-  logWarn,
-  emitContext,
-  emitContextAndBlock,
-} 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 type { PipelineResult } from "../lib-ts/types.js";
-
-const HOOK = "cc-native-plan-review";
-
-async function main(): Promise<void> {
-  logInfo(HOOK, "Unified hook started (PreToolUse)");
-
-  if (isInternalCall()) {
-    logDebug(HOOK, "Skipping: internal subprocess call");
-    return;
-  }
-
-  const payload = loadHookInput();
-  if (!payload) {
-    logInfo(HOOK, "Skipping: Invalid JSON input");
-    emitContext("[Plan Review Skipped] Invalid JSON input");
-    return;
-  }
-
-  if (payload.tool_name !== "ExitPlanMode") {
-    logDebug(HOOK, "Skipping: not ExitPlanMode");
-    return;
-  }
-
-  const sessionId = String(payload.session_id ?? "unknown");
-  const base = getProjectRoot(payload.cwd);
-  const aiwcliDir = getAiwcliDir(base);
-
-  const result: PipelineResult = await runReviewPipeline({
-    sessionId,
-    base,
-    aiwcliDir,
-    transcriptPath: payload.transcript_path as string | undefined,
-    payload: payload as Record<string, unknown>,
-  });
-
-  switch (result.action) {
-    case "skip":
-      logInfo(HOOK, `Skipping: ${result.reason}`);
-      emitContext(`[Plan Review Skipped] ${result.reason}`);
-      break;
-    case "block":
-      emitContextAndBlock(result.contextText, result.blockReason);
-      break;
-    default: {
-      const _exhaustive: never = result;
-      logWarn(HOOK, `Unhandled pipeline action: ${(_exhaustive as { action: string }).action}`);
-    }
-  }
-}
-
-runHookAsync(main, "cc_native_plan_review");
+#!/usr/bin/env bun
+/**
+ * CC-Native Plan Review Hook (Thin Coordinator)
+ *
+ * Claude Code PreToolUse hook that intercepts ExitPlanMode and delegates
+ * to the review pipeline for plan quality review.
+ *
+ * Trigger: ExitPlanMode tool use (PreToolUse)
+ * Configuration: _cc-native/cc-native.config.json
+ * Output: _output/cc-native/plans/{YYYY-MM-DD}/{slug}/reviews/
+ */
+
+import {
+  loadHookInput,
+  runHookAsync,
+  logDebug,
+  logInfo,
+  logWarn,
+  emitContext,
+  emitContextAndBlock,
+} 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 type { PipelineResult } from "../lib-ts/types.js";
+
+const HOOK = "cc-native-plan-review";
+
+async function main(): Promise<void> {
+  logInfo(HOOK, "Unified hook started (PreToolUse)");
+
+  if (isInternalCall()) {
+    logDebug(HOOK, "Skipping: internal subprocess call");
+    return;
+  }
+
+  const payload = loadHookInput();
+  if (!payload) {
+    logInfo(HOOK, "Skipping: Invalid JSON input");
+    emitContext("[Plan Review Skipped] Invalid JSON input");
+    return;
+  }
+
+  if (payload.tool_name !== "ExitPlanMode") {
+    logDebug(HOOK, "Skipping: not ExitPlanMode");
+    return;
+  }
+
+  const sessionId = String(payload.session_id ?? "unknown");
+  const base = getProjectRoot(payload.cwd);
+  const aiwcliDir = getAiwcliDir(base);
+
+  const result: PipelineResult = await runReviewPipeline({
+    sessionId,
+    base,
+    aiwcliDir,
+    transcriptPath: payload.transcript_path as string | undefined,
+    payload: payload as Record<string, unknown>,
+  });
+
+  switch (result.action) {
+    case "skip":
+      logInfo(HOOK, `Skipping: ${result.reason}`);
+      emitContext(`[Plan Review Skipped] ${result.reason}`);
+      break;
+    case "block":
+      emitContextAndBlock(result.contextText, result.blockReason);
+      break;
+    default: {
+      const _exhaustive: never = result;
+      logWarn(HOOK, `Unhandled pipeline action: ${(_exhaustive as { action: string }).action}`);
+    }
+  }
+}
+
+runHookAsync(main, "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");

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

@@ -1,61 +1,61 @@
-#!/usr/bin/env bun
-/**
- * UserPromptSubmit hook — injects post-exploration clarification prompt in plan mode.
- *
- * After explore agents finish examining the codebase, injects a system-reminder
- * telling Claude to ask clarification questions via AskUserQuestion to narrow
- * the approach before drafting the plan.
- *
- * Skips if questions were already asked this session.
- */
-
-import { getProjectRoot } from "../../_shared/lib-ts/base/constants.js";
-import { loadHookInput, runHook, logDebug, logInfo, emitContext } from "../../_shared/lib-ts/base/hook-utils.js";
-import { wasEarlyQuestionsAsked } from "../lib-ts/cc-native-state.js";
-
-const PHASE_A_PROMPT = `## Plan Mode: Narrow the Approach After Exploration
-
-After exploring the codebase, use AskUserQuestion — one call, 3-4 questions — before drafting the plan.
-
-### Why This Matters
-Once you've explored the codebase, you'll understand what exists — but not which direction the user prefers. That's a branch point: multiple viable approaches, and the user's priorities determine which is best. Questions asked after exploration have maximum steering value: they narrow your path before you commit to an implementation direction.
-
-### What to Ask About
-Only ask about decisions that exploration will surface but can't resolve — where human judgment is needed to choose between viable options:
-
-- **Approach selection:** If exploration reveals 2-3 viable implementation paths, ask which the user prefers. Present each option with its trade-offs as concrete choices.
-- **Scope boundaries:** What's in scope vs. out of scope for this change? Which areas of the codebase should be left untouched? How far should the change ripple?
-- **Trade-off preferences:** Where exploration reveals tensions (simplicity vs. flexibility, speed vs. thoroughness, minimal change vs. full refactor), ask which side the user leans toward.
-- **Success criteria beyond the literal ask:** What would make this a 10? What non-obvious quality matters most — performance, readability, extensibility, consistency with existing patterns?
-
-### How to Select Questions
-1. Generate 5+ candidate questions across the categories above
-2. For each, evaluate: "If they answered A vs B, would I take a different approach or write different code?" If no — discard it.
-3. Keep the 3-4 where different answers lead to meaningfully different implementation strategies
-4. Frame each with 2-3 concrete options so the user can react rather than generate from scratch`;
-
-function main(): void {
-  const payload = loadHookInput();
-  if (!payload) return;
-
-  const permissionMode = payload.permission_mode ?? "";
-  if (permissionMode !== "plan") return;
-
-  const sessionId = String(payload.session_id ?? "");
-  if (!sessionId) {
-    logDebug("plan_questions_early", "No session_id, skipping");
-    return;
-  }
-
-  const projectRoot = getProjectRoot(payload.cwd);
-
-  if (wasEarlyQuestionsAsked(sessionId, projectRoot)) {
-    logDebug("plan_questions_early", "Early questions already asked, skipping Phase A prompt");
-    return;
-  }
-
-  logInfo("plan_questions_early", "Plan mode detected, injecting Phase A prompt");
-  emitContext(PHASE_A_PROMPT);
-}
-
-runHook(main, "plan_questions_early");
+#!/usr/bin/env bun
+/**
+ * UserPromptSubmit hook — injects post-exploration clarification prompt in plan mode.
+ *
+ * After explore agents finish examining the codebase, injects a system-reminder
+ * telling Claude to ask clarification questions via AskUserQuestion to narrow
+ * the approach before drafting the plan.
+ *
+ * Skips if questions were already asked this session.
+ */
+
+import { getProjectRoot } from "../../_shared/lib-ts/base/constants.js";
+import { loadHookInput, runHook, logDebug, logInfo, emitContext } from "../../_shared/lib-ts/base/hook-utils.js";
+import { wasEarlyQuestionsAsked } from "../lib-ts/cc-native-state.js";
+
+const PHASE_A_PROMPT = `## Plan Mode: Narrow the Approach After Exploration
+
+After exploring the codebase, use AskUserQuestion — one call, 3-4 questions — before drafting the plan.
+
+### Why This Matters
+Once you've explored the codebase, you'll understand what exists — but not which direction the user prefers. That's a branch point: multiple viable approaches, and the user's priorities determine which is best. Questions asked after exploration have maximum steering value: they narrow your path before you commit to an implementation direction.
+
+### What to Ask About
+Only ask about decisions that exploration will surface but can't resolve — where human judgment is needed to choose between viable options:
+
+- **Approach selection:** If exploration reveals 2-3 viable implementation paths, ask which the user prefers. Present each option with its trade-offs as concrete choices.
+- **Scope boundaries:** What's in scope vs. out of scope for this change? Which areas of the codebase should be left untouched? How far should the change ripple?
+- **Trade-off preferences:** Where exploration reveals tensions (simplicity vs. flexibility, speed vs. thoroughness, minimal change vs. full refactor), ask which side the user leans toward.
+- **Success criteria beyond the literal ask:** What would make this a 10? What non-obvious quality matters most — performance, readability, extensibility, consistency with existing patterns?
+
+### How to Select Questions
+1. Generate 5+ candidate questions across the categories above
+2. For each, evaluate: "If they answered A vs B, would I take a different approach or write different code?" If no — discard it.
+3. Keep the 3-4 where different answers lead to meaningfully different implementation strategies
+4. Frame each with 2-3 concrete options so the user can react rather than generate from scratch`;
+
+function main(): void {
+  const payload = loadHookInput();
+  if (!payload) return;
+
+  const permissionMode = payload.permission_mode ?? "";
+  if (permissionMode !== "plan") return;
+
+  const sessionId = String(payload.session_id ?? "");
+  if (!sessionId) {
+    logDebug("plan_questions_early", "No session_id, skipping");
+    return;
+  }
+
+  const projectRoot = getProjectRoot(payload.cwd);
+
+  if (wasEarlyQuestionsAsked(sessionId, projectRoot)) {
+    logDebug("plan_questions_early", "Early questions already asked, skipping Phase A prompt");
+    return;
+  }
+
+  logInfo("plan_questions_early", "Plan mode detected, injecting Phase A prompt");
+  emitContext(PHASE_A_PROMPT);
+}
+
+runHook(main, "plan_questions_early");