@quolu/lattice 0.12.24 → 0.12.26

package/README.md

@@ -52,7 +52,30 @@ lattice plan create --input .lattice/plan-create.json
 discoveryと初期transactionの不変条件は
 [ADR 0058](docs/adr/0058-project-discovery-and-initial-authoring.md)が正です。
 
-TODO工程storeの読取は`lattice todo status`、検証は`lattice todo verify`、表示生成は
+## 実行runを端から端まで動かす
+
+compileしたrunを実際にdispatchするには、executor adapterを登録してからactivateします。
+参照実装の`lattice-scripted-adapter`を配布しているため、公開CLIと配布binだけで
+実write・receipt受理・closeまで到達できます。
+
+```bash
+lattice run adapter register --schema --json     # 登録入力のJSON Schema
+lattice run adapter register --input adapter.json
+lattice run adapter list --json
+lattice run activate --run .lattice/runs/<id>
+lattice run status --run .lattice/runs/<id>      # accepted に子が入る
+lattice event verify --run .lattice/runs/<id>
+lattice run close --run .lattice/runs/<id>
+```
+
+digestは手で計算しません。binary・config・capabilities・自己digestは登録時にCLIが導出します。
+
+`plan compile`が`BOUNDARY_UNKNOWN`を返す場合は、まず`git status --short`が空かを確認してください。
+未追跡ファイルがあるとsensor statusが`stale`になり、witnessが未解決unknownへ落ちます。
+作業ツリーをcleanにすると同じrequestがそのまま通ります。
+
+TODO工程storeの読取は`lattice todo status`、`compile_binding`付きTaskの投影は
+`lattice todo bindings`、検証は`lattice todo verify`、表示生成は
 `lattice todo gantt`を使います。topology/source reconciliationは
 `lattice todo revise --plan <key> --input <canonical-revision.json>`、Phase付きplanは
 `lattice todo revise-phase --plan <key> --input <canonical-phase-revision.json>`でsuccessor発行します。

package/bin/lattice-scripted-adapter.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+import {
+  runScriptedAdapterController,
+  ScriptedAdapterControllerError,
+} from '../src/runtime-scripted-adapter-controller.mjs';
+
+try {
+  await runScriptedAdapterController();
+} catch (error) {
+  const payload = {
+    schema: 'lattice.scripted_adapter_error.v1',
+    code: error instanceof ScriptedAdapterControllerError
+      ? error.code
+      : 'SCRIPTED_CONTROLLER_FAILED',
+    message: String(error?.message ?? error),
+  };
+  process.stderr.write(`${JSON.stringify(payload)}\n`);
+  process.exitCode = 1;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quolu/lattice",
-  "version": "0.12.24",
+  "version": "0.12.26",
   "description": "Lattice — phase-aware TODO graph compiler and conflict-aware orchestration runtime",
   "type": "module",
   "license": "MIT",
@@ -13,10 +13,12 @@
   },
   "bin": {
     "lattice": "bin/lattice.mjs",
-    "lattice-mcp": "bin/lattice-mcp.mjs"
+    "lattice-mcp": "bin/lattice-mcp.mjs",
+    "lattice-scripted-adapter": "bin/lattice-scripted-adapter.mjs"
   },
   "files": [
     "bin",
+    "bin/lattice-scripted-adapter.mjs",
     "src",
     "docs/schemas/lattice.plan_create_input.v1.schema.json",
     "docs/schemas/lattice.plan_create_input.v2.schema.json",
@@ -58,7 +60,7 @@
     "test": "node scripts/run-product-tests.mjs",
     "test:sensor": "npm --prefix sensor test",
     "precheck": "node --check src/bridge-launch-agent.mjs",
-    "check": "node --check bin/lattice.mjs && node --check bin/lattice-mcp.mjs && node --check bin/lattice-dashboard.mjs && node --check bin/lattice-bridge.mjs && node --check src/cli-stdio.mjs && node --check src/bridge-address.mjs && node --check src/bridge-registrar.mjs && node --check src/todo-gantt-layout.mjs && node --check src/todo-gantt-scope.mjs && node --check src/bridge-config.mjs && node --check src/bridge-server.mjs && node --check src/bridge-daemon.mjs && node --check src/bridge-cli.mjs && node --check src/project-cli.mjs && node --check src/sensor-cli.mjs && node --check src/sensor-runtime.mjs && node --check src/sensor-adapter.mjs && node --check src/factory-diagnostics.mjs && node --check src/runtime-errors.mjs && node --check src/runtime-contracts.mjs && node --check src/runtime-event-store.mjs && node --check src/runtime-adapter-registry.mjs && node --check src/hash-chain.mjs && node --check src/dag-chain.mjs && node --check src/todo-contracts.mjs && node --check src/todo-chain.mjs && node --check src/todo-store.mjs && node --check src/todo-migration.mjs && node --check src/todo-revision.mjs && node --check src/todo-status.mjs && node --check src/todo-cli.mjs && node --check src/todo-dashboard-registry.mjs && node --check src/todo-gantt-presentation.mjs && node --check src/todo-gantt-live.mjs && node --check src/bounded-seam.mjs && node --check src/todo-narrative-anchor.mjs && node --check src/todo-markdown-renderer.mjs && node --check src/todo-gantt-svg.mjs && node --check src/todo-gantt-html.mjs && node --check src/runtime-projection.mjs && node --check src/runtime-decision-verifier.mjs && node --check src/runtime-front-end.mjs && node --check src/runtime-cli.mjs && node --check src/rc3-dogfood-scaffold.mjs && node --check src/runtime-engine.mjs && node --check src/runtime-scripted-executor.mjs && node --check src/runtime-diff-observer.mjs && node --check src/runtime-worktree-executor.mjs && node --check src/runtime-hold-recompile.mjs && node --check src/rc3-scripted-campaign.mjs && node --check src/rc3-actual-dogfood.mjs && node --check src/rc4-stage1-dogfood.mjs && node --check research/fixtures/dispatch-record/src/dispatch-record.mjs && node --check test/research-dispatch-record.test.mjs",
+    "check": "node --check bin/lattice.mjs && node --check bin/lattice-mcp.mjs && node --check bin/lattice-dashboard.mjs && node --check bin/lattice-bridge.mjs && node --check bin/lattice-scripted-adapter.mjs && node --check src/cli-stdio.mjs && node --check src/bridge-address.mjs && node --check src/bridge-registrar.mjs && node --check src/todo-gantt-layout.mjs && node --check src/todo-gantt-scope.mjs && node --check src/bridge-config.mjs && node --check src/bridge-server.mjs && node --check src/bridge-daemon.mjs && node --check src/bridge-cli.mjs && node --check src/project-cli.mjs && node --check src/sensor-cli.mjs && node --check src/sensor-runtime.mjs && node --check src/sensor-adapter.mjs && node --check src/factory-diagnostics.mjs && node --check src/runtime-errors.mjs && node --check src/runtime-contracts.mjs && node --check src/runtime-event-store.mjs && node --check src/runtime-adapter-registry.mjs && node --check src/runtime-scripted-adapter-controller.mjs && node --check src/hash-chain.mjs && node --check src/dag-chain.mjs && node --check src/todo-contracts.mjs && node --check src/todo-chain.mjs && node --check src/todo-store.mjs && node --check src/todo-migration.mjs && node --check src/todo-revision.mjs && node --check src/todo-status.mjs && node --check src/todo-cli.mjs && node --check src/todo-dashboard-registry.mjs && node --check src/todo-gantt-presentation.mjs && node --check src/todo-gantt-live.mjs && node --check src/bounded-seam.mjs && node --check src/todo-narrative-anchor.mjs && node --check src/todo-markdown-renderer.mjs && node --check src/todo-gantt-svg.mjs && node --check src/todo-gantt-html.mjs && node --check src/runtime-projection.mjs && node --check src/runtime-decision-verifier.mjs && node --check src/runtime-front-end.mjs && node --check src/runtime-cli.mjs && node --check src/rc3-dogfood-scaffold.mjs && node --check src/runtime-engine.mjs && node --check src/runtime-scripted-executor.mjs && node --check src/runtime-diff-observer.mjs && node --check src/runtime-worktree-executor.mjs && node --check src/runtime-hold-recompile.mjs && node --check src/rc3-scripted-campaign.mjs && node --check src/rc3-actual-dogfood.mjs && node --check src/rc4-stage1-dogfood.mjs && node --check research/fixtures/dispatch-record/src/dispatch-record.mjs && node --check test/research-dispatch-record.test.mjs",
     "check:project-identity": "node --check src/project-identity.mjs",
     "ci": "npm run test && npm run test:sensor && npm run check && npm run check:project-identity"
   }

package/src/runtime-cli.mjs

@@ -29,14 +29,18 @@ import {
   validateRuntimeBoundaryManifest,
   validateRuntimePlan,
   validRuntimeAbandonReason,
+  validateExecutorReceipt,
   verifyRuntimePlanBinding,
   selfDigest,
 } from './runtime-contracts.mjs';
 import {
+  adjudicatePendingReceipts,
   buildNextRunEvent,
   buildExecutorPackets,
   closeRunIfComplete,
+  dispatchReadyFrontier,
   initializeRunEvents,
+  observeExecutor,
 } from './runtime-engine.mjs';
 import {
   computeReadyFrontier,
@@ -678,6 +682,236 @@ async function withLifecycleLock(runDir, action) {
   }
 }
 
+async function readScriptedControllerReceipt({
+  runDir,
+  controllerId,
+  payloadDigest,
+}) {
+  const receiptPath = path.join(
+    runDir,
+    'controllers',
+    controllerId,
+    'receipts',
+    `${payloadDigest}.json`,
+  );
+  const info = await lstat(receiptPath);
+  if (!info.isFile() || info.isSymbolicLink()) {
+    throw new ManagedRuntimeError(
+      'ADAPTER_CONTROLLER_UNAVAILABLE',
+      'scripted controller receipt sidecarがregular fileではない',
+    );
+  }
+  const bytes = await readFile(receiptPath);
+  let receipt;
+  try {
+    receipt = JSON.parse(bytes.toString('utf8'));
+  } catch {
+    throw new ManagedRuntimeError(
+      'ADAPTER_CONTROLLER_UNAVAILABLE',
+      'scripted controller receipt sidecarのJSONが不正',
+    );
+  }
+  if (bytes.toString('utf8') !== `${canonicalizeArtifact(receipt)}\n`
+    || !validateExecutorReceipt(receipt)
+    || digestArtifact(receipt) !== payloadDigest) {
+    throw new ManagedRuntimeError(
+      'ADAPTER_CONTROLLER_UNAVAILABLE',
+      'scripted controller receipt sidecarのdigest bindingが不正',
+    );
+  }
+  return receipt;
+}
+
+async function driveInitialScriptedManagedEpoch({
+  runDir,
+  repoRoot,
+  request,
+  committed,
+  activation,
+  managedSupervisor,
+  initialEvents,
+  controlEvents,
+}) {
+  let events = [...initialEvents];
+  const { plan, manifests, executor_packets: packets } = committed.bundle;
+  const controllerId = activation.controllerDescriptor.controller_id;
+  const registrationDigest = activation.registration.registration_digest;
+  const sessionNonceDigest = digestArtifact(activation.sessionNonce);
+  const processGroupId = activation.childPid;
+  for (;;) {
+    const frontier = computeReadyFrontier({ plan, events }).dispatchable;
+    if (frontier.length === 0) break;
+    await managedSupervisor.barrierAll({
+      barrierId: `dispatch-${plan.plan_epoch}-${events.length}`,
+      reason: 'initial_scripted_dispatch',
+      frozenEventDigest: events.at(-1).event_digest,
+    });
+    const issuedControlDigest = controlEvents().at(-1)?.event_digest;
+    if (typeof issuedControlDigest !== 'string') {
+      throw new ManagedRuntimeError(
+        'EPOCH_ACTIVATION_INCOMPLETE',
+        'initial dispatch leaseのcontrol bindingが無い',
+      );
+    }
+    const stagedLeases = [];
+    for (const todoId of frontier) {
+      const packet = packets[todoId];
+      const staged = {
+        schema: 'lattice.runtime_write_lease.v1',
+        lease_id: `lease-${packet.packet_digest.slice(0, 24)}`,
+        run_id: request.request_id,
+        todo_id: todoId,
+        plan_epoch: plan.plan_epoch,
+        packet_digest: packet.packet_digest,
+        controller_registration_digest: registrationDigest,
+        supervisor_session_nonce_digest: sessionNonceDigest,
+        state: 'staged',
+        ttl_ms: 60_000,
+        issued_control_digest: issuedControlDigest,
+        lease_digest: '',
+      };
+      staged.lease_digest = selfDigest(staged, 'lease_digest');
+      await managedSupervisor.prepareController({
+        controllerId,
+        executorPacket: packet,
+        stagedLease: staged,
+      });
+      stagedLeases.push(staged);
+    }
+    const activationDigest = digestArtifact({
+      schema: 'lattice.initial_scripted_activation.v1',
+      committed_epoch_pointer_digest: committed.pointer.pointer_digest,
+      staged_lease_digests: stagedLeases.map((lease) => lease.lease_digest).sort(),
+    });
+    const activated = await managedSupervisor.commitWriteGate({
+      planEpoch: plan.plan_epoch,
+      committedEpochDigest: committed.pointer.pointer_digest,
+      activationDigest,
+      commitReleaseBarrier: (barrier) => commitReleaseEpochBarrier({ runDir, barrier }),
+      committedAt: canonicalNow(),
+    });
+    const armedByPacket = new Map(activated.armedLeases.map((lease) => [
+      lease.packet_digest,
+      lease,
+    ]));
+    const managedAdapter = {
+      async dispatch({ packet }) {
+        const lease = armedByPacket.get(packet.packet_digest);
+        if (lease === undefined) {
+          throw new ManagedRuntimeError(
+            'EPOCH_ACTIVATION_INCOMPLETE',
+            `armed leaseが無い: ${packet.todo_id}`,
+          );
+        }
+        await managedSupervisor.authorizeWrite({ leaseDigest: lease.lease_digest });
+        const response = await managedSupervisor.route('dispatch', controllerId, {
+          packet,
+          write_lease: lease,
+        });
+        if (response.packet_digest !== packet.packet_digest
+          || response.lease_digest !== lease.lease_digest) {
+          throw new ManagedRuntimeError(
+            'ADAPTER_CONTROLLER_UNAVAILABLE',
+            `dispatch response binding不一致: ${packet.todo_id}`,
+          );
+        }
+        return {
+          executor_handle: response.executor_handle,
+          worktree_id: response.worktree_id,
+          write_lease_id: lease.lease_id,
+          write_lease_digest: lease.lease_digest,
+          controller_registration_digest: registrationDigest,
+          controller_session_nonce_digest:
+            activation.controllerDescriptor.controller_session_nonce_digest,
+          direct_os_observation_binding: {
+            process_pid: activation.childPid,
+            process_group_id: processGroupId,
+            process_start_identity:
+              structuredClone(activation.controllerDescriptor.process_start_identity),
+            worktree_path: repoRoot,
+            base_sha: packet.base_sha,
+          },
+        };
+      },
+      async observe({ executor_handle: executorHandle }) {
+        const dispatch = events.findLast((event) => (
+          event.kind === 'executor_dispatched'
+          && event.payload?.executor_handle === executorHandle
+        ));
+        const response = await managedSupervisor.route('observe', controllerId, {
+          executor_handle: executorHandle,
+          expected_epoch: dispatch.plan_epoch,
+          expected_lease_digest: dispatch.payload.write_lease_digest,
+        });
+        if (response.observation.state !== 'terminal') {
+          throw new ManagedRuntimeError(
+            'ADAPTER_CONTROLLER_UNAVAILABLE',
+            `scripted controllerがterminal以外を返した: ${response.observation.state}`,
+          );
+        }
+        const receipt = await readScriptedControllerReceipt({
+          runDir,
+          controllerId,
+          payloadDigest: response.observation.payload_digest,
+        });
+        return { state: 'terminal', receipt };
+      },
+    };
+    const dispatched = await dispatchReadyFrontier({
+      runId: request.request_id,
+      plan,
+      events,
+      packets,
+      manifests,
+      adapter: managedAdapter,
+      recordedAt: canonicalNow(),
+    });
+    if (dispatched.failure !== null) {
+      throw new ManagedRuntimeError(
+        'ADAPTER_CONTROLLER_UNAVAILABLE',
+        `scripted dispatch失敗: ${dispatched.failure.todo_id}: ${dispatched.failure.message}`,
+      );
+    }
+    events = dispatched.events;
+    await replaceEventsAtomically(runDir, events);
+    for (const todoId of dispatched.dispatched) {
+      const observed = await observeExecutor({
+        runId: request.request_id,
+        todoId,
+        plan,
+        events,
+        adapter: managedAdapter,
+        recordedAt: canonicalNow(),
+      });
+      events = observed.events;
+      await replaceEventsAtomically(runDir, events);
+    }
+    const adjudicated = adjudicatePendingReceipts({
+      runId: request.request_id,
+      plan,
+      events,
+      recordedAt: canonicalNow(),
+    });
+    if (adjudicated.decisions.some((decision) => decision.decision !== 'accepted')) {
+      throw new ManagedRuntimeError(
+        'ADAPTER_CONTROLLER_UNAVAILABLE',
+        'scripted controller receiptが受理されなかった',
+      );
+    }
+    events = adjudicated.events;
+    await replaceEventsAtomically(runDir, events);
+  }
+  return events;
+}
+
+function isDistributedScriptedControllerActivation(activation) {
+  return activation?.controllerDescriptor?.adapter_kind === 'scripted'
+    && activation?.launchDescriptor?.launch_kind === 'host_binary'
+    && activation.launchDescriptor.argv.some((argument) => (
+      path.basename(argument) === 'lattice-scripted-adapter.mjs'
+    ));
+}
+
 async function runStart({ requestPath, executorAdapter, cwd, stdout }) {
   // --executor省略時の暗黙fallbackは持たない（Decision 8）。未知adapterはtyped reject。
   if (!KNOWN_ADAPTERS.includes(executorAdapter)) {
@@ -1520,6 +1754,18 @@ export async function runManagedSupervisorDaemon({
         for (const extra of additionalActivations) {
           await extra.registerWithManagedSupervisor(managedSupervisor);
         }
+        if (!restarting && isDistributedScriptedControllerActivation(activation)) {
+          await driveInitialScriptedManagedEpoch({
+            runDir,
+            repoRoot,
+            request,
+            committed,
+            activation,
+            managedSupervisor,
+            initialEvents: events,
+            controlEvents: () => controlEvents,
+          });
+        }
         if (restarting) {
           await managedSupervisor.recoveryBarrier({ barrierId: `recovery-${randomUUID()}`,
             frozenEventDigest: events.at(-1).event_digest });

package/src/runtime-engine.mjs

@@ -292,18 +292,34 @@ export async function dispatchReadyFrontier(options = {}) {
       || dispatchResult.worktree_id.length === 0) {
       fail(`adapter dispatchがopaque handle／worktreeを返さない: ${todoId}`);
     }
+    const dispatchPayload = {
+      executor_handle: dispatchResult.executor_handle,
+      worktree_id: dispatchResult.worktree_id,
+      packet_digest: packet.packet_digest,
+      context_content_digest: packet.context_content_digest,
+    };
+    const managedFields = [
+      'write_lease_id',
+      'write_lease_digest',
+      'controller_registration_digest',
+      'controller_session_nonce_digest',
+      'direct_os_observation_binding',
+    ];
+    if (managedFields.some((field) => Object.hasOwn(dispatchResult, field))) {
+      if (!managedFields.every((field) => Object.hasOwn(dispatchResult, field))) {
+        fail(`managed adapter dispatch bindingが不足する: ${todoId}`);
+      }
+      Object.assign(dispatchPayload, Object.fromEntries(
+        managedFields.map((field) => [field, structuredClone(dispatchResult[field])]),
+      ));
+    }
     next.push(buildNextRunEvent({
       events: next,
       runId,
       kind: 'executor_dispatched',
       planEpoch: plan.plan_epoch,
       subject: { kind: 'todo', ref: todoId },
-      payload: {
-        executor_handle: dispatchResult.executor_handle,
-        worktree_id: dispatchResult.worktree_id,
-        packet_digest: packet.packet_digest,
-        context_content_digest: packet.context_content_digest,
-      },
+      payload: dispatchPayload,
       recordedAt,
     }));
     dispatchedNow.push(todoId);

package/src/runtime-managed-supervisor.mjs

@@ -699,6 +699,13 @@ function createControllerSocketTransport(socketPath, timeoutMs) {
       const line = buffer.slice(0, newline); buffer = buffer.slice(newline + 1);
       let document;
       try { document = JSON.parse(line); } catch { failPending('controller document JSON不正'); socket.destroy(); return; }
+      if (document?.schema === 'lattice.scripted_adapter_error.v1'
+        && typeof document.code === 'string'
+        && typeof document.message === 'string') {
+        failPending(`${document.code}: ${document.message}`);
+        socket.destroy();
+        return;
+      }
       if (validateControllerHeartbeat(document)) {
         Promise.resolve(heartbeatHandler?.(structuredClone(document))).catch(() => socket.destroy());
         continue;
@@ -755,6 +762,7 @@ async function activateManagedSupervisorController({ repoRoot, runDir, runId, ad
   const controllerSocketPath = path.join(runDir, controllerSocketRef);
   const supervisorSocketRef = 'supervisor/control.sock';
   let child = null;
+  let childStderr = '';
   try {
     await mkdir(controllerDir, { recursive: true, mode: 0o700 });
     let handshakeSocket = launch.endpoint;
@@ -775,7 +783,15 @@ async function activateManagedSupervisorController({ repoRoot, runDir, runId, ad
       if (!config.isFile() || config.isSymbolicLink() || sha256Bytes(await readFile(configPath)) !== launch.config_digest) fail('ADAPTER_LAUNCH_INVALID', 'config digest不一致');
       const bootstrap = createControllerBootstrap({ requestId: randomUUID(), runId, controllerSocketRef, supervisorSocketRef, supervisorSessionNonce });
       // controller hostのcwdはrun store。bootstrapの固定relative socket refを任意absolute pathへ拡張しない。
-      child = spawn(binaryReal, launch.argv, { cwd: runDir, detached: true, stdio: ['ignore', 'ignore', 'ignore', 'pipe'] });
+      child = spawn(binaryReal, launch.argv, {
+        cwd: runDir,
+        detached: true,
+        stdio: ['ignore', 'ignore', 'pipe', 'pipe'],
+      });
+      child.stderr.setEncoding('utf8');
+      child.stderr.on('data', (chunk) => {
+        childStderr = `${childStderr}${chunk}`.slice(-8_192);
+      });
       child.stdio[3].write(`${canonicalizeArtifact(bootstrap)}\n`);
       child.stdio[3].end();
       handshakeSocket = controllerSocketPath;
@@ -783,11 +799,23 @@ async function activateManagedSupervisorController({ repoRoot, runDir, runId, ad
       const deadline = Date.now() + timeoutMs;
       while (Date.now() < deadline) {
         try { if ((await lstat(handshakeSocket)).isSocket()) break; } catch (error) { if (error?.code !== 'ENOENT') throw error; }
-        if (child.exitCode !== null) fail('ADAPTER_CONTROLLER_UNAVAILABLE', `controller exited: ${child.exitCode}`);
+        if (child.exitCode !== null) {
+          fail(
+            'ADAPTER_CONTROLLER_UNAVAILABLE',
+            `controller exited: ${child.exitCode}${childStderr ? `: ${childStderr.trim()}` : ''}`,
+          );
+        }
         await new Promise((resolve) => setTimeout(resolve, 20));
       }
       let socketInfo;
-      try { socketInfo = await lstat(handshakeSocket); } catch { fail('ADAPTER_CONTROLLER_UNAVAILABLE', 'controller socket未生成'); }
+      try {
+        socketInfo = await lstat(handshakeSocket);
+      } catch {
+        fail(
+          'ADAPTER_CONTROLLER_UNAVAILABLE',
+          `controller socket未生成${childStderr ? `: ${childStderr.trim()}` : ''}`,
+        );
+      }
       if (!socketInfo.isSocket()) fail('ADAPTER_CONTROLLER_UNAVAILABLE', 'controller endpointがsocketでない');
       // exec後にも同じ実行image bytesを再検証する。PID生存も同時に要求する。
       try { process.kill(child.pid, 0); } catch { fail('ADAPTER_CONTROLLER_UNAVAILABLE', 'controller process不達'); }
@@ -902,7 +930,18 @@ async function activateManagedSupervisorController({ repoRoot, runDir, runId, ad
       await registerWithManagedSupervisor(managedSupervisor);
       return managedSupervisor;
     };
-    return { supervisorDescriptor, activationControlEvent, controllerDescriptor, registration, sessionNonce: supervisorSessionNonce, childPid: child?.pid ?? controllerDescriptor.pid, createManagedSupervisor, registerWithManagedSupervisor, disposeController };
+    return {
+      supervisorDescriptor,
+      activationControlEvent,
+      controllerDescriptor,
+      registration,
+      launchDescriptor: structuredClone(launch),
+      sessionNonce: supervisorSessionNonce,
+      childPid: child?.pid ?? controllerDescriptor.pid,
+      createManagedSupervisor,
+      registerWithManagedSupervisor,
+      disposeController,
+    };
   } catch (error) {
     if (child?.pid) { try { process.kill(child.pid, 'SIGTERM'); } catch { /* already exited */ } }
     await rm(controllerSocketPath, { force: true }).catch(() => {});