@north-light/crouter 0.3.276 → 0.3.278

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/core/__tests__/integration/command-plugins.test.js

@@ -821,9 +821,9 @@ describe('typed validation issues', () => {
 describe('plugin help addenda', () => {
     const gate = (paths) => ({
         reservedCoreNames: RESERVED,
-        coreCommandPaths: new Set(paths),
+        coreCommandPaths: () => Promise.resolve(new Set(paths)),
     });
-    test('a helpAddenda entry survives validation and is collected attributed to its plugin', () => {
+    test('a helpAddenda entry survives validation and is collected attributed to its plugin', async () => {
         const m = commandsJson();
         m['helpAddenda'] = { cron: 'Gate on the device: exit 75 parks the occurrence.' };
         installPlugin(userRoot, 'northlight-fixture', { manifest: m });
@@ -833,12 +833,12 @@ describe('plugin help addenda', () => {
         assert.equal(v.issues.length, 0, JSON.stringify(v.issues));
         assert.deepEqual(v.manifest?.helpAddenda, { cron: 'Gate on the device: exit 75 parks the occurrence.' });
         // The help-render lookup: attributed, and empty for an unaddended path.
-        assert.deepEqual(collectHelpAddenda('cron', gate(['cron', 'node']), emptyStart), [
+        assert.deepEqual(await collectHelpAddenda('cron', gate(['cron', 'node']), emptyStart), [
             { plugin: 'northlight-fixture', text: 'Gate on the device: exit 75 parks the occurrence.' },
         ]);
-        assert.deepEqual(collectHelpAddenda('node', gate(['cron', 'node']), emptyStart), []);
+        assert.deepEqual(await collectHelpAddenda('node', gate(['cron', 'node']), emptyStart), []);
     });
-    test('a key naming no core command path fails the strict gate and renders nothing, even beside a valid key', () => {
+    test('a key naming no core command path fails the strict gate and renders nothing, even beside a valid key', async () => {
         const m = commandsJson();
         m['helpAddenda'] = {
             cron: 'a valid target beside the typo',
@@ -860,7 +860,7 @@ describe('plugin help addenda', () => {
         // The render lookup reproduces the GATE verdict, not the compose one: the
         // rejected map contributes nothing — including its valid key — so render
         // can never show what the install report said was rejected.
-        assert.deepEqual(collectHelpAddenda('cron', gate(['cron', 'cron add']), emptyStart), []);
+        assert.deepEqual(await collectHelpAddenda('cron', gate(['cron', 'cron add']), emptyStart), []);
     });
     test('an installed addendum renders through the real help path as an attributed block', async () => {
         const m = commandsJson();

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