ai-spec-dev 0.42.0 → 0.55.0

package/README.md

@@ -12,8 +12,8 @@
 <p align="center">
   <a href="https://github.com/hzhongzhong/ai-spec"><img src="https://img.shields.io/badge/GitHub-ai--spec-181717?logo=github" alt="GitHub" /></a>
   <a href="https://www.npmjs.com/package/ai-spec-dev"><img src="https://img.shields.io/npm/v/ai-spec-dev?color=cb3837&logo=npm" alt="npm" /></a>
-  <img src="https://img.shields.io/badge/version-0.37.0-blue" alt="version" />
-  <img src="https://img.shields.io/badge/tests-409%20passed-brightgreen" alt="tests" />
+  <img src="https://img.shields.io/badge/version-0.55.0-blue" alt="version" />
+  <img src="https://img.shields.io/badge/tests-913%20passed-brightgreen" alt="tests" />
   <img src="https://img.shields.io/badge/providers-9-orange" alt="providers" />
   <img src="https://img.shields.io/badge/license-MIT-green" alt="license" />
 </p>
@@ -31,10 +31,11 @@
 **ai-spec** is an AI-driven development orchestrator SDK & CLI that transforms a one-line requirement into production-ready code through a fully automated pipeline:
 
 ```
-Requirement → Constitution → Context → Spec + Tasks → Interactive Refinement
+init: Register Repos → Project Constitutions → Global Constitution
+create: Requirement → Select Repo(s) → Context → Spec + Tasks → Refinement
 → Quality Assessment → Approval Gate → DSL Extraction → Gap Feedback
 → Git Isolation → Code Generation → TDD / Test Skeleton → Auto Error Fix
-→ 3-Pass Code Review → Review→DSL Loop → Harness Self-Eval → Knowledge Memory
+→ 3-Pass Code Review → Review→DSL Loop → Harness Self-Eval
 ```
 
 **Multi-Repo mode (Workspace):**
@@ -69,16 +70,20 @@ npm run build
 # Set API key (Gemini example)
 export GEMINI_API_KEY=your_key_here
 
-# Initialize project constitution (optional — create auto-triggers it)
+# Initialize: register repos + generate constitutions
 ai-spec init
 
-# Start developing
+# Start developing (select registered repo → run pipeline)
 ai-spec create "Add login functionality to user module"
 ```
 
 ### Pipeline Demo
 
 ```
+[Repo]  Select repo(s) for this feature:
+        ● my-vue-app (vue / frontend)
+        ○ my-node-api (node-express / backend)
+        ✔ 1 repo selected
 [1/6]   Loading project context...
         Constitution : ✔ found
 [2/6]   Generating spec with gemini/gemini-2.5-pro...
@@ -117,19 +122,35 @@ ai-spec create "Add login functionality to user module"
 ### Commands
 
 ```
-ai-spec init                 Analyze codebase, generate project constitution
-ai-spec create [idea]        Full pipeline: constitution → spec → DSL → codegen → review → self-eval
-ai-spec update [change]      Incremental update: modify spec → re-extract DSL → regenerate affected files
-ai-spec learn [lesson]       Inject knowledge directly into constitution §9
-ai-spec review [file]        3-pass AI code review (architecture + implementation + impact)
-ai-spec export               DSL → OpenAPI 3.1.0 YAML/JSON
-ai-spec types                DSL → TypeScript types (models + endpoint types + API_ENDPOINTS)
-ai-spec mock                 DSL → Mock server + MSW handlers + proxy config
-ai-spec dashboard            Generate static HTML harness dashboard
-ai-spec restore <runId>      Rollback all files modified by a specific run
-ai-spec model                Interactive provider/model switcher
-ai-spec config               View/modify project configuration
-ai-spec workspace init       Initialize multi-repo workspace
+# Core workflow
+ai-spec init                       Register repos, generate constitutions (auto-scans projects)
+ai-spec init --add-repo            Quick-add a single repo
+ai-spec init --status              Show registered repos and constitution health
+ai-spec create [idea]              Full pipeline: spec → DSL → codegen → review
+ai-spec create [idea] --openapi    Also auto-generate OpenAPI 3.1.0 YAML after DSL
+ai-spec create [idea] --types      Also auto-generate TypeScript types after DSL
+ai-spec update [change]            Incremental: modify spec → re-extract DSL → regen affected files
+ai-spec review [file]              3-pass AI code review (architecture + implementation + impact)
+
+# Knowledge & constitution
+ai-spec learn [lesson]             Inject a lesson directly into constitution §9
+
+# DSL-derived artifacts
+ai-spec export                     DSL → OpenAPI 3.1.0 YAML/JSON
+ai-spec types                      DSL → TypeScript types (models + endpoint types + API_ENDPOINTS)
+ai-spec mock                       DSL → Mock server + MSW handlers + proxy config
+
+# Configuration (run without flags for interactive model/provider picker)
+ai-spec config                     Interactive provider/model setup (merged from `model`)
+ai-spec config --show              Print current configuration
+ai-spec config --list              List all available providers and models
+
+# Observability
+ai-spec logs [runId]               View run history or stage breakdown
+ai-spec trend                      Harness score trend across runs
+ai-spec dashboard                  Generate static HTML harness dashboard
+ai-spec restore <runId>            Rollback all files modified by a specific run
+ai-spec vcr list                   List VCR recordings
 ```
 
 ### Architecture
@@ -204,10 +225,11 @@ MIT
 **ai-spec** 是一个 AI 驱动的功能开发编排工具 SDK & CLI —— 从一句话需求到可运行代码的完整流水线，支持单 Repo 及多 Repo 跨端联动。
 
 ```
-需求描述 → 项目宪法 → 项目感知 → Spec+Tasks → 交互式润色(Diff预览)
+init: 注册仓库 → 项目级宪法 → 全局宪法汇总
+create: 需求描述 → 选择仓库 → 项目感知 → Spec+Tasks → 交互式润色(Diff预览)
 → Spec质量预评估 → Approval Gate → DSL提取+校验 → DSL Gap Feedback
 → Git 隔离 → 代码生成(同层并行) → TDD测试/测试骨架 → 错误反馈自动修复
-→ 3-pass 代码审查 → Review→DSL Loop → Harness Self-Eval → 经验积累(宪法§9)
+→ 3-pass 代码审查 → Review→DSL Loop → Harness Self-Eval
 ```
 
 **多 Repo 模式（工作区）：**
@@ -242,16 +264,20 @@ npm run build
 # 设置 API Key（以 Gemini 为例）
 export GEMINI_API_KEY=your_key_here
 
-# 首次使用：生成项目宪法（可选，create 会自动触发）
+# 初始化：注册仓库 + 生成宪法链路
 ai-spec init
 
-# 开始开发
+# 开始开发（选择已注册仓库 → 跑 pipeline）
 ai-spec create "给用户模块增加登录功能"
 ```
 
 ### 流水线演示
 
 ```
+[Repo]  选择本次开发的仓库:
+        ● my-vue-app (vue / frontend)
+        ○ my-node-api (node-express / backend)
+        ✔ 已选择 1 个仓库
 [1/6]   加载项目上下文...
         Constitution : ✔ found
 [2/6]   使用 gemini/gemini-2.5-pro 生成 Spec...
@@ -307,19 +333,35 @@ ai-spec create "给用户模块增加登录功能"
 ### 命令总览
 
 ```
-ai-spec init                 分析代码库，生成项目宪法（.ai-spec-constitution.md）
-ai-spec create [idea]        完整流水线：宪法 → spec → DSL → 代码生成 → 审查 → 自评
-ai-spec update [change]      增量更新：修改 Spec → 重提取 DSL → 重新生成受影响文件
-ai-spec learn [lesson]       零摩擦知识注入，直接写入宪法 §9
-ai-spec review [file]        3-pass AI 代码审查（架构 + 实现 + 影响面）
-ai-spec export               DSL → OpenAPI 3.1.0 YAML/JSON
-ai-spec types                DSL → TypeScript 类型文件
-ai-spec mock                 DSL → Mock 服务器 + MSW Handlers + 代理配置
-ai-spec dashboard            生成静态 HTML Harness Dashboard
-ai-spec restore <runId>      回滚指定 run 修改的所有文件
-ai-spec model                交互式切换 AI provider/model
-ai-spec config               查看/修改项目配置
-ai-spec workspace init       初始化多 Repo 工作区
+# 核心开发流程
+ai-spec init                       注册仓库，生成项目宪法 + 全局宪法（自动扫描项目）
+ai-spec init --add-repo            快速添加单个仓库
+ai-spec init --status              查看已注册仓库和宪法状态
+ai-spec create [idea]              完整流水线：spec → DSL → 代码生成 → 审查
+ai-spec create [idea] --openapi    DSL 提取后自动生成 OpenAPI 3.1.0 YAML
+ai-spec create [idea] --types      DSL 提取后自动生成 TypeScript 类型文件
+ai-spec update [change]            增量更新：修改 Spec → 重提取 DSL → 重新生成受影响文件
+ai-spec review [file]              3-pass AI 代码审查（架构 + 实现 + 影响面）
+
+# 知识 & 宪法
+ai-spec learn [lesson]             零摩擦知识注入，直接写入宪法 §9
+
+# DSL 衍生产物
+ai-spec export                     DSL → OpenAPI 3.1.0 YAML/JSON
+ai-spec types                      DSL → TypeScript 类型文件
+ai-spec mock                       DSL → Mock 服务器 + MSW Handlers + 代理配置
+
+# 配置（无参数运行进入交互式 provider/model 选择）
+ai-spec config                     交互式 provider/model 配置（已合并原 model 命令）
+ai-spec config --show              查看当前配置
+ai-spec config --list              列出所有可用 provider 和模型
+
+# 可观测性
+ai-spec logs [runId]               查看 run 历史 / 指定 run 的 stage 详情
+ai-spec trend                      Harness score 趋势分析
+ai-spec dashboard                  生成静态 HTML Harness Dashboard
+ai-spec restore <runId>            回滚指定 run 修改的所有文件
+ai-spec vcr list                   列出 VCR 录制
 ```
 
 <details>
@@ -387,13 +429,17 @@ ai-spec export --server <url>          # 指定服务器 URL
 ### 工作流详解
 
 <details>
-<summary>Step 1 — 项目宪法 + Context</summary>
+<summary>Step 0 — 初始化（ai-spec init）</summary>
+
+`ai-spec init` 完成工作区准备：
 
-**项目宪法**（`.ai-spec-constitution.md`）包含 §1–§9 共 9 个章节，涵盖架构规则、命名规范、API 规范、数据层、错误处理、禁区、测试规范、共享配置清单、累积经验。
+1. **注册仓库**：输入仓库绝对路径 → 自动检测类型/角色（Vue/React/Node/Java/...）
+2. **生成项目宪法**：对每个仓库自动扫描并生成 `.ai-spec-constitution.md`（§1–§9）
+3. **生成全局宪法**：汇总所有仓库的项目宪法要点 → 生成 `.ai-spec-global-constitution.md`
 
-自动扫描的上下文包括：`package.json` / `composer.json` / `pom.xml` 依赖列表、Prisma schema、路由文件、错误处理模式、i18n/constants/enums 等共享配置。
+宪法链路：**仓库注册 → 项目宪法 → 全局宪法汇总**，运行时自动 merge（全局为基线，项目级覆盖）。
 
-**Constitution Rebase**：§9 积累超过 8 条时，运行 `ai-spec init --consolidate` 将经验提炼归并到 §1–§8。
+`--add-repo` 支持快速追加仓库，`--consolidate` 将 §9 积累经验提炼归并到 §1–§8。
 </details>
 
 <details>

package/cli/commands/config.ts

@@ -2,14 +2,21 @@ import { Command } from "commander";
 import * as path from "path";
 import * as fs from "fs-extra";
 import chalk from "chalk";
+import { input, select, confirm } from "@inquirer/prompts";
 import { CodeGenMode } from "../../core/code-generator";
 import { clearAllKeys, clearKey, getSavedKey, KEY_STORE_FILE } from "../../core/key-store";
 import { AiSpecConfig, CONFIG_FILE, loadConfig } from "../utils";
+import {
+  DEFAULT_MODELS,
+  ENV_KEY_MAP,
+  PROVIDER_CATALOG,
+} from "../../core/spec-generator";
+import { AiSpecGlobalConfig, GLOBAL_CONFIG_FILE, loadGlobalConfig, saveGlobalConfig } from "../utils";
 
 export function registerConfig(program: Command): void {
   program
     .command("config")
-    .description(`Set default configuration for this project (saved to ${CONFIG_FILE})`)
+    .description(`Configure ai-spec: run without flags for interactive model/provider setup`)
     .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)")
@@ -18,7 +25,9 @@ export function registerConfig(program: Command): void {
     .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("--max-codegen-concurrency <n>", "Max concurrent tasks per batch in api codegen mode (1-10, default: 3)")
     .option("--show", "Print current configuration")
+    .option("--list", "List all available providers and models")
     .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")
@@ -27,6 +36,117 @@ export function registerConfig(program: Command): void {
       const currentDir = process.cwd();
       const configPath = path.join(currentDir, CONFIG_FILE);
 
+      // ── --list: show all providers ──────────────────────────────────────────
+      if (opts.list) {
+        console.log(chalk.bold("\nAvailable providers & models:\n"));
+        for (const [key, meta] of Object.entries(PROVIDER_CATALOG)) {
+          console.log(`  ${chalk.bold.cyan(key.padEnd(10))} ${chalk.white(meta.displayName)}`);
+          console.log(chalk.gray(`             ${meta.description}`));
+          console.log(chalk.gray(`             env: ${meta.envKey}  |  models: ${meta.models.join(", ")}`));
+          console.log();
+        }
+        return;
+      }
+
+      // ── No flags → interactive model/provider picker ────────────────────────
+      const anyFlagSet = opts.provider || opts.model || opts.codegen || opts.codegenProvider ||
+        opts.codegenModel || opts.minSpecScore !== undefined || opts.minHarnessScore !== undefined ||
+        opts.maxErrorCycles !== undefined || opts.maxCodegenConcurrency !== undefined ||
+        opts.show || opts.reset || opts.clearKeys || opts.clearKey || opts.listKeys;
+
+      if (!anyFlagSet) {
+        const existing: AiSpecGlobalConfig = await loadGlobalConfig();
+
+        console.log(chalk.blue("\n─── ai-spec config ─────────────────────────────"));
+        console.log(chalk.gray(`  Global config: ${GLOBAL_CONFIG_FILE}`));
+        if (Object.keys(existing).length > 0) {
+          console.log(chalk.gray(
+            `  Current: spec=${existing.provider ?? "gemini"}/${existing.model ?? DEFAULT_MODELS[existing.provider ?? "gemini"]}` +
+            (existing.codegenProvider ? `  codegen=${existing.codegenProvider}/${existing.codegenModel ?? ""}` : "")
+          ));
+        }
+        console.log();
+
+        const target = await select({
+          message: "Configure model for:",
+          choices: [
+            { name: "Spec generation  (spec writing & refinement)", value: "spec" },
+            { name: "Code generation  (used when --codegen api is active)", value: "codegen" },
+            { name: "Both             (same provider/model for all tasks)", value: "both" },
+          ],
+        });
+
+        async function pickProviderAndModel(label: string): Promise<{ provider: string; model: string }> {
+          const providerKey = await select({
+            message: `${label} — select provider:`,
+            choices: Object.entries(PROVIDER_CATALOG).map(([key, meta]) => ({
+              name: `${meta.displayName.padEnd(22)} ${chalk.gray(meta.description)}`,
+              value: key,
+              short: meta.displayName,
+            })),
+          });
+          const meta = PROVIDER_CATALOG[providerKey];
+          const modelChoices = [
+            ...meta.models.map((m) => ({ name: m, value: m })),
+            { name: chalk.italic("✎  Enter custom model name..."), value: "__custom__" },
+          ];
+          let chosenModel = await select({
+            message: `${label} — select model (${meta.displayName}):`,
+            choices: modelChoices,
+          });
+          if (chosenModel === "__custom__") {
+            chosenModel = await input({
+              message: "Enter model name:",
+              validate: (v) => v.trim().length > 0 || "Model name cannot be empty",
+            });
+          }
+          return { provider: providerKey, model: chosenModel };
+        }
+
+        const updated: AiSpecGlobalConfig = { ...existing };
+
+        if (target === "spec" || target === "both") {
+          const { provider, model } = await pickProviderAndModel("Spec");
+          updated.provider = provider;
+          updated.model = model;
+        }
+        if (target === "codegen" || target === "both") {
+          if (target === "both") {
+            updated.codegenProvider = updated.provider;
+            updated.codegenModel = updated.model;
+          } else {
+            const { provider, model } = await pickProviderAndModel("Codegen");
+            updated.codegenProvider = provider;
+            updated.codegenModel = model;
+          }
+          const effectiveCodegenProvider = updated.codegenProvider ?? updated.provider ?? "gemini";
+          if (effectiveCodegenProvider !== "claude" && updated.codegen === "claude-code") {
+            updated.codegen = "api";
+            console.log(chalk.yellow(`\n  ⚠  provider "${effectiveCodegenProvider}" does not support "claude-code" mode.`));
+            console.log(chalk.gray(`  codegen mode auto-set to "api".`));
+          }
+        }
+
+        console.log(chalk.blue("\n  Preview:"));
+        console.log(chalk.gray(`    spec    → ${updated.provider}/${updated.model}`));
+        if (updated.codegenProvider) {
+          console.log(chalk.gray(`    codegen → ${updated.codegenProvider}/${updated.codegenModel}  (mode: ${updated.codegen ?? "api"})`));
+        }
+
+        const ok = await confirm({ message: `Save to ${GLOBAL_CONFIG_FILE}?`, default: true });
+        if (!ok) { console.log(chalk.gray("  Cancelled.")); return; }
+
+        await saveGlobalConfig(updated);
+        console.log(chalk.green(`\n  ✔ Saved to ${GLOBAL_CONFIG_FILE}`));
+
+        const providerToCheck = updated.provider ?? "gemini";
+        const envKey = ENV_KEY_MAP[providerToCheck];
+        if (envKey && !process.env[envKey]) {
+          console.log(chalk.yellow(`  ⚠  Remember to set ${envKey} in your environment or .env file.`));
+        }
+        return;
+      }
+
       if (opts.clearKeys) {
         await clearAllKeys();
         console.log(chalk.green(`✔ All saved API keys cleared.`));
@@ -95,6 +215,14 @@ export function registerConfig(program: Command): void {
         }
         updated.minHarnessScore = score;
       }
+      if (opts.maxCodegenConcurrency !== undefined) {
+        const n = parseInt(opts.maxCodegenConcurrency, 10);
+        if (isNaN(n) || n < 1 || n > 10) {
+          console.error(chalk.red("  --max-codegen-concurrency must be a number between 1 and 10"));
+          process.exit(1);
+        }
+        updated.maxCodegenConcurrency = n;
+      }
       if (opts.maxErrorCycles !== undefined) {
         const cycles = parseInt(opts.maxErrorCycles, 10);
         if (isNaN(cycles) || cycles < 1 || cycles > 10) {

package/cli/commands/create.ts

@@ -1,11 +1,168 @@
+import * as path from "path";
+import * as fs from "fs-extra";
 import { Command } from "commander";
 import chalk from "chalk";
-import { input } from "@inquirer/prompts";
+import { input, select, checkbox } from "@inquirer/prompts";
+import { RepoRole } from "../../core/workspace-loader";
 import { SUPPORTED_PROVIDERS } from "../../core/spec-generator";
-import { WorkspaceLoader } from "../../core/workspace-loader";
+import {
+  WorkspaceLoader,
+  WorkspaceConfig,
+  detectRepoType,
+} from "../../core/workspace-loader";
 import { loadConfig } from "../utils";
 import { runMultiRepoPipeline, handleAutoServe } from "../pipeline/multi-repo";
 import { runSingleRepoPipeline } from "../pipeline/single-repo";
+import {
+  RegisteredRepo,
+  getRegisteredRepos,
+  registerRepo,
+  REPO_STORE_FILE,
+} from "../../core/repo-store";
+import { ConstitutionGenerator, CONSTITUTION_FILE } from "../../core/constitution-generator";
+import { createProvider, DEFAULT_MODELS, AIProvider } from "../../core/spec-generator";
+import { resolveApiKey } from "../utils";
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+/**
+ * Prompt user to select a repo role.
+ */
+async function promptRepoRole(): Promise<RepoRole> {
+  return select<RepoRole>({
+    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" },
+    ],
+  });
+}
+
+/**
+ * Prompt user for a repo path and quick-register it.
+ */
+async function quickRegisterRepo(provider: AIProvider): Promise<RegisteredRepo> {
+  const roleOverride = await promptRepoRole();
+
+  const roleLabels: Record<RepoRole, string> = {
+    frontend: "frontend",
+    backend: "backend",
+    mobile: "mobile",
+    shared: "shared",
+  };
+
+  const raw = await input({
+    message: `Enter your ${roleLabels[roleOverride]} repo path (absolute path):`,
+    validate: (v) => {
+      const trimmed = v.trim();
+      if (trimmed.length === 0) return "Path cannot be empty";
+      if (!path.isAbsolute(trimmed)) return "Please provide an absolute path";
+      return true;
+    },
+  });
+
+  // Strip shell escape backslashes (e.g. "文稿\ -\ hongzhong" → "文稿 - hongzhong")
+  const cleaned = raw.trim().replace(/\\ /g, " ");
+  const resolved = path.resolve(cleaned);
+  if (!(await fs.pathExists(resolved))) {
+    console.log(chalk.red(`  Path does not exist: ${resolved}`));
+    return quickRegisterRepo(provider);
+  }
+
+  const { type, role: detectedRole } = await detectRepoType(resolved);
+  const role = roleOverride ?? detectedRole;
+  const repoName = path.basename(resolved);
+
+  console.log(chalk.gray(`  Detected: ${repoName} → ${type} (${role})`));
+
+  // Generate project constitution if missing
+  const constitutionPath = path.join(resolved, CONSTITUTION_FILE);
+  let hasConstitution = await fs.pathExists(constitutionPath);
+  if (!hasConstitution) {
+    console.log(chalk.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(chalk.green(`  ✔ Constitution saved`));
+    } catch (err) {
+      console.log(chalk.yellow(`  ⚠ Constitution failed: ${(err as Error).message}`));
+    }
+  }
+
+  const entry: RegisteredRepo = {
+    name: repoName,
+    path: resolved,
+    type,
+    role,
+    hasConstitution,
+    registeredAt: new Date().toISOString(),
+  };
+  await registerRepo(entry);
+  console.log(chalk.green(`  ✔ Repo registered: ${repoName}`));
+  return entry;
+}
+
+/**
+ * Let user select repo(s) from the registered list, with option to add new.
+ */
+async function selectRepos(
+  registeredRepos: RegisteredRepo[],
+  provider: AIProvider
+): Promise<RegisteredRepo[]> {
+  const ADD_NEW = "__add_new__";
+
+  const choices = [
+    ...registeredRepos.map((r) => ({
+      name: `${r.name} (${r.type} / ${r.role}) → ${r.path}`,
+      value: r.path,
+    })),
+    { name: chalk.cyan("+ Add new repo"), value: ADD_NEW },
+  ];
+
+  const selected = await checkbox<string>({
+    message: "Select repo(s) for this feature (space to toggle, enter to confirm):",
+    choices,
+    required: true,
+  });
+
+  const result: RegisteredRepo[] = [];
+
+  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(chalk.yellow("  No repos selected. Please select at least one."));
+    return selectRepos(registeredRepos, provider);
+  }
+
+  return result;
+}
+
+/**
+ * Build WorkspaceConfig from selected repos for multi-repo pipeline.
+ */
+function buildWorkspaceConfig(repos: RegisteredRepo[]): WorkspaceConfig {
+  return {
+    name: "ai-spec-workspace",
+    repos: repos.map((r) => ({
+      name: r.name,
+      path: r.path,
+      type: r.type,
+      role: r.role,
+    })),
+  };
+}
 
 // ─── Command: create ──────────────────────────────────────────────────────────
 
@@ -48,6 +205,8 @@ export function registerCreate(program: Command): void {
     .option("--serve", "After workspace pipeline completes, auto-start mock server + patch frontend proxy")
     .option("--vcr-record", "Record all AI responses to .ai-spec-vcr/ for offline replay")
     .option("--vcr-replay <runId>", "Replay AI responses from a previous recording (zero API calls)")
+    .option("--openapi", "Auto-generate OpenAPI 3.1.0 YAML after DSL extraction")
+    .option("--types", "Auto-generate TypeScript types after DSL extraction")
     .action(async (idea: string | undefined, opts) => {
       const currentDir = process.cwd();
       const config = await loadConfig(currentDir);
@@ -60,22 +219,98 @@ export function registerCreate(program: Command): void {
         });
       }
 
-      // ── Detect workspace mode ───────────────────────────────────────────────
+      // ── Check for existing workspace config (legacy path) ──────────────────
       const workspaceLoader = new WorkspaceLoader(currentDir);
-      const workspaceConfig = await workspaceLoader.load();
-
-      if (workspaceConfig) {
-        console.log(chalk.cyan(`\n[Workspace] Detected workspace: ${workspaceConfig.name}`));
-        console.log(chalk.gray(`  Repos: ${workspaceConfig.repos.map((r) => r.name).join(", ")}`));
-        const pipelineResults = await runMultiRepoPipeline(idea!, workspaceConfig, opts, currentDir, config);
+      const existingWorkspaceConfig = await workspaceLoader.load();
 
+      if (existingWorkspaceConfig) {
+        console.log(chalk.cyan(`\n[Workspace] Detected workspace: ${existingWorkspaceConfig.name}`));
+        console.log(chalk.gray(`  Repos: ${existingWorkspaceConfig.repos.map((r) => r.name).join(", ")}`));
+        const pipelineResults = await runMultiRepoPipeline(idea!, existingWorkspaceConfig, opts, currentDir, config);
         if (opts.serve) {
           await handleAutoServe(pipelineResults);
         }
         return;
       }
 
-      // ── Single-repo pipeline ────────────────────────────────────────────────
-      await runSingleRepoPipeline(idea!, opts, currentDir, config);
+      // ── Resolve provider (for quick-register if needed) ────────────────────
+      const providerName = (opts.provider as string) || config.provider || "gemini";
+      const modelName = (opts.model as string) || config.model || DEFAULT_MODELS[providerName];
+      const apiKey = await resolveApiKey(providerName, opts.key as string | undefined);
+      const specProvider = createProvider(providerName, apiKey, modelName);
+
+      // Persist the resolved key on opts so downstream pipelines (single/multi-repo)
+      // short-circuit `resolveApiKey` via the cliKey path and skip a duplicate prompt.
+      // Without this, the user gets prompted twice for the same provider when
+      // create.ts and the pipeline both call resolveApiKey independently.
+      if (!opts.key) opts.key = apiKey;
+      // If user did NOT specify a separate codegen provider/key, the pipeline will
+      // fall back to spec provider — pre-fill codegenKey too so that path is silent.
+      const codegenProviderName = (opts.codegenProvider as string) || config.codegenProvider || providerName;
+      if (codegenProviderName === providerName && !opts.codegenKey) {
+        opts.codegenKey = apiKey;
+      }
+
+      // ── Select repo(s) from registered list ────────────────────────────────
+      const registeredRepos = await getRegisteredRepos();
+
+      if (registeredRepos.length === 0) {
+        console.log(chalk.yellow("\n  No repos registered. Please register repos first."));
+        console.log(chalk.gray("  Run: ai-spec init"));
+        console.log(chalk.gray("  Or add a repo now:\n"));
+
+        const addNow = await select({
+          message: "Add a repo now?",
+          choices: [
+            { name: "Yes — register a repo and continue", value: "yes" as const },
+            { name: "No — exit", value: "no" as const },
+          ],
+        });
+
+        if (addNow === "no") {
+          process.exit(0);
+        }
+
+        const newRepo = await quickRegisterRepo(specProvider);
+        registeredRepos.push(newRepo);
+      }
+
+      // Filter out repos whose paths no longer exist
+      const validRepos = [];
+      for (const r of registeredRepos) {
+        if (await fs.pathExists(r.path)) {
+          validRepos.push(r);
+        } else {
+          console.log(chalk.yellow(`  ⚠ Skipping ${r.name}: path not found (${r.path})`));
+        }
+      }
+
+      if (validRepos.length === 0) {
+        console.log(chalk.red("  No valid repos available. Run: ai-spec init"));
+        process.exit(1);
+      }
+
+      const selectedRepos = await selectRepos(validRepos, specProvider);
+
+      // ── Route to appropriate pipeline ──────────────────────────────────────
+      if (selectedRepos.length === 1) {
+        // Single-repo pipeline
+        const repo = selectedRepos[0];
+        console.log(chalk.cyan(`\n[Repo] ${repo.name} (${repo.type}/${repo.role}) → ${repo.path}`));
+        await runSingleRepoPipeline(idea!, opts, repo.path, config);
+      } else {
+        // Multi-repo pipeline — sort backend before frontend
+        const workspaceConfig = buildWorkspaceConfig(selectedRepos);
+
+        console.log(chalk.cyan(`\n[Workspace] ${selectedRepos.length} repo(s) selected:`));
+        for (const repo of selectedRepos) {
+          console.log(chalk.gray(`  ${repo.name} (${repo.type}/${repo.role}) → ${repo.path}`));
+        }
+
+        const pipelineResults = await runMultiRepoPipeline(idea!, workspaceConfig, opts, currentDir, config);
+        if (opts.serve) {
+          await handleAutoServe(pipelineResults);
+        }
+      }
     });
 }