refactor(replay): move source and target decisions into replay-port (#2663) (#3007)

* refactor(replay): move source and target decisions into replay-port

* chore(gates): declare replay-port decision subpaths and dependencies

Author: thymikee

packages/contracts/src/replay-divergence.ts

@@ -181,7 +181,7 @@ export type ReplayDivergenceOverflow = {
 /**
  * ADR 0012 decision 6, R3: the daemon-computed repair routing hint. Always
  * defined (never absent/null) — the mapping in
- * `src/daemon/replay/internal/session-replay-repair-hint.ts` is total, defaulting
+ * `packages/replay-port/src/daemon-port/repair-hint.ts` is total, defaulting
  * to `manual` whenever no safer routing can be proven. A small fixed token,
  * so it is carried at every response level (including `--level digest`) and
  * every projection (text, JSON, client `AppError`, MCP `structuredContent`).

packages/replay-port/package.json

@@ -7,9 +7,23 @@
   "description": "Daemon-side replay port: the adapter over the ad-replay, ad-script and replay-test engines.",
   "dependencies": {
     "@agent-device/ad-script": "workspace:*",
-    "@agent-device/contracts": "workspace:*"
+    "@agent-device/contracts": "workspace:*",
+    "@agent-device/kernel": "workspace:*",
+    "@agent-device/selectors": "workspace:*"
   },
   "exports": {
+    "./target-token": {
+      "types": "./src/daemon-port/target-token.ts",
+      "default": "./src/daemon-port/target-token.ts"
+    },
+    "./repair-hint": {
+      "types": "./src/daemon-port/repair-hint.ts",
+      "default": "./src/daemon-port/repair-hint.ts"
+    },
+    "./script-source": {
+      "types": "./src/daemon-port/script-source.ts",
+      "default": "./src/daemon-port/script-source.ts"
+    },
     "./session-replay-vars": {
       "types": "./src/session-replay-vars.ts",
       "default": "./src/session-replay-vars.ts"

…sts__/session-replay-repair-hint.test.ts …aemon-port/__tests__/repair-hint.test.tssrc/daemon/replay/internal/__tests__/session-replay-repair-hint.test.ts renamed to packages/replay-port/src/daemon-port/__tests__/repair-hint.test.ts src/daemon/replay/internal/__tests__/session-replay-repair-hint.test.ts renamed to packages/replay-port/src/daemon-port/__tests__/repair-hint.test.ts

@@ -2,10 +2,7 @@ import { test } from 'vitest';
 import assert from 'node:assert/strict';
 import type { RawSnapshotNode, SnapshotNode } from '@agent-device/kernel/snapshot';
 import type { TargetAnnotationV1 } from '@agent-device/contracts/replay';
-import {
-  computeReplayRepairHint,
-  type ReplayRepairHintCapture,
-} from '../session-replay-repair-hint.ts';
+import { computeReplayRepairHint, type ReplayRepairHintCapture } from '../repair-hint.ts';
 
 /**
  * ADR 0012 decision 6, R3: `computeReplayRepairHint` must be a TOTAL mapping

…n/__tests__/replay-script-source.test.ts …mon-port/__tests__/script-source.test.tssrc/daemon/__tests__/replay-script-source.test.ts renamed to packages/replay-port/src/daemon-port/__tests__/script-source.test.ts src/daemon/__tests__/replay-script-source.test.ts renamed to packages/replay-port/src/daemon-port/__tests__/script-source.test.ts

@@ -1,6 +1,6 @@
 import { expect, test } from 'vitest';
 import { AppError } from '@agent-device/kernel/errors';
-import { readReplayScriptSourceFile } from '../replay-script-source.ts';
+import { readReplayScriptSourceFile } from '../script-source.ts';
 
 test('reading a file the bundle does not carry names the file and the entry', () => {
   const bundle = { entry: '/flows/login.yaml', files: { '/flows/login.yaml': '---\n- back\n' } };

…ts__/session-replay-target-token.test.ts …emon-port/__tests__/target-token.test.tssrc/daemon/replay/internal/__tests__/session-replay-target-token.test.ts renamed to packages/replay-port/src/daemon-port/__tests__/target-token.test.ts src/daemon/replay/internal/__tests__/session-replay-target-token.test.ts renamed to packages/replay-port/src/daemon-port/__tests__/target-token.test.ts

@@ -3,7 +3,7 @@
 import type { SessionAction } from '@agent-device/contracts/session';
 import { test } from 'vitest';
 import assert from 'node:assert/strict';
-import { extractReplayTargetToken, readRefLabel } from '../session-replay-target-token.ts';
+import { extractReplayTargetToken, readRefLabel } from '../target-token.ts';
 
 // ---------------------------------------------------------------------------
 

…y/internal/session-replay-repair-hint.ts …play-port/src/daemon-port/repair-hint.tssrc/daemon/replay/internal/session-replay-repair-hint.ts renamed to packages/replay-port/src/daemon-port/repair-hint.ts src/daemon/replay/internal/session-replay-repair-hint.ts renamed to packages/replay-port/src/daemon-port/repair-hint.ts

@@ -1,5 +1,5 @@
 /**
- * ADR 0012 decision 6, R3: the daemon-side `repairHint` computation.
+ * ADR 0012 decision 6, R3: the replay port's `repairHint` computation.
  *
  * Computed daemon-side at divergence time, never by the agent, from (i) the
  * recorded `target-v1` evidence for the diverged action (decision 3's
@@ -13,8 +13,7 @@
  * evidence, or a sparse/unavailable capture — so `repairHint` is always
  * defined.
  *
- * Lives in the daemon zone because the container-presence test
- * below is a genuine structural containment check over `parentIndex` — the
+ * The container-presence test below is a genuine structural containment check over `parentIndex` — the
  * same tree-walking machinery decision 3's own identity-set filter uses
  * (`buildAncestryChain`/`computeScrollRegionKey`, `@agent-device/selectors/target-evidence`)
  * — not a flat identity-string search.

src/daemon/replay-script-source.ts …ay-port/src/daemon-port/script-source.tssrc/daemon/replay-script-source.ts renamed to packages/replay-port/src/daemon-port/script-source.ts src/daemon/replay-script-source.ts renamed to packages/replay-port/src/daemon-port/script-source.ts

@@ -18,7 +18,7 @@ import net from 'node:net';
 import path from 'node:path';
 import { afterEach, expect, test } from 'vitest';
 import { LeaseRegistry } from '../lease-registry.ts';
-import { REPLAY_SCRIPT_SOURCE_REQUIRED_MESSAGE } from '../replay-script-source.ts';
+import { REPLAY_SCRIPT_SOURCE_REQUIRED_MESSAGE } from '@agent-device/replay-port/script-source';
 import { createRequestHandler } from './test-device-runtime-gateway.ts';
 import { SessionStore } from '../session-store.ts';
 import { createDaemonHttpServer } from '../server/http-server.ts';