Witness Evidence

エージェントシステム向けオープンエビデンスレイヤー

あなたのエージェントは行動できます。Witness は、何が決定され、どのエビデンスが添付され、次のエージェントが何を引き継げるかを保存します。

AI エージェントは行動できます。Witness はその作業に説明責任をもたらします。

エージェントはソフトウェアの労働力になりつつあります。しかし、彼らが受け入れた真実は、依然としてチャットログに閉じ込められていることがあまりにも多いのです。プランナーが方向性を選び、ビルダーが「完了」と報告し、バリデーターが後から到着し、次のモデルはなぜ誰かがその結果を信頼したのかを再構築しなければなりません。

Witness Evidence は、エージェントプラットフォームおよび AI インフラストラクチャエンジニア向けです。彼らのエージェント、モデル、トレースは、受け入れられたプロジェクト状態を保存する能力よりも速く成長しています。Witness は、アイデンティティに紐づく決定、添付されたエビデンス、結果、ライフサイクル変更、および制限付きプロジェクトコンテキストを MCP を通じて記録します。

真実を委任せずに、実行を委任する。

v0.1.0 コアの実際のローカルデモを実行 · 現在動作しているものを確認 · 機能ロードマップを探索 · 証明ステータスを検査

Related MCP server: Clockchain Developer Tools MCP Server

Witness の位置づけ

MCP connects agents to tools.
A2A connects agents to agents.
Traces show what ran.
Durable runtimes keep workflows alive.
Witness preserves what was decided, which evidence was attached, which status transitions followed, and what the next agent may inherit.

Witness は、エージェントランタイム、トレーシング、オーケストレーション、Git、または可観測性を置き換えるものではありません。実行の詳細の上に、永続的なエビデンス境界として位置します。つまり、チームが実行した決定、生成した結果、エビデンス参照、各ステータス遷移を実行したアイデンティティ、および後続のエージェントが回復を許可されるコンテキストを記録する場所です。

失敗モード

共有エビデンスレイヤーがなければ、マルチエージェントシステムは自信に満ちたトランスクリプトの山になります。

Planner:   “Build the release.”
Builder:   “Done.”
Validator: “Which bytes? Which requirements? Why this design?”
Next run:  “I have no context from the previous chat.”
Owner:     reconstructs everything by hand.

永続化すべきオブジェクトは会話ではありません。目撃されたプロジェクト状態であるべきです。

現在動作しているもの

バージョン 0.1.0 は、ローカルでオープンソースのエビデンスコアを実行します。

• プロジェクト、決定、インサイト、結果、レコード、ライフサイクル、制限付きコンテキスト、および FTS5 検索のための 10 個の MCP ツール。

• 正確なツール、リクエストペイロード、テナント、プロファイル、ランタイム生成、およびノンスにバインドされた署名付きエージェントアイデンティティエンベロープ。

• ロールベースのデフォルト拒否アクセスと冪等なミューテーション。

• 永続化前のプライバシー編集。

• トランザクション付き追記専用操作監査を備えた SQLite 永続化。

• 別々のビルダーとバリデーターアイデンティティを使用した実際のローカルフロー。

• 再現可能な Apache-2.0 リリースアーティファクトと、段階的な新規インストールドクター。

含まれているデモでは、別の合成バリデーターアイデンティティが結果を verified に移します。この遷移は、そのアクターとその理由を記録します。バージョン 0.1.0 は、ビルダー/バリデーターの分離を強制せず、公開読み取りプロジェクションを通じて結果の based_on エビデンス参照を公開せず、参照されたアーティファクトを取得せず、正確性を自動的に判断しません。これは自動エビデンス検証ではありません。

システムの動きを見る

sequenceDiagram
    actor Owner
    participant Planner
    participant Builder
    participant Validator
    participant Witness
    participant NextAgent as Next agent / model

    Owner->>Planner: Ship a validated release
    Planner->>Witness: Record decision + acceptance rule
    Planner->>Builder: Build exact candidate
    Builder->>Witness: Record outcome + evidence reference
    Validator->>Witness: Read decision and outcome
    Validator->>Witness: Accept or dispute the result
    NextAgent->>Witness: Restore bounded project context
    Witness-->>NextAgent: Decision + outcome + acceptance state

リポジトリには、実際のローカル MCP フローが含まれています。一時データベースを作成し、別々の署名付き合成ビルダーとバリデーターアイデンティティを使用し、決定と結果を書き込み、結果を recorded から verified に移し、プロジェクトコンテキストを復元します。

[1/3] Decision recorded: require independent validation
[2/3] Outcome verified by a distinct validator identity
[3/3] Project context restored from the database
WITNESS_DEMO_PASS decisions=1 outcomes=1 outcome_status=verified distinct_validator=true context_restored=true

エビデンスクラス: 実際のローカル製品フロー。 デモは、合成資格情報を使用して公開 MCP サーバーと永続化レイヤーを実行します。クラウドのスクリーンショット、シミュレートされた応答、または外部統合の証明ではありません。

実際のデモを実行

git clone https://github.com/MaximilianoColoma/witness.git
cd witness
uv sync --locked
uv run python examples/coordinated_autonomy_demo.py

期待される最終行:

WITNESS_DEMO_PASS decisions=1 outcomes=1 outcome_status=verified distinct_validator=true context_restored=true

これが可能にすること

説明責任のあるビルダー

ビルダーは作業を生成でき、別のアイデンティティが後でレビュー遷移を実行できます（デモで示されています）。チームは、Witness がその不変条件を追加するまで、必要なビルダー/バリデーター分離を独自のポリシーで強制する必要があります。

モデルに依存しない継続性

モデルを交換し、プロセスを再起動し、来週再開します。後続のエージェントは、古いトランスクリプトをリバースエンジニアリングする代わりに、制限付きプロジェクトオブジェクトを取得できます。

エビデンスを意識したゲート

決定、結果、レシート、およびステータス遷移は、CI、リリースガバナンス、インシデントレビュー、および人間の承認に対するクエリ可能な入力になります。

境界のあるメモリ

Witness はトランスクリプトダンプや汎用 RAG ストアではありません。宣言されたプロジェクトオブジェクトを永続化し、永続化前にサポートされている PII を編集し、読み取りを制限し、未宣言の権限を拒否します。

通常の製品呼び出しが簡単に書き換えられない監査

公開コアのミューテーションと監査イベントは、すべてまたはまったくコミットされません。正規のトリガーは、通常のアプリケーションパスを通じて操作履歴の更新と削除を保護します。

次に構築するもの

クロスモデルプロジェクト継続性

次の開発者機能は、ポータブルな継続性コントラクトです。Claude、Codex、GPT、ローカルモデル、および専門エージェントが、同じ制限付き Witness プロジェクト状態を使用し、元のチャットにアクセスせずに作業を継続できるようにする必要があります。

これは計画中であり、まだ外部で証明されていません。証明には、別のエージェントチームが現在の決定、添付されたエビデンス、および受け入れ状態を再構築する必要があります。再構築時間と失敗ケースを測定する必要があります。EVIDENCE.md を参照してください。

Claude、Codex、OpenAI Agents SDK、LangGraph、または Temporal 用のファーストパーティアダプターは v0.1.0 には含まれていません。現在、これらのシステムは、インテグレーターが構築したカスタム MCP/クライアント配線を通じてのみ Witness に到達できます。文書化された参照アダプターはロードマップの作業であり、現在の機能ではありません。

ノーススター

Witness は、エージェント組織がエージェント、モデル、実行、システムを超えて決定し、証明し、学んだことを保持するためのオープンなエビデンスおよび学習インフラストラクチャになることを目指しています。

そのノーススターには、ポータブルな検証と検証済み学習リターンが含まれます。受け入れられた結果は、未検証のテキストが暗黙的にポリシーになることを許可せずに、後の作業に情報を提供する可能性があります。これは v0.1.0 では自動クロスモデル学習ではありません。

2製品アーキテクチャ

Mission は別の製品です。Spindle は Witness 内の計画された学習機能です。

Mission はエージェントの作業を調整します。Witness はエビデンスを保存し、検証済み学習を複利化するように設計されています。

flowchart LR
    H["Human<br/>goal and direction"] --> M["Mission<br/>coordinates"]
    M --> G["Specialist agents<br/>work"]
    G --> E

    subgraph W["Witness"]
        E["Decision · Outcome · Evidence"] --> S["Spindle<br/>planned learning function"]
        S --> L["Patterns · Rules · Guards"]
    end

    L -. "future governed return" .-> M

エビデンスコアは現在実行されています。完全な Spindle 学習ループは計画中です。 Witness 内での将来の役割は、Witness の verified ライフサイクルステータスにある結果を取得し、追加の適格性とレビューゲートの後、それらを管理された学習候補、再利用可能なパターン、ルール、および将来の Mission 実行のためのガードに変換することです。ステータスは受け入れ遷移を記録します。それ自体が、Witness が基礎となるエビデンスを取得または独立して検証したことを証明するものではありません。バージョン 0.1.0 は、これらのアーティファクトを生成したり、自動的にフィードバックしたりしません。

夢の機能

これらは、バンドルされたオーケストレーションではなく、有効なパターンです。

• トランスクリプトアクセスなしのクロスモデル継続性。

• 外部バリデーターがビルダーのナレーションを信頼せずに検査できるポータブルな証明。

• Witness 内の計画された内部学習機能である Spindle を通じた検証済み学習リターン。

• 永続的な決定チェーンを備えた所有者が読み取れる自律性。

• 受け入れられた根本原因と防止を後のミッションに引き継ぐインシデントメモリ。

すべてのトークンは、システムを以前よりも価値のあるものにして去るべきです。 これは製品の方向性であり、現在の効率性や経済的主張ではありません。

Mission と Witness は 2 つの主要製品です。Mission は作業を調整し、Witness はエビデンス境界と計画された Spindle 学習機能を所有します。v0.1.0 には自動の Witness から Mission への学習リターンは含まれていません。

現在構築されているもの — そしてまだ構築されていないもの

このリポジトリによってサービスはデプロイされていません。公開とグリーン CI は、本番運用、スケール、節約、またはユーザーへの影響を証明するものではありません。

公開 MCP サーフェス

正規のコントラクトは spec/ にあります。FTS5 はローカルテキスト検索であり、セマンティック検索やベクター検索ではありません。

インストールと検証

Python 3.11+ と uv が必要です。

./install.sh --manifest --json
./install.sh --target "$HOME/.local/share/witness" --non-interactive --json
uv sync --locked
uv run python -m pytest -q -p no:cacheprovider tests repair-tests
uv build

段階的インストーラーは、継承された Python 環境変数を消去し、ロックされたインストールを実行し、制限付きローカル構成とストレージを書き込み、実際の MCP 初回実行ドクターを実行します。

命名と技術的アイデンティティ

Witness Evidence は公開向けの修飾子です。技術的識別子は変更されません。 リポジトリ MaximilianoColoma/witness、パッケージ witness-public、Python モジュール witness_public、MCP ツール名、コントラクト、およびリリースされた v0.1.0 アーティファクトは、既存の技術的識別子を維持します。要するに、ストーリーは明確になり、ワイヤーはそのままです。

無関係の確立されたプロジェクトも Witness という名前を使用しています。混乱防止の通知については、TRADEMARKS.md を参照してください。

プロジェクトセンター

• 機能ロードマップ: ROADMAP.md

• エビデンスと証明ステータス: EVIDENCE.md

• ガバナンスとリリース権限: GOVERNANCE.md

• 貢献と DCO: CONTRIBUTING.md

• セキュリティ報告: SECURITY.md

• サポート境界: SUPPORT.md

• 命名と混乱防止: TRADEMARKS.md

ライセンス

Apache License 2.0 の下でライセンスされています。NOTICE を参照してください。Apache-2.0 は、使用、変更、再配布、および商用利用を許可します。公式プロジェクトステータスや商標の承認を暗示する許可は与えません。