Gnomon: エージェント向けに構築されたPostgresデータ用Git
Gnomon. Git for Postgres data, built for agents (github.com)
要約
Gnomonは、PostgreSQLデータベースのデータに対してGitのようなバージョン管理とブランチ機能を提供する拡張機能です。これにより、AIエージェントがデータベースの個別のブランチで安全に作業し、変更を追跡、レビュー、マージできるようになります。データベースのコピーを作成せず、既存のPostgresインスタンス内で動作するため、効率的で導入が容易です。
全文翻訳
Gnomon
エージェント向けに構築されたPostgresデータ用Git。 エージェントに、接続文字列以上のものとして、実際のデータベースのブランチを与えます。エージェントが変更したすべてのフィールドを確認し、適切であればメインブランチにマージし、そうでなければ元に戻すことができます。
Gnomonは、既存のPostgres内で動作します。拡張機能は1つで、コピーやセカンドデータベースは不要です。
create extension gnomon;
select gnomon.track('orders'); -- history starts now, no backfill
select gnomon.create_branch('agent/refunds');
select gnomon.use('agent/refunds');
-- Every query from here on runs on the branch
update orders set status = 'refunded' where id = 4182;
select * from gnomon.diff('agent/refunds'); -- every row and field it changed
select gnomon.merge('agent/refunds'); -- three-way, type-aware, conflicts as rows
select gnomon.undo_merge(1); -- and back
- ドキュメント: https://gnomon.bitsinfra.com/
- インストール: PostgreSQL 15-18(セルフホストまたはマネージド(RDS、Aurora、Supabase)で
create extension gnomonを実行します。インストールを参照してください。 - 初めての方へ: チュートリアルは10分で完了します。
本番環境のブランチを瞬時に作成
ブランチはメインからすべてを読み込み、変更されたものだけを保持するため、データベースのサイズに関わらず瞬時に開き、何もコピーしません。各エージェント実行、各プルリクエスト、各テストにブランチを提供します。
アプリケーションは変更されません。ブランチは接続文字列です。セッションをブランチに向ければ、そのセッションが実行するクエリはメインの代わりにブランチを読み書きします。
| 場所 | 方法 |
|---|---|
| セッション | select gnomon.use('feature') |
| 1つのトランザクション(プーラーの後ろ) | select gnomon.begin('feature') |
| 接続文字列 | gnomon branch url feature |
| Cモジュールを使用 | SET gnomon.branch = 'feature' |
| 過去の時点 | select gnomon.use('main', '2026-10-31 23:59') |
スキーマ変更も同様に引き継がれます。ブランチでマイグレーションを実行して列を追加したり、列名を変更したり、テーブルを作成したりしても、メインはマージされるまでそのままです。マージ時に新しい構造とそのデータが一緒に取り込まれます。
コードのようにデータをレビュー
各ブランチには差分(diff)が付属しています。変更前後の各行とフィールドを確認できます。ブラウザでレビューし、単一行にコメントを付け、競合を並べて解決できます。エージェントが完了すると、Gnomonがレビューを開き、リンクを送信します。
SQLで記述されたチェックを追加すると、Gnomonはマージが許可される前に、マージされた結果に対してそれらを実行します。承認は、あなたが確認した内容をカバーします。ブランチが後で変更された場合、再度レビューが必要になります。
データを理解するマージ
メインとブランチが同じ値を変更した場合、Gnomonは一方を選択するだけではありません。カウントは加算され、JSONはキーごとにマージされ、テキストは行ごとにマージされます。本当に競合するものは、人が解決するかクエリで解決するための競合となります。
ブランチ同士もマージできます。メインだけでなく、単一のトランザクションをあるブランチから別のブランチにピックアップすることも可能です。元に戻す(undo)も同様です。1つのトランザクション、エージェントがその日の午後に実行したことすべて、またはマージ全体を取り消すことができます。
いつでも、その時の状態のまま
Gnomonは、追跡しているすべてのテーブルの履歴を保持します。任意の時点でのデータベース全体を、既存のクエリで読み取り、常に同じ結果を得ることができます。エージェントが決定を下したとき、そのエージェントが何を見たかを正確に確認できます。
-- The open invoices at the end of October
select gnomon.use('main', '2026-10-31 23:59');
select sum(amount) from invoices where status = 'open';
同じ履歴がリアルタイムでKafka、NATS、またはWebhookにストリームされ、dbtには削除された行を保持するスナップショットとして取り込まれます。古い履歴はオブジェクトストレージに移動でき、クエリがそこまで到達するとGnomonがそれを復元します。
以前はパスしていたチェックが失敗するようになった場合、gnomon bisect はそれを壊したトランザクションを見つけ出します。誰が、いつ、なぜそれを実行したのかを特定します。
エージェントに安全に委任
1つのコマンドで、エージェントにデータベースロール、独自のブランチ、および接続文字列が提供されます。それがエージェントが必要とするすべてであり、どのようなツールで構築されていても構いません。エージェントはブランチを読み書きし、データベースはそれ以外のもの(エージェントが名前で要求した場合でも、メインを含む)を拒否します。
# A database role, a branch of its own and a connection string
gnomon agent create support-bot
- 許可したものだけをマージします。 マージは、選択したユーザー、または定義したルール内のエージェント(最大20行、これらのテーブルのみ、すべてのチェックをパスする)に対して行われます。Postgresは、エージェントが何を指示されても、それらを強制します。
- 承認されるまで何も送信されません。 エージェントがキューに入れたメール、Webhook、支払いは、マージされるまでブランチ上に留まります。
- すべての変更には名前が付けられます。 各変更には、エージェント、実行、およびその理由が記録されます。
- 見たものを再生します。 Gnomonは、すべての読み取りの瞬間を記録するため、再生するとエージェントが読み取った行とまったく同じ行が返されます。
- 一度にいくつかの方法を試します。 同じ時点から複数の試行を開始し、それらの変更とチェックを比較して、最良のものを保持します。
- 停止し、元に戻します。 1つのコマンドでエージェントをロックアウトし、ブランチを閉じ、マージされたものを新しいものから順に元に戻します。
- エージェントに対応済みです。 Gnomon MCPサーバーは、エージェントのマシン上またはHTTP経由で、スキーマを探索し、変更を保持せずに試行し、チェックポイントにブランチを巻き戻すことができます。
製品に組み込む
TypeScriptおよびPython SDKは、エージェントが実行する各タスクに独自のブランチを提供し、制限が事前に設定されています。それをマージするか、レビューに送信するか、そのままにするかを選択します。
import { Gnomon } from "@bitsinfra/gnomon";
import { nodePostgres } from "@bitsinfra/gnomon/pg";
const gnomon = new Gnomon({
app: nodePostgres(appPool), // your application's own login
runs: nodePostgres(runsPool), // one login shared by every agent run
});
// A branch for this task, discarded unless it's merged or submitted
await using run = await gnomon.startRun({
task: "Refund order 4182",
actor: "support-bot",
});
await run.sql("update orders set status = 'refunded' where id = 4182");
const { checks, changes } = await run.summary();
if (checks.passed && changes.rows <= 20) await run.merge();
else await run.submit({ title: "Refund order 4182" });
実行は、同じデータベースログインを共有していても、互いのブランチを読み取ることはできません。Anthropic SDK、Claude Agent SDK、Vercel AI SDK、OpenAI Agents SDK、LangChain、または任意のMCPクライアントなど、既存のエージェントフレームワークを使用できます。これらはすべて同じ少数のツールにバインドされ、1つの実行に紐付けられます。これらは、node-postgresやPrismaからpsycopgやDjangoまで、ドライバーやORMを通じて機能します。テストでは、各テストにシードされたデータベースの独自のブランチが提供されます。
npm install @bitsinfra/gnomon # TypeScript
pip install gnomon-postgres # Python
内容物
| 部品 | パス | 機能 |
|---|---|---|
| SQLコア | src/sql | 拡張機能:履歴、ブランチ、マージ、レビュー、有効時間、保持、アーカイブ。マネージドPostgresにインストールされます。 |
| Cモジュール | src/c | オプション:SET gnomon.branch によるルーティング、リアルな行ロック、ブランチでの ON CONFLICT および TRUNCATE、古い読み取りの検出、高速な書き込みとポイントリード。 |
| CLI、MCPサーバー、レビューアプリ | cli | 単一のGoバイナリ:gnomon branch/diff/merge/bisect/agent/migrate/serve/mcp/daemon/archive。 |
| SDK | sdk/ts, integrations/python | @bitsinfra/gnomon および gnomon-postgres:タスクごとの実行、レビュー、型付き差分、テストヘルパー。単一の 仕様 と準拠スイート。 |
| GitHubアクション | action | プルリクエストごとのデータベースブランチ、その上でのマイグレーション、コメントとしての変更。 |
| インテグレーション | integrations | Python、Node、Ruby、Go、Java、Elixir、.NET、PHP;PostgRESTおよびSupabase;dbtパッケージ。 |
| 例、コンテナ | examples, docker | チュートリアルのショップデータベースとすぐに使えるイメージ。 |
ドキュメント
すべて https://gnomon.bitsinfra.com/ にあり、同じページが docs にも存在します:
- インストール と チュートリアル
- コンセプト:ブランチ、座標、マージ
- エージェント、実行とSDK、MCPサーバー
- ブランチ、スキーマ変更、レビュー、マージ
- 履歴とタイムトラベル、変更フィード
- SQLリファレンス、CLIリファレンス、エラー
- 運用、セキュリティ、ベンチマーク
- コーディングエージェント向けのllms.txt
ライセンス
GnomonはPostgreSQLライセンスの下でオープンソースです。貢献を歓迎します。CONTRIBUTING.mdを参照してください。セキュリティの問題は、SECURITY.mdに記載されている通り、プライベートに報告してください。