@winspan/claude-forge 0.1.1

package/dist/claudemd/prompts.js

@@ -0,0 +1,439 @@
+export class ClaudeMdPrompts {
+    /**
+     * 将 buildPersona 暴露为静态方法，供 engine 层在优先级链中调用
+     */
+    static buildPersonaFromProfile(profile) {
+        return buildPersona(profile);
+    }
+    static buildGenerationPrompt(profile, existingContent, persona) {
+        const langs = profile.languages.map(l => l.version ? `${l.name} (${l.version})` : l.name).join(', ') || '未知';
+        const frameworks = profile.frameworks.map(f => f.name).join(', ') || '无';
+        const scripts = Object.entries(profile.scripts)
+            .map(([k, v]) => `  ${k}: \`${v}\``)
+            .join('\n') || '  （无）';
+        const existingSection = existingContent
+            ? `\n## 已有的用户自定义内容（必须完整保留，不得修改）\n\n${existingContent}\n`
+            : '';
+        // 语言相关的最佳实践片段
+        const langPractices = buildLangPractices(profile);
+        // 框架相关的最佳实践片段
+        const frameworkPractices = buildFrameworkPractices(profile);
+        // 优先使用外部传入的人设（来自配置或进化存储），否则自动推断
+        const resolvedPersona = persona ?? buildPersona(profile);
+        return `${resolvedPersona}
+
+你的任务是为 Claude Code 项目生成 CLAUDE.md 指令文件。
+CLAUDE.md 是 Claude Code 在每次会话时自动读取的项目上下文和约束文件，相当于"给 AI 结对编程伙伴的项目手册"。
+
+## 检测到的项目信息
+
+- 项目名：${profile.projectName}
+- 语言：${langs}
+- 框架：${frameworks}
+- 包管理器：${profile.packageManager || '未知'}
+- 构建工具：${profile.buildTool || '未知'}
+- 测试框架：${profile.testFramework || '未知'}
+- Linter：${profile.linter || '无'}
+- Formatter：${profile.formatter || '无'}
+- Monorepo：${profile.monorepo ? '是' : '否'}
+- 关键目录：${profile.keyDirectories.join(', ') || '无'}
+
+## 可用 Scripts
+
+${scripts}
+${existingSection}
+## 语言和框架相关实践参考
+
+${langPractices}
+${frameworkPractices}
+
+## 生成要求
+
+生成一份高质量的 CLAUDE.md，必须包含以下章节，内容要**具体、可执行、有约束力**，不要泛泛而谈：
+
+---
+
+### 1. 项目概述
+一段话说明项目是什么、做什么用。
+
+### 2. 开发环境与常用命令
+只列出 Scripts 中实际存在的命令，不编造。格式：
+\`\`\`
+构建：<命令>
+测试：<命令>（单次运行，不用 watch）
+类型检查：<命令>（如有）
+Lint：<命令>
+格式化：<命令>
+\`\`\`
+
+### 3. 代码规范与约束（核心章节）
+基于检测到的技术栈，给出**具体的、可检查的**规范，包括：
+- 命名约定（变量、函数、文件、类）
+- 类型使用规范（如 TypeScript strict 模式的具体要求）
+- 禁止事项（明确列出不允许的写法，如 \`any\`、\`console.log\` 等）
+- 注释规范
+
+### 4. 架构约束
+- 目录结构职责（每个关键目录的用途和边界）
+- 模块划分原则
+- 依赖方向（哪层可以依赖哪层，哪些不能反向依赖）
+
+### 5. 测试规范
+基于检测到的测试框架，给出：
+- 测试文件位置和命名规则
+- 什么必须测试（单元测试覆盖范围）
+- Mock 策略（哪些要 mock，哪些不能 mock）
+- 测试运行命令（单次运行，不用 watch 模式）
+
+### 6. 安全与质量红线
+这是**强制执行**的约束，违反则拒绝提交：
+- 敏感信息处理（密钥、密码、PII 不得硬编码）
+- 输入验证（所有外部输入必须在边界处验证）
+- 错误处理（不得静默吞掉错误）
+- 依赖安全（不引入未经审查的依赖）
+
+### 7. 常见陷阱（可选，如有项目特定陷阱）
+列出该技术栈中最常见的 3-5 个具体错误，格式：
+- ❌ 错误做法 → ✅ 正确做法
+
+### 8. 提交规范（如有 git）
+- Commit message 格式
+- 分支命名规则
+- PR/MR 要求
+
+---
+
+## 生成规则
+
+1. **具体胜于抽象**：不写"保持代码整洁"，要写"函数不超过 40 行，参数不超过 4 个"
+2. **只用实际存在的命令**：Scripts 字段之外的命令不出现
+3. **红线要强硬**：安全和质量约束用"禁止"、"必须"、"不得"等强制语气
+4. **技术栈特定**：根据检测到的语言和框架，给出该技术栈特有的最佳实践，不是通用废话
+5. **篇幅适中**：整体 80-200 行，每章节 5-15 行
+6. **输出语言**：中文，代码和命令保持英文
+7. **直接输出 Markdown**：不要用代码围栏包裹整体内容`;
+    }
+    static buildModulePrompt(profile, parentContext, existingContent, persona) {
+        const langs = profile.languages.map(l => l.version ? `${l.name} (${l.version})` : l.name).join(', ') || '未知';
+        const frameworks = profile.frameworks.map(f => f.name).join(', ') || '无';
+        const scripts = Object.entries(profile.scripts)
+            .map(([k, v]) => `  ${k}: \`${v}\``)
+            .join('\n') || '  （无）';
+        const existingSection = existingContent
+            ? `\n## 已有的用户自定义内容（必须完整保留，不得修改）\n\n${existingContent}\n`
+            : '';
+        const parentSection = parentContext
+            ? `\n## 父项目上下文（继承的通用规范，不要在模块文档中重复）\n\n${parentContext}\n`
+            : '';
+        // 优先使用外部传入的人设（来自配置或进化存储），否则自动推断
+        const resolvedPersona = persona ?? buildPersona(profile);
+        return `${resolvedPersona}
+
+你的任务是为 Claude Code 项目的**子模块**生成 CLAUDE.md 指令文件。
+
+这是一个**模块级**的 CLAUDE.md，与项目级不同：
+- **不要重复**父项目已有的通用规范（如语言规范、通用工具链约束）
+- **聚焦**本模块的业务职责、对外接口、特有约束
+- **简洁**：50-100 行即可，避免冗余
+
+## 检测到的模块信息
+
+- 模块名：${profile.projectName}
+- 模块路径：${profile.modulePath || '（根目录）'}
+- 语言：${langs}
+- 框架：${frameworks}
+- 包管理器：${profile.packageManager || '未知'}
+- 测试框架：${profile.testFramework || '未知'}
+- 关键目录：${profile.keyDirectories.join(', ') || '无'}
+
+## 可用 Scripts
+
+${scripts}
+${parentSection}${existingSection}
+## 生成要求
+
+生成一份**模块级** CLAUDE.md，必须包含以下章节：
+
+---
+
+### 1. 模块概述（2-3 行）
+- 本模块的核心职责（一句话）
+- 对外暴露的接口/API（如果有）
+- 与其他模块的依赖关系（如果有）
+
+### 2. 模块特有规范（5-10 行）
+- 本模块特有的代码约束（不重复父项目通用规范）
+- 业务逻辑约束（如状态管理、数据流向）
+- 接口设计约束（如 API 命名、参数校验）
+
+### 3. 关键文件说明（3-5 行）
+- 核心入口文件及其职责
+- 重要配置文件位置
+- 测试文件组织方式
+
+### 4. 开发工作流（2-4 行）
+- 本模块的开发/测试/构建命令
+- 与父项目的集成方式（如果是 monorepo）
+
+---
+
+**输出要求：**
+1. **简洁**：总篇幅 50-100 行
+2. **聚焦**：只写本模块特有的内容，不重复父项目规范
+3. **具体**：给出可执行的约束，不要泛泛而谈
+4. **直接输出 Markdown**：不要用代码围栏包裹整体内容`;
+    }
+    static buildRefinementPrompt(currentClaudeMd, distilledContent, events, profile, persona) {
+        const eventSummary = events.slice(-20).map((e) => ({
+            time: e.timestamp,
+            type: e.hook_type,
+            tool: e.tool_name || 'N/A',
+            input: e.tool_input
+                ? JSON.stringify(e.tool_input).substring(0, 200)
+                : undefined,
+        }));
+        // 优先使用外部传入的人设，否则根据 profile 推断，最后兜底
+        const resolvedPersona = persona
+            ?? (profile ? buildPersona(profile) : null)
+            ?? '你是一位拥有 15 年经验的资深工程师，深度参与过多个大型开源项目的工程规范建设，擅长从代码变更模式中提炼可执行的工程约束。';
+        return `${resolvedPersona}
+
+你当前的任务是：基于新发现的项目模式和事件，评估是否需要更新 CLAUDE.md。
+
+## 当前 CLAUDE.md
+
+${currentClaudeMd}
+
+## 最近蒸馏内容（决策和时间线）
+
+${distilledContent}
+
+## 最近事件摘要（${events.length} 条）
+
+${JSON.stringify(eventSummary, null, 2)}
+
+## 要求
+
+1. 分析蒸馏内容和事件，找出以下更新信号：
+   - 新增的常用命令（反复出现的 Bash 命令）
+   - 修正的开发流程（之前记录有误的部分）
+   - 新建立的代码规范
+   - 重要的目录结构变化
+   - 反复出现的注意事项或陷阱
+
+2. 输出格式：
+
+### SHOULD_UPDATE
+true 或 false
+
+### REASON
+简要说明为什么需要/不需要更新
+
+### UPDATED_CONTENT
+如果 SHOULD_UPDATE 为 true，输出更新后的完整 CLAUDE.md 内容（只输出自动生成部分）。
+如果为 false，此章节留空。
+
+## 规则
+- 只有发现有意义的新模式时才输出 true，不要为了更新而更新
+- 更新时保持已有的高质量约束，只增不减
+- 用中文输出`;
+    }
+    /**
+     * 构建人设进化 prompt：评估当前人设是否需要根据新发现的项目模式升级
+     */
+    static buildPersonaRefinementPrompt(currentPersona, distilledContent, profile) {
+        const frameworkNames = profile.frameworks.map(f => f.name).join(', ') || '无';
+        const langNames = profile.languages.map(l => l.name).join(', ') || '未知';
+        return `你是一个 AI 提示词工程专家，擅长为不同技术领域设计高质量的专家人设。
+
+## 当前人设
+
+${currentPersona}
+
+## 项目技术栈
+
+- 语言：${langNames}
+- 框架：${frameworkNames}
+
+## 最近蒸馏内容（反映项目实际使用的技术模式）
+
+${distilledContent}
+
+## 任务
+
+分析蒸馏内容，判断当前人设是否需要升级以更精准地匹配项目实际技术模式。
+
+升级信号：
+- 发现项目大量使用了人设中未提及的专项技术（如 GraphQL、gRPC、特定数据库、特定架构模式）
+- 发现项目有明显的领域特征（如金融、AI/ML、游戏、嵌入式）
+- 当前人设过于泛泛，缺乏项目特有的专业深度
+
+不升级的情况：
+- 人设已经足够精准
+- 蒸馏内容没有揭示新的专项技术
+- 变化不足以影响生成质量
+
+## 输出格式
+
+### PERSONA_UPDATED
+true 或 false
+
+### REASON
+一句话说明原因
+
+### UPDATED_PERSONA
+如果 PERSONA_UPDATED 为 true，输出新的人设文本（一段话，50-100 字，中文）。
+如果为 false，此章节留空。`;
+    }
+}
+// ── 语言特定最佳实践 ──────────────────────────────────────────────────────────
+function buildLangPractices(profile) {
+    const sections = [];
+    const hasTS = profile.languages.some(l => l.name === 'TypeScript');
+    const hasGo = profile.languages.some(l => l.name === 'Go');
+    const hasRust = profile.languages.some(l => l.name === 'Rust');
+    const hasPython = profile.languages.some(l => l.name === 'Python');
+    if (hasTS) {
+        sections.push(`**TypeScript 最佳实践参考：**
+- strict 模式下禁止 \`any\`，用 \`unknown\` + 类型守卫替代
+- 优先用 \`interface\` 描述对象形状，\`type\` 用于联合/交叉类型
+- 异步函数始终标注返回类型（\`Promise<T>\`）
+- 枚举优先用 \`const enum\` 或联合字符串类型
+- 不得用 \`!.\` 非空断言规避类型检查，应显式处理 null/undefined
+- import 路径使用 \`.js\` 扩展名（ESM 模式）
+- 禁止 \`@ts-ignore\`，允许 \`@ts-expect-error\`（附注释说明原因）`);
+    }
+    if (hasGo) {
+        sections.push(`**Go 最佳实践参考：**
+- 错误必须显式处理，禁止 \`_\` 丢弃非无关紧要的 error
+- 接口定义在使用方（消费者）而非实现方
+- 包名小写单词，不用下划线，不缩写（除公认缩写如 http）
+- goroutine 必须有明确的退出机制，防止泄漏
+- 上下文 \`context.Context\` 作为第一个参数传递
+- 表格驱动测试（Table-Driven Tests）是标准写法
+- \`defer\` 用于资源清理，但注意循环体内 defer 不在循环结束时执行`);
+    }
+    if (hasRust) {
+        sections.push(`**Rust 最佳实践参考：**
+- 优先用 \`Result<T, E>\` 而非 \`panic!\`，\`unwrap()\` 只用于测试或确定不会失败处
+- 所有权和借用：优先借用（\`&T\`），避免不必要的 clone
+- 错误类型实现 \`std::error::Error\` trait，推荐使用 \`thiserror\` crate
+- 公开 API 必须有文档注释（\`///\`）和示例
+- 使用 \`clippy\` 检查，不得有 warnings（\`#![deny(warnings)]\`）`);
+    }
+    if (hasPython) {
+        sections.push(`**Python 最佳实践参考：**
+- 所有公开函数必须有类型注解（PEP 484），用 \`mypy\` 或 \`pyright\` 检查
+- 禁止可变默认参数（\`def f(x=[])\`），用 \`None\` 替代
+- 异常处理具体化，禁止裸 \`except:\`，至少 \`except Exception:\`
+- 字符串格式化统一用 f-string（Python 3.6+）
+- 数据类用 \`dataclasses\` 或 \`pydantic\`，禁止裸 dict 传递结构化数据
+- 测试文件以 \`test_\` 前缀，测试函数以 \`test_\` 开头`);
+    }
+    return sections.join('\n\n') || '（无特定语言参考）';
+}
+// ── 框架特定最佳实践 ──────────────────────────────────────────────────────────
+function buildFrameworkPractices(profile) {
+    const sections = [];
+    const frameworkNames = profile.frameworks.map(f => f.name);
+    if (frameworkNames.includes('React') || frameworkNames.includes('Next.js')) {
+        sections.push(`**React/Next.js 最佳实践参考：**
+- 组件职责单一：UI 组件不含业务逻辑，业务逻辑抽入 hooks 或 service
+- 禁止在渲染函数中直接定义函数（每次渲染重新创建），用 \`useCallback\`/\`useMemo\`
+- 状态最小化：能从其他状态推导的值不单独存 state
+- Key 属性必须稳定唯一，禁止用数组 index 作 key（列表可排序/增删时）
+- 服务端组件（RSC）不得引入客户端专属 API（window、localStorage）
+- 禁止直接修改 state，始终创建新对象/数组`);
+    }
+    if (frameworkNames.includes('NestJS')) {
+        sections.push(`**NestJS 最佳实践参考：**
+- 每个模块只暴露必要的 provider，其余保持私有
+- DTO 必须用 class-validator 注解，所有入参在 Controller 层校验
+- Service 不直接访问 Request/Response，保持框架无关
+- 全局过滤器处理异常，不在 Service 中 catch 后 re-throw HTTP 异常
+- 敏感配置通过 ConfigService 读取，禁止直接 \`process.env\``);
+    }
+    if (frameworkNames.includes('Express') || frameworkNames.includes('Fastify')) {
+        sections.push(`**Node.js 后端最佳实践参考：**
+- 所有路由入参必须验证（Zod / Joi / Yup），不信任客户端数据
+- 错误通过统一的 error middleware 处理，不在路由中 \`res.status(500).send\`
+- 异步路由必须 try/catch 或用 asyncHandler 包装，防止未捕获 rejection
+- 禁止同步 I/O 操作（\`fs.readFileSync\` 等）在请求路径中调用
+- 响应格式统一：\`{ data, error, meta }\``);
+    }
+    if (frameworkNames.includes('Django') || frameworkNames.includes('FastAPI') || frameworkNames.includes('Flask')) {
+        sections.push(`**Python Web 框架最佳实践参考：**
+- 敏感配置从环境变量读取，禁止写入代码或 .env 提交到仓库
+- 数据库查询必须参数化，禁止字符串拼接 SQL
+- 所有 API 入参用 pydantic（FastAPI）或 Form/Serializer（Django）验证
+- 接口应返回一致的错误结构，不暴露内部异常详情给客户端
+- 长时间操作（发邮件、图像处理）移入后台任务队列`);
+    }
+    if (profile.testFramework === 'Vitest' || profile.testFramework === 'Jest') {
+        sections.push(`**${profile.testFramework} 测试最佳实践参考：**
+- 测试名称描述行为而非实现：\`it('should return 404 when user not found')\`
+- 每个测试只验证一个行为（单一断言原则）
+- 使用 \`vi.mock\`/\`jest.mock\` 隔离外部依赖（HTTP、数据库、文件系统）
+- 不要测试实现细节（私有方法、内部状态），只测试公开接口
+- 测试数据用 factory 函数生成，避免测试间共享可变状态
+- \`beforeEach\` 中重置 mock，防止测试间污染`);
+    }
+    return sections.join('\n\n') || '';
+}
+// ── 根据技术栈生成领域专家人设 ──────────────────────────────────────────────────
+function buildPersona(profile) {
+    const langNames = profile.languages.map(l => l.name);
+    const frameworkNames = profile.frameworks.map(f => f.name);
+    // 主语言判定
+    const primaryLang = langNames[0] || 'Unknown';
+    // 根据技术栈组合生成人设
+    if (langNames.includes('TypeScript') || langNames.includes('JavaScript')) {
+        if (frameworkNames.includes('React') || frameworkNames.includes('Next.js')) {
+            return `你是一位在 Meta（前 Facebook）React 核心团队工作过 8 年的资深前端架构师，深度参与过 React 18 并发特性和 Server Components 的设计与实现。你对 TypeScript 类型系统有极深的理解，曾为多个大型 SaaS 产品建立过前端工程规范，擅长从性能、可维护性和类型安全三个维度设计约束。`;
+        }
+        if (frameworkNames.includes('NestJS')) {
+            return `你是一位拥有 10 年 Node.js 后端经验的技术专家，曾在 Uber 和 Stripe 负责支付系统和微服务架构设计。你深度掌握 NestJS 的依赖注入、模块化设计和企业级最佳实践，对 TypeScript 严格模式、错误处理和 API 安全有极高的标准。`;
+        }
+        if (frameworkNames.includes('Express') || frameworkNames.includes('Fastify')) {
+            return `你是一位在 Netflix 和 Airbnb 工作过的 Node.js 后端专家，拥有 12 年构建高并发 API 服务的经验。你对异步编程、错误处理、输入验证和安全防护有深刻理解，曾为多个独角兽公司建立过 Node.js 后端工程规范。`;
+        }
+        if (frameworkNames.includes('Vue')) {
+            return `你是一位 Vue.js 核心团队成员，深度参与过 Vue 3 Composition API 和响应式系统的设计。你对 TypeScript 在 Vue 生态中的最佳实践有权威性理解，擅长设计组件化架构和状态管理方案。`;
+        }
+        // 通用 TS/JS
+        return `你是一位拥有 15 年 JavaScript/TypeScript 经验的全栈架构师，曾在 Google 和 Microsoft 参与过 TypeScript 编译器和 VS Code 的开发。你对类型系统、模块化设计和工程规范有极深的理解。`;
+    }
+    if (langNames.includes('Go')) {
+        if (frameworkNames.includes('Gin') || frameworkNames.includes('Echo')) {
+            return `你是一位在 Google 工作过 10 年的 Go 语言专家，深度参与过 Kubernetes 和 Docker 的核心开发。你对 Go 的并发模型、错误处理和接口设计有权威性理解，擅长构建高性能微服务和云原生应用。`;
+        }
+        return `你是一位 Go 语言核心贡献者，曾在 Google 参与 Go 标准库和工具链的开发。你对 Go 的设计哲学（简洁、显式、组合）有深刻理解，擅长从工程实践中提炼可执行的规范。`;
+    }
+    if (langNames.includes('Rust')) {
+        return `你是一位 Rust 核心团队成员，深度参与过 Rust 编译器和 Cargo 的开发。你对所有权系统、生命周期和零成本抽象有权威性理解，曾为 Mozilla、AWS 和 Cloudflare 建立过 Rust 工程规范。`;
+    }
+    if (langNames.includes('Python')) {
+        if (frameworkNames.includes('Django')) {
+            return `你是一位在 Instagram 和 Pinterest 工作过的 Python 后端专家，拥有 12 年 Django 大规模应用经验。你对 ORM 优化、安全防护和 API 设计有深刻理解，擅长建立企业级 Python 工程规范。`;
+        }
+        if (frameworkNames.includes('FastAPI')) {
+            return `你是一位现代 Python 后端架构师，深度掌握 FastAPI、Pydantic 和异步编程。你对类型注解、依赖注入和 OpenAPI 规范有权威性理解，曾为多个 AI 初创公司建立过 Python 后端工程规范。`;
+        }
+        return `你是一位拥有 15 年 Python 经验的资深工程师，曾在 Dropbox 和 Spotify 参与过大规模 Python 系统的架构设计。你对类型系统（mypy/pyright）、测试工程和代码质量有极高的标准。`;
+    }
+    if (langNames.includes('Java')) {
+        if (frameworkNames.includes('Spring Boot')) {
+            return `你是一位在 Netflix 和 LinkedIn 工作过的 Java 后端专家，拥有 15 年 Spring 生态经验。你对依赖注入、AOP、事务管理和微服务架构有深刻理解，擅长建立企业级 Java 工程规范。`;
+        }
+        return `你是一位 Java 资深架构师，曾在 Oracle 和 Google 参与过 JVM 和 Java 标准库的开发。你对并发编程、内存模型和性能优化有权威性理解。`;
+    }
+    if (langNames.includes('C++')) {
+        return `你是一位在 Google 和 Microsoft 工作过的 C++ 专家，深度参与过 Chromium 和 LLVM 的开发。你对现代 C++（C++17/20）、RAII、智能指针和零开销抽象有权威性理解，擅长建立高性能系统的工程规范。`;
+    }
+    if (langNames.includes('C#')) {
+        return `你是一位 Microsoft .NET 团队的资深工程师，深度参与过 C# 语言设计和 .NET Core 的开发。你对 LINQ、异步编程和依赖注入有权威性理解，擅长建立企业级 .NET 工程规范。`;
+    }
+    // 兜底人设
+    return `你是一位拥有 15 年软件工程经验的资深架构师，曾在 Google、Microsoft 和多家独角兽公司担任技术负责人。你深度参与过多个大型开源项目的工程规范建设，对代码质量、架构设计和团队协作有极高的标准。你擅长从项目实际情况中提炼可执行的工程约束，而非泛泛而谈。`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/claudemd/prompts.js.map

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

package/dist/claudemd/writer.d.ts

@@ -0,0 +1,27 @@
+export declare class ClaudeMdWriter {
+    private getClaudeMdPath;
+    readClaudeMd(projectPath: string): string | null;
+    /**
+     * 读取父项目的 CLAUDE.md（用于模块继承上下文）
+     */
+    readParentClaudeMd(parentPath: string): string | null;
+    hasAutoSection(projectPath: string): boolean;
+    /**
+     * 提取标记外的用户自定义内容
+     */
+    getUserContent(projectPath: string): string;
+    /**
+     * 写入自动生成内容，保留用户手写部分
+     */
+    writeClaudeMd(projectPath: string, autoContent: string): void;
+    /**
+     * 更新自动生成部分，保留用户内容不变
+     */
+    updateAutoSection(projectPath: string, newAutoContent: string): void;
+    /**
+     * 在根目录 CLAUDE.md 的自动区块末尾维护子模块 @import 列表。
+     * 每次调用以传入的 modulePaths 为准（全量覆盖），相对路径基于 projectPath。
+     */
+    updateModuleImports(projectPath: string, modulePaths: string[]): void;
+}
+//# sourceMappingURL=writer.d.ts.map

package/dist/claudemd/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/claudemd/writer.ts"],"names":[],"mappings":"AAMA,qBAAa,cAAc;IACzB,OAAO,CAAC,eAAe;IAIvB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMhD;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIrD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAM5C;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAkB3C;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAgB7D;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAIpE;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI;CA0BtE"}

package/dist/claudemd/writer.js

@@ -0,0 +1,91 @@
+import fs from 'fs';
+import path from 'path';
+const AUTO_START = '<!-- forge:claudemd-auto -->';
+const AUTO_END = '<!-- forge:end-claudemd-auto -->';
+export class ClaudeMdWriter {
+    getClaudeMdPath(projectPath) {
+        return path.join(projectPath, 'CLAUDE.md');
+    }
+    readClaudeMd(projectPath) {
+        const filePath = this.getClaudeMdPath(projectPath);
+        if (!fs.existsSync(filePath))
+            return null;
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    /**
+     * 读取父项目的 CLAUDE.md（用于模块继承上下文）
+     */
+    readParentClaudeMd(parentPath) {
+        return this.readClaudeMd(parentPath);
+    }
+    hasAutoSection(projectPath) {
+        const content = this.readClaudeMd(projectPath);
+        if (!content)
+            return false;
+        return content.includes(AUTO_START) && content.includes(AUTO_END);
+    }
+    /**
+     * 提取标记外的用户自定义内容
+     */
+    getUserContent(projectPath) {
+        const content = this.readClaudeMd(projectPath);
+        if (!content)
+            return '';
+        const startIdx = content.indexOf(AUTO_START);
+        const endIdx = content.indexOf(AUTO_END);
+        if (startIdx === -1 || endIdx === -1) {
+            // 整个文件都是用户内容
+            return content.trim();
+        }
+        const before = content.substring(0, startIdx).trim();
+        const after = content.substring(endIdx + AUTO_END.length).trim();
+        return [before, after].filter(Boolean).join('\n\n');
+    }
+    /**
+     * 写入自动生成内容，保留用户手写部分
+     */
+    writeClaudeMd(projectPath, autoContent) {
+        const filePath = this.getClaudeMdPath(projectPath);
+        const userContent = this.getUserContent(projectPath);
+        const autoBlock = `${AUTO_START}\n${autoContent.trim()}\n${AUTO_END}`;
+        let finalContent;
+        if (userContent) {
+            finalContent = `${autoBlock}\n\n${userContent}\n`;
+        }
+        else {
+            finalContent = `${autoBlock}\n`;
+        }
+        fs.writeFileSync(filePath, finalContent, 'utf-8');
+    }
+    /**
+     * 更新自动生成部分，保留用户内容不变
+     */
+    updateAutoSection(projectPath, newAutoContent) {
+        this.writeClaudeMd(projectPath, newAutoContent);
+    }
+    /**
+     * 在根目录 CLAUDE.md 的自动区块末尾维护子模块 @import 列表。
+     * 每次调用以传入的 modulePaths 为准（全量覆盖），相对路径基于 projectPath。
+     */
+    updateModuleImports(projectPath, modulePaths) {
+        const imports = modulePaths
+            .map(p => `@${path.relative(projectPath, p)}/CLAUDE.md`)
+            .join('\n');
+        const section = `## 子模块规范\n\n${imports}`;
+        const current = this.readClaudeMd(projectPath) ?? '';
+        const MODULE_START = '<!-- forge:modules -->';
+        const MODULE_END = '<!-- forge:end-modules -->';
+        const block = `${MODULE_START}\n${section}\n${MODULE_END}`;
+        let updated;
+        if (current.includes(MODULE_START)) {
+            // 替换已有区块
+            updated = current.replace(new RegExp(`${MODULE_START}[\\s\\S]*?${MODULE_END}`), block);
+        }
+        else {
+            // 追加到文件末尾（自动区块外，作为独立区块）
+            updated = current.trimEnd() + `\n\n${block}\n`;
+        }
+        fs.writeFileSync(this.getClaudeMdPath(projectPath), updated, 'utf-8');
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/claudemd/writer.js.map

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

package/dist/cli/commands/backup.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerBackupCommand(program: Command): void;
+//# sourceMappingURL=backup.d.ts.map

package/dist/cli/commands/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6D5D"}

package/dist/cli/commands/backup.js

@@ -0,0 +1,63 @@
+import { success, info } from '../utils/output.js';
+import { handleError } from '../utils/errors.js';
+import { BackupManager } from '../../backup/index.js';
+export function registerBackupCommand(program) {
+    program
+        .command('backup')
+        .description('Create a backup of all Claude Forge data')
+        .option('-p, --project <path>', 'Only backup data for a specific project')
+        .option('-e, --encrypt', 'Encrypt the backup file')
+        .option('-o, --output <path>', 'Output file path')
+        .action(async (options) => {
+        try {
+            info('Creating backup...');
+            const manager = new BackupManager();
+            const outputFile = manager.backup({
+                outputPath: options.output,
+                projectPath: options.project,
+                encrypt: options.encrypt,
+            });
+            success(`Backup created: ${outputFile}`);
+            info(`Checksum: ${outputFile}.sha256`);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    program
+        .command('restore')
+        .description('Restore data from a backup file')
+        .argument('<file>', 'Backup file path')
+        .option('-s, --strategy <strategy>', 'Restore strategy: merge, overwrite, cancel', 'merge')
+        .action(async (file, options) => {
+        try {
+            info(`Restoring from ${file}...`);
+            const manager = new BackupManager();
+            manager.restore(file, options.strategy);
+            success('Restore completed successfully');
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    program
+        .command('export')
+        .description('Export data for a specific project')
+        .requiredOption('-p, --project <path>', 'Project path to export')
+        .option('-o, --output <path>', 'Output file path')
+        .action(async (options) => {
+        try {
+            info(`Exporting project data...`);
+            const manager = new BackupManager();
+            const outputFile = manager.backup({
+                outputPath: options.output,
+                projectPath: options.project,
+            });
+            success(`Export completed: ${outputFile}`);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=backup.js.map

package/dist/cli/commands/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../../src/cli/commands/backup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAW,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAsB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,sBAAsB,EAAE,yCAAyC,CAAC;SACzE,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;SAClD,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;SACjD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;gBAChC,UAAU,EAAE,OAAO,CAAC,MAAM;gBAC1B,WAAW,EAAE,OAAO,CAAC,OAAO;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,CAAC,CAAC;YACH,OAAO,CAAC,mBAAmB,UAAU,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,aAAa,UAAU,SAAS,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,iCAAiC,CAAC;SAC9C,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;SACtC,MAAM,CACL,2BAA2B,EAC3B,4CAA4C,EAC5C,OAAO,CACR;SACA,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,IAAI,CAAC,kBAAkB,IAAI,KAAK,CAAC,CAAC;YAClC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;YACpC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YACxC,OAAO,CAAC,gCAAgC,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oCAAoC,CAAC;SACjD,cAAc,CAAC,sBAAsB,EAAE,wBAAwB,CAAC;SAChE,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;SACjD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,IAAI,CAAC,2BAA2B,CAAC,CAAC;YAClC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;gBAChC,UAAU,EAAE,OAAO,CAAC,MAAM;gBAC1B,WAAW,EAAE,OAAO,CAAC,OAAO;aAC7B,CAAC,CAAC;YACH,OAAO,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}