ai-spec-dev 0.31.0 → 0.33.0

package/dist/cli/index.mjs

@@ -467,9 +467,9 @@ var init_workspace_loader = __esm({
 
 // cli/index.ts
 import { Command } from "commander";
-import * as path22 from "path";
-import * as fs23 from "fs-extra";
-import chalk19 from "chalk";
+import * as path23 from "path";
+import * as fs24 from "fs-extra";
+import chalk21 from "chalk";
 import * as dotenv from "dotenv";
 import { input, confirm as confirm2, select as select3 } from "@inquirer/prompts";
 
@@ -4849,221 +4849,221 @@ function validateDsl(raw) {
   }
   return { valid: true, dsl: raw };
 }
-function validateFeature(raw, path23, errors) {
+function validateFeature(raw, path24, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path23, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path24, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const f = raw;
-  requireNonEmptyString(f["id"], `${path23}.id`, errors);
-  requireNonEmptyString(f["title"], `${path23}.title`, errors);
-  requireNonEmptyString(f["description"], `${path23}.description`, errors);
+  requireNonEmptyString(f["id"], `${path24}.id`, errors);
+  requireNonEmptyString(f["title"], `${path24}.title`, errors);
+  requireNonEmptyString(f["description"], `${path24}.description`, errors);
 }
-function validateModel(raw, path23, errors) {
+function validateModel(raw, path24, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path23, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path24, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const m = raw;
-  requireNonEmptyString(m["name"], `${path23}.name`, errors);
+  requireNonEmptyString(m["name"], `${path24}.name`, errors);
   if (!Array.isArray(m["fields"])) {
-    errors.push({ path: `${path23}.fields`, message: `Must be an array, got: ${typeLabel(m["fields"])}` });
+    errors.push({ path: `${path24}.fields`, message: `Must be an array, got: ${typeLabel(m["fields"])}` });
   } else {
     const fields = m["fields"];
     if (fields.length > MAX_FIELDS_PER_MODEL) {
-      errors.push({ path: `${path23}.fields`, message: `Too many fields (${fields.length} > ${MAX_FIELDS_PER_MODEL})` });
+      errors.push({ path: `${path24}.fields`, message: `Too many fields (${fields.length} > ${MAX_FIELDS_PER_MODEL})` });
     }
     for (let j2 = 0; j2 < Math.min(fields.length, MAX_FIELDS_PER_MODEL); j2++) {
-      validateModelField(fields[j2], `${path23}.fields[${j2}]`, errors);
+      validateModelField(fields[j2], `${path24}.fields[${j2}]`, errors);
     }
   }
   if (m["relations"] !== void 0) {
     if (!Array.isArray(m["relations"])) {
-      errors.push({ path: `${path23}.relations`, message: "Must be an array of strings if present" });
+      errors.push({ path: `${path24}.relations`, message: "Must be an array of strings if present" });
     } else {
       const rels = m["relations"];
       for (let j2 = 0; j2 < rels.length; j2++) {
         if (typeof rels[j2] !== "string") {
-          errors.push({ path: `${path23}.relations[${j2}]`, message: "Must be a string" });
+          errors.push({ path: `${path24}.relations[${j2}]`, message: "Must be a string" });
         }
       }
     }
   }
 }
-function validateModelField(raw, path23, errors) {
+function validateModelField(raw, path24, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path23, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path24, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const f = raw;
-  requireNonEmptyString(f["name"], `${path23}.name`, errors);
-  requireNonEmptyString(f["type"], `${path23}.type`, errors);
+  requireNonEmptyString(f["name"], `${path24}.name`, errors);
+  requireNonEmptyString(f["type"], `${path24}.type`, errors);
   if (typeof f["required"] !== "boolean") {
-    errors.push({ path: `${path23}.required`, message: `Must be boolean, got: ${typeLabel(f["required"])}` });
+    errors.push({ path: `${path24}.required`, message: `Must be boolean, got: ${typeLabel(f["required"])}` });
   }
 }
-function validateEndpoint(raw, path23, errors) {
+function validateEndpoint(raw, path24, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path23, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path24, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const e = raw;
-  requireNonEmptyString(e["id"], `${path23}.id`, errors);
-  requireNonEmptyString(e["description"], `${path23}.description`, errors);
+  requireNonEmptyString(e["id"], `${path24}.id`, errors);
+  requireNonEmptyString(e["description"], `${path24}.description`, errors);
   if (!VALID_METHODS.includes(e["method"])) {
     errors.push({
-      path: `${path23}.method`,
+      path: `${path24}.method`,
       message: `Must be one of ${VALID_METHODS.join("|")}, got: ${JSON.stringify(e["method"])}`
     });
   }
   if (typeof e["path"] !== "string" || !e["path"].startsWith("/")) {
     errors.push({
-      path: `${path23}.path`,
+      path: `${path24}.path`,
       message: `Must be a string starting with "/", got: ${JSON.stringify(e["path"])}`
     });
   }
   if (typeof e["auth"] !== "boolean") {
-    errors.push({ path: `${path23}.auth`, message: `Must be boolean, got: ${typeLabel(e["auth"])}` });
+    errors.push({ path: `${path24}.auth`, message: `Must be boolean, got: ${typeLabel(e["auth"])}` });
   }
   if (typeof e["successStatus"] !== "number" || e["successStatus"] < 100 || e["successStatus"] > 599) {
     errors.push({
-      path: `${path23}.successStatus`,
+      path: `${path24}.successStatus`,
       message: `Must be an HTTP status code (100-599), got: ${JSON.stringify(e["successStatus"])}`
     });
   }
-  requireNonEmptyString(e["successDescription"], `${path23}.successDescription`, errors);
+  requireNonEmptyString(e["successDescription"], `${path24}.successDescription`, errors);
   if (e["request"] !== void 0) {
-    validateRequestSchema(e["request"], `${path23}.request`, errors);
+    validateRequestSchema(e["request"], `${path24}.request`, errors);
   }
   if (e["errors"] !== void 0) {
     if (!Array.isArray(e["errors"])) {
-      errors.push({ path: `${path23}.errors`, message: "Must be an array if present" });
+      errors.push({ path: `${path24}.errors`, message: "Must be an array if present" });
     } else {
       const errs = e["errors"];
       if (errs.length > MAX_ERRORS_PER_ENDPOINT) {
-        errors.push({ path: `${path23}.errors`, message: `Too many error entries (${errs.length} > ${MAX_ERRORS_PER_ENDPOINT})` });
+        errors.push({ path: `${path24}.errors`, message: `Too many error entries (${errs.length} > ${MAX_ERRORS_PER_ENDPOINT})` });
       }
       for (let j2 = 0; j2 < Math.min(errs.length, MAX_ERRORS_PER_ENDPOINT); j2++) {
-        validateResponseError(errs[j2], `${path23}.errors[${j2}]`, errors);
+        validateResponseError(errs[j2], `${path24}.errors[${j2}]`, errors);
       }
     }
   }
 }
-function validateRequestSchema(raw, path23, errors) {
+function validateRequestSchema(raw, path24, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path23, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path24, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const r = raw;
   for (const key of ["body", "query", "params"]) {
     if (r[key] !== void 0) {
-      validateFieldMap(r[key], `${path23}.${key}`, errors);
+      validateFieldMap(r[key], `${path24}.${key}`, errors);
     }
   }
 }
-function validateFieldMap(raw, path23, errors) {
+function validateFieldMap(raw, path24, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path23, message: `Must be a flat object (FieldMap), got: ${typeLabel(raw)}` });
+    errors.push({ path: path24, message: `Must be a flat object (FieldMap), got: ${typeLabel(raw)}` });
     return;
   }
   const map = raw;
   for (const [k2, v2] of Object.entries(map)) {
     if (typeof v2 !== "string") {
-      errors.push({ path: `${path23}.${k2}`, message: `Value must be a type-description string, got: ${typeLabel(v2)}` });
+      errors.push({ path: `${path24}.${k2}`, message: `Value must be a type-description string, got: ${typeLabel(v2)}` });
     }
   }
 }
-function validateResponseError(raw, path23, errors) {
+function validateResponseError(raw, path24, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path23, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path24, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const e = raw;
   if (typeof e["status"] !== "number" || e["status"] < 100 || e["status"] > 599) {
-    errors.push({ path: `${path23}.status`, message: `Must be an HTTP status code (100-599), got: ${JSON.stringify(e["status"])}` });
+    errors.push({ path: `${path24}.status`, message: `Must be an HTTP status code (100-599), got: ${JSON.stringify(e["status"])}` });
   }
-  requireNonEmptyString(e["code"], `${path23}.code`, errors);
-  requireNonEmptyString(e["description"], `${path23}.description`, errors);
+  requireNonEmptyString(e["code"], `${path24}.code`, errors);
+  requireNonEmptyString(e["description"], `${path24}.description`, errors);
 }
-function validateBehavior(raw, path23, errors) {
+function validateBehavior(raw, path24, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path23, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path24, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const b = raw;
-  requireNonEmptyString(b["id"], `${path23}.id`, errors);
-  requireNonEmptyString(b["description"], `${path23}.description`, errors);
+  requireNonEmptyString(b["id"], `${path24}.id`, errors);
+  requireNonEmptyString(b["description"], `${path24}.description`, errors);
   if (b["constraints"] !== void 0) {
     if (!Array.isArray(b["constraints"])) {
-      errors.push({ path: `${path23}.constraints`, message: "Must be an array of strings if present" });
+      errors.push({ path: `${path24}.constraints`, message: "Must be an array of strings if present" });
     } else {
       const cs2 = b["constraints"];
       for (let j2 = 0; j2 < cs2.length; j2++) {
         if (typeof cs2[j2] !== "string") {
-          errors.push({ path: `${path23}.constraints[${j2}]`, message: "Must be a string" });
+          errors.push({ path: `${path24}.constraints[${j2}]`, message: "Must be a string" });
         }
       }
     }
   }
 }
-function validateComponent(raw, path23, errors) {
+function validateComponent(raw, path24, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path23, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path24, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const c = raw;
-  requireNonEmptyString(c["id"], `${path23}.id`, errors);
-  requireNonEmptyString(c["name"], `${path23}.name`, errors);
-  requireNonEmptyString(c["description"], `${path23}.description`, errors);
+  requireNonEmptyString(c["id"], `${path24}.id`, errors);
+  requireNonEmptyString(c["name"], `${path24}.name`, errors);
+  requireNonEmptyString(c["description"], `${path24}.description`, errors);
   if (c["props"] !== void 0) {
     if (!Array.isArray(c["props"])) {
-      errors.push({ path: `${path23}.props`, message: "Must be an array if present" });
+      errors.push({ path: `${path24}.props`, message: "Must be an array if present" });
     } else {
       const props = c["props"];
       for (let j2 = 0; j2 < props.length; j2++) {
         const p = props[j2];
         if (typeof p !== "object" || p === null) {
-          errors.push({ path: `${path23}.props[${j2}]`, message: "Must be an object" });
+          errors.push({ path: `${path24}.props[${j2}]`, message: "Must be an object" });
           continue;
         }
-        requireNonEmptyString(p["name"], `${path23}.props[${j2}].name`, errors);
-        requireNonEmptyString(p["type"], `${path23}.props[${j2}].type`, errors);
+        requireNonEmptyString(p["name"], `${path24}.props[${j2}].name`, errors);
+        requireNonEmptyString(p["type"], `${path24}.props[${j2}].type`, errors);
         if (typeof p["required"] !== "boolean") {
-          errors.push({ path: `${path23}.props[${j2}].required`, message: "Must be boolean" });
+          errors.push({ path: `${path24}.props[${j2}].required`, message: "Must be boolean" });
         }
       }
     }
   }
   if (c["events"] !== void 0) {
     if (!Array.isArray(c["events"])) {
-      errors.push({ path: `${path23}.events`, message: "Must be an array if present" });
+      errors.push({ path: `${path24}.events`, message: "Must be an array if present" });
     } else {
       const events = c["events"];
       for (let j2 = 0; j2 < events.length; j2++) {
         const e = events[j2];
         if (typeof e !== "object" || e === null) {
-          errors.push({ path: `${path23}.events[${j2}]`, message: "Must be an object" });
+          errors.push({ path: `${path24}.events[${j2}]`, message: "Must be an object" });
           continue;
         }
-        requireNonEmptyString(e["name"], `${path23}.events[${j2}].name`, errors);
+        requireNonEmptyString(e["name"], `${path24}.events[${j2}].name`, errors);
       }
     }
   }
   if (c["state"] !== void 0) {
     if (typeof c["state"] !== "object" || Array.isArray(c["state"]) || c["state"] === null) {
-      errors.push({ path: `${path23}.state`, message: "Must be a flat object (Record<string, string>) if present" });
+      errors.push({ path: `${path24}.state`, message: "Must be a flat object (Record<string, string>) if present" });
     }
   }
   if (c["apiCalls"] !== void 0) {
     if (!Array.isArray(c["apiCalls"])) {
-      errors.push({ path: `${path23}.apiCalls`, message: "Must be an array of strings if present" });
+      errors.push({ path: `${path24}.apiCalls`, message: "Must be an array of strings if present" });
     }
   }
 }
-function requireNonEmptyString(v2, path23, errors) {
+function requireNonEmptyString(v2, path24, errors) {
   if (typeof v2 !== "string" || v2.trim().length === 0) {
     errors.push({
-      path: path23,
+      path: path24,
       message: `Must be a non-empty string, got: ${typeLabel(v2)}`
     });
   }
@@ -6025,8 +6025,8 @@ var RunSnapshot = class {
     const fullPath = path7.isAbsolute(filePath) ? filePath : path7.join(this.workingDir, filePath);
     if (!await fs8.pathExists(fullPath)) return;
     if (this.snapshotted.has(fullPath)) return;
-    const relative7 = path7.relative(this.workingDir, fullPath);
-    const dest = path7.join(this.backupRoot, relative7);
+    const relative8 = path7.relative(this.workingDir, fullPath);
+    const dest = path7.join(this.backupRoot, relative8);
     await fs8.ensureDir(path7.dirname(dest));
     await fs8.copy(fullPath, dest);
     this.snapshotted.add(fullPath);
@@ -6041,11 +6041,11 @@ var RunSnapshot = class {
         if (entry.isDirectory()) {
           await walk(full);
         } else {
-          const relative7 = path7.relative(this.backupRoot, full);
-          const dest = path7.join(this.workingDir, relative7);
+          const relative8 = path7.relative(this.backupRoot, full);
+          const dest = path7.join(this.workingDir, relative8);
           await fs8.ensureDir(path7.dirname(dest));
           await fs8.copy(full, dest, { overwrite: true });
-          restored.push(relative7);
+          restored.push(relative8);
         }
       }
     };
@@ -9938,6 +9938,17 @@ function extractReviewScore(reviewText) {
   const match = reviewText.match(/Score:\s*(\d+(?:\.\d+)?)\s*\/\s*10/i);
   return match ? parseFloat(match[1]) : null;
 }
+function modelNameTokens(name) {
+  const lower = name.toLowerCase();
+  const parts = name.replace(/([A-Z])/g, "-$1").toLowerCase().replace(/^-/, "").split("-").filter(Boolean);
+  const tokens = /* @__PURE__ */ new Set();
+  tokens.add(lower);
+  if (parts.length > 1) {
+    tokens.add(parts.join("-"));
+    tokens.add(parts.join("_"));
+  }
+  return [...tokens];
+}
 function runSelfEval(opts) {
   const { dsl, generatedFiles, compilePassed, reviewText, promptHash, logger } = opts;
   const endpointsTotal = dsl?.endpoints?.length ?? 0;
@@ -9945,16 +9956,39 @@ function runSelfEval(opts) {
   const endpointLayerCovered = generatedFiles.some(
     (f) => ENDPOINT_LAYER_PATTERNS.some((p) => p.test(f))
   );
+  const endpointLayerFiles = generatedFiles.filter(
+    (f) => ENDPOINT_LAYER_PATTERNS.some((p) => p.test(f))
+  ).length;
   const modelLayerCovered = generatedFiles.some(
     (f) => MODEL_LAYER_PATTERNS.some((p) => p.test(f))
   );
+  let modelNameMatched = 0;
+  if (modelsTotal > 0 && dsl?.models) {
+    for (const model of dsl.models) {
+      const tokens = modelNameTokens(model.name);
+      const found = generatedFiles.some((f) => {
+        const lf = f.toLowerCase();
+        return tokens.some((t) => lf.includes(t));
+      });
+      if (found) modelNameMatched++;
+    }
+  }
+  const modelNameCoverage = modelsTotal > 0 ? modelNameMatched / modelsTotal : 1;
   let dslCoverageScore = 10;
   if (generatedFiles.length === 0) {
     dslCoverageScore = 0;
   } else {
     if (endpointsTotal > 0 && !endpointLayerCovered) dslCoverageScore -= 4;
     if (modelsTotal > 0 && !modelLayerCovered) dslCoverageScore -= 3;
+    if (modelsTotal > 0 && modelLayerCovered) {
+      if (modelNameCoverage < 0.5) dslCoverageScore -= 2;
+      else if (modelNameCoverage < 0.8) dslCoverageScore -= 1;
+    }
+    if (endpointsTotal >= 5 && endpointLayerCovered && endpointLayerFiles < 2) {
+      dslCoverageScore -= 1;
+    }
   }
+  dslCoverageScore = Math.max(0, Math.min(10, dslCoverageScore));
   const compileScore = compilePassed ? 10 : 5;
   const reviewScore = reviewText ? extractReviewScore(reviewText) : null;
   const harnessScore = reviewScore !== null ? Math.round((dslCoverageScore * 0.4 + compileScore * 0.3 + reviewScore * 0.3) * 10) / 10 : Math.round((dslCoverageScore * 0.55 + compileScore * 0.45) * 10) / 10;
@@ -9967,8 +10001,11 @@ function runSelfEval(opts) {
     detail: {
       endpointsTotal,
       endpointLayerCovered,
+      endpointLayerFiles,
       modelsTotal,
       modelLayerCovered,
+      modelNameCoverage: Math.round(modelNameCoverage * 100) / 100,
+      modelNameMatched,
       filesWritten: generatedFiles.length
     }
   };
@@ -9978,32 +10015,324 @@ function runSelfEval(opts) {
     dslCoverageScore,
     compileScore,
     reviewScore: reviewScore ?? void 0,
-    promptHash
+    promptHash,
+    modelNameCoverage: result.detail.modelNameCoverage,
+    modelNameMatched: result.detail.modelNameMatched,
+    endpointLayerFiles: result.detail.endpointLayerFiles
   });
   return result;
 }
 function printSelfEval(result) {
-  const scoreColor = result.harnessScore >= 8 ? chalk18.green : result.harnessScore >= 6 ? chalk18.yellow : chalk18.red;
+  const scoreColor2 = result.harnessScore >= 8 ? chalk18.green : result.harnessScore >= 6 ? chalk18.yellow : chalk18.red;
   const filled = Math.round(result.harnessScore);
   const bar = "\u2588".repeat(filled) + "\u2591".repeat(10 - filled);
   const compileTag = result.compileScore === 10 ? chalk18.green("pass") : chalk18.yellow("partial");
   const reviewTag = result.reviewScore !== null ? `Review: ${result.reviewScore}/10` : chalk18.gray("Review: skipped");
+  let modelCoverageTag = "";
+  if (result.detail.modelsTotal > 0) {
+    const pct = Math.round(result.detail.modelNameCoverage * 100);
+    const tag = `Models: ${result.detail.modelNameMatched}/${result.detail.modelsTotal} (${pct}%)`;
+    modelCoverageTag = pct >= 80 ? chalk18.green(tag) : pct >= 50 ? chalk18.yellow(tag) : chalk18.red(tag);
+  }
   console.log(chalk18.cyan("\n\u2500\u2500\u2500 Harness Self-Eval \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log(`  Score  : ${scoreColor(`[${bar}] ${result.harnessScore}/10`)}`);
+  console.log(`  Score  : ${scoreColor2(`[${bar}] ${result.harnessScore}/10`)}`);
   console.log(
-    `  DSL    : ${scoreColor(result.dslCoverageScore + "/10")}  Compile: ${compileTag}  ${reviewTag}`
+    `  DSL    : ${scoreColor2(String(result.dslCoverageScore) + "/10")}  Compile: ${compileTag}  ${reviewTag}`
   );
+  if (modelCoverageTag) {
+    console.log(
+      `  Detail : ${modelCoverageTag}  ` + chalk18.gray(`Endpoints: ${result.detail.endpointsTotal}  Files: ${result.detail.filesWritten}`)
+    );
+  }
   console.log(chalk18.gray(`  Prompt : ${result.promptHash}`));
-  console.log(chalk18.gray("\u2500".repeat(49)));
+  console.log(chalk18.cyan("\u2500".repeat(49)));
+}
+
+// core/run-trend.ts
+import * as fs23 from "fs-extra";
+import * as path22 from "path";
+import chalk19 from "chalk";
+var LOG_DIR2 = ".ai-spec-logs";
+async function loadRunLogs(workingDir) {
+  const logDir = path22.join(workingDir, LOG_DIR2);
+  if (!await fs23.pathExists(logDir)) return [];
+  const files = await fs23.readdir(logDir);
+  const jsonFiles = files.filter((f) => f.endsWith(".json")).sort().reverse();
+  const logs = [];
+  for (const file of jsonFiles) {
+    try {
+      const log = await fs23.readJson(path22.join(logDir, file));
+      if (log.runId && log.startedAt) {
+        logs.push(log);
+      }
+    } catch {
+    }
+  }
+  return logs;
+}
+function buildTrendReport(logs, opts = {}) {
+  let entries = logs.map((log) => ({
+    runId: log.runId,
+    startedAt: log.startedAt,
+    promptHash: log.promptHash ?? null,
+    harnessScore: log.harnessScore ?? null,
+    specPath: log.specPath ?? null,
+    provider: log.provider ?? null,
+    model: log.model ?? null,
+    filesWritten: log.filesWritten?.length ?? 0,
+    totalDurationMs: log.totalDurationMs ?? null,
+    errors: log.errors?.length ?? 0
+  }));
+  entries = entries.filter((e) => e.harnessScore !== null);
+  if (opts.promptFilter) {
+    entries = entries.filter(
+      (e) => e.promptHash?.startsWith(opts.promptFilter)
+    );
+  }
+  if (opts.last && opts.last > 0) {
+    entries = entries.slice(0, opts.last);
+  }
+  const groupMap = /* @__PURE__ */ new Map();
+  for (const e of entries) {
+    const key = e.promptHash ?? "(none)";
+    if (!groupMap.has(key)) groupMap.set(key, []);
+    groupMap.get(key).push(e);
+  }
+  const currentHash = entries[0]?.promptHash ?? null;
+  const promptGroups = [];
+  for (const [hash, group] of groupMap.entries()) {
+    const scores = group.map((e) => e.harnessScore);
+    promptGroups.push({
+      promptHash: hash,
+      runs: group.length,
+      avg: Math.round(scores.reduce((a, b) => a + b, 0) / scores.length * 10) / 10,
+      best: Math.max(...scores),
+      worst: Math.min(...scores),
+      firstSeen: group[group.length - 1].startedAt,
+      lastSeen: group[0].startedAt,
+      isCurrent: hash === currentHash
+    });
+  }
+  promptGroups.sort((a, b) => b.lastSeen.localeCompare(a.lastSeen));
+  return { entries, promptGroups, totalRuns: entries.length };
+}
+function scoreBar2(score) {
+  const filled = Math.round(score);
+  return "\u2588".repeat(filled) + "\u2591".repeat(10 - filled);
+}
+function scoreColor(score, text) {
+  if (score >= 8) return chalk19.green(text);
+  if (score >= 6) return chalk19.yellow(text);
+  return chalk19.red(text);
+}
+function formatDate(iso) {
+  return iso.slice(0, 10);
+}
+function formatDuration(ms2) {
+  if (ms2 === null) return "  \u2014  ";
+  const s = Math.round(ms2 / 1e3);
+  if (s < 60) return `${s}s`;
+  return `${Math.floor(s / 60)}m${s % 60}s`;
+}
+function shortSpec(specPath) {
+  if (!specPath) return chalk19.gray("\u2014");
+  return path22.basename(specPath);
+}
+function printTrendReport(report, workingDir) {
+  const { entries, promptGroups } = report;
+  console.log(chalk19.cyan("\n\u2500\u2500\u2500 Harness Trend \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  if (entries.length === 0) {
+    console.log(chalk19.gray("  No scored runs found. Run `ai-spec create` to start tracking."));
+    console.log(chalk19.cyan("\u2500".repeat(63)));
+    return;
+  }
+  if (promptGroups.length > 0) {
+    console.log(chalk19.bold("\n  Prompt Versions:\n"));
+    const colWidths = {
+      hash: 10,
+      runs: 5,
+      avg: 5,
+      best: 5,
+      worst: 5
+    };
+    console.log(
+      chalk19.gray(
+        "  " + "Hash      ".padEnd(colWidths.hash) + " " + "Runs ".padStart(colWidths.runs) + "   Avg  Best Worst  Last seen"
+      )
+    );
+    console.log(chalk19.gray("  " + "\u2500".repeat(55)));
+    for (const g of promptGroups) {
+      const currentMark = g.isCurrent ? chalk19.cyan(" \u25C0 current") : "";
+      const avgStr = scoreColor(g.avg, g.avg.toFixed(1).padStart(5));
+      const bestStr = chalk19.green(g.best.toFixed(1).padStart(5));
+      const worstStr = g.worst < 6 ? chalk19.red(g.worst.toFixed(1).padStart(5)) : chalk19.yellow(g.worst.toFixed(1).padStart(5));
+      console.log(
+        "  " + chalk19.white(g.promptHash.padEnd(colWidths.hash)) + " " + chalk19.gray(String(g.runs).padStart(colWidths.runs)) + " " + avgStr + " " + bestStr + " " + worstStr + "  " + chalk19.gray(formatDate(g.lastSeen)) + currentMark
+      );
+    }
+  }
+  console.log(chalk19.bold("\n  Run History:\n"));
+  for (const e of entries) {
+    const score = e.harnessScore;
+    const bar = scoreColor(score, `[${scoreBar2(score)}]`);
+    const scoreStr = scoreColor(score, score.toFixed(1).padStart(4));
+    const hash = e.promptHash ? chalk19.gray(e.promptHash) : chalk19.gray("(no hash)");
+    const dur = chalk19.gray(formatDuration(e.totalDurationMs));
+    const errMark = e.errors > 0 ? chalk19.yellow(` \u26A0${e.errors}err`) : "";
+    const spec = chalk19.gray(shortSpec(e.specPath));
+    console.log(
+      `  ${chalk19.gray(formatDate(e.startedAt))}  ${bar}${scoreStr}  ${hash}  ${dur}${errMark}  ${spec}`
+    );
+  }
+  const logRelDir = path22.relative(workingDir, path22.join(workingDir, LOG_DIR2));
+  console.log(chalk19.gray(`
+  ${entries.length} run(s) shown  \xB7  logs: ${logRelDir}/`));
+  console.log(chalk19.cyan("\u2500".repeat(63)));
+}
+
+// core/dsl-feedback.ts
+import chalk20 from "chalk";
+function assessDslRichness(dsl) {
+  const gaps = [];
+  if (dsl.endpoints.length === 0 && dsl.models.length === 0) {
+    gaps.push({
+      code: "no_models_no_endpoints",
+      message: "DSL has no endpoints and no models \u2014 spec may be too abstract for structured extraction",
+      hint: "Please add explicit API endpoint definitions (method, path, request/response) and any data models that this feature requires."
+    });
+    return gaps;
+  }
+  const GENERIC_DESC_KEYWORDS = ["handles", "processes", "manages", "\u64CD\u4F5C", "\u5904\u7406", "\u7BA1\u7406"];
+  const GENERIC_DESC_MIN_LEN = 15;
+  for (const ep of dsl.endpoints) {
+    const desc = (ep.description ?? "").trim();
+    const isGeneric = desc.length < GENERIC_DESC_MIN_LEN || GENERIC_DESC_KEYWORDS.some((kw) => desc.toLowerCase().startsWith(kw));
+    if (isGeneric) {
+      gaps.push({
+        code: "generic_endpoint_desc",
+        message: `Endpoint ${ep.method} ${ep.path} has a vague description: "${desc}"`,
+        hint: `Clarify what ${ep.method} ${ep.path} does: what inputs are required, what the success response contains, and what business rule it enforces.`
+      });
+    }
+  }
+  const endpointsWithoutErrors = dsl.endpoints.filter(
+    (ep) => !ep.errors || ep.errors.length === 0
+  );
+  if (endpointsWithoutErrors.length > 0 && dsl.endpoints.length >= 2) {
+    gaps.push({
+      code: "missing_errors",
+      message: `${endpointsWithoutErrors.length}/${dsl.endpoints.length} endpoints have no error definitions`,
+      hint: `For each endpoint, specify at least the main error cases: e.g. 400 validation errors, 401 auth failures, 404 not found, 409 conflict. Include an error code (e.g. INVALID_INPUT) and description for each.`
+    });
+  }
+  for (const model of dsl.models) {
+    if (!model.fields || model.fields.length < 2) {
+      gaps.push({
+        code: "sparse_model",
+        message: `Model "${model.name}" has only ${model.fields?.length ?? 0} field(s) \u2014 likely incomplete`,
+        hint: `List all fields for "${model.name}" with their types and whether they are required. Include at minimum an id, created_at, and the core domain fields this model needs.`
+      });
+    }
+  }
+  return gaps;
+}
+function buildDslGapRefinementPrompt(spec, gaps) {
+  const gapList = gaps.map((g, i) => `${i + 1}. [${g.code}] ${g.message}
+   \u2192 ${g.hint}`).join("\n\n");
+  return `The following feature spec has been structurally analysed. The DSL extracted from it was found to be incomplete in these specific areas:
+
+${gapList}
+
+Your task: revise the spec below to address ONLY the gaps listed above.
+- Do NOT change the overall feature scope or business logic.
+- Do NOT rewrite sections that are already complete.
+- Add missing error cases, clarify vague endpoint descriptions, complete sparse model field lists.
+- Output ONLY the complete revised Markdown spec. No preamble, no explanation.
+
+=== Current Spec ===
+${spec}`;
+}
+function extractStructuralFindings(reviewText) {
+  const parts = reviewText.split(/─{20,}/);
+  const pass1Text = parts[0] ?? "";
+  const pass1Score = extractPassScore(pass1Text);
+  if (pass1Score !== null && pass1Score >= 8) return [];
+  const findings = [];
+  if (/缺少认证|missing auth|auth.*false|未加认证|鉴权.*缺|endpoint.*public.*should/i.test(pass1Text)) {
+    const match = pass1Text.match(/[^。\n]*(?:缺少认证|missing auth|auth.*false|未加认证|鉴权.*缺|endpoint.*public.*should)[^。\n]*/i);
+    findings.push({
+      category: "auth_design",
+      description: match ? match[0].trim() : "One or more endpoints may have incorrect authentication requirements"
+    });
+  }
+  if (/接口设计.*问题|接口.*不合理|API design|response.*missing|request.*missing|接口.*缺少/i.test(pass1Text)) {
+    const match = pass1Text.match(/[^。\n]*(?:接口设计.*问题|接口.*不合理|API design|response.*missing|接口.*缺少)[^。\n]*/i);
+    findings.push({
+      category: "api_contract",
+      description: match ? match[0].trim() : "API contract design may have issues"
+    });
+  }
+  if (/模型.*缺少字段|model.*missing field|数据结构.*问题|schema.*incomplete|字段.*missing/i.test(pass1Text)) {
+    const match = pass1Text.match(/[^。\n]*(?:模型.*缺少字段|model.*missing field|数据结构.*问题|schema.*incomplete)[^。\n]*/i);
+    findings.push({
+      category: "model_design",
+      description: match ? match[0].trim() : "Data model design may be incomplete"
+    });
+  }
+  if (/层级.*违反|layer.*violation|business logic.*controller|controller.*service.*混|分层.*问题/i.test(pass1Text)) {
+    const match = pass1Text.match(/[^。\n]*(?:层级.*违反|layer.*violation|business logic.*controller|分层.*问题)[^。\n]*/i);
+    findings.push({
+      category: "layer_violation",
+      description: match ? match[0].trim() : "Layer separation may be violated in the generated code"
+    });
+  }
+  return findings;
+}
+function extractPassScore(text) {
+  const m = text.match(/Score:\s*(\d+(?:\.\d+)?)\s*\/\s*10/i);
+  return m ? parseFloat(m[1]) : null;
+}
+function buildStructuralAmendmentPrompt(spec, findings) {
+  const findingList = findings.map((f, i) => `${i + 1}. [${f.category}] ${f.description}`).join("\n");
+  return `A code review of the feature built from this spec found the following DESIGN-LEVEL issues.
+These are problems in the spec/contract itself, not in the implementation.
+
+=== Structural Findings ===
+${findingList}
+
+Your task:
+- Revise the spec below to correct the design issues listed above.
+- Do NOT change the feature scope, business logic, or sections unrelated to these findings.
+- Be minimal: only change what is necessary to fix the design issues.
+- Output ONLY the complete revised Markdown spec. No preamble, no explanation.
+
+=== Current Spec ===
+${spec}`;
+}
+function printDslGaps(gaps) {
+  console.log(chalk20.yellow("\n  \u26A0 DSL Completeness Check \u2014 gaps detected:"));
+  for (const gap of gaps) {
+    console.log(chalk20.yellow(`    \xB7 ${gap.message}`));
+  }
+  console.log(chalk20.gray("    \u2192 A targeted spec refinement can fill these gaps before codegen."));
+}
+function printStructuralFindings(findings) {
+  console.log(chalk20.yellow("\n  \u26A0 Review \u2014 structural (design-level) issues found:"));
+  for (const f of findings) {
+    const label = chalk20.gray(`[${f.category}]`);
+    console.log(`    ${label} ${f.description}`);
+  }
+  console.log(chalk20.gray("    \u2192 These are contract issues in the Spec/DSL, not just implementation problems."));
+  console.log(chalk20.gray("    \u2192 Fixing the spec now means the next run generates correct code from the start."));
 }
 
 // cli/index.ts
 dotenv.config();
 var CONFIG_FILE = ".ai-spec.json";
 async function loadConfig(dir) {
-  const p = path22.join(dir, CONFIG_FILE);
-  if (await fs23.pathExists(p)) {
-    return fs23.readJson(p);
+  const p = path23.join(dir, CONFIG_FILE);
+  if (await fs24.pathExists(p)) {
+    return fs24.readJson(p);
   }
   return {};
 }
@@ -10028,20 +10357,20 @@ async function resolveApiKey(providerName, cliKey) {
     validate: (v2) => v2.trim().length > 0 || "API key cannot be empty"
   });
   await saveKey(providerName, newKey.trim());
-  console.log(chalk19.gray(`  Key saved to ${KEY_STORE_FILE}`));
+  console.log(chalk21.gray(`  Key saved to ${KEY_STORE_FILE}`));
   return newKey.trim();
 }
 function printBanner(opts) {
-  console.log(chalk19.blue("\n" + "\u2500".repeat(52)));
-  console.log(chalk19.bold("  ai-spec \u2014 AI-driven Development Orchestrator"));
-  console.log(chalk19.blue("\u2500".repeat(52)));
-  console.log(chalk19.gray(`  Spec    : ${opts.specProvider} / ${opts.specModel}`));
+  console.log(chalk21.blue("\n" + "\u2500".repeat(52)));
+  console.log(chalk21.bold("  ai-spec \u2014 AI-driven Development Orchestrator"));
+  console.log(chalk21.blue("\u2500".repeat(52)));
+  console.log(chalk21.gray(`  Spec    : ${opts.specProvider} / ${opts.specModel}`));
   console.log(
-    chalk19.gray(
+    chalk21.gray(
       `  Codegen : ${opts.codegenMode} (${opts.codegenProvider} / ${opts.codegenModel})`
     )
   );
-  console.log(chalk19.blue("\u2500".repeat(52) + "\n"));
+  console.log(chalk21.blue("\u2500".repeat(52) + "\n"));
 }
 var program = new Command();
 program.name("ai-spec").description("AI-driven Development Orchestrator \u2014 spec, generate, review").version("0.14.1");
@@ -10068,42 +10397,42 @@ program.command("create").description("Generate a feature spec and kick off code
   const workspaceLoader = new WorkspaceLoader(currentDir);
   const workspaceConfig = await workspaceLoader.load();
   if (workspaceConfig) {
-    console.log(chalk19.cyan(`
+    console.log(chalk21.cyan(`
 [Workspace] Detected workspace: ${workspaceConfig.name}`));
-    console.log(chalk19.gray(`  Repos: ${workspaceConfig.repos.map((r) => r.name).join(", ")}`));
+    console.log(chalk21.gray(`  Repos: ${workspaceConfig.repos.map((r) => r.name).join(", ")}`));
     const pipelineResults = await runMultiRepoPipeline(idea, workspaceConfig, opts, currentDir, config2);
     if (opts.serve) {
-      console.log(chalk19.blue("\n\u2500\u2500\u2500 Auto-serve: starting mock server \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+      console.log(chalk21.blue("\n\u2500\u2500\u2500 Auto-serve: starting mock server \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
       const backendResult = pipelineResults.find((r) => r.role === "backend" && r.status === "success" && r.dsl);
       const frontendResult = pipelineResults.find((r) => (r.role === "frontend" || r.role === "mobile") && r.status === "success");
       if (!backendResult) {
-        console.log(chalk19.yellow("  No successful backend with DSL found \u2014 skipping auto-serve."));
+        console.log(chalk21.yellow("  No successful backend with DSL found \u2014 skipping auto-serve."));
       } else {
         const mockPort = 3001;
         const mockResult = await generateMockAssets(backendResult.dsl, backendResult.repoAbsPath, { port: mockPort });
-        const serverJsPath = path22.join(backendResult.repoAbsPath, "mock", "server.js");
-        console.log(chalk19.green(`  \u2714 Mock assets generated (${mockResult.files.length} file(s))`));
+        const serverJsPath = path23.join(backendResult.repoAbsPath, "mock", "server.js");
+        console.log(chalk21.green(`  \u2714 Mock assets generated (${mockResult.files.length} file(s))`));
         const pid = startMockServerBackground(serverJsPath, mockPort);
-        console.log(chalk19.green(`  \u2714 Mock server started (PID ${pid}) \u2192 http://localhost:${mockPort}`));
+        console.log(chalk21.green(`  \u2714 Mock server started (PID ${pid}) \u2192 http://localhost:${mockPort}`));
         if (frontendResult) {
           const proxyResult = await applyMockProxy(frontendResult.repoAbsPath, mockPort, backendResult.dsl.endpoints);
           await saveMockServerPid(frontendResult.repoAbsPath, pid);
           if (proxyResult.applied) {
-            console.log(chalk19.green(`  \u2714 Frontend proxy patched (${proxyResult.framework})`));
-            console.log(chalk19.bold.cyan(`
+            console.log(chalk21.green(`  \u2714 Frontend proxy patched (${proxyResult.framework})`));
+            console.log(chalk21.bold.cyan(`
   Ready! Run your frontend dev server:`));
-            console.log(chalk19.white(`    cd ${frontendResult.repoAbsPath}`));
-            console.log(chalk19.white(`    ${proxyResult.devCommand}`));
-            console.log(chalk19.gray(`
+            console.log(chalk21.white(`    cd ${frontendResult.repoAbsPath}`));
+            console.log(chalk21.white(`    ${proxyResult.devCommand}`));
+            console.log(chalk21.gray(`
   When done, restore: ai-spec mock --restore --frontend ${frontendResult.repoAbsPath}`));
           } else {
-            console.log(chalk19.yellow(`  \u26A0 Auto-patch not available for ${proxyResult.framework}.`));
-            if (proxyResult.note) console.log(chalk19.gray(`    ${proxyResult.note}`));
-            console.log(chalk19.gray(`    Mock server: http://localhost:${mockPort}`));
+            console.log(chalk21.yellow(`  \u26A0 Auto-patch not available for ${proxyResult.framework}.`));
+            if (proxyResult.note) console.log(chalk21.gray(`    ${proxyResult.note}`));
+            console.log(chalk21.gray(`    Mock server: http://localhost:${mockPort}`));
           }
         } else {
-          console.log(chalk19.gray(`  No frontend repo found \u2014 mock server is running at http://localhost:${mockPort}`));
-          console.log(chalk19.gray(`  Configure your frontend proxy manually to point to http://localhost:${mockPort}`));
+          console.log(chalk21.gray(`  No frontend repo found \u2014 mock server is running at http://localhost:${mockPort}`));
+          console.log(chalk21.gray(`  Configure your frontend proxy manually to point to http://localhost:${mockPort}`));
         }
       }
     }
@@ -10124,7 +10453,7 @@ program.command("create").description("Generate a feature spec and kick off code
     codegenModel: codegenModelName
   });
   const runId = generateRunId();
-  console.log(chalk19.gray(`  Run ID: ${runId}`));
+  console.log(chalk21.gray(`  Run ID: ${runId}`));
   const runSnapshot = new RunSnapshot(currentDir, runId);
   setActiveSnapshot(runSnapshot);
   const runLogger = new RunLogger(currentDir, runId, {
@@ -10134,25 +10463,25 @@ program.command("create").description("Generate a feature spec and kick off code
   setActiveLogger(runLogger);
   const promptHash = computePromptHash();
   runLogger.setPromptHash(promptHash);
-  console.log(chalk19.blue("[1/6] Loading project context..."));
+  console.log(chalk21.blue("[1/6] Loading project context..."));
   runLogger.stageStart("context_load");
   const loader = new ContextLoader(currentDir);
   const context = await loader.loadProjectContext();
   const { type: detectedRepoType } = await detectRepoType(currentDir);
   runLogger.stageEnd("context_load", { techStack: context.techStack, repoType: detectedRepoType });
-  console.log(chalk19.gray(`  Tech stack  : ${context.techStack.join(", ") || "unknown"} [${detectedRepoType}]`));
-  console.log(chalk19.gray(`  Dependencies: ${context.dependencies.length} packages`));
-  console.log(chalk19.gray(`  API files   : ${context.apiStructure.length} files`));
+  console.log(chalk21.gray(`  Tech stack  : ${context.techStack.join(", ") || "unknown"} [${detectedRepoType}]`));
+  console.log(chalk21.gray(`  Dependencies: ${context.dependencies.length} packages`));
+  console.log(chalk21.gray(`  API files   : ${context.apiStructure.length} files`));
   if (context.schema) {
-    console.log(chalk19.gray(`  Prisma schema: found`));
+    console.log(chalk21.gray(`  Prisma schema: found`));
   }
   if (context.constitution) {
-    console.log(chalk19.green(`  Constitution : found (.ai-spec-constitution.md)`));
+    console.log(chalk21.green(`  Constitution : found (.ai-spec-constitution.md)`));
     if (context.constitution.length > 6e3) {
-      console.log(chalk19.yellow(`  \u26A0 Constitution is long (${context.constitution.length.toLocaleString()} chars). Consider running: ai-spec init --consolidate`));
+      console.log(chalk21.yellow(`  \u26A0 Constitution is long (${context.constitution.length.toLocaleString()} chars). Consider running: ai-spec init --consolidate`));
     }
   } else {
-    console.log(chalk19.yellow("  Constitution : not found \u2014 auto-generating..."));
+    console.log(chalk21.yellow("  Constitution : not found \u2014 auto-generating..."));
     try {
       const constitutionGen = new ConstitutionGenerator(
         createProvider(specProviderName, specApiKey, specModelName)
@@ -10160,12 +10489,12 @@ program.command("create").description("Generate a feature spec and kick off code
       const constitutionContent = await constitutionGen.generate(currentDir);
       await constitutionGen.saveConstitution(currentDir, constitutionContent);
       context.constitution = constitutionContent;
-      console.log(chalk19.green(`  Constitution : \u2714 generated and saved (.ai-spec-constitution.md)`));
+      console.log(chalk21.green(`  Constitution : \u2714 generated and saved (.ai-spec-constitution.md)`));
     } catch (err) {
-      console.log(chalk19.yellow(`  Constitution : \u26A0 auto-generation failed (${err.message}), continuing without it.`));
+      console.log(chalk21.yellow(`  Constitution : \u26A0 auto-generation failed (${err.message}), continuing without it.`));
     }
   }
-  console.log(chalk19.blue(`
+  console.log(chalk21.blue(`
 [2/6] Generating spec with ${specProviderName}/${specModelName}...`));
   const specProvider = createProvider(specProviderName, specApiKey, specModelName);
   let initialSpec;
@@ -10175,30 +10504,30 @@ program.command("create").description("Generate a feature spec and kick off code
     if (opts.skipTasks) {
       const generator = new SpecGenerator(specProvider);
       initialSpec = await generator.generateSpec(idea, context);
-      console.log(chalk19.green("  \u2714 Spec generated."));
+      console.log(chalk21.green("  \u2714 Spec generated."));
     } else {
       const result = await generateSpecWithTasks(specProvider, idea, context);
       initialSpec = result.spec;
       initialTasks = result.tasks;
-      console.log(chalk19.green(`  \u2714 Spec generated.`));
+      console.log(chalk21.green(`  \u2714 Spec generated.`));
       if (initialTasks.length > 0) {
-        console.log(chalk19.green(`  \u2714 ${initialTasks.length} tasks generated (combined call).`));
+        console.log(chalk21.green(`  \u2714 ${initialTasks.length} tasks generated (combined call).`));
       } else {
-        console.log(chalk19.yellow("  \u26A0 Tasks not parsed from response \u2014 will retry separately after refinement."));
+        console.log(chalk21.yellow("  \u26A0 Tasks not parsed from response \u2014 will retry separately after refinement."));
       }
     }
     runLogger.stageEnd("spec_gen", { taskCount: initialTasks.length });
   } catch (err) {
     runLogger.stageFail("spec_gen", err.message);
-    console.error(chalk19.red("  \u2718 Spec generation failed:"), err);
+    console.error(chalk21.red("  \u2718 Spec generation failed:"), err);
     process.exit(1);
   }
   let finalSpec;
   if (opts.fast) {
-    console.log(chalk19.gray("\n[3/6] Skipping refinement (--fast)."));
+    console.log(chalk21.gray("\n[3/6] Skipping refinement (--fast)."));
     finalSpec = initialSpec;
   } else {
-    console.log(chalk19.blue("\n[3/6] Interactive spec refinement..."));
+    console.log(chalk21.blue("\n[3/6] Interactive spec refinement..."));
     runLogger.stageStart("spec_refine");
     const refiner = new SpecRefiner(specProvider);
     finalSpec = await refiner.refineLoop(initialSpec);
@@ -10209,7 +10538,7 @@ program.command("create").description("Generate a feature spec and kick off code
   const shouldRunAssessment = !opts.skipAssessment && (!opts.auto || minScore > 0);
   if (shouldRunAssessment) {
     if (!opts.auto) {
-      console.log(chalk19.blue("\n[3.4/6] Spec quality assessment..."));
+      console.log(chalk21.blue("\n[3.4/6] Spec quality assessment..."));
     }
     runLogger.stageStart("spec_assess");
     const assessment = await assessSpec(specProvider, finalSpec, context.constitution ?? void 0);
@@ -10218,45 +10547,45 @@ program.command("create").description("Generate a feature spec and kick off code
       if (!opts.auto) printSpecAssessment(assessment);
       if (minScore > 0 && assessment.overallScore < minScore) {
         if (opts.force) {
-          console.log(chalk19.yellow(`
+          console.log(chalk21.yellow(`
   \u26A0 Score gate: ${assessment.overallScore}/10 < minimum ${minScore}/10 \u2014 bypassed with --force.`));
         } else {
           runLogger.stageFail("spec_assess", `Score gate: ${assessment.overallScore} < ${minScore}`);
-          console.log(chalk19.red(`
+          console.log(chalk21.red(`
   \u2718 Spec quality gate failed: overallScore ${assessment.overallScore}/10 < minimum ${minScore}/10`));
           if (!opts.auto) {
-            console.log(chalk19.gray(`  Address the issues above and re-run, or use --force to bypass.`));
+            console.log(chalk21.gray(`  Address the issues above and re-run, or use --force to bypass.`));
           } else {
-            console.log(chalk19.gray(`  Auto mode: gate enforced. Fix the spec or lower minSpecScore, or use --force to bypass.`));
+            console.log(chalk21.gray(`  Auto mode: gate enforced. Fix the spec or lower minSpecScore, or use --force to bypass.`));
           }
-          console.log(chalk19.gray(`  Gate threshold set in .ai-spec.json \u2192 "minSpecScore": ${minScore}`));
+          console.log(chalk21.gray(`  Gate threshold set in .ai-spec.json \u2192 "minSpecScore": ${minScore}`));
           process.exit(1);
         }
       }
     } else {
       runLogger.stageEnd("spec_assess", { skipped: true });
       if (!opts.auto) {
-        console.log(chalk19.gray("  (Assessment skipped \u2014 AI call failed or timed out)"));
+        console.log(chalk21.gray("  (Assessment skipped \u2014 AI call failed or timed out)"));
       }
     }
   }
   if (!opts.auto) {
-    console.log(chalk19.blue("\n[3.5/6] Approval Gate \u2014 review before code generation"));
+    console.log(chalk21.blue("\n[3.5/6] Approval Gate \u2014 review before code generation"));
     const specLines = finalSpec.split("\n").length;
     const specWords = finalSpec.split(/\s+/).length;
     const taskCountHint = initialTasks.length > 0 ? `  Tasks generated : ${initialTasks.length}` : "";
-    console.log(chalk19.gray(`  Spec length     : ${specLines} lines / ${specWords} words`));
-    if (taskCountHint) console.log(chalk19.gray(taskCountHint));
-    const previewSpecsDir = path22.join(currentDir, "specs");
+    console.log(chalk21.gray(`  Spec length     : ${specLines} lines / ${specWords} words`));
+    if (taskCountHint) console.log(chalk21.gray(taskCountHint));
+    const previewSpecsDir = path23.join(currentDir, "specs");
     const slug = featureSlug;
     const prevVersion = await findLatestVersion(previewSpecsDir, slug);
     if (prevVersion) {
-      console.log(chalk19.gray(`  Previous version: v${prevVersion.version} (${prevVersion.filePath})`));
+      console.log(chalk21.gray(`  Previous version: v${prevVersion.version} (${prevVersion.filePath})`));
       const diff = computeDiff(prevVersion.content, finalSpec);
-      console.log(chalk19.cyan("\n  \u2500\u2500 Changes vs previous version \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+      console.log(chalk21.cyan("\n  \u2500\u2500 Changes vs previous version \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
       printDiffSummary(diff, `v${prevVersion.version} \u2192 v${prevVersion.version + 1}`);
       printDiff(diff);
-      console.log(chalk19.cyan("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+      console.log(chalk21.cyan("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     }
     const gate = await select3({
       message: "Ready to proceed to code generation?",
@@ -10267,9 +10596,9 @@ program.command("create").description("Generate a feature spec and kick off code
       ]
     });
     if (gate === "view") {
-      console.log(chalk19.cyan("\n" + "\u2500".repeat(52)));
+      console.log(chalk21.cyan("\n" + "\u2500".repeat(52)));
       console.log(finalSpec);
-      console.log(chalk19.cyan("\u2500".repeat(52) + "\n"));
+      console.log(chalk21.cyan("\u2500".repeat(52) + "\n"));
       const confirm22 = await select3({
         message: "Proceed to code generation?",
         choices: [
@@ -10278,92 +10607,135 @@ program.command("create").description("Generate a feature spec and kick off code
         ]
       });
       if (confirm22 === "abort") {
-        console.log(chalk19.yellow("  Aborted. Spec was NOT saved."));
+        console.log(chalk21.yellow("  Aborted. Spec was NOT saved."));
         process.exit(0);
       }
     } else if (gate === "abort") {
-      console.log(chalk19.yellow("  Aborted. Spec was NOT saved."));
+      console.log(chalk21.yellow("  Aborted. Spec was NOT saved."));
       process.exit(0);
     }
-    console.log(chalk19.green("  \u2714 Approved \u2014 continuing to code generation."));
+    console.log(chalk21.green("  \u2714 Approved \u2014 continuing to code generation."));
   } else {
-    console.log(chalk19.gray("[3.5/6] Approval Gate: skipped (--auto)."));
+    console.log(chalk21.gray("[3.5/6] Approval Gate: skipped (--auto)."));
   }
   let extractedDsl = null;
   if (opts.skipDsl) {
-    console.log(chalk19.gray("\n[DSL] Skipped (--skip-dsl)."));
+    console.log(chalk21.gray("\n[DSL] Skipped (--skip-dsl)."));
   } else {
-    console.log(chalk19.blue("\n[DSL] Extracting structured DSL from spec..."));
-    console.log(chalk19.gray(`  Provider: ${specProviderName}/${specModelName}`));
+    console.log(chalk21.blue("\n[DSL] Extracting structured DSL from spec..."));
+    console.log(chalk21.gray(`  Provider: ${specProviderName}/${specModelName}`));
     runLogger.stageStart("dsl_extract");
     try {
       const isFrontend = isFrontendDeps(context.dependencies);
-      if (isFrontend) console.log(chalk19.gray("  Frontend project detected \u2014 using ComponentSpec extractor"));
+      if (isFrontend) console.log(chalk21.gray("  Frontend project detected \u2014 using ComponentSpec extractor"));
       const dslExtractor = new DslExtractor(specProvider);
       extractedDsl = await dslExtractor.extract(finalSpec, { auto: opts.auto, isFrontend });
       if (extractedDsl) {
         runLogger.stageEnd("dsl_extract", { endpoints: extractedDsl.endpoints?.length ?? 0, models: extractedDsl.models?.length ?? 0 });
-        console.log(chalk19.green("  \u2714 DSL extracted and validated."));
+        console.log(chalk21.green("  \u2714 DSL extracted and validated."));
       } else {
         runLogger.stageEnd("dsl_extract", { skipped: true });
-        console.log(chalk19.yellow("  \u26A0 DSL skipped \u2014 codegen will use Spec + Tasks only."));
+        console.log(chalk21.yellow("  \u26A0 DSL skipped \u2014 codegen will use Spec + Tasks only."));
       }
     } catch (err) {
       runLogger.stageFail("dsl_extract", err.message);
-      console.log(chalk19.yellow(`  \u26A0 DSL extraction error: ${err.message} \u2014 continuing without DSL.`));
+      console.log(chalk21.yellow(`  \u26A0 DSL extraction error: ${err.message} \u2014 continuing without DSL.`));
+    }
+  }
+  if (extractedDsl && !opts.auto && !opts.fast && !opts.skipDsl) {
+    const dslGaps = assessDslRichness(extractedDsl);
+    if (dslGaps.length > 0) {
+      printDslGaps(dslGaps);
+      runLogger.stageStart("dsl_gap_feedback", { gapCount: dslGaps.length, gaps: dslGaps.map((g) => g.code) });
+      const refineChoice = await select3({
+        message: "How would you like to proceed?",
+        choices: [
+          { name: "\u{1F527}  Refine spec (AI fills the gaps, then re-extract DSL)", value: "refine" },
+          { name: "\u23ED   Skip \u2014 proceed with the current DSL", value: "skip" }
+        ]
+      });
+      if (refineChoice === "refine") {
+        console.log(chalk21.blue("  Refining spec to fill DSL gaps..."));
+        try {
+          const refinedSpec = await specProvider.generate(
+            buildDslGapRefinementPrompt(finalSpec, dslGaps),
+            "You are a Senior Tech Lead doing a targeted spec revision. Output only the complete revised Markdown spec."
+          );
+          finalSpec = refinedSpec;
+          console.log(chalk21.green("  \u2714 Spec refined."));
+          console.log(chalk21.blue("  Re-extracting DSL from refined spec..."));
+          const isFrontend2 = isFrontendDeps(context.dependencies);
+          const reExtractor = new DslExtractor(specProvider);
+          const reExtractedDsl = await reExtractor.extract(finalSpec, { auto: true, isFrontend: isFrontend2 });
+          if (reExtractedDsl) {
+            extractedDsl = reExtractedDsl;
+            console.log(chalk21.green(`  \u2714 DSL re-extracted: ${extractedDsl.endpoints.length} endpoint(s), ${extractedDsl.models.length} model(s).`));
+            runLogger.stageEnd("dsl_gap_feedback", { action: "refined", endpoints: extractedDsl.endpoints.length, models: extractedDsl.models.length });
+          } else {
+            console.log(chalk21.yellow("  \u26A0 Re-extraction failed \u2014 keeping original DSL."));
+            runLogger.stageEnd("dsl_gap_feedback", { action: "refined_but_reextract_failed" });
+          }
+        } catch (err) {
+          console.log(chalk21.yellow(`  \u26A0 Spec refinement failed: ${err.message} \u2014 keeping original DSL.`));
+          runLogger.stageEnd("dsl_gap_feedback", { action: "refinement_error", error: err.message });
+        }
+      } else {
+        runLogger.stageEnd("dsl_gap_feedback", { action: "skipped" });
+        console.log(chalk21.gray("  Continuing with current DSL."));
+      }
     }
   }
   const isFrontendProject2 = isFrontendDeps(context.dependencies ?? []);
   const skipWorktree = opts.worktree ? false : opts.skipWorktree || isFrontendProject2;
   let workingDir = currentDir;
   if (!skipWorktree) {
-    console.log(chalk19.blue("\n[4/6] Setting up git worktree..."));
+    console.log(chalk21.blue("\n[4/6] Setting up git worktree..."));
     const worktreeManager = new GitWorktreeManager(currentDir);
     const worktreePath = await worktreeManager.createWorktree(idea);
     if (worktreePath) workingDir = worktreePath;
   } else {
     const reason = opts.worktree ? "" : isFrontendProject2 ? " (frontend project \u2014 use --worktree to override)" : " (--skip-worktree)";
-    console.log(chalk19.gray(`[4/6] Skipping worktree${reason}.`));
+    console.log(chalk21.gray(`[4/6] Skipping worktree${reason}.`));
   }
-  const specsDir = path22.join(workingDir, "specs");
-  await fs23.ensureDir(specsDir);
+  const specsDir = path23.join(workingDir, "specs");
+  await fs24.ensureDir(specsDir);
   const { filePath: specFile, version: specVersion } = await nextVersionPath(specsDir, featureSlug);
-  await fs23.writeFile(specFile, finalSpec, "utf-8");
-  console.log(chalk19.green(`
-[5/6] \u2714 Spec saved: ${specFile}`) + chalk19.gray(` (v${specVersion})`));
+  await fs24.writeFile(specFile, finalSpec, "utf-8");
+  console.log(chalk21.green(`
+[5/6] \u2714 Spec saved: ${specFile}`) + chalk21.gray(` (v${specVersion})`));
   let savedDslFile = null;
   if (extractedDsl) {
     const dslExtractor = new DslExtractor(specProvider);
     savedDslFile = await dslExtractor.saveDsl(extractedDsl, specFile);
-    console.log(chalk19.green(`  \u2714 DSL saved : ${savedDslFile}`));
+    console.log(chalk21.green(`  \u2714 DSL saved : ${savedDslFile}`));
   }
   if (!opts.skipTasks) {
     const taskGen = new TaskGenerator(specProvider);
     let tasksToSave = initialTasks;
     if (tasksToSave.length === 0) {
-      console.log(chalk19.blue(`
+      console.log(chalk21.blue(`
   Generating tasks (separate call)...`));
       try {
         tasksToSave = await taskGen.generateTasks(finalSpec, context);
       } catch (err) {
-        console.log(chalk19.yellow(`  \u26A0 Task generation failed: ${err.message}`));
+        console.log(chalk21.yellow(`  \u26A0 Task generation failed: ${err.message}`));
       }
     }
     if (tasksToSave.length > 0) {
       const sorted = taskGen.sortByLayer(tasksToSave);
       const tasksFile = await taskGen.saveTasks(sorted, specFile);
       printTasks(sorted);
-      console.log(chalk19.green(`  \u2714 Tasks saved: ${tasksFile}`));
+      console.log(chalk21.green(`  \u2714 Tasks saved: ${tasksFile}`));
     } else {
-      console.log(chalk19.yellow("  \u26A0 No tasks generated \u2014 code generation will use fallback file planning."));
+      console.log(chalk21.yellow("  \u26A0 No tasks generated \u2014 code generation will use fallback file planning."));
     }
   }
-  console.log(chalk19.blue(`
+  console.log(chalk21.blue(`
 [6/6] Code generation (mode: ${codegenMode})...`));
   const codegenProvider = codegenProviderName === specProviderName && codegenApiKey === specApiKey ? specProvider : createProvider(codegenProviderName, codegenApiKey, codegenModelName);
   let generatedTestFiles = [];
   if (opts.tdd && extractedDsl) {
-    console.log(chalk19.cyan("\n[TDD] Generating pre-implementation tests (will fail until code is written)..."));
+    console.log(chalk21.cyan("\n[TDD] Generating pre-implementation tests (will fail until code is written)..."));
     const testGen = new TestGenerator(codegenProvider);
     generatedTestFiles = await testGen.generateTdd(extractedDsl, workingDir);
   }
@@ -10377,13 +10749,13 @@ program.command("create").description("Generate a feature spec and kick off code
   });
   runLogger.stageEnd("codegen", { filesGenerated: generatedFiles.length });
   if (opts.tdd) {
-    console.log(chalk19.gray("\n[7/9] TDD mode \u2014 test files already written pre-implementation."));
+    console.log(chalk21.gray("\n[7/9] TDD mode \u2014 test files already written pre-implementation."));
   } else if (opts.skipTests) {
-    console.log(chalk19.gray("\n[7/9] Skipping test generation (--skip-tests)."));
+    console.log(chalk21.gray("\n[7/9] Skipping test generation (--skip-tests)."));
   } else if (!extractedDsl) {
-    console.log(chalk19.gray("\n[7/9] Skipping test generation (no DSL available)."));
+    console.log(chalk21.gray("\n[7/9] Skipping test generation (no DSL available)."));
   } else {
-    console.log(chalk19.blue(`
+    console.log(chalk21.blue(`
 [7/9] Test skeleton generation...`));
     runLogger.stageStart("test_gen");
     const testGen = new TestGenerator(codegenProvider);
@@ -10392,11 +10764,11 @@ program.command("create").description("Generate a feature spec and kick off code
   }
   let compilePassed = false;
   if (opts.skipErrorFeedback) {
-    console.log(chalk19.gray("[8/9] Skipping error feedback (--skip-error-feedback)."));
+    console.log(chalk21.gray("[8/9] Skipping error feedback (--skip-error-feedback)."));
     compilePassed = true;
   } else {
     if (opts.tdd) {
-      console.log(chalk19.cyan("[8/9] TDD mode \u2014 error feedback loop driving implementation to pass tests..."));
+      console.log(chalk21.cyan("[8/9] TDD mode \u2014 error feedback loop driving implementation to pass tests..."));
     }
     runLogger.stageStart("error_feedback");
     compilePassed = await runErrorFeedback(codegenProvider, workingDir, extractedDsl, {
@@ -10407,10 +10779,10 @@ program.command("create").description("Generate a feature spec and kick off code
   }
   let reviewResult = "";
   if (!opts.skipReview) {
-    console.log(chalk19.blue("\n[9/9] Automated code review (3-pass: architecture + implementation + impact/complexity)..."));
+    console.log(chalk21.blue("\n[9/9] Automated code review (3-pass: architecture + implementation + impact/complexity)..."));
     runLogger.stageStart("review");
     const reviewer = new CodeReviewer(specProvider, currentDir);
-    const savedSpec = await fs23.readFile(specFile, "utf-8");
+    const savedSpec = await fs24.readFile(specFile, "utf-8");
     if (codegenMode === "api" && generatedFiles.length > 0) {
       reviewResult = await reviewer.reviewFiles(savedSpec, generatedFiles, workingDir, specFile);
     } else {
@@ -10425,6 +10797,65 @@ program.command("create").description("Generate a feature spec and kick off code
     runLogger.stageEnd("review");
     await accumulateReviewKnowledge(specProvider, currentDir, reviewResult);
   }
+  if (reviewResult && !opts.skipReview && !opts.auto && extractedDsl && savedDslFile) {
+    const structuralFindings = extractStructuralFindings(reviewResult);
+    if (structuralFindings.length > 0) {
+      printStructuralFindings(structuralFindings);
+      runLogger.stageStart("review_dsl_feedback", { findingCount: structuralFindings.length, categories: structuralFindings.map((f) => f.category) });
+      const savedSpecContent = await fs24.readFile(specFile, "utf-8");
+      const patchChoice = await select3({
+        message: "These are design issues in the Spec/DSL. How would you like to handle them?",
+        choices: [
+          { name: "\u{1F527}  Amend spec + update DSL (AI fixes the design issues, no regen yet)", value: "amend" },
+          { name: "\u{1F4DD}  Note in \xA79 only (already done \u2014 no DSL change)", value: "note" },
+          { name: "\u23ED   Skip", value: "skip" }
+        ]
+      });
+      if (patchChoice === "amend") {
+        console.log(chalk21.blue("  Amending spec to address structural findings..."));
+        try {
+          const amendedSpec = await specProvider.generate(
+            buildStructuralAmendmentPrompt(savedSpecContent, structuralFindings),
+            "You are a Senior Tech Lead doing a targeted spec correction. Output only the complete revised Markdown spec."
+          );
+          await runSnapshot.snapshotFile(specFile);
+          if (savedDslFile) await runSnapshot.snapshotFile(savedDslFile);
+          await fs24.writeFile(specFile, amendedSpec, "utf-8");
+          console.log(chalk21.green(`  \u2714 Spec updated: ${specFile}`));
+          console.log(chalk21.blue("  Re-extracting DSL from amended spec..."));
+          const isFrontend3 = isFrontendDeps(context.dependencies);
+          const amendExtractor = new DslExtractor(specProvider);
+          const amendedDsl = await amendExtractor.extract(amendedSpec, { auto: true, isFrontend: isFrontend3 });
+          if (amendedDsl) {
+            const dslWriter = new DslExtractor(specProvider);
+            const newDslPath = await dslWriter.saveDsl(amendedDsl, specFile);
+            extractedDsl = amendedDsl;
+            console.log(chalk21.green(`  \u2714 DSL updated: ${newDslPath}`));
+            console.log(chalk21.cyan(
+              `
+  Next step: run ${chalk21.white("ai-spec update --codegen")} to regenerate files affected by the DSL change.`
+            ));
+            runLogger.stageEnd("review_dsl_feedback", {
+              action: "amended",
+              endpoints: amendedDsl.endpoints.length,
+              models: amendedDsl.models.length
+            });
+          } else {
+            console.log(chalk21.yellow("  \u26A0 DSL re-extraction failed \u2014 spec was updated but DSL file unchanged."));
+            runLogger.stageEnd("review_dsl_feedback", { action: "amended_spec_only" });
+          }
+        } catch (err) {
+          console.log(chalk21.yellow(`  \u26A0 Spec amendment failed: ${err.message}`));
+          runLogger.stageEnd("review_dsl_feedback", { action: "amendment_error", error: err.message });
+        }
+      } else {
+        runLogger.stageEnd("review_dsl_feedback", { action: patchChoice });
+        if (patchChoice === "note") {
+          console.log(chalk21.gray("  Structural findings retained in \xA79. DSL unchanged."));
+        }
+      }
+    }
+  }
   runLogger.stageStart("self_eval");
   const selfEvalResult = runSelfEval({
     dsl: extractedDsl,
@@ -10436,19 +10867,19 @@ program.command("create").description("Generate a feature spec and kick off code
   });
   printSelfEval(selfEvalResult);
   runLogger.finish();
-  console.log(chalk19.bold.green("\n\u2714 All done!"));
-  console.log(chalk19.gray(`  Spec        : ${specFile}`));
-  if (savedDslFile) console.log(chalk19.gray(`  DSL         : ${savedDslFile}`));
+  console.log(chalk21.bold.green("\n\u2714 All done!"));
+  console.log(chalk21.gray(`  Spec        : ${specFile}`));
+  if (savedDslFile) console.log(chalk21.gray(`  DSL         : ${savedDslFile}`));
   if (generatedTestFiles.length > 0) {
-    console.log(chalk19.gray(`  Tests       : ${generatedTestFiles.length} skeleton file(s) generated`));
+    console.log(chalk21.gray(`  Tests       : ${generatedTestFiles.length} skeleton file(s) generated`));
   }
-  console.log(chalk19.gray(`  Working dir : ${workingDir}`));
+  console.log(chalk21.gray(`  Working dir : ${workingDir}`));
   if (workingDir !== currentDir) {
-    console.log(chalk19.gray(`  Run \`cd ${workingDir}\` to enter the worktree.`));
+    console.log(chalk21.gray(`  Run \`cd ${workingDir}\` to enter the worktree.`));
   }
   runLogger.printSummary();
   if (runSnapshot.fileCount > 0) {
-    console.log(chalk19.gray(`  To undo changes: ai-spec restore ${runId}`));
+    console.log(chalk21.gray(`  To undo changes: ai-spec restore ${runId}`));
   }
 });
 program.command("review").description("Run AI code review on current git diff against a spec").argument("[specFile]", "Path to spec file (auto-detects latest in specs/ if omitted)").option(
@@ -10465,24 +10896,24 @@ program.command("review").description("Run AI code review on current git diff ag
   const reviewer = new CodeReviewer(provider, currentDir);
   let specContent = "";
   let resolvedSpecFile;
-  if (specFile && await fs23.pathExists(specFile)) {
-    specContent = await fs23.readFile(specFile, "utf-8");
+  if (specFile && await fs24.pathExists(specFile)) {
+    specContent = await fs24.readFile(specFile, "utf-8");
     resolvedSpecFile = specFile;
-    console.log(chalk19.gray(`Using spec: ${specFile}`));
+    console.log(chalk21.gray(`Using spec: ${specFile}`));
   } else {
-    const specsDir = path22.join(currentDir, "specs");
-    if (await fs23.pathExists(specsDir)) {
-      const files = (await fs23.readdir(specsDir)).filter((f) => f.endsWith(".md")).sort().reverse();
+    const specsDir = path23.join(currentDir, "specs");
+    if (await fs24.pathExists(specsDir)) {
+      const files = (await fs24.readdir(specsDir)).filter((f) => f.endsWith(".md")).sort().reverse();
       if (files.length > 0) {
-        const latest = path22.join(specsDir, files[0]);
-        specContent = await fs23.readFile(latest, "utf-8");
+        const latest = path23.join(specsDir, files[0]);
+        specContent = await fs24.readFile(latest, "utf-8");
         resolvedSpecFile = latest;
-        console.log(chalk19.gray(`Auto-detected spec: specs/${files[0]}`));
+        console.log(chalk21.gray(`Auto-detected spec: specs/${files[0]}`));
       }
     }
   }
   if (!specContent) {
-    console.log(chalk19.yellow("No spec file found. Running review without spec context."));
+    console.log(chalk21.yellow("No spec file found. Running review without spec context."));
   }
   await reviewer.reviewCode(specContent, resolvedSpecFile);
   await reviewer.printScoreTrend();
@@ -10509,15 +10940,15 @@ program.command("init").description(`Analyze codebase and generate Project Const
         auto: opts.auto
       });
       if (result.written) {
-        console.log(chalk19.blue("\n  Summary:"));
-        console.log(chalk19.gray(`  Lines : ${result.before.totalLines} \u2192 ${result.after.totalLines} (${result.before.totalLines - result.after.totalLines > 0 ? "-" : "+"}${Math.abs(result.before.totalLines - result.after.totalLines)})`));
-        console.log(chalk19.gray(`  \xA79    : ${result.before.lessonCount} \u2192 ${result.after.lessonCount} lessons remaining`));
+        console.log(chalk21.blue("\n  Summary:"));
+        console.log(chalk21.gray(`  Lines : ${result.before.totalLines} \u2192 ${result.after.totalLines} (${result.before.totalLines - result.after.totalLines > 0 ? "-" : "+"}${Math.abs(result.before.totalLines - result.after.totalLines)})`));
+        console.log(chalk21.gray(`  \xA79    : ${result.before.lessonCount} \u2192 ${result.after.lessonCount} lessons remaining`));
         if (result.backupPath) {
-          console.log(chalk19.gray(`  Backup: ${path22.basename(result.backupPath)}`));
+          console.log(chalk21.gray(`  Backup: ${path23.basename(result.backupPath)}`));
         }
       }
     } catch (err) {
-      console.error(chalk19.red(`  \u2718 Consolidation failed: ${err.message}`));
+      console.error(chalk21.red(`  \u2718 Consolidation failed: ${err.message}`));
       process.exit(1);
     }
     return;
@@ -10525,75 +10956,75 @@ program.command("init").description(`Analyze codebase and generate Project Const
   if (opts.global) {
     const existing = await loadGlobalConstitution([currentDir]);
     if (existing && !opts.force) {
-      console.log(chalk19.yellow(`
+      console.log(chalk21.yellow(`
   Global constitution already exists at: ${existing.source}`));
-      console.log(chalk19.gray("  Use --force to overwrite it."));
+      console.log(chalk21.gray("  Use --force to overwrite it."));
       return;
     }
-    console.log(chalk19.blue("\n\u2500\u2500\u2500 Generating Global Constitution \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-    console.log(chalk19.gray(`  Provider: ${providerName}/${modelName}`));
-    console.log(chalk19.gray("  Scanning repos in workspace..."));
+    console.log(chalk21.blue("\n\u2500\u2500\u2500 Generating Global Constitution \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk21.gray(`  Provider: ${providerName}/${modelName}`));
+    console.log(chalk21.gray("  Scanning repos in workspace..."));
     const loader = new ContextLoader(currentDir);
     const ctx = await loader.loadProjectContext();
     const summary = [
       `Tech stack: ${ctx.techStack.join(", ") || "unknown"}`,
       `Dependencies: ${ctx.dependencies.slice(0, 20).join(", ")}`
     ].join("\n");
-    const prompt = buildGlobalConstitutionPrompt([{ name: path22.basename(currentDir), summary }]);
+    const prompt = buildGlobalConstitutionPrompt([{ name: path23.basename(currentDir), summary }]);
     let globalConstitution;
     try {
       globalConstitution = await provider.generate(prompt, globalConstitutionSystemPrompt);
     } catch (err) {
-      console.error(chalk19.red("  \u2718 Failed to generate global constitution:"), err);
+      console.error(chalk21.red("  \u2718 Failed to generate global constitution:"), err);
       process.exit(1);
     }
     const saved2 = await saveGlobalConstitution(globalConstitution, currentDir);
-    console.log(chalk19.green(`
+    console.log(chalk21.green(`
   \u2714 Global constitution saved: ${saved2}`));
-    console.log(chalk19.gray("  This will be automatically merged into all project constitutions in this workspace."));
-    console.log(chalk19.gray("  Project-level rules always override global rules.\n"));
-    console.log(chalk19.bold("  Preview:"));
-    console.log(chalk19.gray(globalConstitution.split("\n").slice(0, 12).join("\n")));
+    console.log(chalk21.gray("  This will be automatically merged into all project constitutions in this workspace."));
+    console.log(chalk21.gray("  Project-level rules always override global rules.\n"));
+    console.log(chalk21.bold("  Preview:"));
+    console.log(chalk21.gray(globalConstitution.split("\n").slice(0, 12).join("\n")));
     if (globalConstitution.split("\n").length > 12) {
-      console.log(chalk19.gray(`  ... (${globalConstitution.split("\n").length} lines total)`));
+      console.log(chalk21.gray(`  ... (${globalConstitution.split("\n").length} lines total)`));
     }
     return;
   }
-  const constitutionPath = path22.join(currentDir, CONSTITUTION_FILE);
-  if (!opts.force && await fs23.pathExists(constitutionPath)) {
-    console.log(chalk19.yellow(`
+  const constitutionPath = path23.join(currentDir, CONSTITUTION_FILE);
+  if (!opts.force && await fs24.pathExists(constitutionPath)) {
+    console.log(chalk21.yellow(`
   ${CONSTITUTION_FILE} already exists.`));
-    console.log(chalk19.gray("  Use --force to overwrite it."));
-    console.log(chalk19.gray(`  Or edit it directly: ${constitutionPath}`));
+    console.log(chalk21.gray("  Use --force to overwrite it."));
+    console.log(chalk21.gray(`  Or edit it directly: ${constitutionPath}`));
     return;
   }
-  console.log(chalk19.blue("\n\u2500\u2500\u2500 Generating Project Constitution \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log(chalk19.gray(`  Provider: ${providerName}/${modelName}`));
-  console.log(chalk19.gray("  Analyzing codebase..."));
+  console.log(chalk21.blue("\n\u2500\u2500\u2500 Generating Project Constitution \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk21.gray(`  Provider: ${providerName}/${modelName}`));
+  console.log(chalk21.gray("  Analyzing codebase..."));
   const generator = new ConstitutionGenerator(provider);
   let constitution;
   try {
     constitution = await generator.generate(currentDir);
   } catch (err) {
-    console.error(chalk19.red("  \u2718 Failed to generate constitution:"), err);
+    console.error(chalk21.red("  \u2718 Failed to generate constitution:"), err);
     process.exit(1);
   }
   const saved = await generator.saveConstitution(currentDir, constitution);
-  const globalResult = await loadGlobalConstitution([path22.dirname(currentDir)]);
+  const globalResult = await loadGlobalConstitution([path23.dirname(currentDir)]);
   if (globalResult) {
-    console.log(chalk19.cyan(`
+    console.log(chalk21.cyan(`
   \u2139 Global constitution detected: ${globalResult.source}`));
-    console.log(chalk19.gray("    It will be merged with this project constitution at runtime."));
-    console.log(chalk19.gray("    Project rules take priority over global rules."));
+    console.log(chalk21.gray("    It will be merged with this project constitution at runtime."));
+    console.log(chalk21.gray("    Project rules take priority over global rules."));
   }
-  console.log(chalk19.green(`
+  console.log(chalk21.green(`
   \u2714 Constitution saved: ${saved}`));
-  console.log(chalk19.gray("  This file will be automatically used in all future `ai-spec create` runs."));
-  console.log(chalk19.gray("  Edit it to add custom rules or red lines for your project.\n"));
-  console.log(chalk19.bold("  Preview:"));
-  console.log(chalk19.gray(constitution.split("\n").slice(0, 15).join("\n")));
+  console.log(chalk21.gray("  This file will be automatically used in all future `ai-spec create` runs."));
+  console.log(chalk21.gray("  Edit it to add custom rules or red lines for your project.\n"));
+  console.log(chalk21.bold("  Preview:"));
+  console.log(chalk21.gray(constitution.split("\n").slice(0, 15).join("\n")));
   if (constitution.split("\n").length > 15) {
-    console.log(chalk19.gray(`  ... (${constitution.split("\n").length} lines total)`));
+    console.log(chalk21.gray(`  ... (${constitution.split("\n").length} lines total)`));
   }
 });
 program.command("config").description(`Set default configuration for this project (saved to ${CONFIG_FILE})`).option("--provider <name>", "Default AI provider for spec generation").option("--model <name>", "Default model for spec generation").option(
@@ -10601,44 +11032,44 @@ program.command("config").description(`Set default configuration for this projec
   "Default code generation mode (claude-code|api|plan)"
 ).option("--codegen-provider <name>", "Default provider for code generation").option("--codegen-model <name>", "Default model for code generation").option("--min-spec-score <score>", "Minimum overall spec score (1-10) to pass Approval Gate (0 = disabled)").option("--show", "Print current configuration").option("--reset", "Reset configuration to empty").option("--clear-keys", "Delete all saved API keys from ~/.ai-spec-keys.json").option("--clear-key <provider>", "Delete saved API key for a specific provider").option("--list-keys", "Show which providers have a saved key").action(async (opts) => {
   const currentDir = process.cwd();
-  const configPath = path22.join(currentDir, CONFIG_FILE);
+  const configPath = path23.join(currentDir, CONFIG_FILE);
   if (opts.clearKeys) {
     await clearAllKeys();
-    console.log(chalk19.green(`\u2714 All saved API keys cleared.`));
+    console.log(chalk21.green(`\u2714 All saved API keys cleared.`));
     return;
   }
   if (opts.clearKey) {
     await clearKey(opts.clearKey);
-    console.log(chalk19.green(`\u2714 Saved key for "${opts.clearKey}" removed.`));
+    console.log(chalk21.green(`\u2714 Saved key for "${opts.clearKey}" removed.`));
     return;
   }
   if (opts.listKeys) {
-    const store = await fs23.readJson(KEY_STORE_FILE).catch(() => ({}));
+    const store = await fs24.readJson(KEY_STORE_FILE).catch(() => ({}));
     const providers = Object.keys(store);
     if (providers.length === 0) {
-      console.log(chalk19.gray("No saved API keys."));
+      console.log(chalk21.gray("No saved API keys."));
     } else {
-      console.log(chalk19.bold("Saved API keys:"));
+      console.log(chalk21.bold("Saved API keys:"));
       for (const p of providers) {
         const k2 = store[p];
-        console.log(chalk19.gray(`  ${p}: ${k2.slice(0, 6)}...${k2.slice(-4)}`));
+        console.log(chalk21.gray(`  ${p}: ${k2.slice(0, 6)}...${k2.slice(-4)}`));
       }
-      console.log(chalk19.gray(`
+      console.log(chalk21.gray(`
 File: ${KEY_STORE_FILE}`));
     }
     return;
   }
   if (opts.reset) {
-    await fs23.writeJson(configPath, {}, { spaces: 2 });
-    console.log(chalk19.green(`\u2714 Config reset: ${configPath}`));
+    await fs24.writeJson(configPath, {}, { spaces: 2 });
+    console.log(chalk21.green(`\u2714 Config reset: ${configPath}`));
     return;
   }
   const existing = await loadConfig(currentDir);
   if (opts.show) {
     if (Object.keys(existing).length === 0) {
-      console.log(chalk19.gray("No config file found. Using built-in defaults."));
+      console.log(chalk21.gray("No config file found. Using built-in defaults."));
     } else {
-      console.log(chalk19.bold(`${configPath}:`));
+      console.log(chalk21.bold(`${configPath}:`));
       console.log(JSON.stringify(existing, null, 2));
     }
     return;
@@ -10652,27 +11083,27 @@ File: ${KEY_STORE_FILE}`));
   if (opts.minSpecScore !== void 0) {
     const score = parseInt(opts.minSpecScore, 10);
     if (isNaN(score) || score < 0 || score > 10) {
-      console.error(chalk19.red("  --min-spec-score must be a number between 0 and 10"));
+      console.error(chalk21.red("  --min-spec-score must be a number between 0 and 10"));
       process.exit(1);
     }
     updated.minSpecScore = score;
   }
-  await fs23.writeJson(configPath, updated, { spaces: 2 });
-  console.log(chalk19.green(`\u2714 Config saved to ${configPath}`));
+  await fs24.writeJson(configPath, updated, { spaces: 2 });
+  console.log(chalk21.green(`\u2714 Config saved to ${configPath}`));
   console.log(JSON.stringify(updated, null, 2));
 });
 program.command("model").description("Interactively switch the active AI provider/model and save to .ai-spec.json").option("--list", "List all available providers and models").action(async (opts) => {
   const currentDir = process.cwd();
-  const configPath = path22.join(currentDir, CONFIG_FILE);
+  const configPath = path23.join(currentDir, CONFIG_FILE);
   if (opts.list) {
-    console.log(chalk19.bold("\nAvailable providers & models:\n"));
+    console.log(chalk21.bold("\nAvailable providers & models:\n"));
     for (const [key, meta] of Object.entries(PROVIDER_CATALOG)) {
       console.log(
-        `  ${chalk19.bold.cyan(key.padEnd(10))} ${chalk19.white(meta.displayName)}`
+        `  ${chalk21.bold.cyan(key.padEnd(10))} ${chalk21.white(meta.displayName)}`
       );
-      console.log(chalk19.gray(`             ${meta.description}`));
+      console.log(chalk21.gray(`             ${meta.description}`));
       console.log(
-        chalk19.gray(
+        chalk21.gray(
           `             env: ${meta.envKey}  |  models: ${meta.models.join(", ")}`
         )
       );
@@ -10681,10 +11112,10 @@ program.command("model").description("Interactively switch the active AI provide
     return;
   }
   const existing = await loadConfig(currentDir);
-  console.log(chalk19.blue("\n\u2500\u2500\u2500 Model Switcher \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk21.blue("\n\u2500\u2500\u2500 Model Switcher \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   if (Object.keys(existing).length > 0) {
     console.log(
-      chalk19.gray(
+      chalk21.gray(
         `  Current: spec=${existing.provider ?? "gemini"}/${existing.model ?? DEFAULT_MODELS[existing.provider ?? "gemini"]}` + (existing.codegenProvider ? `  codegen=${existing.codegenProvider}/${existing.codegenModel ?? ""}` : "")
       )
     );
@@ -10702,7 +11133,7 @@ program.command("model").description("Interactively switch the active AI provide
     const providerKey = await select3({
       message: `${label} \u2014 select provider:`,
       choices: Object.entries(PROVIDER_CATALOG).map(([key, meta2]) => ({
-        name: `${meta2.displayName.padEnd(22)} ${chalk19.gray(meta2.description)}`,
+        name: `${meta2.displayName.padEnd(22)} ${chalk21.gray(meta2.description)}`,
         value: key,
         short: meta2.displayName
       }))
@@ -10710,7 +11141,7 @@ program.command("model").description("Interactively switch the active AI provide
     const meta = PROVIDER_CATALOG[providerKey];
     const modelChoices = [
       ...meta.models.map((m) => ({ name: m, value: m })),
-      { name: chalk19.italic("\u270E  Enter custom model name..."), value: "__custom__" }
+      { name: chalk21.italic("\u270E  Enter custom model name..."), value: "__custom__" }
     ];
     let chosenModel = await select3({
       message: `${label} \u2014 select model (${meta.displayName}):`,
@@ -10744,37 +11175,37 @@ program.command("model").description("Interactively switch the active AI provide
       if (!updated.codegen || updated.codegen === "claude-code") {
         updated.codegen = "api";
         console.log(
-          chalk19.yellow(
+          chalk21.yellow(
             `
   \u26A0  provider "${effectiveCodegenProvider}" \u4E0D\u652F\u6301 "claude-code" \u6A21\u5F0F\u3002`
           )
         );
-        console.log(chalk19.gray(`  \u5DF2\u81EA\u52A8\u5C06 codegen \u6A21\u5F0F\u8BBE\u4E3A "api"\u3002`));
+        console.log(chalk21.gray(`  \u5DF2\u81EA\u52A8\u5C06 codegen \u6A21\u5F0F\u8BBE\u4E3A "api"\u3002`));
       }
     }
   }
-  console.log(chalk19.blue("\n  Preview:"));
-  console.log(chalk19.gray(`    spec    \u2192 ${updated.provider}/${updated.model}`));
+  console.log(chalk21.blue("\n  Preview:"));
+  console.log(chalk21.gray(`    spec    \u2192 ${updated.provider}/${updated.model}`));
   if (updated.codegenProvider) {
     console.log(
-      chalk19.gray(
+      chalk21.gray(
         `    codegen \u2192 ${updated.codegenProvider}/${updated.codegenModel}  (mode: ${updated.codegen ?? "claude-code"})`
       )
     );
   }
   const ok = await confirm2({ message: "Save to .ai-spec.json?", default: true });
   if (!ok) {
-    console.log(chalk19.gray("  Cancelled."));
+    console.log(chalk21.gray("  Cancelled."));
     return;
   }
-  await fs23.writeJson(configPath, updated, { spaces: 2 });
-  console.log(chalk19.green(`
+  await fs24.writeJson(configPath, updated, { spaces: 2 });
+  console.log(chalk21.green(`
   \u2714 Saved to ${configPath}`));
   const providerToCheck = updated.provider ?? "gemini";
   const envKey = ENV_KEY_MAP[providerToCheck];
   if (envKey && !process.env[envKey]) {
     console.log(
-      chalk19.yellow(
+      chalk21.yellow(
         `  \u26A0  Remember to set ${envKey} in your environment or .env file.`
       )
     );
@@ -10793,29 +11224,29 @@ async function runSingleRepoPipelineInWorkspace(opts) {
     cliOpts,
     contractContextSection
   } = opts;
-  console.log(chalk19.blue(`
+  console.log(chalk21.blue(`
   [${repoName}] Loading project context...`));
   const loader = new ContextLoader(repoAbsPath);
   let context = await loader.loadProjectContext();
   const { type: detectedRepoType } = await detectRepoType(repoAbsPath);
-  console.log(chalk19.gray(`    Tech stack: ${context.techStack.join(", ") || "unknown"} [${detectedRepoType}]`));
-  console.log(chalk19.gray(`    Dependencies: ${context.dependencies.length} packages`));
+  console.log(chalk21.gray(`    Tech stack: ${context.techStack.join(", ") || "unknown"} [${detectedRepoType}]`));
+  console.log(chalk21.gray(`    Dependencies: ${context.dependencies.length} packages`));
   if (context.constitution && context.constitution.length > 6e3) {
-    console.log(chalk19.yellow(`    \u26A0 Constitution is long (${context.constitution.length.toLocaleString()} chars). Consider running: ai-spec init --consolidate`));
+    console.log(chalk21.yellow(`    \u26A0 Constitution is long (${context.constitution.length.toLocaleString()} chars). Consider running: ai-spec init --consolidate`));
   }
   if (!context.constitution) {
-    console.log(chalk19.yellow(`    Constitution: not found \u2014 auto-generating...`));
+    console.log(chalk21.yellow(`    Constitution: not found \u2014 auto-generating...`));
     try {
       const constitutionGen = new ConstitutionGenerator(specProvider);
       const constitutionContent = await constitutionGen.generate(repoAbsPath);
       await constitutionGen.saveConstitution(repoAbsPath, constitutionContent);
       context.constitution = constitutionContent;
-      console.log(chalk19.green(`    Constitution: generated`));
+      console.log(chalk21.green(`    Constitution: generated`));
     } catch (err) {
-      console.log(chalk19.yellow(`    Constitution: auto-generation failed (${err.message}), continuing.`));
+      console.log(chalk21.yellow(`    Constitution: auto-generation failed (${err.message}), continuing.`));
     }
   } else {
-    console.log(chalk19.green(`    Constitution: found`));
+    console.log(chalk21.green(`    Constitution: found`));
   }
   let fullIdea = idea;
   if (contractContextSection) {
@@ -10823,58 +11254,58 @@ async function runSingleRepoPipelineInWorkspace(opts) {
 
 ${contractContextSection}`;
   }
-  console.log(chalk19.blue(`  [${repoName}] Generating spec...`));
+  console.log(chalk21.blue(`  [${repoName}] Generating spec...`));
   let finalSpec;
   try {
     const result = await generateSpecWithTasks(specProvider, fullIdea, context);
     finalSpec = result.spec;
-    console.log(chalk19.green(`    Spec generated.`));
+    console.log(chalk21.green(`    Spec generated.`));
   } catch (err) {
-    console.error(chalk19.red(`    Spec generation failed: ${err.message}`));
+    console.error(chalk21.red(`    Spec generation failed: ${err.message}`));
     return { dsl: null, specFile: null };
   }
   let extractedDsl = null;
   if (!cliOpts.skipDsl) {
-    console.log(chalk19.blue(`  [${repoName}] Extracting DSL...`));
+    console.log(chalk21.blue(`  [${repoName}] Extracting DSL...`));
     try {
       const dslExtractor = new DslExtractor(specProvider);
       const repoIsFrontend = isFrontendDeps(context.dependencies);
       extractedDsl = await dslExtractor.extract(finalSpec, { auto: true, isFrontend: repoIsFrontend });
       if (extractedDsl) {
-        console.log(chalk19.green(`    DSL extracted.`));
+        console.log(chalk21.green(`    DSL extracted.`));
       }
     } catch (err) {
-      console.log(chalk19.yellow(`    DSL extraction failed: ${err.message}`));
+      console.log(chalk21.yellow(`    DSL extraction failed: ${err.message}`));
     }
   }
   const isFrontendRepo = isFrontendDeps(context.dependencies ?? []);
   const skipWorktreeForRepo = cliOpts.worktree ? false : cliOpts.skipWorktree || isFrontendRepo;
   let workingDir = repoAbsPath;
   if (!skipWorktreeForRepo) {
-    console.log(chalk19.blue(`  [${repoName}] Setting up git worktree...`));
+    console.log(chalk21.blue(`  [${repoName}] Setting up git worktree...`));
     try {
       const worktreeManager = new GitWorktreeManager(repoAbsPath);
       const worktreePath = await worktreeManager.createWorktree(idea);
       if (worktreePath) workingDir = worktreePath;
     } catch (err) {
-      console.log(chalk19.yellow(`    Worktree setup failed: ${err.message}. Using main branch.`));
+      console.log(chalk21.yellow(`    Worktree setup failed: ${err.message}. Using main branch.`));
     }
   } else {
-    console.log(chalk19.gray(`  [${repoName}] Skipping worktree${isFrontendRepo ? " (frontend repo)" : ""}.`));
+    console.log(chalk21.gray(`  [${repoName}] Skipping worktree${isFrontendRepo ? " (frontend repo)" : ""}.`));
   }
-  const specsDir = path22.join(workingDir, "specs");
-  await fs23.ensureDir(specsDir);
+  const specsDir = path23.join(workingDir, "specs");
+  await fs24.ensureDir(specsDir);
   const featureSlug = slugify(idea);
   const { filePath: specFile } = await nextVersionPath(specsDir, featureSlug);
-  await fs23.writeFile(specFile, finalSpec, "utf-8");
-  console.log(chalk19.green(`    Spec saved: ${path22.relative(repoAbsPath, specFile)}`));
+  await fs24.writeFile(specFile, finalSpec, "utf-8");
+  console.log(chalk21.green(`    Spec saved: ${path23.relative(repoAbsPath, specFile)}`));
   let savedDslFile = null;
   if (extractedDsl) {
     const dslExtractorForSave = new DslExtractor(specProvider);
     savedDslFile = await dslExtractorForSave.saveDsl(extractedDsl, specFile);
-    console.log(chalk19.green(`    DSL saved: ${path22.relative(repoAbsPath, savedDslFile)}`));
+    console.log(chalk21.green(`    DSL saved: ${path23.relative(repoAbsPath, savedDslFile)}`));
   }
-  console.log(chalk19.blue(`  [${repoName}] Running code generation (mode: ${codegenMode})...`));
+  console.log(chalk21.blue(`  [${repoName}] Running code generation (mode: ${codegenMode})...`));
   try {
     const codegen = new CodeGenerator(codegenProvider, codegenMode);
     await codegen.generateCode(specFile, workingDir, context, {
@@ -10882,29 +11313,29 @@ ${contractContextSection}`;
       dslFilePath: savedDslFile ?? void 0,
       repoType: detectedRepoType
     });
-    console.log(chalk19.green(`    Code generation complete.`));
+    console.log(chalk21.green(`    Code generation complete.`));
   } catch (err) {
-    console.log(chalk19.yellow(`    Code generation failed: ${err.message}`));
+    console.log(chalk21.yellow(`    Code generation failed: ${err.message}`));
   }
   if (!cliOpts.skipTests && extractedDsl) {
-    console.log(chalk19.blue(`  [${repoName}] Generating test skeletons...`));
+    console.log(chalk21.blue(`  [${repoName}] Generating test skeletons...`));
     try {
       const testGen = new TestGenerator(codegenProvider);
       const testFiles = await testGen.generate(extractedDsl, workingDir);
-      console.log(chalk19.green(`    ${testFiles.length} test file(s) generated.`));
+      console.log(chalk21.green(`    ${testFiles.length} test file(s) generated.`));
     } catch (err) {
-      console.log(chalk19.yellow(`    Test generation failed: ${err.message}`));
+      console.log(chalk21.yellow(`    Test generation failed: ${err.message}`));
     }
   }
   if (!cliOpts.skipErrorFeedback) {
     try {
       await runErrorFeedback(codegenProvider, workingDir, extractedDsl, { maxCycles: 1 });
     } catch (err) {
-      console.log(chalk19.yellow(`    Error feedback failed: ${err.message}`));
+      console.log(chalk21.yellow(`    Error feedback failed: ${err.message}`));
     }
   }
   if (!cliOpts.skipReview) {
-    console.log(chalk19.blue(`  [${repoName}] Running code review...`));
+    console.log(chalk21.blue(`  [${repoName}] Running code review...`));
     try {
       const reviewer = new CodeReviewer(specProvider);
       const originalDir = process.cwd();
@@ -10916,9 +11347,9 @@ ${contractContextSection}`;
         process.chdir(originalDir);
       }
       await accumulateReviewKnowledge(specProvider, repoAbsPath, reviewResult);
-      console.log(chalk19.green(`    Code review complete.`));
+      console.log(chalk21.green(`    Code review complete.`));
     } catch (err) {
-      console.log(chalk19.yellow(`    Code review failed: ${err.message}`));
+      console.log(chalk21.yellow(`    Code review failed: ${err.message}`));
     }
   }
   return { dsl: extractedDsl, specFile };
@@ -10941,7 +11372,7 @@ async function runMultiRepoPipeline(idea, workspace, opts, currentDir, config2)
     codegenModel: codegenModelName
   });
   const workspaceLoader = new WorkspaceLoader(currentDir);
-  console.log(chalk19.blue("\n[W1] Loading per-repo contexts..."));
+  console.log(chalk21.blue("\n[W1] Loading per-repo contexts..."));
   const contexts = /* @__PURE__ */ new Map();
   const frontendContexts = /* @__PURE__ */ new Map();
   for (const repo of workspace.repos) {
@@ -10953,27 +11384,27 @@ async function runMultiRepoPipeline(idea, workspace, opts, currentDir, config2)
       if (repo.role === "frontend" || repo.role === "mobile") {
         const fctx = await loadFrontendContext(repoAbsPath);
         frontendContexts.set(repo.name, fctx);
-        console.log(chalk19.gray(`  ${repo.name}: ${fctx.framework} / ${fctx.httpClient} / hooks:${fctx.hookFiles.length} stores:${fctx.storeFiles.length}`));
+        console.log(chalk21.gray(`  ${repo.name}: ${fctx.framework} / ${fctx.httpClient} / hooks:${fctx.hookFiles.length} stores:${fctx.storeFiles.length}`));
       } else {
-        console.log(chalk19.gray(`  ${repo.name}: ${ctx.techStack.join(", ") || "unknown"} (${ctx.dependencies.length} deps)`));
+        console.log(chalk21.gray(`  ${repo.name}: ${ctx.techStack.join(", ") || "unknown"} (${ctx.dependencies.length} deps)`));
       }
     } catch (err) {
-      console.log(chalk19.yellow(`  ${repo.name}: context load failed \u2014 ${err.message}`));
+      console.log(chalk21.yellow(`  ${repo.name}: context load failed \u2014 ${err.message}`));
     }
   }
-  console.log(chalk19.blue("\n[W2] Decomposing requirement across repos..."));
+  console.log(chalk21.blue("\n[W2] Decomposing requirement across repos..."));
   const decomposer = new RequirementDecomposer(specProvider);
   let decomposition;
   try {
     decomposition = await decomposer.decompose(idea, workspace, contexts, frontendContexts);
-    console.log(chalk19.green(`  Summary: ${decomposition.summary}`));
-    console.log(chalk19.gray(`  Repos affected: ${decomposition.repos.map((r) => r.repoName).join(", ")}`));
+    console.log(chalk21.green(`  Summary: ${decomposition.summary}`));
+    console.log(chalk21.gray(`  Repos affected: ${decomposition.repos.map((r) => r.repoName).join(", ")}`));
     if (decomposition.coordinationNotes) {
-      console.log(chalk19.gray(`  Coordination: ${decomposition.coordinationNotes}`));
+      console.log(chalk21.gray(`  Coordination: ${decomposition.coordinationNotes}`));
     }
   } catch (err) {
-    console.error(chalk19.red(`  Decomposition failed: ${err.message}`));
-    console.log(chalk19.yellow("  Falling back to running all repos independently."));
+    console.error(chalk21.red(`  Decomposition failed: ${err.message}`));
+    console.log(chalk21.yellow("  Falling back to running all repos independently."));
     decomposition = {
       originalRequirement: idea,
       summary: idea,
@@ -10989,11 +11420,11 @@ async function runMultiRepoPipeline(idea, workspace, opts, currentDir, config2)
     };
   }
   if (!opts.auto) {
-    console.log(chalk19.cyan("\n[W3] Decomposition Preview:"));
-    console.log(chalk19.cyan("\u2500".repeat(52)));
+    console.log(chalk21.cyan("\n[W3] Decomposition Preview:"));
+    console.log(chalk21.cyan("\u2500".repeat(52)));
     for (const r of decomposition.repos) {
-      console.log(chalk19.bold(`  ${r.repoName} (${r.role})`));
-      console.log(chalk19.gray(`    ${r.specIdea.slice(0, 150)}${r.specIdea.length > 150 ? "..." : ""}`));
+      console.log(chalk21.bold(`  ${r.repoName} (${r.role})`));
+      console.log(chalk21.gray(`    ${r.specIdea.slice(0, 150)}${r.specIdea.length > 150 ? "..." : ""}`));
       if (r.uxDecisions) {
         const ux = r.uxDecisions;
         const uxSummary = [
@@ -11002,13 +11433,13 @@ async function runMultiRepoPipeline(idea, workspace, opts, currentDir, config2)
           ux.optimisticUpdate ? "optimistic-update" : "",
           ux.errorRollback ? "rollback" : ""
         ].filter(Boolean).join(", ");
-        if (uxSummary) console.log(chalk19.cyan(`    UX: ${uxSummary}`));
+        if (uxSummary) console.log(chalk21.cyan(`    UX: ${uxSummary}`));
       }
       if (r.dependsOnRepos.length > 0) {
-        console.log(chalk19.gray(`    Depends on: ${r.dependsOnRepos.join(", ")}`));
+        console.log(chalk21.gray(`    Depends on: ${r.dependsOnRepos.join(", ")}`));
       }
     }
-    console.log(chalk19.cyan("\u2500".repeat(52)));
+    console.log(chalk21.cyan("\u2500".repeat(52)));
     const gate = await select3({
       message: "Proceed with multi-repo pipeline?",
       choices: [
@@ -11017,24 +11448,24 @@ async function runMultiRepoPipeline(idea, workspace, opts, currentDir, config2)
       ]
     });
     if (gate === "abort") {
-      console.log(chalk19.yellow("  Aborted."));
+      console.log(chalk21.yellow("  Aborted."));
       process.exit(0);
     }
   }
   const sortedRepoRequirements = RequirementDecomposer.sortByDependency(decomposition.repos);
   const contractDsls = /* @__PURE__ */ new Map();
-  console.log(chalk19.blue(`
+  console.log(chalk21.blue(`
 [W4] Running pipeline for ${sortedRepoRequirements.length} repo(s)...`));
   const results = [];
   for (const repoReq of sortedRepoRequirements) {
     const repoConfig = workspace.repos.find((r) => r.name === repoReq.repoName);
     if (!repoConfig) {
-      console.log(chalk19.yellow(`  Skipping ${repoReq.repoName} \u2014 not found in workspace config.`));
+      console.log(chalk21.yellow(`  Skipping ${repoReq.repoName} \u2014 not found in workspace config.`));
       results.push({ repoName: repoReq.repoName, status: "skipped", specFile: null, dsl: null, repoAbsPath: "", role: repoReq.role });
       continue;
     }
     const repoAbsPath = workspaceLoader.resolveAbsPath(repoConfig);
-    console.log(chalk19.bold.blue(`
+    console.log(chalk21.bold.blue(`
   \u2500\u2500 ${repoReq.repoName} (${repoReq.role}) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`));
     let contractContextSection;
     if (repoReq.dependsOnRepos.length > 0) {
@@ -11042,7 +11473,7 @@ async function runMultiRepoPipeline(idea, workspace, opts, currentDir, config2)
       for (const depName of repoReq.dependsOnRepos) {
         const depDsl = contractDsls.get(depName);
         if (depDsl) {
-          console.log(chalk19.gray(`    Using API contract from: ${depName}`));
+          console.log(chalk21.gray(`    Using API contract from: ${depName}`));
           const contract = buildFrontendApiContract(depDsl);
           contractParts.push(buildContractContextSection(contract));
         }
@@ -11062,7 +11493,7 @@ async function runMultiRepoPipeline(idea, workspace, opts, currentDir, config2)
         frontendContext: frontendCtx
       });
       contractContextSection = void 0;
-      console.log(chalk19.gray(`    Frontend context: ${frontendCtx.framework} / ${frontendCtx.httpClient} / ${frontendCtx.uiLibrary}`));
+      console.log(chalk21.gray(`    Frontend context: ${frontendCtx.framework} / ${frontendCtx.httpClient} / ${frontendCtx.uiLibrary}`));
     }
     try {
       const { dsl, specFile } = await runSingleRepoPipelineInWorkspace({
@@ -11079,22 +11510,22 @@ async function runMultiRepoPipeline(idea, workspace, opts, currentDir, config2)
       });
       if (repoReq.isContractProvider && dsl) {
         contractDsls.set(repoReq.repoName, dsl);
-        console.log(chalk19.green(`    Contract stored for downstream repos.`));
+        console.log(chalk21.green(`    Contract stored for downstream repos.`));
       }
       results.push({ repoName: repoReq.repoName, status: "success", specFile, dsl, repoAbsPath, role: repoReq.role });
-      console.log(chalk19.green(`  \u2714 ${repoReq.repoName} complete`));
+      console.log(chalk21.green(`  \u2714 ${repoReq.repoName} complete`));
     } catch (err) {
-      console.error(chalk19.red(`  \u2718 ${repoReq.repoName} failed: ${err.message}`));
+      console.error(chalk21.red(`  \u2718 ${repoReq.repoName} failed: ${err.message}`));
       results.push({ repoName: repoReq.repoName, status: "failed", specFile: null, dsl: null, repoAbsPath, role: repoReq.role });
     }
   }
-  console.log(chalk19.bold.green("\n\u2714 Multi-repo pipeline complete!"));
-  console.log(chalk19.gray(`  Workspace: ${workspace.name}`));
-  console.log(chalk19.gray(`  Requirement: ${idea}`));
+  console.log(chalk21.bold.green("\n\u2714 Multi-repo pipeline complete!"));
+  console.log(chalk21.gray(`  Workspace: ${workspace.name}`));
+  console.log(chalk21.gray(`  Requirement: ${idea}`));
   console.log();
   for (const r of results) {
-    const icon = r.status === "success" ? chalk19.green("\u2714") : r.status === "failed" ? chalk19.red("\u2718") : chalk19.gray("\u2212");
-    const specInfo = r.specFile ? chalk19.gray(` \u2192 ${r.specFile}`) : "";
+    const icon = r.status === "success" ? chalk21.green("\u2714") : r.status === "failed" ? chalk21.red("\u2718") : chalk21.gray("\u2212");
+    const specInfo = r.specFile ? chalk21.gray(` \u2192 ${r.specFile}`) : "";
     console.log(`  ${icon} ${r.repoName} (${r.status})${specInfo}`);
   }
   return results;
@@ -11102,18 +11533,18 @@ async function runMultiRepoPipeline(idea, workspace, opts, currentDir, config2)
 var workspaceCmd = program.command("workspace").description("Manage multi-repo workspace configuration");
 workspaceCmd.command("init").description(`Interactive workspace setup \u2014 creates ${WORKSPACE_CONFIG_FILE}`).action(async () => {
   const currentDir = process.cwd();
-  const configPath = path22.join(currentDir, WORKSPACE_CONFIG_FILE);
-  if (await fs23.pathExists(configPath)) {
+  const configPath = path23.join(currentDir, WORKSPACE_CONFIG_FILE);
+  if (await fs24.pathExists(configPath)) {
     const overwrite = await confirm2({
       message: `${WORKSPACE_CONFIG_FILE} already exists. Overwrite?`,
       default: false
     });
     if (!overwrite) {
-      console.log(chalk19.gray("  Cancelled."));
+      console.log(chalk21.gray("  Cancelled."));
       return;
     }
   }
-  console.log(chalk19.blue("\n\u2500\u2500\u2500 Workspace Setup \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk21.blue("\n\u2500\u2500\u2500 Workspace Setup \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   const workspaceName = await input({
     message: "Workspace name:",
     validate: (v2) => v2.trim().length > 0 || "Name cannot be empty"
@@ -11127,11 +11558,11 @@ workspaceCmd.command("init").description(`Interactive workspace setup \u2014 cre
     const workspaceLoader = new WorkspaceLoader(currentDir);
     const detected = await workspaceLoader.autoDetect();
     if (detected.length === 0) {
-      console.log(chalk19.yellow("  No recognizable repos found in sibling directories."));
+      console.log(chalk21.yellow("  No recognizable repos found in sibling directories."));
     } else {
-      console.log(chalk19.cyan("\n  Detected repos:"));
+      console.log(chalk21.cyan("\n  Detected repos:"));
       for (const r of detected) {
-        console.log(chalk19.gray(`    - ${r.name}: ${r.role} (${r.type}) at ${r.path}`));
+        console.log(chalk21.gray(`    - ${r.name}: ${r.role} (${r.type}) at ${r.path}`));
       }
       const keepAll = await confirm2({
         message: `Include all ${detected.length} detected repo(s)?`,
@@ -11148,7 +11579,7 @@ workspaceCmd.command("init").description(`Interactive workspace setup \u2014 cre
           if (keep) repos.push(r);
         }
       }
-      console.log(chalk19.green(`  \u2714 ${repos.length} repo(s) added from auto-scan.`));
+      console.log(chalk21.green(`  \u2714 ${repos.length} repo(s) added from auto-scan.`));
     }
   }
   const repoTypeChoices = [
@@ -11170,7 +11601,7 @@ workspaceCmd.command("init").description(`Interactive workspace setup \u2014 cre
     default: repos.length === 0
   });
   while (addMore) {
-    console.log(chalk19.cyan(`
+    console.log(chalk21.cyan(`
   Adding repo #${repos.length + 1}`));
     const repoName = await input({
       message: "Repo name (e.g. api, web, app):",
@@ -11184,16 +11615,16 @@ workspaceCmd.command("init").description(`Interactive workspace setup \u2014 cre
       message: `Relative path to "${repoName}" from here (default: ./${repoName}):`,
       default: `./${repoName}`
     });
-    const absPath = path22.resolve(currentDir, repoPath);
+    const absPath = path23.resolve(currentDir, repoPath);
     let detectedType = "unknown";
     let detectedRole = "shared";
-    if (await fs23.pathExists(absPath)) {
+    if (await fs24.pathExists(absPath)) {
       const { type, role } = await detectRepoType(absPath);
       detectedType = type;
       detectedRole = role;
-      console.log(chalk19.gray(`    Auto-detected: type=${type}, role=${role}`));
+      console.log(chalk21.gray(`    Auto-detected: type=${type}, role=${role}`));
     } else {
-      console.log(chalk19.yellow(`    Path "${absPath}" not found \u2014 type/role will be manual.`));
+      console.log(chalk21.yellow(`    Path "${absPath}" not found \u2014 type/role will be manual.`));
     }
     const repoType = await select3({
       message: `Repo type for "${repoName}":`,
@@ -11216,53 +11647,53 @@ workspaceCmd.command("init").description(`Interactive workspace setup \u2014 cre
       type: repoType,
       role: repoRole
     });
-    console.log(chalk19.green(`  \u2714 Added: ${repoName} (${repoRole}, ${repoType})`));
+    console.log(chalk21.green(`  \u2714 Added: ${repoName} (${repoRole}, ${repoType})`));
     addMore = await confirm2({
       message: "Add another repo?",
       default: false
     });
   }
   const workspaceConfig = { name: workspaceName, repos };
-  console.log(chalk19.cyan("\n  Workspace summary:"));
-  console.log(chalk19.gray(`  Name: ${workspaceName}`));
+  console.log(chalk21.cyan("\n  Workspace summary:"));
+  console.log(chalk21.gray(`  Name: ${workspaceName}`));
   for (const r of repos) {
-    console.log(chalk19.gray(`  - ${r.name}: ${r.role} (${r.type}) at ${r.path}`));
+    console.log(chalk21.gray(`  - ${r.name}: ${r.role} (${r.type}) at ${r.path}`));
   }
   const ok = await confirm2({ message: `Save to ${WORKSPACE_CONFIG_FILE}?`, default: true });
   if (!ok) {
-    console.log(chalk19.gray("  Cancelled."));
+    console.log(chalk21.gray("  Cancelled."));
     return;
   }
   const loader = new WorkspaceLoader(currentDir);
   const saved = await loader.save(workspaceConfig);
-  console.log(chalk19.green(`
+  console.log(chalk21.green(`
   \u2714 Workspace saved: ${saved}`));
-  console.log(chalk19.gray(`  Run \`ai-spec create "your feature"\` \u2014 workspace mode will activate automatically.`));
+  console.log(chalk21.gray(`  Run \`ai-spec create "your feature"\` \u2014 workspace mode will activate automatically.`));
 });
 workspaceCmd.command("status").description("Show current workspace configuration").action(async () => {
   const currentDir = process.cwd();
   const loader = new WorkspaceLoader(currentDir);
   const config2 = await loader.load();
   if (!config2) {
-    console.log(chalk19.yellow(`No ${WORKSPACE_CONFIG_FILE} found in ${currentDir}`));
-    console.log(chalk19.gray("  Run `ai-spec workspace init` to create one."));
+    console.log(chalk21.yellow(`No ${WORKSPACE_CONFIG_FILE} found in ${currentDir}`));
+    console.log(chalk21.gray("  Run `ai-spec workspace init` to create one."));
     return;
   }
-  console.log(chalk19.bold(`
+  console.log(chalk21.bold(`
 Workspace: ${config2.name}`));
-  console.log(chalk19.gray(`  Config: ${path22.join(currentDir, WORKSPACE_CONFIG_FILE)}`));
-  console.log(chalk19.gray(`  Repos (${config2.repos.length}):
+  console.log(chalk21.gray(`  Config: ${path23.join(currentDir, WORKSPACE_CONFIG_FILE)}`));
+  console.log(chalk21.gray(`  Repos (${config2.repos.length}):
 `));
   for (const repo of config2.repos) {
     const absPath = loader.resolveAbsPath(repo);
-    const exists = await fs23.pathExists(absPath);
-    const status = exists ? chalk19.green("found") : chalk19.red("not found");
+    const exists = await fs24.pathExists(absPath);
+    const status = exists ? chalk21.green("found") : chalk21.red("not found");
     console.log(
-      `  ${chalk19.bold(repo.name.padEnd(12))} ${repo.role.padEnd(10)} ${repo.type.padEnd(16)} ${status}`
+      `  ${chalk21.bold(repo.name.padEnd(12))} ${repo.role.padEnd(10)} ${repo.type.padEnd(16)} ${status}`
     );
-    console.log(chalk19.gray(`    path: ${absPath}`));
+    console.log(chalk21.gray(`    path: ${absPath}`));
     if (repo.constitution) {
-      console.log(chalk19.green(`    constitution: found`));
+      console.log(chalk21.green(`    constitution: found`));
     }
   }
 });
@@ -11279,30 +11710,30 @@ program.command("update").description("Update an existing spec with a change req
   const modelName = opts.model || config2.model || DEFAULT_MODELS[providerName];
   const apiKey = await resolveApiKey(providerName, opts.key);
   const provider = createProvider(providerName, apiKey, modelName);
-  console.log(chalk19.blue("\n\u2500\u2500\u2500 ai-spec update \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log(chalk19.gray(`  Provider: ${providerName}/${modelName}`));
+  console.log(chalk21.blue("\n\u2500\u2500\u2500 ai-spec update \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk21.gray(`  Provider: ${providerName}/${modelName}`));
   const updateRunId = generateRunId();
   const updateSnapshot = new RunSnapshot(currentDir, updateRunId);
   setActiveSnapshot(updateSnapshot);
   const updateLogger = new RunLogger(currentDir, updateRunId, { provider: providerName, model: modelName });
   setActiveLogger(updateLogger);
-  console.log(chalk19.gray(`  Run ID: ${updateRunId}`));
+  console.log(chalk21.gray(`  Run ID: ${updateRunId}`));
   let specPath = opts.spec ?? null;
   if (!specPath) {
-    const specsDir = path22.join(currentDir, "specs");
+    const specsDir = path23.join(currentDir, "specs");
     const latest = await SpecUpdater.findLatestSpec(specsDir);
     if (!latest) {
-      console.error(chalk19.red("  No spec files found in specs/. Run `ai-spec create` first or use --spec <path>."));
+      console.error(chalk21.red("  No spec files found in specs/. Run `ai-spec create` first or use --spec <path>."));
       process.exit(1);
     }
     specPath = latest.filePath;
-    console.log(chalk19.gray(`  Using spec: ${path22.relative(currentDir, specPath)} (v${latest.version})`));
+    console.log(chalk21.gray(`  Using spec: ${path23.relative(currentDir, specPath)} (v${latest.version})`));
   }
-  console.log(chalk19.gray("  Loading project context..."));
+  console.log(chalk21.gray("  Loading project context..."));
   const loader = new ContextLoader(currentDir);
   const context = await loader.loadProjectContext();
   if (context.constitution && context.constitution.length > 6e3) {
-    console.log(chalk19.yellow(`  \u26A0 Constitution is long (${context.constitution.length.toLocaleString()} chars). Consider running: ai-spec init --consolidate`));
+    console.log(chalk21.yellow(`  \u26A0 Constitution is long (${context.constitution.length.toLocaleString()} chars). Consider running: ai-spec init --consolidate`));
   }
   const { detectRepoType: _detectRepoType } = await Promise.resolve().then(() => (init_workspace_loader(), workspace_loader_exports));
   const { type: repoType } = await _detectRepoType(currentDir);
@@ -11314,19 +11745,19 @@ program.command("update").description("Update an existing spec with a change req
       repoType
     });
   } catch (err) {
-    console.error(chalk19.red(`  Update failed: ${err.message}`));
+    console.error(chalk21.red(`  Update failed: ${err.message}`));
     process.exit(1);
   }
-  console.log(chalk19.green(`
-  \u2714 Spec updated \u2192 v${result.newVersion}: ${path22.relative(currentDir, result.newSpecPath)}`));
+  console.log(chalk21.green(`
+  \u2714 Spec updated \u2192 v${result.newVersion}: ${path23.relative(currentDir, result.newSpecPath)}`));
   if (result.newDslPath) {
-    console.log(chalk19.green(`  \u2714 DSL updated: ${path22.relative(currentDir, result.newDslPath)}`));
+    console.log(chalk21.green(`  \u2714 DSL updated: ${path23.relative(currentDir, result.newDslPath)}`));
   }
   if (result.affectedFiles.length > 0) {
-    console.log(chalk19.cyan("\n  Affected files:"));
+    console.log(chalk21.cyan("\n  Affected files:"));
     for (const f of result.affectedFiles) {
-      const icon = f.action === "create" ? chalk19.green("+") : chalk19.yellow("~");
-      console.log(`    ${icon} ${f.file}: ${chalk19.gray(f.description)}`);
+      const icon = f.action === "create" ? chalk21.green("+") : chalk21.yellow("~");
+      console.log(`    ${icon} ${f.file}: ${chalk21.gray(f.description)}`);
     }
   }
   if (opts.codegen && result.affectedFiles.length > 0) {
@@ -11334,9 +11765,9 @@ program.command("update").description("Update an existing spec with a change req
     const codegenModelName = opts.codegenModel || config2.codegenModel || DEFAULT_MODELS[codegenProviderName];
     const codegenApiKey = opts.codegenKey ?? (codegenProviderName === providerName ? apiKey : await resolveApiKey(codegenProviderName, opts.codegenKey));
     const codegenProvider = createProvider(codegenProviderName, codegenApiKey, codegenModelName);
-    console.log(chalk19.blue("\n  Regenerating affected files..."));
+    console.log(chalk21.blue("\n  Regenerating affected files..."));
     const codeGenerator = new CodeGenerator(codegenProvider, "api");
-    const specContent = await fs23.readFile(result.newSpecPath, "utf-8");
+    const specContent = await fs24.readFile(result.newSpecPath, "utf-8");
     const constitutionSection = context.constitution ? `
 === Project Constitution (MUST follow) ===
 ${context.constitution}
@@ -11347,10 +11778,10 @@ ${JSON.stringify(result.updatedDsl, null, 2).slice(0, 3e3)}
 ` : "";
     updateLogger.stageStart("update_codegen");
     for (const affected of result.affectedFiles) {
-      const fullPath = path22.join(currentDir, affected.file);
+      const fullPath = path23.join(currentDir, affected.file);
       let existing = "";
       try {
-        existing = await fs23.readFile(fullPath, "utf-8");
+        existing = await fs24.readFile(fullPath, "utf-8");
       } catch {
       }
       const codePrompt = `Apply this change to the file.
@@ -11364,23 +11795,23 @@ ${specContent}
 ${constitutionSection}${dslSection}
 === ${existing ? "Current File (return the FULL updated content)" : "New File"} ===
 ${existing || "Create from scratch."}`;
-      process.stdout.write(`  ${existing ? chalk19.yellow("~") : chalk19.green("+")} ${affected.file}... `);
+      process.stdout.write(`  ${existing ? chalk21.yellow("~") : chalk21.green("+")} ${affected.file}... `);
       try {
         const { getCodeGenSystemPrompt: _getPrompt } = await Promise.resolve().then(() => (init_codegen_prompt(), codegen_prompt_exports));
         const raw = await codegenProvider.generate(codePrompt, _getPrompt(repoType));
         const content = raw.replace(/^```\w*\n?/gm, "").replace(/\n?```$/gm, "").trim();
-        await fs23.ensureDir(path22.dirname(fullPath));
+        await fs24.ensureDir(path23.dirname(fullPath));
         await updateSnapshot.snapshotFile(fullPath);
-        await fs23.writeFile(fullPath, content, "utf-8");
+        await fs24.writeFile(fullPath, content, "utf-8");
         updateLogger.fileWritten(affected.file);
-        console.log(chalk19.green("\u2714"));
+        console.log(chalk21.green("\u2714"));
       } catch (err) {
         updateLogger.stageFail("update_codegen", `${affected.file}: ${err.message}`);
-        console.log(chalk19.red(`\u2718 ${err.message}`));
+        console.log(chalk21.red(`\u2718 ${err.message}`));
       }
     }
     updateLogger.stageEnd("update_codegen", { filesUpdated: result.affectedFiles.length });
-    const updatedSpecContent = await fs23.readFile(result.newSpecPath, "utf-8").catch(() => "");
+    const updatedSpecContent = await fs24.readFile(result.newSpecPath, "utf-8").catch(() => "");
     if (updatedSpecContent) {
       const updateReviewer = new CodeReviewer(provider, currentDir);
       const reviewResult = await updateReviewer.reviewCode(updatedSpecContent, result.newSpecPath).catch(() => "");
@@ -11392,13 +11823,13 @@ ${existing || "Create from scratch."}`;
   updateLogger.finish();
   updateLogger.printSummary();
   if (updateSnapshot.fileCount > 0) {
-    console.log(chalk19.gray(`  To undo changes: ai-spec restore ${updateRunId}`));
+    console.log(chalk21.gray(`  To undo changes: ai-spec restore ${updateRunId}`));
   }
   if (!opts.codegen && result.affectedFiles.length > 0) {
-    console.log(chalk19.blue("\n  Next steps:"));
-    console.log(chalk19.gray(`  \u2022 Re-run with --codegen to regenerate affected files automatically`));
-    console.log(chalk19.gray(`  \u2022 Or update files manually based on the affected files list above`));
-    console.log(chalk19.gray(`  \u2022 Run \`ai-spec mock\` to refresh the mock server with the new DSL`));
+    console.log(chalk21.blue("\n  Next steps:"));
+    console.log(chalk21.gray(`  \u2022 Re-run with --codegen to regenerate affected files automatically`));
+    console.log(chalk21.gray(`  \u2022 Or update files manually based on the affected files list above`));
+    console.log(chalk21.gray(`  \u2022 Run \`ai-spec mock\` to refresh the mock server with the new DSL`));
   }
 });
 program.command("export").description("Export the latest DSL to OpenAPI 3.1.0 (YAML or JSON)").option("--openapi", "Export as OpenAPI 3.1.0 (default behaviour)").option("--format <fmt>", "Output format: yaml | json (default: yaml)", "yaml").option("--output <path>", "Output file path (default: openapi.yaml)").option("--server <url>", "API server URL in the OpenAPI document (default: http://localhost:3000)").option("--dsl <path>", "Path to a specific .dsl.json file (auto-detected if omitted)").action(async (opts) => {
@@ -11407,19 +11838,19 @@ program.command("export").description("Export the latest DSL to OpenAPI 3.1.0 (Y
   if (!dslPath) {
     dslPath = await findLatestDslFile(currentDir);
     if (!dslPath) {
-      console.error(chalk19.red("  No .dsl.json file found. Run `ai-spec create` first or use --dsl <path>."));
+      console.error(chalk21.red("  No .dsl.json file found. Run `ai-spec create` first or use --dsl <path>."));
       process.exit(1);
     }
-    console.log(chalk19.gray(`  Using DSL: ${path22.relative(currentDir, dslPath)}`));
+    console.log(chalk21.gray(`  Using DSL: ${path23.relative(currentDir, dslPath)}`));
   }
   let dsl;
   try {
-    dsl = await fs23.readJson(dslPath);
+    dsl = await fs24.readJson(dslPath);
   } catch (err) {
-    console.error(chalk19.red(`  Failed to read DSL: ${err.message}`));
+    console.error(chalk21.red(`  Failed to read DSL: ${err.message}`));
     process.exit(1);
   }
-  console.log(chalk19.blue("\n\u2500\u2500\u2500 ai-spec export \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk21.blue("\n\u2500\u2500\u2500 ai-spec export \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   const format = opts.format === "json" ? "json" : "yaml";
   const serverUrl = opts.server || "http://localhost:3000";
   try {
@@ -11428,31 +11859,31 @@ program.command("export").description("Export the latest DSL to OpenAPI 3.1.0 (Y
       serverUrl,
       outputPath: opts.output
     });
-    const rel = path22.relative(currentDir, outputPath);
-    console.log(chalk19.green(`  \u2714 OpenAPI ${format.toUpperCase()} exported: ${rel}`));
-    console.log(chalk19.gray(`  Feature  : ${dsl.feature.title}`));
-    console.log(chalk19.gray(`  Endpoints: ${dsl.endpoints.length}`));
-    console.log(chalk19.gray(`  Models   : ${dsl.models.length}`));
-    console.log(chalk19.gray(`  Server   : ${serverUrl}`));
-    console.log(chalk19.blue("\n  Next steps:"));
-    console.log(chalk19.gray(`  \u2022 Import ${rel} into Postman / Insomnia / Swagger UI`));
-    console.log(chalk19.gray(`  \u2022 Use openapi-generator to generate client SDKs`));
+    const rel = path23.relative(currentDir, outputPath);
+    console.log(chalk21.green(`  \u2714 OpenAPI ${format.toUpperCase()} exported: ${rel}`));
+    console.log(chalk21.gray(`  Feature  : ${dsl.feature.title}`));
+    console.log(chalk21.gray(`  Endpoints: ${dsl.endpoints.length}`));
+    console.log(chalk21.gray(`  Models   : ${dsl.models.length}`));
+    console.log(chalk21.gray(`  Server   : ${serverUrl}`));
+    console.log(chalk21.blue("\n  Next steps:"));
+    console.log(chalk21.gray(`  \u2022 Import ${rel} into Postman / Insomnia / Swagger UI`));
+    console.log(chalk21.gray(`  \u2022 Use openapi-generator to generate client SDKs`));
   } catch (err) {
-    console.error(chalk19.red(`  Export failed: ${err.message}`));
+    console.error(chalk21.red(`  Export failed: ${err.message}`));
     process.exit(1);
   }
 });
 program.command("mock").description("Generate a standalone mock server + proxy config from the latest DSL").option("--port <n>", "Mock server port (default: 3001)", "3001").option("--msw", "Also generate MSW (Mock Service Worker) handlers at src/mocks/").option("--proxy", "Also generate frontend proxy config snippet").option("--dsl <path>", "Path to a specific .dsl.json file (auto-detected if omitted)").option("--workspace", "Generate mock assets for all backend repos in the workspace").option("--serve", "Start mock server in background + patch frontend proxy (use with --frontend)").option("--frontend <path>", "Path to frontend project for proxy patching (used with --serve/--restore)").option("--restore", "Undo proxy changes and stop mock server (requires --frontend or auto-detects)").action(async (opts) => {
   const currentDir = process.cwd();
   const port = parseInt(opts.port, 10) || 3001;
-  console.log(chalk19.blue("\n\u2500\u2500\u2500 ai-spec mock \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk21.blue("\n\u2500\u2500\u2500 ai-spec mock \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   if (opts.restore) {
-    const frontendDir = opts.frontend ? path22.resolve(opts.frontend) : currentDir;
+    const frontendDir = opts.frontend ? path23.resolve(opts.frontend) : currentDir;
     const r = await restoreMockProxy(frontendDir);
     if (r.restored) {
-      console.log(chalk19.green("  \u2714 Proxy restored and mock server stopped."));
+      console.log(chalk21.green("  \u2714 Proxy restored and mock server stopped."));
     } else {
-      console.log(chalk19.yellow(`  ${r.note ?? "Nothing to restore."}`));
+      console.log(chalk21.yellow(`  ${r.note ?? "Nothing to restore."}`));
     }
     return;
   }
@@ -11460,32 +11891,32 @@ program.command("mock").description("Generate a standalone mock server + proxy c
     const workspaceLoader = new WorkspaceLoader(currentDir);
     const workspaceConfig = await workspaceLoader.load();
     if (!workspaceConfig) {
-      console.error(chalk19.red(`  No ${WORKSPACE_CONFIG_FILE} found. Run \`ai-spec workspace init\` first.`));
+      console.error(chalk21.red(`  No ${WORKSPACE_CONFIG_FILE} found. Run \`ai-spec workspace init\` first.`));
       process.exit(1);
     }
     const backendRepos = workspaceConfig.repos.filter((r) => r.role === "backend");
     if (backendRepos.length === 0) {
-      console.log(chalk19.yellow("  No backend repos found in workspace."));
+      console.log(chalk21.yellow("  No backend repos found in workspace."));
       return;
     }
     for (const repo of backendRepos) {
       const repoAbsPath = workspaceLoader.resolveAbsPath(repo);
-      console.log(chalk19.cyan(`
+      console.log(chalk21.cyan(`
   Repo: ${repo.name} (${repoAbsPath})`));
       const dslFile = await findLatestDslFile(repoAbsPath);
       if (!dslFile) {
-        console.log(chalk19.yellow(`    No DSL file found \u2014 skipping.`));
+        console.log(chalk21.yellow(`    No DSL file found \u2014 skipping.`));
         continue;
       }
-      const dsl2 = await fs23.readJson(dslFile);
+      const dsl2 = await fs24.readJson(dslFile);
       const result2 = await generateMockAssets(dsl2, repoAbsPath, {
         port,
         msw: opts.msw,
         proxy: opts.proxy
       });
       for (const f of result2.files) {
-        console.log(chalk19.green(`    \u2714 ${f.path}`));
-        console.log(chalk19.gray(`      ${f.description}`));
+        console.log(chalk21.green(`    \u2714 ${f.path}`));
+        console.log(chalk21.gray(`      ${f.description}`));
       }
     }
     return;
@@ -11495,19 +11926,19 @@ program.command("mock").description("Generate a standalone mock server + proxy c
     dslPath = await findLatestDslFile(currentDir);
     if (!dslPath) {
       console.error(
-        chalk19.red(
+        chalk21.red(
           "  No .dsl.json file found in .ai-spec/. Run `ai-spec create` first or use --dsl <path>."
         )
       );
       process.exit(1);
     }
-    console.log(chalk19.gray(`  Using DSL: ${path22.relative(currentDir, dslPath)}`));
+    console.log(chalk21.gray(`  Using DSL: ${path23.relative(currentDir, dslPath)}`));
   }
   let dsl;
   try {
-    dsl = await fs23.readJson(dslPath);
+    dsl = await fs24.readJson(dslPath);
   } catch (err) {
-    console.error(chalk19.red(`  Failed to read DSL file: ${err.message}`));
+    console.error(chalk21.red(`  Failed to read DSL file: ${err.message}`));
     process.exit(1);
   }
   const result = await generateMockAssets(dsl, currentDir, {
@@ -11515,58 +11946,58 @@ program.command("mock").description("Generate a standalone mock server + proxy c
     msw: opts.msw,
     proxy: opts.proxy
   });
-  console.log(chalk19.green(`
+  console.log(chalk21.green(`
   \u2714 Mock assets generated (${result.files.length} file(s)):`));
   for (const f of result.files) {
-    console.log(chalk19.green(`    ${f.path}`));
-    console.log(chalk19.gray(`      ${f.description}`));
+    console.log(chalk21.green(`    ${f.path}`));
+    console.log(chalk21.gray(`      ${f.description}`));
   }
   if (opts.serve) {
-    const serverJsPath = path22.join(currentDir, "mock", "server.js");
-    if (!await fs23.pathExists(serverJsPath)) {
-      console.error(chalk19.red("  mock/server.js not found \u2014 generation may have failed."));
+    const serverJsPath = path23.join(currentDir, "mock", "server.js");
+    if (!await fs24.pathExists(serverJsPath)) {
+      console.error(chalk21.red("  mock/server.js not found \u2014 generation may have failed."));
       process.exit(1);
     }
     const pid = startMockServerBackground(serverJsPath, port);
-    console.log(chalk19.green(`
+    console.log(chalk21.green(`
   \u2714 Mock server started (PID ${pid}) \u2192 http://localhost:${port}`));
     if (opts.frontend) {
-      const frontendDir = path22.resolve(opts.frontend);
+      const frontendDir = path23.resolve(opts.frontend);
       const proxyResult = await applyMockProxy(frontendDir, port, dsl.endpoints);
       await saveMockServerPid(frontendDir, pid);
       if (proxyResult.applied) {
-        console.log(chalk19.green(`  \u2714 Frontend proxy patched (${proxyResult.framework})`));
-        console.log(chalk19.bold.cyan(`
+        console.log(chalk21.green(`  \u2714 Frontend proxy patched (${proxyResult.framework})`));
+        console.log(chalk21.bold.cyan(`
   Ready! Open a new terminal and run:`));
-        console.log(chalk19.white(`    cd ${frontendDir}`));
-        console.log(chalk19.white(`    ${proxyResult.devCommand}`));
-        console.log(chalk19.gray(`
+        console.log(chalk21.white(`    cd ${frontendDir}`));
+        console.log(chalk21.white(`    ${proxyResult.devCommand}`));
+        console.log(chalk21.gray(`
   When done: ai-spec mock --restore --frontend ${frontendDir}`));
       } else {
-        console.log(chalk19.yellow(`  \u26A0 Auto-patch not available for ${proxyResult.framework}.`));
-        if (proxyResult.note) console.log(chalk19.gray(`    ${proxyResult.note}`));
+        console.log(chalk21.yellow(`  \u26A0 Auto-patch not available for ${proxyResult.framework}.`));
+        if (proxyResult.note) console.log(chalk21.gray(`    ${proxyResult.note}`));
       }
     } else {
-      console.log(chalk19.gray(`  Tip: use --frontend <path> to also auto-patch your frontend proxy config.`));
-      console.log(chalk19.gray(`  Mock server: http://localhost:${port}`));
+      console.log(chalk21.gray(`  Tip: use --frontend <path> to also auto-patch your frontend proxy config.`));
+      console.log(chalk21.gray(`  Mock server: http://localhost:${port}`));
     }
     return;
   }
-  console.log(chalk19.blue("\n\u2500\u2500\u2500 Quick start \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log(chalk19.white(`  1. Install express (if not already):`));
-  console.log(chalk19.gray(`       npm install --save-dev express`));
-  console.log(chalk19.white(`  2. Start mock server:`));
-  console.log(chalk19.gray(`       node mock/server.js`));
-  console.log(chalk19.gray(`       # or: ai-spec mock --serve --frontend <path-to-frontend>`));
-  console.log(chalk19.white(`  3. Configure your frontend to proxy API calls to:`));
-  console.log(chalk19.gray(`       http://localhost:${port}`));
+  console.log(chalk21.blue("\n\u2500\u2500\u2500 Quick start \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk21.white(`  1. Install express (if not already):`));
+  console.log(chalk21.gray(`       npm install --save-dev express`));
+  console.log(chalk21.white(`  2. Start mock server:`));
+  console.log(chalk21.gray(`       node mock/server.js`));
+  console.log(chalk21.gray(`       # or: ai-spec mock --serve --frontend <path-to-frontend>`));
+  console.log(chalk21.white(`  3. Configure your frontend to proxy API calls to:`));
+  console.log(chalk21.gray(`       http://localhost:${port}`));
   if (opts.proxy) {
-    console.log(chalk19.gray(`     (See the generated proxy config file for framework-specific instructions)`));
+    console.log(chalk21.gray(`     (See the generated proxy config file for framework-specific instructions)`));
   }
   if (opts.msw) {
-    console.log(chalk19.white(`  4. MSW: import and start the worker in your app entry:`));
-    console.log(chalk19.gray(`       import { worker } from './mocks/browser';`));
-    console.log(chalk19.gray(`       if (process.env.NODE_ENV === 'development') worker.start();`));
+    console.log(chalk21.white(`  4. MSW: import and start the worker in your app entry:`));
+    console.log(chalk21.gray(`       import { worker } from './mocks/browser';`));
+    console.log(chalk21.gray(`       if (process.env.NODE_ENV === 'development') worker.start();`));
   }
 });
 program.command("learn").description("Append a lesson or engineering decision directly to constitution \xA79").argument("[lesson]", "The lesson or decision to record (prompted if omitted)").action(async (lesson) => {
@@ -11582,26 +12013,118 @@ program.command("learn").description("Append a lesson or engineering decision di
   }
   const result = await appendDirectLesson(currentDir, lesson.trim());
   if (result.appended) {
-    console.log(chalk19.green(`
+    console.log(chalk21.green(`
   \u2714 Lesson appended to constitution \xA79`));
-    console.log(chalk19.gray(`  File: .ai-spec-constitution.md`));
+    console.log(chalk21.gray(`  File: .ai-spec-constitution.md`));
   } else {
-    console.log(chalk19.yellow(`
+    console.log(chalk21.yellow(`
   \u26A0 Not appended: ${result.reason}`));
   }
 });
 program.command("restore").description("Restore files modified by a previous run").argument("<runId>", "Run ID shown at the end of a create / generate run").action(async (runId) => {
   const currentDir = process.cwd();
   const snapshot = new RunSnapshot(currentDir, runId);
-  console.log(chalk19.blue(`Restoring run: ${runId}...`));
+  console.log(chalk21.blue(`Restoring run: ${runId}...`));
   const restored = await snapshot.restore();
   if (restored.length === 0) {
-    console.log(chalk19.yellow("  No backup found for this run ID."));
+    console.log(chalk21.yellow("  No backup found for this run ID."));
   } else {
-    restored.forEach((f) => console.log(chalk19.green(`  \u2714 restored: ${f}`)));
-    console.log(chalk19.bold.green(`
+    restored.forEach((f) => console.log(chalk21.green(`  \u2714 restored: ${f}`)));
+    console.log(chalk21.bold.green(`
 \u2714 ${restored.length} file(s) restored.`));
   }
 });
+program.command("trend").description("Show harness score trend across past create runs").option("--last <n>", "Number of recent scored runs to show (default: 15)", "15").option("--prompt <hash>", "Filter to a specific prompt hash (prefix match)").option("--json", "Output raw JSON instead of formatted table").action(async (opts) => {
+  const currentDir = process.cwd();
+  const last = parseInt(opts.last, 10) || 15;
+  const logs = await loadRunLogs(currentDir);
+  if (logs.length === 0) {
+    console.log(chalk21.yellow(
+      "\n  No run logs found. Run `ai-spec create` at least once to start tracking.\n"
+    ));
+    return;
+  }
+  const report = buildTrendReport(logs, {
+    last,
+    promptFilter: opts.prompt
+  });
+  if (opts.json) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+  printTrendReport(report, currentDir);
+});
+program.command("logs").description("List recent run logs with stage timing").argument("[runId]", "Show detailed stage breakdown for a specific run ID").option("--last <n>", "Number of runs to list (default: 10)", "10").action(async (runId, opts) => {
+  const currentDir = process.cwd();
+  const logDir = path23.join(currentDir, ".ai-spec-logs");
+  if (!await fs24.pathExists(logDir)) {
+    console.log(chalk21.yellow("\n  No run logs found (.ai-spec-logs/ does not exist).\n"));
+    return;
+  }
+  if (runId) {
+    const logPath = path23.join(logDir, `${runId}.json`);
+    if (!await fs24.pathExists(logPath)) {
+      console.log(chalk21.red(`
+  Run not found: ${runId}
+`));
+      return;
+    }
+    const log = await fs24.readJson(logPath);
+    console.log(chalk21.cyan(`
+\u2500\u2500\u2500 Run: ${log.runId} \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`));
+    console.log(chalk21.gray(`  Started : ${log.startedAt}`));
+    if (log.endedAt) console.log(chalk21.gray(`  Ended   : ${log.endedAt}`));
+    if (log.totalDurationMs !== void 0)
+      console.log(chalk21.gray(`  Duration: ${(log.totalDurationMs / 1e3).toFixed(1)}s`));
+    if (log.provider) console.log(chalk21.gray(`  Provider: ${log.provider} / ${log.model ?? "?"}`));
+    if (log.promptHash) console.log(chalk21.gray(`  Prompt  : ${log.promptHash}`));
+    if (log.harnessScore !== void 0)
+      console.log(chalk21.white(`  Score   : ${log.harnessScore}/10`));
+    if (log.filesWritten?.length)
+      console.log(chalk21.gray(`  Files   : ${log.filesWritten.length} written`));
+    if (log.errors?.length)
+      console.log(chalk21.yellow(`  Errors  : ${log.errors.length}`));
+    if (log.entries?.length) {
+      console.log(chalk21.bold("\n  Stages:\n"));
+      const doneEvents = log.entries.filter((e) => e.event.endsWith(":done") || e.event.endsWith(":failed"));
+      for (const entry of doneEvents) {
+        const isOk = entry.event.endsWith(":done");
+        const stage = entry.event.replace(/:done$|:failed$/, "");
+        const dur = entry.data?.durationMs ? chalk21.gray(` ${(Number(entry.data.durationMs) / 1e3).toFixed(1)}s`) : "";
+        const mark = isOk ? chalk21.green("\u2714") : chalk21.red("\u2718");
+        console.log(`    ${mark}  ${stage.padEnd(20)}${dur}`);
+      }
+    }
+    console.log(chalk21.cyan("\u2500".repeat(52)));
+    return;
+  }
+  const logs = await loadRunLogs(currentDir);
+  const last = parseInt(opts.last, 10) || 10;
+  const shown = logs.slice(0, last);
+  if (shown.length === 0) {
+    console.log(chalk21.yellow("\n  No run logs found.\n"));
+    return;
+  }
+  console.log(chalk21.cyan("\n\u2500\u2500\u2500 Run Logs \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk21.gray(
+    "\n  " + "Run ID                  ".padEnd(26) + "Date      " + "Score ".padStart(6) + "  Files  Dur\n"
+  ));
+  for (const log of shown) {
+    const date = log.startedAt.slice(0, 10);
+    const score = log.harnessScore !== void 0 ? (log.harnessScore >= 8 ? chalk21.green : log.harnessScore >= 6 ? chalk21.yellow : chalk21.red)(
+      log.harnessScore.toFixed(1).padStart(5)
+    ) : chalk21.gray("    \u2014");
+    const files = String(log.filesWritten?.length ?? 0).padStart(5);
+    const dur = log.totalDurationMs !== void 0 ? chalk21.gray((log.totalDurationMs / 1e3).toFixed(0) + "s") : chalk21.gray("\u2014");
+    const errMark = (log.errors?.length ?? 0) > 0 ? chalk21.yellow(` \u26A0${log.errors.length}`) : "";
+    console.log(`  ${chalk21.white(log.runId.padEnd(25))} ${chalk21.gray(date)} ${score}  ${chalk21.gray(files)}  ${dur}${errMark}`);
+  }
+  console.log(chalk21.gray(`
+  Showing ${shown.length} of ${logs.length} run(s)  \xB7  logs: .ai-spec-logs/`));
+  console.log(chalk21.cyan("\u2500".repeat(63)));
+  console.log(chalk21.gray(`  Tip: ai-spec logs <runId>   to see stage breakdown`));
+  console.log(chalk21.gray(`       ai-spec trend          to see score trend by prompt version
+`));
+});
 program.parse();
 //# sourceMappingURL=index.mjs.map