phasegate 0.254.0 → 0.283.0

package/CHANGELOG.md

@@ -7,8 +7,68 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+
+- **WI-328 — 実効言語と出所を phasegate:status に表示（GitHub #39 残課題）** — WI-319/320 の言語自動検出の結果がどこにも表示されず、どの validator が有効/SKIP になるか知る術がなかった。`phasegate:status` の JSON に `languages: { effective, source }`（source = `declared` / `detected` / `fallback`）を追加。解決ロジックは validator-system の `resolveProjectLanguages()`（WI-319 の検出テーブル）に一本化して再利用し、validator の有効/SKIP 判定と必ず同じ結果を表示する。ConfigQueryPort への追加は optional メソッドで後方互換。
+
+- **WI-327 — 最小 config（project のみ）で動作可能に** — 手書き `phasegate.config.json` のスキーマが top-level 8 項目を required とし、`{"project": {"name": ..., "preset": ...}}` の最小構成で L1-001 が連発していた。プリセット解決（`PresetResolutionService.deepMerge`）は省略セクションの補完を既に完備していたため、v3 **と v2**（architecture キーなしの最小 config は v2 検証に振られる）の top-level required を `["project"]` に緩和し、型定義を実態に一致させた。**検証は弱めていない**: セクション内の required・型・enum・additionalProperties は不変で、書かれているが不正なキーは従来どおりエラー（spawn E2E で exit 2 を固定）。最小 config の解決結果がプリセット定義と一致することも統合テストで固定。
+
+- **WI-326 — install フラグ状態を manifest に永続化（GitHub #36 残課題）** — `--with-husky` / `--with-ci` / personal の install 時オプションが `.phasegate/manifest.json` に記録されず、後の reconcile が「全 target 対象」を仮定して opt-out したはずの Husky / CI workflow を追加し直す食い違いがあった。manifest に optional `installationFlags` を追加して install（apply）時に実効フラグを記録し、reconcile は明示指定 > manifest 記録 > 従来挙動の優先順で target を構成する。フィールドを持たない旧 manifest は推測せず従来挙動のまま（load / save round-trip のバイト互換もテストで固定）。
+
+- **WI-324 — フレッシュプロジェクトで L3-004 を SKIP に（オンボーディング阻害の解消）** — phasegate 導入直後（story 未作成・requirement-test-matrix 未生成）でも L3-004 が「マトリクス不在」で fail-closed FAIL になり導入体験を阻害していた。「matrix 不在 かつ StoryCatalog（user_stories.md）の story ゼロ」の場合のみ skipWithReason（WI-317 の L3-003 と同表現）で透過 SKIP に変更。**story が 1 件でも存在するのに matrix 不在なら従来どおり fail-closed**（あるべき matrix の消失事故は見逃さない）。story 数の取得に失敗した場合も判定不能として fail-closed 側に倒す。
+
+- **WI-323 — 非ゲート hook の payload フィールド欠落を fail-open 化（GitHub #40 残課題）** — stop hook が stdin payload の `session_id` 欠落で exit 2 になり、WI-314 の「hook は開発フローを止めない」方針と不整合だった。stop（`SESSION_ID_MISSING`）と post-tool-use（`TOOL_NAME_MISSING`）を警告 + hook-skip-event 記録 + exit 0 の fail-open に変更。**pre-tool-use の `tool_name` 欠落 exit 2 は書き込みゲートのため意図的に fail-closed を維持**し、回帰ガードテストで固定。usecase 契約（空 sessionId エラー）は presentation 入口ガード方式で不変。
+
+- **WI-322 — config なし fallback の coverageThreshold 90 を opt-out の 0 に修正（GitHub #37 残課題）** — WI-317 で「カバレッジゲートはオプトイン、0 = 正規の opt-out」と定義したのに、config なし環境で使われる validator-system の `DEFAULT_CONFIG` fallback が `coverageThreshold: 90` のままで、config を持たない環境だけ勝手に 90% が強制される矛盾を解消。fallback のみの変更でプリセット定義（minimal / standard / strict）は不変。fallback 経由で L3-003 が透過 SKIP になることを回帰テストで固定。
+
+- **WI-321 — complete-check の JSON 出力に warning 詳細を含める（GitHub #38 残課題）** — `phasegate:complete-check` が warning を `summary.warnings` の件数のみで返し、どの validator のどんな warning かが出力に含まれなかった非対称を修正。ci-check case と同じく `CiCheckResult` を data ペイロードとして pass / fail 双方で返す（`data.validatorResults[].validatorId / errors[]`）。validator 結果 0 件時は従来どおり data なし。判定ロジック・exit code・lint 合流は不変。
+
+- **WI-325 — load 経路の JSON パース失敗が "Failed to persist" と誤表示される問題を修正** — `FileSystemConfigRepository.load()` の JSON 構文エラーが書き込み用の `ConfigPersistenceError`（"Failed to persist config"）で送出され、読み込み失敗なのに永続化失敗と誤解させるメッセージになっていた。`ConfigParseError extends ConfigPersistenceError` を新設して load 経路を "Failed to parse config JSON" に分離。サブクラス化により main.ts の `instanceof ConfigPersistenceError` fail-open 判定（WI-314）は無変更で互換維持。save 経路は従来どおり。
+
+- **WI-320 — 言語自動検出を実 CLI 経路で有効化（GitHub #39 フォローアップ）** — WI-319 の検出は adapter に実装されたが、実 CLI では preset 解決（`preset-resolution-service`）・mapper・`ProjectConfig` VO の 3 箇所が未宣言時に `["typescript"]` を注入するため dead code だった（シナリオ検証で発見）。「未宣言」シグナルを resolved config から adapter まで生存させ、純 Python リポジトリで L3-003 が unsupported-language SKIP になることを実 CLI spawn の E2E で固定。宣言時の挙動・検証は不変。
+
+- **WI-319 — project.languages のファイルシステム自動検出（GitHub #39）** — `project.languages` 未宣言時に無条件で `["typescript"]` へフォールバックし、純 Python プロジェクトでも TS 専用 validator（L3-002 / L3-003 / L4-003）が既定で走っていた問題を修正。マーカーファイル（python: pyproject.toml 等 / go.mod / Cargo.toml / pom.xml / Gemfile / composer.json、typescript: tsconfig.json または package.json の typescript 依存のみ — phasegate 導入時の package.json を誤検出しないため存在自体は根拠にしない）から検出し、config 宣言は引き続き最優先、検出ゼロ時は従来どおり typescript フォールバック。
+
+- **WI-318 — complete-check に severity-aware 集約を適用（GitHub #38）** — `phasegate:complete-check` が validator の生の `passed` だけを見ており、warning-only failure でも exit 1 になって `validate` / `ci-check` と乖離していた。Stop hook が叩くのは complete-check のため、L2-016 の `ungated-legacy` マーカー（error→可視 warning 降格）が実質無効化されていた。ci-check と同一の `CiCheckResult.fromResults()`（ADR-017 / WI-260 の `isEffectivelyPassed`）を通す集約に修正し、warning 件数を summary に反映。skipped validator が fail 扱いされる潜在バグも同時に解消。lint fail → exit 1 の合流は不変。
+
+- **WI-317 — coverageThreshold の opt-out を到達可能に（GitHub #37）** — L3-003 実装は「カバレッジゲートはオプトイン」と明記しつつ、opt-out 手段（`null`）がスキーマで拒否され、`0` を設定してもレポート不在で fail-closed FAIL になる矛盾があった。ドメイン VO `L3Config.hasCoverageGate()` の「threshold > 0 でのみ有効」の意図に run-l3 を揃え、`coverageThreshold: 0`（および null）を正規の opt-out として SKIP にした（minimal preset の 0 も本来の opt-out として機能）。レポート不在 FAIL の suggestion に (a) カバレッジ付き実行 (b) `coverageThreshold: 0` での opt-out (c) 非 JS/TS プロジェクトの `project.languages` 宣言、の 3 択を案内する。
+
+- **WI-316 — install の `--with-husky` / `--with-ci` dead flag を修正（GitHub #36）** — install コマンドがこの 2 フラグを一度も読まず、`--personal` なしでは常に `.husky/*` と `.github/workflows/phasegate-aidlc-gate.yml` を書き込んでいた。ヘルプ記載・`init` / `setup:agent` と同じ opt-in（フラグ明示時のみ書き込み）に配線を揃え、CLI 統合テストとドキュメントで固定した。usecase のプログラマティック契約（既定 true）は不変。
+
+- **WI-315 — install / reconcile が CLAUDE.md の user-section を上書きする問題を修正（GitHub #35）** — CLAUDE.md テンプレートは user-section が managed-section の内側にあるため、`install --apply` / `reconcile` の managed block 置換がユーザー自身の記述を placeholder で消失させていた。merge 時に既存 user-section 本文を抽出して新 block に再注入する方式で保持するようにした（AGENTS.md の既存挙動は不変）。併せて、ユーザー本文が `String.replace` の置換文字列として `$` シーケンス解釈される潜在破損を replacer 関数で封じた。
+
+- **WI-314 — 不正 config の hook / doctor 自己修復デッドロック解消（GitHub #40）** — スキーマ違反の `phasegate.config.json` が dispatch 上流の fail-closed で全コマンドを exit 2 にし、pre-tool-use hook 経由で Bash / Write / Edit を全遮断して config 自身の修復も不能になる問題を修正。`hook` / `doctor` は警告 + 既定設定で続行する fail-open とし（診断・自己修復経路の常時確保）、`validate` / `ci-check` 等の検査系は復旧手順の案内付きで fail-closed を維持。hook 内部 adapter の素 `JSON.parse` throw も同様に fail-open 化し、構文破壊 JSON での再デッドロックを塞いだ。gated スコープへの書き込みは phase-gate 判定が引き続き fail-closed でブロックする。
+
+- **WI-313 — typescript peer range を `<7.0.0` に制限（GitHub #34）** — peer 自動インストールで typescript@7 が解決されると classic compiler API（`ts.ScriptTarget` 等）が存在せず全コマンドが `Cannot read properties of undefined (reading 'ESNext')` でクラッシュする問題を修正。TypeScript 7 系を peer range で弾き、packaging contract テストで range を固定した。
+
+- **WI-312 — coverage-producing CI gate** — production workflowとbundled `aidlc-gate`がL3-003実行前に`coverage/coverage-summary.json`を生成せず、clean checkoutでcoverageThresholdに対してfail-closedとなる既存欠陥を修正。self-repoはcoverage付きunit / integrationとcoverage対象外E2Eを各1回だけ実行してplain full suiteの二重実行を避け、threads開始時にもforks blobを保持して両poolをmergeする。templateは採用projectの`coverage` scriptをpackage manager別に必須実行し、test / coverage → matrix → World derive二重一致 → L3 → attestation → integrityの順序を維持する。
+
+- **WI-311 — hermetic CI-facing harness integration tests** — GitHub Actionsのtest-before-matrix順序で、real lint integrationとCLI E2Eがself-repo cwd、coverage、untracked requirement matrixを暗黙のPASS入力としていた既存欠陥を修正。lint adapterへ明示rootを注入してtracked minimal workspaceだけを実scanし、`phasegate:ci-check --json`とlegacy `complete-check`はL3 / Worldを明示無効化したtemp configで公開command契約を検証する。productionのfail-closedとCI gate順序は変更しない。
+
+- **WI-310 — hermetic large-stdout CLI regression** — WI-308の64 KiB超assertionがuntracked requirement matrixとself-repoの604 adopted-legacy warningsへ依存していた欠陥を修正。tracked World-enabled configを使うtemp corpusに160組のduplicate fragment IDを生成し、CIのtest-before-matrix順序でも`validate --layer L2 --format json` / `--json`が決定的に64 KiBを超えて完全parseできる契約へ置換した。
+
+- **WI-309 — WI-305 validator domain reflection repair** — `DesignChangeDeclarationPolicy`を実装・配線しながらvalidator-system `domain_model.md`へのWI-305累積反映を欠落させ、story reflection corpusが検出したbaseline外違反を正規に解消。exact `corpusRole + DeclaredKey`照合、pinned change限定、Work-Item trailer intersection、unique sorted finding、local fast-path / L3 authority境界を実コードどおり記録し、baseline / allowlistには触れていない。
+
+- **WI-308 — CLI large stdout drain** — self-repoのWorld enforcement有効化により`validate --layer L2 --json`が604件のadopted-legacy warningを含む64 KiB超のJSONとなり、`console.log`直後の`process.exit`がpipe bufferをdrainせず末尾を切断する回帰を修正。direct stdout resultを返す全top-level CLI経路を共通graceful exitへ統合し、warningを省略せず任意サイズの完全な出力と既存exit codeを維持する。64 KiB超を必須条件とするprocess E2Eで`--format json` / `--json`双方を固定し、同E2E fileの全subprocess caseへ明示60秒timeoutを適用した。
+
 ### Added
 
+- **WI-307 / H17-19 — World production-ready CI / template regression（WM-24）** — self-repo CIをtest → requirement-test matrix生成 → pure `world:derive --json`二重byte一致 → authoritative L3 → attestation v2 produce / verify → integrity verifyのtrust chainへ整列。保存obligation reportをCI入力にせず、runner tempの二出力とv2 evidenceだけを比較・検証する。bundled `aidlc-gate`はconfig JSONをfail-closedで読み、`world.enabled:true`の場合だけmatrix後のderive二重一致を実行するため、false / absentの採用projectは既存L3契約を維持する。regression-suiteにactual processの3 `world:*` command、`phasegate-world-cli/v1` envelope、exit 0 / 1 / 2、CI source order、package surfaceのcontract testを追加。README / README.ja / CLI guideを登録済み`L2-017` / `L3-008`、bounded SessionStart、attestation v2 root pin、self-repo dogfood有効のproduction仕様へ更新し、H17-19を同一着地でrequiredとして登録した。Phase CのCI統合により、warning-only validatorの`passed:false`とaggregate `allPassed:true`が同時に公開される潜在矛盾を顕在化。harness-apiのpublic ci-check projectionで同一`failOnWarning` policyをper-validator結果にも適用し、warning diagnosticsを保持したまま既定時は`passed:true`、strict時は`passed:false`へ一貫させ、attestation INV-1を緩和せずv2 smokeを成立させた。
+
+- **WI-306 / H17-18 — Attestation v2 World snapshot root pin（WM-23）** — `phasegate-attestation/v2` / `https://phasegate.dev/attestation/gate-run/v2`を追加し、World canonical `corpusRoot`を必須`worldSnapshotRoot`としてattestationDigestのcanonical payloadへ封印する。fragment / node個別digestは保存せず、published `attestation-v2.schema.json`もroot一件だけを許可する。attestation applicationはconsumer-owned plain root providerだけを受け、top-level harness compositionがworld-model public `WorldSnapshotRootFacade`からrootを注入するため、attestation→world-model importを作らない。provider未配線のprogrammatic produceと全v1 verifyは無期限互換のv1を維持し、schema / predicate / root presence mismatchやprovider failureはv1へdowngradeせずfail-closed。World owner projectionはv1 / v2を受理しながらv2 root self-referenceをcorpus projectionから除外する。v1 / v2 produce→verify、root改竄、published schema、projection determinismをtestで固定し、H17-18を同一着地でrequiredとして登録した。
+
+- **WI-305 / H17-17 — Design change declaration / reflection hook（WM-22）** — commit-msg経路へpin済み設計fragmentの変更宣言checkを追加。traceability-modelのpublic plain DTO facadeがGit index / HEADから内容の変わったexplicit product / inception fragmentだけをrole、DeclaredKey、path、change kind、sorted `@work-item-id`、明示`@world-reflects`付きで観測し、world-modelのpublic facadeがconstraint repositoryを露出せずclaimant / premiseのexplicit fragment pinだけを投影する。validator-system policyは両者をrole + keyでendpoint-symmetricに突合し、pin済み変更fragmentのWork Item集合とcommitの`Work-Item: WI-NNN` trailerに共通IDがない場合だけnon-bypassableでblockする。unpinned / legacy whole-file / ADR / source変更へblocking面を広げず、`world.enabled:false`ではproviderを呼ばず従来挙動を維持。Git / control observation不能はfixed code warningへfail-openし、local hookは偽造可能なfast-path、authoritative trust rootはL3-008であることを出力する。H17-17を同一着地で`planned -> required`として登録し、changed fragment / pin projection / matching・mismatch・unavailable contractをunit / Git fixture testで固定した。
+
+- **WI-304 / H17-16 — SessionStart open World obligations summary（WM-21）** — agent-integrationのSessionStart経路へconsumer-owned `WorldObligationsQueryPort`、plain context DTO、priority / adopted-count usecase、bounded presentationを追加。infrastructure adapterはworld-model public `createWorldModelModule`だけを消費し、保存済み`.harness/world-obligations.json`を読まず`writeReport:false`でcurrent corpusからpure deriveする。`new-structural` / `invalid-declaration` / expired waiverをcleanup-required / waivedより先にstable keyで表示し、adopted-legacyは個別列挙せず件数一行へ集約。World sectionはconfig値にかかわらず最大5件 / 2000 Unicode scalar、entry途中切断なし、決定的省略行を保証し、reason / diagnostic details / corpus prose / full reportをpromptへ中継しない。`world.enabled:false`またはsession summary無効時はquery未実行・非表示、config / derive不能時はrepository由来reasonを含まない固定一行warningへfail-openしてhook exit 0を維持する。self-repo E2Eで604 adopted-legacyが一行だけになりfingerprint本文を注入しないことを固定し、H17-16を同一着地で`planned -> required`へ進めた。
+
+- **WI-303 — self-repo World enforcement 有効化（dogfood）** — CP-4 合格を受け `phasegate.config.json` に `world.enabled: true` を設定。以後 self-repo の L2 は L2-017（constraint admission fast-path）、L3 は L3-008（authoritative re-derivation）を実際に実行する。604 件の adopted-legacy baseline は非 blocking warning として可視化され、新規構造違反・不正宣言は fail-closed。実測コストは両ゲート合計 2 秒未満。
+
+- **WI-302 / H17-15 — L3-008 authoritative World constraint re-derivation（WM-20）** — ADR-030のCI trust rootとADR-035 / ADR-037のnon-authoritative generated report contractを執行し、`L3-008 world-constraint-rederivation`をValidatorId、default registry、RunL3、composition-rootへ登録。専用consumer-owned port / service / infrastructure adapterが呼出しごとにworld-model public compositionをfresh構築し、current corpusとversioned constraints / baseline / waiver / debtから`writeReport:false`で義務を独立再導出する。`.harness/world-obligations.json`のreader / cache / pathを依存に持たず、report absent / forged / unsupported-version / deletedでobservationとblocking結果が不変であることをreal filesystem fixtureで固定した。validator-system policyは`new-structural` / `invalid-declaration`と全derive diagnosticをfingerprint・WCR rule付きerrorとしてfail-closed、`adopted-legacy` / active waiverをwarningとして可視non-blockingにする。base fixtureはPASSし、new unpinned claim / duplicate IDを既存mutation manifestのexact fingerprint、unknown schemaをauthoritative diagnosticとして検証。resolved `world.enabled:false`ではL3-008を明示skip、trueの場合だけ実行し、self-repo config自体は変更していない。H17-15を同一着地で`planned -> required`へ進め、enforceable MVPのL2 local / L3 authoritative dual pathを完成した。
+
+- **WI-301 / H17-14 — L2-017 World constraint admission fast-path（WM-19）** — ADR-037で予約した`L2-017 world-constraint-admission`をValidatorId、default registry、RunL2、composition-rootへ登録。config-foundationのresolved `world.enabled`をautomatic gate selectionとして消費し、false / absentではdefinitionを残した明示skip、trueの場合だけworld-model public facadeからpure `deriveWorldObligationsUseCase`を実行する。validator-system所有のpolicy serviceは`new-structural` / `invalid-declaration`とconstraint document admission failureをerrorとしてfail-closedにし、`adopted-legacy` / active waiverをfingerprint・WCR rule付きwarningとして可視化する。validなnew claim / pin自体はblockせず、保存obligation reportは入力にしない。HarnessErrorはlocal fast-pathが偽造可能でauthoritative判定は後続L3 clean-corpus re-derivationであると明記。fixtureでunpinned claim / malformed schemaのfail-closed、new pin finding、baseline採用後のlegacy non-blocking、disabled時のport非実行を固定した。self-repo `world.enabled`はfalseのまま、L3-008は未登録。H17-14を同一着地で`planned -> required`へ進めた。
+
+- **WI-300 / H17-13 — World config surface と resolved mapping（WM-18）** — `phasegate.config.json` v2 / v3へADR-037のtop-level `world` contractを追加し、corpus roots / selection、matrix・attestation・integrity inputs、constraints・baseline・waivers・debts declarations、obligation report、session-start limitをschema / domain Value Objectでfail-closed検証する。absolute / backslash / traversal path、cross-role root overlap、case-fold collision、unknown field、範囲外limitを拒否。minimal / standard / strictは全てcanonical defaultsと`world.enabled:false`を持ち、explicit `world:*` commandは引き続き常時実行可能。preset resolutionはnested overrideをmergeし、World field省略時だけlegacy design / inception / matrix pathを継承する。dedicated `toWorldModelConfig()`をpublic mapping boundaryとして追加し、mainから完全plain DTOをWorld compositionへ注入。複数root、custom provider / control / output pathをextractor、repository、writerへ配線し、corpus digestからoutput / session / gate enablementを除外した。validator-system mapperにもWM-19 / WM-20用World projectionを渡すが、`L2-017` / `L3-008`は未登録のまま維持。H17-13を同一着地で`planned -> required`として登録し、configuration guideとaffected Unit設計を更新した。
+
 - **WI-299 — World Model のユーザー向けドキュメント反映** — README.md / README.ja.md に World Model 節（端点対称な制約再評価、`world:inspect` / `world:pin` / `world:derive`、immutable obligation report、adoption baseline、fail-closed 新規違反、CLI-only の現状スコープ）と Core Capabilities 行・CLI 表エントリを追加。`docs/guide/cli-reference.md` に World Model 節（options / exit code 0-1-2 / 制御ファイル 4 種 + `.harness/world-obligations.json` / `phasegate-world-cli/v1` envelope / `world.enabled` 既定 false と L2-017 / L3-008 予約の明記）を新設。README.ja footer の版表記を現行へ更新。
 
 - **WI-298 / H17-12 — Self-repo World adoption baseline と dogfood smoke（WM-17）** — final tracked corpus、H17-12 AC-bound smoke、再生成matrix、skill-quality semantic debt reflectionを含むcheckoutをbaselineなしで二重deriveし、serialized bytesとunique fingerprint集合の一致を確認。initial structural violationは実測604件で、全件implicit global TestReference ID duplicateの`WCR-005`、WCR-001 / explicit constraint finding / waiver / malformed policy inputは0件だった。candidate evaluation / corpus / constraint rootsをprovenanceに持つ604-entry closed `phasegate.world-baseline.json`を`adoptedByWorkItemId: WI-298`で採用し、same-ruleset追記禁止・返済削除onlyを明記。skill-quality coverage reportのungated attestation gapを`pgw:v1:semantic-debt:skill-quality.coverage-attestation-legacy`として`phasegate.world-debts.json`へ一件宣言し、既存`@coverage-gating`と`@world-semantic-debt`を併存させてL2-016を変更せず別collectionへimportした。self-repo smokeはmatrix再生成後の`world:derive --json`二重実行をbyte-identical、baseline=current fingerprint集合、604件全て`adopted-legacy`、new / repaid / policy diagnostic 0、semantic debt 1、exit 0として固定。H17-12を`planned -> required`へ進め、Phase B機能MVPを完成した。

package/README.ja.md

@@ -189,7 +189,7 @@ npx phasegate reconcile --apply
 | **HarnessError 形式** | 全エラーに ADR 参照 + 修正例が含まれ、AI が自己修正できる |
 | **Baseline (retrofit)** | 既存リポジトリ導入時、`baseline` snapshot に登録した既存ファイルは構造的に編集されるまで gate 対象外 |
 | **カスタム gate** | AIDLC 以外のプロジェクトでも schema-first など独自の前提条件を設定できる |
-| **World Model (CLI)** | 設計文書・ソース・テスト・matrix・attestation を型付き事実グラフに抽出し、制約の両端点を pin して義務を決定的に再導出（`world:inspect` / `world:pin` / `world:derive`） |
+| **World Model** | 設計文書・ソース・テスト・matrix・attestationを型付き事実グラフへ抽出。決定的`world:*` CLI、L2 fast-path、L3 authoritative再導出、bounded SessionStart、attestation v2 root pinを提供 |
 
 ---
 
@@ -260,7 +260,7 @@ Phasegate はプロンプトインジェクションを独立した新規脅威
 
 phasegate のゲートは従来一方向でした: 書き込み時にコードを設計と照合する。**World Model**（[ADR-031](docs/ADR/031-world-model-ownership-and-corpus-lifecycle.md)〜[037](docs/ADR/037-world-cli-and-output-contract.md)）はこの制約面を**端点対称**にします。設計文書・ソースメタデータ・テスト・requirement-test matrix・attestation を型付き・content-addressed な事実グラフとして抽出し、pin された制約は**どちらの端点が変わっても**再評価されます — 設計文書を編集すれば、それを根拠として主張していたコード側に可視の義務が生まれます（逆方向だけではなく）。
 
-3 コマンドを提供します（明示実行は常に可能。`phasegate.config.json` の `world.enabled` は既定 `false` で、将来のゲート統合のみを制御します）:
+3 コマンドは常に明示実行できます。`world.enabled` の product 既定値は `false` で、有効化すると登録済み L2/L3 統合が動きます。このリポジトリでは dogfood のため有効です。
 
 ```bash
 npx phasegate world:inspect --json    # 決定的な read-only snapshot: node / edge / 抽出 diagnostics
@@ -274,8 +274,11 @@ npx phasegate world:derive --json     # 制約評価から obligation report を
 - **新規違反は初日から fail-closed。** 既存違反は閉じた・人間レビュー可能な baseline（`phasegate.world-baseline.json`）として採用され、縮小のみ許されます（同一 ruleset での追加は拒否）。
 - **既知の意味的ギャップは宣言するもので「再発見」しない。** explicit debt は `phasegate.world-debts.json` に宣言し import として表示。waiver（`phasegate.world-waivers.json`）は fingerprint / 理由 / 期限 / Work Item が必須です。
 - **決定性は契約。** 同一 checkout での 2 回実行は byte-identical な JSON を出力します。
+- **enforcement は二つの信頼レベルを持つ。** `L2-017` は偽造可能な local fast-path、`L3-008` は current corpus から authoritative に再導出し、`.harness/world-obligations.json`を信頼しません。adopted legacy は可視・非blocking、新規構造違反や不正宣言はfail-closedです。
+- **agent context はbounded。** SessionStartは最大5件 / 2000文字でopen itemを表示し、adopted legacyは件数だけに集約。導出不能時は固定warningへfail-openします。
+- **evidenceはroot一件だけをpinする。** attestation v2はfragment digestを複製せず`worldSnapshotRoot`をgate-run evidenceへ封印し、v1 produce / verify互換も維持します。
 
-現在のスコープは **CLI のみ**です: validator ID L2-017 / L3-008 は予約済みですが pre-commit / CI ゲートへの登録は未実施で、将来フェーズとして管理しています。
+World enforcementはproduction統合済みです。`L2-017` / `L3-008`は登録済み、bundled CI gateはWorld有効projectで決定的deriveを条件付き実行し、このリポジトリはfull dogfood pathを実行します。
 
 ---
 

package/README.md

@@ -173,7 +173,7 @@ npx phasegate reconcile --apply
 | **Agent-readable HarnessError output** | Gives AI agents the reason, missing artifacts, references, and examples needed to self-correct |
 | **Retrofit baseline** | Lets existing repositories adopt Phasegate gradually by grandfathering unchanged files |
 | **Configurable gates** | Supports AIDLC defaults or custom gates such as schema-first API development |
-| **World Model (CLI)** | Extracts design docs, source, tests, matrices, and attestations into a typed fact graph, pins constraints between endpoints, and deterministically re-derives obligations (`world:inspect` / `world:pin` / `world:derive`) |
+| **World Model** | Extracts design docs, source, tests, matrices, and attestations into a typed fact graph; deterministic `world:*` commands, L2 fast-path, L3 authoritative re-derivation, bounded SessionStart context, and attestation v2 root pinning |
 
 ---
 
@@ -240,7 +240,7 @@ Five components implement this posture:
 
 Phasegate's gates historically pointed one way: code is checked against design at write time. The **World Model** (per [ADR-031](docs/ADR/031-world-model-ownership-and-corpus-lifecycle.md)–[037](docs/ADR/037-world-cli-and-output-contract.md)) makes that constraint surface **endpoint-symmetric**: design documents, source metadata, tests, the requirement-test matrix, and attestations are extracted into a typed, content-addressed fact graph, and a pinned constraint is re-evaluated whenever *either* endpoint changes — so editing a design document creates visible obligations on the code that claimed it, not just the other way around.
 
-Three commands (always runnable explicitly; `world.enabled` in `phasegate.config.json` defaults to `false` and only governs future gate integration):
+Three commands are always runnable explicitly. The product default for `world.enabled` is `false`; enabling it activates the registered L2/L3 integrations. This repository enables it for dogfooding.
 
 ```bash
 npx phasegate world:inspect --json    # deterministic read-only snapshot: nodes, edges, extraction diagnostics
@@ -254,8 +254,11 @@ Design commitments that keep it honest:
 - **New violations fail closed from day one.** Pre-existing violations are adopted into a closed, human-reviewable baseline (`phasegate.world-baseline.json`) that can only shrink; same-ruleset additions are rejected.
 - **Known semantic gaps are declared, never "rediscovered."** Explicit debts live in `phasegate.world-debts.json` and are displayed as imports; waivers (`phasegate.world-waivers.json`) require a fingerprint, reason, expiry, and Work Item.
 - **Determinism is a contract.** Double runs over the same checkout produce byte-identical JSON output.
+- **Enforcement has two trust levels.** `L2-017` is a forgeable local fast-path; `L3-008` authoritatively re-derives from the current corpus and never trusts `.harness/world-obligations.json`. Adopted legacy remains visible and non-blocking; new structural or malformed declarations fail closed.
+- **Agent context is bounded.** SessionStart shows at most five open items within 2,000 characters, summarizes adopted legacy as a count, and fails open with a fixed warning if derivation is unavailable.
+- **Evidence pins one root.** Attestation v2 seals `worldSnapshotRoot` in gate-run evidence without copying fragment digests; v1 produce/verify compatibility remains available.
 
-Current scope is **CLI-only**: validator IDs L2-017 / L3-008 are reserved but not yet registered into pre-commit/CI gating, which is tracked as a future phase.
+World enforcement is production-integrated: `L2-017` and `L3-008` are registered, the bundled CI gate conditionally runs deterministic derivation for World-enabled projects, and this repository runs the full dogfood path.
 
 ---
 

package/docs/contracts/attestation-v2.schema.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://phasegate.dev/contracts/attestation-v2.schema.json",
+  "title": "PhaseGate attestation v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "predicateType",
+    "subject",
+    "inputs",
+    "granularity",
+    "acBoundScope",
+    "worldSnapshotRoot",
+    "metadata",
+    "signature"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "phasegate-attestation/v2" },
+    "predicateType": { "const": "https://phasegate.dev/attestation/gate-run/v2" },
+    "worldSnapshotRoot": { "$ref": "#/$defs/digest" },
+    "subject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["command", "gateResult", "validatorSet"],
+      "properties": {
+        "command": { "type": "string", "minLength": 1 },
+        "gateResult": { "enum": ["pass", "fail"] },
+        "validatorSet": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["validatorId", "passed", "skipped"],
+            "properties": {
+              "validatorId": { "type": "string", "minLength": 1 },
+              "passed": { "type": "boolean" },
+              "skipped": { "type": "boolean" }
+            }
+          }
+        }
+      }
+    },
+    "inputs": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["digestAlgorithm", "sources", "inputDigest"],
+      "properties": {
+        "digestAlgorithm": { "const": "sha256" },
+        "sources": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["path", "digest"],
+            "properties": {
+              "path": { "type": "string", "minLength": 1 },
+              "digest": { "$ref": "#/$defs/digest" }
+            }
+          }
+        },
+        "inputDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "granularity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["traceability"],
+      "properties": {
+        "traceability": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["validator", "level", "claim", "knownLimitations"],
+          "properties": {
+            "validator": { "type": "string", "minLength": 1 },
+            "level": { "enum": ["file", "ac"] },
+            "claim": { "type": "string" },
+            "knownLimitations": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      }
+    },
+    "acBoundScope": { "type": "array", "items": { "type": "string" } },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["producedAt", "producer", "gitCommit"],
+      "properties": {
+        "producedAt": { "type": "string", "minLength": 1 },
+        "producer": { "type": "string", "minLength": 1 },
+        "gitCommit": { "type": ["string", "null"] }
+      }
+    },
+    "signature": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "attestationDigest", "algorithm", "keyId", "value"],
+      "properties": {
+        "mode": { "enum": ["unsigned-poc", "signed"] },
+        "attestationDigest": { "$ref": "#/$defs/digest" },
+        "algorithm": { "type": ["string", "null"] },
+        "keyId": { "type": ["string", "null"] },
+        "value": { "type": ["string", "null"] }
+      }
+    }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+  }
+}

package/docs/guide/cli-reference.md

@@ -328,8 +328,9 @@ L4 warning findings fail the process only when warning strictness is enabled (`v
 ## World Model
 
 <!-- @work-item-id WI-299 -->
+<!-- @work-item-id WI-307 -->
 
-World Model コマンド（ADR-037）。設計文書・ソース・テスト・matrix・attestation を型付き事実グラフとして抽出し、pin された制約を両端点対称に再評価して義務を導出する。明示実行は config に依存せず常に可能（`world.enabled` は既定 `false` で、将来の L2/L3 ゲート統合のみを制御。validator ID `L2-017` / `L3-008` は予約済み・未登録）。
+World Model コマンド（ADR-037）。設計文書・ソース・テスト・matrix・attestation を型付き事実グラフとして抽出し、pin された制約を両端点対称に再評価して義務を導出する。明示実行は config に依存せず常に可能。`world.enabled` のproduct既定値は`false`で、trueの場合に登録済み`L2-017` / `L3-008`とSessionStart integrationを有効化する。phasegate self-repoはdogfoodのためtrueである。
 
 | Command | Options | Description |
 |---|---|---|
@@ -337,6 +338,16 @@ World Model コマンド（ADR-037）。設計文書・ソース・テスト・m
 | `world:pin` | `--constraint <id>`（`pgw:v1:constraint` ID, 必須） `--endpoint <claimant\|premise>`（必須） `--apply` `--format human\|json` `--json` | 制約端点の現在 digest をプレビュー。`--apply` で `phasegate.world-constraints.json` を atomic に更新 |
 | `world:derive` | `--write` `--out <path>`（`--write` 必須） `--format human\|json` `--json` | immutable な obligation report を再導出。既定は pure・read-only。`--write` で raw report を `.harness/world-obligations.json`（untracked）へ永続化 |
 
+### Automatic integration
+
+| Surface | Contract |
+|---|---|
+| `L2-017 world-constraint-admission` | local fast-path。new / changed constraintのmalformed、新規pin / unpinned claimをfail-closed。adopted-legacyはwarningのみ。local resultは偽造可能でauthorityではない |
+| `L3-008 world-constraint-rederivation` | current corpusとversioned control inputからauthoritativeにpure再導出。保存`.harness/world-obligations.json`は読まず、改竄・削除で結果が変わらない |
+| SessionStart | blocking相当を優先して最大5件 / 2000 Unicode scalar。adopted-legacyは件数一行、全文やreasonをpromptへ注入しない。derive不能は固定warningへfail-open |
+| Attestation v2 | `phasegate-attestation/v2`がcanonical`worldSnapshotRoot`一件をpin。fragment digest collectionは保存しない。既存v1のproduce / verify互換を維持 |
+| Bundled `aidlc-gate` | `world.enabled:true`のprojectでmatrix生成後にpure deriveを二回実行してbyte一致を確認し、その後L3を実行。false / absentではWorld段階だけをskip |
+
 ### Exit code
 
 | Exit | 意味 |

package/docs/guide/configuration.md

@@ -76,6 +76,36 @@ The plan identifies target fields, managed artifacts, commands, validation, risk
     "format": "json",
     "outputDir": "reports"
   },
+  "world": {
+    "enabled": false,
+    "corpus": {
+      "productRoots": ["docs/product"],
+      "inceptionRoots": ["docs/inception"],
+      "adrRoots": ["docs/ADR"],
+      "sourceRoots": ["scripts/harness"],
+      "include": ["**/*"],
+      "exclude": []
+    },
+    "inputs": {
+      "matrixPath": ".harness/requirement-test-matrix.json",
+      "attestationPath": ".harness/attestation.json",
+      "integrityManifestPath": "phasegate.integrity.json"
+    },
+    "declarations": {
+      "constraintsPath": "phasegate.world-constraints.json",
+      "baselinePath": "phasegate.world-baseline.json",
+      "waiversPath": "phasegate.world-waivers.json",
+      "debtsPath": "phasegate.world-debts.json"
+    },
+    "output": {
+      "obligationReportPath": ".harness/world-obligations.json"
+    },
+    "sessionStart": {
+      "enabled": true,
+      "maxItems": 5,
+      "maxChars": 2000
+    }
+  },
   "preCommit": {
     "implementationExtensions": [".ts"]
   },
@@ -115,6 +145,8 @@ The `strict` preset also enables:
 - `bundleSizeLimit` -- 500 KB default cap
 - `deadCodeGC` -- automatic dead-code garbage collection
 
+All three presets resolve the same World Model defaults with `world.enabled: false`. This switch controls future automatic L2/L3 and hook integration; it does not disable explicit `world:inspect`, `world:pin`, or `world:derive` commands. Enabling automatic World gates remains an explicit rollout decision. <!-- @work-item-id WI-300 -->
+
 ---
 
 ### Field Reference
@@ -216,6 +248,30 @@ Example for Python and TypeScript:
 
 The metadata validators read `@unit` and `@layer` with language-agnostic regular expressions, so Python `# @unit api` and Go `// @unit api` style comments are both valid as long as the file extension is included here.
 
+#### `world`
+
+<!-- @work-item-id WI-300 -->
+
+`world` configures the World Model read corpus and reviewed control inputs. It is available in both v2 and v3 config schemas. Nested fields may be omitted and are resolved from the selected preset.
+
+| Field | Default | Meaning |
+|---|---|---|
+| `enabled` | `false` | Enables future automatic validator/hook integration; explicit `world:*` commands remain available |
+| `corpus.productRoots` | `["docs/product"]` | Canonical product corpus roots |
+| `corpus.inceptionRoots` | `["docs/inception"]` | Proposal/delta corpus roots |
+| `corpus.adrRoots` | `["docs/ADR"]` | ADR corpus roots |
+| `corpus.sourceRoots` | `["scripts/harness"]` | Source/test corpus roots |
+| `corpus.include` / `exclude` | `["**/*"]` / `[]` | Versioned selection patterns |
+| `inputs.matrixPath` | `.harness/requirement-test-matrix.json` | Matrix owner projection input |
+| `inputs.attestationPath` | `.harness/attestation.json` | Attestation evidence input |
+| `inputs.integrityManifestPath` | `phasegate.integrity.json` | Integrity declaration input |
+| `declarations.*Path` | `phasegate.world-{constraints,baseline,waivers,debts}.json` | Git-reviewed external declarations |
+| `output.obligationReportPath` | `.harness/world-obligations.json` | Generated, non-authoritative report path |
+| `sessionStart.enabled` | `true` | Allows the bounded World summary when session integration is installed |
+| `sessionStart.maxItems` / `maxChars` | `5` / `2000` | Summary caps; valid ranges are 1–20 and 1–8000 |
+
+All paths are project-relative POSIX paths. Absolute paths, backslashes, `.` / `..` segments, cross-role corpus root overlap, and case-fold collisions are rejected. When the matching World field is omitted, legacy `paths.designDocs`, `paths.inceptionDocs`, and `layers.L3.requirementMatrixPath` remain compatible inputs. A present but invalid `world` section fails closed; it is never replaced with defaults silently.
+
 #### `phase2Extensions`
 
 <!-- @work-item-id WI-170 -->

package/docs/guide/installation.md

@@ -56,7 +56,7 @@ npx phasegate install --apply
 npx phasegate doctor
 ```
 
-`install --dry-run` reports whether each target will be created, merged, skipped, or refused. `install --apply` performs the merge, adds package scripts and the `phasegate` devDependency, deploys selected bundled skills to root `skills/`, creates `.claude/skills` and `.codex/skills` links, writes `CLAUDE.md` / `AGENTS.md` managed sections for selected agent targets, writes `.github/workflows/phasegate-aidlc-gate.yml` when CI is enabled, and records managed entries in `.phasegate/manifest.json`. Existing skills catalogs are merged: PhaseGate refreshes only bundled skill directories selected by `--skills core|all` and preserves user-owned skills. See [Setup Artifacts](setup-artifacts.md) for the full managed target, generated artifact, runtime state, legacy artifact, and user-level setting inventory. <!-- @work-item-id WI-152 --> <!-- @work-item-id WI-169 --> <!-- @work-item-id WI-174 --> <!-- @work-item-id WI-216 -->
+`install --dry-run` reports whether each target will be created, merged, skipped, or refused. `install --apply` performs the merge, adds package scripts and the `phasegate` devDependency, deploys selected bundled skills to root `skills/`, creates `.claude/skills` and `.codex/skills` links, writes `CLAUDE.md` / `AGENTS.md` managed sections for selected agent targets, writes `.github/workflows/phasegate-aidlc-gate.yml` when CI is enabled, and records managed entries in `.phasegate/manifest.json`. Husky hook targets (`.husky/*`) and the GitHub Actions target are opt-in, matching `init` and `setup:agent`: pass `--with-husky` and/or `--with-ci` to include them — without these flags `install` does not touch `.husky/` or `.github/workflows/`. <!-- @work-item-id WI-316 --> Existing skills catalogs are merged: PhaseGate refreshes only bundled skill directories selected by `--skills core|all` and preserves user-owned skills. See [Setup Artifacts](setup-artifacts.md) for the full managed target, generated artifact, runtime state, legacy artifact, and user-level setting inventory. <!-- @work-item-id WI-152 --> <!-- @work-item-id WI-169 --> <!-- @work-item-id WI-174 --> <!-- @work-item-id WI-216 -->
 
 For personal evaluation inside a team-owned repository:
 

package/docs/templates/ci/aidlc-gate.yml

@@ -7,8 +7,11 @@
 # 実行内容:
 #   1. bypass:audit — bypass trailer / evidence 監査
 #   2. phasegate lint  — L1 Biome AST ルール検証
-#   3. phasegate:ci-check — L3 CI バリデータ（security / performance / coverage / nyquist）
-#   4. 失敗時: PR にエラーサマリーをコメント
+#   3. package の coverage script を実行し、L3-003 の入力を生成
+#   4. requirement-test matrix をcurrent testsから再生成
+#   5. world.enabled=true の場合、world:derive を2回実行してbyte一致を検証
+#   6. phasegate:ci-check — L3 CI バリデータ（security / performance / coverage / nyquist / World）
+#   7. 失敗時: PR にエラーサマリーをコメント
 
 name: AIDLC Quality Gate
 
@@ -77,6 +80,61 @@ jobs:
           echo "exit_code=$EXIT_CODE" >> $GITHUB_OUTPUT
           exit $EXIT_CODE
 
+      # L3-003 is fail-closed when coverageThreshold is configured but the
+      # report is absent. The adopting project owns this script and must emit
+      # coverage/coverage-summary.json; package-manager selection follows the
+      # lockfile used during dependency installation above.
+      - name: Test and generate coverage
+        shell: bash
+        run: |
+          set -euo pipefail
+          node -e "const scripts=require('./package.json').scripts ?? {}; if (!scripts.coverage) { throw new Error('phasegate aidlc-gate requires package.json scripts.coverage to generate coverage/coverage-summary.json'); }"
+          if [ -f pnpm-lock.yaml ]; then
+            pnpm run coverage
+          elif [ -f yarn.lock ]; then
+            yarn coverage
+          else
+            npm run coverage
+          fi
+
+      # L3-004 consumes the generated requirement-test matrix. Always rebuild it
+      # from this checkout instead of trusting a stale or persisted artifact.
+      - name: Generate requirement-test matrix
+        if: always()
+        run: npx phasegate phasegate:generate-matrix
+
+      # Automatic World integration is selected only by an explicit true value.
+      # Missing/false keeps existing projects compatible; invalid JSON is a hard
+      # configuration error and must not be laundered into a disabled result.
+      - name: Detect World Model enablement
+        id: world_config
+        if: always()
+        shell: bash
+        run: |
+          set -euo pipefail
+          ENABLED=$(node --input-type=module <<'NODE'
+          import { existsSync, readFileSync } from 'node:fs';
+          if (!existsSync('phasegate.config.json')) {
+            process.stdout.write('false');
+          } else {
+            const config = JSON.parse(readFileSync('phasegate.config.json', 'utf8'));
+            process.stdout.write(config.world?.enabled === true ? 'true' : 'false');
+          }
+          NODE
+          )
+          echo "enabled=$ENABLED" >> "$GITHUB_OUTPUT"
+
+      - name: World derive determinism
+        if: steps.world_config.outputs.enabled == 'true'
+        shell: bash
+        run: |
+          set -euo pipefail
+          FIRST="$RUNNER_TEMP/phasegate-world-first.json"
+          SECOND="$RUNNER_TEMP/phasegate-world-second.json"
+          npx phasegate world:derive --json > "$FIRST"
+          npx phasegate world:derive --json > "$SECOND"
+          cmp --silent "$FIRST" "$SECOND"
+
       # L3: CI バリデータ（security / performance / coverage / nyquist）
       - name: L3 CI Check
         id: ci_check

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.254.0",
+  "version": "0.283.0",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",
@@ -78,7 +78,7 @@
     "vitest": "^3.0.0"
   },
   "peerDependencies": {
-    "typescript": ">=5.0.0"
+    "typescript": ">=5.0.0 <7.0.0"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/scripts/harness/agent-integration/application/dto/open-world-obligations-context-dto.ts

@@ -0,0 +1,30 @@
+// @unit agent-integration
+// @layer application
+// @work-item-id WI-304
+
+export type OpenWorldObligationClassification =
+  | "new-structural"
+  | "invalid-declaration"
+  | "expired-waiver"
+  | "policy-diagnostic"
+  | "cleanup-required"
+  | "waived";
+
+export interface OpenWorldObligationContextItemDto {
+  readonly kind: "structural" | "cleanup-required" | "policy-diagnostic";
+  readonly classification: OpenWorldObligationClassification;
+  readonly ruleId: string | null;
+  readonly constraintId: string | null;
+  readonly violationFingerprint: string | null;
+  readonly subjectId: string | null;
+  readonly policyCode?: string | null;
+}
+
+export type OpenWorldObligationsContextDto =
+  | { readonly status: "disabled" }
+  | { readonly status: "unavailable" }
+  | {
+      readonly status: "available";
+      readonly entries: readonly OpenWorldObligationContextItemDto[];
+      readonly adoptedLegacyCount: number;
+    };

package/scripts/harness/agent-integration/application/ports/world-obligations-query-port.ts

@@ -0,0 +1,30 @@
+// @unit agent-integration
+// @layer application
+// @work-item-id WI-304
+
+export type QueriedWorldObligationClassification =
+  | "adopted-legacy"
+  | "new-structural"
+  | "invalid-declaration"
+  | "expired-waiver"
+  | "policy-diagnostic"
+  | "cleanup-required"
+  | "waived";
+
+export interface QueriedWorldObligationEntry {
+  readonly kind: "structural" | "cleanup-required" | "policy-diagnostic";
+  readonly classification: QueriedWorldObligationClassification;
+  readonly ruleId: string | null;
+  readonly constraintId: string | null;
+  readonly violationFingerprint: string | null;
+  readonly subjectId?: string | null;
+  readonly policyCode?: string | null;
+}
+
+export type WorldObligationsQueryResult =
+  | { readonly status: "available"; readonly entries: readonly QueriedWorldObligationEntry[] }
+  | { readonly status: "unavailable" };
+
+export interface WorldObligationsQueryPort {
+  query(): Promise<WorldObligationsQueryResult>;
+}

package/scripts/harness/agent-integration/application/usecases/get-open-world-obligations-context-usecase.ts

@@ -0,0 +1,66 @@
+// @unit agent-integration
+// @layer application
+// @work-item-id WI-304
+
+import type {
+  OpenWorldObligationContextItemDto,
+  OpenWorldObligationsContextDto,
+} from "../dto/open-world-obligations-context-dto.js";
+import type { QueriedWorldObligationEntry, WorldObligationsQueryPort } from "../ports/world-obligations-query-port.js";
+
+interface Dependencies {
+  readonly worldObligationsQueryPort: WorldObligationsQueryPort;
+}
+
+const priority = (entry: OpenWorldObligationContextItemDto): number => {
+  if (entry.classification === "new-structural" || entry.classification === "invalid-declaration") return 0;
+  if (entry.classification === "expired-waiver" || entry.classification === "policy-diagnostic") return 1;
+  if (entry.classification === "cleanup-required") return 2;
+  return 3;
+};
+
+const stableKey = (entry: OpenWorldObligationContextItemDto): string =>
+  [
+    priority(entry).toString().padStart(2, "0"),
+    entry.ruleId ?? "",
+    entry.constraintId ?? "",
+    entry.violationFingerprint ?? "",
+    entry.subjectId ?? "",
+    entry.policyCode ?? "",
+  ].join("\u0000");
+
+type DisplayableQueriedEntry = QueriedWorldObligationEntry & {
+  readonly classification: Exclude<QueriedWorldObligationEntry["classification"], "adopted-legacy">;
+};
+
+const isDisplayable = (entry: QueriedWorldObligationEntry): entry is DisplayableQueriedEntry =>
+  entry.classification !== "adopted-legacy";
+
+const toContextItem = (entry: DisplayableQueriedEntry): OpenWorldObligationContextItemDto => ({
+  kind: entry.kind,
+  classification: entry.classification,
+  ruleId: entry.ruleId,
+  constraintId: entry.constraintId,
+  violationFingerprint: entry.violationFingerprint,
+  subjectId: entry.subjectId ?? null,
+  policyCode: entry.policyCode ?? null,
+});
+
+export class GetOpenWorldObligationsContextUseCase {
+  constructor(private readonly dependencies: Dependencies) {}
+
+  async execute(input: { readonly enabled: boolean }): Promise<OpenWorldObligationsContextDto> {
+    if (!input.enabled) return { status: "disabled" };
+
+    const result = await this.dependencies.worldObligationsQueryPort.query();
+    if (result.status === "unavailable") return { status: "unavailable" };
+
+    const adoptedLegacyCount = result.entries.filter((entry) => entry.classification === "adopted-legacy").length;
+    const entries = result.entries
+      .filter(isDisplayable)
+      .map(toContextItem)
+      .sort((left, right) => (stableKey(left) < stableKey(right) ? -1 : stableKey(left) > stableKey(right) ? 1 : 0));
+
+    return { status: "available", entries: Object.freeze(entries), adoptedLegacyCount };
+  }
+}