@moretea-labs/forge 1.7.2 → 1.8.1

package/docs/architecture/requests/archive/2026/20260613-002040-runtime-harness-hook-adapters.md

@@ -1,68 +0,0 @@
-# Architecture Queue Card: runtime-harness-hook-adapters
-
-> **Status**: Resolved
-> **Detected**: 2026-06-13T00:01:34+0800
-> **Updated**: 2026-06-13T00:04:13+0800
-> **Severity**: high
-> **Change Type**: workflow-surface
-> **File**: `.ai/hooks/post-tool-observer.sh`
-> **Functional Block**: `.ai/hooks`
-> **Capability ID**: `runtime-harness-hook-adapters`
-> **Matched Prefix**: `.ai/hooks`
-> **Architecture Domain**: `runtime-harness`
-> **Architecture Capability**: `hook-adapters`
-> **Architecture Module**: `docs/architecture/modules/runtime-harness/hook-adapters.md`
-> **Workstream Directory**: `tasks/workstreams/runtime-harness/hook-adapters`
-> **Contract Files**: `assets/hooks/AGENTS.md`, `assets/hooks/CLAUDE.md`
-> **Contract Sync Required**: true
-> **Spawn Recommended**: true
-> **Open Edits**: 1
-
-## Required Follow-up
-
-- Read root `AGENTS.md` / `CLAUDE.md`.
-- If functional block is not `root`, read its local `AGENTS.md` / `CLAUDE.md`.
-- Decide whether this change affects module boundaries, entrypoints, dependency rules, runtime paths, or verification commands.
-- For substantial changes, write a snapshot under `docs/architecture/snapshots/`.
-- When a visual explains the boundary better than prose, add or update a Mermaid fenced block in the relevant architecture module or snapshot Markdown first; that Markdown is the semantic source for LLM readers.
-- When a human-readable rendering is useful, generate a matching `$mermaid` architecture HTML file under `docs/architecture/diagrams/` and link it back to the Markdown semantic source.
-- Treat `mermaid` as an external installed skill dependency at `~/.codex/skills/mermaid`; do not copy, vendor, or inline its templates into this repo.
-- If this starts or advances durable execution, run `scripts/workstream-sync.sh ensure --block ".ai/hooks" --request "docs/architecture/requests/runtime-harness-hook-adapters.md"`.
-- After the snapshot or diagram is produced, run `scripts/context-contract-sync.sh sync-latest` so the local architecture contract block links to the latest artifacts.
-
-## Touched Files
-
-| Last Event | Severity | Change Type | File |
-| --- | --- | --- | --- |
-| 2026-06-13T00:04:13+0800 | high | workflow-surface | `.ai/hooks/post-tool-observer.sh` |
-
-## Event Fields
-
-```json
-{
-  "ts": "2026-06-13T00:04:13+0800",
-  "file_path": ".ai/hooks/post-tool-observer.sh",
-  "severity": "high",
-  "functional_block": ".ai/hooks",
-  "capability_id": "runtime-harness-hook-adapters",
-  "matched_prefix": ".ai/hooks",
-  "architecture_domain": "runtime-harness",
-  "architecture_capability": "hook-adapters",
-  "architecture_module": "docs/architecture/modules/runtime-harness/hook-adapters.md",
-  "workstream_dir": "tasks/workstreams/runtime-harness/hook-adapters",
-  "contract_agents": "assets/hooks/AGENTS.md",
-  "contract_claude": "assets/hooks/CLAUDE.md",
-  "change_type": "workflow-surface",
-  "request_file": "docs/architecture/requests/runtime-harness-hook-adapters.md",
-  "spawn_recommended": true,
-  "contract_sync_required": true
-}
-```
-
-## Archive Resolution
-
-- Status: Resolved
-- Archived: 2026-06-13T00:20:40+0800
-- Artifacts:
-- `docs/architecture/modules/runtime-harness/hook-adapters.md`
-- Note: Resolved by documenting that PRD/Sprint helper runtime isolation keeps hook routes under .ai/hooks, moves generated workflow helpers to .ai/harness/scripts, and introduces no post-tool-observer route boundary change.

package/docs/architecture/requests/archive/2026/root.md

@@ -1,68 +0,0 @@
-# Architecture Queue Card: root
-
-> **Status**: No architecture change
-> **Detected**: 2026-05-29T00:03:22+0800
-> **Updated**: 2026-06-12T03:34:14+0800
-> **Severity**: medium
-> **Change Type**: boundary-or-config
-> **File**: `apps/web/src/routes/account.tsx`
-> **Functional Block**: `root`
-> **Capability ID**: `root`
-> **Matched Prefix**: `root`
-> **Architecture Domain**: `root`
-> **Architecture Capability**: `_root`
-> **Architecture Module**: `docs/architecture/index.md`
-> **Workstream Directory**: `tasks/workstreams/root/_root`
-> **Contract Files**: `none`, `none`
-> **Contract Sync Required**: false
-> **Spawn Recommended**: false
-> **Open Edits**: 2
-
-## Required Follow-up
-
-- Read root `AGENTS.md` / `CLAUDE.md`.
-- If functional block is not `root`, read its local `AGENTS.md` / `CLAUDE.md`.
-- Decide whether this change affects module boundaries, entrypoints, dependency rules, runtime paths, or verification commands.
-- For substantial changes, write a snapshot under `docs/architecture/snapshots/`.
-- When a visual explains the boundary better than prose, add or update a Mermaid fenced block in the relevant architecture module or snapshot Markdown first; that Markdown is the semantic source for LLM readers.
-- When a human-readable rendering is useful, generate a matching `$mermaid` architecture HTML file under `docs/architecture/diagrams/` and link it back to the Markdown semantic source.
-- Treat `mermaid` as an external installed skill dependency at `~/.codex/skills/mermaid`; do not copy, vendor, or inline its templates into this repo.
-- If this starts or advances durable execution, run `scripts/workstream-sync.sh ensure --block "root" --request "docs/architecture/requests/root.md"`.
-- After the snapshot or diagram is produced, run `scripts/context-contract-sync.sh sync-latest` so the local architecture contract block links to the latest artifacts.
-
-## Touched Files
-
-| Last Event | Severity | Change Type | File |
-| --- | --- | --- | --- |
-| 2026-06-12T03:34:14+0800 | medium | boundary-or-config | `apps/web/src/routes/account.tsx` |
-| 2026-05-29T00:03:22+0800 | medium | boundary-or-config | `package.json` |
-
-## Event Fields
-
-```json
-{
-  "ts": "2026-06-12T03:34:14+0800",
-  "file_path": "apps/web/src/routes/account.tsx",
-  "severity": "medium",
-  "functional_block": "root",
-  "capability_id": "root",
-  "matched_prefix": "root",
-  "architecture_domain": "root",
-  "architecture_capability": "_root",
-  "architecture_module": "docs/architecture/index.md",
-  "workstream_dir": "tasks/workstreams/root/_root",
-  "contract_agents": "",
-  "contract_claude": "",
-  "change_type": "boundary-or-config",
-  "request_file": "docs/architecture/requests/root.md",
-  "spawn_recommended": false,
-  "contract_sync_required": false
-}
-```
-
-## Archive Resolution
-
-- Status: No architecture change
-- Archived: 2026-06-12T03:36:05+0800
-- Artifacts: (none)
-- Note: Root-level pending card did not require an architecture boundary change for this queue migration.

package/docs/architecture/requests/archive/2026/runtime-harness-hook-adapters.md

@@ -1,76 +0,0 @@
-# Architecture Queue Card: runtime-harness-hook-adapters
-
-> **Status**: Resolved
-> **Detected**: 2026-05-28T15:47:40+0800
-> **Updated**: 2026-05-29T09:44:46+0800
-> **Severity**: high
-> **Change Type**: workflow-surface
-> **File**: `.ai/hooks/session-start-context.sh`
-> **Functional Block**: `.ai/hooks`
-> **Capability ID**: `runtime-harness-hook-adapters`
-> **Matched Prefix**: `.ai/hooks`
-> **Architecture Domain**: `runtime-harness`
-> **Architecture Capability**: `hook-adapters`
-> **Architecture Module**: `docs/architecture/modules/runtime-harness/hook-adapters.md`
-> **Workstream Directory**: `tasks/workstreams/runtime-harness/hook-adapters`
-> **Contract Files**: `AGENTS.md`, `CLAUDE.md`
-> **Contract Sync Required**: true
-> **Spawn Recommended**: true
-> **Open Edits**: 9
-
-## Required Follow-up
-
-- Read root `AGENTS.md` / `CLAUDE.md`.
-- If functional block is not `root`, read its local `AGENTS.md` / `CLAUDE.md`.
-- Decide whether this change affects module boundaries, entrypoints, dependency rules, runtime paths, or verification commands.
-- For substantial changes, write a snapshot under `docs/architecture/snapshots/`.
-- When a visual explains the boundary better than prose, add or update a Mermaid fenced block in the relevant architecture module or snapshot Markdown first; that Markdown is the semantic source for LLM readers.
-- When a human-readable rendering is useful, generate a matching `$mermaid` architecture HTML file under `docs/architecture/diagrams/` and link it back to the Markdown semantic source.
-- Treat `mermaid` as an external installed skill dependency at `~/.codex/skills/mermaid`; do not copy, vendor, or inline its templates into this repo.
-- If this starts or advances durable execution, run `scripts/workstream-sync.sh ensure --block ".ai/hooks" --request "docs/architecture/requests/runtime-harness-hook-adapters.md"`.
-- After the snapshot or diagram is produced, run `scripts/context-contract-sync.sh sync-latest` so the local architecture contract block links to the latest artifacts.
-
-## Touched Files
-
-| Last Event | Severity | Change Type | File |
-| --- | --- | --- | --- |
-| 2026-05-29T09:44:46+0800 | high | workflow-surface | `.ai/hooks/session-start-context.sh` |
-| 2026-05-29T09:44:30+0800 | high | workflow-surface | `assets/hooks/session-start-context.sh` |
-| 2026-05-29T09:43:39+0800 | high | workflow-surface | `assets/hooks/prompt-guard.sh` |
-| 2026-05-29T09:43:31+0800 | high | workflow-surface | `.ai/hooks/prompt-guard.sh` |
-| 2026-05-29T00:42:38+0800 | high | workflow-surface | `.ai/hooks/lib/workflow-state.sh` |
-| 2026-05-28T22:47:36+0800 | high | workflow-surface | `.ai/hooks/hook-input.sh` |
-| 2026-05-28T22:27:05+0800 | high | workflow-surface | `.ai/hooks/worktree-guard.sh` |
-| 2026-05-28T22:26:48+0800 | high | workflow-surface | `.ai/hooks/pre-edit-guard.sh` |
-| 2026-05-28T15:48:16+0800 | high | workflow-surface | `assets/hooks/hook-input.sh` |
-
-## Event Fields
-
-```json
-{
-  "ts": "2026-05-29T09:44:46+0800",
-  "file_path": ".ai/hooks/session-start-context.sh",
-  "severity": "high",
-  "functional_block": ".ai/hooks",
-  "capability_id": "runtime-harness-hook-adapters",
-  "matched_prefix": ".ai/hooks",
-  "architecture_domain": "runtime-harness",
-  "architecture_capability": "hook-adapters",
-  "architecture_module": "docs/architecture/modules/runtime-harness/hook-adapters.md",
-  "workstream_dir": "tasks/workstreams/runtime-harness/hook-adapters",
-  "contract_agents": "AGENTS.md",
-  "contract_claude": "CLAUDE.md",
-  "change_type": "workflow-surface",
-  "request_file": "docs/architecture/requests/runtime-harness-hook-adapters.md",
-  "spawn_recommended": true,
-  "contract_sync_required": true
-}
-```
-
-## Archive Resolution
-
-- Status: Resolved
-- Archived: 2026-06-12T03:36:04+0800
-- Artifacts:
-- `docs/architecture/modules/runtime-harness/hook-adapters.md`
-- Note: Post-edit hook architecture recording now routes through architecture-queue.sh with advisory semantics.

package/docs/architecture/requests/archive/2026/verification-evals-checks.md

@@ -1,68 +0,0 @@
-# Architecture Queue Card: verification-evals-checks
-
-> **Status**: Resolved
-> **Detected**: 2026-05-28T16:18:53+0800
-> **Updated**: 2026-05-28T16:18:53+0800
-> **Severity**: high
-> **Change Type**: workflow-surface
-> **File**: `scripts/check-task-workflow.sh`
-> **Functional Block**: `scripts/check-task-workflow.sh`
-> **Capability ID**: `verification-evals-checks`
-> **Matched Prefix**: `scripts/check-task-workflow.sh`
-> **Architecture Domain**: `verification`
-> **Architecture Capability**: `evals-checks`
-> **Architecture Module**: `docs/architecture/modules/verification/evals-checks.md`
-> **Workstream Directory**: `tasks/workstreams/verification/evals-checks`
-> **Contract Files**: `AGENTS.md`, `CLAUDE.md`
-> **Contract Sync Required**: true
-> **Spawn Recommended**: true
-> **Open Edits**: 1
-
-## Required Follow-up
-
-- Read root `AGENTS.md` / `CLAUDE.md`.
-- If functional block is not `root`, read its local `AGENTS.md` / `CLAUDE.md`.
-- Decide whether this change affects module boundaries, entrypoints, dependency rules, runtime paths, or verification commands.
-- For substantial changes, write a snapshot under `docs/architecture/snapshots/`.
-- When a visual explains the boundary better than prose, add or update a Mermaid fenced block in the relevant architecture module or snapshot Markdown first; that Markdown is the semantic source for LLM readers.
-- When a human-readable rendering is useful, generate a matching `$mermaid` architecture HTML file under `docs/architecture/diagrams/` and link it back to the Markdown semantic source.
-- Treat `mermaid` as an external installed skill dependency at `~/.codex/skills/mermaid`; do not copy, vendor, or inline its templates into this repo.
-- If this starts or advances durable execution, run `scripts/workstream-sync.sh ensure --block "scripts/check-task-workflow.sh" --request "docs/architecture/requests/verification-evals-checks.md"`.
-- After the snapshot or diagram is produced, run `scripts/context-contract-sync.sh sync-latest` so the local architecture contract block links to the latest artifacts.
-
-## Touched Files
-
-| Last Event | Severity | Change Type | File |
-| --- | --- | --- | --- |
-| 2026-05-28T16:18:53+0800 | high | workflow-surface | `scripts/check-task-workflow.sh` |
-
-## Event Fields
-
-```json
-{
-  "ts": "2026-05-28T16:18:53+0800",
-  "file_path": "scripts/check-task-workflow.sh",
-  "severity": "high",
-  "functional_block": "scripts/check-task-workflow.sh",
-  "capability_id": "verification-evals-checks",
-  "matched_prefix": "scripts/check-task-workflow.sh",
-  "architecture_domain": "verification",
-  "architecture_capability": "evals-checks",
-  "architecture_module": "docs/architecture/modules/verification/evals-checks.md",
-  "workstream_dir": "tasks/workstreams/verification/evals-checks",
-  "contract_agents": "AGENTS.md",
-  "contract_claude": "CLAUDE.md",
-  "change_type": "workflow-surface",
-  "request_file": "docs/architecture/requests/verification-evals-checks.md",
-  "spawn_recommended": true,
-  "contract_sync_required": true
-}
-```
-
-## Archive Resolution
-
-- Status: Resolved
-- Archived: 2026-06-12T03:36:04+0800
-- Artifacts:
-- `docs/architecture/modules/verification/evals-checks.md`
-- Note: Required-file checks and focused tests now track architecture-queue.sh.

package/docs/architecture/requests/archive/2026/workflow-engine-contract-assets.md

@@ -1,69 +0,0 @@
-# Architecture Queue Card: workflow-engine-contract-assets
-
-> **Status**: Resolved
-> **Detected**: 2026-05-28T16:18:51+0800
-> **Updated**: 2026-05-28T16:19:11+0800
-> **Severity**: high
-> **Change Type**: workflow-surface
-> **File**: `assets/workflow-contract.v1.json`
-> **Functional Block**: `assets/workflow-contract.v1.json`
-> **Capability ID**: `workflow-engine-contract-assets`
-> **Matched Prefix**: `assets/workflow-contract.v1.json`
-> **Architecture Domain**: `workflow-engine`
-> **Architecture Capability**: `contract-assets`
-> **Architecture Module**: `docs/architecture/modules/workflow-engine/contract-assets.md`
-> **Workstream Directory**: `tasks/workstreams/workflow-engine/contract-assets`
-> **Contract Files**: `AGENTS.md`, `CLAUDE.md`
-> **Contract Sync Required**: true
-> **Spawn Recommended**: true
-> **Open Edits**: 2
-
-## Required Follow-up
-
-- Read root `AGENTS.md` / `CLAUDE.md`.
-- If functional block is not `root`, read its local `AGENTS.md` / `CLAUDE.md`.
-- Decide whether this change affects module boundaries, entrypoints, dependency rules, runtime paths, or verification commands.
-- For substantial changes, write a snapshot under `docs/architecture/snapshots/`.
-- When a visual explains the boundary better than prose, add or update a Mermaid fenced block in the relevant architecture module or snapshot Markdown first; that Markdown is the semantic source for LLM readers.
-- When a human-readable rendering is useful, generate a matching `$mermaid` architecture HTML file under `docs/architecture/diagrams/` and link it back to the Markdown semantic source.
-- Treat `mermaid` as an external installed skill dependency at `~/.codex/skills/mermaid`; do not copy, vendor, or inline its templates into this repo.
-- If this starts or advances durable execution, run `scripts/workstream-sync.sh ensure --block "assets/workflow-contract.v1.json" --request "docs/architecture/requests/workflow-engine-contract-assets.md"`.
-- After the snapshot or diagram is produced, run `scripts/context-contract-sync.sh sync-latest` so the local architecture contract block links to the latest artifacts.
-
-## Touched Files
-
-| Last Event | Severity | Change Type | File |
-| --- | --- | --- | --- |
-| 2026-05-28T16:19:11+0800 | high | workflow-surface | `assets/workflow-contract.v1.json` |
-| 2026-05-28T16:18:51+0800 | high | workflow-surface | `.ai/harness/workflow-contract.json` |
-
-## Event Fields
-
-```json
-{
-  "ts": "2026-05-28T16:19:11+0800",
-  "file_path": "assets/workflow-contract.v1.json",
-  "severity": "high",
-  "functional_block": "assets/workflow-contract.v1.json",
-  "capability_id": "workflow-engine-contract-assets",
-  "matched_prefix": "assets/workflow-contract.v1.json",
-  "architecture_domain": "workflow-engine",
-  "architecture_capability": "contract-assets",
-  "architecture_module": "docs/architecture/modules/workflow-engine/contract-assets.md",
-  "workstream_dir": "tasks/workstreams/workflow-engine/contract-assets",
-  "contract_agents": "AGENTS.md",
-  "contract_claude": "CLAUDE.md",
-  "change_type": "workflow-surface",
-  "request_file": "docs/architecture/requests/workflow-engine-contract-assets.md",
-  "spawn_recommended": true,
-  "contract_sync_required": true
-}
-```
-
-## Archive Resolution
-
-- Status: Resolved
-- Archived: 2026-06-12T03:36:05+0800
-- Artifacts:
-- `docs/architecture/modules/workflow-engine/contract-assets.md`
-- Note: Workflow contract and helper inventory now use architecture-queue.sh.

package/scripts/archive-architecture-request.sh

@@ -1,4 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-exec "$SCRIPT_DIR/lib/run-forge-helper.sh" "archive-architecture-request.sh" "$@"

package/scripts/benchmark-background-check-overlap.ts

@@ -1,228 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * Executable goal-drift guard for the managed-check controller path.
- *
- * It deliberately performs useful rh_context work after run_check returns and
- * before its one final dependency join. A future change that turns this into
- * periodic process_wait polling, re-executes the check, or blocks the initial
- * handle return fails the benchmark rather than only a local Process test.
- */
-
-import { execFileSync } from 'child_process';
-import { mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'fs';
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { performance } from 'perf_hooks';
-import { createMcpToolContext } from '../src/cli/mcp/server';
-import { registerRepository } from '../src/cli/repositories/registry';
-import { callRuntimeTool } from '../src/runtime/gateway/mcp/runtime-tools';
-import { callProcessTool } from '../src/runtime/gateway/mcp/process-tools';
-import { routeDurableMcpCall } from '../src/runtime/gateway/mcp/router';
-import { getProcessRecord } from '../src/runtime/execution/process-runtime/store';
-import {
-  clearGitIdentityCacheForTest,
-  clearGitSnapshotCacheForTest,
-  gitSnapshotPerformanceSnapshot,
-} from '../src/cli/repository/inspector';
-
-const CHECK_DURATION_MS = 1_200;
-const MAX_INITIAL_HANDLE_LATENCY_MS = 700;
-const MAX_TERMINAL_OBSERVATION_LATENCY_MS = 1_000;
-const root = mkdtempSync(join(tmpdir(), 'forge-background-check-overlap-'));
-const controllerHome = join(root, 'controller');
-const repoRoot = join(root, 'repo');
-
-const behavioralContract = {
-  originalUserFacingGoal: 'A long focused check must run in the background while Forge continues useful independent work, then synchronize once at the true dependency boundary.',
-  invariants: {
-    backgroundCheck: 'long_check_returns_a_managed_handle_promptly',
-    noPollingWhileUsefulWorkExists: 'zero_process_wait_calls_before_independent_work_finishes',
-    dependencyDrivenJoin: 'one_final_process_wait_after_the_dependency_boundary',
-    exactlyOnce: 'one_physical_check_execution',
-    resultCorrectness: 'terminal_result_matches_the_returned_process_id',
-    noAdditionalOrchestration: 'no_execution_job_created_for_the_fast_check_route',
-    sourceRetrievalStaysFocused: 'ordinary_rh_context_search_skips_execution_preflight',
-    summaryStaysCheap: 'rh_status_summary_avoids_detail_diagnostics',
-  },
-  antiGoals: [
-    'periodic_process_wait_polling',
-    'synchronous_wait_before_independent_work',
-    'duplicate_check_execution',
-    'source_retrieval_building_unrequested_check_readiness',
-    'summary_status_triggering_detail_diagnostics',
-  ],
-  validation: 'Runs a real managed check, performs rh_context work before the sole join, and separately asserts the rh_status summary hot path.',
-};
-
-function percentile(values: number[], ratio: number): number {
-  const sorted = [...values].sort((left, right) => left - right);
-  return Math.round((sorted[Math.min(sorted.length - 1, Math.floor(sorted.length * ratio))] ?? 0) * 100) / 100;
-}
-
-try {
-  mkdirSync(join(repoRoot, 'src'), { recursive: true });
-  mkdirSync(join(repoRoot, '.forge'), { recursive: true });
-  execFileSync('git', ['init', '-q', '-b', 'main'], { cwd: repoRoot });
-  execFileSync('git', ['config', 'user.email', 'benchmark@example.test'], { cwd: repoRoot });
-  execFileSync('git', ['config', 'user.name', 'Forge Benchmark'], { cwd: repoRoot });
-  writeFileSync(join(repoRoot, 'src', 'fixture.ts'), 'export const backgroundFixture = true;\n');
-  const executionMarker = join(root, 'physical-check-executions.txt');
-  writeFileSync(join(repoRoot, '.forge', 'checks.json'), JSON.stringify({
-    version: 1,
-    checks: {
-      background: {
-        description: 'Synthetic long check for controller overlap behavior.',
-        command: [
-          process.execPath,
-          '-e',
-          [
-            `require('fs').appendFileSync(${JSON.stringify(executionMarker)}, '1');`,
-            `setTimeout(() => { process.stdout.write('BACKGROUND_CHECK_DONE\\n'); process.exit(0); }, ${CHECK_DURATION_MS});`,
-          ].join(' '),
-        ],
-        timeoutMs: 10_000,
-      },
-    },
-  }, null, 2));
-  execFileSync('git', ['add', '.'], { cwd: repoRoot });
-  execFileSync('git', ['commit', '-qm', 'fixture'], { cwd: repoRoot });
-
-  const repository = registerRepository({ path: repoRoot, controllerHome, displayName: 'background-check-overlap' });
-  const ctx = createMcpToolContext({ controllerHome, profile: 'controller', repo: repoRoot });
-
-  const startedAt = performance.now();
-  const started = await routeDurableMcpCall(ctx, 'run_check', {
-    repo_id: repository.repoId,
-    check_id: 'background',
-    interactive_wait_ms: 0,
-  });
-  const initialHandleLatencyMs = performance.now() - startedAt;
-  const startPayload = started?.structuredContent as Record<string, unknown> | undefined;
-  const processId = typeof startPayload?.processId === 'string' ? startPayload.processId : '';
-
-  const independentStartedAt = performance.now();
-  const independent = await callRuntimeTool(ctx, 'rh_context', {
-    repo_id: repository.repoId,
-    operation: 'search',
-    query: 'backgroundFixture',
-    known_paths: ['src/fixture.ts'],
-    structural_context: 'off',
-  });
-  const independentOperationLatencyMs = performance.now() - independentStartedAt;
-  const independentPayload = independent?.structuredContent as { data?: Record<string, unknown> } | undefined;
-  const independentData = independentPayload?.data;
-  const independentRetrievalPolicy = independentData?.retrievalPolicy as Record<string, unknown> | undefined;
-  const sourceRetrievalSkippedExecutionPreflight = independentData?.executionReadiness === undefined
-    && independentData?.registeredChecks === undefined
-    && independentRetrievalPolicy?.executionReadiness === 'requested_check_ids_only';
-  const processWaitCallsBeforeDependencyBoundary = 0;
-
-  const joinStartedAtMs = Date.now();
-  const joined = processId
-    ? await callProcessTool(ctx, 'process_wait', {
-      repo_id: repository.repoId,
-      process_id: processId,
-      timeout_ms: 10_000,
-    })
-    : undefined;
-  const resultObservedAtMs = Date.now();
-  const finalSynchronizationCount = processId ? 1 : 0;
-  const joinedPayload = joined?.structuredContent as { process?: { processId?: string; completed?: boolean; ok?: boolean } } | undefined;
-  const record = processId ? getProcessRecord(controllerHome, repository.repoId, processId) : undefined;
-  const finishedAtMs = record?.finishedAt ? Date.parse(record.finishedAt) : NaN;
-  const completionToObservationLatencyMs = Number.isFinite(finishedAtMs)
-    ? Math.max(0, resultObservedAtMs - finishedAtMs)
-    : undefined;
-  const physicalExecutionCount = readFileSync(executionMarker, 'utf8').length;
-
-  // Summary is a separate hot path: it must answer readiness without falling
-  // into the full Git status/diff-stat or maintenance/detail projection.
-  clearGitIdentityCacheForTest();
-  clearGitSnapshotCacheForTest();
-  const statusSummaryDurations: number[] = [];
-  let summaryPayload: Record<string, unknown> | undefined;
-  for (let iteration = 0; iteration < 7; iteration += 1) {
-    const statusStartedAt = performance.now();
-    const status = await callRuntimeTool(ctx, 'rh_status', { repo_id: repository.repoId, detail_level: 'summary' });
-    statusSummaryDurations.push(performance.now() - statusStartedAt);
-    summaryPayload = status?.structuredContent as Record<string, unknown> | undefined;
-  }
-  // Snapshot this before the intentional detail call below: detail is allowed
-  // to build the full Git projection, while summary is not.
-  const summaryGitSnapshot = gitSnapshotPerformanceSnapshot();
-  const detailStartedAt = performance.now();
-  const detail = await callRuntimeTool(ctx, 'rh_status', { repo_id: repository.repoId, detail_level: 'detail' });
-  const detailElapsedMs = performance.now() - detailStartedAt;
-  const detailPayload = detail?.structuredContent as Record<string, unknown> | undefined;
-  const detailMeta = detailPayload?.responseMeta as Record<string, unknown> | undefined;
-  const summaryData = summaryPayload?.data as Record<string, unknown> | undefined;
-  const summaryRepositoryState = summaryData?.repositoryState as Record<string, unknown> | undefined;
-  const summaryUsesCompactPayload = Boolean(summaryData)
-    && summaryData?.access === undefined
-    && summaryData?.pendingHandoffCount === undefined
-    && summaryData?.activeWorkCount === undefined
-    && summaryData?.activeProcessCount === undefined
-    && summaryRepositoryState?.status === undefined
-    && summaryRepositoryState?.diffStat === undefined;
-
-  const assertions = {
-    initialManagedHandle: Boolean(processId) && startPayload?.path === 'process_managed' && initialHandleLatencyMs <= MAX_INITIAL_HANDLE_LATENCY_MS,
-    independentUsefulOperation: independent?.isError !== true,
-    sourceRetrievalSkipsExecutionPreflight: sourceRetrievalSkippedExecutionPreflight,
-    noPollingBeforeDependencyBoundary: processWaitCallsBeforeDependencyBoundary === 0,
-    oneDependencyJoin: finalSynchronizationCount === 1,
-    exactlyOnce: physicalExecutionCount === 1,
-    terminalResultCorrect: joinedPayload?.process?.processId === processId && joinedPayload?.process?.completed === true && joinedPayload?.process?.ok === true,
-    promptResultObservation: completionToObservationLatencyMs === undefined || completionToObservationLatencyMs <= MAX_TERMINAL_OBSERVATION_LATENCY_MS,
-    statusSummaryUsesCompactProjection: Boolean(summaryPayload?.data)
-      && summaryGitSnapshot.refreshes === 0
-      && summaryGitSnapshot.subprocesses === 0
-      && summaryUsesCompactPayload,
-  };
-  const output = {
-    schemaVersion: 1,
-    behavioralContract,
-    check: {
-      configuredDurationMs: CHECK_DURATION_MS,
-      initialManagedHandleLatencyMs: Number(initialHandleLatencyMs.toFixed(2)),
-      processWaitCallsBeforeDependencyBoundary,
-      independentOperation: {
-        tool: 'rh_context.search',
-        latencyMs: Number(independentOperationLatencyMs.toFixed(2)),
-        completed: independent?.isError !== true,
-        executionPreflight: sourceRetrievalSkippedExecutionPreflight ? 'not_requested' : 'unexpected',
-      },
-      finalSynchronizationCount,
-      finalJoinDurationMs: resultObservedAtMs - joinStartedAtMs,
-      physicalExecutionCount,
-      terminalCompletionToObservationLatencyMs: completionToObservationLatencyMs,
-      processId,
-    },
-    status: {
-      summaryP50Ms: percentile(statusSummaryDurations, 0.5),
-      summaryP95Ms: percentile(statusSummaryDurations, 0.95),
-      detailElapsedMs: Number(detailElapsedMs.toFixed(2)),
-      detailServerDurationMs: detailMeta?.serverDurationMs,
-      detailPhaseTimingsMs: detailMeta?.phaseTimingsMs,
-      fullGitSnapshot: summaryGitSnapshot,
-      summaryOmissions: {
-        maintenance: true,
-        plugins: true,
-        workState: true,
-        accessPolicy: true,
-        gitStatusAndDiffStat: true,
-      },
-    },
-    thresholds: {
-      initialManagedHandleLatencyMs: MAX_INITIAL_HANDLE_LATENCY_MS,
-      terminalCompletionToObservationLatencyMs: MAX_TERMINAL_OBSERVATION_LATENCY_MS,
-    },
-    assertions,
-    passed: Object.values(assertions).every(Boolean),
-  };
-  process.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
-  if (!output.passed) process.exitCode = 1;
-} finally {
-  rmSync(root, { recursive: true, force: true });
-}