ai-spec-dev 0.28.1 → 0.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-spec-dev",
-  "version": "0.28.1",
+  "version": "0.29.0",
   "description": "AI-driven Development Orchestrator SDK & CLI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/prompts/codegen.prompt.ts

@@ -174,25 +174,7 @@ export function getCodeGenSystemPrompt(repoType?: string): string {
   }
 }
 
-export const reviewSystemPrompt = `You are a Senior Software Architect conducting a thorough code review. Your review should be structured, constructive, and specific.
-
-Always format your review with these exact sections:
-
-## ✅ 优点 (What's Good)
-List specific things done well.
-
-## ⚠️ 问题 (Issues Found)
-List bugs, security issues, or spec deviations with line references.
-
-## 💡 改进建议 (Suggestions)
-Actionable improvements that would elevate code quality.
-
-## 📊 总体评价 (Overall Assessment)
-Score: X/10 — One-paragraph summary.
-
-Be specific. Reference actual code, not vague principles.`;
-
-// ─── Two-pass review prompts ───────────────────────────────────────────────────
+// ─── 3-pass review prompts ────────────────────────────────────────────────────
 
 /**
  * Pass 1 — Architecture review.

package/purpose.md

@@ -2,7 +2,7 @@
 
 > 痛点 · 架构创新 · 边界处理 · DSL 的意义 · 当前局限 · 未来方向
 >
-> 当前版本：v0.28.0 · 最后更新：2026-03-26
+> 当前版本：v0.29.0 · 最后更新：2026-03-27
 
 ***
 
@@ -19,7 +19,7 @@
 7. [当前局限](#7-当前局限)
 8. [未来优化方向](#8-未来优化方向)
 
-> **版本记录速览**：v0.17.0 宪法截断修复 · v0.18.0 `learn` + `minSpecScore` + 行为契约提取 · v0.19.0 错误解析重写 + Auto Gate 修复 · v0.20.0 `mock --serve` 一键联调 · v0.21.0 store 公开 API 提取修复 · v0.22.0 service/api 层分离 · v0.23.0 view/route 双层 + 文件名幻觉修复 · v0.24.0 四项质量修复（export default、impliesRegistration、依赖拓扑排序、lesson 计数）· v0.25.0 HTTP import 正则、分页提取、isToolCrash 三项修复 · v0.26.0 多仓库 review 目录、batch 容错、tasks JSON 健壮性 · **v0.27.0 可靠性三件套**（Provider retry/timeout/分类、文件快照 + `restore`、RunId 结构化日志）· **v0.28.0 3-pass review**（Pass 3 影响面评估 + 代码复杂度评估）
+> **版本记录速览**：v0.17.0 宪法截断修复 · v0.18.0 `learn` + `minSpecScore` + 行为契约提取 · v0.19.0 错误解析重写 + Auto Gate 修复 · v0.20.0 `mock --serve` 一键联调 · v0.21.0 store 公开 API 提取修复 · v0.22.0 service/api 层分离 · v0.23.0 view/route 双层 + 文件名幻觉修复 · v0.24.0 四项质量修复（export default、impliesRegistration、依赖拓扑排序、lesson 计数）· v0.25.0 HTTP import 正则、分页提取、isToolCrash 三项修复 · v0.26.0 多仓库 review 目录、batch 容错、tasks JSON 健壮性 · **v0.27.0 可靠性三件套**（Provider retry/timeout/分类、文件快照 + `restore`、RunId 结构化日志）· **v0.28.0 3-pass review**（Pass 3 影响面评估 + 代码复杂度评估）· **v0.29.0 全量审查修复**（RunLogger 完整插桩、update 快照/日志/knowledge、Score Trend 显示影响/复杂度等级、死代码清理）
 
 ***
 
@@ -327,26 +327,38 @@ ai-spec restore 20260326-143022-a7f2
 
 **③ RunId + 结构化 JSON 日志（`run-logger.ts`）**
 
-每次运行在 `.ai-spec-logs/<runId>.json` 写入结构化日志：
+每次运行在 `.ai-spec-logs/<runId>.json` 写入结构化日志。日志包含：
+
+- **`entries[]`** — 每个主要阶段的 `stageStart`/`stageEnd`/`stageFail` 事件，含各阶段 `durationMs` 和业务数据（v0.29.0 完整插桩）
+- **`filesWritten[]`** — 本次运行写入的所有文件路径
+- **`errors[]`** — 各阶段失败时记录的错误摘要
 
 ```json
 {
   "runId": "20260326-143022-a7f2",
   "startedAt": "2026-03-26T14:30:22.000Z",
-  "finishedAt": "...",
-  "durationMs": 42310,
-  "filesWritten": ["src/api/task.ts", "src/stores/taskStore.ts", ...],
-  "events": [
-    { "event": "spec_gen_start", "ts": "..." },
-    { "event": "codegen_task", "ts": "...", "data": { "task": "api" } },
-    { "event": "review_pass1", "ts": "..." },
-    ...
+  "endedAt": "...",
+  "totalDurationMs": 94310,
+  "filesWritten": ["src/api/task.ts", "src/stores/taskStore.ts"],
+  "entries": [
+    { "event": "context_load",      "ts": "...", "data": { "techStack": ["node"], "repoType": "node-express" } },
+    { "event": "context_load:done", "ts": "...", "data": { "durationMs": 312 } },
+    { "event": "spec_gen",          "ts": "...", "data": { "provider": "gemini", "model": "gemini-2.5-pro" } },
+    { "event": "spec_gen:done",     "ts": "...", "data": { "taskCount": 7, "durationMs": 18420 } },
+    { "event": "dsl_extract",       "ts": "..." },
+    { "event": "dsl_extract:done",  "ts": "...", "data": { "endpoints": 4, "models": 2, "durationMs": 6100 } },
+    { "event": "codegen",           "ts": "...", "data": { "mode": "api" } },
+    { "event": "codegen:done",      "ts": "...", "data": { "filesGenerated": 8, "durationMs": 51200 } },
+    { "event": "review",            "ts": "..." },
+    { "event": "review:done",       "ts": "...", "data": { "durationMs": 14800 } }
   ]
 }
 ```
 
 Run 结束后自动打印摘要（RunId、总耗时、写入文件数、日志路径）。日志供排查问题、统计各阶段耗时、追踪历史运行使用。
 
+**覆盖范围（v0.29.0 扩展）**：`create` 命令 9 个阶段均已插桩；`update --codegen` 同样初始化独立 RunId，写文件前快照、写文件后记录，结束后打印摘要 + restore 提示，与 `create` 行为完全对齐。
+
 ***
 
 ### 2.12 3-pass 代码审查（v0.28.0+）
@@ -440,13 +452,13 @@ DSL 提取本身是高幻觉风险操作。ai-spec 做了几个针对性设计
 
 ## 4. 完整功能矩阵
 
-截至 v0.28.0，ai-spec 的完整能力覆盖：
+截至 v0.29.0，ai-spec 的完整能力覆盖：
 
 | 阶段 | 命令 | 核心能力 |
 |------|------|---------|
 | **初始化** | `ai-spec init` | 扫描项目 → 生成宪法 §1-§8（`--global` 生成全局宪法，`--consolidate` 整合 §9） |
 | **新功能** | `ai-spec create` | 宪法（全文注入）→ context → Spec+Tasks → **Spec 质量评估 + minSpecScore Gate** → Approval Gate → DSL → Worktree → 逐 task codegen（**七层顺序 + 层内拓扑排序 + 行为契约缓存**）→ **TDD（`--tdd`）** → 错误反馈闭环（全文扫描，≤2 轮）→ 测试骨架 → **3-pass review** |
-| **变更迭代** | `ai-spec update` | 最小化更新 Spec → 定向更新 DSL（delta 对比）→ 识别受影响文件 → 可选重新生成 |
+| **变更迭代** | `ai-spec update` | 最小化更新 Spec → 定向更新 DSL（delta 对比）→ 识别受影响文件 → 可选重新生成（**`--codegen` 附带写前快照 + RunId 日志 + knowledge 积累，v0.29.0**） |
 | **接口导出** | `ai-spec export` | DSL → OpenAPI 3.1.0 YAML/JSON，纯 TypeScript 实现，零外部依赖 |
 | **前后端联调** | `ai-spec mock` | DSL → Express Mock Server + Proxy 配置 + MSW Handlers；`--serve` 一键后台启动服务器 + 自动 patch 前端 Proxy（Vite/CRA）；`--restore` 一键还原 |
 | **知识注入** | `ai-spec learn` | 零摩擦向宪法 §9 注入工程教训，不调用 AI，实时去重 |
@@ -454,7 +466,7 @@ DSL 提取本身是高幻觉风险操作。ai-spec 做了几个针对性设计
 | **快照回滚** | `ai-spec restore <runId>` | 按 RunId 回滚本次生成写入的所有文件（v0.27.0+） |
 | **多 Repo 工作区** | workspace 模式 | 一句需求 → AI 拆分职责+UX 决策 → [后端流水线 → DSL 契约] → [前端流水线（注入后端契约）]；`--serve` 完成后自动启动联调环境 |
 
-**单 Repo 流水线总图（v0.28.0）：**
+**单 Repo 流水线总图（v0.29.0）：**
 
 ```
 需求描述