repoctx

Solumbe

模型生成变更。Solumbe 验证变更能否安全合并。

此前名为 Òtítọ́（@bashbop/otito），于 4.0.0 版更名；CHANGELOG 列出了所有旧名称及其新名称。

Solumbe 是一个本地优先、确定性、与模型无关的信任层，服务于 AI 辅助开发。它会在 Agent 编辑之前构建感知任务的仓库上下文，为变更实际涉及的内容评分，并依据确切的暂存树判断是否已满足合并条件。它无需服务端或账户，代码也不会离开本机。

它不会取代 Claude Code、Codex、Cursor、Gemini 或任何原生 Agent 框架。它与它们并行运行，无论底层模型如何更换，都能持续发挥作用。

本地检查通过并不意味着自动批准合并：托管 CI、GitHub 审查、CODEOWNERS 和人工发布决策仍是各自独立的权威依据。

安装

npm install -g @bashbop/solumbe
solumbe doctor
solumbe install --host all

最后一条命令会将 Solumbe 的 MCP 服务连接到检测到的所有 Agent 宿主：Claude Code、Claude Desktop、Codex CLI、Cursor、VS Code、Gemini CLI 和 Kimi Code CLI。添加 --dry-run 可先查看计划，或使用 --host claude-code,cursor 指定宿主。之后请重启每个宿主。

也可以不安装，直接运行：npx -y @bashbop/solumbe doctor。

功能

仅根据请求为变更实际涉及的内容排序，无需模型、嵌入或网络：

$ solumbe impact . "add refund handling to checkout" --top 3

  concepts: money flow

   1.  src/payment/checkout.service.ts    score 155
       |- role: required
       |- path matches: checkout
       |- symbol matches: checkout, refund
       |- concept match: money flow (×1.4 + 6.0)
       |- risk: money flow

   2.  src/payment/stripe.webhook.ts    score 6
       |- role: advisory
       |- concept match: money flow (×1.4 + 6.0)

检查确切的暂存树，并准确说明原因：

$ solumbe gate . --staged --base origin/main --request "add refund handling to checkout" --min-convergence 80

  [OK]    Changed files          1 changed file found.
  [OK]    Staged snapshot        Changed-file scope and convergence evidence are captured from the exact staged Git tree.
     |- Tree: 7d0b513dd256877d6bd309a6406468a9b1eaeedc
     |- Base: b776f04fcfbd02c8ce8d63e1a0c2450be58de039
  [OK]    Secret safety          No secret file paths and no credential values found in the changed content.
  [WARN]  Risk review            Risk-sensitive files changed; maintainer review should be explicit.
     |- src/payment/checkout.service.ts
  [OK]    Convergence            Task and diff satisfy the convergence requirement.
     |- Score: 100/100 (aligned)
     |- Receipt handle: rcpt_a8d31efae06e
     |- Subject tree: 7d0b513dd256877d6bd309a6406468a9b1eaeedc

  VERDICT  WARN

收敛度评分是模型无法自行评定的部分：它会对照所声明的意图与差异实际修改的文件，并生成一份绑定到确切基准、父节点和暂存树身份的凭据。

确保变更不超出声明范围。 在编辑之前记录请求预计涉及的文件；检查会列出所有从未声明的文件：

$ solumbe declare . "add refund handling to checkout"
$ # ... the agent edits ...
$ solumbe gate . --staged --base HEAD --intent .solumbe/intent.json

  [FAIL]  Scope contract         Touched `src/auth/session.ts`, which was never declared. Amend the intent with the reason it belongs (`solumbe amend <file> --reason "<why>"`), or take it out of the change.
     |- Request: "add refund handling to checkout"
     |- Contract: fe655c2af2b31b7e3edec6aedd248b379235811d1228c829f87ff73796ace487
     |- Changed files: 3 (1 declared, 0 amended, 1 implied, 1 undeclared)
     |- Implied: tests/checkout.service.test.ts (owner-test of src/payment/checkout.service.ts)
     |- Undeclared on a risk-sensitive path: src/auth/session.ts [auth/security]

修订会将文件及其原因添加到合约中，并对合约进行哈希处理，让审查者了解范围扩大的原因。通过 MCP 使用时，调用 change_impact 并设置 declare: true，以及调用 review_gate 并设置 intent。

核心功能

产品由四条命令组成。它们不会调用模型、打开套接字，也不会读取仓库以外的任何内容。

阶段	命令	用途
修改前	solumbe context "add refund handling" --path .	确定请求需要哪些文件、测试和命令
修改后	solumbe converge . "add refund handling" --base origin/main --staged	评估差异与请求的匹配程度，并生成凭证
合并前	solumbe gate . --staged --base origin/main --request "add refund handling"	针对精确的暂存树给出 PASS / WARN / FAIL 结果
合并后	solumbe attest . --verdict verdict.json --merge <sha>	以哈希链记录已发布的内容及其对应的判定结果

solumbe help 会展示这些命令以及设置方法；solumbe help --all 会列出所有命令，包括用于支持它们的命令（impact、declare、pr、review、map、calibrate、route、ax、dashboard 等）。没有移除任何内容。

无需使用任何托管服务，托管服务也无法改变判定结果。本地核心，可选托管服务准确列出了可选组件会发送的内容及发送位置。

辅助命令

目标	命令
排定变更影响范围的优先级	solumbe impact . "add refund handling" --top 12
评估意图与执行的一致性	solumbe converge "add refunds" --path . --base HEAD --staged
精确评估已提交的变更	solumbe converge "add refunds" --path . --base HEAD~1 --head HEAD
跨仓库判定产品变更	solumbe workspace-gate ../web ../api --request "ship change"
根据历史评估风险标记	solumbe calibrate . --window 30
根据历史评估路由层级	solumbe regret . --window 30 --offline
使用相同答案重新评估已保存的运行记录	solumbe regret --rescore run.json
评估 Agent 体验	solumbe ax . "add a new MCP tool"
推荐模型层级	solumbe route . "add a new MCP tool"
使用模型读取来完善上下文	solumbe context "add a new MCP tool" --path . --online
检查单个仓库	solumbe repo . --json
构建代码映射	solumbe map . --json
为本地项目编制索引并进行搜索	solumbe index ~/projects --discover then solumbe search "events controller"
生成 Agent 框架	solumbe harness . --out .solumbe/harness.md
运行 MCP 服务	solumbe mcp

每条命令都支持 --json，solumbe help 会列出全部命令及其标志。

MCP

Solumbe 提供一个基于 stdio 的 MCP 服务，公开 14 个工具：repo_inspect、repo_map、repo_index、repo_search、context_pack、change_impact、agent_experience、model_route、convergence_score、review_context、review_gate、review_verdict、workspace_report 和 repo_harness。

{
  "mcpServers": {
    "solumbe": {
      "command": "npx",
      "args": ["-y", "@bashbop/solumbe", "mcp"]
    }
  }
}

solumbe install --host all 会为你写入此条目，并使用绝对路径，因此即使宿主未继承你的 shell PATH，也能启动它。已在 MCP Registry 中发布，名称为 io.github.BASHBOP/solumbe。仓库映射查询使用外部的按用户隔离的缓存，绝不会写入正在检查的仓库。Claude Code、Claude Desktop、Codex、Cursor、VS Code、Gemini CLI 和 Kimi Code 的宿主专属设置见 MCP 和 Agent 工作流。

对比

方案	优势	solumbe 的不同之处
Sourcegraph / Cody 上下文	强大的托管代码搜索，以及跨组织的基于嵌入的上下文	以本地为先且结果确定：无需服务端或账户，代码不会离开本机，且相同查询始终生成相同的数据包
手写的 CLAUDE.md / 规则文件	精心整理、意图丰富的指导	手写上下文会过时；solumbe 每次运行都会根据实际代码（符号、导入、路由、测试）重新生成上下文，并补充简短的 CLAUDE.md
grep / ripgrep	快速、通用的文本匹配	solumbe 会根据任务意图，跨路径、符号、导出和测试为整个文件排序，然后添加模式和验证命令，生成上下文数据包，而非匹配行列表

文档

完整的命令参考、Agent 工作流、发布流程、评估方法，以及信任层背后的设计论点：

bashbop.github.io/solumbe

贡献

git clone https://github.com/BASHBOP/solumbe.git
cd solumbe && npm ci && npm run ci

npm run ci 是完整的质量关卡：格式检查、lint、类型检查、版本检查、测试、覆盖率门槛（行覆盖率 70% / 分支覆盖率 60% / 函数覆盖率 75%）、三个评估语料库、依赖项审计，以及打包 tarball 冒烟测试。请求评审前请先运行。

请从 CONTRIBUTING.md 和行为准则开始。所有变更都需要维护者评审；main 分支要求通过质量关卡并解决所有讨论。Solumbe 遵循语义化版本规范，因此请说明 PR 属于无影响、补丁、次要还是主要变更。

---

工具链的一部分

solumbe 是构成 AI 辅助开发确定性信任层的四种工具之一。每种工具都使用静态分析来回答人们总是交给大模型的问题。

• solumbe（本工具），用于上下文：这项变更实际影响了什么？
• tieline，用于契约：前端和后端是否在不知不觉间不再一致？
• bouncer，用于合规：你能否为此向 Ofcom 作出合理解释？
• aiglare，用于治理：模型在哪些地方可能做出无法撤销的操作？

更多信息见 segunolumbe.com。静态分析，而非模型。