@north-light/crouter 0.3.172 → 0.3.174

package/dist/clients/attach/render/group-recap.js

@@ -23,6 +23,9 @@ function memoryName(memory, palette) {
         ? hyperlink(name, pathToFileURL(memory.path).href)
         : name;
 }
+function countMemories(memories, action) {
+    return memories.filter((memory) => memory.action === action).length;
+}
 function distinctFileCount(files) {
     return new Set(files.map((file) => file.key)).size;
 }
@@ -52,7 +55,8 @@ export class GroupRecapComponent extends Container {
         this.addChild(new Spacer(1));
         if (detailed) {
             for (const memory of activity.memories) {
-                this.addChild(new RecapDetailLine(`${palette.info(MEMORY_ICON)} `, memoryName(memory, palette), ''));
+                const icon = memory.action === 'write' ? TOOL_ICON.write : MEMORY_ICON;
+                this.addChild(new RecapDetailLine(`${palette.info(icon)} `, memoryName(memory, palette), ''));
             }
             for (const file of activity.files)
                 this.addFile(file, palette);
@@ -70,8 +74,13 @@ export class GroupRecapComponent extends Container {
             if (changedFiles >= 1) {
                 stats.push(`${palette.warning(TOOL_ICON.edit)} ${palette.muted(count(changedFiles, 'file changed', 'files changed'))}`);
             }
-            if (activity.memories.length >= 1) {
-                stats.push(`${palette.info(MEMORY_ICON)} ${palette.muted(count(activity.memories.length, 'memory read', 'memory reads'))}`);
+            const memoriesRead = countMemories(activity.memories, 'read');
+            if (memoriesRead >= 1) {
+                stats.push(`${palette.info(MEMORY_ICON)} ${palette.muted(count(memoriesRead, 'memory read', 'memory reads'))}`);
+            }
+            const memoriesSaved = countMemories(activity.memories, 'write');
+            if (memoriesSaved >= 1) {
+                stats.push(`${palette.info(TOOL_ICON.write)} ${palette.muted(count(memoriesSaved, 'memory saved', 'memories saved'))}`);
             }
             this.addChild(new Text(stats.join(palette.muted(' · ')), 0, 0));
         }

package/dist/clients/attach/session/connection.js

@@ -1,5 +1,5 @@
 // session/connection.ts — how a viewer gets onto a broker: resolving the
-// local-vs-relay target, dialing it, the role it claims in the hello
+// local or remote attach target, dialing it, the role it claims in the hello
 // handshake, and the optional pre-wait for a socket still being bound.
 //
 // Everything here runs BEFORE the TUI takes over the terminal, which is the
@@ -102,8 +102,8 @@ export async function connectToNode(nodeId, canvasName) {
         catch (err) {
             rethrowAsCliError(err, 'The node may be finalized or otherwise not attachable.');
         }
-        // Local only: a relay accepts the WS upgrade unconditionally, so there is
-        // no socket file to pre-wait on for `--canvas`.
+        // Local only: remote attach reaches crtrd over WebSocket rather than a
+        // local socket file, so `--canvas` has nothing to pre-wait on.
         await preWaitForViewSocket(nodeId);
     }
     const socket = new BrokerClient(nodeId, { transport });
@@ -125,18 +125,12 @@ export async function connectToNode(nodeId, canvasName) {
             next: 'Check the node has a running headless broker.',
         });
     };
-    // A remote relay ACCEPTS the WS upgrade unconditionally and only proves
-    // "no such node/broker" asynchronously — by closing 1011 AFTER the upgrade
-    // completes (`RelayTransport`'s `onClose`, mirroring `server.ts`'s
-    // `bridgeConnection`). That close therefore always lands strictly AFTER the
-    // transport's `connect` event, never before it, so it can never be caught by
-    // a connect-race listener torn down the moment `connect` resolves. Install a
-    // listener that is NEVER removed instead, before dialing at all, so nothing
-    // landing during the caller's synchronous TUI/editor setup has nowhere to go.
-    // `assertConnected` is the caller's one synchronous checkpoint on it, taken
-    // immediately before permanent socket wiring; anything after that is
-    // legitimately mid-session and belongs to the reconnect supervisor, exactly
-    // as it already does for a local socket.
+    // A remote crtrd attach connection can close after its WebSocket upgrade when
+    // its broker socket drops. Install a listener before dialing and keep it
+    // through synchronous TUI/editor setup, so `assertConnected` can surface any
+    // terminal startup failure at its one checkpoint immediately before permanent
+    // socket wiring. Failures after that are mid-session and belong to the
+    // reconnect supervisor, as they do for a local socket.
     let terminalStartupError;
     socket.on('error', (err) => {
         if (terminalStartupError === undefined)

package/dist/clients/attach/session/editor-inventory.d.ts

@@ -1,12 +1,13 @@
 import { CombinedAutocompleteProvider } from '@earendil-works/pi-tui';
 import type { BrokerDataFrame, RefMeta } from '../../../core/runtime/broker-protocol.js';
+import type { ViewerCapabilities } from '../input/capabilities.js';
 import { type PreviewableCommand } from '../slash/prompt-preview.js';
 import type { AttachBindings } from './bindings.js';
 import type { AttachSession } from './context.js';
-export declare function buildAttachAutocompleteProvider(cwd: string, fdPath: string | null, commands?: ReadonlyArray<{
+export declare function buildAttachAutocompleteProvider(cwd: string, fdPath: string | null, commands: ReadonlyArray<{
     name: string;
     description?: string;
-}>, remote?: boolean, createProvider?: (items: ReadonlyArray<{
+}> | undefined, capabilities: ViewerCapabilities, createProvider?: (items: ReadonlyArray<{
     name: string;
     description?: string;
 }>, cwd: string, fdPath: string | null) => CombinedAutocompleteProvider): CombinedAutocompleteProvider;
@@ -54,6 +55,6 @@ export interface EditorInventoryHooks {
 /** Owns everything the editor can complete against — the merged slash-command
  *  list, the loaded-command preview, the broker's raw command metadata, and the
  *  memory-ref inventory — plus the popup that inspects the loaded template.
- *  Construction seeds the command list with builtins-only (`setCommands()`), so
- *  autocomplete works before the broker's first `get_commands` ack. */
-export declare function createEditorInventory(ctx: Pick<AttachSession, 'remote' | 'meta' | 'socket' | 'tui' | 'editor'>, hooks: EditorInventoryHooks): EditorInventory;
+ *  Input wiring supplies the session capability before first render, seeding
+ *  builtins-only autocomplete before the broker's first `get_commands` ack. */
+export declare function createEditorInventory(ctx: Pick<AttachSession, 'meta' | 'socket' | 'tui' | 'editor'>, capabilities: ViewerCapabilities, hooks: EditorInventoryHooks): EditorInventory;

package/dist/clients/attach/session/editor-inventory.js

@@ -19,8 +19,8 @@ import { surfaceTmuxStyleArgs } from '../../../core/runtime/surface-bg.js';
 import { RefAwareAutocompleteProvider } from '../input/ref-autocomplete.js';
 import { CANVAS_SLASH_COMMANDS, locallyConsumedCommandNames, slashCommandList } from '../slash/dispatch.js';
 import { loadedCommandPreview } from '../slash/prompt-preview.js';
-export function buildAttachAutocompleteProvider(cwd, fdPath, commands, remote = false, createProvider = (items, cwd, path) => new CombinedAutocompleteProvider([...items], cwd, path)) {
-    return createProvider([...slashCommandList(commands, remote)], cwd, fdPath);
+export function buildAttachAutocompleteProvider(cwd, fdPath, commands, capabilities, createProvider = (items, cwd, path) => new CombinedAutocompleteProvider([...items], cwd, path)) {
+    return createProvider([...slashCommandList(commands, capabilities)], cwd, fdPath);
 }
 export function createMemoryRefRefreshCoordinator(setMemoryRefs, request) {
     let epoch = 0;
@@ -46,10 +46,10 @@ export function createMemoryRefRefreshCoordinator(setMemoryRefs, request) {
 /** Owns everything the editor can complete against — the merged slash-command
  *  list, the loaded-command preview, the broker's raw command metadata, and the
  *  memory-ref inventory — plus the popup that inspects the loaded template.
- *  Construction seeds the command list with builtins-only (`setCommands()`), so
- *  autocomplete works before the broker's first `get_commands` ack. */
-export function createEditorInventory(ctx, hooks) {
-    const { remote, meta, socket, tui, editor } = ctx;
+ *  Input wiring supplies the session capability before first render, seeding
+ *  builtins-only autocomplete before the broker's first `get_commands` ack. */
+export function createEditorInventory(ctx, capabilities, hooks) {
+    const { meta, socket, tui, editor } = ctx;
     let commands = [];
     let commandPreview;
     // The broker's RAW command metadata (`undefined` until the first get_commands
@@ -90,7 +90,7 @@ export function createEditorInventory(ctx, hooks) {
     // refs never enter command completion or the loaded-command preview (which
     // reads only `commands`, never `memoryRefs`).
     const syncEditorInventories = () => {
-        const commandProvider = buildAttachAutocompleteProvider(meta.cwd, hooks.fdPath, brokerCommands, remote);
+        const commandProvider = buildAttachAutocompleteProvider(meta.cwd, hooks.fdPath, brokerCommands, capabilities);
         editor.setAutocompleteProvider(new RefAwareAutocompleteProvider(memoryRefs, commandProvider));
         editor.setResolvedRefNames(memoryRefs.map((ref) => ref.name));
         // Two independent suppression inventories (review Major 6): the viewer-local
@@ -130,7 +130,6 @@ export function createEditorInventory(ctx, hooks) {
         syncEditorInventories();
         tui.requestRender();
     };
-    setCommands();
     // The correlated ref-inventory lifecycle (design: inline memory references,
     // T3 terminal integration). `socket.request` is the same observer-safe
     // read-op channel local and remote attach already share, so this is

package/dist/clients/attach/session/file-links.d.ts

@@ -0,0 +1,13 @@
+/** URI of the OSC-8 hyperlink occupying the given 1-indexed terminal cell. */
+export declare function osc8UriAt(frame: readonly string[], row: number, column: number): string | undefined;
+export type LinkedFileOpenResult = 'opened' | 'missing' | 'invalid' | 'failed';
+/** Replace this local viewer pane with Neovim, then reattach it when Neovim exits. */
+export declare function openLinkedFileInPane(opts: {
+    uri: string;
+    pane: string;
+    cwd: string;
+    nodeId: string;
+    observer: boolean;
+    /** Clear viewer-local pane identity immediately before the pane runs Neovim. */
+    beforeRespawn: () => void;
+}): LinkedFileOpenResult;

package/dist/clients/attach/session/file-links.js

@@ -0,0 +1,107 @@
+// session/file-links.ts — OSC-8 file links in the rendered attach frame.
+//
+// A click is resolved against the physical rows last handed to the terminal,
+// not against transcript records: wrapping, fixed cockpit rows, ANSI styling,
+// and OSC-8 boundaries have all already been composed there.
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import stringWidth from 'string-width';
+import { respawnPaneInBackground, shellQuote, viewerSplitEnv } from '../../../core/runtime/placement-tmux.js';
+const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+/** URI of the OSC-8 hyperlink occupying the given 1-indexed terminal cell. */
+export function osc8UriAt(frame, row, column) {
+    if (!Number.isInteger(row) || !Number.isInteger(column) || row < 1 || column < 1)
+        return undefined;
+    let activeUri;
+    for (let index = 0; index < Math.min(row, frame.length); index++) {
+        const hitColumn = index === row - 1 ? column : undefined;
+        const scanned = scanOsc8Row(frame[index] ?? '', activeUri, hitColumn);
+        activeUri = scanned.activeUri;
+        if (scanned.uri !== undefined)
+            return scanned.uri;
+    }
+    return undefined;
+}
+function scanOsc8Row(line, initialUri, hitColumn) {
+    let activeUri = initialUri;
+    let cell = 1;
+    let index = 0;
+    while (index < line.length) {
+        if (line[index] === '\x1b') {
+            const escape = readEscape(line, index);
+            if (escape === undefined)
+                break;
+            const osc8 = parseOsc8(escape.text);
+            if (osc8 !== null)
+                activeUri = osc8 === '' ? undefined : osc8;
+            index = escape.end;
+            continue;
+        }
+        const nextEscape = line.indexOf('\x1b', index);
+        const text = line.slice(index, nextEscape === -1 ? undefined : nextEscape);
+        for (const segment of GRAPHEMES.segment(text)) {
+            const width = stringWidth(segment.segment);
+            if (hitColumn !== undefined && width > 0 && hitColumn >= cell && hitColumn < cell + width && activeUri !== undefined) {
+                return { activeUri, uri: activeUri };
+            }
+            cell += width;
+        }
+        index = nextEscape === -1 ? line.length : nextEscape;
+    }
+    return { activeUri, uri: undefined };
+}
+/** Read one terminal control sequence so non-printing ANSI never takes a cell. */
+function readEscape(line, start) {
+    const kind = line[start + 1];
+    if (kind === undefined)
+        return undefined;
+    // OSC, APC, DCS, and PM are string controls terminated by BEL or ST. pi-tui's
+    // cursor marker uses APC, so it must consume no display cells here.
+    if (kind === ']' || kind === '_' || kind === 'P' || kind === '^') {
+        const bel = line.indexOf('\x07', start + 2);
+        const st = line.indexOf('\x1b\\', start + 2);
+        const end = bel === -1 ? st : st === -1 ? bel : Math.min(bel, st);
+        if (end === -1)
+            return undefined;
+        return { text: line.slice(start, end + (end === bel ? 1 : 2)), end: end + (end === bel ? 1 : 2) };
+    }
+    if (kind === '[') {
+        let end = start + 2;
+        while (end < line.length && (line.charCodeAt(end) < 0x40 || line.charCodeAt(end) > 0x7e))
+            end++;
+        if (end >= line.length)
+            return undefined;
+        return { text: line.slice(start, end + 1), end: end + 1 };
+    }
+    return { text: line.slice(start, start + 2), end: start + 2 };
+}
+/** `null` means another escape sequence; an empty URI closes the active link. */
+function parseOsc8(sequence) {
+    if (!sequence.startsWith('\x1b]8;'))
+        return null;
+    const terminatorLength = sequence.endsWith('\x1b\\') ? 2 : 1;
+    const body = sequence.slice(4, -terminatorLength);
+    const separator = body.indexOf(';');
+    if (separator === -1)
+        return null;
+    return body.slice(separator + 1);
+}
+/** Replace this local viewer pane with Neovim, then reattach it when Neovim exits. */
+export function openLinkedFileInPane(opts) {
+    let file;
+    try {
+        const url = new URL(opts.uri);
+        if (url.protocol !== 'file:')
+            return 'invalid';
+        file = fileURLToPath(url);
+    }
+    catch {
+        return 'invalid';
+    }
+    if (!existsSync(file))
+        return 'missing';
+    const attach = `crtr surface attach to ${shellQuote(opts.nodeId)}${opts.observer ? ' --observer' : ''}`;
+    const command = `nvim ${shellQuote(file)} || :; exec ${attach}`;
+    opts.beforeRespawn();
+    return respawnPaneInBackground({ pane: opts.pane, cwd: opts.cwd, env: viewerSplitEnv(), command }) ? 'opened' : 'failed';
+}

package/dist/clients/attach/session/frame.d.ts

@@ -24,8 +24,11 @@ export declare class ViewerFrame implements Component {
     private readonly terminal;
     private readonly parts;
     private viewportRows;
+    private lastFrame;
     constructor(terminal: Terminal, parts: ViewerFrameParts);
     render(width: number): string[];
+    /** The physical rows returned by the most recent render. */
+    lastRenderedFrame(): readonly string[];
     invalidate(): void;
     /** Rows the transcript viewport got in the last frame — the page size. */
     lastViewportRows(): number;

package/dist/clients/attach/session/frame.js

@@ -55,6 +55,7 @@ export class ViewerFrame {
     terminal;
     parts;
     viewportRows = 0;
+    lastFrame = [];
     constructor(terminal, parts) {
         this.terminal = terminal;
         this.parts = parts;
@@ -115,7 +116,15 @@ export class ViewerFrame {
         }
         if (frame.length !== rows)
             reportInvariant(`frame correction rendered ${frame.length} rows; expected ${rows}`);
-        return this.ensureCursorMarker(frame, editorLines, editorSlice, editorBottomOffset, bottomLines.length, rows);
+        const finalFrame = this.ensureCursorMarker(frame, editorLines, editorSlice, editorBottomOffset, bottomLines.length, rows);
+        // This is the exact physical screen content used for OSC-8 mouse hit tests.
+        // Keep a copy because terminal rendering is allowed to retain the returned array.
+        this.lastFrame = finalFrame.slice();
+        return finalFrame;
+    }
+    /** The physical rows returned by the most recent render. */
+    lastRenderedFrame() {
+        return this.lastFrame;
     }
     invalidate() {
         this.parts.header.invalidate();

package/dist/clients/attach/session/frames.js

@@ -1,9 +1,8 @@
 // session/frames.ts — what this terminal DOES about each broker frame.
 //
 // Every fact a frame carries is folded by the shared pure reducer
-// (`core/session-model`), which the web SPA folds too — that shared fold is
-// what keeps the two viewers from drifting, and it happens in `foldState`
-// before anything here runs. What is left, and all this file owns, is the
+// (`core/session-model`) in `foldState` before anything here runs. What is left,
+// and all this file owns, is the
 // LOCAL effects: transcript writes, notices, editor text, and the correlated
 // refetches a fresh broker forces.
 //

package/dist/clients/attach/session/input-wiring.d.ts

@@ -1,4 +1,5 @@
 import { InputController } from '../input/controller.js';
+import { type ViewerCapabilities } from '../input/capabilities.js';
 import type { ToolDisplayToggle } from '../render/chat-view.js';
 import type { KeybindingsManager } from '@earendil-works/pi-tui';
 import type { CopyTarget } from '../render/transcript-copy.js';
@@ -40,5 +41,7 @@ export interface InputWiringHooks {
     /** A prompt or steer was accepted from the editor. */
     onPromptSent: () => void;
 }
+/** Construct the viewer's one capability authority. */
+export declare function createViewerCapabilitiesForInput(ctx: Pick<AttachSession, 'nodeId' | 'remote' | 'role' | 'meta'>): ViewerCapabilities;
 /** Build the viewer's InputController with every hook answered. */
-export declare function createInputController(ctx: Pick<AttachSession, 'nodeId' | 'remote' | 'role' | 'meta' | 'socket' | 'tui' | 'editor' | 'containers'>, km: KeybindingsManager, hooks: InputWiringHooks): InputController;
+export declare function createInputController(ctx: Pick<AttachSession, 'nodeId' | 'remote' | 'role' | 'meta' | 'socket' | 'tui' | 'editor' | 'containers'>, km: KeybindingsManager, capabilities: ViewerCapabilities, hooks: InputWiringHooks): InputController;

package/dist/clients/attach/session/input-wiring.js

@@ -12,18 +12,23 @@
 // pickers (which need a reference to the controller being constructed, so they
 // can only be closed over from inside).
 import { InputController } from '../input/controller.js';
+import { createViewerCapabilities } from '../input/capabilities.js';
 import { cliClient } from '../../../commands/api-client.js';
 import { buildLoginPicker, buildLogoutPicker } from '../overlays/auth.js';
 import { defaultAgentDir } from '../config.js';
+/** Construct the viewer's one capability authority. */
+export function createViewerCapabilitiesForInput(ctx) {
+    return createViewerCapabilities({
+        nodeId: ctx.nodeId,
+        profileId: ctx.meta.profile_id ?? undefined,
+        remote: ctx.remote,
+        role: ctx.role,
+    });
+}
 /** Build the viewer's InputController with every hook answered. */
-export function createInputController(ctx, km, hooks) {
-    const { nodeId, remote, role, socket, tui, editor, containers } = ctx;
+export function createInputController(ctx, km, capabilities, hooks) {
+    const { nodeId, socket, tui, editor, containers } = ctx;
     const { setNotice } = hooks;
-    // The viewer's fixed capability, resolved once at hello: an `--observer`
-    // attach (and a remote one, which is always an observer) may read but never
-    // mutate. Every mutating hook below is wired only when this is true; the
-    // read-op channel (`onRequest`) and the read-only getters stay wired for all.
-    const writable = !remote && role === 'controller';
     // Auth pickers — viewer-local OAuth/API-key flows against the SAME auth.json
     // the broker uses (broker + viewer share a filesystem in the tmux-local attach
     // model), so they run entirely in this process and then tell the broker to
@@ -37,7 +42,7 @@ export function createInputController(ctx, km, hooks) {
     // slash context carries no picker at all, so `/login` and `/logout` report
     // themselves unavailable rather than reaching a `reload_auth` frame.
     const reloadAuth = () => socket.send({ type: 'reload_auth' });
-    const authPickers = !writable
+    const authPickers = !capabilities.permits('auth')
         ? {}
         : {
             openLoginPicker: () => {
@@ -56,10 +61,6 @@ export function createInputController(ctx, km, hooks) {
         // The slash context: `/promote` targets this node, `/resume-node` opens
         // scoped to its profile, `remote` structurally omits the local-only
         // canvas commands, and `/graph` toggles the overlay.
-        nodeId,
-        profileId: ctx.meta.profile_id ?? undefined,
-        remote,
-        role,
         onGraph: hooks.toggleGraph,
         onInbox: hooks.toggleInbox,
         onHelp: hooks.toggleHelp,
@@ -111,7 +112,7 @@ export function createInputController(ctx, km, hooks) {
         // broker (it goes to crtrd via `cliClient`), so leaving it wired for an
         // observer would let a read-only viewer wake and message the node.
         isDormant: hooks.isDormant,
-        onDormantSubmit: !writable ? undefined : (msgText) => {
+        onDormantSubmit: !capabilities.permits('wake-dormant') ? undefined : (msgText) => {
             void (async () => {
                 try {
                     // Text typed into a node's box IS the human talking to it — mark it
@@ -128,6 +129,6 @@ export function createInputController(ctx, km, hooks) {
             })();
         },
         ...authPickers,
-    });
+    }, capabilities);
     return input;
 }

package/dist/clients/attach/session/mouse.d.ts

@@ -12,7 +12,12 @@ export interface MouseReporting {
     /** Turn off unconditionally — teardown and process exit. */
     disable(): void;
     /** Install the SGR listener; returns the remover. */
-    install(tui: TUI, onWheel: (direction: 'up' | 'down', lines: number, column: number) => void): () => void;
+    install(tui: TUI, handlers: MouseHandlers): () => void;
+}
+export interface MouseHandlers {
+    onWheel(direction: 'up' | 'down', lines: number, column: number): void;
+    /** A primary-button press with no Shift, Alt, or Control modifier. */
+    onPrimaryPress(column: number, row: number): void;
 }
 /** Create per-viewer mouse reporting from the user's saved starting mode. */
 export declare function createMouseReporting(write: (data: string) => void, defaultMode: MouseModeDefault): MouseReporting;

package/dist/clients/attach/session/mouse.js

@@ -41,15 +41,18 @@ export function createMouseReporting(write, defaultMode) {
         },
         reassert,
         disable,
-        install: (tui, onWheel) => tui.addInputListener((data) => {
+        install: (tui, handlers) => tui.addInputListener((data) => {
             let consumed = false;
-            const withoutSgr = data.replace(/\x1b\[<(\d+);(\d+);\d+[Mm]/g, (_match, buttons, column) => {
+            const withoutSgr = data.replace(/\x1b\[<(\d+);(\d+);(\d+)([Mm])/g, (_match, buttons, column, row, action) => {
                 consumed = true;
-                const button = Number(buttons) & ~(4 | 8 | 16);
+                const code = Number(buttons);
+                const button = code & ~(4 | 8 | 16);
                 if (button === 64)
-                    onWheel('up', WHEEL_LINES, Number(column));
+                    handlers.onWheel('up', WHEEL_LINES, Number(column));
                 if (button === 65)
-                    onWheel('down', WHEEL_LINES, Number(column));
+                    handlers.onWheel('down', WHEEL_LINES, Number(column));
+                if (code === 0 && action === 'M')
+                    handlers.onPrimaryPress(Number(column), Number(row));
                 return '';
             });
             const withoutMouse = withoutSgr.replace(/\x1b\[M[\s\S]{3}/g, () => {

package/dist/clients/attach/session/profile-files.js

@@ -1,15 +1,16 @@
 // session/profile-files.ts — fuzzy file search across a node's local profile.
 //
-// The popup searches the current workspace plus every project named by the
-// node's profile manifest. Ancestor `.crouter/memory/` stores are added with
-// ignore rules disabled, so project memory remains findable even when a parent
-// ignore file hides `.crouter/`. fzf owns selection and nvim owns viewing; the
-// attach viewer only resolves the relevant roots and wires the two popups.
+// The popup searches the current workspace, every project named by the node's
+// profile manifest, and the profile's own memory store. Ancestor
+// `.crouter/memory/` stores are added with ignore rules disabled, so project
+// memory remains findable even when a parent ignore file hides `.crouter/`.
+// fzf owns selection and nvim owns viewing; the attach viewer only resolves the
+// relevant roots and wires the two popups.
 import { constants, accessSync, existsSync, mkdtempSync, readFileSync, rmSync, statSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { delimiter, dirname, join, resolve, sep } from 'node:path';
 import { execFile, spawnSync } from 'node:child_process';
-import { loadProfileManifest } from '../../../core/profiles/manifest.js';
+import { loadProfileManifest, profileMemoryDir } from '../../../core/profiles/manifest.js';
 import { shellQuote } from '../../../core/runtime/placement-tmux.js';
 import { surfaceTmuxStyleArgs } from '../../../core/runtime/surface-bg.js';
 function isDirectory(path) {
@@ -44,14 +45,15 @@ function workingExecutable(name, preferred) {
     }
     return null;
 }
-function profileProjectDirs(profileId) {
+function profileSearchRoots(profileId) {
     if (profileId === null || profileId === '')
-        return [];
+        return { projects: [], memory: null };
     try {
-        return loadProfileManifest(profileId).manifest.projects;
+        const { profileId: resolvedId, manifest } = loadProfileManifest(profileId);
+        return { projects: manifest.projects, memory: profileMemoryDir(resolvedId) };
     }
     catch {
-        return [];
+        return { projects: [], memory: null };
     }
 }
 function dedupeExistingDirs(paths) {
@@ -119,13 +121,17 @@ export function launchProfileFileSearch(opts) {
         opts.onNotice('Neovim is required for profile file search');
         return;
     }
-    const pointers = dedupeExistingDirs([opts.cwd, ...profileProjectDirs(opts.profileId)]);
+    const profile = profileSearchRoots(opts.profileId);
+    const pointers = dedupeExistingDirs([opts.cwd, ...profile.projects]);
     if (pointers.length === 0) {
         opts.onNotice('No profile file-search directories exist');
         return;
     }
     const roots = outermostDirs(pointers);
-    const memoryDirs = ancestorMemoryDirs(pointers);
+    const memoryDirs = dedupeExistingDirs([
+        ...(profile.memory === null ? [] : [profile.memory]),
+        ...ancestorMemoryDirs(pointers),
+    ]);
     const tempDir = mkdtempSync(join(tmpdir(), 'crtr-profile-files-'));
     const selected = join(tempDir, 'selection');
     const scans = [

package/dist/clients/attach/session/reconnect.js

@@ -105,7 +105,7 @@ export function createReconnect(ctx, hooks) {
                 hooks.setNotice(dormant ? '' : '↻ node refreshing — reconnecting…', { sticky: !dormant });
                 try {
                     const redialed = await Promise.race([
-                        socket.redial().then(() => true),
+                        socket.redial({ brokerUnavailableIsExpected: dormant }).then(() => true),
                         stoppedSignal.then(() => false),
                     ]);
                     if (!redialed || stopped || hooks.isTornDown())

package/dist/clients/attach/session/state-sync.js

@@ -4,8 +4,7 @@
 // Everything this viewer knows because the broker told it — role, pi's engine
 // state, context tokens, the queue, the retained display levels — lives in ONE
 // value folded by the shared pure reducer (`core/session-model`), not in a
-// handful of mutable locals patched from a frame switch. The web SPA folds the
-// same reducer, which is what keeps the two viewers from drifting.
+// handful of mutable locals patched from a frame switch.
 //
 // The dirty tracking IS identity comparison: `reduce` returns the same
 // reference for any frame that changes nothing, and the same sub-object for any

package/dist/clients/attach/session/surface-host.d.ts

@@ -16,7 +16,8 @@ export interface ViewerSurfaceHostOptions {
     /** Styling supplied by the viewer's status-line palette. */
     formatNotice: (text: string) => string;
     noticeMs: number;
-    capabilities: SurfaceHost['capabilities'];
+    /** The session facts; the host itself publishes `selfPane` from below. */
+    capabilities: Omit<SurfaceHost['capabilities'], 'selfPane'>;
     selfPane?: string;
 }
 /** The viewer's one host for full-pane surfaces. */
@@ -53,7 +54,7 @@ export declare class ViewerSurfaceHost implements SurfaceHost {
         title?: string;
     }): Promise<string | null>;
     /** Offer wheel input to the topmost surface only. */
-    handleWheel(direction: 'up' | 'down', lines: number, column: number): boolean;
+    handleWheel(direction: 'up' | 'down', lines: number): boolean;
     /** Whether a full-pane surface currently owns input. */
     hasFullPaneSurface(): boolean;
     /** Close the whole stack before the viewer tears down its TUI. */

package/dist/clients/attach/session/surface-host.js

@@ -1,6 +1,6 @@
 import { truncateToWidth, } from '@earendil-works/pi-tui';
 import { cliClient } from '../../../commands/api-client.js';
-import { focusViewer } from '../../../commands/node.js';
+import { focusViewer } from '../../../commands/surface/node/placement.js';
 import { daemonErrorMessage } from '../../inbox/resolve.js';
 import { buildFileReviewPicker } from '../overlays/file-review.js';
 import { reportInvariant as report } from './invariant.js';
@@ -37,8 +37,8 @@ export class ViewerSurfaceHost {
         this.statusNotice = options.statusNotice;
         this.formatNotice = options.formatNotice;
         this.noticeMs = options.noticeMs;
-        this.capabilities = options.capabilities;
         this.selfPane = options.selfPane;
+        this.capabilities = { ...options.capabilities, selfPane: options.selfPane };
     }
     mount(component, opts) {
         this.disposeNotice();
@@ -136,8 +136,8 @@ export class ViewerSurfaceHost {
         });
     }
     /** Offer wheel input to the topmost surface only. */
-    handleWheel(direction, lines, column) {
-        return this.stack[this.stack.length - 1]?.component.handleWheel?.(direction, lines, column) ?? false;
+    handleWheel(direction, lines) {
+        return this.stack[this.stack.length - 1]?.component.handleWheel?.(direction, lines) ?? false;
     }
     /** Whether a full-pane surface currently owns input. */
     hasFullPaneSurface() {