phasegate 0.254.0 → 0.283.0

package/scripts/harness/agent-integration/infrastructure/adapters/harness-config-config-query-adapter.ts

@@ -6,13 +6,9 @@
  * HarnessConfigV2 の harnesses セクションから Hook 設定を読み取る
  */
 
-import * as fs from 'node:fs';
-import type {
-  BaselineConfig,
-  ConfigQueryPort,
-  HookType,
-} from '../../domain/ports/config-query-port.js';
-import { ProjectPaths } from '../../domain/value-objects/project-paths.js';
+import * as fs from "node:fs";
+import type { BaselineConfig, ConfigQueryPort, HookType } from "../../domain/ports/config-query-port.js";
+import { ProjectPaths } from "../../domain/value-objects/project-paths.js";
 
 interface ProjectDocsSection {
   inception?: string;
@@ -84,8 +80,22 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
     if (this.cachedConfig !== null) {
       return this.cachedConfig;
     }
-    const raw = fs.readFileSync(this.configPath, 'utf8');
-    const doc = JSON.parse(raw) as HarnessConfigDocument;
+    // GitHub #40: config が JSON として壊れている場合に hook プロセス全体を throw で
+    // 落とすと、エージェントの全ツール呼び出しが遮断され config の修復自体が不能になる。
+    // main.ts の ConfigPersistenceError と同じ意味論（警告 + 既定値で続行）に揃える。
+    // ファイル不在等の fs エラーは既存契約どおり throw する（上流の catch が defaults を
+    // 適用する）。gated スコープへの書き込みは phase-gate 側が fail-closed でブロックする。
+    const raw = fs.readFileSync(this.configPath, "utf8");
+    let doc: HarnessConfigDocument;
+    try {
+      doc = JSON.parse(raw) as HarnessConfigDocument;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      process.stderr.write(
+        `Warning: phasegate.config.json could not be parsed as JSON (${message}); continuing with default hook settings so self-repair stays possible.\n`,
+      );
+      doc = {};
+    }
     this.cachedConfig = doc;
     return doc;
   }
@@ -98,10 +108,10 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
     // pre-tool-use → agentLessonCollection
     // post-tool-use → cascadeUpdate
     // stop → デフォルト有効
-    if (hookType === 'pre-tool-use') {
+    if (hookType === "pre-tool-use") {
       return harnesses.agentLessonCollection ?? true;
     }
-    if (hookType === 'post-tool-use') {
+    if (hookType === "post-tool-use") {
       return harnesses.cascadeUpdate ?? true;
     }
     // stop はデフォルト有効
@@ -111,13 +121,9 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
   async getProtectedFilePatterns(): Promise<string[]> {
     const config = this.loadConfig();
     const configured = config.protectedFiles?.patterns ?? [];
-    const principlesDocs = config.paths?.principlesDocs ?? 'docs/principles';
-    const folderRulesDoc = config.paths?.folderRulesDoc ?? 'docs/folder_management_rules.md';
-    return [
-      ...configured,
-      `${normalizeProjectPath(principlesDocs)}/**`,
-      normalizeProjectPath(folderRulesDoc),
-    ];
+    const principlesDocs = config.paths?.principlesDocs ?? "docs/principles";
+    const folderRulesDoc = config.paths?.folderRulesDoc ?? "docs/folder_management_rules.md";
+    return [...configured, `${normalizeProjectPath(principlesDocs)}/**`, normalizeProjectPath(folderRulesDoc)];
   }
 
   async getProtectedFileExclusions(): Promise<string[]> {
@@ -135,13 +141,10 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
     const paths = config.project?.paths;
     const topLevelPaths = config.paths;
 
-    return ProjectPaths.create(
-      paths?.source ?? ['scripts/harness'],
-      {
-        construction: paths?.docs?.construction ?? topLevelPaths?.designDocs ?? 'docs/product/construction',
-        inception: paths?.docs?.inception ?? topLevelPaths?.inceptionDocs ?? 'docs/inception',
-      },
-    );
+    return ProjectPaths.create(paths?.source ?? ["scripts/harness"], {
+      construction: paths?.docs?.construction ?? topLevelPaths?.designDocs ?? "docs/product/construction",
+      inception: paths?.docs?.inception ?? topLevelPaths?.inceptionDocs ?? "docs/inception",
+    });
   }
 
   async getBaselineConfig(): Promise<BaselineConfig> {
@@ -149,7 +152,7 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
     const baseline = config.baseline ?? {};
     return {
       enabled: baseline.enabled ?? true,
-      path: baseline.path ?? '.phasegate/baseline.json',
+      path: baseline.path ?? ".phasegate/baseline.json",
     };
   }
 
@@ -162,5 +165,5 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
 }
 
 function normalizeProjectPath(path: string): string {
-  return path.replace(/\\/g, '/').replace(/\/+$/g, '');
+  return path.replace(/\\/g, "/").replace(/\/+$/g, "");
 }

package/scripts/harness/agent-integration/infrastructure/adapters/world-model-open-obligations-query-adapter.ts

@@ -0,0 +1,58 @@
+// @unit agent-integration
+// @layer infrastructure
+// @work-item-id WI-304
+
+import { createWorldModelModule, type WorldResolvedConfigInput } from "../../../world-model/index.js";
+import type {
+  QueriedWorldObligationEntry,
+  WorldObligationsQueryPort,
+  WorldObligationsQueryResult,
+} from "../../application/ports/world-obligations-query-port.js";
+
+interface Options {
+  readonly rootDir: string;
+  readonly resolvedConfig?: WorldResolvedConfigInput;
+}
+
+export class WorldModelOpenObligationsQueryAdapter implements WorldObligationsQueryPort {
+  constructor(private readonly options: Options) {}
+
+  async query(): Promise<WorldObligationsQueryResult> {
+    try {
+      const world = createWorldModelModule(this.options);
+      const derived = await world.deriveWorldObligationsUseCase.execute({ writeReport: false });
+      if (derived.status !== "derived") return { status: "unavailable" };
+
+      const report = derived.result.report;
+      const entries: QueriedWorldObligationEntry[] = [
+        ...report.structuralObligations.map((entry) => ({
+          kind: "structural" as const,
+          classification: entry.classification,
+          ruleId: entry.ruleId,
+          constraintId: entry.constraintId,
+          violationFingerprint: entry.violationFingerprint,
+        })),
+        ...report.repaidBaselineEntries.map((entry) => ({
+          kind: "cleanup-required" as const,
+          classification: "cleanup-required" as const,
+          ruleId: entry.ruleId,
+          constraintId: entry.constraintId,
+          violationFingerprint: entry.violationFingerprint,
+        })),
+        ...report.policyDiagnostics.map((entry) => ({
+          kind: "policy-diagnostic" as const,
+          classification:
+            entry.code === "expired-waiver" ? ("expired-waiver" as const) : ("policy-diagnostic" as const),
+          ruleId: null,
+          constraintId: null,
+          violationFingerprint: null,
+          subjectId: entry.subjectId,
+          policyCode: entry.code,
+        })),
+      ];
+      return { status: "available", entries: Object.freeze(entries) };
+    } catch {
+      return { status: "unavailable" };
+    }
+  }
+}

package/scripts/harness/agent-integration/presentation/post-tool-use-hook.ts

@@ -2,18 +2,19 @@
  * @layer presentation
  * @unit agent-integration
  * @work-item-id WI-208
+ * @work-item-id WI-323
  *
  * PostToolUse Hook Adapter
  * Claude Code の PostToolUse Hook エントリポイント
  */
 
-import { HandlePostToolUseUseCase } from '../application/usecases/handle-post-tool-use-usecase.js';
-import { HarnessConfigConfigQueryAdapter } from '../infrastructure/adapters/harness-config-config-query-adapter.js';
-import { HarnessApiCliCommandRegistryAdapter } from '../infrastructure/adapters/harness-api-cli-command-registry-adapter.js';
-import { ChildProcessCliExecutorAdapter } from '../infrastructure/adapters/child-process-cli-executor-adapter.js';
-import { recordHookSkipEvent } from './hook-skip-event-recorder.js';
-import * as path from 'node:path';
-import * as fs from 'node:fs/promises';
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { HandlePostToolUseUseCase } from "../application/usecases/handle-post-tool-use-usecase.js";
+import { ChildProcessCliExecutorAdapter } from "../infrastructure/adapters/child-process-cli-executor-adapter.js";
+import { HarnessApiCliCommandRegistryAdapter } from "../infrastructure/adapters/harness-api-cli-command-registry-adapter.js";
+import { HarnessConfigConfigQueryAdapter } from "../infrastructure/adapters/harness-config-config-query-adapter.js";
+import { recordHookSkipEvent } from "./hook-skip-event-recorder.js";
 
 interface PostToolUseHookInput {
   tool_name?: string;
@@ -25,15 +26,15 @@ async function readStdin(): Promise<string> {
   for await (const chunk of process.stdin) {
     chunks.push(chunk as Buffer);
   }
-  return Buffer.concat(chunks).toString('utf8');
+  return Buffer.concat(chunks).toString("utf8");
 }
 
 async function findConfigPath(): Promise<string> {
   let dir = process.cwd();
   while (true) {
     const candidates = [
-      path.join(dir, 'phasegate.config.json'),
-      path.join(dir, '.phasegate-local', 'phasegate.config.json'),
+      path.join(dir, "phasegate.config.json"),
+      path.join(dir, ".phasegate-local", "phasegate.config.json"),
     ];
     for (const candidate of candidates) {
       try {
@@ -45,12 +46,12 @@ async function findConfigPath(): Promise<string> {
     if (parent === dir) break;
     dir = parent;
   }
-  return path.join(process.cwd(), 'phasegate.config.json');
+  return path.join(process.cwd(), "phasegate.config.json");
 }
 
 function projectRootForConfig(configPath: string): string {
   const configDir = path.dirname(configPath);
-  return path.basename(configDir) === '.phasegate-local' ? path.dirname(configDir) : configDir;
+  return path.basename(configDir) === ".phasegate-local" ? path.dirname(configDir) : configDir;
 }
 
 async function main(): Promise<void> {
@@ -58,7 +59,7 @@ async function main(): Promise<void> {
   try {
     raw = await readStdin();
   } catch {
-    process.stderr.write('stdin読み取りエラー\n');
+    process.stderr.write("stdin読み取りエラー\n");
     process.exit(2);
   }
 
@@ -72,8 +73,20 @@ async function main(): Promise<void> {
 
   const toolName = input.tool_name;
   if (!toolName) {
-    process.stderr.write('tool_nameフィールドが必要です\n');
-    process.exit(2);
+    // WI-323: PostToolUse はツール実行後の lint フィードバックでありゲートではないため、
+    // tool_name 欠落は fail-open でスキップする（WI-314 / github#40 方針）。
+    // ※ pre-tool-use-hook の同ガードは書き込みゲートなので fail-closed (exit 2) を維持する。
+    const configPath = await findConfigPath();
+    await recordHookSkipEvent({
+      projectRoot: projectRootForConfig(configPath),
+      hookType: "post-tool-use",
+      reason: "TOOL_NAME_MISSING",
+      targetPaths: [],
+    });
+    process.stderr.write(
+      "警告: stdin payload に tool_name が無いため post-tool-use hook の処理をスキップしました (fail-open)\n",
+    );
+    process.exit(0);
   }
 
   try {
@@ -93,7 +106,7 @@ async function main(): Promise<void> {
     if (output.skipReason) {
       await recordHookSkipEvent({
         projectRoot: projectRootForConfig(configPath),
-        hookType: 'post-tool-use',
+        hookType: "post-tool-use",
         reason: output.skipReason,
         targetPaths: [],
       });

package/scripts/harness/agent-integration/presentation/session-start-hook.ts

@@ -1,13 +1,18 @@
 // @unit agent-integration
 // @layer presentation
+// @work-item-id WI-304
 
 import { buildCiGovernance } from "../../ci-governance/composition-root.js";
+import { createConfigFoundationModule, toWorldModelConfig } from "../../config-foundation/index.js";
+import { GetOpenWorldObligationsContextUseCase } from "../application/usecases/get-open-world-obligations-context-usecase.js";
+import { WorldModelOpenObligationsQueryAdapter } from "../infrastructure/adapters/world-model-open-obligations-query-adapter.js";
 import {
   buildIntegrityUnverifiableWarning,
   buildIntegrityWarning,
   buildSessionStartContext,
   collectPhasegateStatus,
 } from "./phasegate-status-context.js";
+import { buildWorldObligationsSessionContext } from "./world-obligations-session-context.js";
 
 async function readStdin(): Promise<string> {
   const chunks: Buffer[] = [];
@@ -36,6 +41,36 @@ async function buildIntegrityContext(cwd: string): Promise<string | null> {
   }
 }
 
+/**
+ * World の保存済み report は読まず、公開 facade の pure derive から現在の open obligation を要約する。
+ * config/derive の失敗は固定 warning へ縮退し、repository 由来のエラー文字列は中継しない。
+ */
+async function buildWorldContext(cwd: string): Promise<string | null> {
+  try {
+    const configModule = createConfigFoundationModule();
+    const resolved = await configModule.usecases.loadResolvedConfigUseCase.execute();
+    const worldConfig = toWorldModelConfig(resolved.config);
+    if (worldConfig === undefined) return null;
+
+    const contextUseCase = new GetOpenWorldObligationsContextUseCase({
+      worldObligationsQueryPort: new WorldModelOpenObligationsQueryAdapter({
+        rootDir: cwd,
+        resolvedConfig: worldConfig,
+      }),
+    });
+    const context = await contextUseCase.execute({
+      enabled: worldConfig.enabled && worldConfig.sessionStart.enabled,
+    });
+    return buildWorldObligationsSessionContext(context, {
+      maxItems: worldConfig.sessionStart.maxItems,
+      maxChars: worldConfig.sessionStart.maxChars,
+    });
+  } catch (error) {
+    if (error instanceof Error && error.name === "ConfigNotFoundError") return null;
+    return buildWorldObligationsSessionContext({ status: "unavailable" }, { maxItems: 5, maxChars: 2000 });
+  }
+}
+
 async function main(): Promise<void> {
   try {
     await readStdin();
@@ -46,7 +81,8 @@ async function main(): Promise<void> {
   const status = await collectPhasegateStatus(process.cwd());
   const baseContext = buildSessionStartContext(status);
   const integrityContext = await buildIntegrityContext(process.cwd());
-  const additionalContext = integrityContext === null ? baseContext : `${integrityContext}\n\n${baseContext}`;
+  const worldContext = await buildWorldContext(process.cwd());
+  const additionalContext = [integrityContext, worldContext, baseContext].filter((item) => item !== null).join("\n\n");
 
   const output = {
     hookSpecificOutput: {

package/scripts/harness/agent-integration/presentation/stop-hook.ts

@@ -3,19 +3,20 @@
  * @unit agent-integration
  * @work-item-id WI-203
  * @work-item-id WI-208
+ * @work-item-id WI-323
  *
  * Stop Hook Adapter
  * Claude Code の Stop Hook エントリポイント
  */
 
-import { HandleStopUseCase } from '../application/usecases/handle-stop-usecase.js';
-import { EnvFileReentryGuardStateAdapter } from '../infrastructure/adapters/env-file-reentry-guard-state-adapter.js';
-import { HarnessConfigConfigQueryAdapter } from '../infrastructure/adapters/harness-config-config-query-adapter.js';
-import { HarnessApiCliCommandRegistryAdapter } from '../infrastructure/adapters/harness-api-cli-command-registry-adapter.js';
-import { ChildProcessCliExecutorAdapter } from '../infrastructure/adapters/child-process-cli-executor-adapter.js';
-import { recordHookSkipEvent } from './hook-skip-event-recorder.js';
-import * as path from 'node:path';
-import * as fs from 'node:fs/promises';
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { HandleStopUseCase } from "../application/usecases/handle-stop-usecase.js";
+import { ChildProcessCliExecutorAdapter } from "../infrastructure/adapters/child-process-cli-executor-adapter.js";
+import { EnvFileReentryGuardStateAdapter } from "../infrastructure/adapters/env-file-reentry-guard-state-adapter.js";
+import { HarnessApiCliCommandRegistryAdapter } from "../infrastructure/adapters/harness-api-cli-command-registry-adapter.js";
+import { HarnessConfigConfigQueryAdapter } from "../infrastructure/adapters/harness-config-config-query-adapter.js";
+import { recordHookSkipEvent } from "./hook-skip-event-recorder.js";
 
 interface StopHookInput {
   session_id?: string;
@@ -23,8 +24,7 @@ interface StopHookInput {
 
 function isCompleteCheckExecutionWiringFailure(stderr: string): boolean {
   return (
-    /scripts\/harness\/cli\/complete-check\.ts/.test(stderr) ||
-    /ERR_MODULE_NOT_FOUND|Cannot find module/i.test(stderr)
+    /scripts\/harness\/cli\/complete-check\.ts/.test(stderr) || /ERR_MODULE_NOT_FOUND|Cannot find module/i.test(stderr)
   );
 }
 
@@ -40,15 +40,15 @@ async function readStdin(): Promise<string> {
   for await (const chunk of process.stdin) {
     chunks.push(chunk as Buffer);
   }
-  return Buffer.concat(chunks).toString('utf8');
+  return Buffer.concat(chunks).toString("utf8");
 }
 
 async function findConfigPath(): Promise<string> {
   let dir = process.cwd();
   while (true) {
     const candidates = [
-      path.join(dir, 'phasegate.config.json'),
-      path.join(dir, '.phasegate-local', 'phasegate.config.json'),
+      path.join(dir, "phasegate.config.json"),
+      path.join(dir, ".phasegate-local", "phasegate.config.json"),
     ];
     for (const candidate of candidates) {
       try {
@@ -60,12 +60,12 @@ async function findConfigPath(): Promise<string> {
     if (parent === dir) break;
     dir = parent;
   }
-  return path.join(process.cwd(), 'phasegate.config.json');
+  return path.join(process.cwd(), "phasegate.config.json");
 }
 
 function projectRootForConfig(configPath: string): string {
   const configDir = path.dirname(configPath);
-  return path.basename(configDir) === '.phasegate-local' ? path.dirname(configDir) : configDir;
+  return path.basename(configDir) === ".phasegate-local" ? path.dirname(configDir) : configDir;
 }
 
 async function main(): Promise<void> {
@@ -73,7 +73,7 @@ async function main(): Promise<void> {
   try {
     raw = await readStdin();
   } catch {
-    process.stderr.write('stdin読み取りエラー\n');
+    process.stderr.write("stdin読み取りエラー\n");
     process.exit(2);
   }
 
@@ -87,13 +87,24 @@ async function main(): Promise<void> {
 
   const sessionId = input.session_id;
   if (!sessionId) {
-    process.stderr.write('session_idフィールドが必要です\n');
-    process.exit(2);
+    // WI-323: session_id 欠落は呼び出し側環境の不備であり、stop hook はゲートではないため
+    // fail-open でスキップする（WI-314 / github#40 の「hook は開発フローを止めない」方針）。
+    const configPath = await findConfigPath();
+    await recordHookSkipEvent({
+      projectRoot: projectRootForConfig(configPath),
+      hookType: "stop",
+      reason: "SESSION_ID_MISSING",
+      targetPaths: [],
+    });
+    process.stderr.write(
+      "警告: stdin payload に session_id が無いため stop hook の処理をスキップしました (fail-open)\n",
+    );
+    process.exit(0);
   }
 
   try {
     const configPath = await findConfigPath();
-    const reentryGuardStatePort = new EnvFileReentryGuardStateAdapter({ strategy: 'env' });
+    const reentryGuardStatePort = new EnvFileReentryGuardStateAdapter({ strategy: "env" });
     const configQueryPort = new HarnessConfigConfigQueryAdapter(configPath);
     const cliCommandRegistryPort = new HarnessApiCliCommandRegistryAdapter();
     const cliExecutorPort = new ChildProcessCliExecutorAdapter();
@@ -107,14 +118,14 @@ async function main(): Promise<void> {
 
     const output = await useCase.execute({ sessionId });
 
-    if (output.skipReason === 'REENTRY_DETECTED') {
+    if (output.skipReason === "REENTRY_DETECTED") {
       await recordHookSkipEvent({
         projectRoot: projectRootForConfig(configPath),
-        hookType: 'stop',
+        hookType: "stop",
         reason: output.skipReason,
         targetPaths: [],
       });
-      process.stderr.write('ReentryGuard: 再入検出によりスキップ\n');
+      process.stderr.write("ReentryGuard: 再入検出によりスキップ\n");
       process.exit(0);
     }
 
@@ -123,10 +134,8 @@ async function main(): Promise<void> {
         // WI-087 finding #4: enforce=true なら exit 2 + decision JSON で turn block
         if (output.shouldEnforceFailure === true) {
           const reason = formatCompleteCheckFailureReason(output.cliResult.exitCode, output.cliResult.stderr);
-          process.stdout.write(`${JSON.stringify({ decision: 'block', reason })}\n`);
-          process.stderr.write(
-            `${reason} — strict mode により turn を block します\n`,
-          );
+          process.stdout.write(`${JSON.stringify({ decision: "block", reason })}\n`);
+          process.stderr.write(`${reason} — strict mode により turn を block します\n`);
           process.exit(2);
         }
         process.stderr.write(`Complete Check失敗 (exitCode=${output.cliResult.exitCode})\n`);

package/scripts/harness/agent-integration/presentation/world-obligations-session-context.ts

@@ -0,0 +1,60 @@
+// @unit agent-integration
+// @layer presentation
+// @work-item-id WI-304
+
+import type {
+  OpenWorldObligationContextItemDto,
+  OpenWorldObligationsContextDto,
+} from "../application/dto/open-world-obligations-context-dto.js";
+
+const UNAVAILABLE_WARNING =
+  "⚠ World obligations unavailable at SessionStart; continuing fail-open. Run phasegate world:derive.";
+const HEADER = "## World open obligations (SessionStart)";
+const HARD_MAX_ITEMS = 5;
+const HARD_MAX_CHARS = 2000;
+
+export const countUnicodeScalars = (value: string): number => [...value].length;
+
+const renderEntry = (entry: OpenWorldObligationContextItemDto): string => {
+  if (entry.kind === "policy-diagnostic") {
+    return `- [BLOCKING ${entry.classification}] subject=${entry.subjectId ?? "unknown"}`;
+  }
+  const label =
+    entry.classification === "cleanup-required"
+      ? "CLEANUP"
+      : entry.classification === "waived"
+        ? "WAIVED"
+        : `BLOCKING ${entry.classification}`;
+  return `- [${label}] ${entry.ruleId ?? "unknown-rule"} constraint=${entry.constraintId ?? "implicit"} fingerprint=${entry.violationFingerprint ?? "none"}`;
+};
+
+const renderAvailable = (
+  input: Extract<OpenWorldObligationsContextDto, { status: "available" }>,
+  shown: number,
+): string => {
+  const lines = [HEADER, ...input.entries.slice(0, shown).map(renderEntry)];
+  if (input.adoptedLegacyCount > 0) lines.push(`- Adopted legacy: ${input.adoptedLegacyCount} (summary only)`);
+  if (input.entries.length === 0 && input.adoptedLegacyCount === 0) lines.push("- None.");
+  const omitted = input.entries.length - shown;
+  if (omitted > 0) lines.push(`... ${omitted} more; run phasegate world:derive`);
+  return lines.join("\n");
+};
+
+export function buildWorldObligationsSessionContext(
+  input: OpenWorldObligationsContextDto,
+  limits: { readonly maxItems: number; readonly maxChars: number },
+): string | null {
+  const maxItems = Math.min(limits.maxItems, HARD_MAX_ITEMS);
+  const maxChars = Math.min(limits.maxChars, HARD_MAX_CHARS);
+  if (input.status === "disabled") return null;
+  if (input.status === "unavailable") {
+    return countUnicodeScalars(UNAVAILABLE_WARNING) <= maxChars ? UNAVAILABLE_WARNING : null;
+  }
+
+  const maximumShown = Math.min(input.entries.length, maxItems);
+  for (let shown = maximumShown; shown >= 0; shown -= 1) {
+    const candidate = renderAvailable(input, shown);
+    if (countUnicodeScalars(candidate) <= maxChars) return candidate;
+  }
+  return null;
+}

package/scripts/harness/attestation/application/dto/attestation-document.ts

@@ -1,8 +1,9 @@
 // @unit attestation
 // @layer application
+// @work-item-id WI-306
 
 /**
- * record format `phasegate-attestation/v1` の plain object 表現（logical_design §1.4.3）。
+ * versioned record formatのplain object表現（logical_design §1.4.3 / WI-306）。
  * ファイル入出力・stdout エコー・mapper の境界で用いる契約型。VO はプリミティブ展開する。
  */
 export interface AttestationDocumentValidatorOutcome {
@@ -23,9 +24,7 @@ export interface AttestationDocumentGranularityClaim {
   readonly knownLimitations: string[];
 }
 
-export interface AttestationDocument {
-  readonly schemaVersion: "phasegate-attestation/v1";
-  readonly predicateType: string;
+interface AttestationDocumentBase {
   readonly subject: {
     readonly command: string;
     readonly gateResult: "pass" | "fail";
@@ -54,3 +53,17 @@ export interface AttestationDocument {
     readonly value: string | null;
   };
 }
+
+export interface AttestationDocumentV1 extends AttestationDocumentBase {
+  readonly schemaVersion: "phasegate-attestation/v1";
+  readonly predicateType: "https://phasegate.dev/attestation/gate-run/v1";
+}
+
+export interface AttestationDocumentV2 extends AttestationDocumentBase {
+  readonly schemaVersion: "phasegate-attestation/v2";
+  readonly predicateType: "https://phasegate.dev/attestation/gate-run/v2";
+  /** 実行時のWorld canonical corpusRoot。個別fragment digestは保持しない。 */
+  readonly worldSnapshotRoot: string;
+}
+
+export type AttestationDocument = AttestationDocumentV1 | AttestationDocumentV2;