ai-spec-dev 0.38.0 → 0.42.0

package/dist/index.mjs

@@ -116,9 +116,77 @@ CRITICAL \u2014 \u5386\u53F2\u6559\u8BAD\u5E94\u7528\uFF08Accumulated Lessons\uF
 3. \u5BF9\u4E8E\u6BCF\u6761\u76F4\u63A5\u76F8\u5173\u7684\u6559\u8BAD\uFF0C\u5728 \xA78 \u5B9E\u65BD\u8981\u70B9\u672B\u5C3E\u8FFD\u52A0\u4E00\u884C\uFF1A\u300C\u26A0 \u57FA\u4E8E\u5386\u53F2\u6559\u8BAD\uFF1A[\u7B80\u8FF0\u672C\u6B21 spec \u5982\u4F55\u89C4\u907F\u8BE5\u95EE\u9898]\u300D
 4. \u5982\u65E0\u76F8\u5173\u6559\u8BAD\uFF0C\xA78 \u4E0D\u5FC5\u8FFD\u52A0\u4EFB\u4F55\u5185\u5BB9`;
 
-// core/provider-utils.ts
+// core/cli-ui.ts
 import chalk from "chalk";
-var sleep = (ms2) => new Promise((r) => setTimeout(r, ms2));
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function startSpinner(text) {
+  const isTTY = process.stderr.isTTY;
+  let frame = 0;
+  let currentText = text;
+  let stopped = false;
+  function render() {
+    if (stopped) return;
+    const symbol = chalk.cyan(SPINNER_FRAMES[frame % SPINNER_FRAMES.length]);
+    if (isTTY) {
+      process.stderr.write(`\r  ${symbol} ${currentText}${" ".repeat(10)}`);
+    }
+    frame++;
+  }
+  if (!isTTY) {
+    process.stderr.write(`  \u2026 ${currentText}
+`);
+  }
+  const timer = setInterval(render, 80);
+  render();
+  return {
+    update(newText) {
+      currentText = newText;
+    },
+    stop(finalText) {
+      if (stopped) return;
+      stopped = true;
+      clearInterval(timer);
+      if (isTTY) {
+        process.stderr.write(`\r${" ".repeat(currentText.length + 20)}\r`);
+      }
+      if (finalText) {
+        process.stderr.write(`  ${finalText}
+`);
+      }
+    },
+    succeed(successText) {
+      this.stop(chalk.green(`\u2714 ${successText}`));
+    },
+    fail(failText) {
+      this.stop(chalk.red(`\u2718 ${failText}`));
+    }
+  };
+}
+async function retryCountdown(opts) {
+  const { attempt, maxAttempts, waitMs, errorMessage, label } = opts;
+  const isTTY = process.stderr.isTTY;
+  const shortErr = errorMessage.length > 120 ? errorMessage.slice(0, 117) + "..." : errorMessage;
+  process.stderr.write("\n");
+  process.stderr.write(chalk.yellow(`  \u250C\u2500 Retry ${attempt}/${maxAttempts} `) + chalk.gray(`[${label}]`) + chalk.yellow(` ${"\u2500".repeat(Math.max(1, 40 - label.length))}
+`));
+  process.stderr.write(chalk.yellow(`  \u2502 `) + chalk.white(shortErr) + "\n");
+  process.stderr.write(chalk.yellow(`  \u2502 `) + chalk.gray(`Waiting before retry...`) + "\n");
+  const totalSeconds = Math.ceil(waitMs / 1e3);
+  for (let s = totalSeconds; s > 0; s--) {
+    const bar = chalk.green("\u2588".repeat(totalSeconds - s)) + chalk.gray("\u2591".repeat(s));
+    const line = chalk.yellow(`  \u2502 `) + `${bar} ${chalk.bold.white(`${s}s`)}`;
+    if (isTTY) {
+      process.stderr.write(`\r${line}${" ".repeat(10)}`);
+    }
+    await new Promise((r) => setTimeout(r, 1e3));
+  }
+  if (isTTY) {
+    process.stderr.write(`\r${" ".repeat(70)}\r`);
+  }
+  process.stderr.write(chalk.yellow(`  \u2514\u2500 `) + chalk.cyan(`Retrying now...`) + "\n\n");
+}
+
+// core/provider-utils.ts
 var ProviderError = class extends Error {
   constructor(message, kind, originalError) {
     super(message);
@@ -202,11 +270,14 @@ async function withReliability(fn, opts) {
         throw classifyError(err, label);
       }
       const waitMs = attempt === 0 ? 2e3 : 6e3;
-      console.warn(
-        chalk.yellow(`  \u26A0 ${label} failed (attempt ${attempt + 1}/${retries + 1}), retrying in ${waitMs / 1e3}s`) + chalk.gray(` \u2014 ${err.message}`)
-      );
       onRetry?.(attempt + 1, err);
-      await sleep(waitMs);
+      await retryCountdown({
+        attempt: attempt + 1,
+        maxAttempts: retries + 1,
+        waitMs,
+        errorMessage: err.message ?? String(err),
+        label
+      });
     }
   }
   throw new Error("unreachable");
@@ -4107,8 +4178,8 @@ ${currentSpec}`,
 };
 
 // core/code-generator.ts
-import chalk8 from "chalk";
-import { execSync, spawnSync } from "child_process";
+import chalk10 from "chalk";
+import { execSync as execSync2, spawnSync } from "child_process";
 import * as path6 from "path";
 import * as fs10 from "fs-extra";
 
@@ -4685,7 +4756,7 @@ async function updateTaskStatus(specFilePath, taskId, status) {
 }
 
 // core/dsl-extractor.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 import * as fs6 from "fs-extra";
 import * as path4 from "path";
 import { select as select2 } from "@inquirer/prompts";
@@ -4774,6 +4845,7 @@ function validateDsl(raw) {
       }
     }
   }
+  crossReferenceChecks(obj, errors);
   if (errors.length > 0) {
     return { valid: false, errors };
   }
@@ -5005,6 +5077,64 @@ function validateComponent(raw, path10, errors) {
     }
   }
 }
+function crossReferenceChecks(obj, errors) {
+  const models = Array.isArray(obj["models"]) ? obj["models"] : [];
+  const endpoints = Array.isArray(obj["endpoints"]) ? obj["endpoints"] : [];
+  const components = Array.isArray(obj["components"]) ? obj["components"] : [];
+  const seenRoutes = /* @__PURE__ */ new Map();
+  for (let i = 0; i < endpoints.length; i++) {
+    const ep = endpoints[i];
+    if (typeof ep?.["method"] === "string" && typeof ep?.["path"] === "string") {
+      const route = `${ep["method"].toUpperCase()} ${ep["path"]}`;
+      if (seenRoutes.has(route)) {
+        errors.push({
+          path: `endpoints[${i}]`,
+          message: `Duplicate route "${route}" \u2014 also defined at endpoints[${seenRoutes.get(route)}]`
+        });
+      } else {
+        seenRoutes.set(route, i);
+      }
+    }
+  }
+  const modelNames = new Set(
+    models.filter((m) => typeof m?.["name"] === "string").map((m) => m["name"])
+  );
+  for (let i = 0; i < models.length; i++) {
+    const m = models[i];
+    if (!Array.isArray(m?.["relations"])) continue;
+    for (const rel of m["relations"]) {
+      if (typeof rel !== "string") continue;
+      const refMatch = rel.match(/(?:hasMany|hasOne|belongsTo|manyToMany)\s+(\w+)/i);
+      if (refMatch) {
+        const refName = refMatch[1];
+        if (!modelNames.has(refName)) {
+          errors.push({
+            path: `models[${i}].relations`,
+            message: `Relation references model "${refName}" which is not defined in models[]`
+          });
+        }
+      }
+    }
+  }
+  const endpointIds = new Set(
+    endpoints.filter((e) => typeof e?.["id"] === "string").map((e) => e["id"])
+  );
+  if (endpointIds.size > 0) {
+    for (let i = 0; i < components.length; i++) {
+      const c = components[i];
+      if (!Array.isArray(c?.["apiCalls"])) continue;
+      for (const call of c["apiCalls"]) {
+        if (typeof call !== "string") continue;
+        if (!endpointIds.has(call)) {
+          errors.push({
+            path: `components[${i}].apiCalls`,
+            message: `References endpoint "${call}" which is not defined in endpoints[]`
+          });
+        }
+      }
+    }
+  }
+}
 function requireNonEmptyString(v2, path10, errors) {
   if (typeof v2 !== "string" || v2.trim().length === 0) {
     errors.push({
@@ -5019,6 +5149,26 @@ function typeLabel(v2) {
   return typeof v2;
 }
 
+// core/token-budget.ts
+import chalk6 from "chalk";
+var CJK_RANGE = /[\u4e00-\u9fff\u3400-\u4dbf\u3000-\u303f\uff00-\uffef]/g;
+function estimateTokens(text) {
+  if (!text) return 0;
+  const cjkCount = (text.match(CJK_RANGE) ?? []).length;
+  const nonCjkLength = text.length - cjkCount;
+  return Math.ceil(cjkCount + nonCjkLength / 4);
+}
+var DEFAULT_TOKEN_BUDGETS = {
+  gemini: 9e5,
+  claude: 18e4,
+  openai: 12e4,
+  deepseek: 6e4,
+  default: 1e5
+};
+function getDefaultBudget(providerName) {
+  return DEFAULT_TOKEN_BUDGETS[providerName] ?? DEFAULT_TOKEN_BUDGETS.default;
+}
+
 // core/dsl-extractor.ts
 function dslFilePath(specFilePath) {
   const dir = path4.dirname(specFilePath);
@@ -5177,7 +5327,9 @@ var ROUTING_LIBS = [
   ["@tanstack/react-router", "tanstack-router"],
   ["react-navigation", "react-navigation"],
   ["expo-router", "expo-router"],
-  ["vue-router", "vue-router"]
+  ["vue-router", "vue-router"],
+  ["@solidjs/router", "solid-router"],
+  ["@builder.io/qwik-city", "qwik-city"]
 ];
 async function loadFrontendContext(projectRoot) {
   const ctx = {
@@ -5209,6 +5361,18 @@ async function loadFrontendContext(projectRoot) {
     const has = (name) => depKeys.includes(name);
     if (has("react-native") || has("expo")) {
       ctx.framework = "react-native";
+    } else if (has("@sveltejs/kit")) {
+      ctx.framework = "sveltekit";
+    } else if (has("svelte")) {
+      ctx.framework = "svelte";
+    } else if (has("@builder.io/qwik")) {
+      ctx.framework = "qwik";
+    } else if (has("@remix-run/react") || has("@remix-run/node")) {
+      ctx.framework = "remix";
+    } else if (has("astro")) {
+      ctx.framework = "astro";
+    } else if (has("solid-js")) {
+      ctx.framework = "solid";
     } else if (has("next")) {
       ctx.framework = "next";
     } else if (has("react")) {
@@ -5235,6 +5399,12 @@ async function loadFrontendContext(projectRoot) {
     if (ctx.framework === "next") {
       const hasAppDir = await fs7.pathExists(path5.join(projectRoot, "app"));
       ctx.routingPattern = hasAppDir ? "next-app-router" : "next-pages-router";
+    } else if (ctx.framework === "sveltekit") {
+      ctx.routingPattern = "sveltekit-file-router";
+    } else if (ctx.framework === "remix") {
+      ctx.routingPattern = "remix-file-router";
+    } else if (ctx.framework === "astro") {
+      ctx.routingPattern = "astro-file-router";
     } else {
       for (const [lib, label] of ROUTING_LIBS) {
         if (has(lib)) {
@@ -5620,13 +5790,14 @@ function getActiveSnapshot() {
 
 // core/run-logger.ts
 import * as fs9 from "fs-extra";
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 var _activeLogger = null;
 function getActiveLogger() {
   return _activeLogger;
 }
 
-// core/code-generator.ts
+// core/codegen/helpers.ts
+import { execSync } from "child_process";
 function buildSharedConfigSection(context) {
   if (!context?.sharedConfigFiles || context.sharedConfigFiles.length === 0) return "";
   const lines = [
@@ -5758,7 +5929,7 @@ function buildGeneratedFilesSection(cache) {
 }
 function isRtkAvailable() {
   try {
-    execSync("rtk --version", { stdio: "ignore" });
+    execSync("rtk --version", { stdio: "ignore", timeout: 1e4 });
     return true;
   } catch {
     return false;
@@ -5782,6 +5953,73 @@ function parseJsonArray(text) {
   }
   return [];
 }
+
+// core/codegen/topo-sort.ts
+import chalk9 from "chalk";
+function topoSortLayerTasks(tasks) {
+  if (tasks.length <= 1) return [tasks];
+  const idSet = new Set(tasks.map((t) => t.id));
+  const taskById = new Map(tasks.map((t) => [t.id, t]));
+  const inDegree = /* @__PURE__ */ new Map();
+  const dependents = /* @__PURE__ */ new Map();
+  for (const task of tasks) {
+    inDegree.set(task.id, 0);
+    dependents.set(task.id, []);
+  }
+  for (const task of tasks) {
+    const intraDeps = task.dependencies.filter((dep) => idSet.has(dep));
+    inDegree.set(task.id, intraDeps.length);
+    for (const dep of intraDeps) {
+      dependents.get(dep).push(task.id);
+    }
+  }
+  const batches = [];
+  const remaining = new Set(tasks.map((t) => t.id));
+  while (remaining.size > 0) {
+    const batch = [...remaining].filter((id) => inDegree.get(id) === 0).map((id) => taskById.get(id));
+    if (batch.length === 0) {
+      batches.push([...remaining].map((id) => taskById.get(id)));
+      break;
+    }
+    batches.push(batch);
+    for (const task of batch) {
+      remaining.delete(task.id);
+      for (const dependent of dependents.get(task.id)) {
+        inDegree.set(dependent, inDegree.get(dependent) - 1);
+      }
+    }
+  }
+  return batches;
+}
+var LAYER_ICONS = {
+  data: "\u{1F4BE}",
+  infra: "\u2699\uFE0F ",
+  service: "\u{1F527}",
+  api: "\u{1F310}",
+  view: "\u{1F5A5}\uFE0F ",
+  route: "\u{1F5FA}\uFE0F ",
+  test: "\u{1F9EA}"
+};
+function printTaskProgress(completed, total, task, mode) {
+  const pct = total > 0 ? Math.round(completed / total * 100) : 0;
+  const barWidth = 20;
+  const filled = Math.round(pct / 100 * barWidth);
+  const bar = chalk9.green("\u2588".repeat(filled)) + chalk9.gray("\u2591".repeat(barWidth - filled));
+  const icon = LAYER_ICONS[task.layer] ?? "  ";
+  if (mode === "skip") {
+    console.log(
+      chalk9.gray(`
+  [${bar}] ${pct}% \u2713 ${task.id} ${icon} ${task.title} \u2014 already done`)
+    );
+  } else {
+    console.log(
+      chalk9.bold(`
+  [${bar}] ${pct}% \u2192 ${task.id} ${icon} ${task.title}`)
+    );
+  }
+}
+
+// core/code-generator.ts
 var CodeGenerator = class {
   constructor(provider, mode = "claude-code") {
     this.provider = provider;
@@ -5792,13 +6030,13 @@ var CodeGenerator = class {
     let effectiveMode = this.mode;
     if (effectiveMode === "claude-code" && this.provider.providerName !== "claude") {
       console.log(
-        chalk8.yellow(
+        chalk10.yellow(
           `
   \u26A0  codegen \u6A21\u5F0F "claude-code" \u9700\u8981 Claude\uFF0C\u4F46\u5F53\u524D provider \u662F "${this.provider.providerName}"\u3002`
         )
       );
-      console.log(chalk8.gray(`  \u81EA\u52A8\u5207\u6362\u5230 "api" \u6A21\u5F0F\uFF08\u4F7F\u7528 ${this.provider.providerName}/${this.provider.modelName} \u751F\u6210\u4EE3\u7801\uFF09\u3002`));
-      console.log(chalk8.gray(`  \u63D0\u793A\uFF1A\u8FD0\u884C \`ai-spec config --codegen api\` \u53EF\u56FA\u5316\u6B64\u8BBE\u7F6E\u3002
+      console.log(chalk10.gray(`  \u81EA\u52A8\u5207\u6362\u5230 "api" \u6A21\u5F0F\uFF08\u4F7F\u7528 ${this.provider.providerName}/${this.provider.modelName} \u751F\u6210\u4EE3\u7801\uFF09\u3002`));
+      console.log(chalk10.gray(`  \u63D0\u793A\uFF1A\u8FD0\u884C \`ai-spec config --codegen api\` \u53EF\u56FA\u5316\u6B64\u8BBE\u7F6E\u3002
 `));
       effectiveMode = "api";
     }
@@ -5816,23 +6054,23 @@ var CodeGenerator = class {
   // ── Mode: claude-code ──────────────────────────────────────────────────────
   isClaudeCLIAvailable() {
     try {
-      execSync("claude --version", { stdio: "ignore" });
+      execSync2("claude --version", { stdio: "ignore", timeout: 1e4 });
       return true;
     } catch {
       return false;
     }
   }
   async runClaudeCode(specFilePath, workingDir, options = {}) {
-    console.log(chalk8.blue("\n\u2500\u2500\u2500 Code Generation: Claude Code CLI \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk10.blue("\n\u2500\u2500\u2500 Code Generation: Claude Code CLI \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     if (!this.isClaudeCLIAvailable()) {
-      console.log(chalk8.yellow("  \u26A0\uFE0F  Claude Code CLI not found. Falling back to plan mode."));
-      console.log(chalk8.gray("  Install: npm install -g @anthropic-ai/claude-code"));
+      console.log(chalk10.yellow("  \u26A0\uFE0F  Claude Code CLI not found. Falling back to plan mode."));
+      console.log(chalk10.gray("  Install: npm install -g @anthropic-ai/claude-code"));
       return this.runPlanMode(specFilePath);
     }
     const rtkAvailable = isRtkAvailable();
     const claudeCmd = rtkAvailable ? "rtk claude" : "claude";
     if (rtkAvailable) {
-      console.log(chalk8.green("  \u2713 RTK detected \u2014 using rtk claude for token savings"));
+      console.log(chalk10.green("  \u2713 RTK detected \u2014 using rtk claude for token savings"));
     }
     const tasks = await loadTasksForSpec(specFilePath);
     if (options.auto && tasks && tasks.length > 0) {
@@ -5848,28 +6086,28 @@ ${tasks.map((t) => `${t.id} [${t.layer}] ${t.title}
     const promptFile = path6.join(workingDir, ".claude-prompt.txt");
     await fs10.writeFile(promptFile, promptContent, "utf-8");
     if (options.auto) {
-      console.log(chalk8.cyan(`  \u{1F916} Auto mode: running claude -p (non-interactive)...`));
-      console.log(chalk8.gray(`  Spec: ${specFilePath}`));
+      console.log(chalk10.cyan(`  \u{1F916} Auto mode: running claude -p (non-interactive)...`));
+      console.log(chalk10.gray(`  Spec: ${specFilePath}`));
       try {
         spawnSync(claudeCmd, ["-p", promptContent], {
           cwd: workingDir,
           stdio: "inherit",
           shell: false
         });
-        console.log(chalk8.green("\n  \u2714 Claude Code completed."));
+        console.log(chalk10.green("\n  \u2714 Claude Code completed."));
       } catch {
-        console.log(chalk8.yellow("\n  Claude Code exited. Check output above."));
+        console.log(chalk10.yellow("\n  Claude Code exited. Check output above."));
       }
     } else {
-      console.log(chalk8.cyan(`  \u{1F680} Launching ${claudeCmd} in: ${workingDir}`));
-      console.log(chalk8.gray(`  Spec: ${specFilePath}`));
-      if (tasks) console.log(chalk8.gray(`  Tasks: ${tasks.length} tasks loaded into .claude-prompt.txt`));
-      console.log(chalk8.gray("  Prompt pre-loaded in .claude-prompt.txt\n"));
+      console.log(chalk10.cyan(`  \u{1F680} Launching ${claudeCmd} in: ${workingDir}`));
+      console.log(chalk10.gray(`  Spec: ${specFilePath}`));
+      if (tasks) console.log(chalk10.gray(`  Tasks: ${tasks.length} tasks loaded into .claude-prompt.txt`));
+      console.log(chalk10.gray("  Prompt pre-loaded in .claude-prompt.txt\n"));
       try {
-        execSync(claudeCmd, { cwd: workingDir, stdio: "inherit" });
-        console.log(chalk8.green("\n  \u2714 Claude Code session completed."));
+        execSync2(claudeCmd, { cwd: workingDir, stdio: "inherit" });
+        console.log(chalk10.green("\n  \u2714 Claude Code session completed."));
       } catch {
-        console.log(chalk8.yellow("\n  Claude Code session ended. Continuing workflow."));
+        console.log(chalk10.yellow("\n  Claude Code session ended. Continuing workflow."));
       }
     }
   }
@@ -5882,10 +6120,10 @@ ${tasks.map((t) => `${t.id} [${t.layer}] ${t.title}
     const pending = tasks.filter((t) => t.status !== "done");
     const doneCount = tasks.length - pending.length;
     if (options.resume && doneCount > 0) {
-      console.log(chalk8.cyan(`
+      console.log(chalk10.cyan(`
   Resuming: ${doneCount}/${tasks.length} tasks already done \u2014 skipping.`));
     } else {
-      console.log(chalk8.cyan(`
+      console.log(chalk10.cyan(`
   Incremental mode: ${tasks.length} tasks`));
     }
     let completed = doneCount;
@@ -5914,33 +6152,33 @@ Implement ONLY this task. Do not implement other tasks.`;
         completed++;
       } catch {
         taskStatus = "failed";
-        console.log(chalk8.yellow(`
+        console.log(chalk10.yellow(`
   \u26A0 Task ${task.id} exited with error \u2014 marked as failed. Re-run with --resume to retry.`));
       }
       await updateTaskStatus(specFilePath, task.id, taskStatus);
     }
     const successCount = tasks.filter((t) => t.status === "done").length + (completed - doneCount);
     console.log(
-      chalk8.bold(
+      chalk10.bold(
         `
-  ${successCount === tasks.length ? chalk8.green("\u2714") : chalk8.yellow("!")} Incremental build: ${completed}/${tasks.length} tasks completed.`
+  ${successCount === tasks.length ? chalk10.green("\u2714") : chalk10.yellow("!")} Incremental build: ${completed}/${tasks.length} tasks completed.`
       )
     );
   }
   // ── Mode: api ─────────────────────────────────────────────────────────────
   async runApiMode(specFilePath, workingDir, context, options = {}) {
     console.log(
-      chalk8.blue(
+      chalk10.blue(
         `
 \u2500\u2500\u2500 Code Generation: API (${this.provider.providerName}/${this.provider.modelName}) \u2500\u2500\u2500`
       )
     );
     const systemPrompt = getCodeGenSystemPrompt(options.repoType);
     if (options.repoType && options.repoType !== "node-express" && options.repoType !== "node-koa" && options.repoType !== "unknown") {
-      console.log(chalk8.gray(`  Language: ${options.repoType} (using language-specific codegen prompt)`));
+      console.log(chalk10.gray(`  Language: ${options.repoType} (using language-specific codegen prompt)`));
     }
     const spec = await fs10.readFile(specFilePath, "utf-8");
-    const constitutionSection = context?.constitution ? `
+    let constitutionSection = context?.constitution ? `
 === Project Constitution (MUST follow) ===
 ${context.constitution}
 ` : "";
@@ -5955,7 +6193,7 @@ ${buildDslContextSection(dsl)}
     if (dsl) {
       const cmpCount = dsl.components?.length ?? 0;
       const cmpSuffix = cmpCount > 0 ? `, ${cmpCount} components` : "";
-      console.log(chalk8.green(`  \u2713 DSL loaded \u2014 ${dsl.endpoints.length} endpoints, ${dsl.models.length} models${cmpSuffix}`));
+      console.log(chalk10.green(`  \u2713 DSL loaded \u2014 ${dsl.endpoints.length} endpoints, ${dsl.models.length} models${cmpSuffix}`));
     }
     const isFrontend = isFrontendDeps(context?.dependencies ?? []);
     let frontendSection = "";
@@ -5964,13 +6202,30 @@ ${buildDslContextSection(dsl)}
       frontendSection = `
 ${buildFrontendContextSection(fctx)}
 `;
-      console.log(chalk8.gray(`  Frontend context: ${fctx.framework} / ${fctx.httpClient} | hooks:${fctx.hookFiles.length} stores:${fctx.storeFiles.length}`));
+      console.log(chalk10.gray(`  Frontend context: ${fctx.framework} / ${fctx.httpClient} | hooks:${fctx.hookFiles.length} stores:${fctx.storeFiles.length}`));
+    }
+    const allContextText = spec + constitutionSection + dslSection + frontendSection + installedPackagesSection + sharedConfigSection;
+    const estimatedTokenCount = estimateTokens(allContextText);
+    const budget = getDefaultBudget(this.provider.providerName);
+    if (estimatedTokenCount > budget * 0.7) {
+      console.log(
+        chalk10.yellow(
+          `  \u26A0 Context size: ~${Math.round(estimatedTokenCount / 1e3)}K tokens (budget: ${Math.round(budget / 1e3)}K for ${this.provider.providerName})`
+        )
+      );
+      if (constitutionSection.length > 4e3) {
+        const s9Start = constitutionSection.indexOf("## 9.");
+        if (s9Start > 0) {
+          constitutionSection = constitutionSection.slice(0, s9Start) + "## 9. \u79EF\u7D2F\u6559\u8BAD (Accumulated Lessons)\n[Trimmed for context budget \u2014 run `ai-spec init --consolidate` to prune]\n";
+          console.log(chalk10.gray("    \u2192 \xA79 trimmed from constitution to save tokens."));
+        }
+      }
     }
     const tasks = await loadTasksForSpec(specFilePath);
     if (tasks && tasks.length > 0) {
       return this.runApiModeWithTasks(spec, tasks, specFilePath, workingDir, constitutionSection + dslSection + installedPackagesSection, frontendSection, sharedConfigSection, options, systemPrompt, context);
     }
-    console.log(chalk8.gray("  [1/2] Planning implementation files..."));
+    console.log(chalk10.gray("  [1/2] Planning implementation files..."));
     const planPrompt = `Based on the feature spec and project context below, list ALL files that need to be created or modified.
 
 IMPORTANT: Check the "Existing Shared Config Files" section below FIRST. For any file listed there,
@@ -5993,18 +6248,18 @@ Output ONLY a valid JSON array:
       const planResponse = await this.provider.generate(planPrompt, systemPrompt);
       filePlan = parseJsonArray(planResponse);
     } catch (err) {
-      console.error(chalk8.red("  Failed to generate file plan:"), err);
+      console.error(chalk10.red("  Failed to generate file plan:"), err);
     }
     if (filePlan.length === 0) {
-      console.log(chalk8.yellow("  Could not determine file plan. Falling back to plan mode."));
+      console.log(chalk10.yellow("  Could not determine file plan. Falling back to plan mode."));
       await this.runPlanMode(specFilePath);
       return [];
     }
-    console.log(chalk8.cyan(`
+    console.log(chalk10.cyan(`
   Plan: ${filePlan.length} file(s) to process`));
     filePlan.forEach((item) => {
-      const icon = item.action === "create" ? chalk8.green("+") : chalk8.yellow("~");
-      console.log(`  ${icon} ${item.file}: ${chalk8.gray(item.description)}`);
+      const icon = item.action === "create" ? chalk10.green("+") : chalk10.yellow("~");
+      console.log(`  ${icon} ${item.file}: ${chalk10.gray(item.description)}`);
     });
     const { files } = await this.generateFiles(filePlan, spec, workingDir, constitutionSection + dslSection + frontendSection + installedPackagesSection, systemPrompt);
     return files;
@@ -6013,13 +6268,13 @@ Output ONLY a valid JSON array:
     const pendingTasks = tasks.filter((t) => t.status !== "done");
     const doneCount = tasks.length - pendingTasks.length;
     if (options.resume && doneCount > 0) {
-      console.log(chalk8.cyan(`
-  Task-based generation (resume): ${tasks.length} tasks (${chalk8.green(doneCount + " already done")}, skipping)`));
+      console.log(chalk10.cyan(`
+  Task-based generation (resume): ${tasks.length} tasks (${chalk10.green(doneCount + " already done")}, skipping)`));
     } else if (doneCount > 0) {
-      console.log(chalk8.cyan(`
-  Task-based generation: ${tasks.length} tasks (${chalk8.green(doneCount + " already done")}, resuming from checkpoint)`));
+      console.log(chalk10.cyan(`
+  Task-based generation: ${tasks.length} tasks (${chalk10.green(doneCount + " already done")}, resuming from checkpoint)`));
     } else {
-      console.log(chalk8.cyan(`
+      console.log(chalk10.cyan(`
   Task-based generation: ${tasks.length} tasks`));
     }
     const sharedConfigPaths = new Set(
@@ -6051,9 +6306,9 @@ Output ONLY a valid JSON array:
         const pct = Math.round(completedTasks / tasks.length * 100);
         const barWidth = 20;
         const filled = Math.round(pct / 100 * barWidth);
-        const bar = chalk8.green("\u2588".repeat(filled)) + chalk8.gray("\u2591".repeat(barWidth - filled));
+        const bar = chalk10.green("\u2588".repeat(filled)) + chalk10.gray("\u2591".repeat(barWidth - filled));
         console.log(
-          chalk8.bold(`
+          chalk10.bold(`
   [${bar}] ${pct}% \u26A1 Layer [${layer}] ${layerIcon} \u2014 ${layerTasks.length} tasks running in parallel`)
         );
       } else {
@@ -6061,7 +6316,7 @@ Output ONLY a valid JSON array:
       }
       const executeTask = async (task, batchIsParallel) => {
         if (task.filesToTouch.length === 0) {
-          if (!batchIsParallel) console.log(chalk8.gray("    No files specified, skipping."));
+          if (!batchIsParallel) console.log(chalk10.gray("    No files specified, skipping."));
           return { task, files: [], createdFiles: [], success: 0, total: 0, impliesRegistration: false };
         }
         const filePlan = await Promise.all(
@@ -6118,13 +6373,19 @@ ${taskContext}`,
       const layerResults = [];
       for (const batch of taskBatches) {
         const batchIsParallel = batch.length > 1;
-        const batchResultPromises = batch.map(
-          (task) => executeTask(task, batchIsParallel).catch((err) => {
-            console.log(chalk8.yellow(`  \u26A0 ${task.id} threw unexpectedly: ${err.message}`));
-            return { task, files: [], createdFiles: [], success: 0, total: 0, impliesRegistration: false };
-          })
-        );
-        const batchResults = await Promise.all(batchResultPromises);
+        const batchResultPromises = batch.map((task) => executeTask(task, batchIsParallel));
+        const settled = await Promise.allSettled(batchResultPromises);
+        const batchResults = [];
+        for (let i = 0; i < settled.length; i++) {
+          const outcome = settled[i];
+          if (outcome.status === "fulfilled") {
+            batchResults.push(outcome.value);
+          } else {
+            const task = batch[i];
+            console.log(chalk10.yellow(`  \u26A0 ${task.id} threw unexpectedly: ${outcome.reason?.message ?? outcome.reason}`));
+            batchResults.push({ task, files: [], createdFiles: [], success: 0, total: 0, impliesRegistration: false });
+          }
+        }
         layerResults.push(...batchResults);
         await updateCacheFromBatch(batchResults);
       }
@@ -6136,14 +6397,14 @@ ${taskContext}`,
         totalFiles += result.total;
         allGeneratedFiles.push(...result.files);
         if (isParallel) {
-          const icon = result.success === result.total ? chalk8.green("\u2714") : chalk8.yellow("!");
+          const icon = result.success === result.total ? chalk10.green("\u2714") : chalk10.yellow("!");
           const layerTaskIcon = LAYER_ICONS[result.task.layer] ?? "  ";
           console.log(`  ${icon} ${result.task.id} ${layerTaskIcon} ${result.task.title} \u2014 ${result.success}/${result.total} files`);
         }
         const taskStatus = result.success === result.total ? "done" : "failed";
         await updateTaskStatus(specFilePath, result.task.id, taskStatus);
         if (taskStatus === "failed") {
-          console.log(chalk8.yellow(`  \u26A0 ${result.task.id} marked as failed \u2014 re-run with --resume to retry`));
+          console.log(chalk10.yellow(`  \u26A0 ${result.task.id} marked as failed \u2014 re-run with --resume to retry`));
         }
       }
       completedTasks += layerTasks.length;
@@ -6158,7 +6419,7 @@ ${taskContext}`,
           if ((sharedFile.category === "route-index" || sharedFile.category === "store-index") && newModuleNames.length > 0) {
             purpose = `Add to this file: import ${newModuleNames.join(", ")} from their respective paths and register them in the export/default array. Do NOT remove any existing imports.`;
           }
-          console.log(chalk8.gray(`
+          console.log(chalk10.gray(`
     + updating shared config: ${sharedFile.path} [${sharedFile.category}]`));
           const updatedGeneratedFilesSection = buildGeneratedFilesSection(generatedFileCache);
           await this.generateFiles(
@@ -6176,17 +6437,17 @@ Updating shared registration after layer [${layer}] completed. New modules: ${ne
       }
     }
     console.log(
-      chalk8.bold(
+      chalk10.bold(
         `
-  ${totalSuccess === totalFiles ? chalk8.green("\u2714") : chalk8.yellow("!")} Task-based generation: ${totalSuccess}/${totalFiles} files written across ${pendingTasks.length} tasks.`
+  ${totalSuccess === totalFiles ? chalk10.green("\u2714") : chalk10.yellow("!")} Task-based generation: ${totalSuccess}/${totalFiles} files written across ${pendingTasks.length} tasks.`
       )
     );
     return allGeneratedFiles;
   }
   async generateFiles(filePlan, spec, workingDir, constitutionSection, systemPrompt = getCodeGenSystemPrompt(), taskLabel) {
-    const prefix = taskLabel ? `  [${chalk8.cyan(taskLabel)}] ` : "  ";
+    const prefix = taskLabel ? `  [${chalk10.cyan(taskLabel)}] ` : "  ";
     if (!taskLabel) {
-      console.log(chalk8.gray(`
+      console.log(chalk10.gray(`
   Generating ${filePlan.length} file(s)...`));
     }
     let successCount = 0;
@@ -6207,6 +6468,7 @@ ${spec}
 ${constitutionSection}
 === ${existingContent ? "Existing content (modify and return the complete file)" : "Create this file from scratch"} ===
 ${existingContent || "Output only the complete file content."}`;
+      const fileSpinner = startSpinner(`${prefix}Generating ${chalk10.bold(item.file)}...`);
       try {
         const raw = await this.provider.generate(codePrompt, systemPrompt);
         const fileContent = stripCodeFences(raw);
@@ -6214,17 +6476,17 @@ ${existingContent || "Output only the complete file content."}`;
         await fs10.ensureDir(path6.dirname(fullPath));
         await fs10.writeFile(fullPath, fileContent, "utf-8");
         getActiveLogger()?.fileWritten(item.file);
-        console.log(`${prefix}${existingContent ? chalk8.yellow("~") : chalk8.green("+")} ${chalk8.bold(item.file)} ${chalk8.green("\u2714")}`);
+        fileSpinner.succeed(`${existingContent ? chalk10.yellow("~") : chalk10.green("+")} ${chalk10.bold(item.file)}`);
         successCount++;
         writtenFiles.push(item.file);
       } catch (err) {
-        console.log(`${prefix}${chalk8.red("\u2718")} ${chalk8.bold(item.file)} \u2014 ${chalk8.red(err.message)}`);
+        fileSpinner.fail(`${chalk10.bold(item.file)} \u2014 ${err.message}`);
       }
     }
     if (!taskLabel) {
       console.log(
-        chalk8.bold(
-          `  ${successCount === filePlan.length ? chalk8.green("\u2714") : chalk8.yellow("!")} ${successCount}/${filePlan.length} files written.`
+        chalk10.bold(
+          `  ${successCount === filePlan.length ? chalk10.green("\u2714") : chalk10.yellow("!")} ${successCount}/${filePlan.length} files written.`
         )
       );
     }
@@ -6232,7 +6494,7 @@ ${existingContent || "Output only the complete file content."}`;
   }
   // ── Mode: plan ─────────────────────────────────────────────────────────────
   async runPlanMode(specFilePath) {
-    console.log(chalk8.blue("\n\u2500\u2500\u2500 Implementation Plan \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(chalk10.blue("\n\u2500\u2500\u2500 Implementation Plan \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 spec = await fs10.readFile(specFilePath, "utf-8");
     const plan = await this.provider.generate(
       `Create a detailed, step-by-step implementation plan for the following feature spec.
@@ -6245,80 +6507,18 @@ Be specific about:
 ${spec}`,
       "You are a senior developer creating an actionable implementation guide."
     );
-    console.log(chalk8.cyan("\n") + plan);
-  }
-};
-function topoSortLayerTasks(tasks) {
-  if (tasks.length <= 1) return [tasks];
-  const idSet = new Set(tasks.map((t) => t.id));
-  const taskById = new Map(tasks.map((t) => [t.id, t]));
-  const inDegree = /* @__PURE__ */ new Map();
-  const dependents = /* @__PURE__ */ new Map();
-  for (const task of tasks) {
-    inDegree.set(task.id, 0);
-    dependents.set(task.id, []);
-  }
-  for (const task of tasks) {
-    const intraDeps = task.dependencies.filter((dep) => idSet.has(dep));
-    inDegree.set(task.id, intraDeps.length);
-    for (const dep of intraDeps) {
-      dependents.get(dep).push(task.id);
-    }
+    console.log(chalk10.cyan("\n") + plan);
   }
-  const batches = [];
-  const remaining = new Set(tasks.map((t) => t.id));
-  while (remaining.size > 0) {
-    const batch = [...remaining].filter((id) => inDegree.get(id) === 0).map((id) => taskById.get(id));
-    if (batch.length === 0) {
-      batches.push([...remaining].map((id) => taskById.get(id)));
-      break;
-    }
-    batches.push(batch);
-    for (const task of batch) {
-      remaining.delete(task.id);
-      for (const dependent of dependents.get(task.id)) {
-        inDegree.set(dependent, inDegree.get(dependent) - 1);
-      }
-    }
-  }
-  return batches;
-}
-var LAYER_ICONS = {
-  data: "\u{1F4BE}",
-  infra: "\u2699\uFE0F ",
-  service: "\u{1F527}",
-  api: "\u{1F310}",
-  view: "\u{1F5A5}\uFE0F ",
-  route: "\u{1F5FA}\uFE0F ",
-  test: "\u{1F9EA}"
 };
-function printTaskProgress(completed, total, task, mode) {
-  const pct = total > 0 ? Math.round(completed / total * 100) : 0;
-  const barWidth = 20;
-  const filled = Math.round(pct / 100 * barWidth);
-  const bar = chalk8.green("\u2588".repeat(filled)) + chalk8.gray("\u2591".repeat(barWidth - filled));
-  const icon = LAYER_ICONS[task.layer] ?? "  ";
-  if (mode === "skip") {
-    console.log(
-      chalk8.gray(`
-  [${bar}] ${pct}% \u2713 ${task.id} ${icon} ${task.title} \u2014 already done`)
-    );
-  } else {
-    console.log(
-      chalk8.bold(`
-  [${bar}] ${pct}% \u2192 ${task.id} ${icon} ${task.title}`)
-    );
-  }
-}
 
 // core/reviewer.ts
-import chalk10 from "chalk";
-import { execSync as execSync2 } from "child_process";
+import chalk12 from "chalk";
+import { execSync as execSync3 } from "child_process";
 import * as path8 from "path";
 import * as fs12 from "fs-extra";
 
 // core/constitution-generator.ts
-import chalk9 from "chalk";
+import chalk11 from "chalk";
 import * as fs11 from "fs-extra";
 import * as path7 from "path";
 
@@ -6468,7 +6668,7 @@ async function loadConstitution(projectRoot) {
 function printConstitutionHint(exists) {
   if (!exists) {
     console.log(
-      chalk9.yellow(
+      chalk11.yellow(
         "  \u26A1 Tip: Run `ai-spec init` to generate a Project Constitution for better spec quality."
       )
     );
@@ -6552,16 +6752,16 @@ var CodeReviewer = class {
     this.projectRoot = projectRoot;
   }
   getGitDiff() {
-    const silent = { encoding: "utf-8", stdio: "pipe" };
+    const silent = { encoding: "utf-8", stdio: "pipe", cwd: this.projectRoot, timeout: 3e4 };
     try {
-      execSync2("git rev-parse --is-inside-work-tree", silent);
+      execSync3("git rev-parse --is-inside-work-tree", silent);
     } catch {
       return "";
     }
     try {
-      let diff = execSync2("git diff --cached", silent);
-      if (!diff.trim()) diff = execSync2("git diff HEAD", silent);
-      if (!diff.trim()) diff = execSync2("git diff", silent);
+      let diff = execSync3("git diff --cached", silent);
+      if (!diff.trim()) diff = execSync3("git diff HEAD", silent);
+      if (!diff.trim()) diff = execSync3("git diff", silent);
       return diff;
     } catch {
       return "";
@@ -6586,7 +6786,7 @@ var CodeReviewer = class {
   async runThreePassReview(specContent, codeContext, specFile) {
     let complianceReview = "";
     if (specContent && specContent.trim() && specContent !== "(No spec \u2014 review for general code quality)") {
-      console.log(chalk10.gray("  Pass 0/3: Spec compliance check..."));
+      console.log(chalk12.gray("  Pass 0/3: Spec compliance check..."));
       const compliancePrompt = `Check whether the implementation covers every requirement in the spec.
 
 === Feature Spec ===
@@ -6598,13 +6798,13 @@ ${codeContext}`;
       const complianceScore2 = extractComplianceScore(complianceReview);
       const missingCount = extractMissingCount(complianceReview);
       if (complianceScore2 > 0) {
-        const scoreColor = complianceScore2 >= 8 ? chalk10.green : complianceScore2 >= 6 ? chalk10.yellow : chalk10.red;
+        const scoreColor = complianceScore2 >= 8 ? chalk12.green : complianceScore2 >= 6 ? chalk12.yellow : chalk12.red;
         console.log(
-          chalk10.gray("  Pass 0 result: ") + scoreColor(`ComplianceScore ${complianceScore2}/10`) + (missingCount > 0 ? chalk10.red(` \xB7 ${missingCount} missing requirement(s)`) : chalk10.green(" \xB7 all requirements covered"))
+          chalk12.gray("  Pass 0 result: ") + scoreColor(`ComplianceScore ${complianceScore2}/10`) + (missingCount > 0 ? chalk12.red(` \xB7 ${missingCount} missing requirement(s)`) : chalk12.green(" \xB7 all requirements covered"))
         );
       }
     }
-    console.log(chalk10.gray(`  Pass 1/3: Architecture review...`));
+    console.log(chalk12.gray(`  Pass 1/3: Architecture review...`));
     const accumulatedLessons = await loadAccumulatedLessons(this.projectRoot);
     const archPrompt = `Review the architecture of this change.
 ${complianceReview ? `
@@ -6621,7 +6821,7 @@ ${specContent || "(No spec \u2014 review for general code quality)"}
 === Code ===
 ${codeContext}`;
     const archReview = await this.provider.generate(archPrompt, reviewArchitectureSystemPrompt);
-    console.log(chalk10.gray("  Pass 2/3: Implementation review..."));
+    console.log(chalk12.gray("  Pass 2/3: Implementation review..."));
     const history = await loadReviewHistory(this.projectRoot);
     const historyContext = buildHistoryContext(history);
     const implPrompt = `Review the implementation details of this change.
@@ -6636,7 +6836,7 @@ ${codeContext}
 ${archReview}
 ${historyContext}`;
     const implReview = await this.provider.generate(implPrompt, reviewImplementationSystemPrompt);
-    console.log(chalk10.gray("  Pass 3/3: Impact & complexity assessment..."));
+    console.log(chalk12.gray("  Pass 3/3: Impact & complexity assessment..."));
     const impactPrompt = `Assess the impact and complexity of this change.
 
 === Feature Spec ===
@@ -6677,37 +6877,37 @@ ${sep}
     return combined;
   }
   async reviewCode(specContent, specFile) {
-    console.log(chalk10.cyan("\n\u2500\u2500\u2500 Automated Code Review \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(chalk12.cyan("\n\u2500\u2500\u2500 Automated Code Review \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     const diff = this.getGitDiff();
     if (!diff.trim()) {
       console.log(
-        chalk10.yellow("  No git diff found. Stage or commit changes first, then run review.")
+        chalk12.yellow("  No git diff found. Stage or commit changes first, then run review.")
       );
-      console.log(chalk10.gray("  Tip: run `git add .` then `ai-spec review` to review your work."));
+      console.log(chalk12.gray("  Tip: run `git add .` then `ai-spec review` to review your work."));
       return "No changes";
     }
     const { files, added, removed } = this.getDiffStats(diff);
     console.log(
-      chalk10.gray(`  Diff: ${files} file(s), ${chalk10.green("+" + added)} ${chalk10.red("-" + removed)}`)
+      chalk12.gray(`  Diff: ${files} file(s), ${chalk12.green("+" + added)} ${chalk12.red("-" + removed)}`)
     );
     console.log(
-      chalk10.blue(`  Reviewing with ${this.provider.providerName}/${this.provider.modelName}...`)
+      chalk12.blue(`  Reviewing with ${this.provider.providerName}/${this.provider.modelName}...`)
     );
     const codeContext = diff.slice(0, 1e4);
     const reviewResult = await this.runThreePassReview(specContent, codeContext, specFile);
-    console.log(chalk10.cyan("\n\u2500\u2500\u2500 Review Result \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(chalk12.cyan("\n\u2500\u2500\u2500 Review Result \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(reviewResult);
-    console.log(chalk10.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\u2500\u2500\u2500\u2500\u2500\n"));
+    console.log(chalk12.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\u2500\u2500\u2500\u2500\u2500\n"));
     return reviewResult;
   }
   /**
    * Review directly from generated file contents (for api mode where git diff is empty).
    */
   async reviewFiles(specContent, filePaths, workingDir, specFile) {
-    console.log(chalk10.cyan("\n\u2500\u2500\u2500 Automated Code Review (file-based) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-    console.log(chalk10.gray(`  Reviewing ${filePaths.length} generated file(s)...`));
+    console.log(chalk12.cyan("\n\u2500\u2500\u2500 Automated Code Review (file-based) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk12.gray(`  Reviewing ${filePaths.length} generated file(s)...`));
     console.log(
-      chalk10.blue(`  Reviewing with ${this.provider.providerName}/${this.provider.modelName}...`)
+      chalk12.blue(`  Reviewing with ${this.provider.providerName}/${this.provider.modelName}...`)
     );
     let filesSection = "";
     for (const filePath of filePaths) {
@@ -6728,28 +6928,28 @@ ${content.slice(0, 3e3)}`;
       }
     }
     const reviewResult = await this.runThreePassReview(specContent, filesSection, specFile);
-    console.log(chalk10.cyan("\n\u2500\u2500\u2500 Review Result \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(chalk12.cyan("\n\u2500\u2500\u2500 Review Result \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(reviewResult);
-    console.log(chalk10.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\u2500\u2500\u2500\u2500\u2500\n"));
+    console.log(chalk12.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\u2500\u2500\u2500\u2500\u2500\n"));
     return reviewResult;
   }
   /** Print score trend from history (last N reviews) */
   async printScoreTrend(limit = 5) {
     const history = await loadReviewHistory(this.projectRoot);
     if (history.length === 0) {
-      console.log(chalk10.gray("  No review history yet."));
+      console.log(chalk12.gray("  No review history yet."));
       return;
     }
     const recent = history.slice(-limit);
-    console.log(chalk10.cyan("\n\u2500\u2500\u2500 Review Score 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"));
+    console.log(chalk12.cyan("\n\u2500\u2500\u2500 Review Score 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"));
     for (const entry of recent) {
       const bar = "\u2588".repeat(entry.score) + "\u2591".repeat(10 - entry.score);
-      const color = entry.score >= 8 ? chalk10.green : entry.score >= 6 ? chalk10.yellow : chalk10.red;
-      const impactTag = entry.impactLevel ? chalk10.gray(` \u5F71\u54CD:${entry.impactLevel === "\u9AD8" ? chalk10.red(entry.impactLevel) : entry.impactLevel === "\u4E2D" ? chalk10.yellow(entry.impactLevel) : chalk10.green(entry.impactLevel)}`) : "";
-      const complexityTag = entry.complexityLevel ? chalk10.gray(` \u590D\u6742\u5EA6:${entry.complexityLevel === "\u9AD8" ? chalk10.red(entry.complexityLevel) : entry.complexityLevel === "\u4E2D" ? chalk10.yellow(entry.complexityLevel) : chalk10.green(entry.complexityLevel)}`) : "";
+      const color = entry.score >= 8 ? chalk12.green : entry.score >= 6 ? chalk12.yellow : chalk12.red;
+      const impactTag = entry.impactLevel ? chalk12.gray(` \u5F71\u54CD:${entry.impactLevel === "\u9AD8" ? chalk12.red(entry.impactLevel) : entry.impactLevel === "\u4E2D" ? chalk12.yellow(entry.impactLevel) : chalk12.green(entry.impactLevel)}`) : "";
+      const complexityTag = entry.complexityLevel ? chalk12.gray(` \u590D\u6742\u5EA6:${entry.complexityLevel === "\u9AD8" ? chalk12.red(entry.complexityLevel) : entry.complexityLevel === "\u4E2D" ? chalk12.yellow(entry.complexityLevel) : chalk12.green(entry.complexityLevel)}`) : "";
       console.log(`  ${entry.date}  [${color(bar)}] ${color(entry.score + "/10")}${impactTag}${complexityTag}  ${path8.basename(entry.specFile)}`);
     }
-    console.log(chalk10.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\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk12.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\u2500\u2500\u2500\u2500\u2500"));
   }
 };
 
@@ -6799,17 +6999,17 @@ function parseSpecAndTasks(raw) {
 }
 
 // git/worktree.ts
-import { execSync as execSync3 } from "child_process";
+import { execSync as execSync4 } from "child_process";
 import * as path9 from "path";
 import * as fs13 from "fs-extra";
-import chalk11 from "chalk";
+import chalk13 from "chalk";
 var GitWorktreeManager = class {
   constructor(baseDir) {
     this.baseDir = baseDir;
   }
   isGitRepo() {
     try {
-      execSync3("git rev-parse --is-inside-work-tree", { cwd: this.baseDir, stdio: "ignore" });
+      execSync4("git rev-parse --is-inside-work-tree", { cwd: this.baseDir, stdio: "ignore" });
       return true;
     } catch {
       return false;
@@ -6833,58 +7033,58 @@ var GitWorktreeManager = class {
       if (await fs13.pathExists(dest)) continue;
       try {
         await fs13.ensureSymlink(src, dest, "dir");
-        console.log(chalk11.gray(`  Symlinked ${dir}/ from base repo \u2192 worktree`));
+        console.log(chalk13.gray(`  Symlinked ${dir}/ from base repo \u2192 worktree`));
       } catch (err) {
-        console.log(chalk11.yellow(`  \u26A0 Could not symlink ${dir}/: ${err.message}`));
-        console.log(chalk11.yellow(`    Run \`npm install\` inside the worktree manually.`));
+        console.log(chalk13.yellow(`  \u26A0 Could not symlink ${dir}/: ${err.message}`));
+        console.log(chalk13.yellow(`    Run \`npm install\` inside the worktree manually.`));
       }
     }
   }
   async createWorktree(idea) {
     if (!this.isGitRepo()) {
-      console.log(chalk11.yellow("\u26A0\uFE0F Not a git repository. Skipping worktree creation."));
+      console.log(chalk13.yellow("\u26A0\uFE0F Not a git repository. Skipping worktree creation."));
       return null;
     }
     const featureName = this.sanitizeFeatureName(idea);
     const branchName = `feature/${featureName}`;
     const repoName = path9.basename(this.baseDir);
     const worktreePath = path9.resolve(this.baseDir, "..", `${repoName}-${featureName}`);
-    console.log(chalk11.cyan(`
+    console.log(chalk13.cyan(`
 --- Setting up Git Worktree ---`));
     if (await fs13.pathExists(worktreePath)) {
-      console.log(chalk11.yellow(`\u26A0\uFE0F Worktree directory already exists at: ${worktreePath}`));
+      console.log(chalk13.yellow(`\u26A0\uFE0F Worktree directory already exists at: ${worktreePath}`));
       await this.linkDependencies(worktreePath);
       return worktreePath;
     }
     try {
       let branchExists = false;
       try {
-        execSync3(`git show-ref --verify refs/heads/${branchName}`, {
+        execSync4(`git show-ref --verify refs/heads/${branchName}`, {
           cwd: this.baseDir,
           stdio: "ignore"
         });
         branchExists = true;
       } catch {
       }
-      console.log(chalk11.gray(`Creating worktree at: ${worktreePath}`));
+      console.log(chalk13.gray(`Creating worktree at: ${worktreePath}`));
       if (branchExists) {
-        execSync3(`git worktree add "${worktreePath}" ${branchName}`, {
+        execSync4(`git worktree add "${worktreePath}" ${branchName}`, {
           cwd: this.baseDir,
           stdio: "inherit"
         });
       } else {
-        execSync3(`git worktree add -b ${branchName} "${worktreePath}"`, {
+        execSync4(`git worktree add -b ${branchName} "${worktreePath}"`, {
           cwd: this.baseDir,
           stdio: "inherit"
         });
       }
       console.log(
-        chalk11.green(`\u2714 Worktree successfully created and isolated on branch '${branchName}'`)
+        chalk13.green(`\u2714 Worktree successfully created and isolated on branch '${branchName}'`)
       );
       await this.linkDependencies(worktreePath);
       return worktreePath;
     } catch (error) {
-      console.error(chalk11.red("Failed to create git worktree:"), error);
+      console.error(chalk13.red("Failed to create git worktree:"), error);
       return null;
     }
   }