ai-spec-dev 0.41.0 → 0.46.0

package/dist/cli/index.js

@@ -9,6 +9,9 @@ var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -147,6 +150,100 @@ CRITICAL \u2014 \u5386\u53F2\u6559\u8BAD\u5E94\u7528\uFF08Accumulated Lessons\uF
   }
 });
 
+// core/cli-ui.ts
+function startSpinner(text) {
+  const isTTY = process.stderr.isTTY;
+  let frame = 0;
+  let currentText = text;
+  let stopped = false;
+  function render() {
+    if (stopped) return;
+    const symbol = import_chalk.default.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(import_chalk.default.green(`\u2714 ${successText}`));
+    },
+    fail(failText) {
+      this.stop(import_chalk.default.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(import_chalk.default.yellow(`  \u250C\u2500 Retry ${attempt}/${maxAttempts} `) + import_chalk.default.gray(`[${label}]`) + import_chalk.default.yellow(` ${"\u2500".repeat(Math.max(1, 40 - label.length))}
+`));
+  process.stderr.write(import_chalk.default.yellow(`  \u2502 `) + import_chalk.default.white(shortErr) + "\n");
+  process.stderr.write(import_chalk.default.yellow(`  \u2502 `) + import_chalk.default.gray(`Waiting before retry...`) + "\n");
+  const totalSeconds = Math.ceil(waitMs / 1e3);
+  for (let s = totalSeconds; s > 0; s--) {
+    const bar = import_chalk.default.green("\u2588".repeat(totalSeconds - s)) + import_chalk.default.gray("\u2591".repeat(s));
+    const line = import_chalk.default.yellow(`  \u2502 `) + `${bar} ${import_chalk.default.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(import_chalk.default.yellow(`  \u2514\u2500 `) + import_chalk.default.cyan(`Retrying now...`) + "\n\n");
+}
+function startStage(stageKey, label) {
+  const icon = STAGE_ICONS[stageKey] ?? "\u25B8";
+  return startSpinner(`${icon}  ${label}`);
+}
+var import_chalk, SPINNER_FRAMES, STAGE_ICONS;
+var init_cli_ui = __esm({
+  "core/cli-ui.ts"() {
+    "use strict";
+    import_chalk = __toESM(require("chalk"));
+    SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+    STAGE_ICONS = {
+      context_load: "\u{1F4C2}",
+      design_dialogue: "\u{1F4AC}",
+      spec_gen: "\u{1F4DD}",
+      spec_refine: "\u270F\uFE0F ",
+      spec_assess: "\u{1F4CA}",
+      dsl_extract: "\u{1F517}",
+      dsl_gap_feedback: "\u{1F50D}",
+      codegen: "\u2699\uFE0F ",
+      test_gen: "\u{1F9EA}",
+      error_feedback: "\u{1F527}",
+      review: "\u{1F50E}",
+      self_eval: "\u{1F4C8}"
+    };
+  }
+});
+
 // core/provider-utils.ts
 function classifyError(err, label) {
   const e = err;
@@ -223,21 +320,23 @@ async function withReliability(fn, opts) {
         throw classifyError(err, label);
       }
       const waitMs = attempt === 0 ? 2e3 : 6e3;
-      console.warn(
-        import_chalk.default.yellow(`  \u26A0 ${label} failed (attempt ${attempt + 1}/${retries + 1}), retrying in ${waitMs / 1e3}s`) + import_chalk.default.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");
 }
-var import_chalk, sleep, ProviderError;
+var ProviderError;
 var init_provider_utils = __esm({
   "core/provider-utils.ts"() {
     "use strict";
-    import_chalk = __toESM(require("chalk"));
-    sleep = (ms2) => new Promise((r) => setTimeout(r, ms2));
+    init_cli_ui();
     ProviderError = class extends Error {
       constructor(message, kind, originalError) {
         super(message);
@@ -295,14 +394,13 @@ function createProvider(providerName, apiKey, modelName) {
       );
   }
 }
-var import_generative_ai, import_sdk, import_openai, import_axios, import_undici, PROVIDER_CATALOG, SUPPORTED_PROVIDERS, DEFAULT_MODELS, ENV_KEY_MAP, GeminiProvider, ClaudeProvider, OpenAICompatibleProvider, MiMoProvider, SpecGenerator;
+var import_generative_ai, import_sdk, import_openai, import_undici, PROVIDER_CATALOG, SUPPORTED_PROVIDERS, DEFAULT_MODELS, ENV_KEY_MAP, GeminiProvider, ClaudeProvider, OpenAICompatibleProvider, MiMoProvider, SpecGenerator;
 var init_spec_generator = __esm({
   "core/spec-generator.ts"() {
     "use strict";
     import_generative_ai = require("@google/generative-ai");
     import_sdk = __toESM(require("@anthropic-ai/sdk"));
     import_openai = __toESM(require("openai"));
-    import_axios = __toESM(require("axios"));
     import_undici = require("undici");
     init_spec_prompt();
     init_provider_utils();
@@ -312,7 +410,9 @@ var init_spec_generator = __esm({
         displayName: "MiMo (Xiaomi)",
         description: "\u5C0F\u7C73 MiMo \u2014 mimo-v2-pro (Anthropic-compatible API)",
         models: ["mimo-v2-pro"],
-        envKey: "MIMO_API_KEY"
+        envKey: "MIMO_API_KEY",
+        // Fallback env var — MiMo's token plan uses ANTHROPIC_AUTH_TOKEN
+        fallbackEnvKeys: ["ANTHROPIC_AUTH_TOKEN"]
         // baseURL not used — MiMo has a dedicated provider class
       },
       gemini: {
@@ -481,8 +581,8 @@ var init_spec_generator = __esm({
               ...systemInstruction ? { system: systemInstruction } : {},
               messages: [{ role: "user", content: prompt }]
             });
-            const block = message.content[0];
-            if (block.type === "text") return block.text;
+            const textBlock = message.content.find((b) => b.type === "text");
+            if (textBlock) return textBlock.text;
             throw new Error("Unexpected response type from Claude API");
           },
           { label: `${this.providerName}/${this.modelName}` }
@@ -527,43 +627,29 @@ var init_spec_generator = __esm({
       }
     };
     MiMoProvider = class {
+      client;
       providerName = "mimo";
       modelName;
-      apiKey;
-      baseUrl = "https://api.xiaomimimo.com/anthropic/v1/messages";
       constructor(apiKey, modelName = PROVIDER_CATALOG.mimo.models[0]) {
-        this.apiKey = apiKey;
+        const baseURL = process.env["MIMO_BASE_URL"] || process.env["ANTHROPIC_BASE_URL"] || "https://token-plan-cn.xiaomimimo.com/anthropic";
+        this.client = new import_sdk.default({ apiKey, baseURL });
         this.modelName = modelName;
       }
       async generate(prompt, systemInstruction) {
         return withReliability(
           async () => {
-            const body = {
+            const stream = this.client.messages.stream({
               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 import_axios.default.post(this.baseUrl, body, {
-              headers: {
-                "api-key": this.apiKey,
-                "Content-Type": "application/json"
-              }
+              max_tokens: 65536,
+              ...systemInstruction ? { system: systemInstruction } : {},
+              messages: [{ role: "user", content: prompt }]
             });
-            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)}`);
+            const message = await stream.finalMessage();
+            const textBlock = message.content.find((b) => b.type === "text");
+            if (textBlock) return textBlock.text;
+            const thinkBlock = message.content.find((b) => b.type === "thinking");
+            if (thinkBlock) return thinkBlock.thinking;
+            return message.content.map((b) => b.text ?? "").join("");
           },
           { label: `${this.providerName}/${this.modelName}` }
         );
@@ -624,11 +710,68 @@ ${context.schema.slice(0, 3e3)}`);
   }
 });
 
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "ai-spec-dev",
+      version: "0.46.0",
+      description: "AI-driven Development Orchestrator SDK & CLI",
+      main: "dist/index.js",
+      types: "dist/index.d.ts",
+      bin: {
+        "ai-spec": "dist/cli/index.js"
+      },
+      scripts: {
+        build: "tsup",
+        dev: "tsup --watch",
+        test: "vitest run",
+        "test:watch": "vitest"
+      },
+      keywords: [
+        "ai",
+        "spec",
+        "codegen",
+        "gemini",
+        "claude"
+      ],
+      author: "",
+      license: "MIT",
+      dependencies: {
+        "@anthropic-ai/sdk": "^0.38.0",
+        "@google/generative-ai": "^0.21.0",
+        "@inquirer/editor": "^5.0.10",
+        "@inquirer/prompts": "^8.3.2",
+        "@rollup/rollup-darwin-arm64": "^4.60.1",
+        axios: "^1.13.6",
+        chalk: "^4.1.2",
+        commander: "^13.1.0",
+        dotenv: "^16.4.7",
+        "fs-extra": "^11.3.0",
+        openai: "^6.31.0",
+        undici: "^7.24.4"
+      },
+      devDependencies: {
+        "@types/fs-extra": "^11.0.4",
+        "@types/glob": "^8.1.0",
+        "@types/node": "^22.13.5",
+        glob: "^13.0.6",
+        "ts-node": "^10.9.2",
+        tsup: "^8.4.0",
+        typescript: "^5.7.3",
+        vitest: "^2.1.0"
+      }
+    };
+  }
+});
+
 // cli/index.ts
 var import_commander = require("commander");
 var dotenv = __toESM(require("dotenv"));
 
 // cli/commands/create.ts
+var path26 = __toESM(require("path"));
+var fs27 = __toESM(require("fs-extra"));
 var import_chalk26 = __toESM(require("chalk"));
 var import_prompts7 = require("@inquirer/prompts");
 init_spec_generator();
@@ -731,8 +874,8 @@ var WorkspaceLoader = class {
     const repos = [];
     for (const entry of entries) {
       const absPath = path.join(this.workspaceRoot, entry);
-      const stat4 = await fs.stat(absPath).catch(() => null);
-      if (!stat4 || !stat4.isDirectory()) continue;
+      const stat5 = await fs.stat(absPath).catch(() => null);
+      if (!stat5 || !stat5.isDirectory()) continue;
       if (entry.startsWith(".") || entry === "node_modules") continue;
       if (names && !names.includes(entry)) continue;
       const hasManifest = await fs.pathExists(path.join(absPath, "package.json")) || await fs.pathExists(path.join(absPath, "go.mod")) || await fs.pathExists(path.join(absPath, "Cargo.toml")) || await fs.pathExists(path.join(absPath, "pom.xml")) || await fs.pathExists(path.join(absPath, "build.gradle")) || await fs.pathExists(path.join(absPath, "requirements.txt")) || await fs.pathExists(path.join(absPath, "pyproject.toml")) || await fs.pathExists(path.join(absPath, "composer.json"));
@@ -795,6 +938,7 @@ var WorkspaceLoader = class {
 // cli/utils.ts
 var path3 = __toESM(require("path"));
 var fs3 = __toESM(require("fs-extra"));
+var os2 = __toESM(require("os"));
 var import_chalk2 = __toESM(require("chalk"));
 var import_prompts = require("@inquirer/prompts");
 init_spec_generator();
@@ -841,17 +985,42 @@ async function clearKey(provider) {
 
 // cli/utils.ts
 var CONFIG_FILE = ".ai-spec.json";
+var GLOBAL_CONFIG_FILE = path3.join(os2.homedir(), ".ai-spec-config.json");
+async function loadGlobalConfig() {
+  try {
+    if (await fs3.pathExists(GLOBAL_CONFIG_FILE)) {
+      return await fs3.readJson(GLOBAL_CONFIG_FILE);
+    }
+  } catch {
+  }
+  return {};
+}
+async function saveGlobalConfig(config2) {
+  await fs3.ensureFile(GLOBAL_CONFIG_FILE);
+  await fs3.writeJson(GLOBAL_CONFIG_FILE, config2, { spaces: 2 });
+}
 async function loadConfig(dir) {
+  const globalConfig = await loadGlobalConfig();
+  let localConfig = {};
   const p = path3.join(dir, CONFIG_FILE);
   if (await fs3.pathExists(p)) {
-    return fs3.readJson(p);
+    try {
+      localConfig = await fs3.readJson(p);
+    } catch {
+    }
   }
-  return {};
+  return { ...globalConfig, ...localConfig };
 }
 async function resolveApiKey(providerName, cliKey) {
   if (cliKey) return cliKey;
   const envVar = ENV_KEY_MAP[providerName];
   if (envVar && process.env[envVar]) return process.env[envVar];
+  const meta = PROVIDER_CATALOG[providerName];
+  if (meta?.fallbackEnvKeys) {
+    for (const key of meta.fallbackEnvKeys) {
+      if (process.env[key]) return process.env[key];
+    }
+  }
   const savedKey = await getSavedKey(providerName);
   if (savedKey) {
     const masked = savedKey.slice(0, 6) + "..." + savedKey.slice(-4);
@@ -925,7 +1094,7 @@ var pe = "\0PERIOD" + Math.random() + "\0";
 var is = new RegExp(fe, "g");
 var rs = new RegExp(ue, "g");
 var ns = new RegExp(qt, "g");
-var os2 = new RegExp(de, "g");
+var os3 = new RegExp(de, "g");
 var hs = new RegExp(pe, "g");
 var as = /\\\\/g;
 var ls = /\\{/g;
@@ -940,7 +1109,7 @@ function ps(n7) {
   return n7.replace(as, fe).replace(ls, ue).replace(cs, qt).replace(fs4, de).replace(us, pe);
 }
 function ms(n7) {
-  return n7.replace(is, "\\").replace(rs, "{").replace(ns, "}").replace(os2, ",").replace(hs, ".");
+  return n7.replace(is, "\\").replace(rs, "{").replace(ns, "}").replace(os3, ",").replace(hs, ".");
 }
 function me(n7) {
   if (!n7) return [""];
@@ -3870,11 +4039,11 @@ Ze.glob = Ze;
 // core/global-constitution.ts
 var fs5 = __toESM(require("fs-extra"));
 var path4 = __toESM(require("path"));
-var os3 = __toESM(require("os"));
+var os4 = __toESM(require("os"));
 var GLOBAL_CONSTITUTION_FILE = ".ai-spec-global-constitution.md";
 var SEARCH_ROOTS = [
   // Workspace root is injected at runtime — see loadGlobalConstitution()
-  os3.homedir()
+  os4.homedir()
 ];
 async function loadGlobalConstitution(extraRoots = []) {
   const roots = [...extraRoots, ...SEARCH_ROOTS];
@@ -3903,7 +4072,7 @@ function mergeConstitutions(globalContent, projectContent) {
   }
   return parts.join("\n");
 }
-async function saveGlobalConstitution(content, targetDir = os3.homedir()) {
+async function saveGlobalConstitution(content, targetDir = os4.homedir()) {
   const filePath = path4.join(targetDir, GLOBAL_CONSTITUTION_FILE);
   await fs5.writeFile(filePath, content, "utf-8");
   return filePath;
@@ -4936,32 +5105,32 @@ function validateDsl(raw) {
   }
   return { valid: true, dsl: raw };
 }
-function validateFeature(raw, path42, errors) {
+function validateFeature(raw, path43, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path42, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path43, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const f = raw;
-  requireNonEmptyString(f["id"], `${path42}.id`, errors);
-  requireNonEmptyString(f["title"], `${path42}.title`, errors);
-  requireNonEmptyString(f["description"], `${path42}.description`, errors);
+  requireNonEmptyString(f["id"], `${path43}.id`, errors);
+  requireNonEmptyString(f["title"], `${path43}.title`, errors);
+  requireNonEmptyString(f["description"], `${path43}.description`, errors);
 }
-function validateModel(raw, path42, errors) {
+function validateModel(raw, path43, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path42, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path43, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const m = raw;
-  requireNonEmptyString(m["name"], `${path42}.name`, errors);
+  requireNonEmptyString(m["name"], `${path43}.name`, errors);
   if (!Array.isArray(m["fields"])) {
-    errors.push({ path: `${path42}.fields`, message: `Must be an array, got: ${typeLabel(m["fields"])}` });
+    errors.push({ path: `${path43}.fields`, message: `Must be an array, got: ${typeLabel(m["fields"])}` });
   } else {
     const fields = m["fields"];
     if (fields.length > MAX_FIELDS_PER_MODEL) {
-      errors.push({ path: `${path42}.fields`, message: `Too many fields (${fields.length} > ${MAX_FIELDS_PER_MODEL})` });
+      errors.push({ path: `${path43}.fields`, message: `Too many fields (${fields.length} > ${MAX_FIELDS_PER_MODEL})` });
     }
     for (let j2 = 0; j2 < Math.min(fields.length, MAX_FIELDS_PER_MODEL); j2++) {
-      validateModelField(fields[j2], `${path42}.fields[${j2}]`, errors);
+      validateModelField(fields[j2], `${path43}.fields[${j2}]`, errors);
     }
     const seenFieldNames = /* @__PURE__ */ new Set();
     for (let j2 = 0; j2 < Math.min(fields.length, MAX_FIELDS_PER_MODEL); j2++) {
@@ -4970,7 +5139,7 @@ function validateModel(raw, path42, errors) {
         const name = f["name"];
         if (seenFieldNames.has(name)) {
           errors.push({
-            path: `${path42}.fields[${j2}].name`,
+            path: `${path43}.fields[${j2}].name`,
             message: `Duplicate field name "${name}" \u2014 each field within a model must have a unique name`
           });
         } else {
@@ -4981,184 +5150,184 @@ function validateModel(raw, path42, errors) {
   }
   if (m["relations"] !== void 0) {
     if (!Array.isArray(m["relations"])) {
-      errors.push({ path: `${path42}.relations`, message: "Must be an array of strings if present" });
+      errors.push({ path: `${path43}.relations`, message: "Must be an array of strings if present" });
     } else {
       const rels = m["relations"];
       for (let j2 = 0; j2 < rels.length; j2++) {
         if (typeof rels[j2] !== "string") {
-          errors.push({ path: `${path42}.relations[${j2}]`, message: "Must be a string" });
+          errors.push({ path: `${path43}.relations[${j2}]`, message: "Must be a string" });
         }
       }
     }
   }
 }
-function validateModelField(raw, path42, errors) {
+function validateModelField(raw, path43, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path42, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path43, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const f = raw;
-  requireNonEmptyString(f["name"], `${path42}.name`, errors);
-  requireNonEmptyString(f["type"], `${path42}.type`, errors);
+  requireNonEmptyString(f["name"], `${path43}.name`, errors);
+  requireNonEmptyString(f["type"], `${path43}.type`, errors);
   if (typeof f["required"] !== "boolean") {
-    errors.push({ path: `${path42}.required`, message: `Must be boolean, got: ${typeLabel(f["required"])}` });
+    errors.push({ path: `${path43}.required`, message: `Must be boolean, got: ${typeLabel(f["required"])}` });
   }
 }
-function validateEndpoint(raw, path42, errors) {
+function validateEndpoint(raw, path43, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path42, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path43, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const e = raw;
-  requireNonEmptyString(e["id"], `${path42}.id`, errors);
-  requireNonEmptyString(e["description"], `${path42}.description`, errors);
+  requireNonEmptyString(e["id"], `${path43}.id`, errors);
+  requireNonEmptyString(e["description"], `${path43}.description`, errors);
   if (!VALID_METHODS.includes(e["method"])) {
     errors.push({
-      path: `${path42}.method`,
+      path: `${path43}.method`,
       message: `Must be one of ${VALID_METHODS.join("|")}, got: ${JSON.stringify(e["method"])}`
     });
   }
   if (typeof e["path"] !== "string" || !e["path"].startsWith("/")) {
     errors.push({
-      path: `${path42}.path`,
+      path: `${path43}.path`,
       message: `Must be a string starting with "/", got: ${JSON.stringify(e["path"])}`
     });
   }
   if (typeof e["auth"] !== "boolean") {
-    errors.push({ path: `${path42}.auth`, message: `Must be boolean, got: ${typeLabel(e["auth"])}` });
+    errors.push({ path: `${path43}.auth`, message: `Must be boolean, got: ${typeLabel(e["auth"])}` });
   }
   if (typeof e["successStatus"] !== "number" || e["successStatus"] < 100 || e["successStatus"] > 599) {
     errors.push({
-      path: `${path42}.successStatus`,
+      path: `${path43}.successStatus`,
       message: `Must be an HTTP status code (100-599), got: ${JSON.stringify(e["successStatus"])}`
     });
   }
-  requireNonEmptyString(e["successDescription"], `${path42}.successDescription`, errors);
+  requireNonEmptyString(e["successDescription"], `${path43}.successDescription`, errors);
   if (e["request"] !== void 0) {
-    validateRequestSchema(e["request"], `${path42}.request`, errors);
+    validateRequestSchema(e["request"], `${path43}.request`, errors);
   }
   if (e["errors"] !== void 0) {
     if (!Array.isArray(e["errors"])) {
-      errors.push({ path: `${path42}.errors`, message: "Must be an array if present" });
+      errors.push({ path: `${path43}.errors`, message: "Must be an array if present" });
     } else {
       const errs = e["errors"];
       if (errs.length > MAX_ERRORS_PER_ENDPOINT) {
-        errors.push({ path: `${path42}.errors`, message: `Too many error entries (${errs.length} > ${MAX_ERRORS_PER_ENDPOINT})` });
+        errors.push({ path: `${path43}.errors`, message: `Too many error entries (${errs.length} > ${MAX_ERRORS_PER_ENDPOINT})` });
       }
       for (let j2 = 0; j2 < Math.min(errs.length, MAX_ERRORS_PER_ENDPOINT); j2++) {
-        validateResponseError(errs[j2], `${path42}.errors[${j2}]`, errors);
+        validateResponseError(errs[j2], `${path43}.errors[${j2}]`, errors);
       }
     }
   }
 }
-function validateRequestSchema(raw, path42, errors) {
+function validateRequestSchema(raw, path43, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path42, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path43, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const r = raw;
   for (const key of ["body", "query", "params"]) {
     if (r[key] !== void 0) {
-      validateFieldMap(r[key], `${path42}.${key}`, errors);
+      validateFieldMap(r[key], `${path43}.${key}`, errors);
     }
   }
 }
-function validateFieldMap(raw, path42, errors) {
+function validateFieldMap(raw, path43, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path42, message: `Must be a flat object (FieldMap), got: ${typeLabel(raw)}` });
+    errors.push({ path: path43, message: `Must be a flat object (FieldMap), got: ${typeLabel(raw)}` });
     return;
   }
   const map = raw;
   for (const [k2, v2] of Object.entries(map)) {
     if (typeof v2 !== "string") {
-      errors.push({ path: `${path42}.${k2}`, message: `Value must be a type-description string, got: ${typeLabel(v2)}` });
+      errors.push({ path: `${path43}.${k2}`, message: `Value must be a type-description string, got: ${typeLabel(v2)}` });
     }
   }
 }
-function validateResponseError(raw, path42, errors) {
+function validateResponseError(raw, path43, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path42, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path43, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const e = raw;
   if (typeof e["status"] !== "number" || e["status"] < 100 || e["status"] > 599) {
-    errors.push({ path: `${path42}.status`, message: `Must be an HTTP status code (100-599), got: ${JSON.stringify(e["status"])}` });
+    errors.push({ path: `${path43}.status`, message: `Must be an HTTP status code (100-599), got: ${JSON.stringify(e["status"])}` });
   }
-  requireNonEmptyString(e["code"], `${path42}.code`, errors);
-  requireNonEmptyString(e["description"], `${path42}.description`, errors);
+  requireNonEmptyString(e["code"], `${path43}.code`, errors);
+  requireNonEmptyString(e["description"], `${path43}.description`, errors);
 }
-function validateBehavior(raw, path42, errors) {
+function validateBehavior(raw, path43, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path42, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path43, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const b = raw;
-  requireNonEmptyString(b["id"], `${path42}.id`, errors);
-  requireNonEmptyString(b["description"], `${path42}.description`, errors);
+  requireNonEmptyString(b["id"], `${path43}.id`, errors);
+  requireNonEmptyString(b["description"], `${path43}.description`, errors);
   if (b["constraints"] !== void 0) {
     if (!Array.isArray(b["constraints"])) {
-      errors.push({ path: `${path42}.constraints`, message: "Must be an array of strings if present" });
+      errors.push({ path: `${path43}.constraints`, message: "Must be an array of strings if present" });
     } else {
       const cs2 = b["constraints"];
       for (let j2 = 0; j2 < cs2.length; j2++) {
         if (typeof cs2[j2] !== "string") {
-          errors.push({ path: `${path42}.constraints[${j2}]`, message: "Must be a string" });
+          errors.push({ path: `${path43}.constraints[${j2}]`, message: "Must be a string" });
         }
       }
     }
   }
 }
-function validateComponent(raw, path42, errors) {
+function validateComponent(raw, path43, errors) {
   if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    errors.push({ path: path42, message: `Must be an object, got: ${typeLabel(raw)}` });
+    errors.push({ path: path43, message: `Must be an object, got: ${typeLabel(raw)}` });
     return;
   }
   const c = raw;
-  requireNonEmptyString(c["id"], `${path42}.id`, errors);
-  requireNonEmptyString(c["name"], `${path42}.name`, errors);
-  requireNonEmptyString(c["description"], `${path42}.description`, errors);
+  requireNonEmptyString(c["id"], `${path43}.id`, errors);
+  requireNonEmptyString(c["name"], `${path43}.name`, errors);
+  requireNonEmptyString(c["description"], `${path43}.description`, errors);
   if (c["props"] !== void 0) {
     if (!Array.isArray(c["props"])) {
-      errors.push({ path: `${path42}.props`, message: "Must be an array if present" });
+      errors.push({ path: `${path43}.props`, message: "Must be an array if present" });
     } else {
       const props = c["props"];
       for (let j2 = 0; j2 < props.length; j2++) {
         const p = props[j2];
         if (typeof p !== "object" || p === null) {
-          errors.push({ path: `${path42}.props[${j2}]`, message: "Must be an object" });
+          errors.push({ path: `${path43}.props[${j2}]`, message: "Must be an object" });
           continue;
         }
-        requireNonEmptyString(p["name"], `${path42}.props[${j2}].name`, errors);
-        requireNonEmptyString(p["type"], `${path42}.props[${j2}].type`, errors);
+        requireNonEmptyString(p["name"], `${path43}.props[${j2}].name`, errors);
+        requireNonEmptyString(p["type"], `${path43}.props[${j2}].type`, errors);
         if (typeof p["required"] !== "boolean") {
-          errors.push({ path: `${path42}.props[${j2}].required`, message: "Must be boolean" });
+          errors.push({ path: `${path43}.props[${j2}].required`, message: "Must be boolean" });
         }
       }
     }
   }
   if (c["events"] !== void 0) {
     if (!Array.isArray(c["events"])) {
-      errors.push({ path: `${path42}.events`, message: "Must be an array if present" });
+      errors.push({ path: `${path43}.events`, message: "Must be an array if present" });
     } else {
       const events = c["events"];
       for (let j2 = 0; j2 < events.length; j2++) {
         const e = events[j2];
         if (typeof e !== "object" || e === null) {
-          errors.push({ path: `${path42}.events[${j2}]`, message: "Must be an object" });
+          errors.push({ path: `${path43}.events[${j2}]`, message: "Must be an object" });
           continue;
         }
-        requireNonEmptyString(e["name"], `${path42}.events[${j2}].name`, errors);
+        requireNonEmptyString(e["name"], `${path43}.events[${j2}].name`, errors);
       }
     }
   }
   if (c["state"] !== void 0) {
     if (typeof c["state"] !== "object" || Array.isArray(c["state"]) || c["state"] === null) {
-      errors.push({ path: `${path42}.state`, message: "Must be a flat object (Record<string, string>) if present" });
+      errors.push({ path: `${path43}.state`, message: "Must be a flat object (Record<string, string>) if present" });
     }
   }
   if (c["apiCalls"] !== void 0) {
     if (!Array.isArray(c["apiCalls"])) {
-      errors.push({ path: `${path42}.apiCalls`, message: "Must be an array of strings if present" });
+      errors.push({ path: `${path43}.apiCalls`, message: "Must be an array of strings if present" });
     }
   }
 }
@@ -5220,10 +5389,10 @@ function crossReferenceChecks(obj, errors) {
     }
   }
 }
-function requireNonEmptyString(v2, path42, errors) {
+function requireNonEmptyString(v2, path43, errors) {
   if (typeof v2 !== "string" || v2.trim().length === 0) {
     errors.push({
-      path: path42,
+      path: path43,
       message: `Must be a non-empty string, got: ${typeLabel(v2)}`
     });
   }
@@ -5434,13 +5603,18 @@ Output ONLY the corrected JSON. No explanation.`;
 
 // core/token-budget.ts
 var import_chalk5 = __toESM(require("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);
-}
+
+// core/config-defaults.ts
+var DEFAULT_LOG_DIR = ".ai-spec-logs";
+var DEFAULT_VCR_DIR = ".ai-spec-vcr";
+var DEFAULT_BACKUP_DIR = ".ai-spec-backup";
+var DEFAULT_REVIEW_HISTORY_FILE = ".ai-spec-reviews.json";
+var DEFAULT_OPENAPI_SERVER_URL = "http://localhost:3000";
+var DEFAULT_MAX_COMMAND_OUTPUT_CHARS = 3e4;
+var DEFAULT_MAX_FIX_FILE_CHARS = 6e4;
+var DEFAULT_DSL_MAX_RETRIES = 2;
+var DEFAULT_MAX_CONSTITUTION_CHARS = 4e3;
+var DEFAULT_MAX_REVIEW_FILE_CHARS = 3e3;
 var DEFAULT_TOKEN_BUDGETS = {
   gemini: 9e5,
   claude: 18e4,
@@ -5448,8 +5622,18 @@ var DEFAULT_TOKEN_BUDGETS = {
   deepseek: 6e4,
   default: 1e5
 };
+
+// core/token-budget.ts
+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_BUDGETS2 = DEFAULT_TOKEN_BUDGETS;
 function getDefaultBudget(providerName) {
-  return DEFAULT_TOKEN_BUDGETS[providerName] ?? DEFAULT_TOKEN_BUDGETS.default;
+  return DEFAULT_TOKEN_BUDGETS2[providerName] ?? DEFAULT_TOKEN_BUDGETS2.default;
 }
 
 // core/safe-json.ts
@@ -5520,7 +5704,7 @@ function sanitizeDsl(raw) {
   }
   return dsl;
 }
-var MAX_RETRIES = 2;
+var MAX_RETRIES = DEFAULT_DSL_MAX_RETRIES;
 var DEFAULT_MAX_SPEC_CHARS = 12e3;
 function dslFilePath(specFilePath) {
   const dir = path7.dirname(specFilePath);
@@ -6244,12 +6428,11 @@ Shared component structure patterns:`);
 // core/run-snapshot.ts
 var fs10 = __toESM(require("fs-extra"));
 var path9 = __toESM(require("path"));
-var BACKUP_DIR = ".ai-spec-backup";
 var RunSnapshot = class {
   constructor(workingDir, runId) {
     this.workingDir = workingDir;
     this.runId = runId;
-    this.backupRoot = path9.join(workingDir, BACKUP_DIR, runId);
+    this.backupRoot = path9.join(workingDir, DEFAULT_BACKUP_DIR, runId);
   }
   backupRoot;
   snapshotted = /* @__PURE__ */ new Set();
@@ -6305,7 +6488,6 @@ function getActiveSnapshot() {
 var fs11 = __toESM(require("fs-extra"));
 var path10 = __toESM(require("path"));
 var import_chalk7 = __toESM(require("chalk"));
-var LOG_DIR = ".ai-spec-logs";
 function appendJsonlLine(filePath, record) {
   try {
     fs11.appendFileSync(filePath, JSON.stringify(record) + "\n");
@@ -6376,8 +6558,8 @@ var RunLogger = class {
     this.workingDir = workingDir;
     this.runId = runId;
     this.startMs = Date.now();
-    this.logPath = path10.join(workingDir, LOG_DIR, `${runId}.json`);
-    this.jsonlPath = path10.join(workingDir, LOG_DIR, `${runId}.jsonl`);
+    this.logPath = path10.join(workingDir, DEFAULT_LOG_DIR, `${runId}.json`);
+    this.jsonlPath = path10.join(workingDir, DEFAULT_LOG_DIR, `${runId}.jsonl`);
     this.log = {
       runId,
       startedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -6711,6 +6893,7 @@ function printTaskProgress(completed, total, task, mode) {
 }
 
 // core/code-generator.ts
+init_cli_ui();
 var CodeGenerator = class {
   constructor(provider, mode = "claude-code") {
     this.provider = provider;
@@ -7159,6 +7342,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 ${import_chalk9.default.bold(item.file)}...`);
       try {
         const raw = await this.provider.generate(codePrompt, systemPrompt);
         const fileContent = stripCodeFences(raw);
@@ -7166,11 +7350,11 @@ ${existingContent || "Output only the complete file content."}`;
         await fs12.ensureDir(path11.dirname(fullPath));
         await fs12.writeFile(fullPath, fileContent, "utf-8");
         getActiveLogger()?.fileWritten(item.file);
-        console.log(`${prefix}${existingContent ? import_chalk9.default.yellow("~") : import_chalk9.default.green("+")} ${import_chalk9.default.bold(item.file)} ${import_chalk9.default.green("\u2714")}`);
+        fileSpinner.succeed(`${existingContent ? import_chalk9.default.yellow("~") : import_chalk9.default.green("+")} ${import_chalk9.default.bold(item.file)}`);
         successCount++;
         writtenFiles.push(item.file);
       } catch (err) {
-        console.log(`${prefix}${import_chalk9.default.red("\u2718")} ${import_chalk9.default.bold(item.file)} \u2014 ${import_chalk9.default.red(err.message)}`);
+        fileSpinner.fail(`${import_chalk9.default.bold(item.file)} \u2014 ${err.message}`);
       }
     }
     if (!taskLabel) {
@@ -7317,7 +7501,7 @@ ${context.routeSummary}
   }
   if (context.schema) {
     parts.push(`=== Prisma Schema ===
-${context.schema.slice(0, 4e3)}
+${context.schema.slice(0, DEFAULT_MAX_CONSTITUTION_CHARS)}
 `);
   }
   if (context.errorPatterns) {
@@ -7365,7 +7549,7 @@ async function loadAccumulatedLessons(projectRoot) {
   const nextSection = section.slice(marker.length).match(/\n## \d/);
   return nextSection ? section.slice(0, marker.length + nextSection.index) : section;
 }
-var REVIEW_HISTORY_FILE = ".ai-spec-reviews.json";
+var REVIEW_HISTORY_FILE = DEFAULT_REVIEW_HISTORY_FILE;
 async function loadReviewHistory(projectRoot) {
   const historyPath = path13.join(projectRoot, REVIEW_HISTORY_FILE);
   try {
@@ -7496,15 +7680,13 @@ ${specContent || "(No spec \u2014 review for general code quality)"}
 ${codeContext}`;
     const archReview = await this.provider.generate(archPrompt, reviewArchitectureSystemPrompt);
     console.log(import_chalk11.default.gray("  Pass 2/3: Implementation review..."));
+    const specDigest = specContent && specContent.length > 600 ? specContent.slice(0, 600) + "\n... [spec truncated \u2014 see Pass 0/1 for full text]" : specContent || "(No spec)";
     const history = await loadReviewHistory(this.projectRoot);
     const historyContext = buildHistoryContext(history);
     const implPrompt = `Review the implementation details of this change.
 
-=== Feature Spec ===
-${specContent || "(No spec \u2014 review for general code quality)"}
-
-=== Code ===
-${codeContext}
+=== Feature Spec (digest \u2014 full spec was provided in Pass 0/1) ===
+${specDigest}
 
 === Architecture Review (Pass 1 \u2014 do NOT repeat these findings) ===
 ${archReview}
@@ -7513,11 +7695,8 @@ ${historyContext}`;
     console.log(import_chalk11.default.gray("  Pass 3/3: Impact & complexity assessment..."));
     const impactPrompt = `Assess the impact and complexity of this change.
 
-=== Feature Spec ===
-${specContent || "(No spec \u2014 review for general code quality)"}
-
-=== Code ===
-${codeContext}
+=== Feature Spec (digest) ===
+${specDigest}
 
 === Architecture Review (Pass 1 \u2014 do NOT repeat) ===
 ${archReview}
@@ -7591,8 +7770,8 @@ ${sep}
         filesSection += `
 
 === ${filePath} ===
-${content.slice(0, 3e3)}`;
-        if (content.length > 3e3) filesSection += `
+${content.slice(0, DEFAULT_MAX_REVIEW_FILE_CHARS)}`;
+        if (content.length > DEFAULT_MAX_REVIEW_FILE_CHARS) filesSection += `
 ... (truncated, ${content.length} chars total)`;
       } catch {
         filesSection += `
@@ -8196,8 +8375,9 @@ var import_chalk15 = __toESM(require("chalk"));
 var import_child_process5 = require("child_process");
 var fs18 = __toESM(require("fs-extra"));
 var path17 = __toESM(require("path"));
-var MAX_COMMAND_OUTPUT_CHARS = 5e4;
-var MAX_FIX_FILE_CHARS = 6e4;
+init_cli_ui();
+var MAX_COMMAND_OUTPUT_CHARS = DEFAULT_MAX_COMMAND_OUTPUT_CHARS;
+var MAX_FIX_FILE_CHARS = DEFAULT_MAX_FIX_FILE_CHARS;
 function runCommand(cmd, cwd) {
   try {
     const output = (0, import_child_process5.execSync)(cmd, { cwd, encoding: "utf-8", timeout: 6e4 });
@@ -8387,16 +8567,17 @@ ${errorSummary}
 ${fileContent}
 
 Output ONLY the complete fixed file content. No markdown fences, no explanations.`;
+    const fixSpinner = startSpinner(`Fixing ${import_chalk15.default.bold(file)} (${fileErrors.length} error(s))...`);
     try {
       const raw = await provider.generate(prompt, getCodeGenSystemPrompt());
       const fixed = raw.replace(/^```\w*\n?/gm, "").replace(/\n?```$/gm, "").trim();
       await getActiveSnapshot()?.snapshotFile(fullPath);
       await fs18.writeFile(fullPath, fixed, "utf-8");
       results.push({ fixed: true, file, explanation: `Fixed ${fileErrors.length} error(s)` });
-      console.log(import_chalk15.default.green(`  \u2714 Auto-fixed: ${file}`));
+      fixSpinner.succeed(`Auto-fixed: ${file}`);
     } catch (err) {
       results.push({ fixed: false, file, explanation: `AI fix failed: ${err.message}` });
-      console.log(import_chalk15.default.yellow(`  \u26A0 Could not auto-fix: ${file}`));
+      fixSpinner.fail(`Could not auto-fix: ${file}`);
     }
   }
   return results;
@@ -9405,8 +9586,8 @@ async function findLatestDslFile(projectDir) {
     const entries = await fs22.readdir(dir);
     for (const entry of entries) {
       const abs = path21.join(dir, entry);
-      const stat4 = await fs22.stat(abs);
-      if (stat4.isDirectory()) {
+      const stat5 = await fs22.stat(abs);
+      if (stat5.isDirectory()) {
         await scan(abs);
       } else if (entry.endsWith(".dsl.json")) {
         allFiles.push(abs);
@@ -11144,7 +11325,7 @@ ${optionsText}`;
 var import_crypto2 = require("crypto");
 var fs24 = __toESM(require("fs-extra"));
 var path23 = __toESM(require("path"));
-var VCR_DIR = ".ai-spec-vcr";
+var VCR_DIR = DEFAULT_VCR_DIR;
 var VcrRecordingProvider = class {
   constructor(inner) {
     this.inner = inner;
@@ -11272,6 +11453,7 @@ async function listVcrRecordings(workingDir) {
 }
 
 // cli/pipeline/single-repo.ts
+init_cli_ui();
 async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
   const specProviderName = opts.provider || config2.provider || "gemini";
   const specModelName = opts.model || config2.model || DEFAULT_MODELS[specProviderName];
@@ -11334,7 +11516,7 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
       console.log(import_chalk25.default.yellow(`  \u26A0 Constitution is long (${context.constitution.length.toLocaleString()} chars). Consider running: ai-spec init --consolidate`));
     }
   } else {
-    console.log(import_chalk25.default.yellow("  Constitution : not found \u2014 auto-generating..."));
+    const constitutionSpinner = startSpinner("Constitution not found \u2014 auto-generating...");
     try {
       const constitutionGen = new ConstitutionGenerator(
         createProvider(specProviderName, specApiKey, specModelName)
@@ -11342,9 +11524,9 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
       const constitutionContent = await constitutionGen.generate(currentDir);
       await constitutionGen.saveConstitution(currentDir, constitutionContent);
       context.constitution = constitutionContent;
-      console.log(import_chalk25.default.green(`  Constitution : \u2714 generated and saved (.ai-spec-constitution.md)`));
+      constitutionSpinner.succeed("Constitution generated and saved (.ai-spec-constitution.md)");
     } catch (err) {
-      console.log(import_chalk25.default.yellow(`  Constitution : \u26A0 auto-generation failed (${err.message}), continuing without it.`));
+      constitutionSpinner.fail(`Constitution auto-generation failed (${err.message}), continuing without it.`);
     }
   }
   let architectureDecision;
@@ -11375,17 +11557,18 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
   let initialSpec;
   let initialTasks = [];
   runLogger.stageStart("spec_gen", { provider: specProviderName, model: specModelName });
+  const specSpinner = startStage("spec_gen", `Generating spec with ${specProviderName}/${specModelName}...`);
   try {
     if (opts.skipTasks) {
       const { SpecGenerator: SpecGenerator2 } = await Promise.resolve().then(() => (init_spec_generator(), spec_generator_exports));
       const generator = new SpecGenerator2(specProvider);
       initialSpec = await generator.generateSpec(idea, context, architectureDecision);
-      console.log(import_chalk25.default.green("  \u2714 Spec generated."));
+      specSpinner.succeed("Spec generated.");
     } else {
       const result = await generateSpecWithTasks(specProvider, idea, context, architectureDecision);
       initialSpec = result.spec;
       initialTasks = result.tasks;
-      console.log(import_chalk25.default.green(`  \u2714 Spec generated.`));
+      specSpinner.succeed("Spec generated.");
       if (initialTasks.length > 0) {
         console.log(import_chalk25.default.green(`  \u2714 ${initialTasks.length} tasks generated (combined call).`));
       } else {
@@ -11394,8 +11577,8 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
     }
     runLogger.stageEnd("spec_gen", { taskCount: initialTasks.length });
   } catch (err) {
+    specSpinner.fail(`Spec generation failed: ${err.message}`);
     runLogger.stageFail("spec_gen", err.message);
-    console.error(import_chalk25.default.red("  \u2718 Spec generation failed:"), err);
     process.exit(1);
   }
   let finalSpec;
@@ -11417,7 +11600,9 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
       console.log(import_chalk25.default.blue("\n[3.4/6] Spec quality assessment..."));
     }
     runLogger.stageStart("spec_assess");
+    const assessSpinner = startStage("spec_assess", "Evaluating spec quality...");
     const assessment = await assessSpec(specProvider, finalSpec, context.constitution ?? void 0);
+    assessSpinner.stop();
     if (assessment) {
       runLogger.stageEnd("spec_assess", { overallScore: assessment.overallScore });
       if (!opts.auto) printSpecAssessment(assessment);
@@ -11509,21 +11694,24 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
     console.log(import_chalk25.default.blue("\n[DSL] Extracting structured DSL from spec..."));
     console.log(import_chalk25.default.gray(`  Provider: ${specProviderName}/${specModelName}`));
     runLogger.stageStart("dsl_extract");
+    const dslSpinner = startStage("dsl_extract", "Extracting DSL from spec...");
     try {
       const isFrontend = isFrontendDeps(context.dependencies);
-      if (isFrontend) console.log(import_chalk25.default.gray("  Frontend project detected \u2014 using ComponentSpec extractor"));
+      if (isFrontend) {
+        dslSpinner.update("\u{1F517}  Extracting DSL (frontend ComponentSpec mode)...");
+      }
       const dslExtractor = new DslExtractor(specProvider);
       extractedDsl = await dslExtractor.extract(finalSpec, { auto: opts.auto, isFrontend });
       if (extractedDsl) {
         runLogger.stageEnd("dsl_extract", { endpoints: extractedDsl.endpoints?.length ?? 0, models: extractedDsl.models?.length ?? 0 });
-        console.log(import_chalk25.default.green("  \u2714 DSL extracted and validated."));
+        dslSpinner.succeed("DSL extracted and validated.");
       } else {
         runLogger.stageEnd("dsl_extract", { skipped: true });
-        console.log(import_chalk25.default.yellow("  \u26A0 DSL skipped \u2014 codegen will use Spec + Tasks only."));
+        dslSpinner.fail("DSL skipped \u2014 codegen will use Spec + Tasks only.");
       }
     } catch (err) {
       runLogger.stageFail("dsl_extract", err.message);
-      console.log(import_chalk25.default.yellow(`  \u26A0 DSL extraction error: ${err.message} \u2014 continuing without DSL.`));
+      dslSpinner.fail(`DSL extraction error: ${err.message} \u2014 continuing without DSL.`);
     }
   }
   if (extractedDsl && !opts.auto && !opts.fast && !opts.skipDsl) {
@@ -11698,6 +11886,7 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
   if (!opts.skipReview) {
     console.log(import_chalk25.default.blue("\n[9/9] Automated code review (3-pass: architecture + implementation + impact/complexity)..."));
     runLogger.stageStart("review");
+    const reviewSpinner = startStage("review", "Running 3-pass code review...");
     const reviewer = new CodeReviewer(specProvider, workingDir);
     const savedSpec = await fs25.readFile(specFile, "utf-8");
     if (codegenMode === "api" && generatedFiles.length > 0) {
@@ -11705,6 +11894,7 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
     } else {
       reviewResult = await reviewer.reviewCode(savedSpec, specFile);
     }
+    reviewSpinner.succeed("Code review complete.");
     runLogger.stageEnd("review");
     const complianceScore = extractComplianceScore(reviewResult);
     const missingCount = extractMissingCount(reviewResult);
@@ -11833,7 +12023,147 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
   }
 }
 
+// core/repo-store.ts
+var fs26 = __toESM(require("fs-extra"));
+var path25 = __toESM(require("path"));
+var os5 = __toESM(require("os"));
+var REPO_STORE_FILE = path25.join(os5.homedir(), ".ai-spec-repos.json");
+async function readStore2() {
+  try {
+    if (await fs26.pathExists(REPO_STORE_FILE)) {
+      return await fs26.readJson(REPO_STORE_FILE);
+    }
+  } catch (err) {
+    console.warn(`Warning: Could not read repo store at ${REPO_STORE_FILE}: ${err.message}.`);
+  }
+  return { repos: [] };
+}
+async function writeStore2(store) {
+  await fs26.ensureFile(REPO_STORE_FILE);
+  await fs26.writeJson(REPO_STORE_FILE, store, { spaces: 2 });
+}
+async function getRegisteredRepos() {
+  const store = await readStore2();
+  return store.repos;
+}
+async function registerRepo(repo) {
+  const store = await readStore2();
+  const idx = store.repos.findIndex((r) => r.path === repo.path);
+  if (idx >= 0) {
+    store.repos[idx] = repo;
+  } else {
+    store.repos.push(repo);
+  }
+  await writeStore2(store);
+}
+
 // cli/commands/create.ts
+init_spec_generator();
+async function promptRepoRole() {
+  return (0, import_prompts7.select)({
+    message: "What type of repo is this?",
+    choices: [
+      { name: "Frontend", value: "frontend" },
+      { name: "Backend", value: "backend" },
+      { name: "Mobile", value: "mobile" },
+      { name: "Shared / Other", value: "shared" }
+    ]
+  });
+}
+async function quickRegisterRepo(provider) {
+  const roleOverride = await promptRepoRole();
+  const roleLabels = {
+    frontend: "frontend",
+    backend: "backend",
+    mobile: "mobile",
+    shared: "shared"
+  };
+  const raw = await (0, import_prompts7.input)({
+    message: `Enter your ${roleLabels[roleOverride]} repo path (absolute path):`,
+    validate: (v2) => {
+      const trimmed = v2.trim();
+      if (trimmed.length === 0) return "Path cannot be empty";
+      if (!path26.isAbsolute(trimmed)) return "Please provide an absolute path";
+      return true;
+    }
+  });
+  const cleaned = raw.trim().replace(/\\ /g, " ");
+  const resolved = path26.resolve(cleaned);
+  if (!await fs27.pathExists(resolved)) {
+    console.log(import_chalk26.default.red(`  Path does not exist: ${resolved}`));
+    return quickRegisterRepo(provider);
+  }
+  const { type, role: detectedRole } = await detectRepoType(resolved);
+  const role = roleOverride ?? detectedRole;
+  const repoName = path26.basename(resolved);
+  console.log(import_chalk26.default.gray(`  Detected: ${repoName} \u2192 ${type} (${role})`));
+  const constitutionPath = path26.join(resolved, CONSTITUTION_FILE);
+  let hasConstitution = await fs27.pathExists(constitutionPath);
+  if (!hasConstitution) {
+    console.log(import_chalk26.default.blue(`  Generating constitution for ${repoName}...`));
+    try {
+      const gen = new ConstitutionGenerator(provider);
+      const content = await gen.generate(resolved);
+      await gen.saveConstitution(resolved, content);
+      hasConstitution = true;
+      console.log(import_chalk26.default.green(`  \u2714 Constitution saved`));
+    } catch (err) {
+      console.log(import_chalk26.default.yellow(`  \u26A0 Constitution failed: ${err.message}`));
+    }
+  }
+  const entry = {
+    name: repoName,
+    path: resolved,
+    type,
+    role,
+    hasConstitution,
+    registeredAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  await registerRepo(entry);
+  console.log(import_chalk26.default.green(`  \u2714 Repo registered: ${repoName}`));
+  return entry;
+}
+async function selectRepos(registeredRepos, provider) {
+  const ADD_NEW = "__add_new__";
+  const choices = [
+    ...registeredRepos.map((r) => ({
+      name: `${r.name} (${r.type} / ${r.role}) \u2192 ${r.path}`,
+      value: r.path
+    })),
+    { name: import_chalk26.default.cyan("+ Add new repo"), value: ADD_NEW }
+  ];
+  const selected = await (0, import_prompts7.checkbox)({
+    message: "Select repo(s) for this feature (space to toggle, enter to confirm):",
+    choices,
+    required: true
+  });
+  const result = [];
+  for (const val of selected) {
+    if (val === ADD_NEW) {
+      const newRepo = await quickRegisterRepo(provider);
+      result.push(newRepo);
+    } else {
+      const repo = registeredRepos.find((r) => r.path === val);
+      if (repo) result.push(repo);
+    }
+  }
+  if (result.length === 0) {
+    console.log(import_chalk26.default.yellow("  No repos selected. Please select at least one."));
+    return selectRepos(registeredRepos, provider);
+  }
+  return result;
+}
+function buildWorkspaceConfig(repos) {
+  return {
+    name: "ai-spec-workspace",
+    repos: repos.map((r) => ({
+      name: r.name,
+      path: r.path,
+      type: r.type,
+      role: r.role
+    }))
+  };
+}
 function registerCreate(program2) {
   program2.command("create").description("Generate a feature spec and kick off code generation").argument("[idea]", "Feature idea in natural language (prompted if omitted)").option(
     "--provider <name>",
@@ -11856,24 +12186,75 @@ function registerCreate(program2) {
       });
     }
     const workspaceLoader = new WorkspaceLoader(currentDir);
-    const workspaceConfig = await workspaceLoader.load();
-    if (workspaceConfig) {
+    const existingWorkspaceConfig = await workspaceLoader.load();
+    if (existingWorkspaceConfig) {
       console.log(import_chalk26.default.cyan(`
-[Workspace] Detected workspace: ${workspaceConfig.name}`));
-      console.log(import_chalk26.default.gray(`  Repos: ${workspaceConfig.repos.map((r) => r.name).join(", ")}`));
-      const pipelineResults = await runMultiRepoPipeline(idea, workspaceConfig, opts, currentDir, config2);
+[Workspace] Detected workspace: ${existingWorkspaceConfig.name}`));
+      console.log(import_chalk26.default.gray(`  Repos: ${existingWorkspaceConfig.repos.map((r) => r.name).join(", ")}`));
+      const pipelineResults = await runMultiRepoPipeline(idea, existingWorkspaceConfig, opts, currentDir, config2);
       if (opts.serve) {
         await handleAutoServe(pipelineResults);
       }
       return;
     }
-    await runSingleRepoPipeline(idea, opts, currentDir, config2);
+    const providerName = opts.provider || config2.provider || "gemini";
+    const modelName = opts.model || config2.model || DEFAULT_MODELS[providerName];
+    const apiKey = await resolveApiKey(providerName, opts.key);
+    const specProvider = createProvider(providerName, apiKey, modelName);
+    const registeredRepos = await getRegisteredRepos();
+    if (registeredRepos.length === 0) {
+      console.log(import_chalk26.default.yellow("\n  No repos registered. Please register repos first."));
+      console.log(import_chalk26.default.gray("  Run: ai-spec init"));
+      console.log(import_chalk26.default.gray("  Or add a repo now:\n"));
+      const addNow = await (0, import_prompts7.select)({
+        message: "Add a repo now?",
+        choices: [
+          { name: "Yes \u2014 register a repo and continue", value: "yes" },
+          { name: "No \u2014 exit", value: "no" }
+        ]
+      });
+      if (addNow === "no") {
+        process.exit(0);
+      }
+      const newRepo = await quickRegisterRepo(specProvider);
+      registeredRepos.push(newRepo);
+    }
+    const validRepos = [];
+    for (const r of registeredRepos) {
+      if (await fs27.pathExists(r.path)) {
+        validRepos.push(r);
+      } else {
+        console.log(import_chalk26.default.yellow(`  \u26A0 Skipping ${r.name}: path not found (${r.path})`));
+      }
+    }
+    if (validRepos.length === 0) {
+      console.log(import_chalk26.default.red("  No valid repos available. Run: ai-spec init"));
+      process.exit(1);
+    }
+    const selectedRepos = await selectRepos(validRepos, specProvider);
+    if (selectedRepos.length === 1) {
+      const repo = selectedRepos[0];
+      console.log(import_chalk26.default.cyan(`
+[Repo] ${repo.name} (${repo.type}/${repo.role}) \u2192 ${repo.path}`));
+      await runSingleRepoPipeline(idea, opts, repo.path, config2);
+    } else {
+      const workspaceConfig = buildWorkspaceConfig(selectedRepos);
+      console.log(import_chalk26.default.cyan(`
+[Workspace] ${selectedRepos.length} repo(s) selected:`));
+      for (const repo of selectedRepos) {
+        console.log(import_chalk26.default.gray(`  ${repo.name} (${repo.type}/${repo.role}) \u2192 ${repo.path}`));
+      }
+      const pipelineResults = await runMultiRepoPipeline(idea, workspaceConfig, opts, currentDir, config2);
+      if (opts.serve) {
+        await handleAutoServe(pipelineResults);
+      }
+    }
   });
 }
 
 // cli/commands/review.ts
-var path25 = __toESM(require("path"));
-var fs26 = __toESM(require("fs-extra"));
+var path27 = __toESM(require("path"));
+var fs28 = __toESM(require("fs-extra"));
 var import_chalk27 = __toESM(require("chalk"));
 init_spec_generator();
 function registerReview(program2) {
@@ -11891,17 +12272,17 @@ function registerReview(program2) {
     const reviewer = new CodeReviewer(provider, currentDir);
     let specContent = "";
     let resolvedSpecFile;
-    if (specFile && await fs26.pathExists(specFile)) {
-      specContent = await fs26.readFile(specFile, "utf-8");
+    if (specFile && await fs28.pathExists(specFile)) {
+      specContent = await fs28.readFile(specFile, "utf-8");
       resolvedSpecFile = specFile;
       console.log(import_chalk27.default.gray(`Using spec: ${specFile}`));
     } else {
-      const specsDir = path25.join(currentDir, "specs");
-      if (await fs26.pathExists(specsDir)) {
-        const files = (await fs26.readdir(specsDir)).filter((f) => f.endsWith(".md")).sort().reverse();
+      const specsDir = path27.join(currentDir, "specs");
+      if (await fs28.pathExists(specsDir)) {
+        const files = (await fs28.readdir(specsDir)).filter((f) => f.endsWith(".md")).sort().reverse();
         if (files.length > 0) {
-          const latest = path25.join(specsDir, files[0]);
-          specContent = await fs26.readFile(latest, "utf-8");
+          const latest = path27.join(specsDir, files[0]);
+          specContent = await fs28.readFile(latest, "utf-8");
           resolvedSpecFile = latest;
           console.log(import_chalk27.default.gray(`Auto-detected spec: specs/${files[0]}`));
         }
@@ -11916,9 +12297,10 @@ function registerReview(program2) {
 }
 
 // cli/commands/init.ts
-var path27 = __toESM(require("path"));
-var fs28 = __toESM(require("fs-extra"));
+var path28 = __toESM(require("path"));
+var fs29 = __toESM(require("fs-extra"));
 var import_chalk28 = __toESM(require("chalk"));
+var import_prompts8 = require("@inquirer/prompts");
 init_spec_generator();
 
 // prompts/global-constitution.prompt.ts
@@ -11980,240 +12362,139 @@ ${summary}
   return parts.join("\n");
 }
 
-// core/project-index.ts
-var fs27 = __toESM(require("fs-extra"));
-var path26 = __toESM(require("path"));
-var INDEX_FILE = ".ai-spec-index.json";
-var KEY_DEPS = [
-  // Frameworks
-  "express",
-  "fastify",
-  "koa",
-  "@nestjs/core",
-  "hapi",
-  "next",
-  "react",
-  "vue",
-  "nuxt",
-  "svelte",
-  "react-native",
-  "expo",
-  // DB / ORM
-  "prisma",
-  "@prisma/client",
-  "mongoose",
-  "typeorm",
-  "sequelize",
-  "drizzle-orm",
-  // Auth
-  "jsonwebtoken",
-  "passport",
-  "next-auth",
-  "@clerk/nextjs",
-  // Build / Lang
-  "typescript",
-  "vite",
-  "webpack",
-  "esbuild",
-  "turbo",
-  // Testing
-  "jest",
-  "vitest",
-  "mocha",
-  "cypress",
-  "playwright",
-  // Infra
-  "redis",
-  "bull",
-  "socket.io",
-  "graphql",
-  "@trpc/server"
-];
-var SKIP_DIRS = /* @__PURE__ */ new Set([
-  "node_modules",
-  ".git",
-  ".svn",
-  "dist",
-  "build",
-  "out",
-  ".next",
-  ".nuxt",
-  "coverage",
-  ".turbo",
-  ".cache",
-  "__pycache__",
-  "vendor",
-  ".ai-spec-vcr",
-  ".ai-spec-logs",
-  "specs"
-]);
-var MANIFEST_FILES = [
-  "package.json",
-  "go.mod",
-  "Cargo.toml",
-  "pom.xml",
-  "build.gradle",
-  "build.gradle.kts",
-  "requirements.txt",
-  "pyproject.toml",
-  "setup.py",
-  "composer.json"
-];
-async function isProjectRoot(absPath) {
-  for (const manifest of MANIFEST_FILES) {
-    if (await fs27.pathExists(path26.join(absPath, manifest))) return true;
-  }
-  return false;
+// cli/commands/init.ts
+var ROLE_LABELS = {
+  frontend: "frontend",
+  backend: "backend",
+  mobile: "mobile",
+  shared: "shared"
+};
+async function promptRepoRole2() {
+  return (0, import_prompts8.select)({
+    message: "What type of repo is this?",
+    choices: [
+      { name: "Frontend", value: "frontend" },
+      { name: "Backend", value: "backend" },
+      { name: "Mobile", value: "mobile" },
+      { name: "Shared / Other", value: "shared" }
+    ]
+  });
 }
-async function extractTechStack(absPath, type) {
-  const stack = [];
-  if (type === "go") stack.push("go");
-  if (type === "rust") stack.push("rust");
-  if (type === "java") stack.push("java");
-  if (type === "python") stack.push("python");
-  if (type === "php") stack.push("php");
-  const pkgPath = path26.join(absPath, "package.json");
-  if (!await fs27.pathExists(pkgPath)) return stack;
-  let pkg = {};
-  try {
-    pkg = await fs27.readJson(pkgPath);
-  } catch {
-    return stack;
-  }
-  const allDeps = {
-    ...pkg.dependencies ?? {},
-    ...pkg.devDependencies ?? {}
+async function promptRepoPath(role) {
+  const label = ROLE_LABELS[role];
+  const raw = await (0, import_prompts8.input)({
+    message: `Enter your ${label} repo path (absolute path):`,
+    validate: (v2) => {
+      const trimmed = v2.trim();
+      if (trimmed.length === 0) return "Path cannot be empty";
+      if (!path28.isAbsolute(trimmed)) return "Please provide an absolute path";
+      return true;
+    }
+  });
+  const cleaned = raw.trim().replace(/\\ /g, " ");
+  const resolved = path28.resolve(cleaned);
+  if (!await fs29.pathExists(resolved)) {
+    console.log(import_chalk28.default.red(`  Path does not exist: ${resolved}`));
+    return promptRepoPath(role);
+  }
+  const stat5 = await fs29.stat(resolved);
+  if (!stat5.isDirectory()) {
+    console.log(import_chalk28.default.red(`  Not a directory: ${resolved}`));
+    return promptRepoPath(role);
+  }
+  return resolved;
+}
+async function registerSingleRepo(repoPath, provider, roleOverride) {
+  const { type, role: detectedRole } = await detectRepoType(repoPath);
+  const role = roleOverride ?? detectedRole;
+  const repoName = path28.basename(repoPath);
+  console.log(import_chalk28.default.gray(`    Detected: ${repoName} \u2192 ${type} (${role})`));
+  const constitutionPath = path28.join(repoPath, CONSTITUTION_FILE);
+  let hasConstitution = await fs29.pathExists(constitutionPath);
+  if (!hasConstitution) {
+    console.log(import_chalk28.default.blue(`    Generating project constitution for ${repoName}...`));
+    try {
+      const gen = new ConstitutionGenerator(provider);
+      const content = await gen.generate(repoPath);
+      await gen.saveConstitution(repoPath, content);
+      hasConstitution = true;
+      console.log(import_chalk28.default.green(`    \u2714 Constitution saved: ${constitutionPath}`));
+    } catch (err) {
+      console.log(import_chalk28.default.yellow(`    \u26A0 Constitution generation failed: ${err.message}`));
+    }
+  } else {
+    console.log(import_chalk28.default.green(`    \u2714 Constitution already exists: ${constitutionPath}`));
+  }
+  const entry = {
+    name: repoName,
+    path: repoPath,
+    type,
+    role,
+    hasConstitution,
+    registeredAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  const depKeys = new Set(Object.keys(allDeps));
-  for (const dep of KEY_DEPS) {
-    if (depKeys.has(dep)) stack.push(dep);
-  }
-  return stack;
-}
-async function discoverProjects(rootDir, maxDepth) {
-  const found = [];
-  async function walk(absDir, depth) {
-    if (depth > maxDepth) return;
-    let entries;
+  await registerRepo(entry);
+  return entry;
+}
+async function buildProjectSummaries(repos) {
+  const summaries = [];
+  for (const repo of repos) {
+    if (!await fs29.pathExists(repo.path)) continue;
+    const lines = [
+      `Type: ${repo.type} (${repo.role})`
+    ];
     try {
-      entries = await fs27.readdir(absDir, { withFileTypes: true });
+      const loader = new ContextLoader(repo.path);
+      const ctx = await loader.loadProjectContext();
+      lines.push(`Tech stack: ${ctx.techStack.join(", ") || "unknown"}`);
+      lines.push(`Dependencies: ${ctx.dependencies.slice(0, 20).join(", ")}`);
     } catch {
-      return;
+      lines.push(`Tech stack: ${repo.type}`);
     }
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      if (SKIP_DIRS.has(entry.name) || entry.name.startsWith(".")) continue;
-      const childAbs = path26.join(absDir, entry.name);
-      const gitPath = path26.join(childAbs, ".git");
-      if (await fs27.pathExists(gitPath)) {
-        const gitStat = await fs27.stat(gitPath);
-        if (gitStat.isFile()) continue;
-      }
-      if (await isProjectRoot(childAbs)) {
-        found.push(path26.relative(rootDir, childAbs));
-      } else {
-        await walk(childAbs, depth + 1);
+    if (repo.hasConstitution) {
+      try {
+        const constitutionPath = path28.join(repo.path, CONSTITUTION_FILE);
+        const raw = await fs29.readFile(constitutionPath, "utf-8");
+        lines.push("", "Constitution excerpt:", raw.slice(0, 2e3));
+      } catch {
       }
     }
+    summaries.push({ name: repo.name, summary: lines.join("\n") });
   }
-  await walk(rootDir, 0);
-  return found;
+  return summaries;
 }
-async function loadIndex(scanRoot) {
-  const filePath = path26.join(scanRoot, INDEX_FILE);
-  try {
-    return await fs27.readJson(filePath);
-  } catch {
-    return null;
+async function generateGlobalConstitution(provider, repos, currentDir) {
+  console.log(import_chalk28.default.blue("\n\u2500\u2500\u2500 Generating Global Constitution \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(import_chalk28.default.gray(`  Based on ${repos.length} registered repo(s)`));
+  const summaries = await buildProjectSummaries(repos);
+  if (summaries.length === 0) {
+    console.log(import_chalk28.default.yellow("  No valid repos found \u2014 skipping global constitution."));
+    return;
   }
-}
-async function saveIndex(scanRoot, index) {
-  const filePath = path26.join(scanRoot, INDEX_FILE);
-  await fs27.writeJson(filePath, index, { spaces: 2 });
-  return filePath;
-}
-async function runScan(scanRoot, maxDepth = 2) {
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const existing = await loadIndex(scanRoot);
-  const existingMap = new Map(
-    (existing?.projects ?? []).map((p) => [p.path, p])
-  );
-  const discoveredPaths = await discoverProjects(scanRoot, maxDepth);
-  const added = [];
-  const updated = [];
-  const unchanged = [];
-  const seenPaths = /* @__PURE__ */ new Set();
-  for (const relPath of discoveredPaths) {
-    const absPath = path26.join(scanRoot, relPath);
-    seenPaths.add(relPath);
-    const { type, role } = await detectRepoType(absPath);
-    const techStack = await extractTechStack(absPath, type);
-    const hasConstitution = await fs27.pathExists(path26.join(absPath, CONSTITUTION_FILE));
-    const hasWorkspace = await fs27.pathExists(path26.join(absPath, WORKSPACE_CONFIG_FILE));
-    const name = path26.basename(relPath);
-    const prev = existingMap.get(relPath);
-    if (!prev) {
-      const entry = {
-        name,
-        path: relPath,
-        type,
-        role,
-        techStack,
-        hasConstitution,
-        hasWorkspace,
-        firstSeen: now,
-        lastSeen: now
-      };
-      added.push(entry);
-      existingMap.set(relPath, entry);
-    } else {
-      const changed = prev.type !== type || prev.role !== role || prev.hasConstitution !== hasConstitution || prev.hasWorkspace !== hasWorkspace || JSON.stringify(prev.techStack.sort()) !== JSON.stringify(techStack.sort());
-      const entry = {
-        ...prev,
-        type,
-        role,
-        techStack,
-        hasConstitution,
-        hasWorkspace,
-        lastSeen: now,
-        missing: void 0
-        // clear missing flag if it came back
-      };
-      existingMap.set(relPath, entry);
-      if (changed) {
-        updated.push(entry);
-      } else {
-        unchanged.push(entry);
-      }
-    }
+  const prompt = buildGlobalConstitutionPrompt(summaries);
+  let globalConstitution;
+  try {
+    globalConstitution = await provider.generate(prompt, globalConstitutionSystemPrompt);
+  } catch (err) {
+    console.error(import_chalk28.default.red(`  \u2718 Failed to generate global constitution: ${err.message}`));
+    return;
   }
-  const nowMissing = [];
-  for (const [relPath, entry] of existingMap) {
-    if (!seenPaths.has(relPath) && !entry.missing) {
-      const gone = { ...entry, missing: true };
-      existingMap.set(relPath, gone);
-      nowMissing.push(gone);
-    }
+  const saved = await saveGlobalConstitution(globalConstitution, currentDir);
+  console.log(import_chalk28.default.green(`  \u2714 Global constitution saved: ${saved}`));
+  console.log(import_chalk28.default.gray("  Project constitutions will be merged with this at runtime."));
+  const lines = globalConstitution.split("\n");
+  console.log(import_chalk28.default.bold("\n  Preview:"));
+  console.log(import_chalk28.default.gray(lines.slice(0, 10).join("\n")));
+  if (lines.length > 10) {
+    console.log(import_chalk28.default.gray(`  ... (${lines.length} lines total)`));
   }
-  const projects = [...existingMap.values()].sort((a, b) => a.path.localeCompare(b.path));
-  const index = {
-    scanRoot,
-    lastScanned: now,
-    projects
-  };
-  return { index, added, updated, unchanged, nowMissing };
 }
-
-// cli/commands/init.ts
 function registerInit(program2) {
-  program2.command("init").description(`Analyze codebase and generate Project Constitution (${CONSTITUTION_FILE})`).option(
+  program2.command("init").description("Setup workspace: register repos, generate constitutions").option(
     "--provider <name>",
     `AI provider (${SUPPORTED_PROVIDERS.join("|")})`,
     void 0
-  ).option("--model <name>", "Model name").option("-k, --key <apiKey>", "API key").option("--force", "Overwrite existing constitution").option(
-    "--global",
-    `Generate a Global Constitution (~/${GLOBAL_CONSTITUTION_FILE}) instead of a project-level one`
-  ).option("--consolidate", "Consolidate \xA79 accumulated lessons into \xA71\u2013\xA78 core rules (prune & rebase)").option("--dry-run", "Preview consolidation result without writing (use with --consolidate)").action(async (opts) => {
+  ).option("--model <name>", "Model name").option("-k, --key <apiKey>", "API key").option("--force", "Overwrite existing constitutions").option("--consolidate", "Consolidate \xA79 accumulated lessons into \xA71\u2013\xA78 core rules").option("--dry-run", "Preview consolidation result without writing (use with --consolidate)").option("--add-repo", "Add a new repo to the registered list").action(async (opts) => {
     const currentDir = process.cwd();
     const config2 = await loadConfig(currentDir);
     const providerName = opts.provider || config2.provider || "gemini";
@@ -12232,7 +12513,7 @@ function registerInit(program2) {
           console.log(import_chalk28.default.gray(`  Lines : ${result.before.totalLines} \u2192 ${result.after.totalLines} (${result.before.totalLines - result.after.totalLines > 0 ? "-" : "+"}${Math.abs(result.before.totalLines - result.after.totalLines)})`));
           console.log(import_chalk28.default.gray(`  \xA79    : ${result.before.lessonCount} \u2192 ${result.after.lessonCount} lessons remaining`));
           if (result.backupPath) {
-            console.log(import_chalk28.default.gray(`  Backup: ${path27.basename(result.backupPath)}`));
+            console.log(import_chalk28.default.gray(`  Backup: ${path28.basename(result.backupPath)}`));
           }
         }
       } catch (err) {
@@ -12241,119 +12522,125 @@ function registerInit(program2) {
       }
       return;
     }
-    if (opts.global) {
-      const existing = await loadGlobalConstitution([currentDir]);
-      if (existing && !opts.force) {
-        console.log(import_chalk28.default.yellow(`
-  Global constitution already exists at: ${existing.source}`));
-        console.log(import_chalk28.default.gray("  Use --force to overwrite it."));
-        return;
+    if (opts.addRepo) {
+      console.log(import_chalk28.default.blue("\n\u2500\u2500\u2500 Register New Repo \u2500\u2500\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 role = await promptRepoRole2();
+      const repoPath = await promptRepoPath(role);
+      const entry = await registerSingleRepo(repoPath, provider, role);
+      console.log(import_chalk28.default.green(`
+  \u2714 Repo registered: ${entry.name} (${entry.type} / ${entry.role})`));
+      console.log(import_chalk28.default.gray(`    Saved to: ${REPO_STORE_FILE}`));
+      const updateGlobal = await (0, import_prompts8.confirm)({
+        message: "Update global constitution with this repo's context?",
+        default: true
+      });
+      if (updateGlobal) {
+        const allRepos2 = await getRegisteredRepos();
+        await generateGlobalConstitution(provider, allRepos2, currentDir);
       }
-      console.log(import_chalk28.default.blue("\n\u2500\u2500\u2500 Generating Global Constitution \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-      console.log(import_chalk28.default.gray(`  Provider: ${providerName}/${modelName}`));
-      const projectSummaries = [];
-      const index = await loadIndex(currentDir);
-      if (index && index.projects.length > 0) {
-        const active = index.projects.filter((p) => !p.missing);
-        console.log(import_chalk28.default.gray(`  Found project index: ${active.length} project(s) \u2014 reading constitutions...`));
-        for (const entry of active) {
-          const absPath = path27.join(currentDir, entry.path);
-          const lines = [
-            `Type: ${entry.type} (${entry.role})`,
-            `Tech stack: ${entry.techStack.join(", ") || "unknown"}`
-          ];
-          if (entry.hasConstitution) {
-            try {
-              const constitutionPath2 = path27.join(absPath, CONSTITUTION_FILE);
-              const raw = await fs28.readFile(constitutionPath2, "utf-8");
-              const excerpt = raw.slice(0, 2e3);
-              lines.push("", "Constitution excerpt:", excerpt);
-            } catch {
-            }
-          }
-          projectSummaries.push({ name: entry.name, summary: lines.join("\n") });
+      return;
+    }
+    console.log(import_chalk28.default.blue("\n" + "\u2500".repeat(52)));
+    console.log(import_chalk28.default.bold("  ai-spec init \u2014 Workspace Setup"));
+    console.log(import_chalk28.default.blue("\u2500".repeat(52)));
+    console.log(import_chalk28.default.gray(`  Provider: ${providerName}/${modelName}
+`));
+    const existingRepos = await getRegisteredRepos();
+    if (existingRepos.length > 0) {
+      console.log(import_chalk28.default.cyan("  Registered repos:"));
+      for (const r of existingRepos) {
+        const constitutionIcon = r.hasConstitution ? import_chalk28.default.green("\u2714") : import_chalk28.default.gray("\u25CB");
+        console.log(import_chalk28.default.gray(`    ${constitutionIcon} ${r.name} (${r.type} / ${r.role}) \u2192 ${r.path}`));
+      }
+      console.log();
+    }
+    const action = existingRepos.length > 0 ? await (0, import_prompts8.select)({
+      message: "What would you like to do?",
+      choices: [
+        { name: "Add new repo(s)", value: "add" },
+        { name: "Re-generate constitutions for existing repos", value: "regen" },
+        { name: "Skip \u2014 proceed to global constitution", value: "skip" }
+      ]
+    }) : "add";
+    const newRepos = [];
+    if (action === "add") {
+      let addMore = true;
+      while (addMore) {
+        console.log(import_chalk28.default.blue(`
+  \u2500\u2500 Register Repo #${existingRepos.length + newRepos.length + 1} \u2500\u2500`));
+        const role = await promptRepoRole2();
+        const repoPath = await promptRepoPath(role);
+        const alreadyRegistered = [...existingRepos, ...newRepos].find((r) => r.path === repoPath);
+        if (alreadyRegistered) {
+          console.log(import_chalk28.default.yellow(`    Already registered: ${alreadyRegistered.name}`));
+        } else {
+          const entry = await registerSingleRepo(repoPath, provider, role);
+          newRepos.push(entry);
+          console.log(import_chalk28.default.green(`    \u2714 Registered: ${entry.name}`));
         }
-      } else {
-        console.log(import_chalk28.default.yellow("  No project index found. Run `ai-spec scan` first for better results."));
-        console.log(import_chalk28.default.gray("  Falling back: scanning current directory only..."));
-        const loader = new ContextLoader(currentDir);
-        const ctx = await loader.loadProjectContext();
-        projectSummaries.push({
-          name: path27.basename(currentDir),
-          summary: [
-            `Tech stack: ${ctx.techStack.join(", ") || "unknown"}`,
-            `Dependencies: ${ctx.dependencies.slice(0, 20).join(", ")}`
-          ].join("\n")
+        addMore = await (0, import_prompts8.confirm)({
+          message: "Add another repo?",
+          default: false
         });
       }
-      console.log(import_chalk28.default.gray(`  Generating from ${projectSummaries.length} project(s)...`));
-      const prompt = buildGlobalConstitutionPrompt(projectSummaries);
-      let globalConstitution;
-      try {
-        globalConstitution = await provider.generate(prompt, globalConstitutionSystemPrompt);
-      } catch (err) {
-        console.error(import_chalk28.default.red("  \u2718 Failed to generate global constitution:"), err);
-        process.exit(1);
-      }
-      const saved2 = await saveGlobalConstitution(globalConstitution, currentDir);
-      console.log(import_chalk28.default.green(`
-  \u2714 Global constitution saved: ${saved2}`));
-      console.log(import_chalk28.default.gray("  This will be automatically merged into all project constitutions in this workspace."));
-      console.log(import_chalk28.default.gray("  Project-level rules always override global rules.\n"));
-      console.log(import_chalk28.default.bold("  Preview:"));
-      console.log(import_chalk28.default.gray(globalConstitution.split("\n").slice(0, 12).join("\n")));
-      if (globalConstitution.split("\n").length > 12) {
-        console.log(import_chalk28.default.gray(`  ... (${globalConstitution.split("\n").length} lines total)`));
+    }
+    if (action === "regen") {
+      console.log(import_chalk28.default.blue("\n  Re-generating project constitutions..."));
+      for (const repo of existingRepos) {
+        if (!await fs29.pathExists(repo.path)) {
+          console.log(import_chalk28.default.yellow(`    \u26A0 ${repo.name}: path not found \u2014 skipping`));
+          continue;
+        }
+        const constitutionPath = path28.join(repo.path, CONSTITUTION_FILE);
+        if (await fs29.pathExists(constitutionPath) && !opts.force) {
+          console.log(import_chalk28.default.gray(`    ${repo.name}: constitution exists (use --force to overwrite)`));
+          continue;
+        }
+        console.log(import_chalk28.default.blue(`    ${repo.name}: generating constitution...`));
+        try {
+          const gen = new ConstitutionGenerator(provider);
+          const content = await gen.generate(repo.path);
+          await gen.saveConstitution(repo.path, content);
+          console.log(import_chalk28.default.green(`    \u2714 ${repo.name}: constitution saved`));
+        } catch (err) {
+          console.log(import_chalk28.default.yellow(`    \u26A0 ${repo.name}: failed \u2014 ${err.message}`));
+        }
       }
-      return;
     }
-    const constitutionPath = path27.join(currentDir, CONSTITUTION_FILE);
-    if (!opts.force && await fs28.pathExists(constitutionPath)) {
-      console.log(import_chalk28.default.yellow(`
-  ${CONSTITUTION_FILE} already exists.`));
-      console.log(import_chalk28.default.gray("  Use --force to overwrite it."));
-      console.log(import_chalk28.default.gray(`  Or edit it directly: ${constitutionPath}`));
+    const allRepos = await getRegisteredRepos();
+    if (allRepos.length === 0) {
+      console.log(import_chalk28.default.yellow("\n  No repos registered. Run `ai-spec init` again to add repos."));
       return;
     }
-    console.log(import_chalk28.default.blue("\n\u2500\u2500\u2500 Generating Project Constitution \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-    console.log(import_chalk28.default.gray(`  Provider: ${providerName}/${modelName}`));
-    console.log(import_chalk28.default.gray("  Analyzing codebase..."));
-    const generator = new ConstitutionGenerator(provider);
-    let constitution;
-    try {
-      constitution = await generator.generate(currentDir);
-    } catch (err) {
-      console.error(import_chalk28.default.red("  \u2718 Failed to generate constitution:"), err);
-      process.exit(1);
-    }
-    const saved = await generator.saveConstitution(currentDir, constitution);
-    const globalResult = await loadGlobalConstitution([path27.dirname(currentDir)]);
-    if (globalResult) {
-      console.log(import_chalk28.default.cyan(`
-  \u2139 Global constitution detected: ${globalResult.source}`));
-      console.log(import_chalk28.default.gray("    It will be merged with this project constitution at runtime."));
-      console.log(import_chalk28.default.gray("    Project rules take priority over global rules."));
-    }
-    console.log(import_chalk28.default.green(`
-  \u2714 Constitution saved: ${saved}`));
-    console.log(import_chalk28.default.gray("  This file will be automatically used in all future `ai-spec create` runs."));
-    console.log(import_chalk28.default.gray("  Edit it to add custom rules or red lines for your project.\n"));
-    console.log(import_chalk28.default.bold("  Preview:"));
-    console.log(import_chalk28.default.gray(constitution.split("\n").slice(0, 15).join("\n")));
-    if (constitution.split("\n").length > 15) {
-      console.log(import_chalk28.default.gray(`  ... (${constitution.split("\n").length} lines total)`));
-    }
+    const existingGlobal = await loadGlobalConstitution([currentDir]);
+    const shouldGenerateGlobal = !existingGlobal || opts.force || newRepos.length > 0 ? true : await (0, import_prompts8.confirm)({
+      message: "Global constitution exists. Re-generate it?",
+      default: false
+    });
+    if (shouldGenerateGlobal) {
+      await generateGlobalConstitution(provider, allRepos, currentDir);
+    }
+    console.log(import_chalk28.default.bold.green("\n\u2714 Init complete!"));
+    console.log(import_chalk28.default.gray(`  Repos registered: ${allRepos.length}`));
+    for (const r of allRepos) {
+      const icon = r.hasConstitution ? import_chalk28.default.green("\u2714") : import_chalk28.default.gray("\u25CB");
+      console.log(import_chalk28.default.gray(`    ${icon} ${r.name} (${r.type}/${r.role})`));
+    }
+    console.log(import_chalk28.default.gray(`
+  Repo store: ${REPO_STORE_FILE}`));
+    console.log(import_chalk28.default.gray(`  Next step: ai-spec create "your feature idea"`));
+    process.exit(0);
   });
 }
 
 // cli/commands/config.ts
-var path28 = __toESM(require("path"));
-var fs29 = __toESM(require("fs-extra"));
+var path29 = __toESM(require("path"));
+var fs30 = __toESM(require("fs-extra"));
 var import_chalk29 = __toESM(require("chalk"));
 function registerConfig(program2) {
   program2.command("config").description(`Set default configuration for this project (saved to ${CONFIG_FILE})`).option("--provider <name>", "Default AI provider for spec generation").option("--model <name>", "Default model for spec generation").option("--codegen <mode>", "Default code generation mode (claude-code|api|plan)").option("--codegen-provider <name>", "Default provider for code generation").option("--codegen-model <name>", "Default model for code generation").option("--min-spec-score <score>", "Minimum overall spec score (1-10) to pass Approval Gate (0 = disabled)").option("--min-harness-score <score>", "Minimum harness score (1-10) for pipeline success (0 = disabled)").option("--max-error-cycles <n>", "Maximum error-feedback fix cycles (1-10, default: 2)").option("--show", "Print current configuration").option("--reset", "Reset configuration to empty").option("--clear-keys", "Delete all saved API keys from ~/.ai-spec-keys.json").option("--clear-key <provider>", "Delete saved API key for a specific provider").option("--list-keys", "Show which providers have a saved key").action(async (opts) => {
     const currentDir = process.cwd();
-    const configPath = path28.join(currentDir, CONFIG_FILE);
+    const configPath = path29.join(currentDir, CONFIG_FILE);
     if (opts.clearKeys) {
       await clearAllKeys();
       console.log(import_chalk29.default.green(`\u2714 All saved API keys cleared.`));
@@ -12365,7 +12652,7 @@ function registerConfig(program2) {
       return;
     }
     if (opts.listKeys) {
-      const store = await fs29.readJson(KEY_STORE_FILE).catch(() => ({}));
+      const store = await fs30.readJson(KEY_STORE_FILE).catch(() => ({}));
       const providers = Object.keys(store);
       if (providers.length === 0) {
         console.log(import_chalk29.default.gray("No saved API keys."));
@@ -12381,7 +12668,7 @@ File: ${KEY_STORE_FILE}`));
       return;
     }
     if (opts.reset) {
-      await fs29.writeJson(configPath, {}, { spaces: 2 });
+      await fs30.writeJson(configPath, {}, { spaces: 2 });
       console.log(import_chalk29.default.green(`\u2714 Config reset: ${configPath}`));
       return;
     }
@@ -12425,22 +12712,18 @@ File: ${KEY_STORE_FILE}`));
       }
       updated.maxErrorCycles = cycles;
     }
-    await fs29.writeJson(configPath, updated, { spaces: 2 });
+    await fs30.writeJson(configPath, updated, { spaces: 2 });
     console.log(import_chalk29.default.green(`\u2714 Config saved to ${configPath}`));
     console.log(JSON.stringify(updated, null, 2));
   });
 }
 
 // cli/commands/model.ts
-var path29 = __toESM(require("path"));
-var fs30 = __toESM(require("fs-extra"));
 var import_chalk30 = __toESM(require("chalk"));
-var import_prompts8 = require("@inquirer/prompts");
+var import_prompts9 = require("@inquirer/prompts");
 init_spec_generator();
 function registerModel(program2) {
   program2.command("model").description("Interactively switch the active AI provider/model and save to .ai-spec.json").option("--list", "List all available providers and models").action(async (opts) => {
-    const currentDir = process.cwd();
-    const configPath = path29.join(currentDir, CONFIG_FILE);
     if (opts.list) {
       console.log(import_chalk30.default.bold("\nAvailable providers & models:\n"));
       for (const [key, meta] of Object.entries(PROVIDER_CATALOG)) {
@@ -12457,8 +12740,9 @@ function registerModel(program2) {
       }
       return;
     }
-    const existing = await loadConfig(currentDir);
+    const existing = await loadGlobalConfig();
     console.log(import_chalk30.default.blue("\n\u2500\u2500\u2500 Model Switcher \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(import_chalk30.default.gray(`  Config: ${GLOBAL_CONFIG_FILE}`));
     if (Object.keys(existing).length > 0) {
       console.log(
         import_chalk30.default.gray(
@@ -12467,7 +12751,7 @@ function registerModel(program2) {
       );
     }
     console.log();
-    const target = await (0, import_prompts8.select)({
+    const target = await (0, import_prompts9.select)({
       message: "Configure model for:",
       choices: [
         { name: "Spec generation  (used for spec writing & refinement)", value: "spec" },
@@ -12476,7 +12760,7 @@ function registerModel(program2) {
       ]
     });
     async function pickProviderAndModel(label) {
-      const providerKey = await (0, import_prompts8.select)({
+      const providerKey = await (0, import_prompts9.select)({
         message: `${label} \u2014 select provider:`,
         choices: Object.entries(PROVIDER_CATALOG).map(([key, meta2]) => ({
           name: `${meta2.displayName.padEnd(22)} ${import_chalk30.default.gray(meta2.description)}`,
@@ -12489,12 +12773,12 @@ function registerModel(program2) {
         ...meta.models.map((m) => ({ name: m, value: m })),
         { name: import_chalk30.default.italic("\u270E  Enter custom model name..."), value: "__custom__" }
       ];
-      let chosenModel = await (0, import_prompts8.select)({
+      let chosenModel = await (0, import_prompts9.select)({
         message: `${label} \u2014 select model (${meta.displayName}):`,
         choices: modelChoices
       });
       if (chosenModel === "__custom__") {
-        chosenModel = await (0, import_prompts8.input)({
+        chosenModel = await (0, import_prompts9.input)({
           message: "Enter model name:",
           validate: (v2) => v2.trim().length > 0 || "Model name cannot be empty"
         });
@@ -12539,14 +12823,14 @@ function registerModel(program2) {
         )
       );
     }
-    const ok = await (0, import_prompts8.confirm)({ message: "Save to .ai-spec.json?", default: true });
+    const ok = await (0, import_prompts9.confirm)({ message: `Save to ${GLOBAL_CONFIG_FILE}?`, default: true });
     if (!ok) {
       console.log(import_chalk30.default.gray("  Cancelled."));
       return;
     }
-    await fs30.writeJson(configPath, updated, { spaces: 2 });
+    await saveGlobalConfig(updated);
     console.log(import_chalk30.default.green(`
-  \u2714 Saved to ${configPath}`));
+  \u2714 Saved to ${GLOBAL_CONFIG_FILE}`));
     const providerToCheck = updated.provider ?? "gemini";
     const envKey = ENV_KEY_MAP[providerToCheck];
     if (envKey && !process.env[envKey]) {
@@ -12563,14 +12847,14 @@ function registerModel(program2) {
 var path30 = __toESM(require("path"));
 var fs31 = __toESM(require("fs-extra"));
 var import_chalk31 = __toESM(require("chalk"));
-var import_prompts9 = require("@inquirer/prompts");
+var import_prompts10 = require("@inquirer/prompts");
 function registerWorkspace(program2) {
   const workspaceCmd = program2.command("workspace").description("Manage multi-repo workspace configuration");
   workspaceCmd.command("init").description(`Interactive workspace setup \u2014 creates ${WORKSPACE_CONFIG_FILE}`).action(async () => {
     const currentDir = process.cwd();
     const configPath = path30.join(currentDir, WORKSPACE_CONFIG_FILE);
     if (await fs31.pathExists(configPath)) {
-      const overwrite = await (0, import_prompts9.confirm)({
+      const overwrite = await (0, import_prompts10.confirm)({
         message: `${WORKSPACE_CONFIG_FILE} already exists. Overwrite?`,
         default: false
       });
@@ -12580,12 +12864,12 @@ function registerWorkspace(program2) {
       }
     }
     console.log(import_chalk31.default.blue("\n\u2500\u2500\u2500 Workspace Setup \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-    const workspaceName = await (0, import_prompts9.input)({
+    const workspaceName = await (0, import_prompts10.input)({
       message: "Workspace name:",
       validate: (v2) => v2.trim().length > 0 || "Name cannot be empty"
     });
     const repos = [];
-    const useAutoScan = await (0, import_prompts9.confirm)({
+    const useAutoScan = await (0, import_prompts10.confirm)({
       message: "Auto-scan sibling directories for repos?",
       default: true
     });
@@ -12599,7 +12883,7 @@ function registerWorkspace(program2) {
         for (const r of detected) {
           console.log(import_chalk31.default.gray(`    - ${r.name}: ${r.role} (${r.type}) at ${r.path}`));
         }
-        const keepAll = await (0, import_prompts9.confirm)({
+        const keepAll = await (0, import_prompts10.confirm)({
           message: `Include all ${detected.length} detected repo(s)?`,
           default: true
         });
@@ -12607,7 +12891,7 @@ function registerWorkspace(program2) {
           repos.push(...detected);
         } else {
           for (const r of detected) {
-            const keep = await (0, import_prompts9.confirm)({
+            const keep = await (0, import_prompts10.confirm)({
               message: `Include "${r.name}" (${r.role}, ${r.type})?`,
               default: true
             });
@@ -12631,14 +12915,14 @@ function registerWorkspace(program2) {
       { name: "react-native (React Native mobile)", value: "react-native" },
       { name: "unknown", value: "unknown" }
     ];
-    let addMore = await (0, import_prompts9.confirm)({
+    let addMore = await (0, import_prompts10.confirm)({
       message: repos.length > 0 ? "Manually add more repos?" : "Add repos manually?",
       default: repos.length === 0
     });
     while (addMore) {
       console.log(import_chalk31.default.cyan(`
   Adding repo #${repos.length + 1}`));
-      const repoName = await (0, import_prompts9.input)({
+      const repoName = await (0, import_prompts10.input)({
         message: "Repo name (e.g. api, web, app):",
         validate: (v2) => {
           if (!v2.trim()) return "Name cannot be empty";
@@ -12646,7 +12930,7 @@ function registerWorkspace(program2) {
           return true;
         }
       });
-      const repoPath = await (0, import_prompts9.input)({
+      const repoPath = await (0, import_prompts10.input)({
         message: `Relative path to "${repoName}" from here (default: ./${repoName}):`,
         default: `./${repoName}`
       });
@@ -12661,12 +12945,12 @@ function registerWorkspace(program2) {
       } else {
         console.log(import_chalk31.default.yellow(`    Path "${absPath}" not found \u2014 type/role will be manual.`));
       }
-      const repoType = await (0, import_prompts9.select)({
+      const repoType = await (0, import_prompts10.select)({
         message: `Repo type for "${repoName}":`,
         choices: repoTypeChoices,
         default: detectedType
       });
-      const repoRole = await (0, import_prompts9.select)({
+      const repoRole = await (0, import_prompts10.select)({
         message: `Repo role for "${repoName}":`,
         choices: [
           { name: "backend", value: "backend" },
@@ -12683,7 +12967,7 @@ function registerWorkspace(program2) {
         role: repoRole
       });
       console.log(import_chalk31.default.green(`  \u2714 Added: ${repoName} (${repoRole}, ${repoType})`));
-      addMore = await (0, import_prompts9.confirm)({
+      addMore = await (0, import_prompts10.confirm)({
         message: "Add another repo?",
         default: false
       });
@@ -12694,7 +12978,7 @@ function registerWorkspace(program2) {
     for (const r of repos) {
       console.log(import_chalk31.default.gray(`  - ${r.name}: ${r.role} (${r.type}) at ${r.path}`));
     }
-    const ok = await (0, import_prompts9.confirm)({ message: `Save to ${WORKSPACE_CONFIG_FILE}?`, default: true });
+    const ok = await (0, import_prompts10.confirm)({ message: `Save to ${WORKSPACE_CONFIG_FILE}?`, default: true });
     if (!ok) {
       console.log(import_chalk31.default.gray("  Cancelled."));
       return;
@@ -12738,7 +13022,7 @@ Workspace: ${config2.name}`));
 var path32 = __toESM(require("path"));
 var fs33 = __toESM(require("fs-extra"));
 var import_chalk33 = __toESM(require("chalk"));
-var import_prompts10 = require("@inquirer/prompts");
+var import_prompts11 = require("@inquirer/prompts");
 init_spec_generator();
 
 // core/spec-updater.ts
@@ -12973,7 +13257,7 @@ function registerUpdate(program2) {
     const currentDir = process.cwd();
     const config2 = await loadConfig(currentDir);
     if (!change) {
-      change = await (0, import_prompts10.input)({
+      change = await (0, import_prompts11.input)({
         message: "Describe the change you want to make:",
         validate: (v2) => v2.trim().length > 0 || "Change description cannot be empty"
       });
@@ -13291,7 +13575,7 @@ function buildYamlDoc(obj) {
     return `${k2}: ${valStr}`;
   }).join("\n") + "\n";
 }
-function dslToOpenApi(dsl, serverUrl = "http://localhost:3000") {
+function dslToOpenApi(dsl, serverUrl = DEFAULT_OPENAPI_SERVER_URL) {
   const info = {
     title: dsl.feature.title,
     description: dsl.feature.description,
@@ -13338,7 +13622,7 @@ function dslToOpenApi(dsl, serverUrl = "http://localhost:3000") {
 }
 async function exportOpenApi(dsl, projectDir, opts = {}) {
   const format = opts.format ?? "yaml";
-  const serverUrl = opts.serverUrl ?? "http://localhost:3000";
+  const serverUrl = opts.serverUrl ?? DEFAULT_OPENAPI_SERVER_URL;
   const defaultName = `openapi.${format}`;
   const outputPath = opts.outputPath ? path33.isAbsolute(opts.outputPath) ? opts.outputPath : path33.join(projectDir, opts.outputPath) : path33.join(projectDir, defaultName);
   const doc = dslToOpenApi(dsl, serverUrl);
@@ -13534,12 +13818,12 @@ function registerMock(program2) {
 
 // cli/commands/learn.ts
 var import_chalk36 = __toESM(require("chalk"));
-var import_prompts11 = require("@inquirer/prompts");
+var import_prompts12 = require("@inquirer/prompts");
 function registerLearn(program2) {
   program2.command("learn").description("Append a lesson or engineering decision directly to constitution \xA79").argument("[lesson]", "The lesson or decision to record (prompted if omitted)").action(async (lesson) => {
     const currentDir = process.cwd();
     if (!lesson) {
-      lesson = await (0, import_prompts11.input)({
+      lesson = await (0, import_prompts12.input)({
         message: "What lesson or engineering decision should be recorded?",
         validate: (v2) => v2.trim().length > 0 || "Please enter a lesson"
       });
@@ -13581,9 +13865,8 @@ var import_chalk39 = __toESM(require("chalk"));
 var fs37 = __toESM(require("fs-extra"));
 var path36 = __toESM(require("path"));
 var import_chalk38 = __toESM(require("chalk"));
-var LOG_DIR2 = ".ai-spec-logs";
 async function loadRunLogs(workingDir) {
-  const logDir = path36.join(workingDir, LOG_DIR2);
+  const logDir = path36.join(workingDir, DEFAULT_LOG_DIR);
   if (!await fs37.pathExists(logDir)) return [];
   const files = await fs37.readdir(logDir);
   const jsonFiles = new Set(files.filter((f) => f.endsWith(".json")));
@@ -13728,7 +14011,7 @@ function printTrendReport(report, workingDir) {
       `  ${import_chalk38.default.gray(formatDate(e.startedAt))}  ${bar}${scoreStr}  ${hash}  ${dur}${errMark}  ${spec}`
     );
   }
-  const logRelDir = path36.relative(workingDir, path36.join(workingDir, LOG_DIR2));
+  const logRelDir = path36.relative(workingDir, path36.join(workingDir, DEFAULT_LOG_DIR));
   console.log(import_chalk38.default.gray(`
   ${entries.length} run(s) shown  \xB7  logs: ${logRelDir}/`));
   console.log(import_chalk38.default.cyan("\u2500".repeat(63)));
@@ -14387,7 +14670,233 @@ function registerVcr(program2) {
 
 // cli/commands/scan.ts
 var import_chalk44 = __toESM(require("chalk"));
+var path42 = __toESM(require("path"));
+
+// core/project-index.ts
+var fs42 = __toESM(require("fs-extra"));
 var path41 = __toESM(require("path"));
+var INDEX_FILE = ".ai-spec-index.json";
+var KEY_DEPS = [
+  // Frameworks
+  "express",
+  "fastify",
+  "koa",
+  "@nestjs/core",
+  "hapi",
+  "next",
+  "react",
+  "vue",
+  "nuxt",
+  "svelte",
+  "react-native",
+  "expo",
+  // DB / ORM
+  "prisma",
+  "@prisma/client",
+  "mongoose",
+  "typeorm",
+  "sequelize",
+  "drizzle-orm",
+  // Auth
+  "jsonwebtoken",
+  "passport",
+  "next-auth",
+  "@clerk/nextjs",
+  // Build / Lang
+  "typescript",
+  "vite",
+  "webpack",
+  "esbuild",
+  "turbo",
+  // Testing
+  "jest",
+  "vitest",
+  "mocha",
+  "cypress",
+  "playwright",
+  // Infra
+  "redis",
+  "bull",
+  "socket.io",
+  "graphql",
+  "@trpc/server"
+];
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  ".svn",
+  "dist",
+  "build",
+  "out",
+  ".next",
+  ".nuxt",
+  "coverage",
+  ".turbo",
+  ".cache",
+  "__pycache__",
+  "vendor",
+  ".ai-spec-vcr",
+  ".ai-spec-logs",
+  "specs"
+]);
+var MANIFEST_FILES = [
+  "package.json",
+  "go.mod",
+  "Cargo.toml",
+  "pom.xml",
+  "build.gradle",
+  "build.gradle.kts",
+  "requirements.txt",
+  "pyproject.toml",
+  "setup.py",
+  "composer.json"
+];
+async function isProjectRoot(absPath) {
+  for (const manifest of MANIFEST_FILES) {
+    if (await fs42.pathExists(path41.join(absPath, manifest))) return true;
+  }
+  return false;
+}
+async function extractTechStack(absPath, type) {
+  const stack = [];
+  if (type === "go") stack.push("go");
+  if (type === "rust") stack.push("rust");
+  if (type === "java") stack.push("java");
+  if (type === "python") stack.push("python");
+  if (type === "php") stack.push("php");
+  const pkgPath = path41.join(absPath, "package.json");
+  if (!await fs42.pathExists(pkgPath)) return stack;
+  let pkg = {};
+  try {
+    pkg = await fs42.readJson(pkgPath);
+  } catch {
+    return stack;
+  }
+  const allDeps = {
+    ...pkg.dependencies ?? {},
+    ...pkg.devDependencies ?? {}
+  };
+  const depKeys = new Set(Object.keys(allDeps));
+  for (const dep of KEY_DEPS) {
+    if (depKeys.has(dep)) stack.push(dep);
+  }
+  return stack;
+}
+async function discoverProjects(rootDir, maxDepth) {
+  const found = [];
+  async function walk(absDir, depth) {
+    if (depth > maxDepth) return;
+    let entries;
+    try {
+      entries = await fs42.readdir(absDir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (SKIP_DIRS.has(entry.name) || entry.name.startsWith(".")) continue;
+      const childAbs = path41.join(absDir, entry.name);
+      const gitPath = path41.join(childAbs, ".git");
+      if (await fs42.pathExists(gitPath)) {
+        const gitStat = await fs42.stat(gitPath);
+        if (gitStat.isFile()) continue;
+      }
+      if (await isProjectRoot(childAbs)) {
+        found.push(path41.relative(rootDir, childAbs));
+      } else {
+        await walk(childAbs, depth + 1);
+      }
+    }
+  }
+  await walk(rootDir, 0);
+  return found;
+}
+async function loadIndex(scanRoot) {
+  const filePath = path41.join(scanRoot, INDEX_FILE);
+  try {
+    return await fs42.readJson(filePath);
+  } catch {
+    return null;
+  }
+}
+async function saveIndex(scanRoot, index) {
+  const filePath = path41.join(scanRoot, INDEX_FILE);
+  await fs42.writeJson(filePath, index, { spaces: 2 });
+  return filePath;
+}
+async function runScan(scanRoot, maxDepth = 2) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const existing = await loadIndex(scanRoot);
+  const existingMap = new Map(
+    (existing?.projects ?? []).map((p) => [p.path, p])
+  );
+  const discoveredPaths = await discoverProjects(scanRoot, maxDepth);
+  const added = [];
+  const updated = [];
+  const unchanged = [];
+  const seenPaths = /* @__PURE__ */ new Set();
+  for (const relPath of discoveredPaths) {
+    const absPath = path41.join(scanRoot, relPath);
+    seenPaths.add(relPath);
+    const { type, role } = await detectRepoType(absPath);
+    const techStack = await extractTechStack(absPath, type);
+    const hasConstitution = await fs42.pathExists(path41.join(absPath, CONSTITUTION_FILE));
+    const hasWorkspace = await fs42.pathExists(path41.join(absPath, WORKSPACE_CONFIG_FILE));
+    const name = path41.basename(relPath);
+    const prev = existingMap.get(relPath);
+    if (!prev) {
+      const entry = {
+        name,
+        path: relPath,
+        type,
+        role,
+        techStack,
+        hasConstitution,
+        hasWorkspace,
+        firstSeen: now,
+        lastSeen: now
+      };
+      added.push(entry);
+      existingMap.set(relPath, entry);
+    } else {
+      const changed = prev.type !== type || prev.role !== role || prev.hasConstitution !== hasConstitution || prev.hasWorkspace !== hasWorkspace || JSON.stringify(prev.techStack.sort()) !== JSON.stringify(techStack.sort());
+      const entry = {
+        ...prev,
+        type,
+        role,
+        techStack,
+        hasConstitution,
+        hasWorkspace,
+        lastSeen: now,
+        missing: void 0
+        // clear missing flag if it came back
+      };
+      existingMap.set(relPath, entry);
+      if (changed) {
+        updated.push(entry);
+      } else {
+        unchanged.push(entry);
+      }
+    }
+  }
+  const nowMissing = [];
+  for (const [relPath, entry] of existingMap) {
+    if (!seenPaths.has(relPath) && !entry.missing) {
+      const gone = { ...entry, missing: true };
+      existingMap.set(relPath, gone);
+      nowMissing.push(gone);
+    }
+  }
+  const projects = [...existingMap.values()].sort((a, b) => a.path.localeCompare(b.path));
+  const index = {
+    scanRoot,
+    lastScanned: now,
+    projects
+  };
+  return { index, added, updated, unchanged, nowMissing };
+}
+
+// cli/commands/scan.ts
 var ROLE_COLOR = {
   backend: import_chalk44.default.blue,
   frontend: import_chalk44.default.green,
@@ -14461,7 +14970,7 @@ Scanning ${cwd} (depth: ${maxDepth})...`));
     }
     console.log(import_chalk44.default.cyan("\n\u2500".repeat(52)));
     console.log(import_chalk44.default.gray("  \xA7C = has constitution  W = workspace root"));
-    console.log(import_chalk44.default.gray(`  Index saved : ${path41.relative(cwd, path41.join(cwd, INDEX_FILE))}`));
+    console.log(import_chalk44.default.gray(`  Index saved : ${path42.relative(cwd, path42.join(cwd, INDEX_FILE))}`));
     console.log(import_chalk44.default.gray(`  Next steps  : ai-spec scan --list | ai-spec init [--global]`));
   });
 }
@@ -14469,7 +14978,7 @@ Scanning ${cwd} (depth: ${maxDepth})...`));
 // cli/index.ts
 dotenv.config();
 var program = new import_commander.Command();
-program.name("ai-spec").description("AI-driven Development Orchestrator \u2014 spec, generate, review").version("0.14.1");
+program.name("ai-spec").description("AI-driven Development Orchestrator \u2014 spec, generate, review").version(require_package().version);
 registerCreate(program);
 registerReview(program);
 registerInit(program);