ai-spec-dev 0.41.0 → 0.46.0

package/.ai-spec-workspace.json

@@ -0,0 +1,17 @@
+{
+  "name": "bookmark-demo",
+  "repos": [
+    {
+      "name": "demo-backend",
+      "path": "demo-backend",
+      "type": "node-express",
+      "role": "backend"
+    },
+    {
+      "name": "demo-frontend",
+      "path": "demo-frontend",
+      "type": "react",
+      "role": "frontend"
+    }
+  ]
+}

package/.ai-spec.json

@@ -0,0 +1,7 @@
+{
+  "provider": "glm",
+  "model": "glm-4.5-air",
+  "codegenMode": "api",
+  "codegenProvider": "glm",
+  "codegenModel": "glm-4.5-air"
+}

package/README.md

@@ -12,7 +12,7 @@
 <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/version-0.45.0-blue" alt="version" />
   <img src="https://img.shields.io/badge/tests-409%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" />
@@ -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,8 +122,9 @@ 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 init                 Register repos, generate project + global constitutions
+ai-spec init --add-repo      Quick-add a single repo
+ai-spec create [idea]        Select repo(s) → full pipeline: spec → DSL → codegen → review
 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)
@@ -204,10 +210,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 +249,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,8 +318,9 @@ ai-spec create "给用户模块增加登录功能"
 ### 命令总览
 
 ```
-ai-spec init                 分析代码库，生成项目宪法（.ai-spec-constitution.md）
-ai-spec create [idea]        完整流水线：宪法 → spec → DSL → 代码生成 → 审查 → 自评
+ai-spec init                 注册仓库，生成项目宪法 + 全局宪法
+ai-spec init --add-repo      快速添加单个仓库
+ai-spec create [idea]        选择仓库 → 完整流水线：spec → DSL → 代码生成 → 审查
 ai-spec update [change]      增量更新：修改 Spec → 重提取 DSL → 重新生成受影响文件
 ai-spec learn [lesson]       零摩擦知识注入，直接写入宪法 §9
 ai-spec review [file]        3-pass AI 代码审查（架构 + 实现 + 影响面）
@@ -387,13 +399,17 @@ ai-spec export --server <url>          # 指定服务器 URL
 ### 工作流详解
 
 <details>
-<summary>Step 1 — 项目宪法 + Context</summary>
+<summary>Step 0 — 初始化（ai-spec init）</summary>
 
-**项目宪法**（`.ai-spec-constitution.md`）包含 §1–§9 共 9 个章节，涵盖架构规则、命名规范、API 规范、数据层、错误处理、禁区、测试规范、共享配置清单、累积经验。
+`ai-spec init` 完成工作区准备：
 
-自动扫描的上下文包括：`package.json` / `composer.json` / `pom.xml` 依赖列表、Prisma schema、路由文件、错误处理模式、i18n/constants/enums 等共享配置。
+1. **注册仓库**：输入仓库绝对路径 → 自动检测类型/角色（Vue/React/Node/Java/...）
+2. **生成项目宪法**：对每个仓库自动扫描并生成 `.ai-spec-constitution.md`（§1–§9）
+3. **生成全局宪法**：汇总所有仓库的项目宪法要点 → 生成 `.ai-spec-global-constitution.md`
 
-**Constitution Rebase**：§9 积累超过 8 条时，运行 `ai-spec init --consolidate` 将经验提炼归并到 §1–§8。
+宪法链路：**仓库注册 → 项目宪法 → 全局宪法汇总**，运行时自动 merge（全局为基线，项目级覆盖）。
+
+`--add-repo` 支持快速追加仓库，`--consolidate` 将 §9 积累经验提炼归并到 §1–§8。
 </details>
 
 <details>

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 ──────────────────────────────────────────────────────────
 
@@ -60,22 +217,86 @@ 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);
+
+      // ── 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);
+        }
+      }
     });
 }