@north-light/crouter 0.3.277 → 0.3.279

package/dist/commands/canvas-browse.js

@@ -23,14 +23,14 @@ export const browseLeaf = defineLeaf({
                 name: 'return-pane',
                 type: 'string',
                 required: false,
-                constraint: 'tmux pane id to focus the chosen node INTO (set by the /resume-node popup so the node lands back in your pi pane). Default: this pane.',
+                constraint: 'tmux pane id the chosen node REPLACES on Enter — that pane is respawned onto its viewer (set by the /resume popup, so resuming swaps the pane you invoked it from). Default: focus into this pane without replacing it.',
             },
             {
                 kind: 'flag',
                 name: 'cwd',
                 type: 'string',
                 required: false,
-                constraint: 'directory used when you toggle the optional cwd filter (c). The navigator opens with All dirs; /resume-node passes the launching node\'s cwd. Default: the invocation cwd.',
+                constraint: 'directory used when you toggle the optional cwd filter (c). The navigator opens with All dirs; /resume passes the launching node\'s cwd. Default: the invocation cwd.',
             },
             {
                 kind: 'flag',

package/dist/commands/node/bash.js

@@ -2,7 +2,6 @@
 import { envNodeId } from '../../shared/env.js';
 import { defineBranch, defineLeaf } from '../../core/command.js';
 import { InputError } from '../../core/io.js';
-import { displayMessage } from '../../core/runtime/tmux-chrome.js';
 import { contextDir } from '../../core/canvas/paths.js';
 import { existsSync } from 'node:fs';
 import { activeBackgroundBashJobs, backgroundRunningBashJobs, bashJobCommandLine, bashJobPaths, clearJobDeadline, formatBashElapsed, isSafeBashJobId, jobStartedAtMs, readJobPgid, stopBackgroundBashJob, tailJobLog, writeJobDeadlineMs } from '../../core/bash-jobs.js';
@@ -41,19 +40,17 @@ const nodeBashBackground = defineLeaf({
         effects: ['Signals every foreground bash command currently running for the node to return from its tool call immediately while its detached supervisor keeps the command running.', 'Each handed-off command retains its log under the node context jobs directory and sends the node an urgent inbox message when it exits, which steers the node mid-turn.'],
     },
     run: async (input) => {
-        const { id, pane } = resolveBashTarget(input, 'no node found for the bash handoff');
+        const { id } = resolveBashTarget(input, 'no node found for the bash handoff');
         if ((await getNodeOrNull(id)) === null) {
             throw new InputError({ error: 'not_found', message: `no node: ${id}`, next: 'List nodes with `crtr node inspect list`.' });
         }
         const jobs = backgroundRunningBashJobs(contextDir(id));
         const now = Date.now();
         const elapsed = jobs.map((job) => ({ job_id: job.jobId, elapsed_ms: now - (jobStartedAtMs(job.jobId) ?? now) }));
-        const toast = jobs.length === 0
-            ? 'crtr: no running bash command'
-            : jobs.length === 1
-                ? `crtr: bash handed off · ${formatBashElapsed(elapsed[0].elapsed_ms)}`
-                : `crtr: bash handed off (${jobs.length})`;
-        displayMessage(toast, pane);
+        // No tmux toast. A tmux status-line message commandeers the whole client's
+        // status bar for seconds over an action the user just took deliberately;
+        // the viewer reports its own handoff in its own status line, which is where
+        // someone watching that pane is already looking.
         return { node_id: id, jobs: elapsed };
     },
     render: (result) => {

package/dist/core/__tests__/helpers/fleet.d.ts

@@ -9,4 +9,4 @@ export interface TestFleet {
  *  process's fleet. Call in `before`/`beforeEach`; `bindFleet` throws on a
  *  conflicting rebind, so the previous binding is reset first (same idiom as
  *  resetEventSourceForTests). Pass `now` to inject the throttle clock. */
-export declare function bindTestFleet(opts?: Partial<Pick<DaemonFleetOpts, 'epoch' | 'now'>>): TestFleet;
+export declare function bindTestFleet(opts?: Partial<Pick<DaemonFleetOpts, 'epoch' | 'now' | 'probeOnline'>>): TestFleet;

package/dist/core/__tests__/helpers/fleet.js

@@ -30,6 +30,11 @@ export function bindTestFleet(opts = {}) {
             });
         },
         ...(opts.now !== undefined ? { now: opts.now } : {}),
+        // Respawn policy consults network reachability — an offline box parks a
+        // node rather than spending its respawn budget. Default it online so tests
+        // stay deterministic off the network; pass `probeOnline` to drive the
+        // outage branch.
+        probeOnline: opts.probeOnline ?? (async () => true),
     });
     bindFleet(fleet);
     return {

package/dist/core/__tests__/helpers/harness.js

@@ -252,7 +252,11 @@ export async function createHarness(opts = {}) {
             await tail;
         } while (tail !== laneTail);
     }
-    const fleet = new DaemonFleet({ epoch: 'harness-epoch', enqueue: enqueueLaneJob });
+    // Respawn policy probes network reachability (an offline box parks a node
+    // instead of spending its respawn budget). Reachability is an environment
+    // condition, not runtime behavior under test — pin it online so a sandboxed
+    // or offline runner exercises the same recovery path a connected one does.
+    const fleet = new DaemonFleet({ epoch: 'harness-epoch', enqueue: enqueueLaneJob, probeOnline: async () => true });
     bindFleet(fleet);
     // Neutralize ensureDaemon (spawn.ts calls it on every `node new`): write a
     // fake-live-daemon pidfile pointing at OUR (always-alive) pid, so

package/dist/core/canvas/browse/app.d.ts

@@ -1,6 +1,6 @@
 import type { CanvasSource } from '../source.js';
 import { type BindingId, type BindingResolution, type RawTerminalInput } from '../../keybindings/index.js';
-declare const BROWSE_NAV_ACTIONS: readonly ["crtr.browse.quit", "crtr.browse.down", "crtr.browse.up", "crtr.browse.first", "crtr.browse.last", "crtr.browse.expand-or-child", "crtr.browse.collapse-or-parent", "crtr.browse.toggle-fold", "crtr.browse.tab-next", "crtr.browse.tab-previous", "crtr.browse.tab.1", "crtr.browse.tab.2", "crtr.browse.tab.3", "crtr.browse.tab.4", "crtr.browse.tab.5", "crtr.browse.close-subtree", "crtr.browse.sort", "crtr.browse.scope", "crtr.browse.profile", "crtr.browse.residents", "crtr.browse.preview", "crtr.browse.pin", "crtr.browse.search", "crtr.browse.revive-now", "crtr.browse.focus", "crtr.browse.focus-background", "crtr.browse.yank-id"];
+declare const BROWSE_NAV_ACTIONS: readonly ["crtr.browse.quit", "crtr.browse.down", "crtr.browse.up", "crtr.browse.first", "crtr.browse.last", "crtr.browse.expand-or-child", "crtr.browse.collapse-or-parent", "crtr.browse.toggle-fold", "crtr.browse.tab-next", "crtr.browse.tab-previous", "crtr.browse.tab.1", "crtr.browse.tab.2", "crtr.browse.tab.3", "crtr.browse.tab.4", "crtr.browse.tab.5", "crtr.browse.close-subtree", "crtr.browse.sort", "crtr.browse.scope", "crtr.browse.profile", "crtr.browse.residents", "crtr.browse.preview", "crtr.browse.report", "crtr.browse.pin", "crtr.browse.search", "crtr.browse.revive-now", "crtr.browse.focus", "crtr.browse.focus-background", "crtr.browse.yank-id"];
 declare const BROWSE_SEARCH_ACTIONS: readonly ["crtr.browse.search.cancel", "crtr.browse.search.commit", "crtr.browse.search.delete", "crtr.browse.search.quit"];
 export declare function resolveBrowseNavAction(bindings: BindingResolution<BindingId>, raw: RawTerminalInput): (typeof BROWSE_NAV_ACTIONS)[number] | null;
 export declare function resolveBrowseSearchAction(bindings: BindingResolution<BindingId>, raw: RawTerminalInput): (typeof BROWSE_SEARCH_ACTIONS)[number] | null;

package/dist/core/canvas/browse/app.js

@@ -10,7 +10,7 @@
 import { envNodeId } from '../../../shared/env.js';
 import { execFileSync } from 'node:child_process';
 import { resolve } from 'node:path';
-import { dashboardRowsAllFromSource, enrichRowsFromSource, loadPreviewFromSource, renderForestFromSource } from '../render-source.js';
+import { dashboardRowsAllFromSource, enrichRowsFromSource, loadPreviewFromSource, loadTranscriptFromSource, renderForestFromSource } from '../render-source.js';
 import { fullName } from '../labels.js';
 import { setupTerminal, restoreTerminal, getTerminalSize, parseKeypress, } from '../../tui/terminal.js';
 import { buildTree, flatten, pruneNode, TABS } from './model.js';
@@ -22,7 +22,7 @@ const BROWSE_NAV_ACTIONS = [
     'crtr.browse.tab-next', 'crtr.browse.tab-previous', 'crtr.browse.tab.1', 'crtr.browse.tab.2',
     'crtr.browse.tab.3', 'crtr.browse.tab.4', 'crtr.browse.tab.5', 'crtr.browse.close-subtree', 'crtr.browse.sort',
     'crtr.browse.scope', 'crtr.browse.profile', 'crtr.browse.residents', 'crtr.browse.preview',
-    'crtr.browse.pin', 'crtr.browse.search',
+    'crtr.browse.report', 'crtr.browse.pin', 'crtr.browse.search',
     'crtr.browse.revive-now', 'crtr.browse.focus', 'crtr.browse.focus-background', 'crtr.browse.yank-id',
 ];
 const BROWSE_SEARCH_ACTIONS = [
@@ -120,7 +120,8 @@ export async function runBrowse(opts) {
         cwdScope: null, // default: All dirs
         profileScope: launchProfileId,
         sort: 'attention', // default: attention ordering (attached/streaming/live first)
-        preview: false, // default OFF (decision) — `v` opens it for the hovered row
+        preview: true, // default ON — the hovered node's conversation is the point
+        showReport: false,
         residentsOnly: true, // default ON: hide one-shot workers (decision)
         pendingClose: null,
         flash: null,
@@ -168,12 +169,24 @@ export async function runBrowse(opts) {
             /* best-effort — the SIGTERM is what matters; the daemon owns the resume */
         }
     };
-    /** Open the chosen node — the ONLY sanctioned path (reviveNode via surface node focus). */
+    /** Open the chosen node — the ONLY sanctioned path (reviveNode via surface node focus).
+     *  With a return pane (the `/resume` popup), the chosen node REPLACES that pane:
+     *  `--in-place` respawns it onto the node, so resuming swaps the viewer you came
+     *  from instead of splitting another one beside it. The respawn kills that pane's
+     *  process tree, so it is dispatched through `tmux run-shell -b` — the tmux server
+     *  context — and never as a child of this popup, which the same teardown can take
+     *  with it mid-call. Without a return pane, the caller's own pane hosts the viewer
+     *  as before. */
     const selectAndFocus = (id) => {
         cleanup();
-        const args = ['surface', 'node', 'focus', id, ...(opts.returnPane !== undefined && opts.returnPane !== '' ? ['--pane', opts.returnPane] : [])];
+        const returnPane = opts.returnPane !== undefined && opts.returnPane !== '' ? opts.returnPane : undefined;
         try {
-            execFileSync('crtr', args, { stdio: 'inherit' });
+            if (returnPane !== undefined) {
+                execFileSync('tmux', ['run-shell', '-b', `crtr surface node focus ${id} --pane ${returnPane} --in-place >/dev/null 2>&1`], { stdio: 'ignore' });
+            }
+            else {
+                execFileSync('crtr', ['surface', 'node', 'focus', id], { stdio: 'inherit' });
+            }
         }
         catch {
             // `surface node focus` swaps panes out from under us; a sync call can be
@@ -244,13 +257,20 @@ export async function runBrowse(opts) {
         const cur = curRow();
         if (cur !== undefined) {
             const r = rowOf(cur.id);
-            if (r !== undefined)
+            if (r !== undefined) {
                 await loadPreviewFromSource(source, r);
+                // The chat transcript is the side panel's body, so it is read for the
+                // SELECTED row only — never on the background warm pass, where one ordered
+                // transcript per node would hold the whole canvas's conversations in memory.
+                if (previewLayout(size.cols, previewOn).mode === 'side')
+                    await loadTranscriptFromSource(source, r);
+            }
         }
         const frame = renderFrame({
             tree, visible, tab: state.tab, cursor: state.cursor, scrollOffset: state.scrollOffset,
             query: state.query, search: state.search, totalNodes,
             cwdScope: state.cwdScope, profileScope: state.profileScope, sort: state.sort, preview: state.preview,
+            showReport: state.showReport,
             residentsOnly: state.residentsOnly, pendingClose: state.pendingClose, flash: state.flash,
             pinned: state.pinned, help: state.help,
             rename: state.rename, renameBuf: state.renameBuf,
@@ -704,6 +724,11 @@ export async function runBrowse(opts) {
             scheduleFlush();
             return;
         }
+        if (action === 'crtr.browse.report') {
+            state.showReport = !state.showReport;
+            scheduleFlush();
+            return;
+        }
         // Help overlay.
         if (input === '?') {
             state.help = true;

package/dist/core/canvas/browse/render.d.ts

@@ -1,5 +1,6 @@
+import type { TranscriptTurn } from '../render-source.js';
 import type { Tab, Tree, VisibleRow, SortMode } from './model.js';
-import { detectColorCaps, type ColorCaps } from '../../tui/draw.js';
+import { detectColorCaps, type Span, type ColorCaps } from '../../tui/draw.js';
 export { detectColorCaps };
 export type { ColorCaps };
 export declare const RECAP_LINES = 2;
@@ -33,8 +34,12 @@ export interface RenderState {
     profileScope: string | undefined;
     /** Active ordering — status line + (flat modes) row presentation. */
     sort: SortMode;
-    /** Whether the bottom preview panel is drawn. */
+    /** Whether the preview panel is drawn. */
     preview: boolean;
+    /** Side panel shows the node's newest report instead of the goal/chat/state
+     *  briefing. Ignored while a search query is live (the transcript owns the panel)
+     *  and for a node that has pushed nothing. */
+    showReport?: boolean;
     /** Lifecycle filter: when true, `terminal` (one-shot worker) nodes are hidden
      *  — surfaced as a status-line cue. */
     residentsOnly: boolean;
@@ -72,6 +77,16 @@ export declare function previewAllocation(hasRecap: boolean, hasReport: boolean)
     reply: number;
     report: number;
 };
+/** Re-style every case-insensitive occurrence of `query` inside already-rendered
+ *  spans, splitting runs at the match edges. Working on the RENDERED text is what
+ *  lets a transcript keep its markdown and still highlight: the markup is already
+ *  gone, so no column can drift out from under a highlight. */
+export declare function highlightSpans(spans: Span[], query: string): {
+    spans: Span[];
+    hits: number;
+};
+/** How many turns contain the query — the count the section rule advertises. */
+export declare function transcriptHitTurns(turns: readonly TranscriptTurn[], query: string): number;
 /**
  * Render the whole frame. Returns a single string that, written as-is, repaints
  * the screen in place. `caps` gates all hue (defaults to a no-color frame so