gpp

gpp（git++）

AI エージェントは継続的にコードを変更しますが、コミットの間に行われた作業は失われてしまいます。また、コードベースについて記録しているメモ（CLAUDE.md、メモリーバンク、ナレッジファイル）は、コードが変わっても気づかれないまま古くなります。gpp は、そうした状況に対応するために構築されたバージョン管理システムです。すべての変更を発生時に記録し、意図と来歴を添えて精選された変更セットを昇格させ、プロジェクトのナレッジをリポジトリ独自の履歴上で管理します。そのため、コミットによってコードに関する認識が無効になった場合、gpp はそのコミットを特定できます。

（録画は scripts/demo.sh によって生成されます。決定論的で再現可能であり、モックアップは使用していません。）

30 秒で試す

cargo install gpp-cli

gpp init --graphex
echo "fn main() {}" > main.rs
gpp timeline                     # captured already — no staging, no commit
gpp promote -m "first cut" --intent feature
gpp diff HEAD                    # semantic diff: renames/moves are one op

そして、他の VCS にはない機能です。コードに関する認識を記録し、履歴によってそれを検証できます。

gpp belief add --claim "token expiry is 24h" --evidence src/auth.rs:7-7
# ...weeks of commits later...
gpp belief bisect "token expiry is 24h"
# INVALIDATED  cs:fhcpef7c  "raise token expiry to 7 days"
#  -     7 | pub const EXPIRY_HOURS: u64 = 24;
#  +     7 | pub const EXPIRY_HOURS: u64 = 168;

決定論的です。差分の共通部分と blob ハッシュを使い、LLM への問い合わせもネットワーク呼び出しもありません。（参考までに、保存されたメモが無効になったかどうかの判定を求められた場合、最先端モデルでもSTALE ベンチマークで正解率は 55.2% です。ここでは判定ではなく、履歴へのクエリで確認します。）4 言語、5 つのリポジトリにわたる実際の履歴で検証済みです。対象は axum 0.6→0.7、flask 1.1→2.0、clap 3→4、zod 3→4、go-redis 8→9 です。無効になった認識はすべて、ピン留めされ文書化された原因コミットまで二分探索でき、対照となる認識は維持されます。全体のマトリックスは demos/belief-bisect/ をご覧ください。

他との違い

• 継続的な記録。 高頻度のタイムラインで、すべてのファイル変更を記録します（SQLite WAL、デバウンス付きウォッチャー）。精選された変更セットは、明示的な意図、作成者の種類（人間／エージェント）、コスト記録とともに、そこから昇格されます。コミットの間に行われた作業も失われません。
• Graphex：バージョン管理された暗号化プロジェクトナレッジ。 アーキテクチャ、規約、決定、そして認識を、リポジトリ内の暗号化されたナレッジグラフで管理します。エージェントの信頼レベルに応じた階層制御があり、読み取りのたびに監査され、連携する履歴に照らして古さも確認されます。
• エージェントのガバナンス。 エージェントのIDと評判スコアリング、記録／昇格／同期時に適用されるコンプライアンス・アズ・コードのポリシー、異常検知、変更セットごとのトークン／コストの割り当てを標準機能として備えています。

その他の機能（Noise による P2P 同期、リプレイ、レビュー／RBAC、リレーノード、TUI）は、すべて基盤プラットフォームとして提供されます。詳細は docs/ARCHITECTURE.md をご覧ください。

Git は基盤であり、競合ではありません。 ブリッジ（gpp git-import／git-export／git-bridge）は実際の Git コミットを往復変換するため、GitHub や既存のワークフローはそのまま使えます。gpp のナレッジ、来歴、ガバナンスのレイヤーはその隣で機能します。上記の axum デモは、すべてこのブリッジを通じてインポートした履歴だけで動作します。

Claude Code（または任意の MCP クライアント）を接続する

gpp には MCP サーバーが付属しています。エージェントはナレッジグラフを照会できます（すべての認識に、新鮮さを示す情報一式――アンカー、以降のコミット、古くした変更セット――が付属します）。さらに、propose_belief で証拠に紐づく独自の認識を作成し（人間の承認後、履歴によって検証されます）、変更セットを提案し、コストを報告できます。リポジトリのルートにある .mcp.json に、次の内容を追加してください。

{
  "mcpServers": {
    "gpp": { "command": "gpp", "args": ["mcp-server", "--stdio"] }
  }
}

クライアントの完全な設定方法（Claude Desktop、汎用 stdio）と公開されているツールの一覧は、docs/MCP.md をご覧ください。

ステータス

ロードマップの全9フェーズ（0～8）が実装済みです。 各フェーズの成果物と 記録された相違点については docs/ROADMAP.md、優先順位付きのバックログについては docs/TODO.md、継続中のエンジニアリングログについては docs/WORKLOG.mdをご覧ください。

2026-08-23に確認済み：ワークスペースの184件のテストが合格し、cargo clippyと cargo fmtはクリーンで、ワークスペース全体をビルドできます。スタブのクレートは残っていません。すべての クレートに動作する実装があります。カバレッジはCIで計測しています （cargo llvm-cov。ベースラインでは行カバレッジ65.7％で、現在向上中です）。

テストの深さには依然としてばらつきがあります。基盤レイヤーは十分にカバーされており （gpp-core、gpp-graphex、gpp-diff、gpp-tuiは行カバレッジ80％以上。CLIには ポリシー適用、コストレポート、レビュアー割り当て、信念の二分探索のエンドツーエンドテストがあります）、一方で いくつかの統合クレートはスモークテストレベルにとどまっています（gpp-sdk、gpp-notify、gpp-rbac、gpp-replay）。 ここでいう「実装済み」とは、マイルストーンに対して構築・テスト済みという意味であり、 あらゆる箇所で徹底的に強化済みという意味ではありません。この差を埋めることが docs/TODO.mdの最優先項目です。

全レイヤー一覧

レイヤー	クレート	実装内容
ストレージ	gpp-core	コンテンツアドレス型ストア（BLAKE3 + zstd）、Blob/Tree、検証済みフレームの生転送
タイムライン	gpp-timeline	SQLite（WAL）によるキャプチャ、.gppignore、デバウンス付きウォッチャー、プルーニング
履歴	gpp-history	Changeset/Intent/Author、ブランチ参照、昇格、DAGウォーク
差分	gpp-diff	行単位 + tree-sitterによるセマンティック差分（Rust/Python/TS/Go）、名前変更・移動の検出
Gitブリッジ	gpp-git-bridge	git-import/git-export/git-bridge、SQLiteハッシュマップ
Graphex	gpp-graphex	暗号化された（age + AES-GCM）ナレッジグラフ、ティア制御付きプロジェクション、クエリ、ライフサイクル、監査、信念 + 古さの判定エンジン
SDK / MCP	gpp-sdk	AgentSession、gpp mcp-server --stdio（JSON-RPC MCP）
信頼	gpp-trust	評判スコアリング、ステータス遷移、オーバーライド、イベント
ポリシー	gpp-policy	.policy TOMLルール、昇格時（ブロック）+ タイムライン時（警告）+ 同期時（ブロック）の適用、組み込みテンプレート
コスト	gpp-cost	変更セットごとのトークン/$記録、予算、効率、エージェントによる自己申告
異常検知	gpp-anomaly	スコープ/バースト/サイズの検出、解決ワークフロー
同期	gpp-sync	Noise_XX P2P、オブジェクト/参照/ポリシー/graphex、フォーク保持
リプレイ	gpp-replay	再現可能な環境スナップショット + ドリフト差分
レビュー/RBAC/通知	gpp-review gpp-rbac gpp-notify	レビューのライフサイクル、ロール + ブランチ保護、イベント/受信トレイ/HMACウェブフック
リモート	gpp-remote	GitHub/GitLab/BitbucketのPR作成、情報を拡充した本文、CI/レビューの取り込み
リレー	gpp-relay	常時稼働の同期ハブバイナリ + ヘルスエンドポイント + Dockerfile
クライアント	gpp-cli gpp-tui gpp-deps	完全なCLI、ratatui TUI（gpp ui）、依存関係インテリジェンス（gpp deps + OSV）

そのほか：extensions/{gh-gpp,vscode-gpp,neovim-gpp}、GitHub Actions + GitLab CIテンプレート、deploy/ Dockerイメージ、packaging/ Homebrew。

記録済みの今後の対応（ROADMAP/TODOに記載済みで、ひそかに省略したものではありません）：deps向けレジストリ/ライセンスAPI、ネイティブPyO3/napiバインディング、 プラットフォームレビューの送信同期、apt/dpkgパッケージ。

インストール / ビルド

cargo install gpp-cli                    # the `gpp` binary (crates.io)
cargo install gpp-relay                  # relay node (optional)

# or from a clone
cargo build --release
cargo test --workspace
cargo bench -p gpp-core -p gpp-diff      # criterion perf suite

Linux、macOS（ARM + Intel）、Windows向けのビルド済みバイナリは 各リリースに添付されています。 cargo install --git https://github.com/mahabubul470/gpp gpp-cliでは 未リリースの開発版を追跡できます。

さらに試す

# Governance
gpp policy template secrets-scan
gpp trust show
gpp audit --include-cost --include-graphex

# Decentralized: sync two repos over Noise
gpp sync serve 127.0.0.1:9473             # on peer A
gpp sync add a 127.0.0.1:9473 && gpp sync # on peer B

# GitHub-compatible
gpp remote setup --platform github --repository acme/webapp
gpp remote pr-create --base main

プロジェクトの背景についてはCLAUDE.md、仕様全体 （アーキテクチャ、データモデル、CLI、プロトコル、ロードマップ）については docs/、ユーザーガイドとチュートリアルについてはdocs/book/をご覧ください。

ライセンス

MIT