Trust Layer Week 1 段階A MVP

合成データだけで動かす、5ツールのローカルMCPサーバーです。秘密・URL・生payloadはログや構造化レスポンスへ出しません。これは真偽判定器ではなく、保守的な観測シグナルです。

インストール・実行

Node.js 20以上を用意し、このディレクトリで実行します。

npm install
npm test
npm run build
TRUST_LAYER_SECRET='replace-with-local-secret' TRUST_LAYER_DB_FILE='trust-layer-state.json' npm start

開発時は npm run dev、テスト監視は npm run test:watch です。デフォルトのエンドポイントは http://127.0.0.1:8787/mcp、非秘密の死活確認は GET /healthz です。listen hostは既定 0.0.0.0（Render等の外部到達用）で、ローカル限定にする場合だけ HOST=127.0.0.1 を指定します。PORT、HOST、TRUST_LAYER_SECRET、TRUST_LAYER_DB_FILE、Origin許可リスト（コードの TrustLayerOptions.allowedOrigins）を設定してください。Bearer token は手動招待で発行し、Authorization: Bearer <token> にだけ付けます。デフォルトで許可するOriginは http://localhost と http://127.0.0.1 です。

オーナー用の合成token発行

サーバーと同じ TRUST_LAYER_DB_FILE を指定して、平文tokenを一度だけ標準出力へ表示します。標準出力をログへ転送せず、安全な一時メモへ手動コピーしてください。参加者credentialとしてDBに残るのはHMAC hashだけです。

TRUST_LAYER_SECRET='replace-with-local-secret' TRUST_LAYER_DB_FILE='trust-layer-state.json' \
  npm run issue-token -- --group owner-test

このコマンドの出力tokenは環境変数・README・ログへ貼り付けないでください。token発行後は同じsecret/DB fileでサーバーを起動します。

Related MCP server: Agent Trust Stack MCP Server

合成デモ

TrustLayerService.issueSyntheticToken('demo-group') が、平文を一度だけ返すローカルトークン発行方法です。保存されるのはサーバー秘密によるHMACだけです。発行したtokenで5ツールを呼び、同じ research_id は必ず小文字のUUID v4にします（例: 11111111-1111-4111-8111-111111111111）。

1. report_domain_assessment を minimal_observation で送る。

2. 独立した複数ドメインの最小評価をまとめる場合は report_domain_assessments_batch に1〜5件を入れる。これはtransportだけをまとめ、各itemは単体評価と同じreceipt・冪等性・レート制限で処理します。配列内の結果は item_index 順に読み、retry_directive に従って再試行します。

3. report_research_manifest は batch_count=1,batch_index=1,complete=true とし、source_count_total とsource数を一致させる。canonical_url は https://、443（または既定ポート）、公開ドメインのみ、sensitive では使えない。URLを保存するのは14日TTLの短期source decisionだけです。複数sourceが一つのドメインを裏付ける場合はこちらを使います。

4. 必要なら完了済みmanifestのsource参照だけを submit_local_verification に渡す。これは自己申告で、集約重みを増やしません。

5. lookup_domain_signal で直近90日の状態を読む。返すのは insufficient | consistent_support | mixed_observations | review_hold | withdrawn と固定注意書きだけです。

同一token×domain×rubricの集約寄与は30日で最大1票相当、同一招待出所群も各domainで最大1票相当です。新規tokenは発行後7日かつ10寄与までは重み0.25、assessmentは50件/24時間かつ10件/10分、入力資源はitem slot単位で30件/10分・300件/24時間・無効5件/10分cooldownです。manifestの途中batchは14日で削除、receiptは30日、非個人rollupは97日で削除します。clockを注入できるため境界をテストできます。

ファイルとschema

• schemas/: input 5種、success 5種、共通error、共通定義、source union。すべて https://schemas.trust-layer.local/v0.3/ の絶対URIでAjv catalog解決します。batchのMCP inputSchemaだけはtransport用に寛容で、正式な外側契約とitem検証はservice/AJVが行います。

• migrations/001_trust_layer.sql: §5.1の14表を含むPostgreSQL互換migration。pg-mem adapterが起動時にこのmigrationを実行し、各合成リクエストの状態反映をbackup/restore transaction境界で行います。運用DBへ移行する際はこのSQLを正本にします。TRUST_LAYER_DB_FILE指定時は、pg-memの再起動橋渡しとしてparticipant token hashを含む状態を0600ファイルへ保存します（JSONをDBの代替表として使うものではありません）。

• tests/: schema独立検証、単一/multi batch原子遷移、冪等、TTL、rate/dedup/group上限、traceability。

Week 1で未実装の境界

同意UI、DNS隔離egress/DNS再解決・redirectを含む外部再取得、robots/規約判定、独立監査の盲検再取得・反証corroboration、ドメイン管理者のDNS/.well-known異議受付、バックアップ物理消去証跡、監査操作UIは実装していません。tests/traceability.test.ts に各未実装項目と将来テスト名を対応づけています。したがって外部公開・実データ投入・課金・MCPクライアントへの信頼度%表示は行わないでください。