エビデンスバンドル
エビデンスバンドルは、統計表、アクセシブルな SVG 図、そして除外または保留された行の 補遺から成る自己記述的なディレクトリで、すべて 1 つの完了したキャンペーンから派生し、 1 つのエビデンス層にフィルタリングされます。DispatchAtlas はエクスポートされた エビデンスをこれらの層別バンドルに整理し、各バンドルがそのエビデンス層が許す データのみを露出するようにします。
🪜 バンドル層
4 つの層 id は固定の公開安全な語彙に由来します。各層は編集的ラベルではなく、実行可能な 開示ポリシーです:
| 層 | 含む | 除外する |
|---|---|---|
core | コアの公開エビデンスのみ。 | 速度・品質・プラットフォームのエビデンス; 保留された行。 |
speed | コアと速度のエビデンス。 | 品質とプラットフォームのエビデンス; 保留された行。 |
quality | コア・速度・品質のエビデンス。 | プラットフォームのみのエビデンス; 保留された行。 |
platform | 完全な公開プラットフォームエビデンス: 再現性、ポータル、パッケージ、リリース準備状況。 | 編集されたソースと制限付き内部マーカー。これらはどの層でもブロックされたまま。 |
各バンドルは、その表や図と同じ層フィルタ済みデータセットから生成されるため、下位層の エクスポートが上位層の機構、デプロイ主張、保留された行を表面化することはできません。 フィルタはフェイルクローズします: 漏洩する代わりに、下位層の下で後続層の機構を露出する エクスポートはエラーを発生させます。ポリシーが禁じる行は除外され、理由とともに補足の 除外マニフェストに書き込まれます。
📁 バンドルの内容
バンドルには次が含まれます:
- 統計表(ソルバー要約、ペアワイズ比較、ランキング、ベンチマークカバレッジ、実行不能行)、
- 各図の役割・来歴・アクセシビリティ注記を記録する図マニフェストを伴うアクセシブルな SVG 図、
- 除外または保留された行と、限界事項へルーティングされたすべての手法を記録する補遺、
bundle.json、すべての生成ファイルを列挙し、正典マニフェストペイロードをハッシュする マニフェスト。
完全なバンドルレイアウトと各表・図の背後にある統計手法は、 分析エクスポート を参照してください。
⚙️ バンドルの生成方法
1 つのキャンペーンは、エクスポートコマンドを通じて層ごとに 1 つのバンドルへエクスポート します:
uv run dispatchatlas export `
--campaign-dir .\experiments\results\smoke-pilot `
--target-dir .\experiments `
--authorized-output-root .\experiments `
--tier coreバンドルはターゲットワークスペース下の evidence-bundles/{campaign_id}-{tier}/ に
着地します——実験ワークスペースのキュレーション層です。規模が
大きい場合、tools/build_campaign_evidence.py は候補ベンチマークカタログを構築し、
構成済みキャンペーンを実行し、分析を行い、記録された 1 つの構成からすべての層のバンドル
とポータルデータセットを書き出します:
uv run python tools/build_campaign_evidence.py `
--output-root .\experiments `
--problem-count-per-profile 30 `
--stochastic-seeds 10 `
--campaign-suffix localビルダーは、カタログ具体化、キャンペーン計画、実行、分析、バンドルエクスポート、レポート 書き込みのフェーズ進捗を stderr に出力し、生成エビデンスを意図的に Git 追跡のソース ツリーの外に書き込みます。
✅ バンドルの検証方法
- マニフェストハッシュ。
bundle.jsonはすべての生成ファイルを列挙し正典マニフェスト ペイロードをハッシュするため、バンドルの内容は自身のマニフェストに対して検査できます。 - 決定性。 同じ入力に対して同じエクスポートを再実行すると、同じ JSON・表・図の ペイロードが得られます。
- 派生であって権威ではない。 バンドルは常に再現性層の実行レベル記録から派生します ——独立した真実の源では決してなく——そしてそれらの記録自体がコンテンツハッシュされ、 キャンペーンエンジン を通じてリプレイ検証可能です。
- ゲート付き昇格。 バンドルは リリース準備状況 に記された リリースおよび開示ゲートを通じてのみ公開面に到達します。
エビデンス層は、ACM Artifact Review and Badging 語彙のバージョン 1.1 (2020) に、
López-Ibáñez, Branke, Paquete (2021) の確率的最適化ガイダンスと併せて対応します。
コンテンツハッシュされた bundle.json と図マニフェストを備えた任意の層バンドルは、
Artifacts Evaluated — Functional バッジに対応する準備が整っています; 公開ポータルを
通じて公開されたバンドルは Artifacts Available に対応します; 再現性マニフェストが
シード、環境、実行下限、予算とチューニングの同等性を固定した完全キャンペーンバンドルは
Results Reproduced に対応します。Results Replicated は、書かれた手法記述のみから構築
された独立実装を要し、いかなるプラットフォームも自身についてそれを付与できません
——マッピングを誠実に保つためにここに記します。
🌐 ポータルが消費するもの
結果ポータル は、同じエクスポート経路が生成するポータル
データセット(portal-results.json と CSV インデックス)——検索可能なタグ、開示ラベル、
目的値、実行 id、ハッシュ連結のキャンペーンメタデータ——を消費し、それを
tools/build_site_assets.py が静的サイトアセットへレンダリングします。ポータルは実験
ワークスペースを読むこともキャンペーンを実行することもなく、コミット済みで開示フィルタ
済みのエクスポートのみを提示します。