aiwcli 0.15.5 → 0.17.0

package/dist/templates/cc-native/_cc-native/{artifacts/lib → lib-ts/artifacts}/index.ts

@@ -1,26 +1,26 @@
-/**
- * Barrel re-export for artifacts submodules.
- */
-
-export {
-  buildCombinedJson,
-  buildCorroborationReport,
-  buildHighIssuesDocument,
-  buildInlineReviewSummary,
-  extractTopIssuesText,
-  formatCombinedMarkdown,
-  formatReviewMarkdown,
-  generateReviewIndex,
-} from "./format.js";
-
-export {
-  extractPreviousHashes,
-  writeReviewTracker,
-} from "./tracker.js";
-
-export type { ReviewTrackerEntry } from "./tracker.js";
-export {
-  writeCombinedArtifacts,
-  writeFile,
-  writeFileNonCritical,
-} from "./write.js";
+/**
+ * Barrel re-export for artifacts submodules.
+ */
+
+export {
+  formatReviewMarkdown,
+  formatCombinedMarkdown,
+  buildInlineReviewSummary,
+  extractTopIssuesText,
+  buildHighIssuesDocument,
+  buildCorroborationReport,
+  generateReviewIndex,
+  buildCombinedJson,
+} from "./format.js";
+
+export {
+  writeCombinedArtifacts,
+  writeFile,
+  writeFileNonCritical,
+} from "./write.js";
+
+export {
+  writeReviewTracker,
+  extractPreviousHashes,
+} from "./tracker.js";
+export type { ReviewTrackerEntry } from "./tracker.js";

package/dist/templates/cc-native/_cc-native/{artifacts/lib → lib-ts/artifacts}/tracker.ts

@@ -1,108 +1,107 @@
-/**
- * Review tracker management — human-readable lifecycle summary.
- * Extracted from artifacts.ts.
- */
-
-import * as fs from "node:fs";
+/**
+ * Review tracker management — human-readable lifecycle summary.
+ * Extracted from artifacts.ts.
+ */
+
+import * as fs from "node:fs";
 import * as path from "node:path";
-
-import { logWarn } from "../../../_shared/lib-ts/base/logger.js";
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-export interface ReviewTrackerEntry {
-  iteration: number;
-  timestamp: string;
-  planHash: string;
-  verdict: string;
-  decision: string;
-  score: number;
-  topIssues: string[];
-  reviewFolder: string;
-}
-
-// ---------------------------------------------------------------------------
-// Tracker Writing
-// ---------------------------------------------------------------------------
-
-/**
- * Build or update the review-tracker.md in the cc-native reviews directory.
- */
-export function writeReviewTracker(
-  ccNativeReviewsDir: string,
-  entry: ReviewTrackerEntry,
-): void {
-  const trackerPath = path.join(ccNativeReviewsDir, "review-tracker.md");
-
-  let existingContent = "";
-  try {
-    if (fs.existsSync(trackerPath)) {
-      existingContent = fs.readFileSync(trackerPath, "utf-8");
-    }
-  } catch {
-    // Fresh start
-  }
-
-  const previousHashes = extractPreviousHashes(existingContent);
-  const hashChanged = previousHashes.length > 0 &&
-    previousHashes.at(-1) !== entry.planHash;
-
-  const lines: string[] = [];
-  const verdictEmoji = entry.decision === "allow" ? "\u2705" : "\u274C";
-  const changeNote = previousHashes.length > 0
-    ? (hashChanged ? "\u2705 Plan was revised (hash changed)" : "\u26A0\uFE0F Plan unchanged since last review")
-    : "Initial review";
-
-  lines.push(`## Iteration ${entry.iteration} \u2014 ${entry.timestamp} \u2014 ${verdictEmoji} ${entry.verdict.toUpperCase()}`);
-  lines.push("");
-  lines.push(`- **Decision:** ${entry.decision}`);
-  lines.push(`- **Score:** ${entry.score.toFixed(2)}`);
-  lines.push(`- **Plan hash:** \`${entry.planHash}\``);
-  lines.push(`- **Status:** ${changeNote}`);
-  lines.push(`- **Full review:** [\`${path.basename(entry.reviewFolder)}/\`](${path.basename(entry.reviewFolder)}/index.md)`);
-
-  if (entry.topIssues.length > 0) {
-    lines.push("");
-    lines.push("**Top issues:**");
-    for (const issue of entry.topIssues) {
-      lines.push(`- ${issue}`);
-    }
-  }
-  lines.push("");
-
-  let output: string;
-  if (!existingContent || !existingContent.includes("# Plan Review Tracker")) {
-    output = [
-      "# Plan Review Tracker",
-      "",
-      "> Auto-generated by plan review hook. Shows review lifecycle across iterations.",
-      "> Check `plan.md` in each iteration folder to diff plan changes.",
-      "",
-      ...lines,
-    ].join("\n");
-  } else {
-    output = existingContent.trimEnd() + "\n\n" + lines.join("\n");
-  }
-
-  try {
-    fs.writeFileSync(trackerPath, output, "utf-8");
-  } catch (error) {
-    logWarn("artifacts", `Failed to write review tracker: ${error}`);
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-export function extractPreviousHashes(content: string): string[] {
-  const hashes: string[] = [];
-  const regex = /\*\*Plan hash:\*\* `([a-f0-9]+)`/g;
-  let match: RegExpExecArray | null;
-  while ((match = regex.exec(content)) !== null) {
-    hashes.push(match[1]!);
-  }
-  return hashes;
-}
+import { logWarn } from "../../../_core/lib-ts/runtime/logger.js";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface ReviewTrackerEntry {
+  iteration: number;
+  timestamp: string;
+  planHash: string;
+  verdict: string;
+  decision: string;
+  score: number;
+  topIssues: string[];
+  reviewFolder: string;
+}
+
+// ---------------------------------------------------------------------------
+// Tracker Writing
+// ---------------------------------------------------------------------------
+
+/**
+ * Build or update the review-tracker.md in the cc-native reviews directory.
+ */
+export function writeReviewTracker(
+  ccNativeReviewsDir: string,
+  entry: ReviewTrackerEntry,
+): void {
+  const trackerPath = path.join(ccNativeReviewsDir, "review-tracker.md");
+
+  let existingContent = "";
+  try {
+    if (fs.existsSync(trackerPath)) {
+      existingContent = fs.readFileSync(trackerPath, "utf-8");
+    }
+  } catch {
+    // Fresh start
+  }
+
+  const previousHashes = extractPreviousHashes(existingContent);
+  const hashChanged = previousHashes.length > 0 &&
+    previousHashes[previousHashes.length - 1] !== entry.planHash;
+
+  const lines: string[] = [];
+  const verdictEmoji = entry.decision === "allow" ? "\u2705" : "\u274c";
+  const changeNote = previousHashes.length > 0
+    ? (hashChanged ? "\u2705 Plan was revised (hash changed)" : "\u26a0\ufe0f Plan unchanged since last review")
+    : "Initial review";
+
+  lines.push(`## Iteration ${entry.iteration} \u2014 ${entry.timestamp} \u2014 ${verdictEmoji} ${entry.verdict.toUpperCase()}`);
+  lines.push("");
+  lines.push(`- **Decision:** ${entry.decision}`);
+  lines.push(`- **Score:** ${entry.score.toFixed(2)}`);
+  lines.push(`- **Plan hash:** \`${entry.planHash}\``);
+  lines.push(`- **Status:** ${changeNote}`);
+  lines.push(`- **Full review:** [\`${path.basename(entry.reviewFolder)}/\`](${path.basename(entry.reviewFolder)}/index.md)`);
+
+  if (entry.topIssues.length > 0) {
+    lines.push("");
+    lines.push("**Top issues:**");
+    for (const issue of entry.topIssues) {
+      lines.push(`- ${issue}`);
+    }
+  }
+  lines.push("");
+
+  let output: string;
+  if (!existingContent || !existingContent.includes("# Plan Review Tracker")) {
+    output = [
+      "# Plan Review Tracker",
+      "",
+      "> Auto-generated by plan review hook. Shows review lifecycle across iterations.",
+      "> Check `plan.md` in each iteration folder to diff plan changes.",
+      "",
+      ...lines,
+    ].join("\n");
+  } else {
+    output = existingContent.trimEnd() + "\n\n" + lines.join("\n");
+  }
+
+  try {
+    fs.writeFileSync(trackerPath, output, "utf-8");
+  } catch (e) {
+    logWarn("artifacts", `Failed to write review tracker: ${e}`);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+export function extractPreviousHashes(content: string): string[] {
+  const hashes: string[] = [];
+  const regex = /\*\*Plan hash:\*\* `([a-f0-9]+)`/g;
+  let match: RegExpExecArray | null;
+  while ((match = regex.exec(content)) !== null) {
+    hashes.push(match[1]!);
+  }
+  return hashes;
+}

package/dist/templates/cc-native/_cc-native/{artifacts/lib → lib-ts/artifacts}/write.ts

@@ -1,120 +1,119 @@
-/**
- * File I/O for review artifacts.
- * Extracted from artifacts.ts.
- */
-
-import * as fs from "node:fs";
+/**
+ * File I/O for review artifacts.
+ * Extracted from artifacts.ts.
+ */
+
+import * as fs from "node:fs";
 import * as path from "node:path";
-
-import {
-  formatCombinedMarkdown,
-  buildCombinedJson,
-  generateReviewIndex,
-} from "./format.js";
-import { atomicWrite } from "../../../_shared/lib-ts/base/atomic-write.js";
-import { sanitizeFilename } from "../../../_shared/lib-ts/base/constants.js";
-import { logDebug, logWarn, logError } from "../../../_shared/lib-ts/base/logger.js";
-import { ENABLE_ROBUST_PLAN_WRITES } from "../../lib-ts/constants.js";
-import type { CombinedReviewResult, CorroborationResult } from "../../lib-ts/types.js";
-
-// ---------------------------------------------------------------------------
-// Artifact Writing
-// ---------------------------------------------------------------------------
-
-/**
- * Write combined review artifacts to context reviews folder.
- * Uses atomic writes for critical files when ENABLE_ROBUST_PLAN_WRITES is true.
- */
-export function writeCombinedArtifacts(
-  base: string,
-  plan: string,
-  result: CombinedReviewResult,
-  payload: Record<string, unknown>,
-  settings?: Record<string, unknown>,
-  contextReviewsDir?: string,
-  reviewFolder?: string,
-  iteration?: number,
-  corroboration?: CorroborationResult,
-): string {
-  const outDir = reviewFolder ?? contextReviewsDir;
-  if (!outDir) {
-    throw new Error("Either contextReviewsDir or reviewFolder is required");
-  }
-
-  logDebug("utils", `Using review folder: ${outDir}`);
-
-  try {
-    fs.mkdirSync(outDir, { recursive: true });
-  } catch (error: unknown) {
-    logError("utils", `Cannot create directory ${outDir}: ${error}`);
-    throw error;
-  }
-
-  // JSON write
-  const jsonPath = path.join(outDir, "review.json");
-  const jsonData = buildCombinedJson(result);
-  writeFile(jsonPath, JSON.stringify(jsonData, null, 2));
-
-  // Markdown write
-  const mdPath = path.join(outDir, "review.md");
-  const mdContent = formatCombinedMarkdown(result, settings, corroboration);
-  writeFile(mdPath, mdContent);
-
-  // Individual reviewer writes (non-critical)
-  const reviewerOutputDir = path.join(outDir, "reviewer-output");
-  try {
-    fs.mkdirSync(reviewerOutputDir, { recursive: true });
-  } catch (error) {
-    logWarn("artifacts", `Failed to create reviewer-output dir: ${error}`);
-  }
-  for (const [name, r] of Object.entries(result.agents)) {
-    if (r.data) {
-      writeFileNonCritical(
-        path.join(reviewerOutputDir, `${sanitizeFilename(name)}.json`),
-        JSON.stringify(r.data, null, 2),
-      );
-    }
-  }
-
-  // Generate index.md for folder-based reviews
-  if (reviewFolder) {
-    const indexContent = generateReviewIndex(result, iteration, settings);
-    writeFileNonCritical(path.join(outDir, "index.md"), indexContent);
-    return path.join(outDir, "index.md");
-  }
-
-  return mdPath;
-}
-
-// ---------------------------------------------------------------------------
-// File Write Helpers
-// ---------------------------------------------------------------------------
-
-export function writeFile(filePath: string, content: string): void {
-  try {
-    if (ENABLE_ROBUST_PLAN_WRITES) {
-      const [success, error] = atomicWrite(filePath, content);
-      if (!success) throw new Error(`Atomic write failed: ${error}`);
-    } else {
-      fs.writeFileSync(filePath, content, "utf-8");
-    }
-  } catch (error: unknown) {
-    logError("utils", `Failed to write ${path.basename(filePath)}: ${error}`);
-    throw error;
-  }
-}
-
-export function writeFileNonCritical(filePath: string, content: string): void {
-  try {
-    if (ENABLE_ROBUST_PLAN_WRITES) {
-      const [success, error] = atomicWrite(filePath, content);
-      if (!success) {
-        logWarn("utils", `Failed to write ${path.basename(filePath)}: ${error}`);
-      }
-    } else {
-      fs.writeFileSync(filePath, content, "utf-8");
-    }
-  } catch (error: unknown) {
-    logWarn("utils", `Failed to write ${path.basename(filePath)}: ${error}`);
-  }
-}
+import { atomicWrite } from "../../../_core/lib-ts/runtime/atomic-write.js";
+import { logDebug, logWarn, logError } from "../../../_core/lib-ts/runtime/logger.js";
+import { sanitizeFilename } from "../../../_core/lib-ts/runtime/constants.js";
+import { ENABLE_ROBUST_PLAN_WRITES } from "../constants.js";
+import type { CombinedReviewResult, CorroborationResult } from "../types.js";
+import {
+  formatCombinedMarkdown,
+  buildCombinedJson,
+  generateReviewIndex,
+} from "./format.js";
+
+// ---------------------------------------------------------------------------
+// Artifact Writing
+// ---------------------------------------------------------------------------
+
+/**
+ * Write combined review artifacts to context reviews folder.
+ * Uses atomic writes for critical files when ENABLE_ROBUST_PLAN_WRITES is true.
+ */
+export function writeCombinedArtifacts(
+  base: string,
+  plan: string,
+  result: CombinedReviewResult,
+  payload: Record<string, unknown>,
+  settings?: Record<string, unknown>,
+  contextReviewsDir?: string,
+  reviewFolder?: string,
+  iteration?: number,
+  corroboration?: CorroborationResult,
+): string {
+  const outDir = reviewFolder ?? contextReviewsDir;
+  if (!outDir) {
+    throw new Error("Either contextReviewsDir or reviewFolder is required");
+  }
+
+  logDebug("utils", `Using review folder: ${outDir}`);
+
+  try {
+    fs.mkdirSync(outDir, { recursive: true });
+  } catch (e: unknown) {
+    logError("utils", `Cannot create directory ${outDir}: ${e}`);
+    throw e;
+  }
+
+  // JSON write
+  const jsonPath = path.join(outDir, "review.json");
+  const jsonData = buildCombinedJson(result);
+  writeFile(jsonPath, JSON.stringify(jsonData, null, 2));
+
+  // Markdown write
+  const mdPath = path.join(outDir, "review.md");
+  const mdContent = formatCombinedMarkdown(result, settings, corroboration);
+  writeFile(mdPath, mdContent);
+
+  // Individual reviewer writes (non-critical)
+  const reviewerOutputDir = path.join(outDir, "reviewer-output");
+  try {
+    fs.mkdirSync(reviewerOutputDir, { recursive: true });
+  } catch (e) {
+    logWarn("artifacts", `Failed to create reviewer-output dir: ${e}`);
+  }
+  for (const [name, r] of Object.entries(result.agents)) {
+    if (r.data) {
+      writeFileNonCritical(
+        path.join(reviewerOutputDir, `${sanitizeFilename(name)}.json`),
+        JSON.stringify(r.data, null, 2),
+      );
+    }
+  }
+
+  // Generate index.md for folder-based reviews
+  if (reviewFolder) {
+    const indexContent = generateReviewIndex(result, iteration, settings);
+    writeFileNonCritical(path.join(outDir, "index.md"), indexContent);
+    return path.join(outDir, "index.md");
+  }
+
+  return mdPath;
+}
+
+// ---------------------------------------------------------------------------
+// File Write Helpers
+// ---------------------------------------------------------------------------
+
+export function writeFile(filePath: string, content: string): void {
+  try {
+    if (ENABLE_ROBUST_PLAN_WRITES) {
+      const [success, error] = atomicWrite(filePath, content);
+      if (!success) throw new Error(`Atomic write failed: ${error}`);
+    } else {
+      fs.writeFileSync(filePath, content, "utf-8");
+    }
+  } catch (e: unknown) {
+    logError("utils", `Failed to write ${path.basename(filePath)}: ${e}`);
+    throw e;
+  }
+}
+
+export function writeFileNonCritical(filePath: string, content: string): void {
+  try {
+    if (ENABLE_ROBUST_PLAN_WRITES) {
+      const [success, error] = atomicWrite(filePath, content);
+      if (!success) {
+        logWarn("utils", `Failed to write ${path.basename(filePath)}: ${error}`);
+      }
+    } else {
+      fs.writeFileSync(filePath, content, "utf-8");
+    }
+  } catch (e: unknown) {
+    logWarn("utils", `Failed to write ${path.basename(filePath)}: ${e}`);
+  }
+}

package/dist/templates/cc-native/_cc-native/lib-ts/artifacts.ts

@@ -0,0 +1,21 @@
+/**
+ * Review artifact writing and formatting.
+ * Re-exports from artifacts/ subdirectory for backward compatibility.
+ */
+
+export {
+  formatReviewMarkdown,
+  formatCombinedMarkdown,
+  buildInlineReviewSummary,
+  extractTopIssuesText,
+  buildHighIssuesDocument,
+  buildCorroborationReport,
+  generateReviewIndex,
+  buildCombinedJson,
+  writeCombinedArtifacts,
+  writeFile,
+  writeFileNonCritical,
+  writeReviewTracker,
+  extractPreviousHashes,
+} from "./artifacts/index.js";
+export type { ReviewTrackerEntry } from "./artifacts/index.js";

package/dist/templates/cc-native/_cc-native/lib-ts/cc-native-state.ts

@@ -4,16 +4,17 @@
  * See cc-native-plan-review-spec.md §4.5
  */
 
+import { getContextBySessionId, saveState } from "../../_core/lib-ts/context/context-store.js";
+import { logInfo, logWarn } from "../../_core/lib-ts/runtime/logger.js";
+import { nowIso } from "../../_core/lib-ts/runtime/utils.js";
 import type {
   CcNativeState,
   PlanReviewState,
+  QuestionsAskedState,
   IterationState,
   StuckDetectionState,
 } from "./types.js";
-import { logInfo, logWarn } from "../../_shared/lib-ts/base/logger.js";
-import { nowIso } from "../../_shared/lib-ts/base/utils.js";
-import { getContextBySessionId, saveState } from "../../_shared/lib-ts/context/context-store.js";
-import type { ContextState } from "../../_shared/lib-ts/types.js";
+import type { ContextState } from "../../_core/lib-ts/types.js";
 
 /**
  * ContextState extended with the cc_native method-specific data.
@@ -61,8 +62,8 @@ export function saveCcNativeState(
       saveState(state.id, state, projectRoot);
       return true;
     }
-  } catch (error: unknown) {
-    logWarn("utils", `Failed to save cc_native state: ${error}`);
+  } catch (e: unknown) {
+    logWarn("utils", `Failed to save cc_native state: ${e}`);
   }
   return false;
 }
@@ -144,9 +145,9 @@ export function markPlanReviewed(
         max: iterationState.max ?? 1,
         complexity: iterationState.complexity ?? "unknown",
       };
-      const {history} = iterationState;
+      const history = iterationState.history;
       if (history && history.length > 0) {
-        const lastEntry = history.at(-1);
+        const lastEntry = history[history.length - 1];
         if (lastEntry) {
           reviewData.iteration.latest_verdict = lastEntry.verdict ?? "unknown";
         }
@@ -166,8 +167,8 @@ export function markPlanReviewed(
         `Failed to save plan review state for session ${sessionId}`,
       );
     }
-  } catch (error: unknown) {
-    logWarn(hookName, `Failed to mark plan reviewed: ${error}`);
+  } catch (e: unknown) {
+    logWarn(hookName, `Failed to mark plan reviewed: ${e}`);
   }
 }
 
@@ -254,8 +255,8 @@ export function markQuestionsAsked(
     ccNative.questions_asked.asked_at = timestamp;
 
     return saveCcNativeState(sessionId, projectRoot, ccNative);
-  } catch (error: unknown) {
-    logWarn("utils", `Failed to mark questions asked: ${error}`);
+  } catch (e: unknown) {
+    logWarn("utils", `Failed to mark questions asked: ${e}`);
     return false;
   }
 }
@@ -277,8 +278,8 @@ export function resetPlanQuestionsAsked(
       };
     }
     return saveCcNativeState(sessionId, projectRoot, ccNative);
-  } catch (error: unknown) {
-    logWarn("utils", `Failed to reset plan questions asked: ${error}`);
+  } catch (e: unknown) {
+    logWarn("utils", `Failed to reset plan questions asked: ${e}`);
     return false;
   }
 }
@@ -310,8 +311,8 @@ export function updateStuckDetectionState(
     const ccNative = getCcNativeState(sessionId, projectRoot) ?? {};
     ccNative.stuck_detection = stuckState;
     return saveCcNativeState(sessionId, projectRoot, ccNative);
-  } catch (error: unknown) {
-    logWarn("utils", `Failed to update stuck detection state: ${error}`);
+  } catch (e: unknown) {
+    logWarn("utils", `Failed to update stuck detection state: ${e}`);
     return false;
   }
 }