@north-light/crouter 0.3.162 → 0.3.163

package/dist/core/keybindings/catalog.js

@@ -1,4 +1,4 @@
-function binding(id, group, name, description, defaults, inputKind, contexts, safety) {
+function binding(id, group, name, description, defaults, inputKind, contexts, safety, pair) {
     return Object.freeze({
         id,
         group,
@@ -8,9 +8,18 @@ function binding(id, group, name, description, defaults, inputKind, contexts, sa
         inputKind,
         contexts: Object.freeze([...contexts]),
         ...(safety === undefined ? {} : { safety }),
+        ...(pair === undefined ? {} : { pair: Object.freeze({ ...pair }) }),
     });
 }
 const b = binding;
+function menuEntry(action, name, description, defaults, contexts) {
+    const menuId = `crtr.tmux.menu.${action}`;
+    const globalId = `crtr.tmux.menu-global.${action}`;
+    return [
+        b(menuId, 'Global tmux', name, description, defaults, 'tmux-menu-selector', contexts, undefined, { field: 'menu', pairedId: globalId }),
+        b(globalId, 'Global tmux', name, description, [], 'tmux-global-action', ['tmux.root'], undefined, { field: 'global', pairedId: menuId }),
+    ];
+}
 const ATTACH_CONTEXTS = ['attach', 'graph', 'graph.confirm'];
 const VIEW_CONTEXTS = [
     'view.canvas', 'view.chat', 'view.git-pr',
@@ -27,28 +36,28 @@ const SETUP_CANCEL_CONTEXTS = [
 const SETUP_TAB_CONTEXTS = ['setup.login', 'setup.list', 'setup.keybindings', 'setup.models'];
 export const BINDING_CATALOG = Object.freeze([
     b('crtr.tmux.menu.open', 'Global tmux', 'Open crouter menu', 'Open the crouter action menu.', ['alt+c'], 'host-global', ['tmux.root']),
-    b('crtr.tmux.menu.promote', 'Global tmux', 'Promote node', 'Promote the focused node to orchestrator.', ['o'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.resume', 'Global tmux', 'Resume node', 'Open the node resume picker.', ['r'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.fork', 'Global tmux', 'Fork node', 'Fork the focused node into an independent idle root.', ['f'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.demote', 'Global tmux', 'Demote node', 'Demote the focused node to terminal.', ['d'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.detach', 'Global tmux', 'Detach node', 'Detach the focused node to the background.', ['shift+d'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.close-subtree', 'Global tmux', 'Close subtree', 'Close the focused node and its subtree.', ['x'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.background-bash', 'Global tmux', 'Background bash', 'Hand the focused node’s running bash command to its background job system.', ['b'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.file-review', 'Global tmux', 'Review a file', 'Open a line-anchored review of a file named in the transcript.', ['v'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.pin', 'Global tmux', 'Pin conversation', 'Pin or unpin this conversation in the canvas navigator.', ['shift+f'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.show', 'Global tmux', 'Show node', 'Open the focused node’s inspection menu.', ['s'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.view-settings', 'Global tmux', 'View settings', 'Open the viewer display-settings menu.', ['w'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.fold-tools', 'Global tmux', 'Fold finished tool calls', 'Fold every finished tool call in the transcript to its single call line.', ['f'], 'tmux-menu-selector', ['tmux.menu.view-settings']),
-    b('crtr.tmux.menu.metadata', 'Global tmux', 'Show metadata', 'Show the focused node’s metadata dossier.', ['m'], 'tmux-menu-selector', ['tmux.menu.show']),
-    b('crtr.tmux.menu.context', 'Global tmux', 'Browse context', 'Browse the focused node context.', ['c'], 'tmux-menu-selector', ['tmux.menu.show']),
-    b('crtr.tmux.menu.providers', 'Global tmux', 'Open settings', 'Open the crouter settings panel.', ['p'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.graph', 'Global tmux', 'Open graph', 'Open the canvas graph.', ['g'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.focus-manager', 'Global tmux', 'Focus manager', 'Focus the node manager.', ['m'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.copy-id', 'Global tmux', 'Copy node id', 'Copy the focused node id to the system clipboard.', ['y'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.reload-viewer', 'Global tmux', 'Reload viewer', 'Respawn this pane’s viewer onto the current runtime generation.', ['l'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.issues', 'Global tmux', 'Open issue menu', 'Open the issue type submenu.', ['i'], 'tmux-menu-selector', ['tmux.menu']),
-    b('crtr.tmux.menu.issue.idea', 'Global tmux', 'Create idea', 'Create an idea issue.', ['i'], 'tmux-menu-selector', ['tmux.menu.issue']),
-    b('crtr.tmux.menu.issue.bug', 'Global tmux', 'Create bug', 'Create a bug issue.', ['b'], 'tmux-menu-selector', ['tmux.menu.issue']),
+    ...menuEntry('promote', 'Promote node', 'Promote the focused node to orchestrator.', ['o'], ['tmux.menu']),
+    ...menuEntry('resume', 'Resume node', 'Open the node resume picker.', ['r'], ['tmux.menu']),
+    ...menuEntry('fork', 'Fork node', 'Fork the focused node into an independent idle root.', ['f'], ['tmux.menu']),
+    ...menuEntry('demote', 'Demote node', 'Demote the focused node to terminal.', ['d'], ['tmux.menu']),
+    ...menuEntry('detach', 'Detach node', 'Detach the focused node to the background.', ['shift+d'], ['tmux.menu']),
+    ...menuEntry('close-subtree', 'Close subtree', 'Close the focused node and its subtree.', ['x'], ['tmux.menu']),
+    ...menuEntry('background-bash', 'Background bash', 'Hand the focused node’s running bash command to its background job system.', ['b'], ['tmux.menu']),
+    ...menuEntry('file-review', 'Review a file', 'Open a line-anchored review of a file named in the transcript.', ['v'], ['tmux.menu']),
+    ...menuEntry('pin', 'Pin conversation', 'Pin or unpin this conversation in the canvas navigator.', ['shift+f'], ['tmux.menu']),
+    ...menuEntry('show', 'Show node', 'Open the focused node’s inspection menu.', ['s'], ['tmux.menu']),
+    ...menuEntry('view-settings', 'View settings', 'Open the viewer display-settings menu.', ['w'], ['tmux.menu']),
+    ...menuEntry('fold-tools', 'Fold finished tool calls', 'Fold every finished tool call in the transcript to its single call line.', ['f'], ['tmux.menu.view-settings']),
+    ...menuEntry('metadata', 'Show metadata', 'Show the focused node’s metadata dossier.', ['m'], ['tmux.menu.show']),
+    ...menuEntry('context', 'Browse context', 'Browse the focused node context.', ['c'], ['tmux.menu.show']),
+    ...menuEntry('providers', 'Open settings', 'Open the crouter settings panel.', ['p'], ['tmux.menu']),
+    ...menuEntry('graph', 'Open graph', 'Open the canvas graph.', ['g'], ['tmux.menu']),
+    ...menuEntry('focus-manager', 'Focus manager', 'Focus the node manager.', ['m'], ['tmux.menu']),
+    ...menuEntry('copy-id', 'Copy node id', 'Copy the focused node id to the system clipboard.', ['y'], ['tmux.menu']),
+    ...menuEntry('reload-viewer', 'Reload viewer', 'Respawn this pane’s viewer onto the current runtime generation.', ['l'], ['tmux.menu']),
+    ...menuEntry('issues', 'Open issue menu', 'Open the issue type submenu.', ['i'], ['tmux.menu']),
+    ...menuEntry('issue.idea', 'Create idea', 'Create an idea issue.', ['i'], ['tmux.menu.issue']),
+    ...menuEntry('issue.bug', 'Create bug', 'Create a bug issue.', ['b'], ['tmux.menu.issue']),
     b('crtr.tmux.node.next', 'Global tmux', 'Next node', 'Focus the next canvas node.', ['alt+]'], 'host-global', ['tmux.root']),
     b('crtr.tmux.node.previous', 'Global tmux', 'Previous node', 'Focus the previous canvas node.', ['alt+['], 'host-global', ['tmux.root']),
     b('crtr.tmux.inbox.toggle', 'Global tmux', 'Toggle inbox', 'Open or close the human inbox popup.', ['alt+i'], 'host-global', ['tmux.root']),
@@ -244,8 +253,8 @@ function setupBindings() {
         b('crtr.setup.keybindings.filter', 'Setup', 'Filter bindings', 'Open the keybinding filter.', ['/'], 'terminal', ['setup.keybindings']),
         b('crtr.setup.keybindings.filter-delete', 'Setup', 'Delete filter text', 'Delete the previous filter character.', ['backspace'], 'terminal', ['setup.keybindings.filter']),
         b('crtr.setup.keybindings.filter-clear', 'Setup', 'Clear filter', 'Clear the keybinding filter.', ['escape'], 'terminal', ['setup.keybindings.filter'], 'dismiss-modal'),
-        b('crtr.setup.cell-previous', 'Setup', 'Previous cell', 'Select the previous cell (strength-ladder provider column or a kind base/orchestrator provider/strength column).', ['h'], 'terminal', ['setup.models']),
-        b('crtr.setup.cell-next', 'Setup', 'Next cell', 'Select the next cell (strength-ladder provider column or a kind base/orchestrator provider/strength column).', ['l'], 'terminal', ['setup.models']),
+        b('crtr.setup.cell-previous', 'Setup', 'Previous field', 'Select the previous field or setup table cell.', ['h'], 'terminal', ['setup.models', 'setup.keybindings']),
+        b('crtr.setup.cell-next', 'Setup', 'Next field', 'Select the next field or setup table cell.', ['l'], 'terminal', ['setup.models', 'setup.keybindings']),
         b('crtr.setup.models.open', 'Setup', 'Edit model', 'Edit the selected model cell.', ['enter'], 'terminal', ['setup.models']),
         b('crtr.setup.models.scope-next', 'Setup', 'Next model config scope', 'Edit the next applicable user, profile, or project config.', ['s'], 'terminal', ['setup.models']),
         b('crtr.setup.models.commit', 'Setup', 'Commit pick', 'Commit the provider, strength, model, or thinking-level pick.', ['enter'], 'terminal', ['setup.models.picker', 'setup.models.dimension-picker']),

package/dist/core/keybindings/index.d.ts

@@ -4,4 +4,4 @@ export { canonicalTerminalStroke, formatBinding, formatGesture, formatStroke, ma
 export { inboxOpenHint, inboxOpenInstruction, inboxPopupHint, inboxShortcut, } from './inbox.js';
 export { backgroundBashHint, backgroundBashShortcut, } from './background-bash.js';
 export { KeybindingConcurrentEditError, persistUserKeybindings, type PersistedKeybindings, type PersistKeybindingsOptions, } from './persistence.js';
-export type { BindingDefinition, BindingInputKind, BindingResolution, BindingSafetyCapability, EffectiveBinding, KeybindingDiagnostic, KeybindingDiagnosticCode, SafetyRequirement, SparseKeybindingOverrides, } from './types.js';
+export type { BindingDefinition, BindingInputKind, BindingPair, BindingResolution, BindingSafetyCapability, EffectiveBinding, KeybindingDiagnostic, KeybindingDiagnosticCode, SafetyRequirement, SparseKeybindingOverrides, } from './types.js';

package/dist/core/keybindings/resolve.js

@@ -121,6 +121,14 @@ export function normalizeGesture(raw, definition) {
             throw new GestureSyntaxError('a menu selector must be one printable character');
         }
     }
+    if (definition?.inputKind === 'tmux-global-action') {
+        if (normalized.length !== 1)
+            throw new GestureSyntaxError('a global menu shortcut must be one stroke');
+        const modifiers = normalized[0].split('+').slice(0, -1);
+        if (!modifiers.includes('ctrl') && !modifiers.includes('alt')) {
+            throw new GestureSyntaxError('a global menu shortcut must include Ctrl or Alt');
+        }
+    }
     return normalized.join(' > ');
 }
 function normalizeList(raw, definition) {

package/dist/core/keybindings/types.d.ts

@@ -1,4 +1,8 @@
-export type BindingInputKind = 'terminal' | 'tmux-sequence' | 'tmux-menu-selector' | 'host-global';
+export type BindingInputKind = 'terminal' | 'tmux-sequence' | 'tmux-menu-selector' | 'tmux-global-action' | 'host-global';
+export interface BindingPair {
+    readonly field: 'menu' | 'global';
+    readonly pairedId: string;
+}
 export type BindingSafetyCapability = 'dismiss-modal' | 'leave-screen' | 'save-keybindings';
 export interface BindingDefinition<Id extends string = string> {
     readonly id: Id;
@@ -9,6 +13,7 @@ export interface BindingDefinition<Id extends string = string> {
     readonly inputKind: BindingInputKind;
     readonly contexts: readonly string[];
     readonly safety?: BindingSafetyCapability;
+    readonly pair?: BindingPair;
 }
 export interface EffectiveBinding<Id extends string = string> {
     readonly definition: BindingDefinition<Id>;

package/dist/core/memory/doc-link-grammar.d.ts

@@ -0,0 +1,20 @@
+/** One `[[name]]` link occurrence found in a document body. */
+export interface DocLink {
+    /** Character index of the first `[` of `[[`. */
+    start: number;
+    /** Character index just past the closing `]]`. */
+    end: number;
+    /** The canonical document name between the brackets. */
+    name: string;
+}
+/** Is `name` a well-formed canonical doc-link name? */
+export declare function isDocLinkName(name: string): boolean;
+/**
+ * Find every `[[name]]` doc link in a markdown body, in order of appearance,
+ * skipping fenced code blocks and inline code spans (a link mentioned inside
+ * code is an example, not a reference). Occurrences are NOT deduplicated —
+ * callers collapse as needed.
+ */
+export declare function findDocLinks(body: string): DocLink[];
+/** The distinct link names in a body, first-appearance order. */
+export declare function docLinkNames(body: string): string[];

package/dist/core/memory/doc-link-grammar.js

@@ -0,0 +1,110 @@
+// doc-link-grammar.ts — the single source of truth for the `[[canonical/name]]`
+// memory-document link grammar. Zero imports, pure string ops, browser-safe —
+// any surface that highlights, resolves, or lints doc links imports THIS module
+// rather than re-implementing the bracket scan or the name shape.
+//
+// A doc link is a durable cross-reference written INSIDE a memory document's
+// body, pointing at another memory document by its exact canonical name (the
+// same identifier `crtr memory read <name>` takes; a directory INDEX is linked
+// by its folded bare-directory name). It is distinct from the interactive
+// `/name` inline-reference grammar (`inline-ref-grammar.ts`), which scans a
+// human's live composer text — links live in stored markdown and survive there.
+//
+// Links are POINTERS, never transclusion: nothing in the runtime auto-loads a
+// linked body into context. `crtr memory lint` fails a link that resolves to no
+// document; `crtr memory read` surfaces the resolved links of the doc it loads.
+//
+// This module never resolves anything: `findDocLinks` returns candidate links;
+// a caller decides a link is live by testing `name` against the corpus of
+// resolvable canonical names.
+// A canonical doc name: one or more `[A-Za-z0-9_-]+` segments joined by `/`.
+// Anything else between `[[` `]]` (spaces, `|` aliases, empty segments) is NOT
+// a doc link — the grammar has no alias/label form, by design.
+const NAME_RE = /^[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*$/;
+const LINK_RE = /\[\[([^\[\]\n]+)\]\]/g;
+/** Is `name` a well-formed canonical doc-link name? */
+export function isDocLinkName(name) {
+    return NAME_RE.test(name);
+}
+/**
+ * Find every `[[name]]` doc link in a markdown body, in order of appearance,
+ * skipping fenced code blocks and inline code spans (a link mentioned inside
+ * code is an example, not a reference). Occurrences are NOT deduplicated —
+ * callers collapse as needed.
+ */
+export function findDocLinks(body) {
+    const links = [];
+    for (const segment of proseSegments(body)) {
+        LINK_RE.lastIndex = 0;
+        let m;
+        while ((m = LINK_RE.exec(segment.text)) !== null) {
+            const name = m[1];
+            if (!isDocLinkName(name))
+                continue;
+            links.push({ start: segment.offset + m.index, end: segment.offset + m.index + m[0].length, name });
+        }
+    }
+    return links;
+}
+/** The distinct link names in a body, first-appearance order. */
+export function docLinkNames(body) {
+    const seen = new Set();
+    const out = [];
+    for (const link of findDocLinks(body)) {
+        if (seen.has(link.name))
+            continue;
+        seen.add(link.name);
+        out.push(link.name);
+    }
+    return out;
+}
+const FENCE_RE = /^ {0,3}(`{3,}|~{3,})/;
+function* proseSegments(body) {
+    let offset = 0;
+    let fence = null; // the opening fence marker while inside a block
+    for (const line of body.split('\n')) {
+        const lineLen = line.length + 1; // + '\n' (harmless overcount on last line)
+        const fenceMatch = line.match(FENCE_RE);
+        if (fence !== null) {
+            // Inside a fenced block: only a closing fence of the same char and at
+            // least the same length ends it. Nothing in here is prose.
+            if (fenceMatch && fenceMatch[1][0] === fence[0] && fenceMatch[1].length >= fence.length) {
+                fence = null;
+            }
+            offset += lineLen;
+            continue;
+        }
+        if (fenceMatch) {
+            fence = fenceMatch[1];
+            offset += lineLen;
+            continue;
+        }
+        // Prose line: split around inline code spans (single-backtick pairs).
+        yield* proseParts(line, offset);
+        offset += lineLen;
+    }
+}
+function* proseParts(line, offset) {
+    let i = 0;
+    while (i < line.length) {
+        const open = line.indexOf('`', i);
+        if (open === -1) {
+            yield { offset: offset + i, text: line.slice(i) };
+            return;
+        }
+        // Backtick run: an inline span is delimited by runs of equal length.
+        let runEnd = open;
+        while (runEnd < line.length && line[runEnd] === '`')
+            runEnd++;
+        const run = line.slice(open, runEnd);
+        const close = line.indexOf(run, runEnd);
+        if (close === -1) {
+            // Unbalanced backticks: treat the rest as prose past the run.
+            yield { offset: offset + i, text: line.slice(i, open) };
+            i = runEnd;
+            continue;
+        }
+        yield { offset: offset + i, text: line.slice(i, open) };
+        i = close + run.length;
+    }
+}

package/dist/core/memory-resolver.d.ts

@@ -70,6 +70,11 @@ export declare function listMemoryDocs(scope: MemoryScope, quiet?: boolean): Mem
  *  doc's name exactly as `listMemoryDocs` does (path-relative, no extension,
  *  slash-separated) then prefixing the plugin name. Builtin has no plugins. */
 export declare function listPluginMemoryDocs(plugin: InstalledPlugin, scope: MemoryScope, quiet?: boolean): MemoryDoc[];
+/** All project-scoped docs visible from an explicit node workspace/profile.
+ *  This target-addressed form is used when one process serves several nodes
+ *  (notably warm-spare claims), where ambient cwd/profile belong to the host
+ *  process rather than the node whose first-message context is being built. */
+export declare function listProjectMemoryDocs(startDir?: string, profileId?: string | null, quiet?: boolean): MemoryDoc[];
 /** All memory docs across the resolved sources, in precedence order: each
  *  ancestor project `.crouter/` from nearest to farthest, then the selected
  *  profile's memory (if any), then user, then builtin. Within each source,

package/dist/core/memory-resolver.js

@@ -158,7 +158,7 @@ function listMemoryDocsInDir(scope, dir, quiet = false) {
  *  through `loadProfileManifest`; user and builtin are singleton stores. */
 export function listMemoryDocs(scope, quiet = false) {
     if (scope === 'project') {
-        return projectScopeRoots().flatMap((root) => listMemoryDocsInDir('project', join(root, 'memory'), quiet));
+        return listProjectMemoryDocs(process.cwd(), selectedProfileId() || null, quiet);
     }
     if (scope === 'profile') {
         const profileId = selectedProfileId();
@@ -215,6 +215,17 @@ function sourceMemoryDocs(source, quiet = false) {
         ...source.plugins.flatMap((p) => listPluginMemoryDocs(p, source.scope, quiet)),
     ];
 }
+/** All project-scoped docs visible from an explicit node workspace/profile.
+ *  This target-addressed form is used when one process serves several nodes
+ *  (notably warm-spare claims), where ambient cwd/profile belong to the host
+ *  process rather than the node whose first-message context is being built. */
+export function listProjectMemoryDocs(startDir = process.cwd(), profileId = selectedProfileId() || null, quiet = false) {
+    return projectScopeRoots(startDir, profileId).flatMap((root) => sourceMemoryDocs({
+        scope: 'project',
+        memoryDir: join(root, 'memory'),
+        plugins: listInstalledPluginsInRoot('project', root).filter((plugin) => plugin.enabled),
+    }, quiet));
+}
 /** All memory docs across the resolved sources, in precedence order: each
  *  ancestor project `.crouter/` from nearest to farthest, then the selected
  *  profile's memory (if any), then user, then builtin. Within each source,

package/dist/core/runtime/bearings.d.ts

@@ -88,12 +88,12 @@ export declare function buildWakeBearings(origin: WakeOrigin): string;
  *      note. The across-cycles context-dir framing is added ONLY for an
  *      orchestrator (by mode) — the one node whose dir a future cycle resumes
  *      from.
- *   2. `<memory kind="knowledge">` — the consultable catalog, a SIBLING of the
- *      bearings (never nested under the context dir). Dropped when empty.
- *   3. `<project_context>` — the cwd/git environment snapshot. pi's own
- *      AGENTS.md/CLAUDE.md system-prompt injection stays suppressed
- *      (noContextFiles in broker.ts); project guidance instead rides the
- *      `<memory kind="knowledge">` block above via the document substrate
- *      (`crtr sys sync project-guidance` migrates each CLAUDE.md/AGENTS.md into
- *      that dir's own `.crouter/memory/AGENTS.md`). */
+ *   2. `<memory kind="knowledge">` — the consultable boot catalog, a SIBLING of
+ *      the bearings (never nested under the context dir). Dropped when empty.
+ *   3. `<auto-loaded-context>` — memories whose `applies-to: "."` fires because
+ *      cwd/profile mounted their owning project store. Dropped when empty.
+ *   4. `<project_context>` — the cwd/git environment snapshot. pi's own
+ *      AGENTS.md/CLAUDE.md injection stays suppressed (`noContextFiles` in
+ *      broker.ts); `crtr sys sync project-guidance` imports that guidance into
+ *      the directory's `.crouter/memory/INDEX.md` front door. */
 export declare function buildContextBearings(nodeId: string): string;

package/dist/core/runtime/bearings.js

@@ -16,12 +16,12 @@
 //     carries the <project_context> block (buildProjectContextBlock), which is
 //     now only the <environment> snapshot: a host/runtime line (platform,
 //     hostname, node, tmux-or-not), the cwd dir listing, and git status.
-//     Project guidance rides the
-//     document substrate instead: migrated CLAUDE.md/AGENTS.md docs live in the
-//     source dir's own `.crouter/memory/AGENTS.md` and surface through the
-//     <memory kind="knowledge"> block below (renderKnowledgeBlock) via the
-//     profile-widened boot render — no parallel project-context loader lives
-//     here anymore (see `crtr memory read taste/document-substrate`);
+//     Project guidance rides the document substrate instead: a workspace's
+//     `.crouter/memory/INDEX.md` declares `applies-to: "."` and surfaces through
+//     an <auto-loaded-context> block when cwd/profile mounts that workspace;
+//     ordinary boot-routed knowledge remains in the <memory kind="knowledge">
+//     block below. No parallel project-context loader lives here (see
+//     `crtr memory read taste/document-substrate`);
 //   • promote.ts folds orchestratorContextNote() into the promotion guidance
 //     dump, so a node that becomes an orchestrator MID-LIFE gets the
 //     orchestrator framing it never received at spawn — it spawned as a base
@@ -45,7 +45,7 @@ import { readdirSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
 import { hostname } from 'node:os';
 import { cadenceDisplay } from '../wake.js';
-import { renderKnowledgeBlock } from '../substrate/index.js';
+import { renderKnowledgeBlock, renderWorkspaceOpenDocs } from '../substrate/index.js';
 import { loadProfileManifest } from '../profiles/manifest.js';
 import { situationalContextBlock } from './situational-context.js';
 function escapeAttribute(value) {
@@ -391,14 +391,14 @@ export function buildWakeBearings(origin) {
  *      note. The across-cycles context-dir framing is added ONLY for an
  *      orchestrator (by mode) — the one node whose dir a future cycle resumes
  *      from.
- *   2. `<memory kind="knowledge">` — the consultable catalog, a SIBLING of the
- *      bearings (never nested under the context dir). Dropped when empty.
- *   3. `<project_context>` — the cwd/git environment snapshot. pi's own
- *      AGENTS.md/CLAUDE.md system-prompt injection stays suppressed
- *      (noContextFiles in broker.ts); project guidance instead rides the
- *      `<memory kind="knowledge">` block above via the document substrate
- *      (`crtr sys sync project-guidance` migrates each CLAUDE.md/AGENTS.md into
- *      that dir's own `.crouter/memory/AGENTS.md`). */
+ *   2. `<memory kind="knowledge">` — the consultable boot catalog, a SIBLING of
+ *      the bearings (never nested under the context dir). Dropped when empty.
+ *   3. `<auto-loaded-context>` — memories whose `applies-to: "."` fires because
+ *      cwd/profile mounted their owning project store. Dropped when empty.
+ *   4. `<project_context>` — the cwd/git environment snapshot. pi's own
+ *      AGENTS.md/CLAUDE.md injection stays suppressed (`noContextFiles` in
+ *      broker.ts); `crtr sys sync project-guidance` imports that guidance into
+ *      the directory's `.crouter/memory/INDEX.md` front door. */
 export function buildContextBearings(nodeId) {
     const node = getNode(nodeId);
     const bearings = ['<crtr-bearings>', buildIdentityAssertion(nodeId)];
@@ -420,10 +420,14 @@ export function buildContextBearings(nodeId) {
     bearings.push('</crtr-bearings>');
     // The consultable catalog rides BESIDE the bearings, not inside them.
     const knowledge = renderKnowledgeBlock(nodeId);
+    // A workspace mount is the initial read of its root (`applies-to: "."`).
+    const workspaceContext = renderWorkspaceOpenDocs(nodeId);
     // Hidden applet/situation-origin ambient context (see situational-context.ts)
     // — a SIBLING block, never nested under <crtr-bearings>, and never routed
     // through the visible chat/digest path. '' when nothing was ever set.
     const situational = situationalContextBlock(nodeId);
     const projectCtx = node?.cwd !== undefined ? buildProjectContextBlock(node.cwd) : '';
-    return [bearings.join('\n'), knowledge, situational, projectCtx].filter((s) => s !== '').join('\n');
+    return [bearings.join('\n'), knowledge, workspaceContext, situational, projectCtx]
+        .filter((s) => s !== '')
+        .join('\n');
 }

package/dist/core/runtime/broker.js

@@ -3117,15 +3117,6 @@ export async function buildBrokerSession(engine, cfg) {
     //    model comes from a custom-provider extension would get NO model. Mirrors pi
     //    main.js (createAgentSessionServices → …FromServices).
     //
-    //    C4 note: the pinned SDK (0.78.1) has NO project-trust concept at all —
-    //    project context files (AGENTS.md/CLAUDE.md) load UNCONDITIONALLY (gated
-    //    only by `noContextFiles`, left default-false), so the headless "trust
-    //    resolves false → context silently dropped" gap cannot occur here. WHEN the
-    //    SDK pin bumps to 0.79.0+ (which adds project-trust), pass an explicit
-    //    `settingsManager: SettingsManager.create(cfg.cwd, getAgentDir(), { projectTrusted: true })`
-    //    so headless trust defaults TRUSTED — and do NOT re-introduce the CLI's
-    //    resolveProjectTrust, which returns false with no TTY.
-    //
     //    T3 session-rebind: services + model + session creation is factored into
     //    `buildForManager` so it can serve BOTH the initial boot AND the
     //    AgentSessionRuntime factory it is reused as below (new_session/
@@ -3152,10 +3143,9 @@ export async function buildBrokerSession(engine, cfg) {
                 additionalExtensionPaths: cfg.extensionPaths,
                 appendSystemPrompt: cfg.appendSystemPromptPath !== undefined ? [cfg.appendSystemPromptPath] : undefined,
                 // Suppress pi's <project_context> AGENTS.md/CLAUDE.md injection in the
-                // SYSTEM PROMPT unconditionally — crouter reads project guidance through
-                // the document substrate instead (a migrated AGENTS.md doc rides the
-                // <memory kind="knowledge"> block in the first-message bearings; see
-                // bearings.ts and `crtr sys sync project-guidance`), never pi's own file-based loader.
+                // system prompt. crouter imports either source into the project's root
+                // memory INDEX and surfaces that front door in first-message context;
+                // pi's file-based loader is not a second guidance path.
                 noContextFiles: true,
             },
         });

package/dist/core/runtime/canvas-extensions.d.ts

@@ -4,6 +4,7 @@ export declare const CANVAS_RECAP_PATH: string;
 export declare const CANVAS_GOAL_CAPTURE_PATH: string;
 export declare const CANVAS_PASSIVE_CONTEXT_PATH: string;
 export declare const CANVAS_CONTEXT_INTRO_PATH: string;
+export declare const CANVAS_TOOL_GUIDE_PATH: string;
 export declare const CANVAS_DOC_SUBSTRATE_PATH: string;
 export declare const CANVAS_STRUCTURED_OUTPUT_PATH: string;
 export declare const CANVAS_BASH_VALVE_PATH: string;

package/dist/core/runtime/canvas-extensions.js

@@ -16,6 +16,7 @@ export const CANVAS_RECAP_PATH = resolveExtension('canvas-recap');
 export const CANVAS_GOAL_CAPTURE_PATH = resolveExtension('canvas-goal-capture');
 export const CANVAS_PASSIVE_CONTEXT_PATH = resolveExtension('canvas-passive-context');
 export const CANVAS_CONTEXT_INTRO_PATH = resolveExtension('canvas-context-intro');
+export const CANVAS_TOOL_GUIDE_PATH = resolveExtension('canvas-tool-guide');
 export const CANVAS_DOC_SUBSTRATE_PATH = resolveExtension('canvas-doc-substrate');
 export const CANVAS_STRUCTURED_OUTPUT_PATH = resolveExtension('canvas-structured-output');
 export const CANVAS_BASH_VALVE_PATH = resolveExtension('canvas-bash-valve');
@@ -32,6 +33,7 @@ export const CANVAS_EXTENSIONS = [
     CANVAS_GOAL_CAPTURE_PATH,
     CANVAS_PASSIVE_CONTEXT_PATH,
     CANVAS_CONTEXT_INTRO_PATH,
+    CANVAS_TOOL_GUIDE_PATH,
     CANVAS_DOC_SUBSTRATE_PATH,
     CANVAS_STRUCTURED_OUTPUT_PATH,
     CANVAS_BASH_VALVE_PATH,

package/dist/core/runtime/launch.d.ts

@@ -1,4 +1,4 @@
-export { CANVAS_EXTENSIONS, CANVAS_STOPHOOK_PATH, CANVAS_INBOX_WATCHER_PATH, CANVAS_RECAP_PATH, CANVAS_GOAL_CAPTURE_PATH, CANVAS_PASSIVE_CONTEXT_PATH, CANVAS_CONTEXT_INTRO_PATH, CANVAS_DOC_SUBSTRATE_PATH, CANVAS_STRUCTURED_OUTPUT_PATH, CANVAS_BASH_VALVE_PATH, } from './canvas-extensions.js';
+export { CANVAS_EXTENSIONS, CANVAS_STOPHOOK_PATH, CANVAS_INBOX_WATCHER_PATH, CANVAS_RECAP_PATH, CANVAS_GOAL_CAPTURE_PATH, CANVAS_PASSIVE_CONTEXT_PATH, CANVAS_CONTEXT_INTRO_PATH, CANVAS_TOOL_GUIDE_PATH, CANVAS_DOC_SUBSTRATE_PATH, CANVAS_STRUCTURED_OUTPUT_PATH, CANVAS_BASH_VALVE_PATH, } from './canvas-extensions.js';
 import type { NodeMeta, LaunchSpec, Mode, Lifecycle } from '../canvas/index.js';
 import type { ModelProvider, ModelStrength, ScopeConfig } from '../../types.js';
 export { OPENAI_PROVIDER_ENV, configuredLadderProviders, inferPortableModelSelection } from './model-selection.js';

package/dist/core/runtime/launch.js

@@ -14,7 +14,7 @@ import { readMergedLaunchConfig } from '../config.js';
 import { LAUNCH_SYSTEM_PROMPT } from './launch-prompt.js';
 import { nodeEnv } from './nodes.js';
 import { editorLabel } from '../canvas/index.js';
-export { CANVAS_EXTENSIONS, CANVAS_STOPHOOK_PATH, CANVAS_INBOX_WATCHER_PATH, CANVAS_RECAP_PATH, CANVAS_GOAL_CAPTURE_PATH, CANVAS_PASSIVE_CONTEXT_PATH, CANVAS_CONTEXT_INTRO_PATH, CANVAS_DOC_SUBSTRATE_PATH, CANVAS_STRUCTURED_OUTPUT_PATH, CANVAS_BASH_VALVE_PATH, } from './canvas-extensions.js';
+export { CANVAS_EXTENSIONS, CANVAS_STOPHOOK_PATH, CANVAS_INBOX_WATCHER_PATH, CANVAS_RECAP_PATH, CANVAS_GOAL_CAPTURE_PATH, CANVAS_PASSIVE_CONTEXT_PATH, CANVAS_CONTEXT_INTRO_PATH, CANVAS_TOOL_GUIDE_PATH, CANVAS_DOC_SUBSTRATE_PATH, CANVAS_STRUCTURED_OUTPUT_PATH, CANVAS_BASH_VALVE_PATH, } from './canvas-extensions.js';
 import { nodeDir } from '../canvas/paths.js';
 import { CANVAS_EXTENSIONS, mergeCanvasExtensions, assertMandatoryCanvasExtensions } from './canvas-extensions.js';
 import { modelLadders, defaultProvider, STRENGTH_ALIASES, MODEL_PROVIDER_KEYS, MODEL_STRENGTHS, THINKING_SUFFIXES, stripThinkingSuffix, } from './model-selection.js';