soloforge 1.2.8 → 1.2.10

package/README.md

@@ -1,406 +1,190 @@
 # SoloForge
 
-AI 驱动的开发工作流系统 — 一个人干五个人的活。
+AI 编程助手的项目工作流配置器。SoloForge 帮你把 Claude Code、Codex App、Trae IDE 接入同一套项目规则、知识模板和验证习惯，让 AI 在你的项目里更少误判、更少乱写、更容易交付可检查的结果。
 
-SoloForge 是一个 [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 服务器，为 AI 编程助手（Claude Code、Codex App、Trae IDE）提供结构化的、知识驱动的开发工作流。它作为规则引擎和模板系统，通过知识模式、验证管线和自动化代码审查来保障工程质量。
+## 适合谁
+
+- 你已经在用 Claude Code、Codex App 或 Trae IDE 写代码。
+- 你希望每个项目都有稳定的 AI 工作流规则，而不是每次从零解释。
+- 你希望 AI 修改代码前先理解项目边界，生成产物时不要误改源码。
+- 你希望配置可以自动推断，但不要在低置信度时乱写项目配置。
 
 ## 最短成功路径
 
 ```bash
-# 1. 全局安装（任意目录均可）
+# 1. 全局安装
 npm install -g soloforge
 
 # 2. 进入项目根目录
 cd /path/to/my-project
 
-# 3. 预检：看看会生成什么（不写入文件）
+# 3. 预检：查看 SoloForge 会识别出什么，不写入配置
 soloforge init --auto --dry-run
 
-# 4. 确认后正式初始化（自动探测项目结构）
+# 4. 初始化项目
 soloforge init --auto
 
-# 5. 重新打开 / 重载 AI 工具（让它加载新生成的配置）
-#    Claude Code → 退出后重新在项目目录启动 claude
-#    Trae IDE    → 重新打开项目目录（需已开启项目级 MCP）
-#    Codex App   → 重新打开项目目录
+# 5. 重新打开你的 AI 工具，让它加载新配置
+# Claude Code: 退出后在项目目录重新启动 claude
+# Codex App: 重新打开项目目录
+# Trae IDE: 重新打开项目目录
 
-# 6. 验证是否生效
-soloforge validate          # 检查配置和知识文件
-soloforge status            # 查看当前项目状态
+# 6. 检查状态
+soloforge validate
+soloforge status
 ```
 
-如果 `--auto` 置信度不够，用 `soloforge init --interactive` 手动配置。
-
-## 快速开始
-
-### 安装
+如果 `init --auto` 提示置信度不足，改用：
 
 ```bash
-npm install -g soloforge    # 全局安装，可在任意目录执行
+soloforge init --interactive
 ```
 
-### 初始化
+## 初始化方式
 
-所有 `soloforge` 命令默认在**当前目录**操作。`--project-path` 仅 `init` 和 `init --auto` 支持；`generate-*`、`validate`、`status` 需先 `cd` 到目标项目目录。
+所有命令默认作用于当前目录。推荐先 `cd` 到项目根目录再执行。
 
 ```bash
-# 推荐：先 dry-run 预检
-soloforge init --auto --dry-run                    # 查看探测结果，不写入文件
-
-# 正式初始化（在项目根目录执行，或加 --project-path）
-soloforge init --auto                               # 自动探测项目结构，高置信度时写入
-soloforge init --auto --project-path /path/to/proj  # 不在项目目录时用 --project-path
-soloforge init                                      # 手动默认配置（Claude Code 适配器）
-soloforge init --adapter trae                       # Trae IDE 适配器
-soloforge init --adapter codex                      # Codex App 适配器
-soloforge init --adapter all                        # 同时生成所有适配器配置
-
-# 交互式配置（手动输入项目名称、技术栈等）
-soloforge init --interactive
-
-# 低置信度时的兜底
-soloforge init --interactive                        # 手动补充配置
+soloforge init --auto --dry-run      # 只预览，不写入 config.yaml
+soloforge init --auto                # 高置信度时生成项目配置和适配器文件
+soloforge init                       # 生成目录、知识模板和适配器文件，不写 config.yaml
+soloforge init --interactive         # 手动确认项目配置
+soloforge init --adapter claude      # 只生成 Claude Code 配置
+soloforge init --adapter codex       # 只生成 Codex App 配置
+soloforge init --adapter trae        # 只生成 Trae IDE 配置
+soloforge init --adapter all         # 同时生成所有适配器配置
 ```
 
-### 各适配器生成的文件
-
-| 适配器 | 生成文件 | 说明 |
-|--------|---------|------|
-| Claude Code | `.claude/settings.json` | Hooks 配置（PreToolUse/PostToolUse） |
-| | `CLAUDE.md` | 工作流规则文件 |
-| | `.mcp.json` | MCP Server 配置（SoloForge + Playwright） |
-| Trae IDE | `.trae/mcp.json` | MCP Server 配置 |
-| | `.trae/rules/project_rules.md` | 项目规则文件 |
-| Codex App | `.codex/config.toml` | MCP Server 配置（TOML 格式） |
-| | `.codex/hooks.json` | Hooks 配置 |
-| | `AGENTS.md` | 工作流规则文件 |
-| 共通 | `.soloforge/config.yaml` | 项目配置（不覆盖已有） |
-| | `.soloforge/knowledge/` | 知识模板（不覆盖已有） |
-| | `.gitignore` 追加 | `.mcp.json` 和 `.soloforge/`（如缺失则追加） |
-
-> **Cursor 说明**: Cursor 暂无内置适配器（无 `--adapter cursor`）。如需在 Cursor 中使用 SoloForge：
-> 1. 先用 `soloforge init` 生成 `.mcp.json`
-> 2. 从 `.mcp.json` 中复制 `soloforge` 这一项，粘贴到项目根目录的 `.cursor/mcp.json`
-> 3. 将 `SOLOFORGE_PROJECT` 改为项目绝对路径
->
-> 示例 `.cursor/mcp.json`:
-> ```json
-> {
->   "mcpServers": {
->     "soloforge": {
->       "command": "soloforge",
->       "args": ["mcp"],
->       "env": { "SOLOFORGE_PROJECT": "/absolute/path/to/my-project" }
->     }
->   }
-> }
-> ```
-> 前提：`soloforge` 已全局安装（`npm install -g soloforge`）且在 PATH 上。生成后重载 Cursor 窗口。
-
-### 初始化后的下一步
-
-1. **检查配置**: `soloforge validate` — 确认 config.yaml 和知识文件正确
-2. **重新打开 / 重载 AI 工具**: 退出并重新启动 Claude Code / Trae / Codex，让它加载新生成的配置文件
-3. **试一个小任务**: 让 AI "创建一个简单的 DTO"，观察 SoloForge 工作流是否触发
-4. **查看状态**: `soloforge status` — 确认知识库已索引
-
-### 更新与重新生成
-
-SoloForge 更新后，需要重新生成适配器配置以获取最新的 hooks 和规则：
+`config.yaml` 是可选文件。没有它时，SoloForge 会根据 `package.json`、`pom.xml`、`go.mod` 等文件在运行时推断项目类型；只有高置信度或你手动确认时，才会把配置写入 `.soloforge/config.yaml`。
 
-```bash
-# 更新 SoloForge（任意目录均可）
-npm update -g soloforge
+## 生成文件
 
-# 重新生成（在目标项目根目录执行，不会覆盖 config.yaml 和已有知识）
-soloforge init                          # Claude Code: .claude/settings.json + CLAUDE.md
-soloforge generate-hooks                # 仅重新生成 .claude/settings.json hooks
-soloforge generate-claude-md            # 仅重新生成 CLAUDE.md
-soloforge generate-trae                 # 仅重新生成 .trae/ 配置
-soloforge generate-codex                # 仅重新生成 .codex/ 配置 + AGENTS.md
-
-# 重新生成后，重新打开 / 重载 AI 工具以加载更新
+| 位置 | 用途 |
+|------|------|
+| `.soloforge/knowledge/` | 项目知识模板和规则 |
+| `.soloforge/config.yaml` | 可选项目配置，仅在高置信度或手动确认后生成 |
+| `.claude/settings.json` / `CLAUDE.md` / `.mcp.json` | Claude Code 配置 |
+| `.codex/config.toml` / `.codex/hooks.json` / `AGENTS.md` | Codex App 配置 |
+| `.trae/mcp.json` / `.trae/rules/project_rules.md` | Trae IDE 配置 |
 
-# 查看版本
-soloforge version
-```
+SoloForge 不会覆盖已有知识文件。重新运行 `soloforge init` 可刷新适配器配置。
 
-### 日常命令
+## 日常命令
 
 ```bash
-# 以下命令均在项目根目录执行
-soloforge validate          # 验证配置和知识文件
-soloforge status            # 查看当前项目状态
+soloforge validate          # 检查项目配置和知识文件
+soloforge status            # 查看当前项目状态和配置来源
+soloforge version           # 查看版本
 ```
 
-## 工作原理
-
-SoloForge 以 MCP Server（stdio 传输）运行。AI 助手在开发过程中调用 SoloForge 工具：
+更新 SoloForge 后，建议重新生成适配器配置：
 
+```bash
+npm update -g soloforge
+cd /path/to/my-project
+soloforge init
 ```
-开发者 → AI 助手 (Claude Code / Trae / Codex) → SoloForge MCP Server
-                                               ← 知识、规则、模板
-```
-
-SoloForge 引擎不直接调用 LLM API，由宿主 AI 中转。所有智能来自宿主 AI，SoloForge 提供结构、规则和知识。
-
-## MCP 工具
-
-### 核心管线（Phase 1）
-
-| 工具 | 说明 |
-|------|------|
-| `sf_classify` | 分类任务意图、风险、复杂度；确定执行模式 |
-| `sf_expand` | 意图膨胀 + 知识匹配 + 作用域控制 + 验收标准 |
-| `sf_verify` | 生成构建/测试验证命令，收集证据 |
-| `sf_learn` | 从已完成任务提取模式，更新知识库 |
-| `sf_status` | 查询任务状态，恢复中断的工作流 |
-
-### 质量与规划（Phase 2）
-
-| 工具 | 说明 |
-|------|------|
-| `sf_plan` | 复杂意图拆解为子任务，分析依赖关系 |
-| `sf_plan_advance` | 高级任务规划：知识驱动的多步骤规划 |
-| `sf_analyze` | 影响范围分析，与声明范围对比 |
-| `sf_scaffold` | 脚手架生成（Controller/Service/DTO 等） |
-| `sf_review` | 五维代码审查（质量/安全/性能/技术债务/架构） |
-
-### 团队协作（Phase 3）
-
-| 工具 | 说明 |
-|------|------|
-| `sf_deliver` | 提交代码、生成变更日志；推送和 PR 取决于交付配置 ⚠️ |
-| `sf_coord_check` | 预测性冲突检测，跨仓库关联提示 |
-| `sf_team_status` | 活动流、工作负载可视化、过期分支告警 |
-| `sf_contract_check` | 检测接口契约的破坏性变更 |
-| `sf_onboard` | 引导式入职：项目概览 → 代码导览 → 首任务 |
-
-> **⚠️ `sf_deliver` 风险说明**: 默认行为是 `auto_commit=true, auto_push=false, auto_pr=false` — 即只执行 `git commit`，不推送、不创建 PR。推送和 PR 由交付配置（`delivery` 域知识中的 `auto_push` / `auto_pr`）或调用参数 `skip_push` / `skip_pr` 控制。SoloForge 不会自动调用此工具，必须由开发者或 AI 助手显式触发。建议首次使用前先执行 `sf_review` 确认变更内容，或在交付配置中保持 `auto_push: false` 以手动控制推送时机。
-
-### 知识维护
 
-| 工具 | 说明 |
-|------|------|
-| `sf_knowledge_add` | 新增知识条目，返回行业探索指引 |
-| `sf_knowledge_update` | 更新知识条目内容 |
-| `sf_knowledge_audit` | 审计知识格式、完整性和质量 |
-
-### 高级能力（Phase 4）
+## 使用时你会看到什么
 
-| 工具 | 说明 |
-|------|------|
-| `sf_feasibility_check` | 三档可行性分析（可行/风险/不可行） |
-| `sf_debug` | 智能排障：解析 → 追踪 → 根因 → 修复方案 |
-| `sf_observability` | 系统指标、告警检测、周期报告 |
+接入成功后，AI 助手会在合适的时候调用 SoloForge 来理解任务、生成执行上下文、给出验证建议和记录任务状态。对你来说，主要变化是：
 
-### 深度能力（Phase 5）
+- 写代码类任务会更明确 scope、验收项和验证命令。
+- 生成文档、提取说明、分析日志等产物型任务会默认输出到 `.soloforge/output/`，不会默认修改 `src/`。
+- 遇到缺少路径、源码包、日志等必需输入时，会先澄清，而不是猜着执行。
+- 敏感信息、危险命令和高风险交付动作会更保守，需要你确认。
 
-| 工具 | 说明 |
-|------|------|
-| `sf_migration_check` | 分析数据库迁移文件安全性，检测破坏性操作 |
-| `sf_test_guide` | 根据变更文件生成测试类型、场景和 Mock 指引 |
-| `sf_test_quality` | 五维评估测试文件质量（断言/边界/命名/重复/覆盖） |
-| `sf_dependency_scan` | 扫描依赖漏洞，支持 npm/maven/gradle |
-| `sf_debt_report` | 技术债务聚合报告：分类、趋势、优先级 |
+## 产物输出
 
-### 治理闭环
+文档、分析报告、源码包提取结果等非代码产物默认写入：
 
-| 工具 | 说明 |
-|------|------|
-| `sf_audit_sample` | 按风险加权抽样，critical 100% 抽中 |
-| `sf_escape_report` | 记录逃逸/误伤/工具故障 |
-| `sf_governance_report` | 汇总治理健康报告 |
-| `sf_capability_update` | 人工确认后更新能力状态 |
+```text
+.soloforge/output/
+```
 
-## 知识体系
+例如让 AI “从 `/tmp/prototype.zip` 抓取原型说明”，SoloForge 会把它作为只读外部材料处理，要求产物写入 `.soloforge/output/**`，而不是修改项目源码。
 
-SoloForge 内置知识模板（含全局模式），覆盖 6 种类型：
+## Cursor 说明
 
-| 类型 | 用途 |
-|------|------|
-| `pattern` | 决策规则 + 验收标准 |
-| `procedure` | 操作流程 + 检查点 |
-| `domain` | 业务规则、约束条件、例外情况 |
-| `acceptance_template` | 质量门禁 + 自动化检查命令 |
-| `review_rule` | 正则驱动的代码审查规则 |
-| `pipeline_procedure` | CI/CD 流水线阶段定义 |
-
-知识文件采用 Markdown + YAML frontmatter 格式：
-
-```markdown
----
-name: crud-operation
-type: pattern
-when: "CRUD, 增删改查, 新增, 删除, 修改"
-scope: [backend]
-products: ["*"]
----
-
-## 决策规则
-- API 层使用 DTO，持久层使用 Entity
-- 业务实体使用软删除，日志使用硬删除
-...
-
-## 验收项
-- [AC-01] 所有 CRUD 端点返回正确的 HTTP 状态码
-...
-```
+Cursor 暂无内置适配器。可以先生成 `.mcp.json`，再手动复制到 `.cursor/mcp.json`：
 
-## 项目配置
-
-SoloForge 从 `.soloforge/config.yaml` 读取项目配置：
-
-```yaml
-name: my-project
-tech_stack:
-  backend:
-    lang: java
-    framework: spring-boot
-    version: "3.0"
-  frontend:
-    lang: typescript
-    framework: react
-    version: "18"
-product_profile: default
-repos:
-  - name: backend
-    path: .
-    lang: java
-    framework: spring-boot
-    scope: ["src/main/java"]
-build_commands:
-  backend:
-    build: mvn compile -q
-    test: mvn test -q
-    full: mvn verify -q
-  frontend:
-    build: npm run build
-    test: npm test
-    full: npm run build && npm test
-scope:
-  backend: ["src/main/java"]
-  frontend: ["src/main/react"]
+```bash
+soloforge init
 ```
 
-## 架构
-
-```
-知识层                   机制层                      适配层
-+------------------+    +---------------------+    +------------------+
-| 知识模板          |    | 分类器               |    | Claude Code      |
-| 6 种知识类型      |    | 意图膨胀器           |    | Trae IDE         |
-| 产品 Profile     |    | 验证器               |    | Codex App        |
-|                  |    | 代码审查器           |    | CLI              |
-| 项目专属知识      |    | 任务规划器           |    |                  |
-|                  |    | 脚手架生成器         |    |                  |
-|                  |    | 自动交付             |    |                  |
-|                  |    | 契约治理内核         |    |                  |
-+------------------+    +---------------------+    +------------------+
+示例：
+
+```json
+{
+  "mcpServers": {
+    "soloforge": {
+      "command": "soloforge",
+      "args": ["mcp"],
+      "env": { "SOLOFORGE_PROJECT": "/absolute/path/to/my-project" }
+    }
+  }
+}
 ```
 
-## 契约治理内核
-
-SoloForge 的治理能力按四级状态管理，新增治理能力不伪装 hard block：
-
-| 状态 | 含义 |
-|------|------|
-| `enforced` | 强制执行，阻断不合规操作 |
-| `advisory` | 建议性告警，由开发者决策 |
-| `experimental` | 实验性，需晋级计划才能升级 |
-| `removed` | 已移除，不再生效 |
-
-治理闭环：任务完成入池 → 按风险加权抽样 → 逃逸记录 → 治理报告 → 人工确认后状态更新。所有状态变更必须经 `sf_capability_update` + 人工确认，不自动执行。
-
-## 常见问题 / 排错
-
-### `soloforge init` 报 "配置校验失败"
-
-`--auto` 模式依赖指纹检测（pom.xml / package.json 等）。如果项目结构非标准，用 `--interactive` 手动配置。
+保存后重载 Cursor 窗口。
 
-### `soloforge validate` 报知识文件错误
+## 常见问题
 
-知识模板随 SoloForge 版本更新。重新运行 `soloforge init` 不会覆盖已有知识，但可手动删除 `.soloforge/knowledge/` 后重新初始化。
+### `soloforge init --auto` 没有生成 config.yaml
 
-### AI 助手没有调用 SoloForge 工具
+这是正常行为。SoloForge 只有在项目指纹足够明确时才会自动写配置。你可以继续使用运行时推断，也可以执行 `soloforge init --interactive` 手动确认。
 
-确认适配器配置已生成：
-- Claude Code: 检查 `.mcp.json` 是否存在且路径正确
-- Trae IDE: 检查 `.trae/mcp.json` 是否存在，并确认 Trae 已开启项目级 MCP（beta flag）
-- Codex App: 检查 `.codex/config.toml` 是否存在
+### AI 工具没有调用 SoloForge
 
-### `sf_deliver` 执行后想撤回
+先检查对应配置文件是否生成，然后重启或重载 AI 工具：
 
-默认只执行 `git commit`（不推送）。如果交付配置启用了 `auto_push`：
-- 未推送时：`git reset HEAD~1` 撤销最近一次提交
-- 已推送时：`git revert <hash>` 创建反向提交
-- PR：在 Git 平台关闭
+- Claude Code: `.mcp.json`、`.claude/settings.json`、`CLAUDE.md`
+- Codex App: `.codex/config.toml`、`.codex/hooks.json`、`AGENTS.md`
+- Trae IDE: `.trae/mcp.json`、`.trae/rules/project_rules.md`
 
-### 指定项目路径 vs 当前目录
+### 想重新生成配置
 
 ```bash
-# 方式 1: cd 到项目目录
-cd /path/to/my-project
 soloforge init
-
-# 方式 2: --project-path（适用于脚本或非交互场景）
-soloforge init --project-path /path/to/my-project
 ```
 
-## 卸载 / 清理
+该命令会刷新适配器配置，不会覆盖已有 `.soloforge/config.yaml` 和知识文件。
 
-### 全局卸载
+### 想清理项目中的 SoloForge 文件
+
+全局卸载只会移除命令：
 
 ```bash
-npm uninstall -g soloforge    # 任意目录均可
+npm uninstall -g soloforge
 ```
 
-`npm uninstall -g` 只移除 `soloforge` 命令本身，不会删除任何项目中的 `.soloforge/`、适配器配置或规则文件。
-
-### 项目内清理
+项目内文件需要手动删除：
 
-卸载后，以下文件/目录保留在项目中，按需手动删除：
-
-| 文件 / 目录 | 适配器 | 备注 |
-|------------|--------|------|
-| `.soloforge/` | 共通 | 项目配置、知识模板、状态 |
-| `.mcp.json` | Claude Code | MCP Server 配置 |
-| `.claude/settings.json` | Claude Code | Hooks 配置 |
-| `CLAUDE.md` | Claude Code | **可能有用户手写内容，删除前确认** |
-| `.trae/` | Trae IDE | MCP 配置 + 规则文件 |
-| `.codex/` | Codex App | MCP 配置 + Hooks |
-| `AGENTS.md` | Codex App | **可能有用户手写内容，删除前确认** |
+```text
+.soloforge/
+.mcp.json
+.claude/
+CLAUDE.md
+.codex/
+AGENTS.md
+.trae/
+```
 
-`.gitignore` 中由 SoloForge 自动追加的 `.mcp.json` 和 `.soloforge/` 条目也需手动移除。
+删除 `CLAUDE.md` 或 `AGENTS.md` 前请确认没有手写内容。
 
 ## 本仓库开发
 
-以下命令在 SoloForge 源码仓库根目录执行：
-
 ```bash
-# 安装依赖
 npm install
-
-# 构建
 npm run build
-
-# 运行测试
 npm test
-
-# 类型检查
-npm run lint
-
-# 监听模式
-npm run dev
 ```
 
-## 技术栈
+## 技术要求
 
-- TypeScript (ESM)
 - Node.js >= 18
-- MCP SDK (`@modelcontextprotocol/sdk`)
-- Handlebars（模板引擎）
-- Vitest（测试框架）
+- TypeScript / ESM
+- 支持的 AI 编程工具（Claude Code / Codex App / Trae IDE）
 
 ## 许可证
 

package/dist/adapters/claude_code/claude_md.d.ts

@@ -1,2 +1,7 @@
+/**
+ * 生成 CLAUDE.md 项目指令文件内容。
+ * @param config - 项目配置
+ * @returns CLAUDE.md 文件的文本内容
+ */
 export declare function generateClaudeMd(config: import("../../types.js").ProjectConfig): string;
 //# sourceMappingURL=claude_md.d.ts.map

package/dist/adapters/claude_code/claude_md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude_md.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/claude_md.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,gBAAgB,EAAE,aAAa,GAAG,MAAM,CAEvF"}
+{"version":3,"file":"claude_md.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/claude_md.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,gBAAgB,EAAE,aAAa,GAAG,MAAM,CAGvF"}

package/dist/adapters/claude_code/claude_md.js

@@ -1,5 +1,11 @@
 import { generateWorkflowRules } from "../shared/workflow_template.js";
+/**
+ * 生成 CLAUDE.md 项目指令文件内容。
+ * @param config - 项目配置
+ * @returns CLAUDE.md 文件的文本内容
+ */
 export function generateClaudeMd(config) {
+    console.error("[soloForge] ClaudeMD生成: 开始生成 CLAUDE.md");
     return generateWorkflowRules(config) + "\n";
 }
 //# sourceMappingURL=claude_md.js.map

package/dist/adapters/claude_code/claude_md.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude_md.js","sourceRoot":"","sources":["../../../src/adapters/claude_code/claude_md.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,UAAU,gBAAgB,CAAC,MAA8C;IAC7E,OAAO,qBAAqB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"claude_md.js","sourceRoot":"","sources":["../../../src/adapters/claude_code/claude_md.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA8C;IAC7E,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACxD,OAAO,qBAAqB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAC9C,CAAC"}

package/dist/adapters/claude_code/hooks.d.ts

@@ -1,3 +1,7 @@
 export { generateClaudeMd } from "./claude_md.js";
+/**
+ * 生成 Claude Code hooks 配置对象。
+ * @returns hooks 配置对象，包含 PreToolUse 和 PostToolUse 钩子
+ */
 export declare function generateHooksConfig(): object;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/adapters/claude_code/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,wBAAgB,mBAAmB,IAAI,MAAM,CA2B5C"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CA4B5C"}

package/dist/adapters/claude_code/hooks.js

@@ -1,5 +1,10 @@
 export { generateClaudeMd } from "./claude_md.js";
+/**
+ * 生成 Claude Code hooks 配置对象。
+ * @returns hooks 配置对象，包含 PreToolUse 和 PostToolUse 钩子
+ */
 export function generateHooksConfig() {
+    console.error("[soloForge] Hooks配置: 生成 hooks 配置");
     return {
         hooks: {
             PreToolUse: [

package/dist/adapters/claude_code/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/adapters/claude_code/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,KAAK,EAAE;YACL,UAAU,EAAE;gBACV;oBACE,OAAO,EAAE,YAAY;oBACrB,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,uBAAuB;yBACjC;qBACF;iBACF;aACF;YACD,WAAW,EAAE;gBACX;oBACE,OAAO,EAAE,MAAM;oBACf,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,qBAAqB;yBAC/B;qBACF;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/adapters/claude_code/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAClD,OAAO;QACL,KAAK,EAAE;YACL,UAAU,EAAE;gBACV;oBACE,OAAO,EAAE,YAAY;oBACrB,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,uBAAuB;yBACjC;qBACF;iBACF;aACF;YACD,WAAW,EAAE;gBACX;oBACE,OAAO,EAAE,MAAM;oBACf,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,qBAAqB;yBAC/B;qBACF;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/claude_code/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDjE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDjE"}

package/dist/adapters/claude_code/server.js

@@ -8,6 +8,7 @@ import { registerTools } from "./tools.js";
  * @param deps - 服务器依赖项（配置、知识索引、任务上下文）
  */
 export async function startServer(deps) {
+    console.error("[soloForge] server: startServer() 开始执行");
     const { config, knowledgeIndex, taskContext } = deps;
     const server = new McpServer({
         name: "soloforge",
@@ -28,7 +29,7 @@ export async function startServer(deps) {
             await transport.close?.();
         }
         catch (e) {
-            console.debug("[soloforge]", e);
+            console.debug("[soloForge]", e);
         }
         process.exit(0);
     };
@@ -38,30 +39,17 @@ export async function startServer(deps) {
     process.on("SIGPIPE", () => {
         shutdown();
     });
-    // 捕获未处理的同步异常，确保资源释放后退出
-    process.on("uncaughtException", async (err) => {
+    // 捕获未处理的同步异常，同步清理后退出（避免异步清理未完成就 exit）
+    process.on("uncaughtException", (err) => {
         console.error("SoloForge 未捕获异常:", err);
-        try {
-            if (knowledgeIndex)
-                await knowledgeIndex.close();
-            await transport.close?.();
-        }
-        catch (e) {
-            console.debug("[soloforge]", e);
-        }
+        // 同步清理：不等待 async 操作，直接退出
+        process.exitCode = 1;
         process.exit(1);
     });
-    // 捕获未处理的 Promise 拒绝，确保资源释放后退出
-    process.on("unhandledRejection", async (reason) => {
+    // 捕获未处理的 Promise 拒绝，同步清理后退出
+    process.on("unhandledRejection", (reason) => {
         console.error("SoloForge 未处理的 Promise 拒绝:", reason);
-        try {
-            if (knowledgeIndex)
-                await knowledgeIndex.close();
-            await transport.close?.();
-        }
-        catch (e) {
-            console.debug("[soloforge]", e);
-        }
+        process.exitCode = 1;
         process.exit(1);
     });
 }

package/dist/adapters/claude_code/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsB3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB;IAChD,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAErD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IAE/D,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5C,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAChD,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsB3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB;IAC9C,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC1D,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAErD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IAE/D,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;QACtC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACvC,yBAAyB;QACzB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}