@mycodemap/mycodemap 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -2,16 +2,105 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.5.0] - 2026-04-15 - Design Contract Surface
+
+### 🏗️ v1.4 Milestone: Design-to-Code Mapping & Handoff Package
+
+v1.4 milestone 完成，新增完整的 design contract 公共 CLI 表面，支持人类设计到 AI 执行的标准化 handoff。
+
+#### Phase 17: Design Contract Validation
+- **feature**: 发布 `design validate` 命令，校验 `mycodemap.design.md` 必填 sections
+- **feature**: 返回结构化 diagnostics（missing-section、duplicate-section、empty-section 等）
+
+#### Phase 18: Design-to-Code Mapping
+- **feature**: 发布 `design map` 命令，将 design contract 解析为 candidate code scope
+- **feature**: 支持 `no-candidates`、`over-broad-scope`、`high-risk-scope` 自动阻断
+
+#### Phase 19: Handoff Package & Human Gates
+- **feature**: 发布 `design handoff` 命令，生成 reviewer / AI agent 共用的 handoff artifact
+- **feature**: 输出 `readyForExecution`、`approvals`、`assumptions`、`openQuestions`
+
+#### Phase 20: Design Drift Verification
+- **feature**: 发布 `design verify` 命令，基于 reviewed handoff truth 做 checklist / drift 检查
+- **feature**: `needs-review` 保持零退出码，仅 blocker diagnostics 返回非零 exit code
+
+### 🚀 New Features
+
+- **design**: 新增 design contract 四阶段 CLI 命令（validate / map / handoff / verify）
+- **docs**: 同步 AI_GUIDE.md、README.md 和 docs/ai-guide 中的 design 类型定义与 workflow 命令
+- **ci**: 更新文档一致性校验脚本，覆盖 design contract 测试与 fixture
+
+### 🐛 Bug Fixes
+
+- **storage**: 修复 `kuzu` 可选依赖在 CI typecheck 中的模块缺失错误
+- **publish**: 移除 GitHub Actions 中不稳定的 `npm install -g npm@latest` 步骤
+
 ## [0.4.2] - 2026-03-25 - Test Infrastructure Fix
 
+### 🏗️ v1.3 Milestone: Kùzu-only Convergence & High-Signal Debt Cleanup
+
+v1.3 milestone 完成，核心产品面收敛为 Kùzu-only，清偿多项技术债务。
+
+#### Phase 13: Storage Backend Convergence
+- **refactor**: 移除 neo4j 运行时表面 (`8957fca`)
+- **docs**: 同步 kuzu-only public contract (`d07524e`)
+
+#### Phase 14: CLI Surface & Documentation Alignment
+- **refactor**: 收口 analyze 和 server 过渡差距 (`4a756d7`)
+- **docs**: 移除 workflow 过渡性 public 措辞 (`e5b9560`)
+
+#### Phase 15: Analysis Intent & Workflow Runtime
+- **feature**: 发布 public intent contract 和 outputs (`f4abfa6`)
+- **refactor**: 对齐 workflow 运行时编排核心 (`ddd1c80`)
+- **bugfix**: 扩展 quality 和回归测试覆盖 (`5eb38f7`)
+
+#### Phase 16: Core Debt Cleanup & Final Guardrails
+- **refactor**: 实现 plugin 真实 reload 生命周期 (`3a5fbc6`)
+- **refactor**: 收口 parser index 和 resolution 债务 (`f64432a`)
+- **refactor**: 使 analysis write paths 显式化 (`27458cd`)
+- **docs**: 同步 kuzu-only 和 docs gate contract (`a4c8e12`)
+
+#### Milestone Archive
+- **docs**: 归档 v1.0 CI 和 docs phases (`7d474df`)
+- **docs**: 归档 v1.0 analyze 和 workflow phases (`b3e43e4`)
+- **docs**: 归档 v1.0 kickoff 和 cli cleanup (`bb80e4b`)
+- **docs**: 归档 v1.1 plugin rollout phases (`35cfd60`)
+- **docs**: 归档 v1.1 docs 和 v1.2 activation (`0aed09c`)
+- **docs**: 归档 v1.2 backend validation (`a27bfb0`)
+- **docs**: 完成 v1.3 milestone 关闭 (`ccb7d12`)
+
+### 🚀 New Features
+
+- **storage**: 新增 adapter parity 和 validation (`b051dd8`)
+- **storage**: 接入 generate export 和共享 helpers (`f625596`)
+- **analyze**: 发布 public intent contract 和标准化输出 (`f4abfa6`)
+- **plugins**: 新增 runtime config 和 diagnostics surface (`74d7905`)
+- **workflow**: 扩展 quality 和回归测试覆盖 (`5eb38f7`)
+- **claude**: 引入完整的 GSD (Get Shit Done) workflow agents 和命令 (`ef537e2`)
+- **claude/gstack**: 新增 Docker 配置和 agent 定义 (`b83c000`)
+- **claude/gstack**: 新增 GitHub Actions workflows (`7ef301b`)
+
 ### 🐛 Bug Fixes
 
-- **test**: 修复 validate-docs 测试缺少 product-specs 文件的问题
+- **test**: 修复 validate-docs 测试缺少 product-specs 文件的问题 (`20d4293`)
+- **hooks**: 解决 vitest 跨 node_modules 布局的查找问题 (`d53a5ac`)
+- **hooks**: 添加本地 vitest entry 回退 (`d6542b5`)
+- **adapter**: 增加 method signature 测试超时 (`4e97ca5`)
 
 ### 📚 Documentation
 
-- **docs**: 同步 MVP3 产品规格文档基线
-- **docs**: 完成 v1.3 milestone 归档
+- **docs**: 同步 MVP3 产品规格文档基线 (`0c75108`)
+- **docs**: 完成 v1.3 milestone 归档 (`ccb7d12`)
+- **ai-guide**: 新增 ship troubleshooting section (`b7fe6d4`)
+- **guardrails**: 同步 hooks 和 validation 文档 (`38b1964`)
+- **planning**: 添加当前状态和 codebase map (`0bbd4ac`)
+
+### 🔧 Maintenance
+
+- **config**: 同步所有 AI 文档到 v0.4.2 (`43c7b17`)
+- **config**: 版本升级到 v0.4.2 (`d1f55c6`)
+- **config**: vitest 添加 lcov coverage reporter (`a4da751`)
+- **tooling**: checkpoint milestone metadata (`851ecf6`)
 
 ## [0.4.1] - 2026-03-23 - Ship Workflow Fixes
 

package/README.md

@@ -7,7 +7,7 @@ CodeMap 是一个面向 TypeScript/JavaScript/Go 项目的 AI-first 代码地图
 ## 特性
 
 - **AI-first 代码地图** - 生成 `AI_MAP.md`、`CONTEXT.md`、`codemap.json` 等 AI/Agent 可直接消费的上下文
-- **核心分析命令** - 提供 `generate`、`query`、`deps`、`impact`、`complexity`、`cycles`、`analyze`、`export`、`ci`
+- **核心分析命令** - 提供 `generate`、`query`、`deps`、`impact`、`complexity`、`cycles`、`analyze`、`design`、`export`、`ci`
 - **机器可读优先** - 结构化输出是产品基线；当前 CLI 过渡期仍主要通过 `--json` 暴露机器可读结果
 - **分层架构 (MVP3)** - 保持 `Interface → Infrastructure → Domain → Server → CLI` 的明确边界
 - **双层解析模式** - 提供 `fast`（快速正则）和 `smart`（TypeScript AST）两种解析模式
@@ -25,7 +25,7 @@ CodeMap 是一个面向 TypeScript/JavaScript/Go 项目的 AI-first 代码地图
 | 输出契约 | 目标是机器可读优先；`当前 CLI 现实` 是多数命令通过 `--json` 提供结构化结果，`analyze` 额外支持 `--output-mode machine|human` |
 | 架构边界 | `Server Layer` 是内部架构层，不等于公共 `mycodemap server` 命令 |
 
-当前公共 CLI 聚焦 `init`、`generate`、`query`、`deps`、`cycles`、`complexity`、`impact`、`analyze`、`ci`、`workflow`、`export`、`ship`；`server`、`watch`、`report`、`logs` 已从 public CLI 移除，并在调用时给出迁移提示。
+当前公共 CLI 聚焦 `init`、`generate`、`query`、`deps`、`cycles`、`complexity`、`impact`、`analyze`、`design`、`ci`、`workflow`、`export`、`ship`；`server`、`watch`、`report`、`logs` 已从 public CLI 移除，并在调用时给出迁移提示。
 
 ## 安装
 
@@ -73,6 +73,13 @@ mycodemap impact -f src/cli/index.ts -j
 
 # analyze 额外支持显式 machine/human 模式
 mycodemap analyze -i read -t src/cli/index.ts --output-mode human
+
+# 人类设计先落成 design contract，再交给 AI/Agent 消费
+cp docs/product-specs/DESIGN_CONTRACT_TEMPLATE.md mycodemap.design.md
+mycodemap design validate mycodemap.design.md --json
+mycodemap design map mycodemap.design.md --json
+mycodemap design handoff mycodemap.design.md --json
+mycodemap design verify mycodemap.design.md --json
 ```
 
 生成后，将 `.mycodemap/AI_MAP.md` 的内容提供给 AI 助手即可让其快速理解你的项目结构；需要结构化结果继续处理时，优先使用 JSON / machine 模式。
@@ -284,6 +291,39 @@ mycodemap export json -o ./out     # 指定输出路径
 
 > 内置模板（`refactoring` / `bugfix` / `feature` / `hotfix`）共享同一 4 阶段顺序，只通过不同的阶段阈值和适用场景调整体验。
 
+## 设计契约输入面
+
+`design` 是给“人类负责设计、AI 负责执行”协作链路准备的正式输入面。
+先把设计写成 `mycodemap.design.md`，再用 CLI 校验必填 sections、空段、重复 heading 和未知 heading。
+
+```bash
+# 从 canonical template 起步
+cp docs/product-specs/DESIGN_CONTRACT_TEMPLATE.md mycodemap.design.md
+
+# 使用默认文件名校验
+mycodemap design validate mycodemap.design.md --json
+
+# 校验通过后生成 candidate scope
+mycodemap design map mycodemap.design.md --json
+
+# 把 scope 打包成 handoff artifact，供 reviewer / AI agent 消费
+mycodemap design handoff mycodemap.design.md --json
+
+# 基于 reviewed handoff truth 做 verification / drift 检查
+mycodemap design verify mycodemap.design.md --json
+
+# 也可以显式传入其他路径
+mycodemap design validate docs/designs/login.design.md
+```
+
+必填 sections：
+- `## Goal`
+- `## Constraints`
+- `## Acceptance Criteria`
+- `## Non-Goals`
+
+> 建议最小工作流：`design validate → design map → design handoff → design verify`。`design map --json` 会返回 `summary`、`candidates`、`diagnostics` 与 `unknowns`；`design handoff --json` 会继续返回 `readyForExecution`、`approvals`、`assumptions` 与 `openQuestions`，默认 artifact 路径为 `.mycodemap/handoffs/{stem}.handoff.md|json`；`design verify --json` 会返回 `checklist`、`drift`、`diagnostics` 与 `readyForExecution`，其中 review-needed 不会直接变成非零退出，只有 blocker diagnostics 才会阻断。
+
 ### 工作流 CLI 命令
 
 ```bash
@@ -632,6 +672,37 @@ cp examples/codex/codemap-agent.md .agents/skills/codemap/SKILL.md
 
 ## 新增 CLI 命令
 
+### `mycodemap design`
+
+校验、映射并验证 human-authored design contract，默认读取仓库根目录的 `mycodemap.design.md`。
+
+```bash
+# validate: 使用默认路径校验
+mycodemap design validate mycodemap.design.md --json
+
+# validate: 显式指定文件
+mycodemap design validate docs/designs/login.design.md
+
+# map: 生成 candidate code scope
+mycodemap design map mycodemap.design.md --json
+
+# handoff: 生成 reviewer + agent 共用的 handoff package
+mycodemap design handoff mycodemap.design.md --json
+
+# verify: 基于 reviewed handoff truth 做 checklist / drift 校验
+mycodemap design verify mycodemap.design.md --json
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-j, --json` | 输出纯 JSON diagnostics，适合 AI/CI 消费 |
+
+> canonical 模板位于 `docs/product-specs/DESIGN_CONTRACT_TEMPLATE.md`。
+> 缺失必填 section、重复 section、空 section 或未知 heading 时，CLI 会返回结构化 diagnostics，而不是继续猜测设计意图。
+> `design map` 会基于 design contract 返回 `candidates`、`diagnostics` 与 `unknowns`；若命中 `no-candidates`、`over-broad-scope` 或 `high-risk-scope`，命令会直接阻断。
+> `design handoff` 会基于 validated design contract + mapping truth 返回 `readyForExecution`、`approvals`、`assumptions`、`openQuestions`；human mode 默认写出 `.mycodemap/handoffs/{stem}.handoff.md|json`。
+> `design verify` 会把 `Acceptance Criteria` 固定映射为 `checklist`，并输出 `drift` / `diagnostics`；当结果只是 `needs-review` 时保持零退出码，只有 `ok=false` 或 blocker diagnostics 才返回非零 exit code。
+
 ### `mycodemap analyze`
 
 统一分析入口，当前公共契约只暴露四个 intent，并统一返回结构化输出：
@@ -682,50 +753,6 @@ mycodemap analyze -i link -t src/index.ts --structured --json
 >
 > legacy 兼容映射：`search → find`、`impact/complexity → read`、`dependency/reference → link`、`overview/documentation → show`；`refactor` 会返回 `E0001_INVALID_INTENT`。
 
-### `mycodemap ci`
-
-CI Gateway - 代码质量门禁工具：
-
-```bash
-# 验证工作区是否干净（ship 的发布前检查也复用这条规则）
-mycodemap ci check-working-tree
-
-# 验证当前分支是否允许执行发布前检查
-mycodemap ci check-branch
-mycodemap ci check-branch --allow main,release/*
-
-# 运行发布前脚本集合（docs/typecheck/lint/test/build/pack）
-mycodemap ci check-scripts
-
-# 验证提交格式（[TAG] scope: message）
-mycodemap ci check-commits
-mycodemap ci check-commits -c 5
-mycodemap ci check-commits -r origin/main..HEAD
-
-# 验证文件头注释（[META], [WHY]）
-mycodemap ci check-headers
-mycodemap ci check-headers -d src/domain
-mycodemap ci check-headers -f "src/index.ts,src/cli/index.ts"
-
-# 评估变更风险
-mycodemap ci assess-risk
-mycodemap ci assess-risk -t 0.5
-
-# 验证文档同步（含 analyze generated block 校验）
-mycodemap ci check-docs-sync
-
-# 验证输出契约
-mycodemap ci check-output-contract
-
-# 检查提交文件数量（限制 10 个文件）
-mycodemap ci check-commit-size
-mycodemap ci check-commit-size -m 15
-```
-
-> `mycodemap ship` 的 CHECK 阶段现在复用 `ci check-working-tree`、`ci check-branch`、`ci check-scripts` 作为 must-pass 事实源，而不是重复实现这些检查。
-> `mycodemap ci check-headers -d <dir>` 与 `generate` / `analyze` 共享同一套 `.gitignore` 感知排除模块；若仓库没有 `.gitignore`，则回退到默认 `exclude` 列表。
-
-支持的提交 TAG 类型：`[REFACTOR]`, `[TEST]`, `[DOCS]`, `[FEAT]`, `[FIX]`, `[CHORE]`, `[PERF]`, `[SECURITY]`, `[BREAKING]`, `[HOTFIX]`, `[MIGRATION]`, `[WIP]`
 
 ## 贡献指南
 
@@ -816,3 +843,47 @@ DELETE   删除代码/文件
 ## 许可证
 
 [MIT](LICENSE)
+### `mycodemap ci`
+
+CI Gateway - 代码质量门禁工具：
+
+```bash
+# 验证工作区是否干净（ship 的发布前检查也复用这条规则）
+mycodemap ci check-working-tree
+
+# 验证当前分支是否允许执行发布前检查
+mycodemap ci check-branch
+mycodemap ci check-branch --allow main,release/*
+
+# 运行发布前脚本集合（docs/typecheck/lint/test/build/pack）
+mycodemap ci check-scripts
+
+# 验证提交格式（[TAG] scope: message）
+mycodemap ci check-commits
+mycodemap ci check-commits -c 5
+mycodemap ci check-commits -r origin/main..HEAD
+
+# 验证文件头注释（[META], [WHY]）
+mycodemap ci check-headers
+mycodemap ci check-headers -d src/domain
+mycodemap ci check-headers -f "src/index.ts,src/cli/index.ts"
+
+# 评估变更风险
+mycodemap ci assess-risk
+mycodemap ci assess-risk -t 0.5
+
+# 验证文档同步（含 analyze generated block 校验）
+mycodemap ci check-docs-sync
+
+# 验证输出契约
+mycodemap ci check-output-contract
+
+# 检查提交文件数量（限制 10 个文件）
+mycodemap ci check-commit-size
+mycodemap ci check-commit-size -m 15
+```
+
+> `mycodemap ship` 的 CHECK 阶段现在复用 `ci check-working-tree`、`ci check-branch`、`ci check-scripts` 作为 must-pass 事实源，而不是重复实现这些检查。
+> `mycodemap ci check-headers -d <dir>` 与 `generate` / `analyze` 共享同一套 `.gitignore` 感知排除模块；若仓库没有 `.gitignore`，则回退到默认 `exclude` 列表。
+
+支持的提交 TAG 类型：`[REFACTOR]`, `[TEST]`, `[DOCS]`, `[FEAT]`, `[FIX]`, `[CHORE]`, `[PERF]`, `[SECURITY]`, `[BREAKING]`, `[HOTFIX]`, `[MIGRATION]`, `[WIP]`

package/dist/ai/claude.d.ts

@@ -0,0 +1,38 @@
+import { AIProvider, type AIProviderConfig, type AIResponse } from './provider.js';
+import type { CodeMap } from '../types/index.js';
+/**
+ * Claude Provider 配置
+ */
+export interface ClaudeProviderConfig extends AIProviderConfig {
+    /** CLI 路径，默认 claude */
+    cliPath?: string;
+}
+/**
+ * Claude Provider - 通过 CLI 调用 Claude
+ */
+export declare class ClaudeProvider extends AIProvider {
+    readonly name: "claude";
+    private cliPath;
+    constructor(config?: ClaudeProviderConfig);
+    /**
+     * 执行 AI 推理
+     */
+    execute(prompt: string, context?: CodeMap): Promise<AIResponse>;
+    /**
+     * 检查 Claude CLI 是否可用
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * 构建提示词
+     */
+    private buildPrompt;
+    /**
+     * 总结 CodeMap 上下文
+     */
+    private summarizeContext;
+    /**
+     * 解析 Claude CLI JSON 响应
+     */
+    private parseResponse;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/ai/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/ai/claude.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAWjD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,SAAgB,IAAI,EAAG,QAAQ,CAAU;IACzC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE,oBAAyB;IAK7C;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAoErE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAsBrC;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;OAEG;IACH,OAAO,CAAC,aAAa;CA6BtB"}

package/dist/ai/claude.js

@@ -0,0 +1,169 @@
+// ============================================
+// Claude CLI Provider 实现
+// ============================================
+import { spawn } from 'child_process';
+import { AIProvider } from './provider.js';
+/**
+ * Claude Provider - 通过 CLI 调用 Claude
+ */
+export class ClaudeProvider extends AIProvider {
+    name = 'claude';
+    cliPath;
+    constructor(config = {}) {
+        super(config);
+        this.cliPath = config.cliPath || 'claude';
+    }
+    /**
+     * 执行 AI 推理
+     */
+    async execute(prompt, context) {
+        const timeout = this.config.timeout || 60000;
+        // 构建包含上下文的完整提示词
+        const fullPrompt = this.buildPrompt(prompt, context);
+        return new Promise((resolve, reject) => {
+            const args = [
+                '-p',
+                '--output-format', 'json',
+                '--dangerously-skip-permissions'
+            ];
+            let stdout = '';
+            let stderr = '';
+            let killed = false;
+            const proc = spawn(this.cliPath, args, {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout
+            });
+            // 超时处理
+            const timeoutId = setTimeout(() => {
+                killed = true;
+                proc.kill('SIGTERM');
+                reject(new Error(`Claude 执行超时（${timeout / 1000}秒）`));
+            }, timeout);
+            proc.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('close', (code) => {
+                clearTimeout(timeoutId);
+                if (killed)
+                    return;
+                if (code !== 0 && code !== null) {
+                    reject(new Error(`Claude CLI 错误: ${stderr || `exit code ${code}`}`));
+                    return;
+                }
+                try {
+                    const response = this.parseResponse(stdout);
+                    resolve(response);
+                }
+                catch (error) {
+                    reject(new Error(`解析 Claude 响应失败: ${error instanceof Error ? error.message : String(error)}`));
+                }
+            });
+            proc.on('error', (error) => {
+                clearTimeout(timeoutId);
+                if (!killed) {
+                    reject(new Error(`Claude CLI 执行失败: ${error.message}`));
+                }
+            });
+            // 发送提示词
+            proc.stdin.write(fullPrompt);
+            proc.stdin.end();
+        });
+    }
+    /**
+     * 检查 Claude CLI 是否可用
+     */
+    async isAvailable() {
+        return new Promise((resolve) => {
+            const proc = spawn(this.cliPath, ['--version'], {
+                stdio: 'ignore'
+            });
+            proc.on('close', (code) => {
+                resolve(code === 0);
+            });
+            proc.on('error', () => {
+                resolve(false);
+            });
+            // 2 秒超时
+            setTimeout(() => {
+                proc.kill();
+                resolve(false);
+            }, 2000);
+        });
+    }
+    /**
+     * 构建提示词
+     */
+    buildPrompt(prompt, context) {
+        let fullPrompt = prompt;
+        if (context) {
+            const contextInfo = this.summarizeContext(context);
+            fullPrompt = `${contextInfo}\n\n---\n\n${prompt}`;
+        }
+        return fullPrompt;
+    }
+    /**
+     * 总结 CodeMap 上下文
+     */
+    summarizeContext(codeMap) {
+        const lines = [];
+        lines.push('# Project Context');
+        lines.push('');
+        lines.push(`Project: ${codeMap.project.name}`);
+        lines.push(`Total Files: ${codeMap.summary.totalFiles}`);
+        lines.push(`Total Modules: ${codeMap.summary.totalModules}`);
+        lines.push('');
+        // 入口点
+        const entryPoints = codeMap.modules.filter(m => {
+            const basename = require('path').basename(m.path);
+            return basename === 'index.ts' || basename === 'main.ts' || basename === 'app.ts';
+        });
+        if (entryPoints.length > 0) {
+            lines.push('## Entry Points');
+            for (const ep of entryPoints.slice(0, 5)) {
+                lines.push(`- ${ep.path}`);
+            }
+            lines.push('');
+        }
+        // 模块列表
+        lines.push('## Modules');
+        for (const mod of codeMap.modules.slice(0, 20)) {
+            const exports = mod.exports.map(e => e.name).join(', ');
+            lines.push(`- ${mod.path}: ${exports || '(no exports)'}`);
+        }
+        if (codeMap.modules.length > 20) {
+            lines.push(`- ... and ${codeMap.modules.length - 20} more`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 解析 Claude CLI JSON 响应
+     */
+    parseResponse(stdout) {
+        // Claude 可能输出多行 JSON，需要找到有效的 JSON
+        const lines = stdout.trim().split('\n');
+        let jsonStr = '';
+        // 从后往前找有效的 JSON 对象
+        for (let i = lines.length - 1; i >= 0; i--) {
+            const line = lines[i].trim();
+            if (line.startsWith('{') && line.endsWith('}')) {
+                jsonStr = line;
+                break;
+            }
+        }
+        if (!jsonStr) {
+            // 如果没有 JSON，直接返回原始输出
+            return { content: stdout.trim() };
+        }
+        const parsed = JSON.parse(jsonStr);
+        if (parsed.error) {
+            throw new Error(parsed.error);
+        }
+        return {
+            content: parsed.result || stdout.trim()
+        };
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/ai/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/ai/claude.ts"],"names":[],"mappings":"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"}

package/dist/ai/codex.d.ts

@@ -0,0 +1,38 @@
+import { AIProvider, type AIProviderConfig, type AIResponse } from './provider.js';
+import type { CodeMap } from '../types/index.js';
+/**
+ * Codex Provider 配置
+ */
+export interface CodexProviderConfig extends AIProviderConfig {
+    /** CLI 路径，默认 codex */
+    cliPath?: string;
+}
+/**
+ * Codex Provider - 通过 CLI 调用 Codex
+ */
+export declare class CodexProvider extends AIProvider {
+    readonly name: "codex";
+    private cliPath;
+    constructor(config?: CodexProviderConfig);
+    /**
+     * 执行 AI 推理
+     */
+    execute(prompt: string, context?: CodeMap): Promise<AIResponse>;
+    /**
+     * 检查 Codex CLI 是否可用
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * 构建提示词
+     */
+    private buildPrompt;
+    /**
+     * 总结 CodeMap 上下文
+     */
+    private summarizeContext;
+    /**
+     * 解析 Codex CLI JSON 响应
+     */
+    private parseResponse;
+}
+//# sourceMappingURL=codex.d.ts.map

package/dist/ai/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/ai/codex.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,SAAgB,IAAI,EAAG,OAAO,CAAU;IACxC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE,mBAAwB;IAK5C;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAiErE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAsBrC;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;OAEG;IACH,OAAO,CAAC,aAAa;CA4BtB"}