@crouton-kit/crouter 0.3.20 → 0.3.22

package/dist/core/__tests__/full/broker-lifecycle.test.js

@@ -0,0 +1,116 @@
+// Run with: node --import tsx/esm --test src/core/__tests__/full/broker-lifecycle.test.ts
+//
+// HEADLESS RETARGET (foundation-spec §C.6 + §E). The broker-backed lifecycle
+// acceptance gate (plan T11), items 1–3 — no tmux session, no hasTmux() gate.
+// FULL TIER: item 3 boots a REAL broker process (~5s pi-SDK load), so the file
+// lives in full/ (CI), not the fast local loop. (Items 1–2 are pure model reads.) The suite is SPLIT across sibling files (one isolated
+// harness each); the asserting test per acceptance item (plan §4):
+//   1 spawn --headless → host_kind='broker', null placement                      → "spawn" (here, MODEL)
+//   2 supervised by the broker pid (signal-0) — a healthy broker is left alone    → "spawn" (here, MODEL)
+//   3 inbox wakes LIVE (in-broker watcher) AND DORMANT (idle-release → daemon)    → "live wake" here + broker-dormant-wake.test.ts
+//   4–6 + M-1/M-2 crash / teardown / boot failure                                 → broker-crash-teardown.test.ts
+//   §5.4 C2 + G1…G9 dialogs / attach                                              → broker-dialogs / broker-attach-*.test.ts
+//
+// (1) BUG LOCKED — the headless-broker spawn+supervision contract. Items 1–2:
+//     `node new --headless` yields a BROKER-hosted node — host_kind='broker',
+//     NULL tmux placement (window/pane/tmux_session) — supervised purely by its
+//     recorded pi_pid (signal-0), so the daemon leaves a HEALTHY broker (live
+//     pid) untouched. Item 3: the REAL in-broker inbox-watcher delivers an inbox
+//     push to a LIVE broker via pi.sendUserMessage WITHOUT any exit or revive.
+//
+// (2) WHY MODEL-LEVEL, NOT TMUX CHROME — items 1–2 are pure row facts (host_kind,
+//     the three NULL placement columns, pid-supervision via handleBrokerLiveness),
+//     so they are fabricated DIRECTLY in the canvas with a LIVE pid and ZERO real
+//     boots: a tick with a live broker pid clears the grace timer and revives
+//     nothing. A broker carries no pane anywhere, so nothing here reads tmux.
+//     Item 3 alone needs ONE real broker boot — it proves the in-PROCESS watcher
+//     actually fires inside a live broker and reaches the engine's sendUserMessage
+//     (the wake is observable only as a real injected message).
+//
+// (3) HOW THE HEADLESS DRIVE STILL FAILS IF THE BUG REGRESSES — if spawn stopped
+//     setting host_kind='broker' / null placement, the item-1 model asserts fail;
+//     if the daemon revived a healthy (live-pid) broker, item-2's cycles bump and
+//     the asserts go RED; if the in-broker watcher stopped delivering, item-3's
+//     awaitWake times out (no injected message, no wake).
+import { test, before, after } from 'node:test';
+import assert from 'node:assert/strict';
+import { spawn } from 'node:child_process';
+import { createHarness } from '../helpers/harness.js';
+import { appendInbox } from '../../feed/inbox.js';
+import { isPidAlive } from '../../canvas/pid.js';
+let h;
+let root;
+// Disposable LIVE pids — a real, alive process the daemon can signal-0 probe as a
+// healthy broker. SIGKILLed in after().
+const livePids = [];
+function disposableLivePid() {
+    const child = spawn('sleep', ['600'], { stdio: 'ignore', detached: true });
+    child.unref();
+    livePids.push(child.pid);
+    return child.pid;
+}
+before(async () => {
+    h = await createHarness({ headless: true, sessionPrefix: 'crtr-broker' });
+    root = h.spawnRoot('broker-suite root');
+});
+after(async () => {
+    for (const pid of livePids) {
+        try {
+            process.kill(pid, 'SIGKILL');
+        }
+        catch {
+            /* already gone */
+        }
+    }
+    if (h !== undefined)
+        await h.dispose();
+});
+// ===========================================================================
+// Items 1 + 2 — spawn --headless: broker host_kind, NULL placement, supervised
+// by the broker pid alone. PURE MODEL READ: fabricate the broker row directly
+// (a LIVE supervised pid), assert the contract, tick once → a healthy broker is
+// LEFT. ZERO real boots.
+// ===========================================================================
+test('spawn --headless → broker host_kind, null placement; daemon leaves a healthy (live-pid) broker', async () => {
+    const livePid = disposableLivePid();
+    const id = h.fabricateBrokerNode({
+        status: 'active',
+        intent: null,
+        pi_pid: livePid, // a real, alive process — the signal-0 supervision target
+        pi_session_id: 'sess-lifecycle', // booted once (identity bound)
+    });
+    const node = h.node(id);
+    // Item 1: the broker host + a paneless placement (the three NULL columns).
+    assert.equal(node.host_kind, 'broker', "host_kind === 'broker'");
+    assert.equal(node.window ?? null, null, 'window is NULL (paneless broker)');
+    assert.equal(node.pane ?? null, null, 'pane is NULL (paneless broker)');
+    assert.equal(node.tmux_session ?? null, null, 'tmux_session is NULL (paneless broker)');
+    assert.ok(node.pi_pid != null, 'a broker pid is recorded as pi_pid');
+    assert.equal(isPidAlive(node.pi_pid), true, 'the broker pid is alive');
+    // Item 2: the supervision signal IS the broker pid. handleBrokerLiveness sees a
+    // LIVE pid → nothing pending; the daemon leaves a healthy broker untouched.
+    await h.tick();
+    assert.equal(h.status(id), 'active', 'a healthy broker stays active across a daemon tick');
+    assert.equal(h.node(id).pi_pid, livePid, 'pid unchanged — not revived');
+    assert.equal(h.node(id).cycles ?? 0, 0, 'no revive — cycles still 0');
+    assert.equal(isPidAlive(livePid), true, 'broker still alive');
+});
+// ===========================================================================
+// Item 3 (LIVE) — the in-broker inbox-watcher delivers an inbox push WITHOUT an
+// exit or revive (the broker stays alive; pi.sendUserMessage → injected). This
+// is the one item that genuinely exercises the broker PROCESS, so it pays ONE
+// real boot.
+// ===========================================================================
+test('LIVE wake — in-broker watcher injects an inbox push with no exit/revive', async () => {
+    const id = await h.spawnHeadlessChild(root, 'headless worker — live wake');
+    const pid = h.node(id).pi_pid;
+    const boots = h.bootCount(id);
+    appendInbox(id, { from: 'tester', tier: 'normal', kind: 'message', label: 'live-wake', data: { body: 'do this live' } });
+    // The REAL in-broker watcher (800ms poll + 1000ms debounce) delivers via
+    // pi.sendUserMessage → fake-pi.injected.jsonl.
+    await h.awaitWake(id, { match: /do this live/, timeoutMs: 15_000 });
+    // No exit, no revive: same broker pid, still alive, no new boot.
+    assert.equal(h.bootCount(id), boots, 'no new boot — the live broker was not revived');
+    assert.equal(h.node(id).pi_pid, pid, 'pi_pid unchanged — the broker never exited');
+    assert.equal(isPidAlive(pid), true, 'the broker is still alive after the live wake');
+});

package/dist/core/__tests__/{cascade-close.test.js → full/cascade-close.test.js}

@@ -46,7 +46,7 @@
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
 import { spawnSync } from 'node:child_process';
-import { createHarness, hasTmux } from './helpers/harness.js';
+import { createHarness, hasTmux } from '../helpers/harness.js';
 function sessionExists(session) {
     return spawnSync('tmux', ['has-session', '-t', session], { stdio: 'ignore' }).status === 0;
 }
@@ -103,8 +103,9 @@ test('cascade close: middle-node close reaps EXACTLY its subtree (canceled), anc
         // ===================================================================
         const closeRes = h.cli(A, ['node', 'close', '--node', B]);
         assert.equal(closeRes.code, 0, `node close exit 0\n${closeRes.stderr}`);
-        // The CLI's own rendered report: cascade root B, exactly 4 closed, 0 spared.
-        assert.match(closeRes.stdout, new RegExp(`<closed id="${B}" count="4" spared="0"\\s*/>`), `close report names B as root, count=4, spared=0\n${closeRes.stdout}`);
+        // The CLI's own rendered report (plain markdown): cascade root B, exactly
+        // 4 closed, 0 spared (no spared clause is emitted when none were spared).
+        assert.match(closeRes.stdout, new RegExp(`^Closed ${B} and its exclusive subtree — 4 node\\(s\\) closed\\.`), `close report names B as root, count=4, spared=0\n${closeRes.stdout}`);
         // ===================================================================
         // ASSERT 1 — the A5 DELIVERABLE: the EXACT terminal status of every
         // cascade-reaped node. CURRENT behavior: status='canceled', intent=null,

package/dist/core/__tests__/full/daemon-liveness-pane.full.test.js

@@ -0,0 +1,292 @@
+// Run with: node --import tsx/esm --test src/core/__tests__/full/daemon-liveness-pane.full.test.ts
+//
+// FULL-TIER (genuine tmux) half of the daemon liveness suite — split out of
+// daemon-liveness.test.ts (foundation-spec §C.8 + §E). These lock the daemon's
+// PANE-existence reconciliation: a live pane vs a stale window cache, the gone-
+// branch routing (crash / finalize / release), and the frozen-pane idle-release
+// revive. Every one of them needs a REAL live tmux window+pane to be faithful —
+// the verdict turns on `isNodePaneAlive → paneExists/paneLocation/listLivePanes`
+// probing the tmux server — so it cannot be model-fabricated; it stays CI-only.
+// (The pure decision primitives — livenessVerdict, isPidAlive — are the fast
+// half, in src/core/__tests__/daemon-liveness.test.ts.)
+import { test, before, after, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { spawn, spawnSync } from 'node:child_process';
+import { createNode, getNode, subscribe } from '../../canvas/canvas.js';
+import { closeDb } from '../../canvas/db.js';
+import { appendInbox } from '../../feed/inbox.js';
+import { markBusy, clearBusy } from '../../runtime/busy.js';
+import { superviseTick } from '../../../daemon/crtrd.js';
+let home;
+function node(id, over = {}) {
+    return {
+        node_id: id,
+        name: id,
+        created: new Date().toISOString(),
+        cwd: '/tmp/work',
+        kind: 'general',
+        mode: 'base',
+        lifecycle: 'terminal',
+        status: 'active',
+        ...over,
+    };
+}
+function hasTmux() {
+    return spawnSync('tmux', ['-V'], { stdio: 'ignore' }).status === 0;
+}
+/** A pid that is guaranteed dead: spawn a no-op and wait for it to exit. */
+function deadPid() {
+    const r = spawnSync('true', [], { stdio: 'ignore' });
+    return r.pid ?? 0x7ffffffe; // fall back to an implausibly-high pid
+}
+/** A pid that is ALIVE for the test's duration but expendable. Pane-gone
+ *  fixtures must NEVER use process.pid for an alive pi: the gone-pane zombie
+ *  sweep (b92082e) SIGKILLs a pane-gone node's live pid, which took the whole
+ *  test runner down with it. The daemon (or the after hook) reaps these. */
+const livePids = [];
+function disposableLivePid() {
+    const child = spawn('sleep', ['600'], { stdio: 'ignore', detached: true });
+    child.unref();
+    livePids.push(child.pid);
+    return child.pid;
+}
+before(() => {
+    home = mkdtempSync(join(tmpdir(), 'crtr-daemon-liveness-pane-'));
+    process.env['CRTR_HOME'] = home;
+});
+beforeEach(() => {
+    closeDb();
+    rmSync(home, { recursive: true, force: true });
+});
+after(() => {
+    closeDb();
+    rmSync(home, { recursive: true, force: true });
+    delete process.env['CRTR_HOME'];
+    for (const pid of livePids) {
+        try {
+            process.kill(pid, 'SIGKILL');
+        }
+        catch {
+            /* already reaped by the daemon's zombie sweep — fine */
+        }
+    }
+});
+// ---------------------------------------------------------------------------
+// superviseTick + a REAL live tmux window (gated on tmux availability)
+// ---------------------------------------------------------------------------
+/** Run `fn` with a real, live tmux window held open for its whole duration, then
+ *  tear the session down. Gives superviseTick a genuinely-alive window to judge. */
+async function withLiveWindow(tag, fn) {
+    const session = `crtr-livetest-${process.pid}-${tag}`;
+    spawnSync('tmux', ['new-session', '-d', '-s', session, '-c', '/tmp', 'sleep 600']);
+    try {
+        const r = spawnSync('tmux', ['list-windows', '-t', session, '-F', '#{window_id}'], { encoding: 'utf8' });
+        const window = (r.stdout ?? '').trim().split('\n')[0];
+        await fn(session, window);
+    }
+    finally {
+        spawnSync('tmux', ['kill-session', '-t', session], { stdio: 'ignore' });
+    }
+}
+/** Like withLiveWindow but also resolves the window's live `%pane_id` — the v3
+ *  pane-anchored handle the daemon now keys liveness on. */
+async function withLivePane(tag, fn) {
+    await withLiveWindow(tag, async (session, window) => {
+        const r = spawnSync('tmux', ['display-message', '-p', '-t', `${session}:${window}`, '#{pane_id}'], { encoding: 'utf8' });
+        const pane = (r.stdout ?? '').trim();
+        await fn(session, window, pane);
+    });
+}
+test('window alive + ALIVE pi pid → healthy, untouched', { skip: !hasTmux() }, async () => {
+    await withLiveWindow('a', async (session, window) => {
+        // pi_pid = this test process: definitely alive.
+        createNode(node('A', { tmux_session: session, window, pi_pid: process.pid, pi_session_id: 'booted' }));
+        await superviseTick();
+        assert.equal(getNode('A').status, 'active', 'a node with a live pi is left active');
+    });
+});
+test('window alive + dead pi pid → pending on first observation (not reaped, not revived)', { skip: !hasTmux() }, async () => {
+    await withLiveWindow('b', async (session, window) => {
+        createNode(node('D', {
+            tmux_session: session,
+            window,
+            pi_pid: deadPid(),
+            pi_session_id: 'booted-once',
+            intent: null,
+            status: 'active',
+        }));
+        await superviseTick();
+        // First observation: inside the grace window → pending. The node must NOT be
+        // reaped to 'dead' (its window is alive) nor revived yet (no new pi spawned).
+        assert.equal(getNode('D').status, 'active', 'pending node stays active on first tick');
+    });
+});
+// ---------------------------------------------------------------------------
+// Step 3 (Q6): PANE-existence drives the daemon verdict, not window-existence.
+// A manual move-pane/join-pane/break-pane must never read as a death; and a
+// pane that is genuinely gone fires the existing gone-branch even when the
+// window it used to live in is still alive.
+// ---------------------------------------------------------------------------
+test('pane alive but window/session cache STALE → LIVE (reconciled, not revived/reaped)', { skip: !hasTmux() }, async () => {
+    await withLivePane('p1', async (session, window, pane) => {
+        // The pane is live, the pi is alive (this process) — but the row's window
+        // cache is bogus (as if a manual move desynced it). Pane-existence must win:
+        // the node stays active and reconcile FOLLOWS the pane back to its real window.
+        createNode(node('M', {
+            pane,
+            tmux_session: session,
+            window: '@99999', // stale/bogus — windowAlive() would call this gone
+            pi_pid: process.pid,
+            pi_session_id: 'booted',
+        }));
+        await superviseTick();
+        const m = getNode('M');
+        assert.equal(m.status, 'active', 'a live pane keeps the node active despite a stale window cache');
+        assert.equal(m.window, window, 'reconcile FOLLOWED the live pane back to its real window');
+        assert.equal(m.pane, pane, 'the durable pane id is unchanged');
+    });
+});
+test('pane GONE while its old window is still alive → the gone-branch fires (crash → dead)', { skip: !hasTmux() }, async () => {
+    await withLivePane('p2', async (session, window) => {
+        // Make a guaranteed-DEAD pane id inside the still-live window: split a fresh
+        // pane, then kill it (the window survives via its original pane).
+        const sp = spawnSync('tmux', ['split-window', '-d', '-P', '-F', '#{pane_id}', '-t', `${session}:${window}`, 'sleep 600'], { encoding: 'utf8' });
+        const dead = (sp.stdout ?? '').trim();
+        spawnSync('tmux', ['kill-pane', '-t', dead], { stdio: 'ignore' });
+        // The window is alive, but the node is anchored on that dead pane. Under the
+        // old window-keyed liveness this node would read healthy (window alive + live
+        // pid). Pane-keyed: the pane is gone → the gone-branch fires. The node is
+        // MID-GENERATION (busy marker present — agent_start touched it, agent_end
+        // never cleared it), so the gone-branch routes to crash → 'dead'.
+        createNode(node('G', {
+            pane: dead,
+            tmux_session: session,
+            window,
+            pi_pid: disposableLivePid(), // alive zombie — the gone-pane sweep SIGKILLs it
+            pi_session_id: 'booted',
+            intent: null,
+        }));
+        markBusy('G'); // pane killed inside a turn → genuine mid-run crash
+        await superviseTick();
+        assert.equal(getNode('G').status, 'dead', 'a gone pane mid-generation fires the gone-branch → crash (dead)');
+        clearBusy('G');
+    });
+});
+// ---------------------------------------------------------------------------
+// Gone-pane routing: a pane-gone node in the crash branch is no longer an
+// unconditional 'dead'. It routes on what the node was DOING at pane-kill time:
+//   • mid-generation (busy marker PRESENT)               → crash  ('dead')
+//   • finished its turn, awaiting nothing live           → finalize ('done')
+//   • finished its turn, still awaiting a LIVE child     → release ('idle' + idle-release), revivable
+// (The mid-generation → dead leg is covered by node 'G' above.)
+// ---------------------------------------------------------------------------
+test('pane gone + booted + busy ABSENT + no live subscription → finalize (done): the pane was closed to dismiss a finished node', { skip: !hasTmux() }, async () => {
+    await withLivePane('fin1', async (session, window) => {
+        const sp = spawnSync('tmux', ['split-window', '-d', '-P', '-F', '#{pane_id}', '-t', `${session}:${window}`, 'sleep 600'], { encoding: 'utf8' });
+        const dead = (sp.stdout ?? '').trim();
+        spawnSync('tmux', ['kill-pane', '-t', dead], { stdio: 'ignore' });
+        // Booted (pi_session_id set), no busy marker (agent_end cleared it → the turn
+        // finished), and no subscription to any live node. Closing the pane was a
+        // dismissal of a node that already did its own work → finalize to 'done'.
+        createNode(node('FIN', {
+            pane: dead,
+            tmux_session: session,
+            window,
+            pi_pid: disposableLivePid(), // alive zombie — swept before finalize routing
+            pi_session_id: 'booted',
+            intent: null,
+        }));
+        // no markBusy: the turn ended cleanly.
+        await superviseTick();
+        assert.equal(getNode('FIN').status, 'done', 'a finished, unsubscribed node whose pane was closed finalizes to done');
+    });
+});
+test('pane gone + booted + busy ABSENT but AWAITING a LIVE child → idle-release (revivable, NOT dead)', { skip: !hasTmux() }, async () => {
+    await withLivePane('fin2', async (session, window) => {
+        const sp = spawnSync('tmux', ['split-window', '-d', '-P', '-F', '#{pane_id}', '-t', `${session}:${window}`, 'sleep 600'], { encoding: 'utf8' });
+        const dead = (sp.stdout ?? '').trim();
+        spawnSync('tmux', ['kill-pane', '-t', dead], { stdio: 'ignore' });
+        // A live child the parent is subscribed to: hasActiveLiveSubscription === true.
+        createNode(node('CHILD', { status: 'active', pi_session_id: 'booted' }));
+        createNode(node('PARENT', {
+            pane: dead,
+            tmux_session: session,
+            window,
+            pi_pid: deadPid(), // the user closed the pane → pi is dead
+            pi_session_id: 'booted',
+            intent: null,
+        }));
+        subscribe('PARENT', 'CHILD', true); // active subscription to a LIVE node
+        // REGRESSION: closing the pane of a waiting orchestrator must NOT kill it.
+        // PARENT finished its turn (no busy marker) but still awaits a live child, so
+        // a hard 'dead' would orphan the child's report. It routes to idle-release
+        // (revivable); the second pass revives it on the next inbox push. No inbox
+        // entry here, so it stays dormant (idle + idle-release) — revivable, not dead.
+        await superviseTick();
+        const p = getNode('PARENT');
+        assert.equal(p.status, 'idle', 'a finished node still awaiting a live child is RELEASED, not killed');
+        assert.equal(p.intent, 'idle-release', 'routed to idle-release so a child push revives it');
+        assert.equal(p.window ?? null, null, 'the stale window ref is dropped');
+    });
+});
+// ---------------------------------------------------------------------------
+// Step 7 (§5.3, F3): a focused-dormant node frozen via remain-on-exit is
+// PANE-alive but pi-DEAD with intent='idle-release'. The daemon must NOT
+// grace-revive it on liveness (handleLiveWindow early-returns for idle-release);
+// it revives ONLY when an unseen inbox entry arrives (second pass, gated on pi
+// liveness — NOT pane existence, which would skip a frozen pane forever).
+// ---------------------------------------------------------------------------
+test('idle-release + live (frozen) pane + DEAD pi → handleLiveWindow does NOT grace-revive it', { skip: !hasTmux() }, async () => {
+    await withLivePane('idle1', async (session, window, pane) => {
+        createNode(node('F', {
+            pane,
+            tmux_session: session,
+            window,
+            pi_pid: deadPid(), // pi is DEAD; the pane is frozen (remain-on-exit stand-in)
+            pi_session_id: 'booted',
+            intent: 'idle-release',
+            status: 'idle',
+            home_session: session,
+        }));
+        // Two ticks: the SECOND is far past REVIVE_GRACE_MS (20s). Without the
+        // idle-release early-return in handleLiveWindow, tick 1 would mark the dead
+        // pi 'pending' and tick 2 (now past grace) would grace-revive it, bumping
+        // cycles. The early-return means it is never even marked pending. No inbox
+        // entry, so the second pass never revives it either.
+        await superviseTick(1_000_000);
+        await superviseTick(1_000_000 + 60_000);
+        const m = getNode('F');
+        assert.equal(m.status, 'idle', 'still idle — the frozen focused-dormant node is left alone');
+        assert.equal(m.cycles ?? 0, 0, 'cycles NOT bumped → reviveNode never fired');
+        assert.equal(m.pane, pane, 'pane unchanged');
+        assert.equal(m.window, window, 'window unchanged');
+        // Non-vacuous: drop the `intent==='idle-release'` early-return and tick 2
+        // (deadFor 60s > 20s grace) revives → cycles===1, status flips → both fail.
+    });
+});
+test('idle-release + live (frozen) pane + DEAD pi + UNSEEN inbox → REVIVED on the second pass', { skip: !hasTmux() }, async () => {
+    await withLivePane('idle2', async (session, window, pane) => {
+        createNode(node('W', {
+            pane,
+            tmux_session: session,
+            window,
+            pi_pid: deadPid(),
+            pi_session_id: 'booted',
+            intent: 'idle-release',
+            status: 'idle',
+            home_session: session, // the revive window lands here (torn down with the session)
+        }));
+        appendInbox('W', { from: 'child', tier: 'normal', kind: 'update', label: 'work for you' });
+        await superviseTick();
+        // The OLD second-pass guard `if (isNodePaneAlive(r)) continue;` would SKIP a
+        // pane-alive node forever; the new `if (r.pi_pid != null && isPidAlive(...))`
+        // gate sees the DEAD pi and revives. reviveNode bumps cycles BEFORE placing
+        // the window, so the bump is the observable even though the launch is a real
+        // (short-lived, torn-down) window. Non-vacuous: the old pane-existence gate
+        // leaves cycles unbumped.
+        assert.equal(getNode('W').cycles, 1, 'reviveNode fired on the inbox push despite a live (frozen) pane');
+    });
+});

package/dist/core/__tests__/{dead-pane-regression.test.js → full/dead-pane-regression.test.js}

@@ -27,8 +27,8 @@
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
 import { spawnSync } from 'node:child_process';
-import { hasTmux } from './helpers/harness.js';
-import { spawnAndDetach } from '../spawn.js';
+import { hasTmux } from '../helpers/harness.js';
+import { spawnAndDetach } from '../../spawn.js';
 const SKIP = !hasTmux();
 // --- LOCAL tmux drivers (keyed on a raw %pane id, not a canvas node) --------
 function tmux(args) {

package/dist/core/__tests__/{detach-focus.test.js → full/detach-focus.test.js}

@@ -32,11 +32,11 @@
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
 import { spawnSync } from 'node:child_process';
-import { createHarness, hasTmux } from './helpers/harness.js';
-import { setPresence, getNode } from '../canvas/canvas.js';
-import { openFocusRow, getFocusByNode, getFocusByPane, listFocuses } from '../canvas/focuses.js';
-import { closeDb } from '../canvas/db.js';
-import { markBusy } from '../runtime/busy.js';
+import { createHarness, hasTmux } from '../helpers/harness.js';
+import { setPresence, getNode } from '../../canvas/canvas.js';
+import { openFocusRow, getFocusByNode, getFocusByPane, listFocuses } from '../../canvas/focuses.js';
+import { closeDb } from '../../canvas/db.js';
+import { markBusy } from '../../runtime/busy.js';
 const SKIP = !hasTmux() ? 'tmux unavailable' : false;
 function sessionExists(session) {
     return spawnSync('tmux', ['has-session', '-t', session], { stdio: 'ignore' }).status === 0;
@@ -109,7 +109,7 @@ test('node demote --detach on a FOCUSED node: flips terminal, relocates the pane
         //     breaks the pane back into h.session.
         const res = h.cli(B, ['node', 'demote', '--node', B, '--pane', bPane, '--detach']);
         assert.equal(res.code, 0, `node demote --detach exit 0\n${res.stderr}`);
-        assert.match(res.stdout, /detached="true"/, `the agent was detached\n${res.stdout}`);
+        assert.match(res.stdout, /relocated to the background/, `the agent was detached\n${res.stdout}`);
         closeDb();
         const b = getNode(B);
         // (a) lifecycle flipped to terminal IN PLACE.
@@ -180,7 +180,7 @@ test('node demote --detach on a NON-GENERATING focused node: RELEASES to dormant
         // --- Drive the REAL verb on the non-generating focused node.
         const res = h.cli(B, ['node', 'demote', '--node', B, '--pane', bPane, '--detach']);
         assert.equal(res.code, 0, `node demote --detach exit 0\n${res.stderr}`);
-        assert.match(res.stdout, /detached="true"/, `the agent was detached\n${res.stdout}`);
+        assert.match(res.stdout, /relocated to the background/, `the agent was detached\n${res.stdout}`);
         closeDb();
         const b = getNode(B);
         // (b) RELEASED to dormant — idle + intent='idle-release' (revivable via inbox

package/dist/core/__tests__/{human-new-window-regression.test.js → full/human-new-window-regression.test.js}

@@ -21,8 +21,8 @@
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
 import { spawnSync } from 'node:child_process';
-import { hasTmux } from './helpers/harness.js';
-import { spawnAndDetach } from '../spawn.js';
+import { hasTmux } from '../helpers/harness.js';
+import { spawnAndDetach } from '../../spawn.js';
 const SKIP = !hasTmux();
 function tmux(args) {
     const r = spawnSync('tmux', args, { encoding: 'utf8' });

package/dist/core/__tests__/{placement-focus.test.js → full/placement-focus.test.js}

@@ -18,11 +18,11 @@ import { mkdtempSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { spawnSync } from 'node:child_process';
-import { createNode, getNode, setPresence } from '../canvas/canvas.js';
-import { openFocusRow, getFocusByNode, getFocusById, listFocuses, } from '../canvas/focuses.js';
-import { closeDb } from '../canvas/db.js';
-import { outgoingDisposition, retargetFocus, openFocus, focus as placementFocus, registerRootFocus, focusByPane, detachToBackground, } from '../runtime/placement.js';
-import { markBusy, isBusy } from '../runtime/busy.js';
+import { createNode, getNode, setPresence } from '../../canvas/canvas.js';
+import { openFocusRow, getFocusByNode, getFocusById, listFocuses, } from '../../canvas/focuses.js';
+import { closeDb } from '../../canvas/db.js';
+import { outgoingDisposition, retargetFocus, openFocus, focus as placementFocus, registerRootFocus, focusByPane, detachToBackground, } from '../../runtime/placement.js';
+import { markBusy, isBusy } from '../../runtime/busy.js';
 let home;
 let savedTmux;
 function node(id, over = {}) {

package/dist/core/__tests__/{placement-reconcile.test.js → full/placement-reconcile.test.js}

@@ -17,9 +17,9 @@ import { mkdtempSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { spawnSync } from 'node:child_process';
-import { createNode, getNode, getRow } from '../canvas/canvas.js';
-import { closeDb } from '../canvas/db.js';
-import { reconcileDecision, reconcile, isNodePaneAlive, } from '../runtime/placement.js';
+import { createNode, getNode, getRow } from '../../canvas/canvas.js';
+import { closeDb } from '../../canvas/db.js';
+import { reconcileDecision, reconcile, isNodePaneAlive, } from '../../runtime/placement.js';
 let home;
 function node(id, over = {}) {
     return {

package/dist/core/__tests__/{placement-revive.test.js → full/placement-revive.test.js}

@@ -27,11 +27,11 @@ import { mkdtempSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { spawnSync } from 'node:child_process';
-import { createNode, getNode } from '../canvas/canvas.js';
-import { openFocusRow, getFocusByNode, getFocusById } from '../canvas/focuses.js';
-import { closeDb } from '../canvas/db.js';
-import { reviveTarget, reviveIntoPlacement, reconcileFocus } from '../runtime/placement.js';
-import { reviveInPlace } from '../runtime/revive.js';
+import { createNode, getNode } from '../../canvas/canvas.js';
+import { openFocusRow, getFocusByNode, getFocusById } from '../../canvas/focuses.js';
+import { closeDb } from '../../canvas/db.js';
+import { reviveTarget, reviveIntoPlacement, reconcileFocus } from '../../runtime/placement.js';
+import { reviveInPlace } from '../../runtime/revive.js';
 let home;
 function node(id, over = {}) {
     return {

package/dist/core/__tests__/{placement-teardown.test.js → full/placement-teardown.test.js}

@@ -18,10 +18,10 @@ import { mkdtempSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { spawnSync } from 'node:child_process';
-import { createNode, getNode } from '../canvas/canvas.js';
-import { openFocusRow, getFocusByNode, getFocusById } from '../canvas/focuses.js';
-import { closeDb } from '../canvas/db.js';
-import { handFocusToManager, tearDownNode } from '../runtime/placement.js';
+import { createNode, getNode } from '../../canvas/canvas.js';
+import { openFocusRow, getFocusByNode, getFocusById } from '../../canvas/focuses.js';
+import { closeDb } from '../../canvas/db.js';
+import { handFocusToManager, tearDownNode } from '../../runtime/placement.js';
 let home;
 function node(id, over = {}) {
     return {

package/dist/core/__tests__/{review-render-pane-regression.test.js → full/review-render-pane-regression.test.js}

@@ -32,8 +32,8 @@ import { tmpdir } from 'node:os';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { createRequire } from 'node:module';
-import { hasTmux } from './helpers/harness.js';
-const CROUTER = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
+import { hasTmux } from '../helpers/harness.js';
+const CROUTER = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', '..');
 const CLI_SRC = join(CROUTER, 'src', 'cli.ts');
 const TSX_ESM = createRequire(import.meta.url).resolve('tsx/esm');
 function tmux(args) {

package/dist/core/__tests__/full/spike-harness.test.d.ts

@@ -0,0 +1 @@
+export {};