ai-spec-dev 0.1.0 → 0.14.1

package/RELEASE_LOG.md

@@ -0,0 +1,1444 @@
+# Release Log
+
+---
+
+## [0.16.0] 2026-03-24 — Spec 质量预评估 · 分层代码审查 · TDD 模式
+
+### 1. Spec 质量预评估（`core/spec-assessor.ts`, `prompts/spec-assess.prompt.ts`）
+
+- **触发时机**：`ai-spec create` 非 `--auto` 模式下，在 Approval Gate 之前自动运行（可用 `--skip-assessment` 跳过）
+- **评估维度**（0-10 分）：
+  - `coverageScore` — 错误处理、边界条件、auth 规则覆盖完整度
+  - `clarityScore` — API 契约是否足够清晰，可供 DSL 可靠提取
+  - `constitutionScore` — 是否与项目宪法保持一致（命名、错误码、中间件约定）
+- **输出**：评分条形图 + 具体问题列表 + 改进建议 + DSL 可提取性预警
+- **设计原则**：纯建议性，不阻断流程；让工程师在进入 Approval Gate 前就看到结构性问题
+
+### 2. 分层代码审查（`core/reviewer.ts`, `prompts/codegen.prompt.ts`）
+
+- **两遍审查替代单次审查**：
+  - **Pass 1（架构层）**：聚焦 Spec 合规性、层职责分离、安全权限、数据模型完整性 — 不评论代码细节
+  - **Pass 2（实现层）**：聚焦输入校验、错误处理、边界条件、代码模式 — 不重复架构层发现
+- **历史问题对比**：读取 `.ai-spec-reviews.json` 中最近 5 次审查，将 top issues 注入 Pass 2 prompt，触发「历史问题复现」检查
+- **评分趋势记录**：每次审查结束后，评分 + top issues 写入 `.ai-spec-reviews.json`（保留最近 20 条）；`ai-spec review` 命令在审查后自动打印趋势图
+- **constructor 新增 `projectRoot` 参数**：reviewer 实例绑定项目根目录，历史文件路径准确
+
+### 3. TDD 模式（`--tdd` flag, `core/test-generator.ts`, `prompts/testgen.prompt.ts`）
+
+- **新增 `--tdd` flag**：`ai-spec create --tdd`
+- **流程变化**：
+  ```
+  普通模式：DSL → codegen → 测试骨架（空断言）→ error feedback
+  TDD 模式：DSL → TDD 测试（真实断言，预期 FAIL）→ codegen → error feedback（最多 3 轮，以测试通过为目标）
+  ```
+- **TDD 测试 vs 骨架**：
+  - 骨架（原）：`it('should create task', () => { /* TODO */ })`
+  - TDD（新）：`expect(res.status).toBe(201); expect(res.body.data.id).toBeDefined(); expect(res.body.code).toBe('MISSING_FIELD')`
+- **新增 `tddTestGenSystemPrompt`**：要求 AI 生成可运行的断言，以 supertest 做 HTTP 集成测试，所有 endpoint 的成功/校验失败/auth 失败路径全部覆盖
+- **`TestGenerator.generateTdd()`**：新方法，使用 TDD prompt，由 `cli/index.ts` 在代码生成之前调用
+
+---
+
+## [0.15.0] 2026-03-24 — 并行 Task 执行（同层 tasks 并发）
+
+### 核心变更 (`core/code-generator.ts`)
+
+**问题**：`runApiModeWithTasks` 完全串行 — 一个 task 完成才开始下一个。6 个 service 层 task 每个 30s，总耗时 3 分钟。同层 task 之间通常没有真实依赖，浪费严重。
+
+**实现**：按 `data → infra → service → api → test` 顺序分层，每层内所有 pending task 通过 `Promise.all` 并发执行：
+
+```
+旧（串行）：
+TASK-002 → TASK-003 → TASK-004 → TASK-005 → ... (每个 30s = 2.5 分钟)
+
+新（同层并行）：
+TASK-002 ┐
+TASK-003 ┤ Promise.all (~30s)  →  TASK-005 ┐
+TASK-004 ┘                         TASK-006 ┘  (~30s)
+```
+
+**关键设计决策**：
+1. **Shared config 文件排除并行**：`routes/index.ts` 等注册文件从各 task 的 filePlan 中剥离，改为层完成后统一执行一次 batch update（携带该层所有新建模块名），避免多个 AI 调用同时覆写同一文件
+2. **Cache 快照隔离**：同层所有 task 拿到的是本层开始前的 `generatedFileCache` 快照，避免同层 task 之间的竞态；层结束后统一写入 cache，供下一层使用
+3. **并行输出前缀**：`generateFiles` 新增 `taskLabel` 参数，并行模式下每行输出加 `[TASK-XXX]` 前缀，防止多 task 输出行交叉混乱
+4. **done task 先显示**：已完成 task 在进入层循环前统一展示跳过，进度条状态清晰
+
+**输出示例**：
+```
+  [████████░░░░░░░░░░░░] 40% ⚡ Layer [service] 🔧 — 3 tasks running in parallel
+  [TASK-002] + src/services/userService.ts ✔
+  [TASK-003] + src/services/productService.ts ✔
+  [TASK-004] + src/services/orderService.ts ✔
+
+  ✔ TASK-002 🔧 Create user service — 1/1 files
+  ✔ TASK-003 🔧 Create product service — 1/1 files
+  ✔ TASK-004 🔧 Create order service — 1/1 files
+
+    + updating shared config: src/router/routes/index.ts [route-index]
+```
+
+---
+
+## [0.14.5] 2026-03-24 — 前端分页参数一致性：自动提取并注入项目真实分页 pattern
+
+### 分页参数 ground-truth 注入 (`core/frontend-context-loader.ts`)
+
+- **问题**：生成的列表接口使用 `page`/`size` + GET `{ params }`，但项目实际使用 `pageIndex`/`pageSize` + POST body，导致前端运行时分页失效
+- **根因**：
+  1. `src/apis/` 目录不在 API 文件扫描路径中 → `httpClientImport` 提取失败 → AI 回退到 raw `axios` 而非 `http from '@/utils/http'`
+  2. `FrontendContext` 无分页 pattern 字段 → AI 使用通用默认值而非项目约定
+- **修复**：
+  1. 将 `"src/apis/**/*.{ts,js}"` 加入 `apiFilePatterns`，修复 `httpClientImport` 提取覆盖缺失问题
+  2. 新增 `paginationExample?: string` 字段至 `FrontendContext`
+  3. 新增分页 pattern 提取逻辑：扫描所有 API 文件，找到包含 `pageIndex`/`pageSize`/`pageNum`/`current`/`page`/`size` 等字段的 interface，并提取使用该 interface 的第一个导出函数作为示例
+  4. `buildFrontendContextSection()` 注入时使用强制标签：`"COPY THIS EXACTLY for all paginated list APIs — use IDENTICAL parameter names, HTTP method, and call style"`
+
+---
+
+## [0.14.4] 2026-03-24 — 前端出码率提升：路由 Index 自动注册 & 跨 Task 函数名一致性
+
+### 1. 路由模块 Index 注册特指化 (`core/code-generator.ts`)
+
+- **问题**：`impliesRegistration` 自动注入 `routes/index.ts` 时，purpose 只写 `"Register/update route-index entries for the new feature"` — AI 不知道具体要 import 哪个模块名，经常不修改 index 文件
+- **修复**：注入 `route-index` / `store-index` 类文件时，从同 task 正在新建的文件中提取模块名，生成具体描述：
+  > `"Add to this file: import taskManagement from their respective paths and register them in the export/default array. Do NOT remove any existing imports."`
+
+### 2. 跨 Task 函数名一致性（Generated File Cache）(`core/code-generator.ts`)
+
+- **根本原因**：API 文件（Task A 生成 `src/apis/task.ts`，导出 `getTaskList`）与路由文件（Task B 生成）是两个完全独立的 AI 调用，Task B 看不到 Task A 写了什么，只能靠 DSL endpoint ID 猜函数名 → 猜出 `getTasks` 而非 `getTaskList`
+- **修复**：
+  1. 新增 `buildGeneratedFilesSection(cache)` — 将已生成文件的内容格式化为 `=== Files Already Generated in This Run ===` 区段注入后续 task
+  2. 每个 task 完成后，将写入的 `src/api*` / `src/service*` / `src/store*` / `src/composable*` 文件读回，存入 `generatedFileCache: Map<string, string>`
+  3. 后续每个 task 的 `generateFiles` 调用都携带 `generatedFilesSection`，后续 task 可以看到之前 task 输出的确切导出名称
+
+### 3. 系统提示新增规则 (`prompts/codegen.prompt.ts`)
+
+- **规则 16**（路由 Index 强制注册）：创建 `src/router/routes/X.ts` 时**必须同时**更新 `routes/index.ts`，添加 import 和 export 注册
+- **规则 17**（跨文件一致性）：`=== Files Already Generated in This Run ===` 中的函数名是权威来源，NEVER 重命名或猜测替代名；无此区段时从 DSL endpoint ID 推导
+
+---
+
+## [0.14.3] 2026-03-24 — 欢迎界面
+
+### Welcome Screen (`cli/welcome.ts`, `cli/index.ts`)
+
+- `ai-spec` 无参数运行时展示两栏欢迎界面（仿 Claude Code 风格），不再直接输出帮助文本
+- **左栏**：橙色标题栏 `─── ai-spec v0.14.1 ───` · 居中 `Welcome back, <username>!` · Unicode 机器人 ASCII art · Provider/Model/当前目录（超长路径自动截断 + `…`）
+- **右栏**（垂直分隔符分割）：
+  - **Tips for getting started** — 三条常用命令示例
+  - **Recent activity** — 扫描 `specs/` 目录，列出最近 3 个 spec 文件及相对时间（`2d ago`、`3h ago`）
+- `program.version` 从硬编码错误值 `"0.6.0"` 更正为 `"0.14.1"`
+
+---
+
+## [0.14.2] 2026-03-24 — Java/Maven 项目上下文感知
+
+### Java 项目 ContextLoader 支持 (`core/context-loader.ts`)
+
+- **问题**：`ContextLoader.loadProjectContext()` 只处理 PHP（`composer.json`）和 Node.js（`package.json`）；Java Maven/Gradle 项目的 `techStack` 和 `dependencies` 均为空，workspace `[W1]` 显示 `unknown (0 deps)`
+- **修复**：
+  1. 新增 `isJava` 检测：`pom.xml` / `build.gradle` / `build.gradle.kts`，优先级在 Node.js 之前
+  2. 新增 `loadMavenOrGradle(context)` — Maven：正则提取所有 `<artifactId>` 标签（跳过项目自身 artifact），解析 `<maven.compiler.source>` 获取 Java 版本，按依赖名推断技术栈（Spring Boot / MyBatis / JPA / Dubbo / RocketMQ / Redis / Lombok / OpenFeign / Nacos / Sentinel）；Gradle：提取 `group:artifact:version` 格式中的 artifactId
+  3. 新增 `loadJavaApiStructure(context)` — glob `**/src/main/java/**/*Controller.java`（排除 `target/`）作为 `apiStructure`；读取 `application.properties/yml` 前 800 字符作为 `routeSummary`
+
+---
+
+## [0.14.1] 2026-03-24 — 关键 Bug 修复：非 Node 项目生成 TypeScript 代码
+
+### `repoType` 从未传入 `generateCode`，导致所有非 Node 项目使用 Node.js 系统提示 (`cli/index.ts`)
+
+- **根本原因**：`getCodeGenSystemPrompt(options.repoType)` 需要 `repoType` 参数才能选择对应语言的 prompt（PHP / Go / Java / Rust / Python），但两处 `generateCode` 调用（单 repo `create` 命令 + workspace pipeline）都**从未传过 `repoType`**
+  — `options.repoType` 始终是 `undefined`，一律 fallback 到 Node.js/TypeScript 默认 prompt
+  — PHP 项目生成 `.ts` / `prisma/schema.prisma`；Java 项目生成 TypeScript 代码
+- **修复**：
+  1. 单 repo `create` 命令：在加载 context 后立即调用 `detectRepoType(currentDir)`，将结果作为 `repoType` 传入 `generateCode`
+  2. workspace pipeline `runSingleRepoPipelineInWorkspace`：同样调用 `detectRepoType(repoAbsPath)`，传入 `generateCode`
+  3. Tech stack 日志新增语言标签显示（如 `PHP, Lumen [php]`），便于排查
+
+---
+
+## [0.14.0] 2026-03-24 — P0 修复：前端框架检测统一 & Task 模式前端上下文显式注入
+
+### 1. `isFrontendDeps` — 单一可信源 (`core/context-loader.ts`)
+
+- **问题**：`["react", "vue", "next", "react-native", "expo"]` 这个列表在 6 个地方各写一遍（`cli/index.ts` ×4、`code-generator.ts`、`test-generator.ts`、`spec-updater.ts`）
+  — 添加新框架（Svelte、Solid、Nuxt）需要改 6 个地方，且各处已经不一致（`spec-updater.ts` 漏掉了 `expo`）
+- **修复**：
+  - 新增 `export const FRONTEND_FRAMEWORKS` — 完整列表（含 Svelte、Solid、Qwik、Nuxt）
+  - 新增 `export function isFrontendDeps(deps: string[]): boolean`
+  - 所有 6 处 inline 检测全部替换为 `isFrontendDeps(...)` / `FRONTEND_FRAMEWORKS`
+  - 以后只改一处即可全局生效
+
+### 2. `frontendSection` 从隐式变为显式参数 (`core/code-generator.ts`)
+
+- **问题**：`frontendSection` 被拼入 `constitutionSection` 字符串后传给 `runApiModeWithTasks`，命名误导 — 未来有人往 `constitutionSection` 拼了其他内容时容易漏掉 `frontendSection`
+- **修复**：`runApiModeWithTasks` 新增独立的 `frontendSection: string` 参数，在 `generateFiles` 调用中显式拼入 `constitutionSection + frontendSection + sharedConfigSection`
+  — 前端上下文（layout import、store 范式、组件复用列表、HTTP client import 等）现在在 task 模式中**有名有姓地**注入每个文件生成请求
+
+---
+
+## [0.13.9] 2026-03-24 — 组件复用感知
+
+### 前端组件复用上下文 (`core/frontend-context-loader.ts`, `prompts/codegen.prompt.ts`)
+
+- **问题**：AI 不知道项目 `src/components/` 里已经有哪些组件，也不知道现有页面里用的是哪些 UI 库组件，导致重复造轮子或使用与项目风格不符的写法
+- **新增字段**：
+  - `reusableComponents: string[]` — 扫描 `src/components/` 全部 `.vue/.tsx/.jsx`，列出所有可复用组件路径（最多 40 个）
+  - `pageExamples: string[]` — 读取 1-2 个现有 view/page 文件前 80 行，展示实际的组件引用和 UI 库使用方式
+- **上下文注入**：
+  - 组件列表标注为 "check this BEFORE creating a new component"
+  - 页面示例标注为 "follow the same import and usage patterns"
+- **系统提示新增规则**：
+  - 规则 12：生成任何 UI 组件前，先检查 `reusableComponents` 列表，有的直接 import 复用
+  - 规则 13：从 `pageExamples` 学习 UI 库组件的具体用法，不用原生 HTML 替代已有的组件
+
+---
+
+## [0.13.8] 2026-03-24 — Store HTTP 幻觉 & HTTP Client Import 幻觉修复
+
+### 1. Store 层直接发 HTTP 请求 (`core/frontend-context-loader.ts`, `prompts/codegen.prompt.ts`)
+
+- **根本原因**：`storeFiles` 只传文件路径列表，AI 从未看到项目里真实 store 的内容，用了训练数据里"store 自己做请求"的默认经验
+- **修复**：
+  1. `FrontendContext` 新增 `storePatterns: string[]` — 读取 1-2 个现有 store 文件的前 60 行内容
+  2. `buildFrontendContextSection()` 将 store 内容标注为 **"CRITICAL — stores call API layer, NOT HTTP directly"**，直接作为结构模板
+  3. `codeGenSystemPrompt` 新增架构层分离规则：Store 只能调用 API 层函数，不能直接发 HTTP 请求
+
+### 2. HTTP client import 幻觉（`@/utils/request`）(`core/frontend-context-loader.ts`)
+
+- **根本原因**：API 文件的 HTTP client import 路径没有被提取为具名事实，AI 猜测了一个在中文 Vue 项目中常见但本项目不存在的路径
+- **修复**：
+  1. `FrontendContext` 新增 `httpClientImport?: string` — 正则扫描现有 API 文件，提取精确 import 行（支持 `@/` 别名路径和 `axios`/`ky` 直接导入）
+  2. `buildFrontendContextSection()` 将该行标注为 **"COPY THIS EXACTLY"**，禁止 AI 发明其他路径
+
+---
+
+## [0.13.6] 2026-03-24 — Layout 幻觉 & 路由注册可靠性修复
+
+### Layout 组件路径幻觉 (`core/frontend-context-loader.ts`)
+
+- **根本原因**：AI 在 120 行的路由模块预览里"看到"了正确的 `@/layout/index.vue`，但训练数据里 `@/layouts/MainLayout.vue` 更常见，覆盖了实际样本
+- **修复**：主动提取，而非依赖 AI 自行寻找
+  1. `extractRouteModuleContext()` — 扫描 `src/router/modules/` 中的现有模块文件，用正则提取 Layout import 的**精确代码行**（支持 `const Layout = () => import(...)` / `import Layout from ...` 两种形式）
+  2. 取一个完整的路由模块文件（≤100行）作为 `routeModuleExample`
+  3. `buildFrontendContextSection()` 将 layout import 行标注为 **"COPY THIS EXACTLY"**，路由模块作为 **structural template** 直接插入提示
+- 效果：AI 收到的是**具名事实**（`layoutImport = "const Layout = () => import('@/layout/index.vue')"`)而非需要在样本里自行找，彻底避免路径幻觉
+
+---
+
+## [0.13.5] 2026-03-24 — 前端代码生成幻觉 & 路由规范修复
+
+### 1. 依赖幻觉防御 — 禁止使用未安装的包 (`core/code-generator.ts`, `prompts/codegen.prompt.ts`)
+
+- **根本原因**：codegen 上下文只传了 `techStack` 和部分文件名，AI 从未收到实际安装的 npm 包列表，只能靠猜测 → 幻觉引入 `vue-i18n` 等不存在的依赖
+- **修复**：
+  1. 新增 `buildInstalledPackagesSection()` — 将项目的完整 `dependencies` 列表格式化为 `=== Installed Packages ===` 区段，注入进每次生成调用（plan/api/task 三种路径均覆盖）
+  2. `codeGenSystemPrompt` 新增绑定性规则：**ONLY use packages from the Installed Packages list. NEVER import anything not listed.** 若功能需要不存在的包，用已有包实现等价逻辑
+
+### 2. 从样本学习约定，而非 hardcode 目录规则 (`prompts/codegen.prompt.ts`, `core/code-generator.ts`, `core/context-loader.ts`)
+
+- **根本原因**：之前用 `hasRouterModules` 检测 `src/router/modules/` 目录来注入特定规则，这是 hack — 换个项目结构就失效
+- **修复方向**：让 AI 从真实代码样本中自行推断项目约定，而非靠工具硬编码猜测
+  1. 移除 `buildSharedConfigSection()` 中的 `hasRouterModules` 目录检测逻辑
+  2. 移除 `codeGenSystemPrompt` 中的 Vue Router 专项硬编码规则
+  3. 新增通用的"样本优先"规则：**从 Existing Shared Config Files 中的真实代码学习结构、命名和注册方式，项目样本 > 框架默认经验**
+  4. shared config files preview 从 80 行提升到 120 行，确保 AI 看到完整的路由模块示例
+
+---
+
+## [0.13.4] 2026-03-24 — MiMo max_tokens 截断修复
+
+### MiMo `stop_reason: max_tokens` 导致 DSL 提取失败 (`core/spec-generator.ts`)
+
+- MiMo 在生成 DSL JSON 时，若 CoT thinking 内容过长会先耗尽 token，导致响应中只有 `thinking` block、没有 `text` block
+- 之前抛出 `Unexpected MiMo response` 原始 JSON，信息不易排查
+- 修复：
+  1. `max_tokens` 从 `8192` 提升到 `16384`，减少截断概率
+  2. 检测 `stop_reason === "max_tokens"`，抛出明确提示："prompt 过长，可缩短 spec 或换更大 context 的模型"
+
+---
+
+## [0.13.3] 2026-03-24 — DSL 校验误报修复
+
+### DSL `errors[].code` 空字符串导致校验失败 (`core/dsl-extractor.ts`)
+
+- AI 生成 DSL 时偶尔将 `endpoints[].errors[].code` / `.description` 输出为空字符串 `""`
+- 校验器报 `Must be a non-empty string, got: string`，触发无效 retry 循环
+- 修复：在 `validateDsl` 前调用 `sanitizeDsl()`，自动过滤掉 `code`/`description` 为空的 error 条目；若全部被过滤则删除整个 `errors` 字段
+
+---
+
+## [0.13.2] 2026-03-24 — API Key 持久化
+
+### API Key 持久化存储 (`core/key-store.ts`, `cli/index.ts`)
+
+- 第一次输入 API key 后自动保存到 `~/.ai-spec-keys.json`（文件权限 600，仅 owner 可读）
+- 下次运行时若已有保存的 key，显示脱敏 key（`sk-ab12...ef56`）并提示选择：
+  - **Use saved key** — 直接复用
+  - **Enter a new key** — 输入新 key 并覆盖保存
+- 优先级：CLI `--key` flag → 环境变量 → 保存的 key → 交互输入
+- 新增 `ai-spec config` 子命令选项：
+  - `--list-keys` — 列出所有已保存 key 的 provider（脱敏显示）
+  - `--clear-key <provider>` — 删除指定 provider 的保存 key
+  - `--clear-keys` — 清除全部保存的 key
+
+---
+
+## [0.13.1] 2026-03-23 — 前端自动跳过 worktree & Bug 修复
+
+### 1. 前端项目自动跳过 worktree (`cli/index.ts`)
+
+- 检测到前端项目（依赖含 `react` / `vue` / `next` / `react-native` / `expo`）时，**自动设置 `skipWorktree = true`**
+  - 原因：worktree 不复制 `node_modules`，前端 dev server 启动会失败
+  - 代码直接在当前仓库的新分支上生成，无需手动 `cd` 到 worktree
+- 新增 `--worktree` flag：强制开启 worktree，覆盖自动跳过行为
+- workspace pipeline 中前端/mobile repo 同样自动跳过
+
+### 2. MiMo Thinking Block 修复 (`core/spec-generator.ts`)
+
+- MiMo v2 Pro 启用 CoT 时会在 `content` 数组首位返回 `{ type: "thinking" }` block
+- 之前只检查 `content[0].type === "text"`，thinking 排第一时抛异常并将原始响应打印到终端
+- 修复：改用 `blocks.find(b => b.type === "text")` 跳过 thinking block
+
+### 3. vue-tsc 工具崩溃检测 (`core/error-feedback.ts`)
+
+- `vue-tsc` 与 TypeScript 版本不兼容时会抛 `ReferenceError: ScriptKind is not defined`
+- 之前将此错误当作真实类型错误喂进 AI 自动修复循环，导致无效修复
+- 修复：检测到 `ReferenceError/TypeError` + `node_modules` 堆栈时，判定为工具崩溃，打印警告并跳过
+
+### 4. git diff --cached 在非 git 目录崩溃 (`core/reviewer.ts`)
+
+- 在非 git 目录执行 `git diff --cached` 时，git 输出 `error: unknown option 'cached'` 并将整个帮助信息喷到终端
+- 修复：先执行 `git rev-parse --is-inside-work-tree` 前置检查，并对所有 git 命令加 `stdio: "pipe"` 静默 stderr
+
+### 5. Worktree 后 node_modules/vendor 丢失 (`git/worktree.ts`)
+
+- worktree 目录不含 `node_modules`，导致 `vite: command not found`
+- 修复：worktree 创建后自动 symlink `node_modules/`（Node.js）和 `vendor/`（PHP Composer）
+
+### 6. Task 模式下路由/Store 文件未被修改 (`core/code-generator.ts`)
+
+- Task 的 `filesToTouch` 只含组件文件，路由注册文件未被处理
+- 修复：检测到 task 涉及新建页面/组件时，自动将 `sharedConfigFiles`（router/store）注入当前 task 的 filePlan
+- 所有已存在文件的 action 从硬编码 `"create"` 改为动态检测 `"modify"`
+
+### 7. Workspace Init 自动扫描子目录 (`cli/index.ts`)
+
+- 之前只能逐个手动添加 repo
+- 新增：输入 workspace name 后询问「Auto-scan sibling directories?」，一键检测所有子目录
+
+---
+
+## [0.13.0] 2026-03-23 — 上下文感知 & 错误反馈增强
+
+### 1. sharedConfigFiles 路由/Store 扫描补全 (`core/context-loader.ts`)
+
+新增路由注册文件扫描模式：
+- Vue Router Modules: `src/router/modules/**/*.{ts,js}`, `src/router/routes.{ts,js}`
+- React Router: `src/routes.{ts,tsx}`, `src/router.{ts,tsx}`
+- PHP Lumen/Laravel: `routes/api.php`, `routes/web.php`
+
+新增 Store 注册文件扫描，独立 `store-index` 分类：
+- Pinia/Vuex: `src/stores/index.ts`, `src/store/modules/index.ts`
+- Redux: `src/store/rootReducer.ts`, `src/app/store.ts`
+
+`fileStructure` 扫描范围扩大：maxDepth 3→5，文件数上限 60→120，新增排除 `vendor/**`、`build/**`、`*.map`、`*.min.js`
+
+### 2. TypeScript 类型检查加入 error feedback loop (`core/error-feedback.ts`)
+
+新增 `detectBuildCommand()`：
+- 有 `tsconfig.json` + `vue-tsc` → `npx vue-tsc --noEmit`
+- 有 `scripts.type-check` / `scripts.typecheck` → `npm run type-check`
+- 默认 → `npx tsc --noEmit`
+
+`ErrorFeedbackOptions` 新增 `skipBuild?: boolean`
+type-check 在 test/lint 之前运行（最快，最常见错误源）
+
+### 3. PHP / Lumen 项目上下文感知 (`core/context-loader.ts`)
+
+新增 `loadComposerJson()`：读取 `composer.json`，提取依赖和技术栈（Lumen/Laravel/Eloquent/JWT Auth 等）
+新增 `loadPhpRoutes()`：加载 `routes/api.php` + `routes/web.php` 作为 routeSummary，扫描 `app/Http/Controllers/**/*.php` 作为 apiStructure
+PHP 异常处理文件识别：`app/Exceptions/Handler.php`
+
+---
+
+## [0.12.2] 2026-03-23 — PHP/Lumen 后端支持
+
+**修改：** `core/workspace-loader.ts` · `core/error-feedback.ts` · `prompts/codegen.prompt.ts`
+
+- `RepoType` 新增 `"php"` 类型
+- `detectRepoType()` 新增 `composer.json` 检测（优先级在 Node.js 之前）：自动识别 PHP/Lumen/Laravel 项目为 `{ type: "php", role: "backend" }`
+- `autoDetect()` manifest 列表新增 `composer.json`（workspace init 时自动扫描 PHP 项目）
+- `detectTestCommand()`：PHP → `./vendor/bin/phpunit --colors=never` 或 `php artisan test --no-ansi`
+- `detectLintCommand()`：PHP → `./vendor/bin/phpstan analyse`（如已安装，否则 null）
+- `parseErrors()` 文件扩展名正则新增 `.php`
+- 新增 `codeGenPhpSystemPrompt`：PSR-12，PHP 8.x，Lumen/Laravel 路由约定，Eloquent ORM，构造器属性提升
+
+---
+
+## [0.12.1] 2026-03-23 — 恢复 MiMo v2 Pro 支持
+
+**修改：** `core/spec-generator.ts`
+
+- 新增 `MiMoProvider` 类：使用 axios 直接调用小米 MiMo API
+  - Endpoint: `https://api.xiaomimimo.com/anthropic/v1/messages`
+  - Auth 格式：`api-key: $MIMO_API_KEY`（不同于 Anthropic 的 `x-api-key`，因此无法复用 Anthropic SDK，用 axios 独立实现）
+  - 请求/响应格式与 Anthropic messages API 兼容
+- `PROVIDER_CATALOG` 新增 `mimo` 条目：`mimo-v2-pro`，env var `MIMO_API_KEY`
+- `createProvider()` factory 新增 `case "mimo"` 分支
+
+**使用：**
+```bash
+export MIMO_API_KEY=your_key_here
+ai-spec create "功能描述" --provider mimo
+ai-spec create "功能描述" --provider mimo --model mimo-v2-pro
+```
+
+---
+
+## [0.12.0] 2026-03-23 — 宪法整合：`ai-spec init --consolidate`
+
+### 问题
+
+`ai-spec review` 每次运行后会把审查 issue 追加到宪法 §9。长期运行后 §9 会积累几十条条目，其中充斥着重复措辞、已修复问题的历史记录、不再适用的早期教训。宪法被注入每次 AI 调用，§9 越长越造成 token 浪费和信噪比下降（代码中有 2000 字符硬截断，超出部分直接丢弃）。
+
+### 解决方案：Constitution Rebase
+
+类比 `git rebase`：把散落在 §9 的经验教训提炼、去重，归并到 §1–§8 相应章节，再清理 §9。
+
+---
+
+### 新增：`prompts/consolidate.prompt.ts`
+
+- `consolidateSystemPrompt` — 主导 AI 按三条决策路径处理每条 §9 lesson：
+  - **LIFT**：通用且持久的规则 → 自然融入 §1–§8 对应章节，改写为规范性语句
+  - **KEEP**：近期特定、尚未泛化 → 保留在 §9（max 5 条）
+  - **DROP**：重复、已覆盖或不再适用 → 删除
+- `buildConsolidatePrompt()` — 注入完整宪法和 §9 数量
+- `parseConstitutionStats()` — 解析宪法的总行数、§9 行数、lesson 数量（用于阈值检测和效果对比）
+
+### 新增：`core/constitution-consolidator.ts`
+
+- `ConstitutionConsolidator.consolidate()` — 完整整合流程：
+  1. 解析当前 §9 数量，低于阈值（默认 5）直接跳过
+  2. 调用 AI 生成整合后的宪法
+  3. 展示彩色 diff（复用 `computeDiff` / `printDiff`）
+  4. 写入前自动创建带时间戳的备份（`.ai-spec-constitution.backup-YYYY-MM-DD-HH-MM-SS.md`）
+  5. 写入整合后的宪法，输出前后对比数据
+- `checkConsolidationNeeded()` — 可供外部调用的阈值检查函数
+
+### 修改：`core/knowledge-memory.ts`
+
+`appendLessonsToConstitution()` 写入后自动检查 §9 数量：
+- ≥ 8 条时打印黄色提示：`⚠ §9 now has N lessons. Run \`ai-spec init --consolidate\` to prune and rebase.`
+
+### 修改：`cli/index.ts` — `init` 命令新增两个选项
+
+```
+ai-spec init --consolidate          # 整合 §9 → §1–§8，清理冗余（需要现有宪法）
+ai-spec init --consolidate --dry-run   # 预览整合结果，不写入磁盘
+```
+
+整合流程输出示例：
+```
+─── Constitution Consolidation ──────────────────
+  File    : .ai-spec-constitution.md
+  Size    : 187 lines
+  §9 items: 14 accumulated lessons
+
+  Consolidating 14 lesson(s) with AI...
+
+  Changes preview:
+  + ## 3. API 规范
+  +   - 所有 POST 接口必须在 request body 中验证 email 格式，不接受裸字符串
+  ...
+  ~ removed: 8 lines  added: 3 lines
+
+  After consolidation:
+  Size    : 162 lines (was 187)
+  §9 items: 4 remaining (was 14)
+  ✔ ~10 lesson(s) lifted into §1–§8 or removed
+
+  Backup  : .ai-spec-constitution.backup-2026-03-23-14-30-00.md
+  ✔ Constitution updated: .ai-spec-constitution.md
+
+  Summary:
+  Lines : 187 → 162 (-25)
+  §9    : 14 → 4 lessons remaining
+```
+
+---
+
+## [0.11.0] 2026-03-23 — 三大高优先级补全：增量更新 / OpenAPI 导出 / 多语言 Codegen Prompt
+
+### 目标
+
+填补工具链中最关键的三个空白：变更驱动的需求更新、标准接口格式导出、以及对 Go/Python/Java/Rust 项目的真正有效代码生成。
+
+---
+
+### Feature 1：`ai-spec update` — 增量 Spec + 代码更新流水线
+
+**核心思路：** 现实中 90% 的工作是"改需求"，而非从零开始。现有的 `create` 命令无法处理这种场景。
+
+**新增：** `core/spec-updater.ts`
+
+- `SpecUpdater.update()` — 三步流程：
+  1. **更新 Spec**：AI 读取现有 Spec + 变更描述 → 生成更新后的完整 Spec（保留未变更部分）
+  2. **更新 DSL**：若存在现有 DSL → 使用定向 DSL 更新 prompt（只更新变化的端点/模型）；失败时降级为全量重提取
+  3. **识别受影响文件**：对比新旧 DSL，让 AI 列出需要修改的文件列表（不是全量重生成）
+- `SpecUpdater.findLatestSpec()` — 从 `specs/` 目录自动找最新版本文件
+- 所有结果写入新版本文件（`feature-xxx-v2.md` + `feature-xxx-v2.dsl.json`）
+
+**新增：** `prompts/update.prompt.ts`
+
+- `specUpdateSystemPrompt` — 要求 AI 最小化改动，保留原有结构
+- `dslUpdateSystemPrompt` — 针对 DSL JSON 的精准更新指令（保留未变更条目）
+- `buildAffectedFilesPrompt()` — 基于 DSL diff（新增/修改的端点/模型）生成受影响文件 prompt
+
+**新增：** `cli/index.ts` — `ai-spec update` 命令
+
+```
+ai-spec update "新增商品收藏功能"        # 自动找最新 Spec，生成 v2
+ai-spec update "把价格字段改为 Float"   # 更新 DSL 模型字段
+ai-spec update --codegen               # 更新完后自动重新生成受影响文件
+ai-spec update --spec specs/xxx-v1.md  # 指定 Spec 文件
+ai-spec update --skip-affected         # 跳过受影响文件识别
+```
+
+**工作流对比：**
+
+| 场景 | 之前 | 现在 |
+|---|---|---|
+| 新功能 | `ai-spec create "..."` | 同上 |
+| 改现有功能 | 手动修改 Spec + 手动更新代码 | `ai-spec update "..."` |
+| 改完自动更新代码 | 不支持 | `ai-spec update "..." --codegen` |
+
+---
+
+### Feature 2：`ai-spec export` — DSL → OpenAPI 3.1.0
+
+**核心思路：** DSL 已是结构化中间表示，距离 OpenAPI 只差一步。有了 OpenAPI 可以接入整个开放生态。
+
+**新增：** `core/openapi-exporter.ts`
+
+- `dslToOpenApi()` — 将 SpecDSL 转换为 OpenAPI 3.1.0 对象：
+  - `models[]` → `components.schemas`（含类型映射、required 字段推断）
+  - `endpoints[]` → `paths`（含路径参数提取、query params、requestBody、success/error responses）
+  - `auth: true` → `security: [{bearerAuth: []}]` + `components.securitySchemes.bearerAuth`
+  - 自动注入 `ErrorResponse` 通用 schema
+  - 路径参数格式自动转换（`:id` → `{id}`）
+- `exportOpenApi()` — 写入 `openapi.yaml` 或 `openapi.json`（内置 YAML 序列化，零外部依赖）
+
+**新增：** `cli/index.ts` — `ai-spec export` 命令
+
+```
+ai-spec export                      # 读取最新 DSL，生成 openapi.yaml
+ai-spec export --format json        # 生成 openapi.json
+ai-spec export --server https://api.example.com   # 指定服务器 URL
+ai-spec export --output docs/api.yaml             # 指定输出路径
+ai-spec export --dsl specs/xxx.dsl.json           # 指定 DSL 文件
+```
+
+**下游工具链：**
+
+```
+openapi.yaml → Postman / Insomnia 直接导入
+           → openapi-generator → TypeScript / Go / Python / Java SDK
+           → Swagger UI → 在线接口文档
+           → Prism → 更专业的 mock server
+```
+
+---
+
+### Feature 3：多语言 Codegen System Prompt
+
+**核心思路：** `workspace-loader` 已识别 Go/Python/Java/Rust，但代码生成的 prompt 仍是 Node.js 风格。对这些项目生成的代码是无法使用的。
+
+**修改：** `prompts/codegen.prompt.ts`
+
+新增四个语言专属 system prompt，并提供统一入口函数：
+
+```typescript
+getCodeGenSystemPrompt(repoType?: string): string
+// "go"     → codeGenGoSystemPrompt
+// "python" → codeGenPythonSystemPrompt
+// "java"   → codeGenJavaSystemPrompt
+// "rust"   → codeGenRustSystemPrompt
+// default  → codeGenSystemPrompt (Node.js)
+```
+
+各 prompt 的核心差异：
+
+| 语言 | 关键规则 |
+|---|---|
+| Go | 惯用 Go 风格（named return errors, context, slog/zap），按 go.mod 检测 router（chi/gin/echo），标准 testing + testify |
+| Python | 检测 FastAPI/Flask/Django，PEP 8 + type annotations + Pydantic，正确注册路由（APIRouter / urls.py） |
+| Java | Spring Boot 分层（Controller→Service→Repository），构造器注入，Lombok 支持，@ControllerAdvice |
+| Rust | 检测 Axum/Actix-web，Result<T,E> everywhere，no unwrap() in production，现有 Cargo.toml crates only |
+
+**修改：** `core/code-generator.ts`
+
+- `CodeGenOptions` 新增 `repoType?: string` 字段
+- `runApiMode()` 根据 `repoType` 调用 `getCodeGenSystemPrompt()` 选择 prompt
+- `generateFiles()` 和 `runApiModeWithTasks()` 透传 `systemPrompt` 参数
+
+**修改：** `core/error-feedback.ts`
+
+- `attemptFix()` 改为使用 `getCodeGenSystemPrompt()`（修复时也使用语言正确的 prompt）
+
+---
+
+## [0.10.0] 2026-03-23 — Mock Server + 多语言后端支持
+
+### 目标
+
+解决 `ai-spec create` 之后前后端联调断层问题：后端 DSL 已有，但服务未部署、本地无法连数据库，前端无从联调。同时扩展多语言后端 Repo 识别与错误反馈。
+
+---
+
+### Feature 1：`ai-spec mock` — 一键联调 Mock 套件
+
+**新增：** `core/mock-server-generator.ts`
+
+从已有 DSL（`.ai-spec/*.dsl.json`）生成三类联调资产：
+
+**① 独立 Express Mock 服务器（`mock/server.js`）**
+
+- 纯 CommonJS，只依赖 `express`，无需任何编译，`node mock/server.js` 即运行
+- 每个 DSL 端点对应一个路由，返回从数据模型字段类型推断的 fixture 响应
+  - `DateTime` → ISO 8601 字符串，`Int` ID 字段 → `"abc123"`，`price` 字段 → `9.99`，List 端点 → `{ data: [...], total, page, pageSize }`
+- `auth: true` 端点自动挂 Bearer Token 验证中间件（缺失时返回 401）
+- CORS 全开（dev only）
+- 生成 `mock/README.md`：端点表、快速启动说明
+
+**② 前端 Proxy 配置片段（`--proxy`）**
+
+- 自动识别前端框架（检测 `vite.config.*` / `next.config.*` / `react-scripts` / `webpack.config.*`）
+- 按框架生成对应配置片段（注释形式）：
+  - Vite → `server.proxy` 块
+  - Next.js → `rewrites()` 数组
+  - CRA → `package.json "proxy"` + `setupProxy.js`
+  - webpack → `devServer.proxy` 块
+
+**③ MSW Handler（`--msw`）**
+
+- 生成 `src/mocks/handlers.ts`：msw v2 风格，`http.get/post/...` + `HttpResponse.json()`
+- 生成 `src/mocks/browser.ts`：`setupWorker` 初始化
+- 适用于前端完全脱离后端本地运行的场景
+
+**新增：** `cli/index.ts` — `ai-spec mock` 命令
+
+```
+ai-spec mock                    # 读取最新 DSL，生成 mock/server.js
+ai-spec mock --port 3002        # 指定端口（默认 3001）
+ai-spec mock --proxy            # 同时生成 Proxy 配置片段
+ai-spec mock --msw              # 同时生成 MSW handlers
+ai-spec mock --dsl <path>       # 指定 DSL 文件
+ai-spec mock --workspace        # 工作区所有后端 repo 批量生成
+```
+
+---
+
+### Feature 2：多语言后端支持
+
+**修改：** `core/workspace-loader.ts`
+
+`RepoType` 新增：`"go"` | `"python"` | `"java"` | `"rust"`
+
+`detectRepoType()` 在 `package.json` 检测前优先检查非 Node.js 语言：
+
+| 语言 | 识别依据 |
+|---|---|
+| Go | `go.mod` |
+| Rust | `Cargo.toml` |
+| Java | `pom.xml` / `build.gradle` / `build.gradle.kts` |
+| Python | `requirements.txt` / `pyproject.toml` / `setup.py` |
+
+`autoDetect()` 扩展扫描条件：不再只检查 `package.json`，同时检查以上所有 manifest 文件。
+
+**修改：** `core/error-feedback.ts`
+
+`detectTestCommand()` 和 `detectLintCommand()` 按语言自动选择：
+
+| 语言 | 测试命令 | Lint 命令 |
+|---|---|---|
+| Go | `go test ./...` | `go vet ./...` |
+| Rust | `cargo test` | `cargo clippy -- -D warnings` |
+| Java (Maven) | `mvn test -q` | — |
+| Java (Gradle) | `./gradlew test` | — |
+| Python | `pytest` | `ruff check . \|\| flake8 .` |
+| Node.js | `npm test` / `npx vitest run` | `npm run lint` / `npx eslint .` |
+
+`parseErrors()` 文件路径提取正则扩展支持 `.go` `.py` `.java` `.rs` 后缀。
+
+**修改：** `cli/index.ts` — workspace init 交互
+
+Repo 类型选择器新增 `go` / `python` / `java` / `rust` 选项。
+
+---
+
+## [0.9.0] 2026-03-23 — 三项精准 Fix：前端 DSL 提取 / 分解上下文 / Codegen 注入
+
+### 目标
+
+修复上一版自我评估中指出的三个薄弱点，使「一句话 → 前后端全链路」真正可靠运行而不依赖 AI 猜测。
+
+---
+
+### Fix 1：前端 DSL 提取 — ComponentSpec 提取不再依赖推断
+
+**修改：** `prompts/dsl.prompt.ts`
+
+新增 `dslFrontendSystemPrompt`：
+- 专为前端规格设计的提取规则，输出格式含 `components[]` 数组
+- `models[]` 在前端 feature 中强制为 `[]`，由 `components[]` 替代
+- `ComponentSpec` 结构：id / name / description / props（name/type/required）/ events（name/payload）/ state（Record<string,string>）/ apiCalls（调用的端点列表）
+- `buildDslExtractionPrompt()` 新增 `isFrontend` 参数，前端场景追加提示语
+
+**修改：** `core/dsl-extractor.ts`
+
+- `extract()` 新增 `opts.isFrontend?: boolean` 参数
+- 前端项目自动使用 `dslFrontendSystemPrompt` 和前端提取 prompt
+- `buildDslContextSection()` 扩展：若 DSL 含 `components[]`，追加 `-- UI Components --` 区块注入到 codegen prompt
+- 自动检测依赖（react/vue/next/react-native/expo）→ 设置 `isFrontend`
+
+**修改：** `core/dsl-validator.ts`
+
+- 新增 `validateComponent()` 函数：校验 `ComponentSpec` 的 id/name/description/props/events/state/apiCalls 字段
+- `validateDsl()` 增加 `components[]` 可选字段校验（bounded loop，max 50）
+- `printDslSummary()` 扩展：显示 `Components: N` 及每个组件的 id、name、props/events 数量
+
+**修改：** `cli/index.ts` — 两处 `extract()` 调用
+
+- 单 repo 模式：从 `context.dependencies` 检测前端项目，传入 `isFrontend`
+- 多 repo 模式（`runSingleRepoPipelineInWorkspace`）：同样检测并传入 `isFrontend`
+
+---
+
+### Fix 2：需求分解上下文注入 — UX 决策基于真实代码而非猜测
+
+**修改：** `prompts/decompose.prompt.ts`
+
+`buildDecomposePrompt()` 新增 `frontendContexts?: Map<string, FrontendContext>` 参数：
+
+对每个前端/移动端 repo，在 prompt 中注入：
+- `Framework / Test / HTTP client` 基础信息
+- 现有 hook 文件列表（告诉 AI "reference these in specIdea"）
+- 现有 API wrapper 列表（附注"MUST extend, NOT recreate"）
+- 现有 store 文件列表（附注"add state here, don't create new stores"）
+- API wrapper 前 10 行代码片段（让 AI 知道现有调用模式）
+
+**修改：** `core/requirement-decomposer.ts`
+
+- `decompose()` 新增 `frontendContexts?: Map<string, FrontendContext>` 参数，透传到 `buildDecomposePrompt()`
+
+**修改：** `cli/index.ts` — `runMultiRepoPipeline()`
+
+- W1 阶段：对 frontend/mobile repo 同步调用 `loadFrontendContext()`，构建 `frontendContexts` Map
+- W1 输出展示：`framework / httpClient | hooks:N stores:N`
+- W2 阶段：将 `frontendContexts` 传入 `decomposer.decompose()`
+
+---
+
+### Fix 3：前端 Codegen 上下文注入 — AI 不再凭空创建 hook/service
+
+**修改：** `core/code-generator.ts`
+
+`runApiMode()` 新增前端感知逻辑：
+1. 检测 `context.dependencies` 中是否含前端框架（react/vue/next/react-native/expo）
+2. 如果是前端项目 → 调用 `loadFrontendContext(workingDir)`
+3. `buildFrontendContextSection()` 输出注入 prompt（展示现有 hook/store/API wrapper 文件和代码）
+4. `frontendSection` 拼入：
+   - 有 tasks 时：`constitutionSection + dslSection + frontendSection`（传入 `runApiModeWithTasks`）
+   - 无 tasks 时：`plan prompt` 和 `generateFiles` 调用均包含 `frontendSection`
+5. Plan prompt 新增明确指令：`Extend existing hooks/services/stores — do NOT create new parallel utilities`
+
+---
+
+## [0.8.0] 2026-03-23 — 前端支持增强 + 跨项目共享宪法
+
+### 目标
+
+两项中优先级优化同步落地：让 ai-spec 真正理解前端项目的结构（而不只是检测框架名称），并将「项目宪法」从单项目升级为「全局 + 项目」双层架构，使团队规范可以跨 repo 共享。
+
+---
+
+### #14 前端支持增强 (6.4)
+
+**修改：** `core/dsl-types.ts`
+
+新增 `ComponentSpec` 类型：
+- `ComponentProp`：name / type / required / description
+- `ComponentEvent`：name / payload（回调事件）
+- `ComponentSpec`：id / name / description / props / events / state / apiCalls
+- `SpecDSL.components?: ComponentSpec[]`（前端 DSL 的可选组件规格列表）
+
+**修改：** `core/frontend-context-loader.ts`
+
+`FrontendContext` 新增字段：
+- `testFramework`：自动检测 `rtl` / `cypress` / `vitest` / `jest` / `unknown`
+- `apiWrapperContent`：前 2 个 API 封装文件的前 60 行内容（阻止 AI 重复创建请求工具）
+- `hookFiles`：`use*.ts/tsx` hook 文件列表（15 个以内）
+- `hookPatterns`：前 2 个 hook 文件的前 30 行内容（提供命名和结构参考）
+- `storeFiles`：Zustand store / Redux slice 等状态文件列表
+
+`buildFrontendContextSection()` 更新：
+- 展示 API wrapper 代码（附注"extend these, do NOT create new request utilities"）
+- 展示 hook 列表和结构示例
+- 展示 store 文件列表
+
+**修改：** `core/test-generator.ts`
+
+前后端感知测试生成：
+- `isFrontendProject()` — 通过 package.json 检测前端项目（react / vue / next / react-native）
+- `generate()` 自动分叉：前端走 RTL/Cypress 模板，后端走原有 Jest/Vitest 模板
+- 前端模式：把 `ComponentSpec` / hook 文件 / API wrapper 结构注入 prompt
+- 在 console 输出显示 `Mode: frontend (react / rtl)` 等信息
+
+**修改：** `prompts/testgen.prompt.ts`
+
+新增 `testGenFrontendSystemPrompt`：
+- 专为 React Testing Library 编写的规则集
+- 覆盖：渲染测试 / props 测试 / 交互事件 / 加载状态 / 乐观更新回滚 / 节流防抖（`jest.useFakeTimers()`）
+
+---
+
+### #15 跨项目共享宪法 (6.3)
+
+**新文件：** `core/global-constitution.ts`
+
+- `GLOBAL_CONSTITUTION_FILE = ".ai-spec-global-constitution.md"`
+- `loadGlobalConstitution(extraRoots)` — 按优先级搜索：传入目录 → 用户 home
+- `mergeConstitutions(global, project)` — 双层注入：全局宪法 + 项目宪法（项目优先）
+- `saveGlobalConstitution(content, targetDir)` — 保存到指定目录（默认 home）
+
+**新文件：** `prompts/global-constitution.prompt.ts`
+
+- `globalConstitutionSystemPrompt`：5 个章节（团队 API 规范 / 命名规范 / 禁区 / 跨端契约规范 / 日志规范）
+- `buildGlobalConstitutionPrompt(summaries)` — 构建跨 repo 分析 prompt
+
+**修改：** `core/context-loader.ts`
+
+`loadConstitution()` 升级为双层宪法加载：
+1. 加载项目宪法（`.ai-spec-constitution.md`）
+2. 搜索全局宪法（项目父目录 → home dir）
+3. 如果全局宪法存在 → `mergeConstitutions()` 合并注入
+4. 如果只有项目宪法 → 直接使用（完全向后兼容）
+
+**修改：** `cli/index.ts`
+
+`ai-spec init` 新增 `--global` 选项：
+- 生成全局宪法而非项目宪法（写入当前目录的 `.ai-spec-global-constitution.md`）
+- 使用 `globalConstitutionSystemPrompt` 生成团队级规范
+- 支持 `--force` 覆盖已有全局宪法
+
+`ai-spec init`（项目模式）新增：
+- 检测全局宪法后显示提示：`ℹ Global constitution detected: <path>`，提示用户项目规则优先
+
+---
+
+## [0.7.0] 2026-03-23 — Phase 4: 多 Repo 工作区编排
+
+### 目标
+
+将 ai-spec 从「单项目工具」升级为「多 Repo 需求编排器」。输入一句需求，系统自动分析它对各端（后端/前端/移动端）意味着什么，按依赖顺序依次为每个 Repo 运行完整流水线，并通过契约桥接确保后端接口定义直接成为前端开发的输入上下文，消灭前后端对接歧义。
+
+---
+
+### #13 Workspace 层
+
+**新文件：** `core/workspace-loader.ts`
+
+- `RepoConfig`：name / path / type / role / constitution（运行时加载）
+- `WorkspaceConfig`：name + repos 数组
+- `detectRepoType(absPath)`：从 package.json 依赖自动检测 repo 类型和角色
+  - react-native/expo → mobile
+  - next → frontend
+  - react → frontend
+  - vue → frontend
+  - koa → backend
+  - express/prisma/mongoose → backend
+- `WorkspaceLoader.load()`：加载 `.ai-spec-workspace.json`，不存在时返回 null（优雅降级）
+- `WorkspaceLoader.autoDetect()`：扫描当前目录的子目录，自动发现包含 package.json 的 repo
+- `WorkspaceLoader.resolveRepoPaths()`：解析相对路径 + 自动加载各 repo 的宪法文件
+- `WorkspaceLoader.save()`：保存时自动去掉运行时字段（constitution）
+- `WorkspaceLoader.getProcessingOrder()`：按 backend → shared → frontend → mobile 排序
+
+---
+
+### #14 需求分解器
+
+**新文件：** `core/requirement-decomposer.ts` + `prompts/decompose.prompt.ts`
+
+**核心类型：**
+
+```typescript
+UxDecision {
+  throttleMs?: number       // e.g. 300 — 按钮点击类操作
+  debounceMs?: number       // e.g. 500 — 搜索输入类操作
+  optimisticUpdate: boolean // 先更新 UI，再等服务器确认
+  reloadOnSuccess?: string[]// 成功后需要重新拉取哪些接口（通常为空）
+  errorRollback: boolean    // 乐观更新失败时回滚
+  loadingState: boolean     // 是否显示 loading
+  notes?: string            // 额外协作说明
+}
+
+RepoRequirement {
+  repoName, role, specIdea
+  isContractProvider        // 该 repo 的 DSL 成为其他 repo 的契约
+  dependsOnRepos            // 依赖哪些 repo 先完成
+  uxDecisions               // 仅前端/移动端有
+}
+
+DecompositionResult {
+  originalRequirement, summary
+  repos: RepoRequirement[]
+  coordinationNotes         // 跨 repo 协调说明
+}
+```
+
+**Prompt 设计（`decompose.prompt.ts`）：**
+- 包含 throttle vs debounce 判断指南（高频点击用 throttle，输入搜索用 debounce）
+- 包含乐观更新模式说明（点赞/收藏等用 optimistic，支付等用等待确认）
+- 要求输出精确的接口路径、方法、返回字段，不允许模糊描述
+- 输出标准 JSON，包含完整示例
+
+**鲁棒性：**
+- 分解失败时降级：自动为所有 repo 生成基础 requirement，后端 isContractProvider=true，前端依赖后端
+- `sortByDependency()`：拓扑排序，循环依赖时给出警告但不崩溃
+
+---
+
+### #15 跨 Repo 契约桥接
+
+**新文件：** `core/contract-bridge.ts`
+
+**核心功能：**
+- `buildFrontendApiContract(dsl)`：将后端 SpecDSL 转换为前端可消费的 API 契约
+  - 生成 TypeScript interface 定义（Request / Response 类型）
+  - `inferTsType()`：从 DSL 字段描述启发式推断 TS 类型（boolean/number/string/datetime）
+  - `buildResponseInterface()`：优先从模型字段推断响应类型，降级到从 successDescription 关键词推断
+- `buildContractContextSection(contract)`：生成注入 prompt 的文本块，明确标注「不得更改路径/方法/类型」
+
+**前端 Spec Prompt：** `prompts/frontend-spec.prompt.ts`
+- 包含 UX 工程模式参考（throttle/debounce/optimistic update/state sync 最佳实践）
+- `buildFrontendSpecPrompt(opts)`：将 API 契约 + UX 决策 + 前端上下文组合成完整 prompt
+
+---
+
+### #16 前端项目上下文加载
+
+**新文件：** `core/frontend-context-loader.ts`
+
+- 检测框架（react / next / vue / react-native）
+- 检测状态管理（zustand / redux / jotai / pinia 等）
+- 检测 HTTP 客户端（axios / react-query / swr / fetch）
+- 检测 UI 库（tailwind / antd / shadcn / MUI 等）
+- 检测路由模式（react-router / next-app-router / vue-router）
+- 扫描现有 api/ / services/ 目录
+- 扫描 component 模式样本
+
+---
+
+### Pipeline 集成
+
+**`cli/index.ts` 变更：**
+
+**新增：`workspace` 命令**
+
+```
+ai-spec workspace init    # 交互式设置 .ai-spec-workspace.json
+ai-spec workspace status  # 显示当前 workspace 配置和路径解析状态
+```
+
+`workspace init` 流程：
+1. 询问 workspace 名称
+2. 循环添加 repo（name + 相对路径），自动检测 type/role
+3. 保存 `.ai-spec-workspace.json`
+
+**修改：`create` 命令增加 workspace 模式检测**
+
+- 启动时检测 `.ai-spec-workspace.json` 是否存在
+- 存在时进入多 Repo 流水线（`runMultiRepoPipeline`）
+- 不存在时静默 fallback 到原单 Repo 流水线
+
+**`runMultiRepoPipeline()` 流程：**
+
+```
+[W1] 加载所有 repo 的 ProjectContext
+[W2] AI 分解需求 → DecompositionResult（含 UxDecision）
+[W3] 展示分解预览 + 用户确认（--auto 跳过）
+[W4] 按依赖顺序逐 repo 运行完整流水线
+     后端完成后 → buildFrontendApiContract(dsl)
+              → buildContractContextSection(contract)
+              → 注入到下一个 frontend repo 的 spec idea 中
+[W5] 最终汇总（所有 repo 的 spec / DSL / worktree 路径）
+```
+
+**`runSingleRepoPipelineInWorkspace()` 关键特性：**
+- 接受 `contractContextSection` 参数，注入 spec idea 前端
+- 每个 repo 独立容错，失败不中断其他 repo
+- 自动为每个 repo 生成宪法（如不存在）
+
+---
+
+### 命令新增
+
+```
+ai-spec workspace init    # 初始化 workspace
+ai-spec workspace status  # 查看 workspace 状态
+ai-spec create "..."      # 自动检测 workspace 模式
+```
+
+---
+
+### 文档
+
+- `RELEASE_LOG.md`：本条目
+
+---
+
+## [0.6.0] 2026-03-23 — Phase 3: 测试生成 · 错误反馈 · 经验积累
+
+### 目标
+
+在代码生成后引入"自动质检"闭环：生成测试骨架 → 运行测试/lint → AI 自动修复 → 代码审查 → 将审查教训写回项目宪法，使宪法随每次迭代持续进化。
+
+---
+
+### #10 测试骨架生成
+
+**新文件：** `core/test-generator.ts` + `prompts/testgen.prompt.ts`
+
+**触发条件：** 代码生成完成且 DSL 提取成功时自动运行（可用 `--skip-tests` 跳过）
+
+**生成逻辑：**
+
+- `buildTestGenPrompt(dsl, testDir)` — 从 DSL 提取测试要点：
+  - 每个端点 → 成功路径 / 参数校验 / 鉴权测试（`auth: true` 时）
+  - 每个模型 → 创建测试 / 唯一约束测试（有 `unique` 字段时）
+  - 每个业务行为 → 边界用例
+- `detectTestDir()` — 自动检测 `tests/` · `test/` · `__tests__/` · `spec/`，默认 `tests/`
+- AI 返回 `[{ file: "path", content: "source" }]` JSON 数组，逐文件写入
+
+**Prompt 约束（`testgen.prompt.ts`）：**
+
+- 使用项目已有测试框架（Jest/Vitest 自动检测）
+- `describe/it` 骨架结构，不实现断言（placeholder 注释标 TODO）
+- 每个端点至少：成功路径、参数校验、鉴权（if auth=true）
+- 每个模型至少：创建、唯一约束（if unique 字段存在）
+- 最多 2 层 describe 嵌套
+
+**步骤标记：** `[7/9]`（位于代码生成后、错误反馈前）
+
+---
+
+### #11 错误反馈自动修复循环
+
+**新文件：** `core/error-feedback.ts`
+
+**触发条件：** 代码生成/测试生成后自动运行（可用 `--skip-error-feedback` 跳过）
+
+**检测：**
+
+- `detectTestCommand()` — 检查 `package.json scripts.test`、vitest/jest config 文件
+- `detectLintCommand()` — 检查 `package.json scripts.lint`、`.eslintrc*` / `eslint.config.js`
+- 两者都未检测到时跳过整个 feedback 步骤
+
+**修复流程（最多 2 次 cycle）：**
+
+```
+cycle 1: runCommand(testCmd) → parseErrors() → attemptFix()
+cycle 2: runCommand(testCmd) → 验证修复结果
+```
+
+- `parseErrors()` — 取输出最后 80 行，过滤 node_modules / npm timing / stack trace 噪音
+- `attemptFix()` — 按文件分组错误，逐文件提交 AI，prompt 携带 DSL 上下文 + 当前文件内容
+- 每次 fix 后重写文件，cycle 通过则提前结束
+- 2 次后仍有错误 → 黄色警告，不中断流水线
+
+**选项：** `ErrorFeedbackOptions { maxCycles, skipTests, skipLint }`
+
+**步骤标记：** `[8/9]`（位于测试生成后、代码审查前）
+
+---
+
+### #12 知识记忆 / 经验积累
+
+**新文件：** `core/knowledge-memory.ts`
+
+**触发条件：** 代码审查完成后自动运行（`--skip-review` 时跳过）
+
+**提取流程：**
+
+1. `extractIssuesFromReview(reviewText)` — 解析审查报告中的 `## ⚠️ 问题` 章节，提取最多 10 条 issue
+2. `categorizeIssue(text)` — 根据关键词自动分类：security 🔒 / performance ⚡ / bug 🐛 / pattern 📐 / general 📝
+3. `appendLessonsToConstitution(projectRoot, issues)` — 追加到宪法 `§9 积累教训`：
+   - Section 不存在时自动创建 `## 9. 积累教训 (Accumulated Lessons)`
+   - 存在时追加到 Section 内容末尾（自动找到下一个 `## \d` 前的位置）
+   - **去重**：issue 描述前 50 字符与宪法现有内容匹配时跳过
+
+**宪法 §9 格式：**
+
+```markdown
+## 9. 积累教训 (Accumulated Lessons)
+- 🔒 **[2026-03-23]** 登录接口缺少 rate limiting
+- 🐛 **[2026-03-23]** 异步错误未被全局 error handler 捕获
+```
+
+**效果：** 每次 `ai-spec create` 运行时宪法（含 §9）会注入所有 Spec/代码生成 prompt，积累的教训在后续迭代中自动生效。
+
+---
+
+### Pipeline 集成
+
+**`cli/index.ts` 变更：**
+
+- 新增 `--skip-tests` 选项
+- 新增 `--skip-error-feedback` 选项
+- 新增 `[7/9]` 测试生成步骤（代码生成后）
+- 新增 `[8/9]` 错误反馈步骤
+- 原 `[7/7]` 代码审查 → 改为 `[9/9]`
+- 审查完成后捕获返回值，传入 `accumulateReviewKnowledge()`
+- Done 摘要新增测试骨架文件数
+- 版本号升至 `0.6.0`
+
+---
+
+### 其他变更
+
+- **移除小米 MiMo provider**：从 `PROVIDER_CATALOG` 和 README 中移除 `mimo` / `MIMO_API_KEY` / `mimo-v2-pro`。MiMo V2 Pro 模型目前暂不支持。
+
+---
+
+### 文档
+
+- `README.md`：
+  - 流水线概览图加入 Phase 3 全部步骤
+  - 快速开始示例输出更新（含 Phase 3 步骤日志）
+  - 支持模型表移除 MiMo
+  - `create` 选项表新增 `--skip-tests`、`--skip-error-feedback`
+  - 新增 "Step 7 — 测试骨架生成"、"Step 8 — 错误反馈自动修复"、"Step 9 — 代码审查 + 经验积累" 章节
+  - 项目结构更新（新增 3 个 Phase 3 文件）
+  - 命令总览更新，新增所有命令与选项速查表
+- `RELEASE_LOG.md`：本条目
+
+---
+
+## [0.5.0] 2026-03-23 — Phase 2: DSL 转换 · Schema · 校验
+
+### 目标
+
+在 Approval Gate 之后、代码生成之前，引入结构化 JSON DSL 作为 Spec → Code 的中间层。DSL 提供确定性的端点签名和数据模型定义，减少 codegen 阶段的 AI 猜测。
+
+---
+
+### #5 DSL Schema / 类型系统
+
+**新文件：** `core/dsl-types.ts`
+
+定义 `SpecDSL` 及其所有子类型，**设计约束**：
+- 所有类型完全扁平，无递归类型定义
+- 无泛型 / 条件类型 / 映射类型，保持 TS 编译简单
+- `request/response` schema 用 `Record<string, string>`（字段名 → 类型描述字符串），避免深层嵌套引发幻觉
+
+**类型结构：**
+```
+SpecDSL
+├── version: "1.0"
+├── feature: FeatureMeta { id, title, description }
+├── models: DataModel[]
+│   └── DataModel { name, description?, fields: ModelField[], relations?: string[] }
+│       └── ModelField { name, type, required, unique?, description? }
+├── endpoints: ApiEndpoint[]
+│   └── ApiEndpoint { id, method, path, description, auth, request?, successStatus, successDescription, errors? }
+│       ├── RequestSchema { body?, query?, params? }  — values are FieldMap (Record<string,string>)
+│       └── ResponseError { status, code, description }
+└── behaviors: BusinessBehavior[]
+    └── BusinessBehavior { id, description, trigger?, constraints?: string[] }
+```
+
+---
+
+### #6 DSL 校验器
+
+**新文件：** `core/dsl-validator.ts`
+
+**安全设计原则：**
+- 所有循环以有限数组长度为边界，无递归调用
+- 硬性上界防护：models ≤ 50，fields/model ≤ 100，endpoints ≤ 100，behaviors ≤ 50，errors/endpoint ≤ 20
+- 单次遍历收集所有错误（不在第一个错误时抛出），给出完整报告
+- 精确字段路径：如 `endpoints[1].request.body.userId`
+- 无外部依赖（不使用 zod / ajv 等）
+
+**校验规则（关键）：**
+- `method` 枚举校验：只允许 `GET|POST|PUT|PATCH|DELETE`
+- `path` 必须以 `/` 开头
+- `auth` 必须是 boolean（不接受字符串 `"true"`）
+- `successStatus` 必须是 100-599 的整数
+- `FieldMap` 的值必须是字符串（防止嵌套对象幻觉）
+- `relations` 必须是字符串数组（plain text，不接受对象）
+
+**辅助函数：**
+- `printValidationErrors(errors)` — 彩色错误列表输出
+- `printDslSummary(dsl)` — 简洁统计 + endpoint 列表
+
+---
+
+### #4 DSL 提取器 + Prompt
+
+**新文件：** `prompts/dsl.prompt.ts` + `core/dsl-extractor.ts`
+
+**Prompt 抗幻觉设计（9 条 CRITICAL RULES）：**
+1. 只提取明确写出的内容，不推断不补全
+2. 无 models → `"models": []`，无 behaviors → `"behaviors": []`
+3. 输出纯 JSON，无 markdown fence，无任何前置/后置文字
+4. 缺失字段用空字符串 `""`，不能省略字段
+5. path 必须以 `/` 开头，method 枚举严格
+6. FieldMap 值必须是类型描述字符串，不能是嵌套对象
+7. 提供完整 JSON schema 模板供模型对照
+8. 提供具体 few-shot 示例（带注释说明）
+9. retry prompt 携带具体错误路径，定向修复
+
+**提取流程（最多 2 次 retry）：**
+```
+attempt 1: buildDslExtractionPrompt(spec) → AI → parseJSON → validateDsl
+           成功 → 返回 SpecDSL
+           失败 → 展示错误
+attempt 2: buildDslRetryPrompt(spec, prevOutput, errors) → AI → parseJSON → validateDsl
+           成功 → 返回 SpecDSL
+           失败 → handleFailure()
+```
+
+**JSON 解析容错（`parseJsonFromOutput`）：**
+- 直接以 `{` 开头 → 直接 `JSON.parse`
+- 有 ` ``` ` fence → 提取 fence 内容再 parse
+- 都不是 → 找第一个 `{` 到最后一个 `}` 再 parse
+- 全部失败 → 抛出 `SyntaxError`，触发 retry
+
+**故障处理：**
+- `--auto` 模式：失败时静默跳过，不中断流水线
+- 交互模式：展示选项 `⏭ Skip / ❌ Abort`
+
+**`buildDslContextSection(dsl)`：**
+
+将 SpecDSL 转换为紧凑的纯文本摘要（而非 JSON），注入 codegen prompt：
+- 控制输出大小，避免 token 浪费
+- 提取最有价值的信息：端点签名（method + path + auth + status）、模型字段、业务规则
+
+**`loadDslForSpec(specFilePath)`：**
+
+从 spec 文件路径自动推断 DSL 路径（`.dsl.json` 后缀），加载并重新校验，失败返回 `null`（不抛出）。
+
+---
+
+### Pipeline 集成
+
+**`cli/index.ts` 变更：**
+- 新增 `--skip-dsl` 选项
+- 新增 `[DSL]` 步骤（位于 Approval Gate 后、Worktree 前）
+- Step 5 保存 DSL 文件（`feature-<slug>-v<N>.dsl.json`）
+- `generateCode()` 传入 `dslFilePath`
+- Done 摘要新增 DSL 文件路径
+
+**`core/code-generator.ts` 变更：**
+- `CodeGenOptions` 新增 `dslFilePath?: string`
+- `runApiMode()` 自动加载 DSL，调用 `buildDslContextSection()` 生成摘要
+- DSL section 注入：plan prompt（文件规划）和 task codegen prompt（文件生成）都会收到 DSL 上下文
+- 有 DSL 时打印 `✓ DSL loaded — N endpoints, M models`
+
+**输出文件新增：**
+```
+specs/feature-<slug>-v1.dsl.json   ← 与 spec 和 tasks 文件并排
+```
+
+---
+
+### 文档
+
+- `README.md`：
+  - 流水线概览图加入 DSL 步骤
+  - 快速开始示例输出更新（含 DSL 步骤日志）
+  - `create` 选项表新增 `--skip-dsl`
+  - 新增 "Step DSL" 工作流章节（含结构说明、抗幻觉设计、示例 DSL JSON）
+  - 项目结构更新（新增 3 个 DSL 文件）
+- `RELEASE_LOG.md`：本条目
+
+---
+
+> 记录每次迭代的功能变更、架构调整和修复。
+> 格式：`[版本] 日期 — 变更摘要`
+
+---
+
+## [0.4.0] 2026-03-23 — Phase 1: 工业化流水线基础设施
+
+### 目标
+
+为 ai-spec 补充"可工业化 AI 开发流水线"的三个基础模块：
+Spec 版本管理、人工审批门禁、增量构建续跑。
+
+---
+
+### #3 Spec Versioning & Diff
+
+**新文件：** `core/spec-versioning.ts`
+
+- `slugify(idea)` — 自然语言需求转安全文件名 slug
+  - 示例：`"用户登录 with OAuth2"` → `"--with-oauth2"`（CJK 字符过滤后取 ascii 部分）
+- `findLatestVersion(specsDir, slug)` — 扫描 `specs/` 目录，返回最新版本的路径、版本号和内容
+- `nextVersionPath(specsDir, slug)` — 自动递增版本号，返回下一个文件路径
+  - 输出：`feature-<slug>-v1.md`、`feature-<slug>-v2.md` …
+- `computeDiff(oldText, newText)` — 基于 LCS 算法的行级 diff，无外部依赖
+  - 大文件（> 800 行）自动降级为 O(n) 简化 diff，避免内存溢出
+- `printDiff(diff)` — 彩色 unified-style diff 输出（`+` 绿 / `-` 红 / 上下文灰）
+- `printDiffSummary(diff, label)` — 单行摘要：`+12  -3  lines`
+
+**变更：**
+
+- `cli/index.ts`：Spec 文件名从 `feature-{timestamp}.md` 改为 `feature-{slug}-v{N}.md`
+- `core/spec-refiner.ts`：AI Polish 完成后自动展示变更 diff，让用户在打开编辑器前预览改动
+
+---
+
+### #7 Approval Gate（人工确认检查点）
+
+**变更：** `cli/index.ts` 新增 `[3.5/6]` 步骤
+
+在 Spec 润色完成（Step 3）与 Git Worktree 创建（Step 4）之间插入正式的人工审批门禁：
+
+**展示信息：**
+- Spec 行数 / 词数
+- 已生成的 task 数量
+- 若存在历史版本，自动对比并展示彩色 diff（版本 v1 → v2 的变化）
+
+**三选一操作：**
+- `✅ Proceed` — 确认，继续代码生成
+- `📋 View full spec` — 在终端完整展示 Spec 内容，再次询问是否继续
+- `❌ Abort` — 中止，Spec **不写入磁盘**
+
+**跳过条件：** `--auto` 模式自动选 Proceed，跳过此步骤（适合 CI/全自动流水线）
+
+---
+
+### #9 Incremental Build + `--resume`
+
+**变更：** `core/code-generator.ts`、`cli/index.ts`
+
+#### CLI 新增选项
+
+```
+--resume    续跑模式：跳过 tasks.json 中已标记为 done 的 task
+```
+
+#### claude-code `--auto` 增量执行
+
+之前：`--auto` 模式将所有 tasks 合并成一个 prompt 发送给 `claude -p`
+
+现在：`--auto` + tasks 文件存在时，改为**逐 task 执行** `claude -p`：
+- 每个 task 单独一次 `claude -p` 调用，prompt 包含 task 详情 + spec 路径
+- 每次调用完成后将 task 状态写入 `tasks.json`（`"status": "done"` 或 `"failed"`）
+- 任一 task 失败不中断整体流程（标记 `failed`，跳过继续）
+- 支持 `--resume` 跳过已完成 task
+
+#### api 模式 resume 增强
+
+- `runApiModeWithTasks` 接收 `options.resume`，在日志中明确区分 "resume" 和普通 checkpoint 恢复
+- `--resume` 标志传递链：`cli opts.resume` → `generateCode(options)` → `runApiMode(options)` → `runApiModeWithTasks(options)`
+
+#### 进度条（两种模式通用）
+
+新增 `printTaskProgress(completed, total, task, mode)` 辅助函数：
+
+```
+  [████████░░░░░░░░░░░░]  40% → TASK-002 🔧 Implement FavoriteService
+  [████████░░░░░░░░░░░░]  40% ✓ TASK-001 💾 Add schema — already done
+```
+
+- 进度 = `已完成 task 数 / 总 task 数`
+- 每层对应图标：💾 data / ⚙️ infra / 🔧 service / 🌐 api / 🧪 test
+- `skip` 模式（已完成 task）使用灰色显示
+
+---
+
+### 文档
+
+- `README.md`：
+  - 更新流水线概览图
+  - 新增 `[3.5/6] Approval Gate` 步骤说明和示例
+  - 更新 Step 3 增加 AI diff 预览说明
+  - 更新 Step 5 增加版本化命名、增量构建、进度条说明
+  - `create` 选项表新增 `--resume`
+  - codegen 模式表更新 claude-code 增量执行说明
+  - 项目结构更新（新增 `spec-versioning.ts`、`RELEASE_LOG.md`）
+- `RELEASE_LOG.md`：本文件，新建
+
+---
+
+## [0.3.0] 2026-03-19 — 项目宪法 + 任务分解 + RTK 集成
+
+### 新功能
+
+#### `ai-spec init` 命令
+
+新增独立的 `init` 命令，分析代码库并生成项目宪法（`.ai-spec-constitution.md`）。
+
+宪法包含 8 个章节：架构规则、命名规范、API 规范、数据层规范、错误处理规范、禁区、测试规范、共享配置文件清单。
+
+`ai-spec create` 会在 Step 1 自动检测宪法是否存在，不存在时自动运行 init。
+
+#### Task 分解
+
+Spec 生成后自动分解为结构化 `tasks.json`，包含：
+- `id`、`title`、`layer`（data / infra / service / api / test）
+- `filesToTouch`、`acceptanceCriteria`、`dependencies`、`priority`
+- `status`（运行时写入：pending / done / failed）
+
+任务按层级顺序排列：`data → infra → service → api → test`
+
+Spec + Tasks 通过单次 AI 调用完成（`core/combined-generator.ts`），节省 token。
+
+`api` 模式代码生成检测到 tasks 文件时自动切换 task-by-task 模式，精度更高。
+
+#### RTK 集成
+
+检测 `rtk` binary 是否可用，若可用则在 `claude-code` 模式中自动使用 `rtk claude` 替代 `claude` 执行，减少 claude code 会话中的 token 消耗。
+
+`--auto` 模式下以 `rtk claude -p` 非交互方式执行。
+
+### 变更
+
+- `core/context-loader.ts`：新增宪法文件加载、共享配置文件扫描
+- `core/task-generator.ts`：新建，包含 `SpecTask` 类型、`TaskGenerator`、`updateTaskStatus`
+- `core/combined-generator.ts`：新建，Spec + Tasks 合并 AI 调用
+- `core/constitution-generator.ts`：新建
+- `core/code-generator.ts`：新增 RTK 检测、task-by-task 模式、断点续传
+- `cli/index.ts`：新增 `init`、`--skip-tasks`、`--auto`、`--fast` 选项
+
+---
+
+## [0.2.0] 2026-03-?? — 多 Provider 支持 + 交互式 model 切换
+
+### 新功能
+
+- 支持 9 个 AI Provider：Gemini / Claude / OpenAI / DeepSeek / Qwen / GLM / MiniMax / Doubao / MiMo
+- `ai-spec model` 命令：交互式 provider + model 切换器
+- `ai-spec config` 命令：项目级默认配置管理（`.ai-spec.json`）
+- Provider 自动适配：Qwen3 注入 `enable_thinking: false`；OpenAI o1/o3 使用 `developer` role；MiMo 使用 Anthropic 兼容接口
+
+### 变更
+
+- `core/spec-generator.ts`：重构为 `AIProvider` 接口 + 各 provider 实现
+- `cli/index.ts`：新增 `model`、`config` 命令，`create` 新增 `--codegen-provider`、`--codegen-model` 选项
+
+---
+
+## [0.1.0] 2026-03-?? — 初始版本
+
+### 功能
+
+- `ai-spec create`：调用 Gemini 生成 Spec → 交互式润色 → Git Worktree → Claude Code 生成代码 → AI 代码审查
+- `ai-spec review`：独立代码审查命令
+- 支持 `claude-code` / `api` / `plan` 三种代码生成模式
+- 项目上下文自动扫描（package.json / Prisma schema / 路由文件）