Agent Recall Trail

ART — Agent Recall Trail

ART は、コーディングエージェント向けのローカルファーストなメモリおよびガバナンス付きナレッジ製品です。各エージェントには、物理的に分離された専用の Recall Trail が用意されます。安定した結論は不変の Knowledge Edition となり、ほかのエージェントは非公開のソース識別情報やソース本文を見ることなく取得できます。

ART 0.3.7 は、stdio MCP 経由で Codex と DeepSeek Harness (DSH) をサポートします。単独で動作し、AAA アダプター、クラウド同期、同梱モデル、自律的な公開は必要ありません。

製品の境界

• 非公開メモリは、1 つのプロセスに紐付いたエージェント ID に属します。
• 共有ナレッジには、コミットされ、レビュー済みのエディションのみが含まれます。
• エージェントは、記録、想起、閲覧、フィードバックの提供、提案の作成、ガバナンスの申請を行えます。
• 人間によるガバナンスは、ART のローカルページで行います。明示的に有効化された、既定では無効のローカル委任ポリシーでは、曖昧さのない 1 つの指示により、承認と公開を原子的に行うこともできます。これらの操作には AgentDelegated と表示され、Human と表示されることはありません。
• Codex の選択的な自動メモリは、そのページにある、マシン全体に適用される別個の既定では無効のスイッチで制御します。許可されたターンごとに、範囲が限定された非公開 Candidate を最大 1 件作成します。共有ナレッジを公開することはありません。
• 取り消し、置換、アーカイブ、保証は、引き続き人間が行う操作です。
• 保存されたコンテンツは証拠であり、実行可能な指示でも、認可でもありません。

段階的な想起

ART は、4 つの明示的な取得モード lexical、full_scan、semantic、hybrid を備えた単一の想起 API を提供します。既定のモードは常に lexical です。簡潔な route リクエストで、範囲を限定した recall の前に関連する非公開および共有トピックを特定できます。正確な本文は read でのみ返されます。

• lexical は、ローカル BM25 に加え、完全一致、トークン、Jieba、CJK バイグラムのシグナルを使用します。
• full_scan は、ガバナンスの対象となるすべての正規レコードをランク付けします。埋め込みサービスは不要で、網羅性を重視する小規模なストアを対象としています。
• semantic は、明示的に設定された埋め込みエンドポイントと、破棄可能なローカルベクトル投影のみを使用します。
• hybrid は、所有者が設定できるバージョン管理された融合ポリシーを通じて、語彙的ランクと意味的ランクを組み合わせます。オプションのプロバイダーまたは投影を利用できない場合、ART は変更されていない lexical の結果を返し、フォールバックを報告します。

ART のオプションの埋め込みアダプターは、ユーザーが提供し、運用します。ART は、エンドポイントに互換性があるという理由だけで、モデルを同梱、ダウンロード、トレーニング、選定したり、品質を主張したりすることはありません。

クイックスタート

cargo build --release --locked
./target/release/art --home /an/explicit/art-home init --confirm
./target/release/art --home /an/explicit/art-home agent create --id codex-primary --host codex
./target/release/art --home /an/explicit/art-home doctor --agent codex-primary --json

Codex integration または DSH desktop/CLI integration を使用して、紐付けられた stdio 子プロセスを 1 つ起動します。デスクトップ用のエクスポートには、MCP パッチと自己完結型のスキルが含まれます：art integration dsh --desktop --agent <id> --apply --output <new-directory>。オペレーター用 CLI を確認するには、art --help を実行してください。

インストール

ネイティブアーカイブと SHA256SUMS を 最新リリースからダウンロードしてアーカイブを検証し、展開したバイナリを使って付属のインストーラーを実行してください。

bash scripts/install.sh --binary /absolute/path/to/art --confirm
art --version
art doctor --agent codex-primary --json

インストーラーは、実行ファイルのバイト列を ~/.across/bin/art に保持し、~/.local/bin/art に検出用リンクを作成して、所有者だけがアクセスできる ART データを初期化します。Codex や DSH の設定は編集しません。薄型の Codex プラグインは plugin/agent-recall-trail にあり、その MCP 子プロセスは codex-primary に恒久的に紐付けられます。移行やナレッジの公開を行う前に、運用ガイドを参照してください。

ART 0.3.7 では、中立的な Hook プロンプトによるオプトイン方式の選択的な自動メモリー、Agent と Hook で共有される価値判断の指針、上限付き予算、独立して検証されたエビデンス、意味的類似性に基づくレビューへの振り分け、可視化された診断機能が追加されています。また、正確でアクセス可能な提案レビュー用ワークスペース、8 種類の標準ソースアンカー、永続的な委任ガバナンス、互換性のあるクライアント向けに分離された Elicitation、制限されたホストでのプラグイン検出、段階的な振り分け、ガバナンス下でのフルスキャン、オプションのセマンティックおよびハイブリッドアダプター、決定論的な Knowledge Vault バックアップ、ローカルレビュー権限の暗号化された復元、検証済みの空のホームへの復元、再現可能な語彙的 BEIR ゲートも維持されています。専用のプライベート Git リポジトリを作成する前に、運用ガイドを参照してください。

設定の優先順位は、--home、次に --config <file>、続いて所有者のみがアクセスできるユーザー設定 ~/.across/config/art/config.json、最後に組み込みの ~/.across ルートです。ルート設定で受け付けるのは schema と home のみです。オプションの埋め込み設定は <ART_HOME>/config/art/embedding/default.json に分離されています。オプションのランク融合ポリシーは <ART_HOME>/config/art/retrieval/fusion.json にあり、必要な場合のトークンは、別の所有者限定ファイルに保存されます。

自動メモリーの設定は <ART_HOME>/config/art/auto-memory.json に別途保存されます。設定が存在しない場合や読み取れない場合は無効になります。認証済みのガバナンスページを操作するユーザーのみが変更できます。MCP ツールは状態を読み取れますが、有効化はできません。このスイッチは共有ナレッジの委任とは独立しており、想起や明示的な art_memory_capture リクエストには影響しません。

Agent Reliability Toolkit

ART は、小規模なローカルファーストの信頼性ツールキットを構成する独立した要素の 1 つです。

• Agent Recall Trail は、非公開の Agent メモリーを、レビュー済みの共有ナレッジと分離して保持します。
• Agent Runtime Proof は、実行中の Agent または MCP ランタイムが、承認したアーティファクトと一致することを検証します。
• Agent Residue Evidence は、テストやビルドの後に残った、タスク単位のファイル、プロセス、待ち受けポートを記録します。

各プロジェクトは個別にインストールでき、それぞれ独自の信頼境界を維持します。

コミュニティからのフィードバック

実際の Codex と DSH による評価は、特に役立ちます。インストールが完了したら、簡潔な検証済みインストールレポートに記録できます。より詳細に評価する場合は、設計パートナー向け Issueで、合成または編集済みのワークフローを共有してください。ホストと ART のバージョン、試した操作、確認した結果を含めてください。DSH ユーザーは公式コミュニティディスカッションにも参加できます。認証情報、非公開のナレッジ、またはトランスクリプト全体は投稿しないでください。

ドキュメント

• アーキテクチャ
• メモリとナレッジモデル
• 運用
• セキュリティモデル
• テストと受け入れ
• アーキテクチャ上の決定
• 独立した設計レビュー

すべての自動テストまたは手動テストでは、明示的にタスクが所有する ART ホームを使用する必要があります。ART は Codex または DSH の設定を自動的に変更することはありません。

Apache-2.0 ライセンスです。セキュリティ、 貢献、サポートをご覧ください。