CONTINUUM バナー

CONTINUUM: 長時間実行される AI エージェントのための検証可能な意味的リカバリ。 セマンティックチェックポイント（会話のダンプではない）、重複する副作用を拒否する冪等なアクション台帳、 そしてハッシュチェーンによる改ざん証跡ログを、デフォルトで拒否する MCP サーバーとして公開。フレームワーク非依存、Python 3.11+。

Python 3.11+ PyPI License Pydantic v2 Website Demo CI 状態 Coverage

CONTINUUM ウェブサイトを見る

Build with Ona

CONTINUUM がエージェントの復旧に役立ったなら、リポジトリにスターを付けてください。他の人が見つけやすくなり、良い first issue が届き続けます。

English | 简体中文 | Español | 日本語 | Português | 한국어

--- ## 目次 [なぜ](#なぜ) · [クイックスタート](#クイックスタート) · [仕組み](#仕組み) · [CONTINUUM の位置づけ](#continuum-の位置づけ) · [機能](#機能) · [セキュリティ拡張](#セキュリティ拡張) · [実証的検証](#実証的検証) · [MCP 統合](#mcp-統合) · [フレームワーク統合](#フレームワーク統合) · [コアコンセプト](#コアコンセプト) · [アーキテクチャ](#アーキテクチャ) · [API と CLI](#api-と-cli) · [ロードマップ](#ロードマップ) · [CONTINUUM ではないもの](#continuum-ではないもの) · [関連研究](#関連研究) · [ステータスと制限](#ステータスと制限) · [コントリビューション](#コントリビューション) · [ライセンス](#ライセンス) --- ## なぜ 現代の AI エージェントは長時間タスクを実行します（数百回の LLM 呼び出し、ツール呼び出し、ファイルやデータベースへの書き込み）。クラッシュしたとき、従来の対応はすべてを最初から再生することであり、これは作業を重複させ、副作用を重複させ、トークンを浪費し、意思決定を失わせます。 CONTINUUM はより狭く、より難しい問いを立てます。エージェントはタスク状態のコンパクトな意味的表現から再開しつつ、その状態が現在の環境で依然として有効であることを独立して検証できるか。その差別化は三つの部分にあります。 - **セマンティックチェックポイント**：エージェントが継続するために必要なコンパクトでバージョン管理された表現であり、会話のダンプではない。 - **独立した環境の再検証**：各チェックポイントコンポーネントは再開前に現在の環境に対して検証され、陳腐化は依存グラフを通じて伝播する。 - **来歴を意識した状態**：すべての事実はその起源をたどることができ、エージェントが報告した進捗が自己認証されることは決してない。 ## クイックスタート PyPI に `continuum-agent` 0.1.2 として公開。`pip install continuum-agent` を実行（固定する場合は `pip install continuum-agent==0.1.2`）。リリースタグではビルド済み wheel が [GitHub Releases](https://github.com/Cyrax321/CONTINUUM/releases) に添付される。 ゼロセットアップのパス（クローンもインストールも公開も不要）： | パス | 方法 | |:--|:--| | PyPI からインストール | `pip install continuum-agent==0.1.2` してから `continuum --help` | | クラッシュリカバリを端から端まで見る | `docker run --rm ghcr.io/cyrax321/continuum` | | Docker 経由で CLI を使う | `docker run --rm ghcr.io/cyrax321/continuum continuum --help` | | クローンせずに CLI を実行 | `uvx --from git+https://github.com/Cyrax321/CONTINUUM.git continuum --help` | | Windows PowerShell（クローン内） | `powershell -ExecutionPolicy Bypass -File .\try-it.ps1` または `powershell -ExecutionPolicy Bypass -File .\try-it.ps1 cli --help` | | ノートブックで同じリカバリを見る | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Cyrax321/CONTINUUM/blob/main/examples/demo.ipynb) | | 同じノートブックを Binder で | [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/Cyrax321/CONTINUUM/HEAD?labpath=examples%2Fdemo.ipynb) | | ブラウザで完全な開発環境 | [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/Cyrax321/CONTINUUM?quickstart=1) | Docker イメージは CI によって `main` への各 push と各リリースタグで GHCR に公開される（`.github/workflows/docker-publish.yml`）。Codespace は `.devcontainer/` で定義される。ノートブックは [examples/demo.ipynb](examples/demo.ipynb) です。最初のセルはインポート失敗時にのみ CONTINUUM をインストールするため、1つのファイルが Colab、Binder、クローンのいずれでも動作します。 ```bash git clone https://github.com/Cyrax321/CONTINUUM.git cd CONTINUUM uv venv && source .venv/bin/activate # macOS / Linux; Windows: .venv\Scripts\activate # コントリビューター（推奨）：ライブラリ + CLI + すべてのテストツール + すべてのアダプター uv pip install -e ".[dev]" # または必要なものだけを選ぶ：.（最小）、[mcp]、[otel]、[langgraph]、 # [openai]、[langchain]、[attest]、[postgres] # またはクローンを完全にスキップ： uv pip install git+https://github.com/Cyrax321/CONTINUUM.git uv pip install "continuum-agent[mcp] @ git+https://github.com/Cyrax321/CONTINUUM.git" ``` > **pip フォールバック：** 上記のすべてのコマンドで `uv pip install` を `pip install` に置き換えてください。 検証： ```bash continuum --help # CLI エントリーポイント continuum-mcp --help # MCP サーバーエントリーポイント（[mcp] または [dev] が必要） pytest -q # 最小環境で約 3950 件収集、約 3,636 件通過、約 41 件スキップ（正確な数は異なる） ruff check src/ tests/ examples/ && ruff format --check src/ tests/ examples/ mypy src/continuum # CI が強制する三つのゲート ``` コアライブラリは一つのランタイム依存（`pydantic>=2.7`）のみを持ち、残りはすべてオプションである。完全なパッケージマップ、extras 行列、Postgres テスト設定、コマンドごとの検証は [references/install.md](references/install.md) にある。 ### コーディングエージェントを2分で接続 Claude Code、Gemini CLI、または Codex の場合、Python を書く必要もプロンプトファイルも不要である。 ```bash continuum start my-task --goal "エージェントにやらせたいこと" continuum hooks install claude-code --with-gate # 同様に：gemini、codex ``` それ以降、エージェントが書き込むすべてのファイルはハッシュチェーン証拠としてキャプチャされ、セッション開始時に自動的に状態ブリーフィングが入り、`.continuum/gate.json` に登録された未請求の副作用は実行前に拒否され、どんなクラッシュ後の新しいセッションも実行可能な次のステップで再開する。CLAUDE.md は不要である。 最小限のライブラリ例。記録とリカバリ： ```python from continuum import EventType, Run, SQLiteStorage, project store = SQLiteStorage("agent.db") store.create_run(Run(run_id="run_4821", goal="10,000 ドキュメントを分析")) store.append_event( "run_4821", EventType.RUN_STARTED, {"goal": "10,000 ドキュメントを分析", "total": 10_000} ) for i, doc in enumerate(documents): analyze(doc) store.append_event("run_4821", EventType.WORK_COMPLETED, {"doc": i}) # クラッシュ後、新しいプロセスは停止した場所から正確に再開する： state = project("run_4821", store.read_events("run_4821")) print(state.progress.completed) # すでに完了、繰り返さない print(store.verify_events("run_4821").ok) # True、クラッシュ後もチェーンは無傷 ``` **自分で証明を実行：** ```bash python examples/crash_recovery_agent.py # 実際のプロセスキル、実際の副作用 python examples/context_compaction.py # トランスクリプト喪失、チェックポイントは生存 python examples/model_switch.py # モデル A が死亡、モデル B が安全に引き継ぎ python scripts/mcp_smoke.py # 実際の子プロセス、実際の JSON-RPC トラフィック ``` `e2e-autonomy-test/` キットは実際の請求書バッチタスク、実行中のハードキル、そして新しい再開セッションをスクリプト化し、その後 outbox、台帳、イベントチェーンを帯域外で採点する。実行 1 は実際の Claude Code セッションで **7/7 のメカニクス** を獲得した。完全なウォークスルーは [references/e2e.md](references/e2e.md) にある。 ## 仕組み CONTINUUM は **LLM コンテキスト**（一時的）と **永続的なタスク状態**（永続的）を分離する。会話履歴を保存する代わりに、継続するために必要な最小限の検証済み情報であるセマンティックチェックポイントを構築する。 ![CONTINUUM の仕組み](docs/assets/architecture.svg) 詳細な説明、投影モデル、リカバリコンテキストは [references/architecture.md](references/architecture.md) にある。 ## CONTINUUM の位置づけ 四つの関心事が長時間実行されるすべてのエージェントで重なる。CONTINUUM は最後の一つだけを所有し、他の三つには明示的な継ぎ目を通じて触れる。競合を名指しすることも、提供済みモジュールや公開済みスイートが既に印字していない主張をすることもない。 | レイヤー | 問いに答える | 接続方法（提供済みモジュールまたは公開済み出力） | |:--|:--|:--| | Harness | エージェントはどのようにツールを呼び出し目標に向かって進むか | CONTINUUM の外。接続点は `src/continuum/adapters/generic.py`（`GenericAgentAdapter`）、`src/continuum/adapters/thin.py`（CrewAI、AutoGen、Pydantic AI フック）、`src/continuum/mcp/server.py`（MCP stdio）、`src/continuum/hooks.py` と `src/continuum/clienthooks.py`（コーディング CLI ライフサイクルフック）、`src/continuum/gateway.py`（任意の言語向け強制 HTTP プロキシ）、`src/continuum/otel.py`（OpenTelemetry ブリッジ）で提供。レシピは `docs/recipes/` と `references/adapters.md` にある。 | | 耐久実行 | クラッシュ前に何が起こり、何が失われずに再生できるか | ハッシュチェーンイベントログ `src/continuum/events.py` と `verify()` と `trusted_through`、永続ストレージ `src/continuum/storage/sqlite.py`（WAL、`synchronous=FULL`、schema v6）と `src/continuum/storage/postgres.py` に加え `src/continuum/storage/migrations.py`、ポリシー駆動チェックポイント `src/continuum/checkpoint/manager.py` と `src/continuum/checkpoint/policy.py` が `restore()` でギャップを再生。ウォークスルーは `docs/recovery_walkthrough.md`（`examples/recovery_walkthrough.py` の出力）にある。 | | コントロールプレーン | どの実行がアクティブで、誰がそれに作用でき、出力はどこへ行くか | 実行レジストリと親子階層 `src/continuum/storage/` と `src/continuum/recovery/family.py`（`continuum tree`）、allowlist 認可 `src/continuum/mcp/authz.py`（`CONTINUUM_MCP_MUTATING_CLIENTS` / `CONTINUUM_MCP_TOKEN`）、表示面 `src/continuum/dashboard/app.py` と `src/continuum/serve/server.py`、CLI `src/continuum/cli/main.py`（`continuum runs`、`continuum tree`、`continuum health`）。 | | 検証基盤 | 時刻 T のチェックポイントと今の世界が与えられたとき、継続しても安全かつ正確か | `src/continuum/state/validator.py`（陳腐化 `dependency -> evidence -> finding -> decision` に加え `PlanStep.depends_on`）、`src/continuum/provenance_map.py`（`Origin` から `REQUIRES_REVIEW` まで `REVIEW_CONFIRMED` まで）、`src/continuum/actions/ledger.py` と `src/continuum/actions/idempotency.py` および `src/continuum/gate.py` / `src/continuum/gateway.py`（実行前にクレーム、重複を拒否し、照合のために `UnknownSideEffect` を送出）、`src/continuum/replayguard.py`（ポータブルガード）、`src/continuum/pinning.py` と `src/continuum/replay_similarity.py`（再生の正確性）、`src/continuum/budgets.py`（リトライ上限）、`src/continuum/recovery/engine.py` + `src/continuum/recovery/contract.py` + `src/continuum/recovery/planner.py` + `src/continuum/recovery/observations.py`（最大深刻度 `RESUME < ... < ABORT`、`evidence` / `reason` / `next_allowed_action` / `human_steps` を持つ密封契約）、`src/continuum/checkpoint/rewind.py`（アトミックな二重状態巻き戻し）、`src/continuum/analysis/prefix_trust.py`（助言的信頼）。公開済みチェック：`docs/recovery_walkthrough.md`、`benchmarks/fault_injection/`（`detection_rate` / `unsafe_resume_rate` を印字するスイート）、`src/continuum/benchmark/phase6/`（リカバリ正確性スイート）、`docs/RESULTS.md`、そして下の再生成可能なビジュアル。 | 上記の各行は、タグ付けされたコミット時点で `main` に存在するパスに追跡可能である。この表ではベンチマーク数値を再掲しない。ベンチマークはそれらを既に印字したスイート出力の中にのみ生きる。公開済みスイートと設計文書の完全なリストは `docs/research.md` にある。 ### クラッシュリカバリ、実際に 下の画像はモックではない。`python demo-run/generate_crash_visual.py` の出力であり、`demo-run/worker.py` をドキュメント 399 で `os._exit(9)` まで実行し、`continuum resume --env dataset=v4` を呼び出して拒否パス（`REQUEST_HUMAN`、`safe:false`、exit 21）を示し、不確かな副作用を探査で調停し、同じデータベースから再開して重複作業なしで完了する。トランスクリプトは監査用に `docs/assets/crash-recovery.txt` としても保存される。 再生成： ```bash python demo-run/generate_crash_visual.py # または：python scripts/generate_crash_visual.py ``` ![クラッシュリカバリ：バッチ途中のハードキル、拒否、調停、再開](docs/assets/crash-recovery.svg) コード付きの完全なウォークスルーは `docs/recovery_walkthrough.md`（`examples/recovery_walkthrough.py`）にある。最小の bench harness は `references/bench.md`（`continuum benchmark`）にある。 ## 機能 | 機能 | 得られるもの | |:--|:--| | セマンティックチェックポイント | コンパクトでバージョン管理され、検査可能な状態。トランスクリプトのダンプではない | | 冪等なアクション台帳 | 重複する外部副作用を拒否し、不確かなものを照合のために浮かび上がらせる | | 環境の再検証 | 各チェックポイントコンポーネントは再開前に現在の世界に対して検証される | | 来歴を意識した状態 | エージェントが報告した進捗は `REQUIRES_REVIEW` と印付けされ、自己認証されることはない | | リカバリエンジン | 決定的で密封された次アクション契約を持つ七つのリカバリモード | | デフォルトで拒否する MCP サーバー | 十二のツール、読み取りと変更の分離、呼び出し元 allowlist | | フレームワークアダプター | 汎用 Python、OpenAI Agents SDK、LangGraph、LangChain 統合 | | 安全な計画ループ | 二信号の観測検証が高リスク分岐を REQUIRES_REVIEW に昇格させる | | 周期的な再検証 | 環境はスケジュールに従って再チェックされ、実行中のドリフトを一周期以内に捉える | | 改ざん証跡ログ | ハッシュチェーンイベントログ（55 種のイベントタイプ）と完全性検証 | | 強制ゲート | 未請求の副作用呼び出しは実行前に拒否され、拒否メッセージがクレームプロトコルを教える | | 観測フック | コーディング CLI が書き込むすべてのファイルはダイジェスト検証された証拠となり、モデル制御の外にある | | セッションブリーフィング | 新しいセッションは開始時に実行状態を決定的に学ぶ。前のセッションの推論サマリーを含む | | 調停プローブ | 登録されたコマンドは不確かな副作用を自動的に決着させ、人間は残りのみを見る | | 実行可能なガイダンス | Resume と validate は次のステップを実行可能なコマンドとして描画し、状態としてではない | | 強制 HTTP ゲートウェイ | 任意の言語からの外向き呼び出しはクレームを要し、応答は実際のステータスコードから決着する | | OpenTelemetry ブリッジ | 本番トレーシングからのツール呼び出しスパンがゼロコード変更で証拠になる | | アクションインデックス | 実行を跨ぐ冪等性検索はインデックス化された読み取りであり、全ログスキャンではない | | バージョンピン留め | 呼び出し元が主張した prompt、ツール、モデルハッシュがクレームごとに保存され、ドリフトは再開時に表面化する | | リトライ予算 | アクションタイプごとの試行上限がクレーム時に強制され、エージェントは残り試行回数を見る | | マルチエージェントの親子 | 親の再開は家族の最悪状態を合成し、不確かな子が親をブロックする | | 情報付きリトライ | エンジンが作成した失敗サマリーがリカバリ後の再開に注入される | | フォークセマンティクス | 発散する継続は新鮮な権限を持つ子実行に分岐する | | ログ圧縮 | アンカー前の接頭辞は verbatim でアーカイブされ、ライブログは数ヶ月にわたる実行でも有界に保たれる | | 消費済み付与の追跡 | 一度きりの権限参照は終端状態で消費済みとして印付けされ、復元後の再利用は拒否される（`GRANT_DENIED`）。チェックポイント復元パスでの権限復活を防御する | | チェーン証明 | `continuum attest` は Ed25519 で実行のチェーンヘッドに署名し、外部検証者が既知の鍵で履歴が改ざんされていないことを証明できる | | HITL ダッシュボード | 監査が CLI と同等の確認、照合、完了ボタン | ## セキュリティ拡張 二つの加算的なセキュリティ拡張がリカバリとチェックポイント基盤の上に位置する。它们は再開、再生、または既存のクラッシュ時再検証パスを変更しない。 - **安全な計画ループ**：観測は来歴を持ち、二つの独立した信号で検証される（`verified` / `unverified` / `contested`）。未検証または競合する観測によってガードされた計画分岐は `REQUIRES_REVIEW` に昇格する。決定は台帳に `PERCEPTION_OBSERVED` と `BRANCH_RESOLVED` イベントとして追記される。 - **周期的な再検証**：リカバリエンジンをステップ間隔（デフォルト 25）とアプリ切り替え時に再利用し、実行中の環境ドリフトを一周期以内に捉える。次のクラッシュまで待たない。 [docs/PROBLEM.md](docs/PROBLEM.md)、[docs/RESULTS.md](docs/RESULTS.md)、[STATUS.md](STATUS.md) を参照。 ## 実証的検証 CONTINUUM はモックの単体テストだけでなく、実際の LLM エージェント、ライブのプロトコル境界、ハードなプロセスクラッシュに対して検証される。 - **実際のエージェント**：実行中に `SIGKILL` された Claude Code による複数セッションの請求書バッチ。メカニクスで 7/7 を獲得。再開セッションは `continuum_resume` を照会し、二段階台帳で副作用を経路付け、検証済み書き込みの重複を拒否し、`request_human` を尊重した。ライブテストはプロンプトドリフトの重複排除ギャップを露わにし、`ActionLedger.claim()` における正規パス正規化とトークンベースのフォールバックで閉じられた。 - **サードパーティクライアント**：Gemini CLI と Kilo Code が stdio JSON-RPC でライブ SQLite ストアに対して接続し、マルチエージェント共存と認可の分離を検証。 - **プロトコル準拠**：`@modelcontextprotocol/inspector --cli` でプロセス死を跨いで端から端まで駆動。変更ツールはデフォルトで `CONTINUUM_MCP_MUTATING_CLIENTS` の背後で拒否され、外部クレームは `REQUIRES_REVIEW`（`safe: false`）に降格する。 - **自己修復**：ハードキルされたサーバーは起動時に一度だけのリトライで孤立した SQLite `-wal`/`-shm` サイドカーをクリーンアップして回復する。 - **スケール**：約 2,809 件のテストが収集され（約 2,775 が通過、残りはオプションサービスなしでスキップ）、Python 3.11、3.12、3.13 で実行（unit、`hypothesis` によるプロパティベース、並行性、敵対的）。CONTINUUM-Bench は五つのクラッシュシナリオに加え専用の argument-drift シナリオを実行し、CONTINUUM について 0 の重複作業と 0 の重複副作用を、単純な再生については完全な重複を測定する。さらに 14 シナリオのリカバリ正確性スイート（`continuum.benchmark.phase6`）が耐久実行サーベイのクラッシュポイントを実行可能なアサーションとして符号化する。 - **敵対的監査**：完全な MCP 面がライブプロトコル上で監査され、三つの欠陥が見つかり修正された。手法と再現手順は [test.md](test.md) にある。 ## MCP 統合 CONTINUUM は MCP サーバーを提供する。エージェントはライブラリを埋め込むことなく進捗を記録し、チェックポイントを作成し、副作用を台帳経由で経路付けできる。 ```bash uv pip install -e ".[mcp]" CONTINUUM_MCP_MUTATING_CLIENTS=your-client-name continuum-mcp ``` stdio 経由の十二のツール。三つは読み取り専用（`continuum_validate`、`continuum_resume`、`continuum_list_actions`）、九つは変更する。副作用は二段階（クレーム、実行、完了）であり、変更ツールはデフォルトで allowlist の背後で拒否される。エージェントが報告した状態は来歴 `Origin.EXTERNAL_AGENT` で記録され `REQUIRES_REVIEW` と印付けされる。 検証の詳細（起動時のクラッシュリカバリや Claude Code による端から端のテストを含む）は [references/mcp.md](references/mcp.md) にある。登録済みサーバーが `CONNECTION_CLOSED` を報告した場合、原因はほぼ常に `PATH` 解決でありサーバー自身ではない。[docs/api/mcp.md](docs/api/mcp.md#troubleshooting) に診断と二つの是正策がある。 ## フレームワーク統合 九つのアダプターが `src/continuum/adapters/` に提供される（一つのインプロセスファサードに加え八つの統合）。すべてオプションインストールのためコアは標準ライブラリのみのままである。 | アダプター | クラス | 備考 | |:--|:--|:--| | 汎用 Python エージェント | `GenericAgentAdapter` | インプロセスファサード。信頼できる（`Origin.DETERMINISTIC`）状態を書き込む。 | | ファイルシステムサンドボックス | `FilesystemSandboxAdapter` | ローカルディレクトリサンドボックス。外部サービスなし。ドキュメントと CI のデフォルト。 | | Python インプロセス | `PythonInProcAdapter` | 一時作業ディレクトリで Python を実行し、台帳経由で記録する。 | | コンテナ | `ContainerAdapter` | Docker ベース。`docker` 不在時はガード付きスキップ。 | | ブラウザ | `BrowserAdapter` | Playwright ベース。未インストール時はガード付きスキップ。 | | Kubernetes | `KubernetesAdapter` | `kubectl` ベース。未設定時はガード付きスキップ。 | | OpenAI Agents SDK | `OpenAIAgentAdapter` | 実験的。`ToolContext` / `RunHooks` にフック。オプション `openai-agents`。 | | LangGraph | `LangGraphAgentAdapter` | 実験的。`StateGraph` をラップ。オプション `langgraph`。 | | LangChain | `LangChainAgentAdapter` | 実験的。LCEL `Runnable` パイプラインと `create_agent` ツール呼び出しループに `checkpoint_node` を落とす。オプション `langchain`。 | 各アダプターは台帳経由で進捗を記録し、二段階のインターセプトと完了プロトコルで外部効果を経路付ける。三つのフレームワークアダプターはすべて端から端の統合テストを持ち、**ライブの OpenRouter モデル** に対して駆動され、その実行で LLM 引数ドリフトの重複排除ギャップと二つの OpenAI アダプター欠陥（アダプターごとのライブのハードクラッシュ（副作用の最中の `os._exit(137)`）証明を含む）が露わになり閉じられた。完全な使用法、ライブモデル結果、実行可能な例は [references/adapters.md](references/adapters.md) にある。 本番の LangGraph アプリはネイティブな永続化 API を維持することもできる。`make_continuum_checkpointer(storage)` は LangGraph の `BaseCheckpointSaver` を CONTINUUM ストレージ上で実装する。したがって各 put は同じハッシュチェーンで来歴タグ付けされたイベントログに着地する（[references/adapters.md](references/adapters.md) を参照）。 さらに三つの本番フレームワークが [`adapters/thin.py`](src/continuum/adapters/thin.py) の SDK 不要な薄いフック面でカバーされる。 | フレームワーク | インターセプト面 | エントリーポイント | |:--|:--|:--| | CrewAI | グローバルなツール呼び出し前後のフック | `install_crewai_hooks(storage, run_id)` | | AutoGen core | `FunctionTool.run_json` をその場でラップ | `wrap_autogen_tool(tool, storage, run_id)` | | Pydantic AI | 非同期 Hooks ケーパビリティ | `Agent(capabilities=[wrap_pydantic_ai_hooks(storage, run_id)])` | これらのいずれにも届かないスタックでは：`continuum gateway` が任意の言語からの外向き HTTP にクレームを強制し、`continuum.otel.make_span_processor(storage)` が既存の OpenTelemetry ツールスパンを証拠に変え、`continuum serve` が MCP ツールと同じ操作を言語非依存の JSON ワイヤプロトコルで公開する（stdio、または `--transport http` による HTTP と `CONTINUUM_SERVE_TOKEN` 認証）。 ### エージェントまたは MCP が報告した実行の再開 MCP 経由、または OpenAI アダプター経由で報告された状態は来歴 `Origin.EXTERNAL_AGENT` を持ち、`request_human` に解決されるまで確認されない。LangGraph と LangChain の実行は `Origin.DETERMINISTIC` を使い直接再開する。レビューをクリアして再開するには： ```bash continuum confirm # REVIEW_CONFIRMED を記録し、再評価する continuum resume # 今度は RESUME を報告する ``` MCP 上では同等物が `continuum_confirm` ツールの後の `continuum_resume` である。確認は一回限りの人間による証明イベントであり、自己認証の安全性の逃げ道である。したがって外部駆動の実行が永続的に詰まることはない。 ## コアコンセプト 各コンセプトの深いリファレンスは [references/concepts.md](references/concepts.md) にある。 - **セマンティックチェックポイント**、エージェントが継続するために必要なコンパクトでバージョン管理された表現。 - **状態検証**、各コンポーネントが独立して検証され、陳腐化は依存グラフを通じて伝播する。 - **冪等なアクション台帳**、外部副作用が追跡され重複排除され、不確かな結果は静かに再試行されるのではなく送出される。 - **リカバリモード**、`RESUME`、`REPAIR_AND_RESUME`、`ROLLBACK`、`WAIT`、`REQUEST_HUMAN`、`ABORT`（さらに `REPLAN`）。 - **リカバリ契約**、決定的で完全性が封印され、ゲートされた次のアクション。 ## アーキテクチャ CONTINUUM は一つの不変条件を中心に構成される。**すべての事実はその起源を持ち、信頼は得られるものであり、決して仮定されない。** なぜこれがスタートアップにとって重要か。数週間実行されるエージェントはコンテキストが失われたときに作業を失ってはならず、トークンやコストを浪費したり、同じツールを二度発火させてはならない。 ### システムを一望、汎用アダプター、単一ログ、任意のハーネス 任意のハーネスが同じハッシュチェーンログに接続する。同じ実行を Claude Code が書き込み、LangGraph が再開し、CLI が検査し、ダッシュボードで承認できる。フレームワークの協力を必要としない。 ```text Claude Code ─┐ Gemini CLI ──┤ Codex ───────┤ LangGraph ───┼── 5 つの継ぎ目 ──► 単一の耐久ログ ──► リカバリ + ダッシュボード + CLI LangChain ───┤ （ハッシュチェーン、 （密封された契約、 OpenAI SDK ──┤ 来歴タグ付け、 検証、健全性、 CrewAI ──────┤ 厳密に一度） ファミリー） 任意の HTTP ──┤ 任意の OTel アプリ┘ 継ぎ目：1 インプロセス 2 MCP 3 CLI フック 4 ゲートウェイ 5 OTel ``` ### 三つの保証（デモがそれぞれを証明する） 1. **自己認証なし。** エージェントが報告した状態は `EXTERNAL_AGENT` であり、人間による `REVIEW_CONFIRMED` まで `REQUIRES_REVIEW` に降格する。信頼できる書き込みだけが `DETERMINISTIC` 状態を生む。 2. **副作用はクレームを要する。** すべての外部効果は発火前に冪等な台帳でクレームされる。未請求の効果は境界でブロックされ、重複は拒否され、不確かな結果は照合のために送出される。 3. **リカバリは現実に対して検証する。** 再開は安全と言う前にファイルダイジェスト、依存バージョン、モデル同一性をチェックする。陳腐化は `dependency -> evidence -> finding -> decision` に加え `PlanStep.depends_on` で伝播するため、影響を受けたステップだけが修復される。 ### 五つの統合の継ぎ目 | 継ぎ目 | 接続方法 | 得られるもの | |:--|:--|:--| | 1 インプロセス | `GenericAgentAdapter.intercept_action(...)` と `wrap_tool(key_fn=...)`（LangChain、LangGraph、OpenAI Agents SDK 向け） | Python フレームワーク、信頼できる書き込み | | 2 MCP サーバー | `continuum-mcp` 12 ツールを stdio 経由（`continuum_record_progress`、`continuum_intercept_action`、`continuum_complete_action` など） | 任意の MCP 対応クライアント、3 読み取り専用 + 9 変更、allowlist `CONTINUUM_MCP_MUTATING_CLIENTS` | | 3 CLI ライフサイクルフック | `continuum hooks install claude-code --with-gate`（`gemini` と `codex` も） | コーディング CLI：`SessionStart briefing`、`PostToolUse observe`、`PreToolUse gate`、CLAUDE.md 不要 | | 4 強制 HTTP ゲートウェイ | `continuum gateway --port 8765` と `.continuum/gateway.json` | 任意の言語、任意の外向き HTTP はクレームを要し、ゲートウェイは実際のステータスコードから決着させる | | 5 OpenTelemetry ブリッジ | `make_span_processor(storage)` | 任意のトレース済みアプリ、スパンが `TOOL_COMPLETED` 証拠になる | CrewAI、AutoGen、Pydantic AI 向けの薄いフック面は SDK なしで `adapters/thin.py` に存在する。 ### 強制パイプライン、なぜ重複も無効な呼び出しもないのか ゲートから観測へのパイプラインがハーネス境界の隙間を閉じる。これがトークンとコストを節約し、無効なツール呼び出しをブロックするものである。 ```text PreToolUse フック PostToolUse フック | | v v continuum gate continuum observe | | |-- クレームなし？拒否（exit 2） |-- TOOL_COMPLETED イベント： | + クレーム手順 | パス、バイト、現時点のディスク上の sha256 | | |-- 有効なクレームあり？許可 |-- ディスク検証状態： | | 検証済み / 変更済み / 欠落 v エージェントが効果を実行 | v continuum_complete_action （現実から決着、報告からではない） | v 台帳は COMPLETED と印付けされ、次回の再生は二度目の発火ではなくキャッシュされた結果を返す ``` 未知のホストはフェイルクローズで拒否され、オープンリレーではない。Shell `Bash/curl` は文書化された v1 の盲点である。 ### リカバリ決定木、数週間が終わるまで、正確かつ厳密に エンジンは最も慎重な信号を採用する。したがって安全性が利便性に負けることは決してない。 ```text RESUME < REPAIR_AND_RESUME < REPLAN < WAIT < REQUEST_HUMAN < ROLLBACK < ABORT ``` 各 `continuum resume` は密封された契約を返す。内容はリカバリ状態と `safe`、検証済みと無効化されたコンポーネント、実行可能な `human_steps`（実行すべき正確な shell）、チェックポイント後の観測のディスク検証、ピン留めのドリフト、そしてマルチエージェントの `continuum tree` 向け家族集約である。ブリーフィング `continuum briefing` は新鮮な `claude` SessionStart ごとにその契約を注入する。したがって端末を kill した後に `hi` と言っても最後の良いプレフィックスから再開する。 ### なぜこれがトークン、コスト、無効な呼び出しを節約するのか * **トークン：** セマンティックチェックポイントは `Goal + Plan + Progress` を保存し、トランスクリプトのダンプではない。ブリーフィングは検証済み状態に加え上限 4096 の推論サマリーだけを提供し、次のセッションを劣化させることが示されているエラーテールを渡さない。情報付きリトライ `recovery/summary.py` は生の履歴ではなくエンジンが作成したサマリーを注入する。 * **コスト：** 台帳 `action_index` は相対パスと絶対パスのような引数ドリフトがあっても重複する副作用を拒否する（`invoice:INV-001` は安定したキー）。したがって同じ API が再開後に二度支払われることはない。予算 `budgets.py` はクレーム時にリトライの嵐を上限付ける。`continuum benchmark` は continuum に対して `0 重複`、単純なものに対して `50` と印字する。 * **無効な呼び出し：** ゲート、ゲートウェイ、`replayguard` の `langgraph_protected_node` は未請求または再生されたツール呼び出しを実行前にブロックする。ピン留め `pinning.py` は再開時に prompt やツールのドリフトを表面化させる。 ### ストレージアーキテクチャ スキーマ v6。SQLite がプライマリ、Postgres は CI で検証済み。一つのログ、多くの投影。 | テーブル | 目的 | |:--|:--| | `events` | ハッシュチェーンの追記専用ログ（55 種のイベントタイプ） | | `runs` | 親子用の `parent_run_id` を持つ実行メタデータ | | `versions` | チェックポイントごとの SemanticState スナップショット | | `checkpoints` | `RECOVERY` アンカーを持つ密封されたチェックポイント記録 | | `action_index` | 実行を跨ぐ冪等性投影（schema v3+）、インデックス化された読み取りであり全スキャンではない | | `events_archive` | 圧縮された接頭辞ストレージ（schema v5+）、`continuum compact` が数ヶ月にわたる実行のためにライブログを有界に保つ | | `lg_checkpoints` / `lg_writes` | LangGraph ネイティブ永続化（schema v4+）、`make_continuum_checkpointer(storage)` | ### モジュールマップ、一つのライブラリ、多くの面 CONTINUUM は一つのライブラリ（`src/continuum`、132 モジュール）に加え大規模なテストスイート（186 テストファイル、約 2,809 テスト）である。すべてのモジュールは一つのハッシュチェーンイベントログに追記し再生する。 | モジュール | 役割 | |:--|:--| | `events.py` | 追記専用でハッシュチェーンのイベントログと `verify() trusted_through` | | `state/` | 投影 `project()`、検証、抽出、陳腐化の伝播 | | `storage/` | `SQLiteStorage` v6、`postgres.py`、`migrations.py`、`actionindex.py` | | `actions/` | 冪等な台帳 `claim/complete/reconcile`、`idempotency.py` キーと正規化とトークンフォールバック、消費済み付与の追跡 `GRANT_DENIED` | | `checkpoint/` | ポリシー駆動チェックポイント `manager.py` `policy.py` と `RECOVERY` アンカーと `prune` | | `recovery/` | エンジン、プランナー、密封契約 `contract.py`、`guidance` `human_steps`、`observations` ディスク検証、`family` ロールアップ、`fork` セマンティクス、`summary` 情報付きリトライ | | `gate.py` | ツール前強制：台帳クレームに対する許可または拒否 | | `gateway.py` | 強制 HTTP プロキシ：外向きリクエストのために実行前にクレーム | | `replayguard.py` | ポータブルガード：`evaluate, protected_call, langgraph_protected_node`、ACRFence の再生ハザードを閉じる | | `hooks.py` `clienthooks.py` | 共有チェックポイントフックとインストーラープロファイル `claude-code gemini codex` | | `budgets.py` | アクションタイプごとのリトライ予算レジストリと評価 | | `pinning.py` | 再開時のバージョンピン留め正規化とドリフト検出 | | `replay_similarity.py` | 再生とフォークのための意味的類似性バックエンド exact/fuzzy/embedding | | `reconcilers.py` | 自動決着のためのプローブレジストリ `.continuum/reconcilers.json` | | `adapters/` | 9 つのクラスアダプター + 薄いフック `thin.py` CrewAI AutoGen Pydantic AI + LangGraph ストア | | `mcp/` | 12 の stdio ツールに加え認可 `authz.py` トークン認証、allowlist、確認トークン | | `serve/` | Sidecar stdio JSON ワイヤ + HTTP `CONTINUUM_SERVE_TOKEN` | | `dashboard/` | Web ダッシュボード `app.py` `hitl.py` と HITL ボタン確認、照合、完了、接頭辞信頼助言、ピン留め | | `cli/` | 55 の argparse コマンド、終了コードが評決、`runs, start, inspect, resume, verify, health, tree, benchmark, attest, dashboard` | | `otel.py` | OpenTelemetry スパンプロセッサーブリッジ | | `benchmark/` | CONTINUUM-Bench ハーネス、5 つのクラッシュシナリオ + 引数ドリフト + 14 シナリオのリカバリスイート | ### 正直な制限 - ゲートはシェルコマンドの内部を見ることができない（Bash や curl は構造化されたツールクレームを回避する） - Postgres バックエンドは CI でテストされているが本番で鍛えられていない - `request_human` 通知のための webhook 外向きはまだない（#305） - v1 では一層のマルチエージェント階層のみ - 大きなペイロードのオフロード（#254）はまだ未実装 - 数週間スケールのベンチマークとトークンコスト表はボード #550（#568 から #570）に着地する 完全なリファレンスは [references/architecture.md](references/architecture.md) にある。そしてこの上に構築される数ヶ月平面、来歴因果グラフ、権限の復活、許容性、活性はボード #550 とその 20 のサブ issue #551 から #570 として固定されている。 ## API と CLI Python 面（`EventType`、`Run`、`SQLiteStorage`、`diff_states`、`project`）とアダプター API は実行可能な例とともに [references/api.md](references/api.md) に文書化されている。CLI は同じ面をシェル形式にしたものである。 ```bash continuum runs # 実行を一覧表示 continuum inspect # 意味的状態 continuum validate --env dataset=v4 # 検証、読み取り専用 continuum resume --env dataset=v4 # リカバリ決定 + 契約 + 次のステップ continuum checkpoint # チェックポイントを強制、変更する continuum actions # 外部副作用 continuum reconcile # プローブで不確かな効果を決着させる continuum complete # キーボードから実行を完了として閉じる continuum verify # イベントハッシュチェーンを再監査 continuum budget # アクションタイプごとのリトライ予算使用量 continuum compact # アンカー前のログ接頭辞をアーカイブ continuum tree # 親 + 子とリカバリ状態を表示 continuum attest --key signer.pem # 外部検証者のためにチェーンヘッドに署名 ``` すべての配線はホスト側であり、モデルの協力は任意である。 ```bash continuum hooks install claude-code --with-gate # コーディング CLI：証拠、ブリーフィング、ゲート continuum gateway --port 8765 # それ以外すべてのための強制 HTTP プロキシ provider.add_span_processor(continuum.otel.make_span_processor(storage)) # OTel を証拠に continuum-mcp # MCP 対応のものなら何でも：十二ツールサーバー continuum briefing # セッション開始時のコンテキスト注入 continuum budget # リトライ予算使用量レポート continuum tree # マルチエージェント階層ビュー ``` オプションのレジストリはコードの傍らに存在し、データでありコードではない。`.continuum/gate.json`（副作用ツール + 安定キーテンプレート）、`.continuum/reconcilers.json`（外部システムをチェックするプローブ）、`.continuum/gateway.json`（上流ルート）。 ほとんどのコマンドはサブコマンドの **前** に置くグローバル修飾子 `--json` を受け付ける（例: `continuum --json resume RUN`）。サブコマンドの後に置くと拒否される。読み取り専用コマンドは実行状態を変更しない。`--repair` のない `resume` は、`.continuum/webhooks.json` が設定されていると `NOTIFICATION_SENT` / `NOTIFICATION_FAILED` イベントを追記することがある。終了コードは安全性契約である（検証済みで安全な実行のみが 0 で終了する）。完全なコマンドリスト、終了コード表、状態差分出力は [references/cli.md](references/cli.md) にある。 ## ロードマップ | フェーズ | コンポーネント | ステータス | |:--:|:--|:--| | 1-11 | データモデル、意味的状態、永続化、チェックポイント、検証、アクション台帳、リカバリエンジン、CLI、クラッシュリカバリ例、環境スナップショットと差分、フレームワークアダプター | 完了 | | 12 | ベンチマークスイート（CONTINUUM-Bench） | 完了（最小ハーネス） | | 13 | クラウド API（FastAPI + PostgreSQL） | 部分的：PostgreSQL ストレージバックエンドと HTTP sidecar トランスポート（`continuum serve --transport http`）は提供され CI テスト済み、ホストされたマルチテナントサービスは未開始 | | 14 | ダッシュボード | 完了（`continuum dashboard`） | | 15+ | 強制された耐久性：観測フック、ゲート、セッションブリーフィング、調停プローブ、強制ゲートウェイ、OTel ブリッジ、アクションインデックス、実行可能なガイダンス、マルチクライアントインストーラー、意味的再生検出、バージョンピン留め、リトライ予算、ログ圧縮、HITL 面、フォークセマンティクス、情報付きリトライ、マルチエージェント集約 | 完了（issue #213 を参照） | | 次へ | 数ヶ月スケールの耐久平面：マイルストーンに固定された計画（#312）、構造化された試行記憶（#313）、アトミックな二重状態巻き戻し（#292）、公開されたリカバリ正確性ベンチマーク（#293）、webhook 外向き通知（#305） | 計画中（ドラフト仕様は [docs/UPGRADE_SPEC.md](docs/UPGRADE_SPEC.md) にある） | 当初の計画を超えて、MCP サーバー、MCP 認可と呼び出し元認証レイヤー、来歴と反自己認証、コミュニティファイル、フォワードマイグレーションを伴うスキーマバージョニング、有界なリカバリコンテキスト、消費済み付与の追跡、Ed25519 イベントチェーン証明、ネイティブな LangGraph チェックポインター、そして `main` への各 push ごとの wheel 成果物が提供されている。[STATUS.md](STATUS.md) の検証済みと信じられているものの内訳と未解決の正確性バグを参照。 ## CONTINUUM ではないもの | これではない | むしろこれである | |:--|:--| | LLM | LLM を使用するエージェントのための信頼性レイヤー | | エージェントフレームワーク | 任意のフレームワークに差し込めるリカバリレイヤー | | ベクトルデータベース | 埋め込みではない構造化された意味的状態 | | RAG システム | 検証済みチェックポイントであり、検索拡張メモリではない | | ワークフローエンジン | リカバリレイヤーであり、オーケストレーターではない | コアの抽象化：`意味的状態 + 環境検証 + アクション照合 = 安全なリカバリ`。 ## 関連研究 CONTINUUM は耐久実行、冪等な副作用追跡、LLM エージェントのためのクラッシュリカバリの交差点に位置する。最も近い隣接領域は機械検証された再開契約（Khan 2026）、制約で保護された入場を伴うエージェントトランザクション処理（Mnemosyne 2026）、チェックポイントロールバック攻撃分析（ACRFence 2026）、設計レベルのプロンプトインジェクション防御（CaMeL 2025）である。完全な注釈付きリスト、基礎、引用監査は [references/related-work.md](references/related-work.md) にある。 ## ドキュメントマップ `docs/` 配下のすべてのページと、それぞれが存在する理由： - **リファレンスと API**: [docs/api/README.md](docs/api/README.md) （ライブラリ、CLI、MCP、サイドカー）、 [docs/GLOSSARY.md](docs/GLOSSARY.md) （すべての復旧用語、それぞれが実装を指す）、 [references/api.md](references/api.md)、[references/cli.md](references/cli.md)。 - **タスクガイド**: [docs/guides/README.md](docs/guides/README.md)、 [docs/recipes/README.md](docs/recipes/README.md)、[docs/concepts/README.md](docs/concepts/README.md)。 - **セキュリティ**: [docs/threat_model.md](docs/threat_model.md) （何が保護され、何が検出され、何が明示的に保護されないか）、 [docs/signing_key_rotation.md](docs/signing_key_rotation.md) （鍵付き封印をローテーションしながら、古いハッシュのみの契約の検証を壊さない方法）。 - **契約とスケール**: [docs/contract_compatibility.md](docs/contract_compatibility.md) （別のビルドで検証される封印済みの約束）、 [docs/multi_agent_isolation.md](docs/multi_agent_isolation.md) （共有 `run_id` の分離）、 [docs/audit-provenance-compaction-294.md](docs/audit-provenance-compaction-294.md) （圧縮を生き延びる来歴）。 - **作成と運用**: [docs/adapters_guide.md](docs/adapters_guide.md) （アダプターの書き方）、 [docs/cloud_api.md](docs/cloud_api.md) （任意のデプロイ層）、 [docs/TESTING_MCP.md](docs/TESTING_MCP.md) （MCP 表面の敵対的監査）、 [docs/CONTRIBUTING_ONBOARDING.md](docs/CONTRIBUTING_ONBOARDING.md) （オンボーディング）。 - **計画**: [docs/ARCHITECTURE_EVOLUTION.md](docs/ARCHITECTURE_EVOLUTION.md) （北極星）、 [docs/CONTINUUM_MASTER_PLAN.md](docs/CONTINUUM_MASTER_PLAN.md) （検証済みの現状と次の作業）、 [docs/research/README.md](docs/research/README.md) （それらの計画の原点となったノート）。 ## ステータスと制限 - **テスト済み**：このツリーの 2026-08-24 監査での完全な実行で 3,636 合格 + 23 スキップ。CI は Python 3.11、3.12、3.13 でスイートを強制し、カウントはプラットフォームや Postgres などのオプションサービスにより異なる（[STATUS.md](STATUS.md) を参照）。MCP 面もライブプロトコル上で敵対的に監査済み。[test.md](test.md) を参照。 - **PyPI では `continuum-agent` 0.1.2**（`pip install continuum-agent`、クローンは `pip install .` で依然として動作。クイックスタートを参照）。 - **MCP 呼び出し元認証はデプロイごとに任意。** `CONTINUUM_MCP_TOKEN` が設定されているとき、サーバーは呼び出し元が `initialize` ハンドシェイクの `_meta.authToken` でその共有秘密を提示しない限り、すべての変更ツールを拒否する。呼び出し元ごとの秘密は `CONTINUUM_MCP_CLIENT_TOKENS`（`name:secret` ペア）経由で利用可能。トークンが何も設定されていない場合、認可は宣言されたアイデンティティのみによる（歴史的なデフォルト、ローカルな単一ユーザー利用のために保持）。 - **MCP 経由で自己報告された状態を確認するには別の秘密が必要。** `continuum_confirm` はオペレーターが `CONTINUUM_MCP_CONFIRM_TOKEN` を設定するまで、すべての呼び出し元を拒否する。進捗を記録することを許されたエージェントがそれを確認することも許されてはならないからである。デフォルトのパスは人間に導かれたままである。ホストで `continuum confirm ` を実行する。 - **未構築のコンポーネント**：クラウド API（フェーズ 13）。 - **シェルコマンド強制のギャップ**：ゲートは構造化されたツール呼び出しに対してクレームを強制するが、Bash や curl コマンドの内部を見ることはできない。v1 スコープの拒否として文書化されている。 - **フレームワークアダプターは依然として実験的。** 三つのフレームワークアダプターはすべてライブモデルでのソフト再開とハードクラッシュの証明（OpenRouter、`gpt-4o-mini`）を持ち、不確かな副作用上での再開をブロックするクラッシュ契約を含み、汎用ファサードと同等のクラッシュと再開の検証テストを持つようになった（Refs #285）。本番のリカバリには `GenericAgentAdapter` を優先すること。 - **エージェントと MCP の実行は自動再開の前に明示的な確認を必要とする。** 外部から報告された状態は `REQUIRES_REVIEW` であるため、`continuum resume` は人間が確認するまで `request_human` を返す。設計によるものであり欠陥ではない。[フレームワーク統合](#フレームワーク統合) を参照。 - **e2e 自律テストシリーズ**（issue [#6](https://github.com/Cyrax321/CONTINUUM/issues/6)）：三回の完全な Claude Code 実行がメカニクスで 7/7 を獲得し、プロンプトなしの回復動作が観察された。多様なプロンプトスタイルにわたるさらなる反復は依然として開かれている。 ## について 2026 年初頭、長時間実行されるエージェントが推論ではなくリカバリで失敗するのを見た。チェックポイントは検証すべき証拠ではなく、継続するための証明として扱われていた。Temporal、LangGraph、ACRFence 2603.20625、self conditioning 2509.09677 を調査し、ギャップが移植可能な検証基盤であることを見つけた。それは、時刻 T の状態と今の世界が与えられたとき、継続しても安全かを問うものである。 三週間で私は一つの不変条件から CONTINUUM を構築した。すべての事実はその起源を持つ。結果は `verify()` を持つハッシュチェーンログ、安定したキー重複排除を持つ台帳、未請求の効果をブロックするゲートとゲートウェイ、そして契約を封印するリカバリエンジンである。五つの継ぎ目が同じログを Claude Code、LangGraph、LangChain、OpenAI、HTTP、OpenTelemetry に公開する。実際のキルと約 2,809 のテストで検証され、単純な再生が `50` と印字するところで `0 重複` と印字する。 CONTINUUM は **Anandhu P Shaji**（[@Cyrax321](https://github.com/Cyrax321) · [LinkedIn](https://www.linkedin.com/in/anandhupshaji/)）によって作成され、原作者によって保守されている。オープンソースであり [Apache-2.0](LICENSE) の下にある。コミュニティの貢献は [CONTRIBUTING.md](CONTRIBUTING.md) 経由で歓迎され、[AUTHORS.md](AUTHORS.md) と [graphs/contributors](https://github.com/Cyrax321/CONTINUUM/graphs/contributors) でクレジットされる。 ## コントリビューション このプロジェクトは Apache 2.0 の下でオープンソースであり、意図的に拡張可能に構築されている。リカバリセマンティクスを検証する研究者、台帳や MCP サーバーを他のフレームワークや言語に移植するエンジニア、計画されたロードマップを現実にする誰にとっても拡張可能である。良い出発点は [issue トラッカー](https://github.com/Cyrax321/CONTINUUM/issues) の `good first issue` ラベル、または STATUS.md にリストされた未解決の正確性バグである。 大きな PR を送信する前に issue を開いてください。完全なコントリビューションガイドは [CONTRIBUTING.md](CONTRIBUTING.md) を参照。 [Code of Conduct](CODE_OF_CONDUCT.md) と [セキュリティポリシー](SECURITY.md) を含む。 ### コントリビューター ## スポンサー CONTINUUM がエージェントの信頼できる回復に役立つなら、長期的な保守を支援するためにスポンサーを検討してください。

Sponsor Cyrax321

スポンサーになる、GitHub Sponsors、または FUNDING.yml にカスタムリンクを追加（他のプラットフォームを好む場合）。

## ライセンス Apache 2.0、[LICENSE](LICENSE) を参照。 --- 深いリファレンス資料： - [references/install.md](references/install.md) - 前提条件、インストールレベル、パッケージマップ、検証 - [references/concepts.md](references/concepts.md) - セマンティックチェックポイント、検証、台帳、リカバリモード、契約 - [references/architecture.md](references/architecture.md) - データモデル、イベントログ、投影、ストレージ、チェックポインティング、リカバリエンジン、セキュリティ - [references/adapters.md](references/adapters.md) - フレームワークアダプターの使用法とライブモデル検証結果 - [references/api.md](references/api.md) - Python とアダプター API - [references/cli.md](references/cli.md) - 完全な CLI コマンドリスト、終了コード、状態差分 - [references/mcp.md](references/mcp.md) - MCP サーバー状態、検証、未解決の問い - [references/bench.md](references/bench.md) - CONTINUUM-Bench 設計 - [references/quickstart.md](references/quickstart.md) - インストール、例、証明スクリプト - [references/e2e.md](references/e2e.md) - 端から端の自律テストウォークスルー - [references/testing.md](references/testing.md) - テストスイートの配置と規約 - [references/related-work.md](references/related-work.md) - 注釈付き関連研究と引用監査 ## クイックリンク - [Issues](https://github.com/Cyrax321/CONTINUUM/issues) バグ報告や新機能の要望 - [Discussions](https://github.com/Cyrax321/CONTINUUM/discussions) 設計や仕様の提案 - [リリースノート](docs/release-notes.md) - [リリースチェックリスト](docs/release-checklist.md)