ai-spec-dev 0.24.0 → 0.28.1

package/dist/index.mjs

@@ -109,6 +109,67 @@ model ExampleModel {
 
 \u6839\u636E\u7528\u6237\u7684\u60F3\u6CD5\u548C\u9879\u76EE\u4E0A\u4E0B\u6587\u751F\u6210\u4E0A\u8FF0\u5B8C\u6574 Spec\u3002\u786E\u4FDD API \u8BBE\u8BA1\u4E0E\u73B0\u6709\u9879\u76EE\u7684\u8DEF\u7531\u98CE\u683C\u3001\u9519\u8BEF\u7801\u89C4\u8303\u4FDD\u6301\u4E00\u81F4\uFF0C\u6570\u636E\u6A21\u578B\u4E0E\u73B0\u6709 Prisma Schema \u534F\u8C03\u3002`;
 
+// core/provider-utils.ts
+import chalk from "chalk";
+var sleep = (ms2) => new Promise((r) => setTimeout(r, ms2));
+var ProviderError = class extends Error {
+  constructor(message, kind, originalError) {
+    super(message);
+    this.kind = kind;
+    this.originalError = originalError;
+    this.name = "ProviderError";
+  }
+};
+function classifyError(err, label) {
+  const e = err;
+  const status = e.status ?? e.response?.status;
+  if (status === 401 || status === 403)
+    return new ProviderError(`Auth error \u2014 check your API key (${label})`, "auth", err);
+  if (status === 429)
+    return new ProviderError(`Rate limit hit (${label}) \u2014 try again later or switch provider`, "rate_limit", err);
+  if (e._timeout || e.message?.toLowerCase().includes("timed out"))
+    return new ProviderError(`Request timed out (${label})`, "timeout", err);
+  if (e.code === "ECONNRESET" || e.code === "ENOTFOUND" || e.code === "ECONNREFUSED")
+    return new ProviderError(`Network error \u2014 check connection/proxy (${label}): ${e.message}`, "network", err);
+  return new ProviderError(`Provider error (${label}): ${e.message}`, "provider", err);
+}
+function isRetryable(err) {
+  const e = err;
+  const status = e.status ?? e.response?.status;
+  if (status === 401 || status === 403) return false;
+  if (status === 429 || status !== void 0 && status >= 500) return true;
+  if (e.code === "ECONNRESET" || e.code === "ENOTFOUND" || e.code === "ECONNREFUSED") return true;
+  if (e.message?.toLowerCase().includes("timed out")) return true;
+  return true;
+}
+async function withReliability(fn, opts) {
+  const { retries = 2, timeoutMs = 9e4, label = "AI call", onRetry } = opts ?? {};
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      return await Promise.race([
+        fn(),
+        new Promise(
+          (_2, reject) => setTimeout(
+            () => reject(Object.assign(new Error(`timed out after ${timeoutMs / 1e3}s`), { _timeout: true })),
+            timeoutMs
+          )
+        )
+      ]);
+    } catch (err) {
+      if (!isRetryable(err) || attempt === retries) {
+        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);
+    }
+  }
+  throw new Error("unreachable");
+}
+
 // core/spec-generator.ts
 function geminiRequestOptions() {
   const proxyUrl = process.env.GEMINI_PROXY || process.env.HTTPS_PROXY || process.env.https_proxy || process.env.HTTP_PROXY || process.env.http_proxy;
@@ -254,12 +315,17 @@ var GeminiProvider = class {
     this.modelName = modelName;
   }
   async generate(prompt, systemInstruction) {
-    const model = this.genAI.getGenerativeModel(
-      { model: this.modelName, ...systemInstruction ? { systemInstruction } : {} },
-      geminiRequestOptions()
+    return withReliability(
+      async () => {
+        const model = this.genAI.getGenerativeModel(
+          { model: this.modelName, ...systemInstruction ? { systemInstruction } : {} },
+          geminiRequestOptions()
+        );
+        const result = await model.generateContent(prompt);
+        return result.response.text();
+      },
+      { label: `${this.providerName}/${this.modelName}` }
     );
-    const result = await model.generateContent(prompt);
-    return result.response.text();
   }
 };
 var ClaudeProvider = class {
@@ -271,15 +337,20 @@ var ClaudeProvider = class {
     this.modelName = modelName;
   }
   async generate(prompt, systemInstruction) {
-    const message = await this.client.messages.create({
-      model: this.modelName,
-      max_tokens: 8192,
-      ...systemInstruction ? { system: systemInstruction } : {},
-      messages: [{ role: "user", content: prompt }]
-    });
-    const block = message.content[0];
-    if (block.type === "text") return block.text;
-    throw new Error("Unexpected response type from Claude API");
+    return withReliability(
+      async () => {
+        const message = await this.client.messages.create({
+          model: this.modelName,
+          max_tokens: 8192,
+          ...systemInstruction ? { system: systemInstruction } : {},
+          messages: [{ role: "user", content: prompt }]
+        });
+        const block = message.content[0];
+        if (block.type === "text") return block.text;
+        throw new Error("Unexpected response type from Claude API");
+      },
+      { label: `${this.providerName}/${this.modelName}` }
+    );
   }
 };
 var OpenAICompatibleProvider = class {
@@ -299,19 +370,24 @@ var OpenAICompatibleProvider = class {
     });
   }
   async generate(prompt, systemInstruction) {
-    const messages = [];
-    if (systemInstruction) {
-      const isOSeries = /^o[13]/.test(this.modelName);
-      const role = isOSeries ? "developer" : this.systemRole;
-      messages.push({ role, content: systemInstruction });
-    }
-    messages.push({ role: "user", content: prompt });
-    const completion = await this.client.chat.completions.create({
-      model: this.modelName,
-      messages,
-      ...this.extraBody ? { extra_body: this.extraBody } : {}
-    });
-    return completion.choices[0].message.content ?? "";
+    return withReliability(
+      async () => {
+        const messages = [];
+        if (systemInstruction) {
+          const isOSeries = /^o[13]/.test(this.modelName);
+          const role = isOSeries ? "developer" : this.systemRole;
+          messages.push({ role, content: systemInstruction });
+        }
+        messages.push({ role: "user", content: prompt });
+        const completion = await this.client.chat.completions.create({
+          model: this.modelName,
+          messages,
+          ...this.extraBody ? { extra_body: this.extraBody } : {}
+        });
+        return completion.choices[0].message.content ?? "";
+      },
+      { label: `${this.providerName}/${this.modelName}` }
+    );
   }
 };
 var MiMoProvider = class {
@@ -324,32 +400,37 @@ var MiMoProvider = class {
     this.modelName = modelName;
   }
   async generate(prompt, systemInstruction) {
-    const body = {
-      model: this.modelName,
-      max_tokens: 16384,
-      messages: [{ role: "user", content: [{ type: "text", text: prompt }] }],
-      top_p: 0.95,
-      stream: false,
-      temperature: 1,
-      stop_sequences: null
-    };
-    if (systemInstruction) {
-      body.system = systemInstruction;
-    }
-    const response = await axios.post(this.baseUrl, body, {
-      headers: {
-        "api-key": this.apiKey,
-        "Content-Type": "application/json"
-      }
-    });
-    const data = response.data;
-    const blocks = data?.content ?? [];
-    const textBlock = blocks.find((b) => b.type === "text");
-    if (textBlock?.text) return textBlock.text;
-    if (data?.stop_reason === "max_tokens") {
-      throw new Error(`MiMo response truncated (max_tokens reached). The prompt may be too long. Try a shorter spec or switch to a model with larger context.`);
-    }
-    throw new Error(`Unexpected MiMo response: ${JSON.stringify(response.data).slice(0, 200)}`);
+    return withReliability(
+      async () => {
+        const body = {
+          model: this.modelName,
+          max_tokens: 16384,
+          messages: [{ role: "user", content: [{ type: "text", text: prompt }] }],
+          top_p: 0.95,
+          stream: false,
+          temperature: 1,
+          stop_sequences: null
+        };
+        if (systemInstruction) {
+          body.system = systemInstruction;
+        }
+        const response = await axios.post(this.baseUrl, body, {
+          headers: {
+            "api-key": this.apiKey,
+            "Content-Type": "application/json"
+          }
+        });
+        const data = response.data;
+        const blocks = data?.content ?? [];
+        const textBlock = blocks.find((b) => b.type === "text");
+        if (textBlock?.text) return textBlock.text;
+        if (data?.stop_reason === "max_tokens") {
+          throw new Error(`MiMo response truncated (max_tokens reached). The prompt may be too long. Try a shorter spec or switch to a model with larger context.`);
+        }
+        throw new Error(`Unexpected MiMo response: ${JSON.stringify(response.data).slice(0, 200)}`);
+      },
+      { label: `${this.providerName}/${this.modelName}` }
+    );
   }
 };
 function createProvider(providerName, apiKey, modelName) {
@@ -3805,10 +3886,10 @@ ${preview}
 
 // core/spec-refiner.ts
 import { editor, confirm, select } from "@inquirer/prompts";
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 
 // core/spec-versioning.ts
-import chalk from "chalk";
+import chalk2 from "chalk";
 import * as fs4 from "fs-extra";
 function computeDiff(oldText, newText) {
   const oldLines = oldText.split("\n");
@@ -3859,7 +3940,7 @@ function computeSimpleDiff(oldLines, newLines) {
 var CONTEXT_LINES = 3;
 function printDiff(diff) {
   if (diff.added === 0 && diff.removed === 0) {
-    console.log(chalk.gray("  (no changes)"));
+    console.log(chalk2.gray("  (no changes)"));
     return;
   }
   const { lines } = diff;
@@ -3876,25 +3957,25 @@ function printDiff(diff) {
   let prevIdx = -2;
   for (const idx of sorted) {
     if (idx > prevIdx + 1 && prevIdx !== -2) {
-      console.log(chalk.cyan("  @@"));
+      console.log(chalk2.cyan("  @@"));
     }
     const l = lines[idx];
     if (l.type === "added") {
-      console.log(chalk.green(`  + ${l.content}`));
+      console.log(chalk2.green(`  + ${l.content}`));
     } else if (l.type === "removed") {
-      console.log(chalk.red(`  - ${l.content}`));
+      console.log(chalk2.red(`  - ${l.content}`));
     } else {
-      console.log(chalk.gray(`    ${l.content}`));
+      console.log(chalk2.gray(`    ${l.content}`));
     }
     prevIdx = idx;
   }
 }
 function printDiffSummary(diff, label) {
   const parts = [];
-  if (diff.added > 0) parts.push(chalk.green(`+${diff.added}`));
-  if (diff.removed > 0) parts.push(chalk.red(`-${diff.removed}`));
-  if (parts.length === 0) parts.push(chalk.gray("no change"));
-  console.log(chalk.bold(`  ${label}: `) + parts.join("  ") + chalk.gray(` lines`));
+  if (diff.added > 0) parts.push(chalk2.green(`+${diff.added}`));
+  if (diff.removed > 0) parts.push(chalk2.red(`-${diff.removed}`));
+  if (parts.length === 0) parts.push(chalk2.gray("no change"));
+  console.log(chalk2.bold(`  ${label}: `) + parts.join("  ") + chalk2.gray(` lines`));
 }
 
 // core/spec-refiner.ts
@@ -3906,16 +3987,16 @@ var SpecRefiner = class {
     let currentSpec = initialSpec;
     let round = 1;
     while (true) {
-      console.log(chalk2.cyan(`
+      console.log(chalk3.cyan(`
 \u2500\u2500\u2500 Spec Review (Round ${round}) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`));
-      console.log(chalk2.gray("  Opening spec in editor. Save and close to continue."));
+      console.log(chalk3.gray("  Opening spec in editor. Save and close to continue."));
       currentSpec = await editor({
         message: "Review and edit the spec:",
         default: currentSpec,
         postfix: ".md",
         waitForUserInput: false
       });
-      console.log(chalk2.green("  \u2714 Spec saved."));
+      console.log(chalk3.green("  \u2714 Spec saved."));
       const action = await select({
         message: "What would you like to do?",
         choices: [
@@ -3928,7 +4009,7 @@ var SpecRefiner = class {
         break;
       }
       if (action === "ai") {
-        console.log(chalk2.blue(`  AI (${this.provider.providerName}/${this.provider.modelName}) is polishing the spec...`));
+        console.log(chalk3.blue(`  AI (${this.provider.providerName}/${this.provider.modelName}) is polishing the spec...`));
         try {
           const improved = await this.provider.generate(
             `Review the following feature spec and improve it for clarity, completeness, and technical feasibility.
@@ -3938,30 +4019,30 @@ Output ONLY the improved markdown spec, nothing else.
 ${currentSpec}`,
             "You are a Senior Tech Lead doing a spec review. Output only the improved Markdown."
           );
-          console.log(chalk2.yellow("\n  AI has suggested improvements. Opening diff in editor..."));
+          console.log(chalk3.yellow("\n  AI has suggested improvements. Opening diff in editor..."));
           const acceptImproved = await confirm({
             message: "Accept AI improvements? (opens editor so you can review first)",
             default: true
           });
           if (acceptImproved) {
             const diff = computeDiff(currentSpec, improved);
-            console.log(chalk2.cyan("\n  \u2500\u2500 AI Changes \u2500\u2500\u2500\u2500\u2500\u2500\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(chalk3.cyan("\n  \u2500\u2500 AI Changes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
             printDiffSummary(diff, "AI edits");
             printDiff(diff);
-            console.log(chalk2.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\n"));
+            console.log(chalk3.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\n"));
             currentSpec = await editor({
               message: "Review AI-improved spec (edit if needed, then save):",
               default: improved,
               postfix: ".md",
               waitForUserInput: false
             });
-            console.log(chalk2.green("  \u2714 AI-improved spec accepted."));
+            console.log(chalk3.green("  \u2714 AI-improved spec accepted."));
           } else {
-            console.log(chalk2.gray("  AI improvements discarded. Keeping your version."));
+            console.log(chalk3.gray("  AI improvements discarded. Keeping your version."));
           }
         } catch (err) {
-          console.error(chalk2.red("  AI improvement failed:"), err);
-          console.log(chalk2.gray("  Continuing with current spec."));
+          console.error(chalk3.red("  AI improvement failed:"), err);
+          console.log(chalk3.gray("  Continuing with current spec."));
         }
       }
       round++;
@@ -3971,10 +4052,10 @@ ${currentSpec}`,
 };
 
 // core/code-generator.ts
-import chalk6 from "chalk";
+import chalk8 from "chalk";
 import { execSync } from "child_process";
 import * as path6 from "path";
-import * as fs8 from "fs-extra";
+import * as fs10 from "fs-extra";
 
 // prompts/codegen.prompt.ts
 var codeGenSystemPrompt = `You are a Senior Full-Stack Developer implementing features based on provided specifications.
@@ -4199,9 +4280,51 @@ Actionable, concrete improvements.
 Score: X/10 \u2014 Combined architecture + implementation assessment in one paragraph.
 
 Be specific. Reference actual code, not vague principles.`;
+var reviewImpactComplexitySystemPrompt = `You are a Senior Staff Engineer assessing the RISK and MAINTAINABILITY of a code change.
+
+Two previous review passes have already covered architecture compliance and implementation correctness. Do NOT repeat their findings.
+
+Your job is to answer exactly two questions:
+
+---
+
+## \u{1F30A} \u5F71\u54CD\u9762\u8BC4\u4F30 (Impact Assessment)
+
+Evaluate what this change touches beyond its own files:
+
+1. **\u76F4\u63A5\u5F71\u54CD\u6587\u4EF6** \u2014 List the files created or modified.
+2. **\u95F4\u63A5\u5F71\u54CD\u8303\u56F4** \u2014 Which existing modules, API consumers, or downstream services will be affected? (e.g., shared utilities modified, public interfaces changed, database schema altered)
+3. **\u7834\u574F\u6027\u53D8\u66F4 (Breaking Changes)** \u2014 Are there changes requiring coordinated updates elsewhere?
+   - API endpoint signature changes (path, method, required params)
+   - Database schema changes (renamed columns, dropped fields, new NOT NULL constraints)
+   - Config / env variable changes
+   - Exported function/type renames
+   - If none: state "\u65E0\u7834\u574F\u6027\u53D8\u66F4"
+4. **\u5F71\u54CD\u7B49\u7EA7** \u2014 Rate as \u4F4E / \u4E2D / \u9AD8 with one sentence justification.
+   - \u4F4E: isolated to new files, no shared interface changes
+   - \u4E2D: modifies shared utilities or existing public interfaces, backwards compatible
+   - \u9AD8: breaking changes, or touches core auth / payment / data integrity paths
+
+---
+
+## \u{1F9EE} \u4EE3\u7801\u590D\u6742\u5EA6\u8BC4\u4F30 (Complexity Assessment)
+
+Evaluate how hard the new code will be to understand and change in the future:
+
+1. **\u8BA4\u77E5\u590D\u6742\u5EA6\u70ED\u70B9** \u2014 Identify the 1-3 most complex functions/methods. For each, explain WHY (deep nesting, multiple early returns, implicit state mutation, mixed abstraction levels).
+2. **\u8026\u5408\u5EA6\u5206\u6790** \u2014 How tightly is the new code coupled to existing modules? Are dependencies injected or hardcoded? Any circular dependency risks?
+3. **\u53EF\u7EF4\u62A4\u6027\u98CE\u9669** \u2014 Flag patterns that will cause pain when requirements change:
+   - Magic numbers / hardcoded strings that should be constants
+   - Business logic buried in framework lifecycle hooks or constructors
+   - Implicit temporal coupling (functions that must be called in a specific order)
+4. **\u590D\u6742\u5EA6\u7B49\u7EA7** \u2014 Rate as \u4F4E / \u4E2D / \u9AD8 with one sentence justification.
+
+---
+
+Format using ONLY these two sections. Be specific. Reference file names and line ranges where relevant.`;
 
 // core/task-generator.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 import * as fs5 from "fs-extra";
 import * as path3 from "path";
 
@@ -4355,31 +4478,36 @@ function parseTasks(raw) {
 }
 function printTasks(tasks) {
   const layerColors = {
-    data: chalk3.magenta,
-    infra: chalk3.gray,
-    service: chalk3.blue,
-    api: chalk3.cyan,
-    view: chalk3.yellow,
-    route: chalk3.white,
-    test: chalk3.green
+    data: chalk4.magenta,
+    infra: chalk4.gray,
+    service: chalk4.blue,
+    api: chalk4.cyan,
+    view: chalk4.yellow,
+    route: chalk4.white,
+    test: chalk4.green
   };
-  console.log(chalk3.bold(`
+  console.log(chalk4.bold(`
   Tasks (${tasks.length}):`));
   for (const task of tasks) {
-    const color = layerColors[task.layer] ?? chalk3.white;
+    const color = layerColors[task.layer] ?? chalk4.white;
     const badge = color(`[${task.layer}]`);
-    const prio = task.priority === "high" ? chalk3.red("\u25CF") : task.priority === "medium" ? chalk3.yellow("\u25CF") : chalk3.gray("\u25CF");
-    console.log(`  ${prio} ${chalk3.bold(task.id)} ${badge} ${task.title}`);
+    const prio = task.priority === "high" ? chalk4.red("\u25CF") : task.priority === "medium" ? chalk4.yellow("\u25CF") : chalk4.gray("\u25CF");
+    console.log(`  ${prio} ${chalk4.bold(task.id)} ${badge} ${task.title}`);
   }
 }
 async function loadTasksForSpec(specFilePath) {
   const base = path3.basename(specFilePath, ".md");
   const dir = path3.dirname(specFilePath);
   const tasksFile = path3.join(dir, `${base}-tasks.json`);
-  if (await fs5.pathExists(tasksFile)) {
-    return fs5.readJson(tasksFile);
+  if (!await fs5.pathExists(tasksFile)) return null;
+  try {
+    return await fs5.readJson(tasksFile);
+  } catch {
+    console.warn(
+      chalk4.yellow(`  \u26A0 Tasks file is corrupt or unreadable (${path3.basename(tasksFile)}).`) + chalk4.gray(` Re-run \`ai-spec tasks <spec>\` to regenerate.`)
+    );
+    return null;
   }
-  return null;
 }
 async function updateTaskStatus(specFilePath, taskId, status) {
   const tasks = await loadTasksForSpec(specFilePath);
@@ -4393,13 +4521,13 @@ async function updateTaskStatus(specFilePath, taskId, status) {
 }
 
 // core/dsl-extractor.ts
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 import * as fs6 from "fs-extra";
 import * as path4 from "path";
 import { select as select2 } from "@inquirer/prompts";
 
 // core/dsl-validator.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 var VALID_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE"];
 var MAX_MODELS = 50;
 var MAX_FIELDS_PER_MODEL = 100;
@@ -4970,7 +5098,7 @@ ${preview}`);
       } catch {
       }
     }
-    const httpImportRegex = /^import\s+(?:\w+|\{[^}]+\})\s+from\s+['"](@\/[^'"]+|axios|ky)['"]/m;
+    const httpImportRegex = /^import(?!\s+type)\s+(?:[\w*]+|\{[^}]+\})\s+from\s+['"]((?:@{1,2}|~|#)[/\\][^'"]+|\.{1,2}\/[^'"]*(?:http|request|fetch|client|api)[^'"]*|axios|ky(?:-universal)?|undici|node-fetch|cross-fetch|got|superagent|alova|openapi-fetch)['"]/im;
     for (const relPath of ctx.existingApiFiles.slice(0, 5)) {
       try {
         const content = await fs7.readFile(path5.join(projectRoot, relPath), "utf-8");
@@ -4983,31 +5111,51 @@ ${preview}`);
       }
     }
     const paginationFieldNames = ["pageIndex", "pageSize", "pageNum", "current", "page", "size", "offset", "limit"];
-    const paginationInterfaceRegex = new RegExp(
-      `(?:interface|type)\\s+(\\w*(?:Params|Query|Request|Filter|Page)\\w*)\\s*\\{[^}]*\\b(?:${paginationFieldNames.join("|")})\\b[^}]*\\}`,
-      "s"
-    );
-    const apiExportFnRegex = /export\s+(?:async\s+)?function\s+\w+\s*\([^)]*\)[^{]*\{[\s\S]*?\n\}/g;
     for (const relPath of ctx.existingApiFiles) {
       if (/types?\.ts$|index\.ts$/.test(relPath)) continue;
       try {
         const content = await fs7.readFile(path5.join(projectRoot, relPath), "utf-8");
         if (!paginationFieldNames.some((f) => content.includes(f))) continue;
-        const interfaceMatch = content.match(paginationInterfaceRegex);
-        if (!interfaceMatch) continue;
-        const interfaceName = interfaceMatch[1];
-        const fnRegex = new RegExp(
-          `export\\s+(?:async\\s+)?function\\s+\\w+\\s*\\(\\s*\\w+\\s*:\\s*${interfaceName}[^)]*\\)[\\s\\S]*?\\n\\}`,
-          ""
-        );
-        const fnMatch = content.match(fnRegex);
-        if (fnMatch) {
+        const lines = content.split("\n");
+        let interfaceName = "";
+        let interfaceBlock = "";
+        for (let i = 0; i < lines.length; i++) {
+          const m = lines[i].match(/(?:interface|type)\s+(\w*(?:Params|Query|Request|Filter|Page)\w*)\s*[={<]/);
+          if (!m) continue;
+          const blockLines = [];
+          let depth = 0;
+          for (let j2 = i; j2 < Math.min(i + 40, lines.length); j2++) {
+            blockLines.push(lines[j2]);
+            depth += (lines[j2].match(/\{/g) ?? []).length;
+            depth -= (lines[j2].match(/\}/g) ?? []).length;
+            if (depth === 0 && j2 > i) break;
+          }
+          const blockText = blockLines.join("\n");
+          if (!paginationFieldNames.some((f) => new RegExp(`\\b${f}\\b`).test(blockText))) continue;
+          interfaceName = m[1];
+          interfaceBlock = blockText;
+          break;
+        }
+        if (!interfaceName) continue;
+        for (let i = 0; i < lines.length; i++) {
+          const line = lines[i];
+          if (!/export\s+(async\s+)?(function|const)/.test(line)) continue;
+          if (!line.includes(interfaceName)) continue;
+          const fnLines = [];
+          let depth = 0;
+          for (let j2 = i; j2 < Math.min(i + 30, lines.length); j2++) {
+            fnLines.push(lines[j2]);
+            depth += (lines[j2].match(/\{/g) ?? []).length;
+            depth -= (lines[j2].match(/\}/g) ?? []).length;
+            if (depth === 0 && j2 > i) break;
+          }
           ctx.paginationExample = `// From ${relPath}
-${interfaceMatch[0]}
+${interfaceBlock}
 
-${fnMatch[0]}`;
+${fnLines.join("\n")}`;
           break;
         }
+        if (ctx.paginationExample) break;
       } catch {
       }
     }
@@ -5220,6 +5368,21 @@ Shared component structure patterns:`);
   return lines.join("\n");
 }
 
+// core/run-snapshot.ts
+import * as fs8 from "fs-extra";
+var _activeSnapshot = null;
+function getActiveSnapshot() {
+  return _activeSnapshot;
+}
+
+// core/run-logger.ts
+import * as fs9 from "fs-extra";
+import chalk7 from "chalk";
+var _activeLogger = null;
+function getActiveLogger() {
+  return _activeLogger;
+}
+
 // core/code-generator.ts
 function buildSharedConfigSection(context) {
   if (!context?.sharedConfigFiles || context.sharedConfigFiles.length === 0) return "";
@@ -5386,13 +5549,13 @@ var CodeGenerator = class {
     let effectiveMode = this.mode;
     if (effectiveMode === "claude-code" && this.provider.providerName !== "claude") {
       console.log(
-        chalk6.yellow(
+        chalk8.yellow(
           `
   \u26A0  codegen \u6A21\u5F0F "claude-code" \u9700\u8981 Claude\uFF0C\u4F46\u5F53\u524D provider \u662F "${this.provider.providerName}"\u3002`
         )
       );
-      console.log(chalk6.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(chalk6.gray(`  \u63D0\u793A\uFF1A\u8FD0\u884C \`ai-spec config --codegen api\` \u53EF\u56FA\u5316\u6B64\u8BBE\u7F6E\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
 `));
       effectiveMode = "api";
     }
@@ -5417,16 +5580,16 @@ var CodeGenerator = class {
     }
   }
   async runClaudeCode(specFilePath, workingDir, options = {}) {
-    console.log(chalk6.blue("\n\u2500\u2500\u2500 Code Generation: Claude Code CLI \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk8.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(chalk6.yellow("  \u26A0\uFE0F  Claude Code CLI not found. Falling back to plan mode."));
-      console.log(chalk6.gray("  Install: npm install -g @anthropic-ai/claude-code"));
+      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"));
       return this.runPlanMode(specFilePath);
     }
     const rtkAvailable = isRtkAvailable();
     const claudeCmd = rtkAvailable ? "rtk claude" : "claude";
     if (rtkAvailable) {
-      console.log(chalk6.green("  \u2713 RTK detected \u2014 using rtk claude for token savings"));
+      console.log(chalk8.green("  \u2713 RTK detected \u2014 using rtk claude for token savings"));
     }
     const tasks = await loadTasksForSpec(specFilePath);
     if (options.auto && tasks && tasks.length > 0) {
@@ -5440,29 +5603,29 @@ ${tasks.map((t) => `${t.id} [${t.layer}] ${t.title}
   Criteria: ${t.acceptanceCriteria.join("; ")}`).join("\n")}` : "";
     const promptContent = `Please read the spec file at ${specFilePath} and implement all the requirements. Create or modify files as necessary.${taskSection}`;
     const promptFile = path6.join(workingDir, ".claude-prompt.txt");
-    await fs8.writeFile(promptFile, promptContent, "utf-8");
+    await fs10.writeFile(promptFile, promptContent, "utf-8");
     if (options.auto) {
-      console.log(chalk6.cyan(`  \u{1F916} Auto mode: running claude -p (non-interactive)...`));
-      console.log(chalk6.gray(`  Spec: ${specFilePath}`));
+      console.log(chalk8.cyan(`  \u{1F916} Auto mode: running claude -p (non-interactive)...`));
+      console.log(chalk8.gray(`  Spec: ${specFilePath}`));
       try {
         execSync(`${claudeCmd} -p "${promptContent.replace(/"/g, '\\"')}"`, {
           cwd: workingDir,
           stdio: "inherit"
         });
-        console.log(chalk6.green("\n  \u2714 Claude Code completed."));
+        console.log(chalk8.green("\n  \u2714 Claude Code completed."));
       } catch {
-        console.log(chalk6.yellow("\n  Claude Code exited. Check output above."));
+        console.log(chalk8.yellow("\n  Claude Code exited. Check output above."));
       }
     } else {
-      console.log(chalk6.cyan(`  \u{1F680} Launching ${claudeCmd} in: ${workingDir}`));
-      console.log(chalk6.gray(`  Spec: ${specFilePath}`));
-      if (tasks) console.log(chalk6.gray(`  Tasks: ${tasks.length} tasks loaded into .claude-prompt.txt`));
-      console.log(chalk6.gray("  Prompt pre-loaded in .claude-prompt.txt\n"));
+      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"));
       try {
         execSync(claudeCmd, { cwd: workingDir, stdio: "inherit" });
-        console.log(chalk6.green("\n  \u2714 Claude Code session completed."));
+        console.log(chalk8.green("\n  \u2714 Claude Code session completed."));
       } catch {
-        console.log(chalk6.yellow("\n  Claude Code session ended. Continuing workflow."));
+        console.log(chalk8.yellow("\n  Claude Code session ended. Continuing workflow."));
       }
     }
   }
@@ -5475,10 +5638,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(chalk6.cyan(`
+      console.log(chalk8.cyan(`
   Resuming: ${doneCount}/${tasks.length} tasks already done \u2014 skipping.`));
     } else {
-      console.log(chalk6.cyan(`
+      console.log(chalk8.cyan(`
   Incremental mode: ${tasks.length} tasks`));
     }
     let completed = doneCount;
@@ -5506,32 +5669,32 @@ Implement ONLY this task. Do not implement other tasks.`;
         completed++;
       } catch {
         taskStatus = "failed";
-        console.log(chalk6.yellow(`
+        console.log(chalk8.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(
-      chalk6.bold(
+      chalk8.bold(
         `
-  ${successCount === tasks.length ? chalk6.green("\u2714") : chalk6.yellow("!")} Incremental build: ${completed}/${tasks.length} tasks completed.`
+  ${successCount === tasks.length ? chalk8.green("\u2714") : chalk8.yellow("!")} Incremental build: ${completed}/${tasks.length} tasks completed.`
       )
     );
   }
   // ── Mode: api ─────────────────────────────────────────────────────────────
   async runApiMode(specFilePath, workingDir, context, options = {}) {
     console.log(
-      chalk6.blue(
+      chalk8.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(chalk6.gray(`  Language: ${options.repoType} (using language-specific codegen prompt)`));
+      console.log(chalk8.gray(`  Language: ${options.repoType} (using language-specific codegen prompt)`));
     }
-    const spec = await fs8.readFile(specFilePath, "utf-8");
+    const spec = await fs10.readFile(specFilePath, "utf-8");
     const constitutionSection = context?.constitution ? `
 === Project Constitution (MUST follow) ===
 ${context.constitution}
@@ -5547,7 +5710,7 @@ ${buildDslContextSection(dsl)}
     if (dsl) {
       const cmpCount = dsl.components?.length ?? 0;
       const cmpSuffix = cmpCount > 0 ? `, ${cmpCount} components` : "";
-      console.log(chalk6.green(`  \u2713 DSL loaded \u2014 ${dsl.endpoints.length} endpoints, ${dsl.models.length} models${cmpSuffix}`));
+      console.log(chalk8.green(`  \u2713 DSL loaded \u2014 ${dsl.endpoints.length} endpoints, ${dsl.models.length} models${cmpSuffix}`));
     }
     const isFrontend = isFrontendDeps(context?.dependencies ?? []);
     let frontendSection = "";
@@ -5556,13 +5719,13 @@ ${buildDslContextSection(dsl)}
       frontendSection = `
 ${buildFrontendContextSection(fctx)}
 `;
-      console.log(chalk6.gray(`  Frontend context: ${fctx.framework} / ${fctx.httpClient} | hooks:${fctx.hookFiles.length} stores:${fctx.storeFiles.length}`));
+      console.log(chalk8.gray(`  Frontend context: ${fctx.framework} / ${fctx.httpClient} | hooks:${fctx.hookFiles.length} stores:${fctx.storeFiles.length}`));
     }
     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(chalk6.gray("  [1/2] Planning implementation files..."));
+    console.log(chalk8.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,
@@ -5585,18 +5748,18 @@ Output ONLY a valid JSON array:
       const planResponse = await this.provider.generate(planPrompt, systemPrompt);
       filePlan = parseJsonArray(planResponse);
     } catch (err) {
-      console.error(chalk6.red("  Failed to generate file plan:"), err);
+      console.error(chalk8.red("  Failed to generate file plan:"), err);
     }
     if (filePlan.length === 0) {
-      console.log(chalk6.yellow("  Could not determine file plan. Falling back to plan mode."));
+      console.log(chalk8.yellow("  Could not determine file plan. Falling back to plan mode."));
       await this.runPlanMode(specFilePath);
       return [];
     }
-    console.log(chalk6.cyan(`
+    console.log(chalk8.cyan(`
   Plan: ${filePlan.length} file(s) to process`));
     filePlan.forEach((item) => {
-      const icon = item.action === "create" ? chalk6.green("+") : chalk6.yellow("~");
-      console.log(`  ${icon} ${item.file}: ${chalk6.gray(item.description)}`);
+      const icon = item.action === "create" ? chalk8.green("+") : chalk8.yellow("~");
+      console.log(`  ${icon} ${item.file}: ${chalk8.gray(item.description)}`);
     });
     const { files } = await this.generateFiles(filePlan, spec, workingDir, constitutionSection + dslSection + frontendSection + installedPackagesSection, systemPrompt);
     return files;
@@ -5605,13 +5768,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(chalk6.cyan(`
-  Task-based generation (resume): ${tasks.length} tasks (${chalk6.green(doneCount + " already done")}, skipping)`));
+      console.log(chalk8.cyan(`
+  Task-based generation (resume): ${tasks.length} tasks (${chalk8.green(doneCount + " already done")}, skipping)`));
     } else if (doneCount > 0) {
-      console.log(chalk6.cyan(`
-  Task-based generation: ${tasks.length} tasks (${chalk6.green(doneCount + " already done")}, resuming from checkpoint)`));
+      console.log(chalk8.cyan(`
+  Task-based generation: ${tasks.length} tasks (${chalk8.green(doneCount + " already done")}, resuming from checkpoint)`));
     } else {
-      console.log(chalk6.cyan(`
+      console.log(chalk8.cyan(`
   Task-based generation: ${tasks.length} tasks`));
     }
     const sharedConfigPaths = new Set(
@@ -5643,9 +5806,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 = chalk6.green("\u2588".repeat(filled)) + chalk6.gray("\u2591".repeat(barWidth - filled));
+        const bar = chalk8.green("\u2588".repeat(filled)) + chalk8.gray("\u2591".repeat(barWidth - filled));
         console.log(
-          chalk6.bold(`
+          chalk8.bold(`
   [${bar}] ${pct}% \u26A1 Layer [${layer}] ${layerIcon} \u2014 ${layerTasks.length} tasks running in parallel`)
         );
       } else {
@@ -5653,12 +5816,12 @@ Output ONLY a valid JSON array:
       }
       const executeTask = async (task, batchIsParallel) => {
         if (task.filesToTouch.length === 0) {
-          if (!batchIsParallel) console.log(chalk6.gray("    No files specified, skipping."));
+          if (!batchIsParallel) console.log(chalk8.gray("    No files specified, skipping."));
           return { task, files: [], createdFiles: [], success: 0, total: 0, impliesRegistration: false };
         }
         const filePlan = await Promise.all(
           task.filesToTouch.filter((f) => !sharedConfigPaths.has(f)).map(async (f) => {
-            const exists = await fs8.pathExists(path6.join(workingDir, f));
+            const exists = await fs10.pathExists(path6.join(workingDir, f));
             return {
               file: f,
               action: exists ? "modify" : "create",
@@ -5698,7 +5861,7 @@ ${taskContext}`,
             const isViewFile = /src[\\/](views?|pages?)[\\/]/i.test(writtenFile);
             if (isCodeFile || isViewFile) {
               try {
-                const content = isViewFile ? `// view component \u2014 use this exact path for router imports` : await fs8.readFile(path6.join(workingDir, writtenFile), "utf-8");
+                const content = isViewFile ? `// view component \u2014 use this exact path for router imports` : await fs10.readFile(path6.join(workingDir, writtenFile), "utf-8");
                 generatedFileCache.set(writtenFile, content);
               } catch {
               }
@@ -5710,7 +5873,12 @@ ${taskContext}`,
       const layerResults = [];
       for (const batch of taskBatches) {
         const batchIsParallel = batch.length > 1;
-        const batchResultPromises = batch.map((task) => executeTask(task, batchIsParallel));
+        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);
         layerResults.push(...batchResults);
         await updateCacheFromBatch(batchResults);
@@ -5723,14 +5891,14 @@ ${taskContext}`,
         totalFiles += result.total;
         allGeneratedFiles.push(...result.files);
         if (isParallel) {
-          const icon = result.success === result.total ? chalk6.green("\u2714") : chalk6.yellow("!");
+          const icon = result.success === result.total ? chalk8.green("\u2714") : chalk8.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(chalk6.yellow(`  \u26A0 ${result.task.id} marked as failed \u2014 re-run with --resume to retry`));
+          console.log(chalk8.yellow(`  \u26A0 ${result.task.id} marked as failed \u2014 re-run with --resume to retry`));
         }
       }
       completedTasks += layerTasks.length;
@@ -5745,7 +5913,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(chalk6.gray(`
+          console.log(chalk8.gray(`
     + updating shared config: ${sharedFile.path} [${sharedFile.category}]`));
           const updatedGeneratedFilesSection = buildGeneratedFilesSection(generatedFileCache);
           await this.generateFiles(
@@ -5763,17 +5931,17 @@ Updating shared registration after layer [${layer}] completed. New modules: ${ne
       }
     }
     console.log(
-      chalk6.bold(
+      chalk8.bold(
         `
-  ${totalSuccess === totalFiles ? chalk6.green("\u2714") : chalk6.yellow("!")} Task-based generation: ${totalSuccess}/${totalFiles} files written across ${pendingTasks.length} tasks.`
+  ${totalSuccess === totalFiles ? chalk8.green("\u2714") : chalk8.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 ? `  [${chalk6.cyan(taskLabel)}] ` : "  ";
+    const prefix = taskLabel ? `  [${chalk8.cyan(taskLabel)}] ` : "  ";
     if (!taskLabel) {
-      console.log(chalk6.gray(`
+      console.log(chalk8.gray(`
   Generating ${filePlan.length} file(s)...`));
     }
     let successCount = 0;
@@ -5781,8 +5949,8 @@ Updating shared registration after layer [${layer}] completed. New modules: ${ne
     for (const item of filePlan) {
       const fullPath = path6.join(workingDir, item.file);
       let existingContent = "";
-      if (await fs8.pathExists(fullPath)) {
-        existingContent = await fs8.readFile(fullPath, "utf-8");
+      if (await fs10.pathExists(fullPath)) {
+        existingContent = await fs10.readFile(fullPath, "utf-8");
       }
       const codePrompt = `Implement this file.
 
@@ -5797,19 +5965,21 @@ ${existingContent || "Output only the complete file content."}`;
       try {
         const raw = await this.provider.generate(codePrompt, systemPrompt);
         const fileContent = stripCodeFences(raw);
-        await fs8.ensureDir(path6.dirname(fullPath));
-        await fs8.writeFile(fullPath, fileContent, "utf-8");
-        console.log(`${prefix}${existingContent ? chalk6.yellow("~") : chalk6.green("+")} ${chalk6.bold(item.file)} ${chalk6.green("\u2714")}`);
+        await getActiveSnapshot()?.snapshotFile(fullPath);
+        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")}`);
         successCount++;
         writtenFiles.push(item.file);
       } catch (err) {
-        console.log(`${prefix}${chalk6.red("\u2718")} ${chalk6.bold(item.file)} \u2014 ${chalk6.red(err.message)}`);
+        console.log(`${prefix}${chalk8.red("\u2718")} ${chalk8.bold(item.file)} \u2014 ${chalk8.red(err.message)}`);
       }
     }
     if (!taskLabel) {
       console.log(
-        chalk6.bold(
-          `  ${successCount === filePlan.length ? chalk6.green("\u2714") : chalk6.yellow("!")} ${successCount}/${filePlan.length} files written.`
+        chalk8.bold(
+          `  ${successCount === filePlan.length ? chalk8.green("\u2714") : chalk8.yellow("!")} ${successCount}/${filePlan.length} files written.`
         )
       );
     }
@@ -5817,8 +5987,8 @@ ${existingContent || "Output only the complete file content."}`;
   }
   // ── Mode: plan ─────────────────────────────────────────────────────────────
   async runPlanMode(specFilePath) {
-    console.log(chalk6.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 fs8.readFile(specFilePath, "utf-8");
+    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"));
+    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.
 Be specific about:
@@ -5830,7 +6000,7 @@ Be specific about:
 ${spec}`,
       "You are a senior developer creating an actionable implementation guide."
     );
-    console.log(chalk6.cyan("\n") + plan);
+    console.log(chalk8.cyan("\n") + plan);
   }
 };
 function topoSortLayerTasks(tasks) {
@@ -5881,32 +6051,32 @@ 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 = chalk6.green("\u2588".repeat(filled)) + chalk6.gray("\u2591".repeat(barWidth - filled));
+  const bar = chalk8.green("\u2588".repeat(filled)) + chalk8.gray("\u2591".repeat(barWidth - filled));
   const icon = LAYER_ICONS[task.layer] ?? "  ";
   if (mode === "skip") {
     console.log(
-      chalk6.gray(`
+      chalk8.gray(`
   [${bar}] ${pct}% \u2713 ${task.id} ${icon} ${task.title} \u2014 already done`)
     );
   } else {
     console.log(
-      chalk6.bold(`
+      chalk8.bold(`
   [${bar}] ${pct}% \u2192 ${task.id} ${icon} ${task.title}`)
     );
   }
 }
 
 // core/reviewer.ts
-import chalk7 from "chalk";
+import chalk9 from "chalk";
 import { execSync as execSync2 } from "child_process";
 import * as path7 from "path";
-import * as fs9 from "fs-extra";
+import * as fs11 from "fs-extra";
 var REVIEW_HISTORY_FILE = ".ai-spec-reviews.json";
 async function loadReviewHistory(projectRoot) {
   const historyPath = path7.join(projectRoot, REVIEW_HISTORY_FILE);
   try {
-    if (await fs9.pathExists(historyPath)) {
-      return await fs9.readJson(historyPath);
+    if (await fs11.pathExists(historyPath)) {
+      return await fs11.readJson(historyPath);
     }
   } catch {
   }
@@ -5917,7 +6087,7 @@ async function appendReviewHistory(projectRoot, entry) {
   const existing = await loadReviewHistory(projectRoot);
   const updated = [...existing, entry].slice(-20);
   try {
-    await fs9.writeJson(historyPath, updated, { spaces: 2 });
+    await fs11.writeJson(historyPath, updated, { spaces: 2 });
   } catch {
   }
 }
@@ -5925,6 +6095,14 @@ function extractScore(reviewText) {
   const match = reviewText.match(/Score:\s*(\d+(?:\.\d+)?)\s*\/\s*10/i);
   return match ? parseFloat(match[1]) : 0;
 }
+function extractImpactLevel(reviewText) {
+  const match = reviewText.match(/影响等级[：:]\s*(低|中|高)/);
+  return match ? match[1] : void 0;
+}
+function extractComplexityLevel(reviewText) {
+  const match = reviewText.match(/复杂度等级[：:]\s*(低|中|高)/);
+  return match ? match[1] : void 0;
+}
 function extractTopIssues(reviewText) {
   const issuesSection = reviewText.match(/##.*?问题.*?\n([\s\S]*?)(?=##|$)/i)?.[1] ?? "";
   return issuesSection.split("\n").filter((l) => /^[-·•*]/.test(l.trim())).map((l) => l.replace(/^[-·•*]\s*/, "").trim()).filter(Boolean).slice(0, 3);
@@ -5970,15 +6148,14 @@ var CodeReviewer = class {
     };
   }
   /**
-   * Two-pass review:
+   * Three-pass review:
    *   Pass 1 — architecture (spec compliance, layer separation, auth)
    *   Pass 2 — implementation details (validation, error handling, edge cases)
    *             + historical issue recurrence check
-   *
-   * Falls back to single-pass if the two-pass flag is not set.
+   *   Pass 3 — impact assessment + code complexity
    */
-  async runTwoPassReview(specContent, codeContext, specFile) {
-    console.log(chalk7.gray("  Pass 1/2: Architecture review..."));
+  async runThreePassReview(specContent, codeContext, specFile) {
+    console.log(chalk9.gray("  Pass 1/3: Architecture review..."));
     const archPrompt = `Review the architecture of this change.
 
 === Feature Spec ===
@@ -5987,7 +6164,7 @@ ${specContent || "(No spec \u2014 review for general code quality)"}
 === Code ===
 ${codeContext}`;
     const archReview = await this.provider.generate(archPrompt, reviewArchitectureSystemPrompt);
-    console.log(chalk7.gray("  Pass 2/2: Implementation review..."));
+    console.log(chalk9.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.
@@ -6002,61 +6179,85 @@ ${codeContext}
 ${archReview}
 ${historyContext}`;
     const implReview = await this.provider.generate(implPrompt, reviewImplementationSystemPrompt);
-    const combined = `${archReview}
+    console.log(chalk9.gray("  Pass 3/3: Impact & complexity assessment..."));
+    const impactPrompt = `Assess the impact and complexity of this change.
 
-${"\u2500".repeat(52)}
+=== Feature Spec ===
+${specContent || "(No spec \u2014 review for general code quality)"}
 
+=== Code ===
+${codeContext}
+
+=== Architecture Review (Pass 1 \u2014 do NOT repeat) ===
+${archReview}
+
+=== Implementation Review (Pass 2 \u2014 do NOT repeat) ===
 ${implReview}`;
+    const impactReview = await this.provider.generate(impactPrompt, reviewImpactComplexitySystemPrompt);
+    const sep = "\u2500".repeat(52);
+    const combined = `${archReview}
+
+${sep}
+
+${implReview}
+
+${sep}
+
+${impactReview}`;
     const score = extractScore(implReview) || extractScore(archReview);
     const topIssues = extractTopIssues(implReview);
+    const impactLevel = extractImpactLevel(impactReview);
+    const complexityLevel = extractComplexityLevel(impactReview);
     if (score > 0 && specFile) {
       await appendReviewHistory(this.projectRoot, {
         date: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
         specFile: path7.relative(this.projectRoot, specFile),
         score,
-        topIssues
+        topIssues,
+        ...impactLevel ? { impactLevel } : {},
+        ...complexityLevel ? { complexityLevel } : {}
       });
     }
     return combined;
   }
   async reviewCode(specContent, specFile) {
-    console.log(chalk7.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(chalk9.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(
-        chalk7.yellow("  No git diff found. Stage or commit changes first, then run review.")
+        chalk9.yellow("  No git diff found. Stage or commit changes first, then run review.")
       );
-      console.log(chalk7.gray("  Tip: run `git add .` then `ai-spec review` to review your work."));
+      console.log(chalk9.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(
-      chalk7.gray(`  Diff: ${files} file(s), ${chalk7.green("+" + added)} ${chalk7.red("-" + removed)}`)
+      chalk9.gray(`  Diff: ${files} file(s), ${chalk9.green("+" + added)} ${chalk9.red("-" + removed)}`)
     );
     console.log(
-      chalk7.blue(`  Reviewing with ${this.provider.providerName}/${this.provider.modelName}...`)
+      chalk9.blue(`  Reviewing with ${this.provider.providerName}/${this.provider.modelName}...`)
     );
     const codeContext = diff.slice(0, 1e4);
-    const reviewResult = await this.runTwoPassReview(specContent, codeContext, specFile);
-    console.log(chalk7.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"));
+    const reviewResult = await this.runThreePassReview(specContent, codeContext, specFile);
+    console.log(chalk9.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(chalk7.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(chalk9.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(chalk7.cyan("\n\u2500\u2500\u2500 Automated Code Review (file-based) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-    console.log(chalk7.gray(`  Reviewing ${filePaths.length} generated file(s)...`));
+    console.log(chalk9.cyan("\n\u2500\u2500\u2500 Automated Code Review (file-based) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk9.gray(`  Reviewing ${filePaths.length} generated file(s)...`));
     console.log(
-      chalk7.blue(`  Reviewing with ${this.provider.providerName}/${this.provider.modelName}...`)
+      chalk9.blue(`  Reviewing with ${this.provider.providerName}/${this.provider.modelName}...`)
     );
     let filesSection = "";
     for (const filePath of filePaths) {
       const fullPath = path7.join(workingDir, filePath);
       try {
-        const content = await fs9.readFile(fullPath, "utf-8");
+        const content = await fs11.readFile(fullPath, "utf-8");
         filesSection += `
 
 === ${filePath} ===
@@ -6070,33 +6271,33 @@ ${content.slice(0, 3e3)}`;
 (file not found)`;
       }
     }
-    const reviewResult = await this.runTwoPassReview(specContent, filesSection, specFile);
-    console.log(chalk7.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"));
+    const reviewResult = await this.runThreePassReview(specContent, filesSection, specFile);
+    console.log(chalk9.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(chalk7.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(chalk9.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(chalk7.gray("  No review history yet."));
+      console.log(chalk9.gray("  No review history yet."));
       return;
     }
     const recent = history.slice(-limit);
-    console.log(chalk7.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(chalk9.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 ? chalk7.green : entry.score >= 6 ? chalk7.yellow : chalk7.red;
+      const color = entry.score >= 8 ? chalk9.green : entry.score >= 6 ? chalk9.yellow : chalk9.red;
       console.log(`  ${entry.date}  [${color(bar)}] ${color(entry.score + "/10")}  ${path7.basename(entry.specFile)}`);
     }
-    console.log(chalk7.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(chalk9.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"));
   }
 };
 
 // core/constitution-generator.ts
-import chalk8 from "chalk";
-import * as fs10 from "fs-extra";
+import chalk10 from "chalk";
+import * as fs12 from "fs-extra";
 import * as path8 from "path";
 
 // prompts/constitution.prompt.ts
@@ -6178,7 +6379,7 @@ var ConstitutionGenerator = class {
   }
   async saveConstitution(projectRoot, content) {
     const filePath = path8.join(projectRoot, CONSTITUTION_FILE);
-    await fs10.writeFile(filePath, content, "utf-8");
+    await fs12.writeFile(filePath, content, "utf-8");
     return filePath;
   }
 };
@@ -6237,15 +6438,15 @@ ${sections.join("\n")}
 }
 async function loadConstitution(projectRoot) {
   const filePath = path8.join(projectRoot, CONSTITUTION_FILE);
-  if (await fs10.pathExists(filePath)) {
-    return fs10.readFile(filePath, "utf-8");
+  if (await fs12.pathExists(filePath)) {
+    return fs12.readFile(filePath, "utf-8");
   }
   return void 0;
 }
 function printConstitutionHint(exists) {
   if (!exists) {
     console.log(
-      chalk8.yellow(
+      chalk10.yellow(
         "  \u26A1 Tip: Run `ai-spec init` to generate a Project Constitution for better spec quality."
       )
     );
@@ -6290,8 +6491,8 @@ function parseSpecAndTasks(raw) {
 // git/worktree.ts
 import { execSync as execSync3 } from "child_process";
 import * as path9 from "path";
-import * as fs11 from "fs-extra";
-import chalk9 from "chalk";
+import * as fs13 from "fs-extra";
+import chalk11 from "chalk";
 var GitWorktreeManager = class {
   constructor(baseDir) {
     this.baseDir = baseDir;
@@ -6318,30 +6519,30 @@ var GitWorktreeManager = class {
     for (const dir of candidates) {
       const src = path9.join(this.baseDir, dir);
       const dest = path9.join(worktreePath, dir);
-      if (!await fs11.pathExists(src)) continue;
-      if (await fs11.pathExists(dest)) continue;
+      if (!await fs13.pathExists(src)) continue;
+      if (await fs13.pathExists(dest)) continue;
       try {
-        await fs11.ensureSymlink(src, dest, "dir");
-        console.log(chalk9.gray(`  Symlinked ${dir}/ from base repo \u2192 worktree`));
+        await fs13.ensureSymlink(src, dest, "dir");
+        console.log(chalk11.gray(`  Symlinked ${dir}/ from base repo \u2192 worktree`));
       } catch (err) {
-        console.log(chalk9.yellow(`  \u26A0 Could not symlink ${dir}/: ${err.message}`));
-        console.log(chalk9.yellow(`    Run \`npm install\` inside the worktree manually.`));
+        console.log(chalk11.yellow(`  \u26A0 Could not symlink ${dir}/: ${err.message}`));
+        console.log(chalk11.yellow(`    Run \`npm install\` inside the worktree manually.`));
       }
     }
   }
   async createWorktree(idea) {
     if (!this.isGitRepo()) {
-      console.log(chalk9.yellow("\u26A0\uFE0F Not a git repository. Skipping worktree creation."));
+      console.log(chalk11.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(chalk9.cyan(`
+    console.log(chalk11.cyan(`
 --- Setting up Git Worktree ---`));
-    if (await fs11.pathExists(worktreePath)) {
-      console.log(chalk9.yellow(`\u26A0\uFE0F Worktree directory already exists at: ${worktreePath}`));
+    if (await fs13.pathExists(worktreePath)) {
+      console.log(chalk11.yellow(`\u26A0\uFE0F Worktree directory already exists at: ${worktreePath}`));
       await this.linkDependencies(worktreePath);
       return worktreePath;
     }
@@ -6355,7 +6556,7 @@ var GitWorktreeManager = class {
         branchExists = true;
       } catch {
       }
-      console.log(chalk9.gray(`Creating worktree at: ${worktreePath}`));
+      console.log(chalk11.gray(`Creating worktree at: ${worktreePath}`));
       if (branchExists) {
         execSync3(`git worktree add "${worktreePath}" ${branchName}`, {
           cwd: this.baseDir,
@@ -6368,12 +6569,12 @@ var GitWorktreeManager = class {
         });
       }
       console.log(
-        chalk9.green(`\u2714 Worktree successfully created and isolated on branch '${branchName}'`)
+        chalk11.green(`\u2714 Worktree successfully created and isolated on branch '${branchName}'`)
       );
       await this.linkDependencies(worktreePath);
       return worktreePath;
     } catch (error) {
-      console.error(chalk9.red("Failed to create git worktree:"), error);
+      console.error(chalk11.red("Failed to create git worktree:"), error);
       return null;
     }
   }