@mycodemap/mycodemap 0.1.0 → 0.1.1

package/docs/archive/PUBLISH_NPM_DESIGN_V2.md

@@ -0,0 +1,390 @@
+# MyCodeMap NPM 发布设计方案
+
+> 版本: 2.0
+> 日期: 2026-03-04
+> 状态: 最终方案（待实施）
+
+---
+
+## 1. 概述
+
+### 1.1 目标
+
+将 CodeMap 工具发布到 NPM，使用户可以通过 `npx @mycodemap/mycodemap` 方式在其他项目中使用，同时建立完善的日志反馈机制便于问题排查。
+
+### 1.2 核心设计原则
+
+1. **开箱即用** - tree-sitter 自带预编译 binary，覆盖主流平台
+2. **友好引导** - 首次使用提供交互式配置向导
+3. **问题可追踪** - 完整的日志系统 + 一键上报机制
+4. **品牌一致** - 所有内容统一使用 `mycodemap`
+5. **日志增强** - 命令导出 + 错误提示
+
+---
+
+## 2. 包配置
+
+### 2.1 命名规范
+
+| 项目 | 命名 |
+|------|------|
+| npm 包名 | `@mycodemap/mycodemap` |
+| CLI 命令 | `mycodemap` |
+| 配置文件 | `mycodemap.config.json` |
+| Schema 文件 | `mycodemap.config.schema.json` |
+| 输出目录 | `.mycodemap` |
+| 日志目录 | `.mycodemap/logs` |
+
+### 2.2 package.json 变更
+
+```json
+{
+  "name": "@mycodemap/mycodemap",
+  "version": "0.1.0",
+  "description": "TypeScript 代码地图工具 - 为 AI 辅助开发提供结构化上下文",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "mycodemap": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md",
+    "mycodemap.config.schema.json",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "benchmark": "bash scripts/run-benchmark.sh",
+    "test:all": "npm run test && npm run benchmark",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "typescript",
+    "mycodemap",
+    "codemap",
+    "code-analysis",
+    "ai",
+    "developer-tools",
+    "static-analysis"
+  ],
+  "author": "<需要填写>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/<your-github-username>/mycodemap.git"
+  },
+  "bugs": {
+    "url": "https://github.com/<your-github-username>/mycodemap/issues"
+  },
+  "homepage": "https://github.com/<your-github-username>/mycodemap#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}
+```
+
+---
+
+## 3. 代码改动清单
+
+### 3.1 环境变量（全部重命名）
+
+| 原名 | 新名 | 文件位置 |
+|------|------|----------|
+| `CODEMAP_RUNTIME_LOG_ENABLED` | `MYCODEMAP_RUNTIME_LOG_ENABLED` | src/cli/runtime-logger.ts |
+| `CODEMAP_RUNTIME_LOG_DIR` | `MYCODEMAP_RUNTIME_LOG_DIR` | src/cli/runtime-logger.ts |
+| `CODEMAP_RUNTIME_LOG_RETENTION_DAYS` | `MYCODEMAP_RUNTIME_LOG_RETENTION_DAYS` | src/cli/runtime-logger.ts |
+| `CODEMAP_RUNTIME_LOG_MAX_FILES` | `MYCODEMAP_RUNTIME_LOG_MAX_FILES` | src/cli/runtime-logger.ts |
+| `CODEMAP_RUNTIME_LOG_MAX_SIZE_MB` | `MYCODEMAP_RUNTIME_LOG_MAX_SIZE_MB` | src/cli/runtime-logger.ts |
+
+### 3.2 日志配置
+
+| 项目 | 原值 | 新值 | 文件位置 |
+|------|------|------|----------|
+| 日志目录 | `.codemap/logs` | `.mycodemap/logs` | src/cli/runtime-logger.ts:10 |
+| 日志前缀 | `codemap-` | `mycodemap-` | src/cli/runtime-logger.ts:14 |
+
+### 3.3 CLI 配置
+
+| 项目 | 原值 | 新值 | 文件位置 |
+|------|------|------|----------|
+| CLI 名称 | `codemap` | `mycodemap` | src/cli/index.ts:25 |
+| 默认输出目录 | `.codemap` | `.mycodemap` | src/cli/index.ts:39,47 |
+
+### 3.4 配置文件
+
+| 项目 | 原值 | 新值 | 文件位置 |
+|------|------|------|----------|
+| 配置文件名 | `codemap.config.json` | `mycodemap.config.json` | src/cli/commands/init.ts:8,37 |
+| Schema URL | `https://codemap.dev/schema.json` | `./mycodemap.config.schema.json` | src/cli/commands/init.ts:21 |
+| 默认输出目录 | `.codemap` | `.mycodemap` | src/cli/commands/init.ts:31 |
+
+### 3.5 输出目录（所有引用）
+
+| 文件 | 改动 |
+|------|------|
+| src/cli/commands/init.ts | 配置文件名、schema URL、输出目录、提示信息全部更新 |
+| src/generator/index.ts | `codemap.json` → `mycodemap.json` |
+| src/orchestrator/workflow/ci-executor.ts | `codemap.json` → `mycodemap.json` |
+| src/cli/commands/generate.ts | `.codemap` → `.mycodemap` |
+| src/cli/commands/watch.ts | `.codemap` → `.mycodemap` |
+| src/cli/commands/watch-foreground.ts | `.codemap` → `.mycodemap` |
+| src/cli/commands/query.ts | `.codemap` → `.mycodemap` |
+| src/cli/commands/deps.ts | `.codemap` → `.mycodemap` |
+| src/cli/commands/cycles.ts | `.codemap` → `.mycodemap` |
+| src/cli/commands/complexity.ts | `.codemap` → `.mycodemap` |
+| src/cli/commands/impact.ts | `.codemap` → `.mycodemap` |
+| src/cli/commands/analyze.ts | `.codemap` → `.mycodemap` |
+| src/cli/commands/init.ts | `.codemap` → `.mycodemap` |
+| src/cache/index.ts | `.codemap` → `.mycodemap` |
+| src/generator/file-describer.ts | `.codemap` → `.mycodemap` |
+| src/orchestrator/adapters/codemap-adapter.ts | `.codemap` → `.mycodemap` |
+| src/orchestrator/workflow/config.ts | `.codemap` → `.mycodemap` |
+| src/orchestrator/workflow/workflow-persistence.ts | `.codemap` → `.mycodemap` |
+| src/orchestrator/workflow/workflow-orchestrator.ts | `.codemap` → `.mycodemap` |
+| src/orchestrator/workflow/templates.ts | `.codemap` → `.mycodemap` |
+| src/orchestrator/workflow/ci-executor.ts | `.codemap` → `.mycodemap` |
+
+---
+
+## 4. 新增文件
+
+### 4.1 mycodemap.config.schema.json
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MyCodeMap Configuration",
+  "description": "Configuration schema for MyCodeMap - TypeScript code analysis tool",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["fast", "smart", "hybrid"],
+      "default": "hybrid",
+      "description": "Analysis mode: fast (regex), smart (AST), or hybrid (auto-select)"
+    },
+    "include": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": ["src/**/*.ts"],
+      "description": "Glob patterns for files to include in analysis"
+    },
+    "exclude": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": ["node_modules/**", "dist/**", "build/**", "*.test.ts", "*.spec.ts"],
+      "description": "Glob patterns for files to exclude from analysis"
+    },
+    "output": {
+      "type": "string",
+      "default": ".mycodemap",
+      "description": "Output directory for generated code maps"
+    },
+    "plugins": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of plugins to enable"
+    },
+    "complexity": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true },
+        "maxComplexity": { "type": "number", "default": 10 }
+      }
+    }
+  }
+}
+```
+
+### 4.2 .npmignore
+
+```
+# 开发/构建产物
+src/
+tests/
+coverage/
+*.ts
+!*.d.ts
+tsconfig*.json
+vitest*.config.*
+*.map
+
+# 项目特有
+.agents
+.claude/
+.git/
+.githooks/
+.github/
+.gitignore
+.vscode/
+.idea/
+
+# 临时文件
+*.log
+*.tmp
+.DS_Store
+
+# 文档（仅保留根目录的 README.md）
+docs/
+*.md
+!README.md
+```
+
+### 4.3 CHANGELOG.md
+
+```markdown
+# Changelog
+
+## [0.1.0] - 2026-03-04
+
+### Added
+- 初始发布
+- 双层解析模式 (fast/smart)
+- 代码地图生成 (AI_MAP.md, mycodemap.json)
+- 依赖图分析
+- 复杂度分析
+- 循环依赖检测
+- 变更影响分析
+- CI 门禁集成
+- 运行日志系统
+```
+
+---
+
+## 5. 脚本和 CI 更新
+
+### 5.1 scripts/hooks/pre-commit
+
+```
+npx mycodemap generate --quiet >/dev/null 2>&1 &
+```
+
+### 5.2 .githooks/pre-commit
+
+```
+npx mycodemap generate --quiet >/dev/null 2>&1 &
+```
+
+### 5.2 .github/workflows/ci-gateway.yml
+
+```yaml
+- run: npx mycodemap ci check-commits --range origin/main..HEAD
+- run: npx mycodemap ci check-headers
+- run: npx mycodemap generate
+- run: npx mycodemap ci assess-risk --threshold=0.7
+- run: npx mycodemap ci check-output-contract --schema-version v1.0.0 --top-k 8 --max-tokens 160
+```
+
+---
+
+## 6. .gitignore 更新
+
+添加以下条目：
+
+```
+.mycodemap
+.mycodemap/
+*.mycodemap.json
+```
+
+---
+
+## 7. 日志功能增强
+
+### 7.1 命令行功能
+
+```bash
+mycodemap logs          # 查看日志列表
+mycodemap logs export  # 导出日志为 zip
+mycodemap logs clear   # 清理日志
+```
+
+### 7.2 错误提示增强
+
+当程序出错时，自动提示：
+
+```
+❌ 出错了！请将以下信息提交到 issue:
+   - 日志文件: .mycodemap/logs/mycodemap-2026-03-04.log
+   - 运行命令: mycodemap generate
+   - 复现步骤: ...
+```
+
+---
+
+## 8. 发布流程
+
+### 8.1 发布前检查清单
+
+```bash
+# 1. 构建项目
+npm run build
+
+# 2. 运行测试
+npm test
+
+# 3. 生成代码地图（自检）
+node dist/cli/index.js generate
+```
+
+### 8.2 发布命令
+
+```bash
+# 登录 npm（首次需要）
+npm login
+
+# 发布
+npm publish --access public
+```
+
+### 8.3 发布后验证
+
+```bash
+# 验证包是否发布成功
+npm view @mycodemap/mycodemap
+
+# 本地测试 npx 方式运行
+npx @mycodemap/mycodemap --version
+```
+
+---
+
+## 9. 改动统计
+
+| 类别 | 数量 |
+|------|------|
+| 环境变量 | 5 |
+| 日志配置 | 2 |
+| CLI 配置 | 2 |
+| 配置文件 | 2 |
+| 输出目录 | ~20 |
+| 脚本更新 | 2 |
+| CI 更新 | 5 |
+| 新增文件 | 3 |
+
+---
+
+## 10. 待填写信息
+
+发布前需要填写以下信息：
+
+- [ ] author: npm 账号名称和邮箱
+- [ ] repository.url: GitHub 仓库地址
+- [ ] bugs.url: GitHub Issues 地址
+- [ ] homepage: 项目主页地址

package/docs/archive/TASK_DESIGN_COVERAGE_REPORT.md

@@ -0,0 +1,314 @@
+# CodeMap 任务与设计文档覆盖检查报告
+
+> 生成时间: 2026-03-01
+> 检查范围: Phase 1-10 vs 8个设计文档
+
+---
+
+## 摘要
+
+| 指标 | 数值 |
+|------|------|
+| 设计文档总数 | 8 |
+| 核心功能覆盖 | 8 (100%) |
+| v2.5 规划覆盖 | 0 (0%) |
+| 总体覆盖率 | ~80-85% |
+
+---
+
+## 详细覆盖情况
+
+### ✅ 完整覆盖的设计文档
+
+| 设计文档 | 对应任务 | 覆盖内容 |
+|----------|----------|----------|
+| **REFACTOR_CONFIDENCE_DESIGN.md** | Phase 2 | 置信度计算函数、三级阈值配置、辅助函数 |
+| **REFACTOR_RESULT_FUSION_DESIGN.md** | Phase 3 | 加权合并、风险加权、去重、排序、Token截断 |
+| **REFACTOR_ORCHESTRATOR_DESIGN.md** (核心) | Phase 4-5 | 工具编排器、适配器、向后兼容、Intent路由 |
+| **REFACTOR_TEST_LINKER_DESIGN.md** | Phase 6 | 测试配置加载、映射构建、关联查找 |
+| **REFACTOR_GIT_ANALYZER_DESIGN.md** | Phase 7-8 | Git历史分析、风险评分、AI饲料生成器 |
+| **CI_GATEWAY_DESIGN.md** | Phase 9 | Commit验证、文件头检查、GitHub Actions |
+| **REFACTOR_ARCHITECTURE_OVERVIEW.md** | Phase 1-10 | 整体架构、CLI命令结构、验收标准 |
+
+### ❌ 未覆盖的设计文档（v2.5 规划）
+
+| 设计文档 | 章节 | 说明 |
+|----------|------|------|
+| **REFACTOR_ORCHESTRATOR_DESIGN.md** | 第8节 | 工作流编排器设计 (WorkflowOrchestrator) |
+| **REFACTOR_RESULT_FUSION_DESIGN.md** | 第8节 | 工作流上下文融合 |
+| **REFACTOR_TEST_LINKER_DESIGN.md** | 第7节 | 工作流阶段测试策略 |
+| **REFACTOR_GIT_ANALYZER_DESIGN.md** | 第10节 | 工作流Git分析器集成 |
+| **CI_GATEWAY_DESIGN.md** | 第11节 | 工作流CI集成 |
+
+---
+
+## Phase 任务与设计文档映射
+
+```
+Phase 1 (unified-result)
+  └── REFACTOR_ARCHITECTURE_OVERVIEW.md (第4.1节)
+  └── REFACTOR_ORCHESTRATOR_DESIGN.md (第2节 类型定义)
+
+Phase 2 (confidence)
+  └── REFACTOR_CONFIDENCE_DESIGN.md (完整)
+  └── REFACTOR_ARCHITECTURE_OVERVIEW.md (第4.1节)
+
+Phase 3 (result-fusion)
+  └── REFACTOR_RESULT_FUSION_DESIGN.md (完整)
+  └── REFACTOR_ARCHITECTURE_OVERVIEW.md (第4.2节)
+
+Phase 4 (tool-orchestrator)
+  └── REFACTOR_ORCHESTRATOR_DESIGN.md (第1-2节)
+  └── REFACTOR_CONFIDENCE_DESIGN.md (第3节)
+  └── REFACTOR_RESULT_FUSION_DESIGN.md (第3节)
+
+Phase 5 (refactor-commands)
+  └── REFACTOR_ORCHESTRATOR_DESIGN.md (第3-5节)
+
+Phase 6 (analyze-command)
+  └── REFACTOR_ORCHESTRATOR_DESIGN.md (第4节)
+  └── REFACTOR_TEST_LINKER_DESIGN.md (完整)
+  └── REFACTOR_ARCHITECTURE_OVERVIEW.md (第4.4节)
+
+Phase 7 (git-analyzer)
+  └── REFACTOR_GIT_ANALYZER_DESIGN.md (第1-3, 6节)
+  └── REFACTOR_ARCHITECTURE_OVERVIEW.md (第4.5节)
+
+Phase 8 (ai-feed-generator)
+  └── REFACTOR_GIT_ANALYZER_DESIGN.md (第4节)
+  └── REFACTOR_ARCHITECTURE_OVERVIEW.md (第4.6节)
+  └── REFACTOR_REQUIREMENTS.md (第8.6节)
+
+Phase 9 (ci-gateway)
+  └── CI_GATEWAY_DESIGN.md (完整)
+  └── REFACTOR_ARCHITECTURE_OVERVIEW.md (第4.7节)
+
+Phase 10 (integration)
+  └── REFACTOR_ARCHITECTURE_OVERVIEW.md (第7-8节)
+```
+
+---
+
+## 未覆盖内容详解 (v2.5 规划)
+
+### 1. 工作流编排器 (WorkflowOrchestrator)
+
+**需要实现的内容**:
+- 阶段状态机管理 (pending → running → completed → verified)
+- 阶段间上下文持久化 (WorkflowContext)
+- 阶段交付物检查点 (PhaseCheckpoint)
+- 交互式工作流引导 (WorkflowCLI)
+
+**关键文件**:
+- `src/orchestrator/workflow/workflow-orchestrator.ts`
+- `src/orchestrator/workflow/workflow-context.ts`
+- `src/orchestrator/workflow/workflow-persistence.ts`
+- `src/cli/commands/workflow.ts`
+
+### 2. 工作流上下文融合
+
+**需要实现的内容**:
+- 跨阶段结果传递
+- 工作流特定加权
+- 阶段间结果继承
+
+### 3. 工作流阶段测试
+
+**需要实现的内容**:
+- 阶段特定的测试策略 (PHASE_TEST_STRATEGY)
+- 测试建议生成
+
+### 4. 工作流 Git 分析器集成
+
+**需要实现的内容**:
+- 阶段 Git 分析配置 (PHASE_GIT_CONFIG)
+- WorkflowGitAnalyzer 类
+
+### 5. 工作流 CI 集成
+
+**需要实现的内容**:
+- 阶段 CI 配置 (PHASE_CI_CONFIG)
+- WorkflowCIExecutor 类
+
+---
+
+## 建议
+
+### 方案 A: 保持现状
+- 优点: Phase 1-10 已完成 v1.0 范围，核心功能完整
+- 缺点: v2.5 规划内容缺失
+
+### 方案 B: 添加 Phase 11
+- 新增 Phase 11 专门实现工作流编排器
+- 需要额外 1-2 天工作量
+
+### 方案 C: 分阶段实施
+- 在 Phase 6-10 中逐步引入工作流概念
+- 但可能影响核心功能的清晰度
+
+---
+
+## 结论
+
+**当前 Phase 1-10 任务足够完成实施所有设计文档的核心功能 (v1.0 范围)，覆盖率约 80-85%。**
+
+v2.5 规划的工作流相关内容属于扩展功能，不在本次重构范围内。如果需要完整实施所有设计文档，建议添加 Phase 11。
+
+---
+
+## 附录 A: 详细 Phase 与设计文档对比矩阵
+
+| 设计文档 | 总行数 | 对应任务 | 覆盖状态 | 备注 |
+|---------|--------|----------|----------|------|
+| REFACTOR_REQUIREMENTS.md | 962 | Phase 1-10 | ⚠️ 部分 | 场景七 E2E 流程依赖工作流编排器 |
+| REFACTOR_ARCHITECTURE_OVERVIEW.md | 544 | Phase 1-10 | ✅ 核心覆盖 | v2.5 规划内容缺失 |
+| REFACTOR_ORCHESTRATOR_DESIGN.md | 1000+ | Phase 4,6 | ⚠️ 部分 | 第8章工作流编排器(~350行)完全缺失 |
+| REFACTOR_CONFIDENCE_DESIGN.md | 244 | Phase 2 | ✅ 基础完整 | 第6节工作流置信度(~50行)缺失 |
+| REFACTOR_RESULT_FUSION_DESIGN.md | 482 | Phase 3 | ⚠️ 基础完整 | 第8节工作流融合(~70行)缺失 |
+| REFACTOR_TEST_LINKER_DESIGN.md | 311 | Phase 6 | ⚠️ 基础完整 | 第7节工作流测试(~50行)缺失 |
+| REFACTOR_GIT_ANALYZER_DESIGN.md | 785 | Phase 7-8 | ⚠️ 基础完整 | 第10节工作流Git集成(~100行)缺失 |
+| CI_GATEWAY_DESIGN.md | 692 | Phase 9 | ⚠️ 基础完整 | 第11节工作流CI集成(~80行)缺失 |
+
+---
+
+## 附录 B: 遗漏功能详细清单
+
+### B1. CLI 命令遗漏
+
+| 命令 | 设计文档位置 | 当前任务状态 | 影响 |
+|------|-------------|-------------|------|
+| `codemap ci check-output-contract` | CI_GATEWAY_DESIGN.md 第4.2节 | ⚠️ Phase 9 未明确提及 | CI 门禁不完整 |
+| `codemap workflow start` | ORCHESTRATOR_DESIGN.md 第8.5节 | ❌ 完全缺失 | 无法启动工作流 |
+| `codemap workflow status` | ORCHESTRATOR_DESIGN.md 第8.5节 | ❌ 完全缺失 | 无法查看状态 |
+| `codemap workflow proceed` | ORCHESTRATOR_DESIGN.md 第8.5节 | ❌ 完全缺失 | 无法推进阶段 |
+| `codemap workflow resume` | ORCHESTRATOR_DESIGN.md 第8.5节 | ❌ 完全缺失 | 无法恢复中断 |
+| `codemap workflow checkpoint` | ORCHESTRATOR_DESIGN.md 第8.5节 | ❌ 完全缺失 | 无法创建检查点 |
+
+### B2. 类型定义遗漏
+
+| 类型/接口 | 设计文档位置 | 用途 | 任务状态 |
+|----------|-------------|------|----------|
+| `WorkflowPhase` | ORCHESTRATOR_DESIGN.md 第8.2节 | 阶段类型定义 | ❌ 缺失 |
+| `WorkflowContext` | ORCHESTRATOR_DESIGN.md 第8.2节 | 工作流上下文 | ❌ 缺失 |
+| `PhaseDefinition` | ORCHESTRATOR_DESIGN.md 第8.2节 | 阶段契约 | ❌ 缺失 |
+| `PhaseArtifacts` | ORCHESTRATOR_DESIGN.md 第8.2节 | 阶段交付物 | ❌ 缺失 |
+| `WorkflowFusionContext` | RESULT_FUSION_DESIGN.md 第8.1节 | 跨阶段融合 | ❌ 缺失 |
+| `PHASE_CI_CONFIG` | CI_GATEWAY_DESIGN.md 第11.1节 | 阶段CI配置 | ❌ 缺失 |
+| `PHASE_GIT_CONFIG` | GIT_ANALYZER_DESIGN.md 第10.1节 | 阶段Git配置 | ❌ 缺失 |
+| `PHASE_TEST_STRATEGY` | TEST_LINKER_DESIGN.md 第7.1节 | 阶段测试策略 | ❌ 缺失 |
+
+### B3. 类实现遗漏
+
+| 类名 | 设计文档位置 | 职责 | 任务状态 |
+|------|-------------|------|----------|
+| `WorkflowOrchestrator` | ORCHESTRATOR_DESIGN.md 第8.3节 | 工作流编排核心 | ❌ 缺失 |
+| `WorkflowPersistence` | ORCHESTRATOR_DESIGN.md 第8.4节 | 上下文持久化 | ❌ 缺失 |
+| `PhaseCheckpoint` | ORCHESTRATOR_DESIGN.md 第8.6节 | 检查点验证 | ❌ 缺失 |
+| `ConfidenceGuide` | ORCHESTRATOR_DESIGN.md 第8.6节 | 置信度引导 | ❌ 缺失 |
+| `WorkflowResultFusion` | RESULT_FUSION_DESIGN.md 第8.1节 | 工作流结果融合 | ❌ 缺失 |
+| `PhaseInheritance` | RESULT_FUSION_DESIGN.md 第8.2节 | 阶段结果继承 | ❌ 缺失 |
+| `WorkflowTestLinker` | TEST_LINKER_DESIGN.md 第7.2节 | 工作流测试建议 | ❌ 缺失 |
+| `WorkflowGitAnalyzer` | GIT_ANALYZER_DESIGN.md 第10.2节 | 工作流Git分析 | ❌ 缺失 |
+| `WorkflowCIExecutor` | CI_GATEWAY_DESIGN.md 第11.2节 | 工作流CI执行 | ❌ 缺失 |
+
+---
+
+## 附录 C: 用户场景覆盖检查
+
+REFACTOR_REQUIREMENTS.md 第8节定义了7个用户场景：
+
+| 场景 | 描述 | 依赖任务 | 可完整实施？ |
+|------|------|----------|-------------|
+| 8.1 影响分析 | 带置信度和回退 | Phase 2,4,5,6 | ✅ 是 |
+| 8.2 置信度触发回退 | 低置信度时回退 | Phase 2,4 | ✅ 是 |
+| 8.3 代码搜索 | 高置信度场景 | Phase 2,4,6 | ✅ 是 |
+| 8.4 文档搜索 | 多工具融合 | Phase 3,6 | ✅ 是 |
+| 8.5 功能实现辅助 | 参考现有实现 | Phase 5,6 | ✅ 是 |
+| 8.6 CI门禁护栏 | 双层次门禁 | Phase 9 | ⚠️ 缺少 output-contract 检查 |
+| 8.7 完整E2E开发流程 | 串联所有功能 | **需要工作流编排器** | ❌ **否** |
+
+**场景七详细检查** (REFACTOR_REQUIREMENTS.md 第8.7节 ~300行): 
+
+| 阶段 | 描述 | 独立任务可覆盖？ | 需工作流编排器？ |
+|------|------|-----------------|-----------------|
+| 一：参考搜索 | 找可参考实现 | ✅ Phase 6 | 否 |
+| 二：影响分析 | 分析影响范围 | ✅ Phase 5/6 | 否 |
+| 三：风险评估 | 风险评分计算 | ✅ Phase 7/8/9 | 否 |
+| 四：代码实现 | 开发者编码 | N/A (手动) | 否 |
+| 五：提交验证 | pre-commit检查 | ✅ Phase 9 | 否 |
+| 六：CI流水线 | GitHub Actions | ✅ Phase 9 | 否 |
+| **阶段间上下文传递** | 结果自动传递 | ❌ **无** | ✅ **是** |
+| **检查点机制** | 交付物验证 | ❌ **无** | ✅ **是** |
+| **交互式引导** | CLI引导 | ❌ **无** | ✅ **是** |
+
+---
+
+## 附录 D: 补充建议（基于详细分析）
+
+### 新增任务建议
+
+如果决定实施 v2.5 规划内容，建议新增：
+
+```
+Phase 11: workflow-orchestrator (工作量：2-3天)
+├── 11.1 工作流核心类型定义
+│   ├── WorkflowPhase, WorkflowContext, PhaseDefinition
+│   └── PhaseArtifacts, PhaseStatus
+├── 11.2 WorkflowOrchestrator 类实现
+│   ├── start(), executeCurrentPhase(), proceedToNextPhase()
+│   └── getStatus(), resume(), checkpoint()
+├── 11.3 WorkflowPersistence 持久化层
+│   ├── save(), load(), loadActive(), list(), delete()
+│   └── Map/Set 序列化处理
+├── 11.4 PhaseCheckpoint 检查点验证
+│   └── validate() 交付物验证
+├── 11.5 workflow CLI 命令
+│   ├── workflow start/status/proceed/resume/checkpoint
+│   └── 交互式引导输出
+├── 11.6 各模块工作流集成配置
+│   ├── PHASE_CI_CONFIG (CI_GATEWAY)
+│   ├── PHASE_GIT_CONFIG (GIT_ANALYZER)
+│   ├── PHASE_TEST_STRATEGY (TEST_LINKER)
+│   └── CONFIDENCE_REQUIREMENTS (CONFIDENCE)
+└── 11.7 集成测试
+    └── 完整 E2E 流程测试
+```
+
+### 当前任务微调建议
+
+对现有 Phase 任务进行轻微调整以修复遗漏：
+
+| 任务 | 建议调整 |
+|------|----------|
+| Phase 9 | 明确添加 `codemap ci check-output-contract` 子命令实现 |
+| Phase 6 | 在测试关联器中预留 `WorkflowTestLinker` 扩展接口 |
+| Phase 4 | 在 `IntentRouter` 中预留 `workflow` 意图处理 |
+
+---
+
+## 修订结论
+
+### 基础功能评估 (v1.0 范围)
+- **Phase 1-10 足够完成**：✅ **是**
+- 覆盖 REFACTOR_ARCHITECTURE_OVERVIEW.md 中标记为 v1.0 的内容
+- 所有核心分析功能可正常工作
+
+### 完整设计评估 (含 v2.5 规划)
+- **Phase 1-10 足够完成**：❌ **否**
+- **覆盖率约 75%**（现有报告 ~80-85% 偏乐观）
+- **关键遗漏：工作流编排器 (~350行设计文档)**
+- 场景七（完整 E2E 流程）无法实施
+
+### 实施建议优先级
+
+| 优先级 | 建议 | 理由 |
+|--------|------|------|
+| P0 | 保持 Phase 1-10 不变 | 核心功能完整，可独立交付 |
+| P1 | 在 Phase 9 添加 check-output-contract | 完善 CI 门禁 |
+| P2 | 添加 Phase 11 工作流编排器 | 完整实现设计文档 |
+
+---
+
+*此报告由 Claude Code 自动生成*
+*补充内容生成时间: 2026-03-01*
+*分析依据: 10个任务文件 vs 8个设计文档逐行对比*