aiwcli 0.12.6 → 0.12.8

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

@@ -1,80 +1,80 @@
-/**
- * Per-context debug logging for cc-native hooks.
- * Thin delegation layer over the unified logger.
- * See cc-native-plan-review-spec.md §4.13
- *
- * Can be disabled via CCNATIVE_DEBUG_DISABLE=1 environment variable.
- */
-
-import * as fs from "node:fs";
+/**
+ * Per-context debug logging for cc-native hooks.
+ * Thin delegation layer over the unified logger.
+ * See cc-native-plan-review-spec.md §4.13
+ *
+ * Can be disabled via CCNATIVE_DEBUG_DISABLE=1 environment variable.
+ */
+
+import * as fs from "node:fs";
 import * as path from "node:path";
-
-import { hookLog } from "../../_shared/lib-ts/base/logger.js";
-
-/** Feature flag — set CCNATIVE_DEBUG_DISABLE=1 to turn off */
-const DEBUG_ENABLED = !["1", "true", "yes"].includes(
-  (process.env.CCNATIVE_DEBUG_DISABLE ?? "").toLowerCase(),
-);
-
-/**
- * Get or create debug directory within context folder.
- */
-export function getDebugDir(contextPath: string): string {
-  const debugDir = path.join(contextPath, "debug");
-  fs.mkdirSync(debugDir, { recursive: true });
-  return debugDir;
-}
-
-/**
- * Write a debug log entry. Delegates to unified logger.
- */
-export function debugLog(
-  contextPath: string,
-  sessionName: string,
-  component: string,
-  message: string,
-  data?: unknown,
-): void {
-  if (!DEBUG_ENABLED) return;
-
-  hookLog("debug", sessionName, message, {
-    component,
-    data,
-  });
-}
-
-/**
- * Log raw output (stdout, stderr, etc). Delegates to unified logger.
- */
-export function debugRaw(
-  contextPath: string,
-  sessionName: string,
-  component: string,
-  label: string,
-  raw: string,
-  maxLen = 10_000,
-): void {
-  if (!DEBUG_ENABLED) return;
-
-  const truncated = raw.length > maxLen ? raw.slice(0, maxLen) : raw;
-  const suffix =
-    raw.length > maxLen ? ` [TRUNCATED from ${raw.length} chars]` : "";
-
-  hookLog("debug", sessionName, `${label}${suffix}: ${truncated}`, {
-    component,
-  });
-}
-
-/**
- * Remove debug folder during context archive.
- */
-export function cleanupDebugFolder(contextPath: string): void {
-  try {
-    const debugDir = path.join(contextPath, "debug");
-    if (fs.existsSync(debugDir)) {
-      fs.rmSync(debugDir, { recursive: true, force: true });
-    }
-  } catch {
-    // Best effort cleanup
-  }
-}
+
+import { hookLog } from "../../_shared/lib-ts/base/logger.js";
+
+/** Feature flag — set CCNATIVE_DEBUG_DISABLE=1 to turn off */
+const DEBUG_ENABLED = !["1", "true", "yes"].includes(
+  (process.env.CCNATIVE_DEBUG_DISABLE ?? "").toLowerCase(),
+);
+
+/**
+ * Get or create debug directory within context folder.
+ */
+export function getDebugDir(contextPath: string): string {
+  const debugDir = path.join(contextPath, "debug");
+  fs.mkdirSync(debugDir, { recursive: true });
+  return debugDir;
+}
+
+/**
+ * Write a debug log entry. Delegates to unified logger.
+ */
+export function debugLog(
+  contextPath: string,
+  sessionName: string,
+  component: string,
+  message: string,
+  data?: unknown,
+): void {
+  if (!DEBUG_ENABLED) return;
+
+  hookLog("debug", sessionName, message, {
+    component,
+    data,
+  });
+}
+
+/**
+ * Log raw output (stdout, stderr, etc). Delegates to unified logger.
+ */
+export function debugRaw(
+  contextPath: string,
+  sessionName: string,
+  component: string,
+  label: string,
+  raw: string,
+  maxLen = 10_000,
+): void {
+  if (!DEBUG_ENABLED) return;
+
+  const truncated = raw.length > maxLen ? raw.slice(0, maxLen) : raw;
+  const suffix =
+    raw.length > maxLen ? ` [TRUNCATED from ${raw.length} chars]` : "";
+
+  hookLog("debug", sessionName, `${label}${suffix}: ${truncated}`, {
+    component,
+  });
+}
+
+/**
+ * Remove debug folder during context archive.
+ */
+export function cleanupDebugFolder(contextPath: string): void {
+  try {
+    const debugDir = path.join(contextPath, "debug");
+    if (fs.existsSync(debugDir)) {
+      fs.rmSync(debugDir, { recursive: true, force: true });
+    }
+  } catch {
+    // Best effort cleanup
+  }
+}

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

@@ -20,7 +20,7 @@ export {
   formatReviewMarkdown,
   generateReviewIndex,
   writeCombinedArtifacts,
-} from "./artifacts.js";
+} from "../artifacts/lib/index.js";
 
 // CC-native state
 export {
@@ -59,13 +59,13 @@ export { cleanupDebugFolder, debugLog, debugRaw, getDebugDir } from "./debug.js"
 export { coerceToReview, parseJsonMaybe } from "./json-parser.js";
 
 // Orchestrator
-export { buildOrchestratorSchema, runOrchestrator } from "./orchestrator.js";
+export { buildOrchestratorSchema, runOrchestrator } from "../plan-review/lib/orchestrator.js";
 
 // Reviewers
 export {
   AgentReviewer,
   runAgentReview,
-} from "./reviewers/index.js";
+} from "../plan-review/lib/reviewers/index.js";
 
 // Iteration state
 export {
@@ -113,4 +113,4 @@ export {
 } from "./types.js";
 
 // Verdict aggregation
-export { computeReviewDecision, worstVerdict } from "./verdict.js";
+export { computeReviewDecision, worstVerdict } from "../plan-review/lib/verdict.js";

package/dist/templates/cc-native/_cc-native/lib-ts/json-parser.ts

@@ -1,168 +1,168 @@
-/**
- * JSON parsing utilities for LLM responses.
- * See cc-native-plan-review-spec.md §4.10-4.11
- */
-
-import type { ReviewData, Verdict } from "./types.js";
-import { logDebug, logWarn } from "../../_shared/lib-ts/base/logger.js";
-
-/**
- * Try strict JSON parse. If that fails, attempt to extract the first {...} block.
- *
- * @param text - Raw text that may contain JSON
- * @param requireFields - Optional list of field names to check for
- * @returns Parsed dict or null if parsing failed entirely
- */
-export function parseJsonMaybe(
-  text: string,
-  requireFields?: string[],
-): null | Record<string, unknown> {
-  const trimmed = text.trim();
-  if (!trimmed) return null;
-
-  let obj: null | Record<string, unknown> = null;
-  let parseMethod: null | string = null;
-
-  // Strict parse
-  try {
-    const parsed: unknown = JSON.parse(trimmed);
-    if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
-      obj = parsed as Record<string, unknown>;
-      parseMethod = "strict";
-    }
-  } catch {
-    // Fall through to heuristic
-  }
-
-  // Heuristic: try to extract a JSON object substring
-  if (obj === null) {
-    const start = trimmed.indexOf("{");
-    const end = trimmed.lastIndexOf("}");
-    if (start !== -1 && end !== -1 && end > start) {
-      const candidate = trimmed.slice(start, end + 1);
-      try {
-        const parsed: unknown = JSON.parse(candidate);
-        if (
-          parsed !== null &&
-          typeof parsed === "object" &&
-          !Array.isArray(parsed)
-        ) {
-          obj = parsed as Record<string, unknown>;
-          parseMethod = "heuristic";
-          logDebug(
-            "parse",
-            `Used heuristic extraction (chars ${start}-${end})`,
-          );
-        }
-      } catch {
-        logDebug(
-          "parse",
-          `Heuristic extraction failed for candidate at chars ${start}-${end}`,
-        );
-        return null;
-      }
-    }
-  }
-
-  // Validate required fields if parsed
-  if (obj && requireFields) {
-    const missing = requireFields.filter((f) => !(f in obj!) || !obj![f]);
-    if (missing.length > 0) {
-      logWarn(
-        "parse",
-        `Parsed JSON (${parseMethod}) missing/empty fields: ${JSON.stringify(missing)}`,
-      );
-      logDebug("parse", `Keys present: ${JSON.stringify(Object.keys(obj))}`);
-      // Heuristic extraction grabbed the wrong object — reject it.
-      // Strict parse still returns partial objects (caller handles defaults).
-      if (parseMethod === "heuristic") {
-        logWarn("parse", "Rejecting heuristic result due to missing required fields");
-        return null;
-      }
-    }
-  }
-
-  return obj;
-}
-
-/**
- * Validate/normalize parsed JSON to ReviewData shape with safe defaults.
- *
- * @param obj - Parsed JSON object (possibly null)
- * @param defaultFixMsg - Default suggested_fix message for error case
- * @returns Tuple of [ok, verdict, normalizedData]
- */
-export function coerceToReview(
-  obj: null | Record<string, unknown>,
-  defaultFixMsg = "Retry or check configuration.",
-): [boolean, Verdict, ReviewData] {
-  if (!obj) {
-    logWarn("coerce", "No object provided to coerceToReview");
-    return [
-      false,
-      "error",
-      {
-        verdict: "fail",
-        summary: "No structured output returned.",
-        summary_source: "default",
-        issues: [
-          {
-            severity: "high",
-            category: "tooling",
-            issue: "Reviewer returned no JSON.",
-            suggested_fix: defaultFixMsg,
-          },
-        ],
-        missing_sections: [],
-        questions: [],
-      },
-    ];
-  }
-
-  const rawVerdict = obj.verdict;
-  let verdict: Verdict;
-  if (rawVerdict === "pass" || rawVerdict === "warn" || rawVerdict === "fail") {
-    verdict = rawVerdict;
-  } else {
-    logWarn(
-      "coerce",
-      `Invalid or missing verdict '${String(rawVerdict)}', defaulting to 'warn'`,
-    );
-    verdict = "warn";
-  }
-
-  // Log when fields are being defaulted
-  const summaryRaw = String(obj.summary ?? "").trim();
-  if (!summaryRaw) {
-    logWarn(
-      "coerce",
-      "summary missing or empty from parsed output, using default",
-    );
-    logDebug("coerce", `Raw object keys: ${JSON.stringify(Object.keys(obj))}`);
-    logDebug(
-      "coerce",
-      `verdict=${obj.verdict}, issues_count=${Array.isArray(obj.issues) ? (obj.issues as unknown[]).length : 0}`,
-    );
-  }
-
-  if (!obj.issues) {
-    logDebug("coerce", "issues array empty or missing");
-  }
-
-  const norm: ReviewData = {
-    verdict,
-    summary: summaryRaw || "No summary provided.",
-    summary_source: summaryRaw ? "reviewer" : "default",
-    issues: Array.isArray(obj.issues)
-      ? (obj.issues as ReviewData["issues"])
-      : [],
-    missing_sections: Array.isArray(obj.missing_sections)
-      ? (obj.missing_sections as string[])
-      : [],
-    questions: Array.isArray(obj.questions)
-      ? (obj.questions as string[])
-      : [],
-  };
-
-  return [true, verdict, norm];
-}
+/**
+ * JSON parsing utilities for LLM responses.
+ * See cc-native-plan-review-spec.md §4.10-4.11
+ */
+
+import type { ReviewData, Verdict } from "./types.js";
+import { logDebug, logWarn } from "../../_shared/lib-ts/base/logger.js";
+
+/**
+ * Try strict JSON parse. If that fails, attempt to extract the first {...} block.
+ *
+ * @param text - Raw text that may contain JSON
+ * @param requireFields - Optional list of field names to check for
+ * @returns Parsed dict or null if parsing failed entirely
+ */
+export function parseJsonMaybe(
+  text: string,
+  requireFields?: string[],
+): null | Record<string, unknown> {
+  const trimmed = text.trim();
+  if (!trimmed) return null;
+
+  let obj: null | Record<string, unknown> = null;
+  let parseMethod: null | string = null;
+
+  // Strict parse
+  try {
+    const parsed: unknown = JSON.parse(trimmed);
+    if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+      obj = parsed as Record<string, unknown>;
+      parseMethod = "strict";
+    }
+  } catch {
+    // Fall through to heuristic
+  }
+
+  // Heuristic: try to extract a JSON object substring
+  if (obj === null) {
+    const start = trimmed.indexOf("{");
+    const end = trimmed.lastIndexOf("}");
+    if (start !== -1 && end !== -1 && end > start) {
+      const candidate = trimmed.slice(start, end + 1);
+      try {
+        const parsed: unknown = JSON.parse(candidate);
+        if (
+          parsed !== null &&
+          typeof parsed === "object" &&
+          !Array.isArray(parsed)
+        ) {
+          obj = parsed as Record<string, unknown>;
+          parseMethod = "heuristic";
+          logDebug(
+            "parse",
+            `Used heuristic extraction (chars ${start}-${end})`,
+          );
+        }
+      } catch {
+        logDebug(
+          "parse",
+          `Heuristic extraction failed for candidate at chars ${start}-${end}`,
+        );
+        return null;
+      }
+    }
+  }
+
+  // Validate required fields if parsed
+  if (obj && requireFields) {
+    const missing = requireFields.filter((f) => !(f in obj!) || !obj![f]);
+    if (missing.length > 0) {
+      logWarn(
+        "parse",
+        `Parsed JSON (${parseMethod}) missing/empty fields: ${JSON.stringify(missing)}`,
+      );
+      logDebug("parse", `Keys present: ${JSON.stringify(Object.keys(obj))}`);
+      // Heuristic extraction grabbed the wrong object — reject it.
+      // Strict parse still returns partial objects (caller handles defaults).
+      if (parseMethod === "heuristic") {
+        logWarn("parse", "Rejecting heuristic result due to missing required fields");
+        return null;
+      }
+    }
+  }
+
+  return obj;
+}
+
+/**
+ * Validate/normalize parsed JSON to ReviewData shape with safe defaults.
+ *
+ * @param obj - Parsed JSON object (possibly null)
+ * @param defaultFixMsg - Default suggested_fix message for error case
+ * @returns Tuple of [ok, verdict, normalizedData]
+ */
+export function coerceToReview(
+  obj: null | Record<string, unknown>,
+  defaultFixMsg = "Retry or check configuration.",
+): [boolean, Verdict, ReviewData] {
+  if (!obj) {
+    logWarn("coerce", "No object provided to coerceToReview");
+    return [
+      false,
+      "error",
+      {
+        verdict: "fail",
+        summary: "No structured output returned.",
+        summary_source: "default",
+        issues: [
+          {
+            severity: "high",
+            category: "tooling",
+            issue: "Reviewer returned no JSON.",
+            suggested_fix: defaultFixMsg,
+          },
+        ],
+        missing_sections: [],
+        questions: [],
+      },
+    ];
+  }
+
+  const rawVerdict = obj.verdict;
+  let verdict: Verdict;
+  if (rawVerdict === "pass" || rawVerdict === "warn" || rawVerdict === "fail") {
+    verdict = rawVerdict;
+  } else {
+    logWarn(
+      "coerce",
+      `Invalid or missing verdict '${String(rawVerdict)}', defaulting to 'warn'`,
+    );
+    verdict = "warn";
+  }
+
+  // Log when fields are being defaulted
+  const summaryRaw = String(obj.summary ?? "").trim();
+  if (!summaryRaw) {
+    logWarn(
+      "coerce",
+      "summary missing or empty from parsed output, using default",
+    );
+    logDebug("coerce", `Raw object keys: ${JSON.stringify(Object.keys(obj))}`);
+    logDebug(
+      "coerce",
+      `verdict=${obj.verdict}, issues_count=${Array.isArray(obj.issues) ? (obj.issues as unknown[]).length : 0}`,
+    );
+  }
+
+  if (!obj.issues) {
+    logDebug("coerce", "issues array empty or missing");
+  }
+
+  const norm: ReviewData = {
+    verdict,
+    summary: summaryRaw || "No summary provided.",
+    summary_source: summaryRaw ? "reviewer" : "default",
+    issues: Array.isArray(obj.issues)
+      ? (obj.issues as ReviewData["issues"])
+      : [],
+    missing_sections: Array.isArray(obj.missing_sections)
+      ? (obj.missing_sections as string[])
+      : [],
+    questions: Array.isArray(obj.questions)
+      ? (obj.questions as string[])
+      : [],
+  };
+
+  return [true, verdict, norm];
+}