@north-light/crouter 0.3.233 → 0.3.234

package/dist/commands/memory/find.js

@@ -126,7 +126,7 @@ export const findLeaf = defineLeaf({
         const units = selector.store !== null
             ? searchUnits(kindFilter, loadMemoryStoreView(requireMountedStore(selector.store), false).docs, false)
             : searchUnits(kindFilter, listAllMemoryDocs(selector.scope, false, true), true);
-        // --- grep mode: regex over every unit's body, one row per matching line ---
+        // grep mode: regex over every unit's body, one row per matching line
         if (grep) {
             let regex;
             try {
@@ -167,7 +167,7 @@ export const findLeaf = defineLeaf({
             registerMemoryListingExposure(listingIdentity);
             return output;
         }
-        // --- ranked mode: weighted relevance over name/routing-line/short-form(+body) ---
+        // ranked mode: weighted relevance over name/routing-line/short-form(+body)
         const terms = query
             .toLowerCase()
             .split(/\s+/)

package/dist/commands/memory/lint.js

@@ -3,6 +3,7 @@
 // verification, the plugin candidate gate, and the build's builtin gate consume
 // too; this leaf only picks WHAT to lint (a target view, or one exact store
 // with --dir) and shapes the findings for the CLI.
+import { envProfileId } from '../../shared/env.js';
 import { defineLeaf } from '../../core/command.js';
 import { warn } from '../../core/output.js';
 import { ExitCode } from '../../types.js';
@@ -26,7 +27,7 @@ function findingRow(finding) {
 function resolvableNamesForStore(store) {
     const view = loadMemoryTargetView({
         cwd: store.ownerDir ?? store.storeRoot,
-        profileId: process.env['CRTR_PROFILE_ID'] || null,
+        profileId: envProfileId() || null,
         nodeId: null,
     }, { quiet: true, includeDescendants: true });
     return resolvableCanonicalNames(view.docs);

package/dist/commands/memory/read.d.ts

@@ -1,11 +1,6 @@
-import { createMemoryDocSnapshot, resolveMemoryDocs } from '../../core/memory-resolver.js';
+import { createMemoryDocSnapshot, readMemoryDocContent, resolveMemoryDocs } from '../../core/memory-resolver.js';
 import type { MemoryDoc } from '../../core/memory-resolver.js';
-export { createMemoryDocSnapshot, resolveMemoryDocs };
-/** Load the body at an already-resolved memory path with the same frontmatter
- * stripping and in-node path interpolation as `memory read`. Callers that
- * already have the resolved path (such as slash-command discovery) avoid
- * re-walking every memory store for each document. */
-export declare function readMemoryDocContent(path: string, includeFrontmatter?: boolean): string;
+export { createMemoryDocSnapshot, readMemoryDocContent, resolveMemoryDocs };
 /** One physical document sharing a canonical identity, as the path-aware
  *  surfaces report it. `--dir <its project>` is how a non-winner is reached. */
 export declare function candidateRow(doc: MemoryDoc, winner: MemoryDoc): Record<string, unknown>;

package/dist/commands/memory/read.js

@@ -1,12 +1,11 @@
+import { envNodeId } from '../../shared/env.js';
 import { CrtrClient } from '../../api/index.js';
-import { interpolateNodePaths } from '../../core/canvas/paths.js';
 import { defineLeaf } from '../../core/command.js';
 import { CrtrError } from '../../core/errors.js';
 import { memoryExtensionEffectiveCatalog, projectEffectiveMemoryExtensions } from '../../core/memory/extensions.js';
-import { readText, realpathOrSelf } from '../../core/fs-utils.js';
-import { parseFrontmatterGeneric } from '../../core/frontmatter.js';
+import { realpathOrSelf } from '../../core/fs-utils.js';
 import { docLinkNames } from '../../core/memory/doc-link-grammar.js';
-import { createMemoryDocSnapshot, listAllMemoryDocs, loadMemoryStoreView, resolveMemoryCandidates, resolveMemoryDocs, } from '../../core/memory-resolver.js';
+import { createMemoryDocSnapshot, listAllMemoryDocs, loadMemoryStoreView, readMemoryDocContent, resolveMemoryCandidates, resolveMemoryDocs, } from '../../core/memory-resolver.js';
 import { expandShellBlocks, hasShellBlocks, makeNodeShellRunner } from '../../core/runtime/shell-expansion.js';
 import { emptyContextExposureState, exposedAtOrAbove, exposureTarget, loadContextExposureState, registerDocumentExposure, registerExposure, saveContextExposureState, } from '../../core/substrate/injected-store.js';
 import { dirDedupKey, docListingDirs, docsByName, isDirName, renderDirListing } from '../../core/substrate/listings.js';
@@ -15,17 +14,7 @@ import { renderResult } from '../../core/render.js';
 import { effectiveDocKind } from '../../core/substrate/schema.js';
 import { canonicalSegments } from '../../core/memory/identity.js';
 import { MEMORY_KINDS, requireMountedStore, resolveReadSelector, selectorParam } from './shared.js';
-export { createMemoryDocSnapshot, resolveMemoryDocs };
-/** Load the body at an already-resolved memory path with the same frontmatter
- * stripping and in-node path interpolation as `memory read`. Callers that
- * already have the resolved path (such as slash-command discovery) avoid
- * re-walking every memory store for each document. */
-export function readMemoryDocContent(path, includeFrontmatter = false) {
-    const raw = readText(path);
-    const content = includeFrontmatter ? raw : parseFrontmatterGeneric(raw).body;
-    const nodeId = process.env['CRTR_NODE_ID'];
-    return nodeId ? interpolateNodePaths(content, nodeId) : content;
-}
+export { createMemoryDocSnapshot, readMemoryDocContent, resolveMemoryDocs };
 /** The node-config subject for memory-read-event gate evaluation. A CLI
  * process cannot take it from canvas-db (V-1); one `/v1` request supplies it.
  * With no node identity or no reachable daemon the answer is null — gated
@@ -150,7 +139,7 @@ export const readLeaf = defineLeaf({
             }
             fail = () => resolveMemoryCandidates(nameRaw, resolveOpts);
         }
-        const nodeId = process.env['CRTR_NODE_ID'] || undefined;
+        const nodeId = envNodeId() || undefined;
         if (set === null) {
             // No document answers this name — a directory with no document of its own
             // still does, through its listing. An explicit dir read is a deliberate

package/dist/commands/memory/shared.js

@@ -3,6 +3,7 @@
 // scope modules and build their documented output objects on top of the small
 // helpers here. Nothing in this file forks on kind or re-implements the
 // schema/gate/resolver — it only composes them.
+import { envNodeId, envProfileId } from '../../shared/env.js';
 import { existsSync, readdirSync, realpathSync, rmdirSync, statSync } from 'node:fs';
 import { dirname, join, resolve as resolvePath } from 'node:path';
 import { stringify as yamlStringify, parse as yamlParse } from 'yaml';
@@ -40,7 +41,7 @@ export function scopeRank(scope) {
     return scope === 'node' ? -1 : scope === 'project' ? 0 : scope === 'profile' ? 1 : scope === 'user' ? 2 : 3;
 }
 export function registerMemoryListingExposure(identity) {
-    const nodeId = process.env['CRTR_NODE_ID'];
+    const nodeId = envNodeId();
     if (nodeId === undefined || nodeId === '')
         return;
     const state = loadContextExposureState(nodeId);
@@ -151,7 +152,7 @@ export function resolveWriteSelector(input) {
     if (scope === 'node') {
         // The this-node store: the same dir render.ts's nodeLocalDocs loads at
         // boot, so a doc written here rides into this node's knowledge block.
-        const nodeId = process.env['CRTR_NODE_ID'] || '';
+        const nodeId = envNodeId() || '';
         if (nodeId === '') {
             throw usage('node scope requires a running node (CRTR_NODE_ID unset); rerun inside a node');
         }
@@ -163,7 +164,7 @@ export function resolveWriteSelector(input) {
         // is a durable id this process was launched under, so it resolves strictly
         // — a stale one must fail rather than write into a neighbouring store.
         const typed = input.profile !== undefined && input.profile !== '';
-        const profileIdOrName = typed ? input.profile : process.env['CRTR_PROFILE_ID'] || '';
+        const profileIdOrName = typed ? input.profile : envProfileId() || '';
         if (profileIdOrName === '') {
             throw usage('profile scope requires a selected profile; rerun inside a profiled node or pass --profile');
         }
@@ -209,14 +210,12 @@ export function requireMountedStore(store) {
         next: `Run \`crtr sys migrate --dir ${repositoryRoot}\`.`,
     });
 }
-// ---------------------------------------------------------------------------
 // Canonical name → physical placement
 //
 // Every surface takes the FULL canonical name. Placement strips the selected
 // store's namespace off it, checks that neither the identity nor either
 // physical representation of the local name is already taken, and picks the
 // form the new file takes.
-// ---------------------------------------------------------------------------
 /** Normalize and validate a full canonical name: ordering prefixes are
  *  physical-path-only, a trailing `INDEX` is never an address, and the segment
  *  charset is fixed. */
@@ -709,13 +708,11 @@ export function applyExtensionChanges(frontmatter, sets, unsets) {
     else
         frontmatter['extensions'] = extensions;
 }
-// ---------------------------------------------------------------------------
 // Help material shared by `write` and `edit`
 //
 // Single-sourced: both leaves compose these, so a wording fix lands on both.
 // Anything exclusive to one leaf (creation rules on `write`, the rationale
 // contract on `edit`) stays owned by that leaf.
-// ---------------------------------------------------------------------------
 /** The frontmatter-overlay flags, keyed by flag name, carrying the prose true
  *  on BOTH leaves. `write` appends its creation clauses with `withConstraint`;
  *  neither leaf restates the other's rules. */

package/dist/commands/memory/write.js

@@ -1,3 +1,4 @@
+import { envNodeId, envProfileId } from '../../shared/env.js';
 import { join } from 'node:path';
 import { defineLeaf } from '../../core/command.js';
 import { usage } from '../../core/errors.js';
@@ -188,14 +189,14 @@ export const writeLeaf = defineLeaf({
                 ? {
                     resolvable: resolvableCanonicalNames(loadMemoryTargetView({
                         cwd: store.ownerDir ?? process.cwd(),
-                        profileId: process.env['CRTR_PROFILE_ID'] || null,
-                        nodeId: process.env['CRTR_NODE_ID'] || null,
+                        profileId: envProfileId() || null,
+                        nodeId: envNodeId() || null,
                     }, { quiet: true, includeDescendants: true }).docs),
                 }
                 : {}),
             ...(carriesBootEntry
                 ? {
-                    nestedStore: descendantStoreRoots(projectScopeRoots(process.cwd(), process.env['CRTR_PROFILE_ID'] || null))
+                    nestedStore: descendantStoreRoots(projectScopeRoots(process.cwd(), envProfileId() || null))
                         .map((root) => realpathOrSelf(join(root, 'memory')))
                         .includes(realpathOrSelf(memoryDir)),
                 }

package/dist/commands/node/bash.js

@@ -1,4 +1,5 @@
 // `crtr node bash` — file-backed background job controls.
+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';
@@ -12,7 +13,7 @@ function resolveBashTarget(input, missingMessage) {
     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: missingMessage, next: 'Run from inside a node, pass --node <id>, or --pane <pane>.' });
     }

package/dist/commands/node/create.js

@@ -1,4 +1,5 @@
 // `crtr node new` — creation commands and persona-kind helpers.
+import { envNodeId } from '../../shared/env.js';
 import { defineLeaf } from '../../core/command.js';
 import { InputError } from '../../core/io.js';
 import { mark } from '../../core/timing.js';
@@ -207,7 +208,7 @@ async function runNodeCreation(input) {
     if (noKickoff && mode === 'orchestrator') {
         throw new InputError({ error: 'no_kickoff_orchestrator_unsupported', message: '--no-kickoff cannot be combined with --mode orchestrator', field: 'no-kickoff', next: 'Drop --no-kickoff and provide a prompt, or spawn in base mode.' });
     }
-    const parentId = parent ?? process.env['CRTR_NODE_ID'];
+    const parentId = parent ?? envNodeId();
     mark('node_new.create_start', { root });
     const detail = await cliClient().createNode({
         ...(kind !== undefined ? { kind } : {}),

package/dist/commands/node/inspect.js

@@ -89,9 +89,7 @@ const nodeList = defineLeaf({
         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.
@@ -233,9 +231,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 +283,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',

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',
@@ -365,9 +358,7 @@ export const nodeLifecycle = defineBranch({
     },
     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 +386,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>.' });
         }
@@ -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.' });

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>.' });
     }

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);

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 {