@north-light/crouter 0.3.233 → 0.3.235

package/dist/commands/node/inspect.js

@@ -82,16 +82,17 @@ const nodeList = defineLeaf({
                 return false;
             return true;
         });
-        const nodes = (await Promise.all(rows.map(async (row) => {
+        const nodes = [];
+        for (const row of rows) {
             const detail = await canvasSource.getNode(row.node_id).catch(rethrowAsCliError);
-            return { ...row, name: fullName(detail ?? row) };
-        }))).filter((row) => name === undefined || name === '' || fuzzyMatch(name, row.name));
+            const named = { ...row, name: fullName(detail ?? row) };
+            if (name === undefined || name === '' || fuzzyMatch(name, named.name))
+                nodes.push(named);
+        }
         return { nodes };
     },
 });
-// ---------------------------------------------------------------------------
 // node inspect show — a node + its place in the spine
-// ---------------------------------------------------------------------------
 // The renderer receives only the command result, while JSON output bypasses it.
 // Keep remote provenance out of the returned DTO-shaped object without adding a
 // second wire field or mutating the remote response.
@@ -121,6 +122,7 @@ const nodeShow = defineLeaf({
         ],
         output: [
             { name: 'node', type: 'object', required: true, constraint: 'The full node meta (system prompt + every telemetry field). The render surfaces a glanceable slice; `--json` carries the complete dump.' },
+            { name: 'fault', type: 'object', required: true, constraint: 'The active runtime fault projection, or null: {link, kind, retry: {disposition}, since}.' },
             { name: 'reports', type: 'object[]', required: true, constraint: 'Who this node subscribes to (its reports/down), each enriched with {node_id, name, kind, status, active} — these are typically its spawned children.' },
             { name: 'managers', type: 'object[]', required: true, constraint: 'Who subscribes to this node (its managers/up), same enriched shape.' },
             { name: 'artifacts', type: 'object', required: true, constraint: 'Counts of what the node left on disk by corpus: {report, doc, roadmap}. Enumerate them with `node inspect artifacts <id>`.' },
@@ -188,7 +190,7 @@ const nodeShow = defineLeaf({
         if (reports.length > 0)
             hints.push(`Drill into a child/report: \`crtr node inspect show <node_id>\` (${reports.map((r) => r['node_id']).join(', ')}).`);
         hints.push(`Full machine dump (system prompt + all telemetry): \`crtr --json node inspect show ${id}\`.`);
-        return { node, reports, managers, artifacts, pending_crons, paths, follow_up: hints.join('\n') };
+        return { node, fault: node.fault ?? null, reports, managers, artifacts, pending_crons, paths, follow_up: hints.join('\n') };
     },
     render: (r) => {
         const node = r['node'];
@@ -197,12 +199,14 @@ const nodeShow = defineLeaf({
         const isRemoteShow = remoteShowResults.has(r);
         const alive = isRemoteShow ? 'remote (liveness not checked locally)' : (isPidAlive(pid) ? 'alive' : 'dead');
         const intent = node['intent'] ? `/${String(node['intent'])}` : '';
+        const fault = r['fault'];
         const parts = [];
         // 1) Glanceable meta slice — the debug-critical fields, not the full dump.
         parts.push(`# ${fullName(node)}  (${id})`);
         const meta = [
             `- kind/mode/lifecycle: ${node['kind']} / ${node['mode']} / ${node['lifecycle']}`,
             `- status: ${node['status']}${intent}`,
+            ...(fault === null || fault === undefined ? [] : [`- fault: ${String(fault['kind'])} / ${String(fault['retry']?.disposition)} since ${String(fault['since'])}`]),
             `- broker pid: ${pid ?? '(none)'} — ${alive}`,
             `- cwd: ${node['cwd']}`,
             `- host: ${node['host_kind']}` + (node['profile_id'] ? ` · profile ${node['profile_id']}` : ''),
@@ -233,9 +237,7 @@ const nodeShow = defineLeaf({
         return parts.join('\n\n');
     },
 });
-// ---------------------------------------------------------------------------
 // node fork — branch a conversation + durable context into an idle root
-// ---------------------------------------------------------------------------
 export const nodeFork = defineLeaf({
     name: 'fork',
     description: 'fork a node into an independent idle root with the same conversation and durable context',
@@ -287,9 +289,7 @@ export const nodeFork = defineLeaf({
         return `Forked independent idle root ${result['node_id']}.${placement} It will make no model call until its first real user message.`;
     },
 });
-// ---------------------------------------------------------------------------
 // node inspect — read the graph (list, show, context)
-// ---------------------------------------------------------------------------
 export const nodeInspect = defineBranch({
     name: 'inspect',
     description: 'read one node — its graph position, context, and artifacts',
@@ -297,6 +297,7 @@ export const nodeInspect = defineBranch({
     help: {
         name: 'node inspect',
         summary: 'read one node (or the roster) — topology, context dir, and artifacts',
+        model: 'Inspection is read-only and never revives a node. The roster is the selection surface; one-node metadata points to progressively heavier views: a parsed broker snapshot, rendered conversation, context browser, or artifact references.',
     },
     children: [nodeList, nodeShow, nodeSnapshotLeaf, nodeTranscriptLeaf, nodeContextLeaf, nodeArtifactsLeaf],
 });

package/dist/commands/node/lifecycle.js

@@ -1,4 +1,5 @@
 // `crtr node` lifecycle and durable configuration commands.
+import { envNodeId } from '../../shared/env.js';
 import { defineBranch, defineLeaf } from '../../core/command.js';
 import { InputError } from '../../core/io.js';
 import { cliClient, getNodeOrNull, rethrowAsCliError } from '../api-client.js';
@@ -65,9 +66,7 @@ const nodeRecycle = defineLeaf({
         return lines.join('\n');
     },
 });
-// ---------------------------------------------------------------------------
 // node lifecycle close — close a node + cascade-cancel its exclusive subtree (Alt+C → x)
-// ---------------------------------------------------------------------------
 const nodeClose = defineLeaf({
     name: 'close',
     description: 'close a node + cascade-cancel its exclusive subtree (revivable)',
@@ -110,9 +109,7 @@ const nodeClose = defineLeaf({
         return `Closed ${r['node_id']} and its exclusive subtree — ${r['count']} node(s) closed${spared > 0 ? `, ${spared} spared (still managed from outside the subtree)` : ''}.`;
     },
 });
-// ---------------------------------------------------------------------------
 // node config — reconfigure a node's settings headlessly (model/lifecycle/kind/mode/name)
-// ---------------------------------------------------------------------------
 const NODE_CONFIG_MODEL_EFFECT = 'Model change first: a live broker switches immediately over its socket; a dormant node persists the durable model override and launch recipe for its next revive.';
 export const nodeConfig = defineLeaf({
     name: 'config',
@@ -268,7 +265,7 @@ export const nodePromote = defineLeaf({
         effects: ['Flips mode→orchestrator + kind→chosen (lifecycle unchanged unless --resident, which also flips lifecycle→resident); --model durably pins the model tier; rewrites the launch spec to that kind\'s orchestrator persona; seeds context/roadmap.md scaffold if absent.', 'The next model request is gated on appending and persisting your new-role guidance. If a fresh context starts first, its rebuilt baseline carries the new role.'],
     },
     run: async (input) => {
-        const id = input['node'] ?? process.env['CRTR_NODE_ID'];
+        const id = input['node'] ?? envNodeId();
         if (id === undefined || id === '')
             throw new InputError({ error: 'no_node', message: 'no node to promote (set CRTR_NODE_ID or pass --node)', next: 'Run from inside a node, or pass --node <id>.' });
         const kind = input['kind'];
@@ -300,7 +297,7 @@ async function resolveLifecycleNode(input, pane) {
     if (id === undefined || id === '')
         id = nodeInPane(pane);
     if (id === undefined || id === '')
-        id = process.env['CRTR_NODE_ID'];
+        id = envNodeId();
     if (id === undefined || id === '')
         throw new InputError({ error: 'no_node', message: 'no node (set CRTR_NODE_ID, pass --node, or run from the agent\'s pane)', next: 'Run from inside a node, pass --node <id>, or --pane <pane>.' });
     const exists = await getNodeOrNull(id);
@@ -308,13 +305,11 @@ async function resolveLifecycleNode(input, pane) {
         throw new InputError({ error: 'not_found', message: `no node: ${id}`, next: 'List nodes with `crtr node inspect list`.' });
     return id;
 }
-// ---------------------------------------------------------------------------
 // node lifecycle demote — flip a node to TERMINAL in place (the friendly half
 // of the promote/demote pair; bound to Alt+C → d, and → D with --detach). It
 // stays focused and running but now owes a final up the spine. `node config
 // --lifecycle` remains the orthogonal low-level command (it also does resident).
 // See vision F5.
-// ---------------------------------------------------------------------------
 const nodeDemote = defineLeaf({
     name: 'demote',
     description: 'demote a node to terminal in place; it stays focused and running but now owes a final; --detach also closes its viewer (broker keeps running off-screen)',
@@ -352,9 +347,7 @@ const nodeDemote = defineLeaf({
     },
     render: (r) => `Demoted ${r['node_id']} — lifecycle now terminal (in place)${r['detached'] === true ? ', viewer closed (broker still running off-screen)' : ''}.`,
 });
-// ---------------------------------------------------------------------------
 // node lifecycle — recycle, close, or demote a node
-// ---------------------------------------------------------------------------
 export const nodeLifecycle = defineBranch({
     name: 'lifecycle',
     description: 'lifecycle actions — recycle, close, demote, or revive a node',
@@ -362,12 +355,11 @@ export const nodeLifecycle = defineBranch({
     help: {
         name: 'node lifecycle',
         summary: 'end, transition, or revive a node — recycle the pane, close + cascade-cancel a subtree, demote to terminal in place, or revive a dormant node',
+        model: 'Lifecycle actions preserve or replace an existing node identity. Finishing is permanent, closing is revivable, demotion changes the completion obligation in place, and revival relaunches a dormant broker. Teardown cascades only through descendants exclusively managed by the affected subtree.',
     },
     children: [nodeRecycle, nodeClose, nodeDemote, nodeReviveLeaf],
 });
-// ---------------------------------------------------------------------------
 // node yield — refresh: discard context, revive fresh in the same mode against roadmap or goal
-// ---------------------------------------------------------------------------
 export const nodeYield = defineLeaf({
     name: 'yield',
     description: 'refresh your context, same mode, against your roadmap or goal',
@@ -395,7 +387,7 @@ export const nodeYield = defineLeaf({
         effects: ['The stophook shuts the process down on next stop and the daemon revives it fresh.', '--kind and/or --model durably reshape the node (kind respecialization, model-tier pin) before the refresh-revive; --promote additionally flips mode→orchestrator and seeds a roadmap scaffold — mode is otherwise left exactly as it was.'],
     },
     run: async (input) => {
-        const id = process.env['CRTR_NODE_ID'];
+        const id = envNodeId();
         if (id === undefined || id === '')
             throw new InputError({ error: 'no_node', message: 'no node to yield (CRTR_NODE_ID unset)', next: 'Run from inside a node.' });
         const kind = input['kind'];

package/dist/commands/node/message.js

@@ -1,4 +1,5 @@
 // `crtr node message` — immediate inbox delivery and typed-output requests.
+import { envNodeId } from '../../shared/env.js';
 import { defineBranch, defineLeaf } from '../../core/command.js';
 import { InputError } from '../../core/io.js';
 import { OUTPUT_SCHEMA_CONSTRAINTS, OUTPUT_SCHEMA_TRANSPORT, parseOutputSchemaValue } from '../../core/runtime/structured-output.js';
@@ -22,7 +23,7 @@ async function resolveMsgTarget(input) {
         });
     }
     if (self) {
-        const id = process.env['CRTR_NODE_ID'];
+        const id = envNodeId();
         if (id === undefined || id === '') {
             throw new InputError({ error: 'no_node', message: 'no node to target with --self (CRTR_NODE_ID unset)', next: 'Run from inside a node, or pass --to <node-id>.' });
         }
@@ -55,7 +56,7 @@ function messageRequestParams() {
         { kind: 'stdin', name: 'body', required: false, constraint: 'Visible message body. The schema alone is a complete request.' },
         { kind: 'flag', name: 'to', type: 'string', required: false, constraint: 'Target an existing node by id. Exactly one of --to or --self is required.' },
         { kind: 'flag', name: 'self', type: 'bool', required: false, constraint: 'Target the calling node. Exactly one of --to or --self is required.' },
-        { kind: 'flag', name: 'tier', type: 'enum', choices: ['critical', 'urgent', 'normal'], required: false, default: 'normal', constraint: 'Delivery urgency. Deferred never wakes an idle node.' },
+        { kind: 'flag', name: 'tier', type: 'enum', choices: ['critical', 'urgent', 'normal'], required: false, default: 'normal', constraint: 'Delivery urgency. Every accepted tier may revive a dormant target, because the request must be answered; deferred is rejected for that reason.' },
         { kind: 'flag', name: 'output-schema', type: 'string', required: true, constraint: `JSON Schema the result must satisfy. ${OUTPUT_SCHEMA_TRANSPORT} The target answers through a constrained submit tool, then keeps working. ${OUTPUT_SCHEMA_CONSTRAINTS}` },
         { kind: 'flag', name: 'situational-context', type: 'string', required: false, constraint: 'Non-empty hidden ambient context delivered beside the message, or alone.' },
         { kind: 'flag', name: 'reopen', type: 'bool', required: false, hidden: true, constraint: 'Clear a finalized target latch before delivery or fresh revive.' },
@@ -80,7 +81,7 @@ async function runMessageEngine(input) {
     if (outputSchema !== null && tierRaw === 'deferred') {
         throw new InputError({ error: 'output_schema_deferred_tier', message: '--output-schema cannot combine with --tier deferred because the target must answer', field: 'tier', next: 'Use normal, urgent, or critical tier, or drop --output-schema.' });
     }
-    const senderFrom = process.env['CRTR_NODE_ID'];
+    const senderFrom = envNodeId();
     const client = cliClient();
     if (!hasBody && !hasSituational && outputSchema === null) {
         throw new InputError({ error: 'empty_body', message: 'a message body is required unless --output-schema or --situational-context is supplied', field: 'body', next: 'Pass the message on stdin, or supply one of the documented alternatives.' });
@@ -104,7 +105,7 @@ async function runMessageEngine(input) {
 const nodeMessageSend = defineLeaf({
     name: 'send',
     description: 'deliver an inbox message to an existing node immediately',
-    whenToUse: 'you need to steer or inform a node now without creating an ongoing subscription',
+    whenToUse: 'a node that already exists should have information or new direction now — steering a worker mid-task, handing over a finding it needs, correcting a wrong turn, or waking a dormant node with fresh work. The target reads it and decides what to do with it. Use `node message request` instead when you need an answer back in a shape you specify, and `node subscription add` when the target should keep receiving this node’s pushes rather than this one delivery',
     help: {
         name: 'node message send',
         summary: 'deliver an inbox message to an existing node immediately',
@@ -119,7 +120,7 @@ const nodeMessageSend = defineLeaf({
 const nodeMessageRequest = defineLeaf({
     name: 'request',
     description: 'deliver an immediate typed-output request to an existing node',
-    whenToUse: 'the target must answer once through a submit tool constrained by a JSON Schema',
+    whenToUse: 'a node that already exists must hand back one answer in a shape you fix — a choice among options, a structured extraction, a verdict your own logic will branch on — or must be held to answering at all before it goes quiet. Use `node message send` instead when prose in the target’s own judgment is enough, and `node new --output-schema` when no node holds the context yet and the work needs a fresh agent',
     help: {
         name: 'node message request',
         summary: 'deliver an immediate typed-output request to an existing node',
@@ -138,6 +139,10 @@ export const nodeMessage = defineBranch({
     name: 'message',
     description: 'deliver immediate inbox work to an existing node',
     whenToUse: 'you need one immediate delivery: send ordinary information, or request one schema-constrained result',
-    help: { name: 'node message', summary: 'deliver now; choose ordinary delivery or a typed-output obligation' },
+    help: {
+        name: 'node message',
+        summary: 'deliver one immediate inbox entry to an existing node',
+        model: 'Both children append one inbox entry to a node that already exists, targeted by id or --self, and may revive it if it is dormant. They differ in what the delivery obligates. An ordinary message obligates nothing: the target reads it and acts however it judges best. A request installs a one-off submit schema and holds the target awake and owing until it answers; the answer is validated against the schema, written to the target’s result file, and pushed as an update report to the TARGET’S subscribers, so subscribe to it first if the answer has to reach you. Neither child creates that standing relationship — a durable delivery edge is `node subscription`, and work that needs a fresh agent is `node new`.',
+    },
     children: [nodeMessageSend, nodeMessageRequest],
 });

package/dist/commands/node/subscription.js

@@ -1,9 +1,10 @@
 // `crtr node subscription` — push-delivery edge controls.
+import { envNodeId } from '../../shared/env.js';
 import { defineBranch, defineLeaf } from '../../core/command.js';
 import { InputError } from '../../core/io.js';
 import { cliClient, rethrowAsCliError } from '../api-client.js';
 function resolveSubscriber(input) {
-    const sub = input['subscriber'] ?? process.env['CRTR_NODE_ID'];
+    const sub = input['subscriber'] ?? envNodeId();
     if (sub === undefined || sub === '') {
         throw new InputError({ error: 'no_subscriber', message: 'no subscriber (set CRTR_NODE_ID or pass --subscriber)', field: 'subscriber', next: 'Run from inside a node, or pass --subscriber <id>.' });
     }
@@ -68,6 +69,10 @@ export const nodeSubscription = defineBranch({
     name: 'subscription',
     description: 'manage push-delivery edges between nodes',
     whenToUse: 'you need an ongoing active or passive subscriber-to-publisher delivery edge that spawn did not create, or need to remove one',
-    help: { name: 'node subscription', summary: 'add or remove subscriber-to-publisher push-delivery edges' },
+    help: {
+        name: 'node subscription',
+        summary: 'add or remove subscriber-to-publisher push-delivery edges',
+        model: 'Subscriptions point from a subscriber to a publisher and control future push delivery. Active edges wake on each push; passive edges accumulate pushes for the subscriber’s next turn. Removing either edge stops subsequent delivery without changing messages already received.',
+    },
     children: [nodeSubscribe, nodeUnsubscribe],
 });

package/dist/commands/node/wait.js

@@ -1,11 +1,12 @@
 // `crtr node wait` — durable controller and deadline waits.
+import { envNodeId, envProfileId } from '../../shared/env.js';
 import { defineBranch, defineLeaf } from '../../core/command.js';
 import { InputError } from '../../core/io.js';
 import { parseWhen } from '../../core/wake.js';
 import { cliClient, getNodeOrNull, rethrowAsCliError } from '../api-client.js';
 import { shellQuote } from '../surface/node/placement.js';
 function armerId() {
-    const id = process.env['CRTR_NODE_ID'];
+    const id = envNodeId();
     if (id === undefined || id === '') {
         throw new InputError({ error: 'no_node', message: 'no node to anchor a deadline cron (CRTR_NODE_ID unset)', next: 'Run from inside a node.' });
     }
@@ -84,7 +85,7 @@ const nodeWaitDeadline = defineLeaf({
         const parsed = parseWhen(until, parseOpts(now, tz));
         if ('error' in parsed)
             throwTimeError(parsed.error);
-        const profile = process.env['CRTR_PROFILE_ID'];
+        const profile = envProfileId();
         // One deadline per node: the arm seam REPLACES this node's pending
         // cancel-on-wake cron rather than stacking a second one (see armCron in
         // core/canvas/crons.ts, where the invariant is enforced for every caller).
@@ -129,7 +130,7 @@ const nodeWait = defineLeaf({
         effects: ['Durably records the controller on this node. The stop guard permits dormancy only while that controller remains active or idle; its next inbox delivery clears the record before the delivery wakes this node.'],
     },
     run: async (input) => {
-        const nodeId = process.env['CRTR_NODE_ID'];
+        const nodeId = envNodeId();
         if (nodeId === undefined || nodeId === '')
             throw new InputError({ error: 'no_node', message: 'no node to wait (CRTR_NODE_ID unset)', next: 'Run from inside the terminal node that is blocked.' });
         const node = await getNodeOrNull(nodeId);
@@ -153,6 +154,10 @@ export const nodeWaitBranch = defineBranch({
     name: 'wait',
     description: 'declare a durable controller or deadline wait',
     whenToUse: 'a terminal node must dorm for one named controller, or race its inbox against a self-scheduled deadline',
-    help: { name: 'node wait', summary: 'declare durable wait state; choose the event that settles it' },
+    help: {
+        name: 'node wait',
+        summary: 'declare durable wait state; choose the event that settles it',
+        model: 'Both waits belong to the calling terminal node and settle on one future event. A controller wait records an existing node as the wake source; a deadline wait arms an urgent one-shot cron that races any earlier inbox delivery and is canceled when that delivery wins.',
+    },
     children: [nodeWait, nodeWaitDeadline],
 });

package/dist/commands/node-context.js

@@ -17,6 +17,7 @@
 // and the on-disk existence filter is a local fs read (neither touches canvas
 // state). The /context popup (src/pi-extensions/canvas-context.ts) shells this
 // leaf inside a tmux display-popup. Piped / non-TTY it prints the roster.
+import { envNodeId } from '../shared/env.js';
 import { spawnSync } from 'node:child_process';
 import { existsSync, mkdirSync, mkdtempSync, rmSync, symlinkSync } from 'node:fs';
 import { tmpdir } from 'node:os';
@@ -106,7 +107,7 @@ export const nodeContextLeaf = defineLeaf({
         ],
     },
     run: async (input) => {
-        const selfId = input['node']?.trim() || process.env['CRTR_NODE_ID'];
+        const selfId = input['node']?.trim() || envNodeId();
         if (selfId === undefined || selfId === '') {
             throw new InputError({
                 error: 'no_node',

package/dist/commands/node-lifecycle-revive.js

@@ -52,9 +52,7 @@ export function isNowEligibleFault(fault) {
         return true;
     return fault.retry.by === 'daemon';
 }
-// ---------------------------------------------------------------------------
 // Local, db-free helpers (inlined so the leaf never imports the canvas barrel)
-// ---------------------------------------------------------------------------
 /** Inlined from `runtime/busy.ts` (which reaches the canvas barrel via `jobDir`):
  * is the node mid-turn right now? `<jobDir>/busy` exists for the span pi is
  * inside a run. `jobDir` here is the pure path helper from paths.js. */

package/dist/commands/node-worktree.js

@@ -2,12 +2,13 @@
 // `node new --worktree <base>`; this branch holds the single close
 // verb, symmetric with birth, so a git worktree's whole lifecycle sits under
 // `node`.
+import { envNodeId } from '../shared/env.js';
 import { defineBranch, defineLeaf } from '../core/command.js';
 import { InputError } from '../core/io.js';
 import { ApiError } from '../api/index.js';
 import { cliClient } from './api-client.js';
 function requireCallerNode() {
-    const id = process.env['CRTR_NODE_ID'];
+    const id = envNodeId();
     if (id === undefined || id.trim() === '') {
         throw new InputError({
             error: 'no_node_context',

package/dist/commands/pkg/browse/actions.d.ts

@@ -1,4 +1,4 @@
-import type { ActionPresentation, ActionRequest, ActionOutcome } from "./model.js";
+import type { ActionPresentation, ActionRequest, ActionOutcome } from './model.js';
 /** How an action reads before it runs — and whether it needs confirming. */
 export declare function presentAction(request: ActionRequest): ActionPresentation;
 /** Actions available for a request's subject right now, in offer order. */

package/dist/commands/pkg/browse/actions.js

@@ -1,9 +1,9 @@
 // Mutations for `crtr pkg browse`. Each action delegates to the same leaf the
 // CLI runs, so the browser and `crtr pkg …` can never drift.
-import { marketAdd, marketRemove, marketUpdate } from "../market-manage.js";
-import { pluginDisable, pluginEnable, pluginInstall, pluginRemove, pluginUpdate, } from "../plugin-manage.js";
-import { listAllMarketplaces } from "../../../core/resolver.js";
-import { projectScopeRoot } from "../../../core/scope.js";
+import { marketAdd, marketRemove, marketUpdate } from '../market-manage.js';
+import { pluginDisable, pluginEnable, pluginInstall, pluginRemove, pluginUpdate, } from '../plugin-manage.js';
+import { listAllMarketplaces } from '../../../core/resolver.js';
+import { projectScopeRoot } from '../../../core/scope.js';
 function pluginName(request) {
     return request.entry?.name ?? "plugin";
 }

package/dist/commands/pkg/browse/catalog.d.ts

@@ -1,4 +1,4 @@
-import { type Catalog, type PluginCapability, type PluginEntry } from "./model.js";
+import { type Catalog, type PluginCapability, type PluginEntry } from './model.js';
 /** Every rail source with its rows: the installed library first, then each
  *  registered marketplace. Called on open and after any action that could
  *  change install state. Must never throw for a broken marketplace — record it

package/dist/commands/pkg/browse/catalog.js

@@ -1,20 +1,20 @@
 // Catalog reads for `crtr pkg browse`. Everything here is read-only; mutations
 // live in actions.ts.
-import { statSync } from "node:fs";
-import { isAbsolute, join } from "node:path";
-import { SUBTREE_NAMES, coreCommandPaths } from "../../../build-root.js";
-import { discoverPluginCommandCandidates, validateEffectiveCommandPlugins, validatePluginCommands } from "../../../core/command-plugins/discovery.js";
-import { qualifiedTopLevelCommandName } from "../../../core/command-manifests/registry.js";
-import { listDirs, pathExists, walkFiles } from "../../../core/fs-utils.js";
-import { currentSha, gitSync } from "../../../core/git.js";
-import { listPluginMemoryDocs } from "../../../core/memory-resolver.js";
-import { memoryExtensionEffectiveCatalog, projectEffectiveMemoryExtensions } from "../../../core/memory/extensions.js";
-import { readMarketplaceManifest, readPluginManifest } from "../../../core/manifest.js";
-import { readConfig } from "../../../core/config.js";
-import { parseSubstrateDoc } from "../../../core/substrate/schema.js";
-import { projectScopeRoot, userScopeRoot } from "../../../core/scope.js";
-import { isGitUrl } from "../shared.js";
-import { INSTALLED_SOURCE_ID, marketplaceSourceId, } from "./model.js";
+import { statSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { SUBTREE_NAMES, coreCommandPaths } from '../../../build-root.js';
+import { discoverPluginCommandCandidates, validateEffectiveCommandPlugins, validatePluginCommands } from '../../../core/command-plugins/discovery.js';
+import { qualifiedTopLevelCommandName } from '../../../core/command-manifests/registry.js';
+import { listDirs, pathExists, walkFiles } from '../../../core/fs-utils.js';
+import { currentSha, gitSync } from '../../../core/git.js';
+import { listPluginMemoryDocs } from '../../../core/memory-resolver.js';
+import { memoryExtensionEffectiveCatalog, projectEffectiveMemoryExtensions } from '../../../core/memory/extensions.js';
+import { readMarketplaceManifest, readPluginManifest } from '../../../core/manifest.js';
+import { readConfig } from '../../../core/config.js';
+import { parseSubstrateDoc } from '../../../core/substrate/schema.js';
+import { projectScopeRoot, userScopeRoot } from '../../../core/scope.js';
+import { isGitUrl } from '../shared.js';
+import { INSTALLED_SOURCE_ID, marketplaceSourceId, } from './model.js';
 function parseSemver(version) {
     const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z.-]+)?$/.exec(version);
     return match === null

package/dist/commands/pkg/browse/command-view.d.ts

@@ -1,3 +1,3 @@
-import type { CommandNode, PluginCapability } from "./model.js";
+import type { CommandNode, PluginCapability } from './model.js';
 /** Every line of one command's contract view, wrapped to `width`. */
 export declare function renderCommandView(node: CommandNode, capability: PluginCapability, width: number): string[];

package/dist/commands/pkg/browse/command-view.js

@@ -3,9 +3,9 @@
 //
 // Pure rendering. It returns styled lines already wrapped to `width`; the
 // dossier owns scrolling and never truncates what comes back.
-import { visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
-import { theme, wrapText } from "../../../core/tui/panel.js";
-import { commandLabel } from "./model.js";
+import { visibleWidth, wrapTextWithAnsi } from '@earendil-works/pi-tui';
+import { theme, wrapText } from '../../../core/tui/panel.js';
+import { commandLabel } from './model.js';
 /** Every line of one command's contract view, wrapped to `width`. */
 export function renderCommandView(node, capability, width) {
     const out = [];

package/dist/commands/pkg/browse/detail-panel.d.ts

@@ -1,4 +1,4 @@
-import type { ActionOutcome, CatalogSource, PluginCapability, PluginEntry } from "./model.js";
+import type { ActionOutcome, CatalogSource, PluginCapability, PluginEntry } from './model.js';
 export declare class PkgDetailPanel {
     private entry;
     private source;

package/dist/commands/pkg/browse/detail-panel.js

@@ -4,11 +4,11 @@
 // `enter` deeper — a whole memory doc or a whole command contract. The overview
 // is not a teaser: every command node and every memory doc it lists is a real
 // row a cursor can land on and open, and nothing is elided with `+N more`.
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import { padAnsi, theme, wrapText } from "../../../core/tui/panel.js";
-import { renderCommandView } from "./command-view.js";
-import { renderDocView } from "./doc-view.js";
-import { commandLabel, displayVersion, plural } from "./model.js";
+import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
+import { padAnsi, theme, wrapText } from '../../../core/tui/panel.js';
+import { renderCommandView } from './command-view.js';
+import { renderDocView } from './doc-view.js';
+import { commandLabel, displayVersion, plural } from './model.js';
 /** One labelled row and its explanation. Inline while both fit; otherwise the
  *  explanation wraps underneath, hanging under the label rather than resetting
  *  to the left margin. Nothing is ever truncated to make it fit. */
@@ -90,7 +90,7 @@ export class PkgDetailPanel {
     get viewing() {
         return this.view.kind !== "overview";
     }
-    // --- navigation ----------------------------------------------------------
+    // navigation
     /** `j`/`k`: move the cursor between selectable rows on the overview, scroll a
      *  line inside an opened view — and scroll the overview too when the plugin
      *  has nothing selectable to move between. */
@@ -170,7 +170,7 @@ export class PkgDetailPanel {
         this.collapsed.add(key);
         return true;
     }
-    // --- the selectable model ------------------------------------------------
+    // the selectable model
     /** Command rows in display order, skipping the children of folded branches. */
     commandRows() {
         const rows = [];
@@ -195,7 +195,7 @@ export class PkgDetailPanel {
             ...capability.docs.map((doc) => ({ kind: "doc", doc })),
         ];
     }
-    // --- rendering -----------------------------------------------------------
+    // rendering
     render(width, height, focused) {
         const lines = this.lines(width, focused);
         this.lastLines = lines.length;

package/dist/commands/pkg/browse/doc-view.d.ts

@@ -1,3 +1,3 @@
-import type { DocDetail } from "./model.js";
+import type { DocDetail } from './model.js';
 /** Every line of one memory doc's reader view, wrapped to `width`. */
 export declare function renderDocView(doc: DocDetail, width: number): string[];

package/dist/commands/pkg/browse/doc-view.js

@@ -4,9 +4,9 @@
 // Pure rendering. It receives a doc already read from disk and returns styled
 // lines already wrapped to `width`; the dossier owns scrolling and never
 // truncates what comes back.
-import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
-import { Markdown, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
-import { theme, wrapText } from "../../../core/tui/panel.js";
+import { getMarkdownTheme } from '@earendil-works/pi-coding-agent';
+import { Markdown, visibleWidth, wrapTextWithAnsi } from '@earendil-works/pi-tui';
+import { theme, wrapText } from '../../../core/tui/panel.js';
 /** Every line of one memory doc's reader view, wrapped to `width`. */
 export function renderDocView(doc, width) {
     const out = [];

package/dist/commands/pkg/browse/list-panel.d.ts

@@ -1,4 +1,4 @@
-import type { CatalogSource, PluginEntry } from "./model.js";
+import type { CatalogSource, PluginEntry } from './model.js';
 /** The middle column of the plugin browser. It owns filtering and row position;
  * the shell owns horizontal navigation and actions. */
 export declare class PkgListPanel {

package/dist/commands/pkg/browse/list-panel.js

@@ -1,6 +1,6 @@
-import { matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import { padAnsi, theme, visibleRange } from "../../../core/tui/panel.js";
-import { displayVersion, plural } from "./model.js";
+import { matchesKey, truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
+import { padAnsi, theme, visibleRange } from '../../../core/tui/panel.js';
+import { displayVersion, plural } from './model.js';
 /** The middle column of the plugin browser. It owns filtering and row position;
  * the shell owns horizontal navigation and actions. */
 export class PkgListPanel {

package/dist/commands/pkg/browse/model.d.ts

@@ -1,6 +1,6 @@
-import type { Field, InputParam } from "../../../core/help.js";
-import type { SurfaceEntry } from "../../../core/substrate/schema.js";
-import type { MemoryExtensionScalar, OwnerRef, Scope } from "../../../types.js";
+import type { Field, InputParam } from '../../../core/help.js';
+import type { SurfaceEntry } from '../../../core/substrate/schema.js';
+import type { MemoryExtensionScalar, OwnerRef, Scope } from '../../../types.js';
 /** The scopes that can hold a marketplace, and that a plugin can be installed
  *  into. Narrower than `Scope`: `builtin` names plugins that ship with crtr, and
  *  `listAllMarketplaces()` never yields it, so a builtin marketplace or a

package/dist/commands/pkg/browse/shell.d.ts

@@ -1,5 +1,5 @@
-import { type Component, type Focusable, type TUI } from "@earendil-works/pi-tui";
-import { type BindingId, type BindingResolution } from "../../../core/keybindings/index.js";
+import { type Component, type Focusable, type TUI } from '@earendil-works/pi-tui';
+import { type BindingId, type BindingResolution } from '../../../core/keybindings/index.js';
 /** Full-screen plugin browser. The data and mutation boundaries stay in the
  * catalog/actions collaborators, leaving this class responsible for movement,
  * disclosure, and the rendered page grammar. */

package/dist/commands/pkg/browse/shell.js

@@ -1,13 +1,13 @@
 // The `crtr pkg browse` page: a grouped source rail, plugin list, and dossier.
-import { Input, matchesKey, truncateToWidth, visibleWidth, } from "@earendil-works/pi-tui";
-import { formatGesture, matchesPiTuiInput, } from "../../../core/keybindings/index.js";
-import { runTuiPage } from "../../../core/tui/page-host.js";
-import { PAGE_CHROME_ROWS, columns, framed, padAnsi, pageFrame, theme, visibleRange, } from "../../../core/tui/panel.js";
-import { availableActions, presentAction, runAction } from "./actions.js";
-import { loadCapability, loadCatalog } from "./catalog.js";
-import { PkgDetailPanel } from "./detail-panel.js";
-import { PkgListPanel } from "./list-panel.js";
-import { INSTALLED_SOURCE_ID, marketplaceSourceId, plural, } from "./model.js";
+import { Input, matchesKey, truncateToWidth, visibleWidth, } from '@earendil-works/pi-tui';
+import { formatGesture, matchesPiTuiInput, } from '../../../core/keybindings/index.js';
+import { runTuiPage } from '../../../core/tui/page-host.js';
+import { PAGE_CHROME_ROWS, columns, framed, padAnsi, pageFrame, theme, visibleRange, } from '../../../core/tui/panel.js';
+import { availableActions, presentAction, runAction } from './actions.js';
+import { loadCapability, loadCatalog } from './catalog.js';
+import { PkgDetailPanel } from './detail-panel.js';
+import { PkgListPanel } from './list-panel.js';
+import { INSTALLED_SOURCE_ID, marketplaceSourceId, plural, } from './model.js';
 const RAIL_WIDTH = 22;
 const LIST_WIDTH = 34;
 const RAIL_MIN_TOTAL_WIDTH = 84;
@@ -96,7 +96,7 @@ export class PkgBrowseShell {
         if (this.busy !== undefined)
             clearInterval(this.busy.timer);
     }
-    // --- model selection -----------------------------------------------------
+    // model selection
     sources() {
         if (this.catalog.sources.length > 0)
             return this.catalog.sources;
@@ -171,7 +171,7 @@ export class PkgBrowseShell {
     clearActionNotice() {
         this.notice = undefined;
     }
-    // --- input ---------------------------------------------------------------
+    // input
     /** A live filter, an open modal, or a running action holds every key — the
      *  one predicate both `handleInput` and the footer consult, so the footer can
      *  never advertise a key the filter is swallowing. */
@@ -279,7 +279,7 @@ export class PkgBrowseShell {
             this.syncSource();
         }
     }
-    // --- actions and modals --------------------------------------------------
+    // actions and modals
     /** The focused rail row as an action subject. Carries the marketplace's scope
      *  as well as its name: two marketplaces can share a name across the user and
      *  project scopes, and without the scope `availableActions` cannot tell which
@@ -424,7 +424,7 @@ export class PkgBrowseShell {
         }
         this.tui.requestRender();
     }
-    // --- rendering -----------------------------------------------------------
+    // rendering
     /** The source rail. It scrolls like the list does: marketplace count is user
      *  controlled, so a fixed slice would let the selection sit below the last
      *  drawn row, moving invisibly while the badge the user is aiming for never