Òtítọ́

Solumbe

変更を生成するのはモデルです。Solumbe は安全にマージできるかを検証します。

以前は Òtítọ́（@bashbop/otito）という名前でしたが、4.0.0 で名称を変更しました。CHANGELOG では、旧名称と新名称の対応をすべて確認できます。

Solumbe は、ローカル優先で決定論的、モデルに依存しない、AI 支援開発のための信頼レイヤーです。エージェントが編集する前にタスクに応じたリポジトリコンテキストを構築し、変更が実際にどこまで及ぶかを評価して、ステージ済みの正確なツリーに基づいてマージ可能かを判定します。サーバーもアカウントも不要で、コードがマシンの外に出ることもありません。

Claude Code、Codex、Cursor、Gemini などのネイティブなエージェントハーネスを置き換えるものではありません。それらと並行して動作し、その下でモデルが変わっても機能し続けます。

ローカルゲートを通過しても、自動的にマージが承認されるわけではありません。ホスト型 CI、GitHub のレビュー、CODEOWNERS、人間によるリリース判断は、それぞれ独立した権限を持ち続けます。

インストール

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

最後のコマンドは、検出されたすべてのエージェントホスト（Claude Code、Claude Desktop、Codex CLI、Cursor、VS Code、Gemini CLI、Kimi Code CLI）に Solumbe の MCP サーバーを接続します。まず設定内容を確認するには --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 では、declare: true を指定した change_impact と、intent を指定した review_gate を使用します。

コア

4つのコマンドが製品です。モデルを呼び出さず、ソケットを開かず、リポジトリ外のものを読み取りません。

手順	コマンド	何を示すか
編集前	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
エージェントエクスペリエンスを採点する	solumbe ax . "add a new MCP tool"
モデルのティアを推奨する	solumbe route . "add a new MCP tool"
モデルを使った読み取りでコンテキストを精緻化する	solumbe context "add a new MCP tool" --path . --online
1つのリポジトリを調べる	solumbe repo . --json
コードマップを作成する	solumbe map . --json
ローカルプロジェクトをインデックス化して検索する	solumbe index ~/projects --discover の後に solumbe search "events controller"
エージェント用ハーネスを生成する	solumbe harness . --out .solumbe/harness.md
MCP サーバーを実行する	solumbe mcp

すべてのコマンドで --json を指定でき、solumbe help にはフラグとともにすべてのコマンドが一覧表示されます。

MCP

Solumbe には、14 個のツールを公開する stdio MCP サーバーが付属しています：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 を実行すると、ホストがシェルの PATH を引き継がない場合でも起動できるよう、絶対パスを使ったエントリーが書き込まれます。MCP Registry では io.github.BASHBOP/solumbe として公開されています。リポマップの検索では、ユーザーごとの外部キャッシュを使用し、調査対象のリポジトリには書き込みません。Claude Code、Claude Desktop、Codex、Cursor、VS Code、Gemini CLI、Kimi Code 向けのホスト固有のセットアップについては、MCP とエージェントのワークフローをご覧ください。

比較

アプローチ	強み	solumbe との違い
Sourcegraph / Cody のコンテキスト	組織全体にわたる、強力なホスト型コード検索と埋め込みベースのコンテキスト	ローカル優先で決定論的です。サーバーもアカウントも不要で、コードがマシンの外に出ることもなく、同じクエリからは常に同じパケットが得られます
手書きの CLAUDE.md / ルールファイル	厳選された、意図が豊富なガイダンス	手書きのコンテキストは古くなります。solumbe は実際のコード（シンボル、インポート、ルート、テスト）から毎回コンテキストを再生成し、簡潔な CLAUDE.md を補完します
grep / ripgrep	高速で、汎用的なテキスト照合	solumbe はパス、シンボル、エクスポート、テストにわたってタスクの意図に基づきファイル全体を順位付けし、パターンと検証コマンドを加えて、該当行の一覧ではなくコンテキストパケットを生成します

ドキュメント

コマンドの完全なリファレンス、エージェントのワークフロー、リリースプロセス、評価方法、信頼レイヤーの設計理念については、以下をご覧ください。

bashbop.github.io/solumbe

コントリビューション

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

npm run ci はすべてのチェックを実行します。フォーマット、リント、型チェック、バージョンチェック、テスト、カバレッジの下限（行 70%／分岐 60%／関数 75%）、3 つの評価コーパス、依存関係の監査、パッケージ化した tarball のスモークテストが含まれます。レビューを依頼する前に実行してください。

まずはCONTRIBUTING.mdと行動規範をご覧ください。すべての変更にはメンテナーのレビューが必要です。main ではチェックの合格と会話の解決が必須です。Solumbe はセマンティックバージョニングに従っているため、PR が影響なし、パッチ、マイナー、メジャーのどれに該当するかを記載してください。

---

ツールチェーンの一部

solumbe は、AI を活用した開発のための決定論的な信頼レイヤーを構成する 4 つのツールの 1 つです。それぞれが静的解析を使って、人々が繰り返し LLM に尋ねている質問に答えます。

• solumbe（このツール）はコンテキストを扱います。この変更は実際には何に影響しますか？
• tieline はコントラクトを扱います。フロントエンドとバックエンドは、いつの間にか食い違っていませんか？
• bouncer はコンプライアンスを扱います。これを Ofcom に説明できますか？
• aiglare はガバナンスを扱います。モデルが取り消せない操作を実行できる箇所はどこですか？

詳しくは segunolumbe.com をご覧ください。モデルではなく、静的解析を。