@north-light/crouter 0.3.162 → 0.3.164

package/dist/commands/sys/setup-wizard.js

@@ -1278,6 +1278,50 @@ class ModelsPanel {
         return frame(this.fitBody(body, selectedLine, contentBudget));
     }
 }
+/** Collapse explicitly-paired catalog definitions into one setup action row.
+ *  Pair membership and field roles come only from catalog metadata; neither
+ *  rendering nor installation guesses from binding ID names. */
+function buildSetupKeybindingRows() {
+    const byId = new Map(BINDING_CATALOG.map((definition) => [definition.id, definition]));
+    const consumed = new Set();
+    const rows = [];
+    for (const definition of BINDING_CATALOG) {
+        if (consumed.has(definition.id))
+            continue;
+        if (definition.pair === undefined) {
+            rows.push({
+                group: definition.group,
+                name: definition.name,
+                description: definition.description,
+                fields: [{ definition }],
+            });
+            consumed.add(definition.id);
+            continue;
+        }
+        const paired = byId.get(definition.pair.pairedId);
+        if (paired?.pair?.pairedId !== definition.id || paired.pair.field === definition.pair.field) {
+            throw new Error(`invalid keybinding pair metadata for ${definition.id}`);
+        }
+        const members = [definition, paired];
+        const menu = members.find((member) => member.pair?.field === 'menu');
+        const global = members.find((member) => member.pair?.field === 'global');
+        if (menu === undefined || global === undefined)
+            throw new Error(`incomplete keybinding pair for ${definition.id}`);
+        rows.push({
+            group: menu.group,
+            name: menu.name,
+            description: menu.description,
+            fields: [
+                { label: 'Menu', definition: menu },
+                { label: 'Global', definition: global },
+            ],
+        });
+        consumed.add(menu.id);
+        consumed.add(global.id);
+    }
+    return rows;
+}
+const SETUP_KEYBINDING_ROWS = buildSetupKeybindingRows();
 export class SetupWizard {
     manifest;
     installedPackageIds;
@@ -1299,6 +1343,7 @@ export class SetupWizard {
     expandedPluginId = null;
     confirming = false;
     keyIndex = 0;
+    keyFieldIndex = 0;
     keyScroll = 0;
     keyFilter = '';
     filteringKeys = false;
@@ -1539,25 +1584,38 @@ export class SetupWizard {
         const resolution = this.keyDraft.resolution();
         const needle = this.keyFilter.trim().toLowerCase();
         if (needle === '')
-            return BINDING_CATALOG;
-        return BINDING_CATALOG.filter((definition) => {
-            const rendered = formatBinding(resolution, definition.id);
-            return [definition.name, definition.id, definition.group, definition.description, rendered]
-                .some((value) => value.toLowerCase().includes(needle));
-        });
-    }
-    selectedKeybinding() {
+            return SETUP_KEYBINDING_ROWS;
+        return SETUP_KEYBINDING_ROWS.filter((row) => [
+            row.name,
+            row.group,
+            row.description,
+            ...row.fields.flatMap((field) => [
+                field.label ?? '',
+                field.definition.id,
+                field.definition.name,
+                field.definition.description,
+                formatBinding(resolution, field.definition.id),
+            ]),
+        ].some((value) => value.toLowerCase().includes(needle)));
+    }
+    selectedKeyRow() {
         const rows = this.filteredKeybindings();
         if (rows.length === 0)
             return undefined;
         this.keyIndex = Math.max(0, Math.min(this.keyIndex, rows.length - 1));
-        return rows[this.keyIndex];
+        const row = rows[this.keyIndex];
+        this.keyFieldIndex = Math.max(0, Math.min(this.keyFieldIndex, row.fields.length - 1));
+        return row;
+    }
+    selectedKeybinding() {
+        return this.selectedKeyRow()?.fields[this.keyFieldIndex]?.definition;
     }
     moveKey(delta) {
         const rows = this.filteredKeybindings();
         if (rows.length === 0)
             return;
         this.keyIndex = Math.max(0, Math.min(rows.length - 1, this.keyIndex + delta));
+        this.keyFieldIndex = Math.min(this.keyFieldIndex, rows[this.keyIndex].fields.length - 1);
         const page = this.keyPageSize();
         if (this.keyIndex < this.keyScroll)
             this.keyScroll = this.keyIndex;
@@ -1566,6 +1624,14 @@ export class SetupWizard {
         this.keyEditError = undefined;
         this.invalidate();
     }
+    moveKeyField(delta) {
+        const row = this.selectedKeyRow();
+        if (row === undefined)
+            return;
+        this.keyFieldIndex = Math.max(0, Math.min(row.fields.length - 1, this.keyFieldIndex + delta));
+        this.keyEditError = undefined;
+        this.invalidate();
+    }
     // Max output lines the row region may emit before it starts clipping the
     // confirm prompt / notice / footer. Budgets the fixed chrome around the list:
     // header (3) + blank + tab header/count (2) + blank + footer (1) plus a small
@@ -1821,6 +1887,14 @@ export class SetupWizard {
             this.moveKey(-1);
             return;
         }
+        else if (this.matches('crtr.setup.cell-previous', data)) {
+            this.moveKeyField(-1);
+            return;
+        }
+        else if (this.matches('crtr.setup.cell-next', data)) {
+            this.moveKeyField(1);
+            return;
+        }
         else if (this.matches('crtr.setup.keybindings.page-up', data)) {
             this.moveKey(-this.keyPageSize());
             return;
@@ -2027,7 +2101,7 @@ export class SetupWizard {
                                         ? `type gestures separated by commas · ${this.label('crtr.setup.keybindings.commit-edit')} commit · ${this.label('crtr.setup.keybindings.cancel-edit')} cancel · ${this.label('crtr.setup.keybindings.page-up')}/${this.label('crtr.setup.keybindings.page-down')} scroll`
                                         : this.filteringKeys
                                             ? `filter: ${this.keyFilter || 'type to search'} · ${this.label('crtr.setup.keybindings.edit')} keep · ${this.label('crtr.setup.keybindings.filter-delete')} delete · ${this.label('crtr.setup.keybindings.filter-clear')} clear`
-                                            : `${this.label('crtr.setup.list-down')}/${this.label('crtr.setup.list-up')} move · ${this.label('crtr.setup.keybindings.edit')} edit · ${this.label('crtr.setup.keybindings.unbind')} disable · ${this.label('crtr.setup.keybindings.reset-row')} reset · ${this.label('crtr.setup.keybindings.reset-all')} reset all · ${this.label('crtr.setup.keybindings.filter')} filter · ${this.label('crtr.setup.keybindings.save')} save · ${this.label('crtr.setup.keybindings.discard')} ${this.keyFilter !== '' ? 'clear filter' : 'discard'}`;
+                                            : `${this.label('crtr.setup.list-down')}/${this.label('crtr.setup.list-up')} move · ${this.label('crtr.setup.cell-previous')}/${this.label('crtr.setup.cell-next')} field · ${this.label('crtr.setup.keybindings.edit')} edit · ${this.label('crtr.setup.keybindings.unbind')} disable · ${this.label('crtr.setup.keybindings.reset-row')} reset · ${this.label('crtr.setup.keybindings.reset-all')} reset all · ${this.label('crtr.setup.keybindings.filter')} filter · ${this.label('crtr.setup.keybindings.save')} save · ${this.label('crtr.setup.keybindings.discard')} ${this.keyFilter !== '' ? 'clear filter' : 'discard'}`;
         return [truncateToWidth(theme.fg('dim', line), width)];
     }
     renderProviders(width) {
@@ -2113,30 +2187,50 @@ export class SetupWizard {
         out.push(truncateToWidth(theme.fg('dim', `${this.label('crtr.setup.confirm.accept')} confirm · ${this.label('crtr.setup.confirm.back')} go back`), width));
         return out;
     }
-    // Does the row at `index` contribute a diagnostic line in the current state?
-    // Mirrors the emit loop's `message` computation so the line-cost accounting
-    // and the render stay in lockstep.
-    keyRowHasMessage(rows, index) {
-        const definition = rows[index];
+    keyRowMessage(rows, index) {
+        const row = rows[index];
         const selected = index === this.keyIndex;
-        const editing = this.editingKey === definition.id;
-        if (!selected && !editing)
-            return false;
-        if (editing && this.keyEditError)
-            return true;
-        const diagnostic = this.keyDiagnostics.find((entry) => entry.bindingId === definition.id || entry.relatedBindingIds?.includes(definition.id));
-        return diagnostic !== undefined;
-    }
-    // Output lines the visible rows [start..end] cost, counting the per-row group
-    // heading (the first visible row always re-emits its heading) and any
-    // diagnostic line. Used to clamp the scroll so the anchor row always renders.
-    keyLineCost(rows, start, end) {
+        const editing = row.fields.find((field) => field.definition.id === this.editingKey);
+        if (!selected && editing === undefined)
+            return undefined;
+        if (editing !== undefined && this.keyEditError)
+            return { label: editing.label, message: this.keyEditError };
+        const diagnostic = this.keyDiagnostics.find((entry) => row.fields.some((field) => entry.bindingId === field.definition.id || entry.relatedBindingIds?.includes(field.definition.id)));
+        if (diagnostic === undefined)
+            return undefined;
+        const responsible = row.fields.find((field) => diagnostic.bindingId === field.definition.id || diagnostic.relatedBindingIds?.includes(field.definition.id));
+        return { label: responsible?.label, message: diagnostic.message };
+    }
+    /** Number of lines needed to keep the active paired field legible. A narrow
+     *  row stacks the action and field instead of sacrificing the action name,
+     *  selected-field identity, or value to fixed columns. */
+    keyRowBodyLineCount(row, index, resolution, width) {
+        const editingFieldIndex = row.fields.findIndex((field) => field.definition.id === this.editingKey);
+        const active = editingFieldIndex >= 0 || index === this.keyIndex;
+        if (!active || row.fields.length < 2)
+            return 1;
+        const fieldIndex = editingFieldIndex >= 0 ? editingFieldIndex : Math.min(this.keyFieldIndex, row.fields.length - 1);
+        const field = row.fields[fieldIndex];
+        const value = editingFieldIndex >= 0 ? `> ${this.keyInput.getValue()}` : formatBinding(resolution, field.definition.id);
+        const bracketedLabel = `[${field.label}]`;
+        const inlineWidth = 3 + visibleWidth(row.name) + 1 + visibleWidth(bracketedLabel) + 1 + visibleWidth(value);
+        if (inlineWidth <= width)
+            return 1;
+        const compactFieldWidth = visibleWidth(field.label ?? '') + 1 + visibleWidth(value);
+        return compactFieldWidth <= width ? 2 : 3;
+    }
+    // Output lines the visible rows [start..end] cost, counting group headings,
+    // responsive row bodies, and diagnostics. Used to clamp the scroll so the
+    // anchor row always renders.
+    keyLineCost(rows, start, end, resolution, width) {
         let lines = 0;
         let previousGroup;
         for (let index = start; index <= end; index += 1) {
-            const definition = rows[index];
-            lines += (definition.group !== previousGroup ? 1 : 0) + 1 + (this.keyRowHasMessage(rows, index) ? 1 : 0);
-            previousGroup = definition.group;
+            const row = rows[index];
+            lines += (row.group !== previousGroup ? 1 : 0)
+                + this.keyRowBodyLineCount(row, index, resolution, width)
+                + (this.keyRowMessage(rows, index) ? 1 : 0);
+            previousGroup = row.group;
         }
         return lines;
     }
@@ -2157,12 +2251,14 @@ export class SetupWizard {
         // Injected group-heading and diagnostic lines can make a pageSize-row window
         // exceed the raw viewport, so instead of a fixed reserve, clamp the scroll
         // dynamically until the anchor is guaranteed to render within `viewport`.
-        const editIndex = this.editingKey !== null ? rows.findIndex((row) => row.id === this.editingKey) : -1;
+        const editIndex = this.editingKey !== null
+            ? rows.findIndex((row) => row.fields.some((field) => field.definition.id === this.editingKey))
+            : -1;
         const anchor = editIndex >= 0 ? editIndex : this.keyIndex;
         if (anchor >= 0) {
             if (anchor < this.keyScroll)
                 this.keyScroll = anchor;
-            while (this.keyScroll < anchor && this.keyLineCost(rows, this.keyScroll, anchor) > viewport) {
+            while (this.keyScroll < anchor && this.keyLineCost(rows, this.keyScroll, anchor, resolution, width) > viewport) {
                 this.keyScroll += 1;
             }
         }
@@ -2179,40 +2275,95 @@ export class SetupWizard {
             out.push(truncateToWidth(theme.fg('warning', 'No matching keybindings.'), width));
             return out;
         }
-        const nameWidth = Math.max(16, Math.min(28, Math.floor(width * 0.28)));
-        const keyWidth = Math.max(18, Math.min(34, Math.floor(width * 0.34)));
-        const showDescription = width >= 72;
+        const nameWidth = Math.max(10, Math.min(26, Math.floor(width * 0.28)));
         let emitted = 0;
         let previousGroup;
         for (let index = this.keyScroll; index < rows.length; index += 1) {
-            const definition = rows[index];
+            const row = rows[index];
             const selected = index === this.keyIndex;
-            const editing = this.editingKey === definition.id;
-            const diagnostics = (selected || editing)
-                ? this.keyDiagnostics.filter((diagnostic) => diagnostic.bindingId === definition.id || diagnostic.relatedBindingIds?.includes(definition.id))
-                : [];
-            const message = editing ? (this.keyEditError ?? diagnostics[0]?.message) : (selected ? diagnostics[0]?.message : undefined);
-            // Budget output lines (heading + row + optional diagnostic) so the list
-            // never clips the confirm prompt / notice / footer below it.
-            const cost = (definition.group !== previousGroup ? 1 : 0) + 1 + (message ? 1 : 0);
+            const editingFieldIndex = row.fields.findIndex((field) => field.definition.id === this.editingKey);
+            const activeFieldIndex = editingFieldIndex >= 0
+                ? editingFieldIndex
+                : selected ? Math.min(this.keyFieldIndex, row.fields.length - 1) : 0;
+            const message = this.keyRowMessage(rows, index);
+            const bodyLines = this.keyRowBodyLineCount(row, index, resolution, width);
+            // Budget output lines (heading + responsive row + optional diagnostic) so
+            // the list never clips the confirm prompt / notice / footer below it.
+            const cost = (row.group !== previousGroup ? 1 : 0) + bodyLines + (message ? 1 : 0);
             if (emitted > 0 && emitted + cost > viewport)
                 break;
-            if (definition.group !== previousGroup) {
-                out.push(truncateToWidth(theme.fg('accent', definition.group), width));
-                previousGroup = definition.group;
+            if (row.group !== previousGroup) {
+                out.push(truncateToWidth(theme.fg('accent', row.group), width));
+                previousGroup = row.group;
             }
             const marker = selected ? theme.fg('accent', '▶') : ' ';
-            const sourceMark = resolution.get(definition.id).source === 'user' ? theme.fg('warning', '•') : ' ';
-            const name = padAnsi(selected ? theme.fg('accent', definition.name) : definition.name, nameWidth);
-            // Render the edit field whenever THIS row is the one being edited — even if
-            // paging has moved the selection elsewhere — so the active editor stays
-            // visible while it captures input.
-            const keyText = editing ? (this.keyInput.render(keyWidth)[0] ?? '') : formatBinding(resolution, definition.id);
-            const key = padAnsi(keyText, keyWidth);
-            const description = showDescription ? ` ${theme.fg('dim', definition.description)}` : '';
-            out.push(truncateToWidth(`${marker}${sourceMark} ${name} ${key}${description}`, width));
-            if (message)
-                out.push(truncateToWidth(theme.fg('warning', `   ${message}`), width));
+            const sourceMark = row.fields.some((field) => resolution.get(field.definition.id).source === 'user')
+                ? theme.fg('warning', '•')
+                : ' ';
+            if (bodyLines > 1) {
+                const field = row.fields[activeFieldIndex];
+                const editing = field.definition.id === this.editingKey;
+                const plainValue = editing ? `> ${this.keyInput.getValue()}` : formatBinding(resolution, field.definition.id);
+                const bracketedLabel = `[${field.label}]`;
+                const compactLabel = field.label ?? '';
+                out.push(truncateToWidth(`${marker}${sourceMark} ${selected ? theme.fg('accent', row.name) : row.name}`, width));
+                if (bodyLines === 2) {
+                    const useBracketed = visibleWidth(bracketedLabel) + 1 + visibleWidth(plainValue) <= width;
+                    const plainLabel = useBracketed ? bracketedLabel : compactLabel;
+                    const label = theme.fg('accent', theme.bold(plainLabel));
+                    const indent = ' '.repeat(Math.max(0, Math.min(3, width - visibleWidth(plainLabel) - 1 - visibleWidth(plainValue))));
+                    const valueWidth = Math.max(1, width - visibleWidth(indent) - visibleWidth(label) - 1);
+                    const value = editing ? (this.keyInput.render(valueWidth)[0] ?? '') : plainValue;
+                    out.push(truncateToWidth(`${indent}${label} ${value}`, width));
+                }
+                else {
+                    const label = theme.fg('accent', theme.bold(bracketedLabel));
+                    const labelIndent = ' '.repeat(Math.max(0, Math.min(3, width - visibleWidth(label))));
+                    const value = editing ? (this.keyInput.render(width)[0] ?? '') : plainValue;
+                    out.push(truncateToWidth(`${labelIndent}${label}`, width));
+                    out.push(truncateToWidth(value, width));
+                }
+            }
+            else {
+                const name = padAnsi(selected ? theme.fg('accent', row.name) : row.name, nameWidth);
+                const available = Math.max(1, width - 4 - nameWidth);
+                const showAllFields = row.fields.length === 1 || available >= 28;
+                const visibleFields = showAllFields ? row.fields : [row.fields[activeFieldIndex]];
+                const fieldAreaWidth = row.fields.length > 1
+                    ? Math.min(61, available)
+                    : Math.min(34, available);
+                const gapWidth = Math.max(0, visibleFields.length - 1);
+                const fieldWidth = Math.max(1, Math.floor((fieldAreaWidth - gapWidth) / visibleFields.length));
+                const renderedFields = visibleFields.map((field) => {
+                    const fieldIndex = row.fields.indexOf(field);
+                    const editing = field.definition.id === this.editingKey;
+                    const active = editing || (selected && fieldIndex === activeFieldIndex);
+                    const label = field.label === undefined
+                        ? ''
+                        : active
+                            ? theme.fg('accent', theme.bold(`[${field.label}]`))
+                            : theme.fg('dim', `${field.label}:`);
+                    const labelWidth = visibleWidth(label);
+                    const valueWidth = Math.max(1, fieldWidth - labelWidth - (label === '' ? 0 : 1));
+                    // Render the edit field whenever THIS underlying definition is being
+                    // edited, even if paging moved row selection elsewhere.
+                    const value = editing
+                        ? (this.keyInput.render(valueWidth)[0] ?? '')
+                        : formatBinding(resolution, field.definition.id);
+                    const content = label === '' ? value : `${label} ${value}`;
+                    return padAnsi(truncateToWidth(content, fieldWidth), fieldWidth);
+                });
+                const fieldsText = renderedFields.join(' ');
+                const descriptionWidth = available - visibleWidth(fieldsText) - 1;
+                const description = descriptionWidth >= 16
+                    ? ` ${theme.fg('dim', truncateToWidth(row.description, descriptionWidth))}`
+                    : '';
+                out.push(truncateToWidth(`${marker}${sourceMark} ${name} ${fieldsText}${description}`, width));
+            }
+            if (message) {
+                const fieldPrefix = message.label === undefined ? '' : `${message.label}: `;
+                out.push(truncateToWidth(theme.fg('warning', `   ${fieldPrefix}${message.message}`), width));
+            }
             emitted += cost;
         }
         if (this.keyConfirm !== null) {

package/dist/commands/sys/sync-deps.js

@@ -16,16 +16,13 @@
 //     via the bare-dir → INDEX contract, AND the bundle's relative sidecar
 //     links (./references/x.md, ./docs/y.md) keep resolving on disk because
 //     the bundle's file layout is preserved. Sidecar .md files get minimal
-//     substrate frontmatter injected (lint-clean, name/name visible); other files
-//     copy verbatim.
-//   • Vendored bundle and sidecar docs sit at name/name, so agents can
-//     discover their resolvable identities without loading their bodies. The
-//     ONE generated top deps/INDEX.md sits at preview/preview and carries the
-//     routing catalog. The catalog is one read away, each vendored doc another;
-//     the positional on-read hook surfaces the catalog's preview line plus each
-//     vendored doc's bare name, once per session — which also routes agents
-//     whose cwd (and boot tree) is elsewhere the moment they read a file in
-//     this project.
+//     substrate frontmatter injected (lint-clean, system name/file none); other
+//     files copy verbatim.
+//   • Vendored bundle and sidecar docs sit at system name/file none, so the boot
+//     catalog exposes their resolvable identities without loading their bodies.
+//     The ONE generated top deps/INDEX.md sits at system preview/file none and
+//     carries the routing catalog. The catalog is one read away, each vendored
+//     doc another.
 import { copyFileSync, mkdirSync, readdirSync, rmSync } from 'node:fs';
 import { CRTR_DIR_NAME } from '../../types.js';
 import { basename, dirname, join, relative, resolve, sep } from 'node:path';
@@ -181,9 +178,8 @@ function condenseDescription(desc, max = 220) {
     return `${cut.slice(0, lastSpace > 80 ? lastSpace : max).trimEnd()}…`;
 }
 /** Frontmatter fields from a source file that must never pass through into a
- *  vendored doc: identity, routing, and trigger fields are all set (or
- *  deliberately absent) by this lane — a source applies-to/read-when would
- *  pierce the INDEX ceiling (on-read D6) and defeat the collapsed design. */
+ *  vendored doc: this lane owns identity, routing, visibility, and gates, so a
+ *  dependency bundle cannot alter how the generated project catalog surfaces. */
 const CONTROLLED_FIELDS = [
     'name',
     'description',
@@ -374,7 +370,7 @@ export function runDepsSync(opts) {
                     ? condenseDescription(entry.description)
                     : `Vendored agent doc shipped by ${entry.pkg}.`,
                 'system-prompt-visibility': 'name',
-                'file-read-visibility': 'name',
+                'file-read-visibility': 'none',
                 'source-package': `${entry.pkg}@${entry.version}`,
                 ...passthroughFm(entry.fm),
             };
@@ -398,7 +394,7 @@ export function runDepsSync(opts) {
                 'when-and-why-to-read': `When ${parentName} links to this file, this knowledge should be read because it carries the linked supporting reference.`,
                 'short-form': firstHeading(body) ?? `Supporting reference vendored from ${entry.pkg}.`,
                 'system-prompt-visibility': 'name',
-                'file-read-visibility': 'name',
+                'file-read-visibility': 'none',
                 'source-package': `${entry.pkg}@${entry.version}`,
                 ...passthroughFm(sourceFm),
             };
@@ -409,7 +405,7 @@ export function runDepsSync(opts) {
             copyFileSync(entry.sourceAbs, target);
         }
     }
-    // The generated catalog INDEX: preview/preview routing + full per-package map.
+    // The generated catalog INDEX: boot preview + full per-package map.
     const libNames = [...new Set(skills.map(([, skill]) => skill.pkg))];
     const shownLibs = libNames.slice(0, 6).join(', ') + (libNames.length > 6 ? ', …' : '');
     const byPackage = new Map();
@@ -435,7 +431,7 @@ export function runDepsSync(opts) {
             ? 'No dependency-shipped agent docs are currently vendored.'
             : "Generated catalog of the agent docs shipped inside this project's npm dependencies.",
         'system-prompt-visibility': 'preview',
-        'file-read-visibility': 'preview',
+        'file-read-visibility': 'none',
         'generated-by': DEPS_GENERATED_MARKER,
     };
     const indexBody = emptyCatalog
@@ -490,7 +486,7 @@ export const sysSyncDepsLeaf = defineLeaf({
         ],
         outputKind: 'object',
         effects: [
-            "Wipes and regenerates <project>/.crouter/memory/deps/ from installed dependency skills, except bundles selected by exact {package,version,skill} entries in package.json crtr.sync.deps.exclude. Each included SKILL.md becomes a name/name deps/<bundle>/INDEX.md (relative sidecar links keep resolving), Markdown sidecar docs are vendored alongside at name/name, other sidecar assets are copied verbatim, and a generated preview/preview deps/INDEX.md catalog plus a self-ignoring .gitignore are written. Excluded bundles and their sidecars do not enter the catalog.",
+            "Wipes and regenerates <project>/.crouter/memory/deps/ from installed dependency skills, except bundles selected by exact {package,version,skill} entries in package.json crtr.sync.deps.exclude. Each included SKILL.md becomes a system-name/file-none deps/<bundle>/INDEX.md (relative sidecar links keep resolving), Markdown sidecar docs are vendored alongside at the same rungs, other sidecar assets are copied verbatim, and a system-preview/file-none deps/INDEX.md catalog plus a self-ignoring .gitignore are written. Excluded bundles and their sidecars do not enter the catalog.",
             'With --dry-run: read-only; writes nothing.',
         ],
     },

package/dist/commands/sys/sync-project-guidance.js

@@ -1,8 +1,8 @@
 // `crtr sys sync project-guidance` — one-way migration of a project's own
 // CLAUDE.md/AGENTS.md/.claude/rules into that SAME directory's OWN
-// `.crouter/memory/`, so the doc travels with the repo and gets positional
-// on-read for free. See `crtr memory read taste/document-substrate` for the
-// content-rung ruling this migration relies on.
+// `.crouter/memory/`. Each project guide becomes the root INDEX front door;
+// rules retain their explicit path routes, or use the workspace-open `.` route
+// when they are pathless.
 import { existsSync, readdirSync, realpathSync, statSync } from 'node:fs';
 import { basename, dirname, join, relative, resolve, sep } from 'node:path';
 import { defineLeaf } from '../../core/command.js';
@@ -95,7 +95,7 @@ function synthesizeShortForm(body) {
     return 'Migrated project guidance.';
 }
 /** `.claude/rules` frontmatter `paths:` normalizes to a glob list — a single
- *  string, an array, or absent (positional, unconditional rule). */
+ *  string, an array, or absent for a workspace-wide rule. */
 function normalizeRulePaths(v) {
     if (typeof v === 'string')
         return v.trim() === '' ? [] : [v.trim()];
@@ -201,12 +201,10 @@ function projectDocLabel(candidate) {
         .replace(/^\.$/, '');
     return relDir === '' ? rootLabel : normalizedName(`${rootLabel}/${relDir}`);
 }
-/** AGENTS.md/CLAUDE.md → `<sourceDir>/.crouter/memory/AGENTS.md` at
- *  content/content (the CTO's ruling, 2026-07-06: an AGENTS.md-style doc is
- *  always-relevant AND wholly-important, so full-body at `content` is
- *  sanctioned — see `taste/document-substrate`). The on-disk filename stays
- *  `AGENTS.md`, but the substrate identity is the explicit project label so
- *  sibling roots do not collapse on a shared `AGENTS` leaf. */
+/** AGENTS.md/CLAUDE.md → `<sourceDir>/.crouter/memory/INDEX.md`, the
+ *  workspace front door. Its explicit project identity keeps sibling roots
+ *  distinct; system none/file content plus `applies-to: "."` puts the wholly
+ *  important guide in first-message context when cwd/profile mounts the store. */
 function prepareAgentsCandidate(candidate) {
     const body = parseFrontmatterGeneric(readText(candidate.path)).body;
     const docLabel = projectDocLabel(candidate);
@@ -215,21 +213,21 @@ function prepareAgentsCandidate(candidate) {
         name: docLabel,
         'when-and-why-to-read': `When working in ${docLabel}, this knowledge should be read because it is the project's operating guide.`,
         'short-form': synthesizeShortForm(body),
-        'system-prompt-visibility': 'content',
+        'system-prompt-visibility': 'none',
         'file-read-visibility': 'content',
+        'applies-to': ['.'],
     };
     return {
         candidate,
         name: docLabel,
-        target: memoryFilePath(join(candidate.sourceDir, CRTR_DIR_NAME, 'memory'), 'AGENTS'),
+        target: memoryFilePath(join(candidate.sourceDir, CRTR_DIR_NAME, 'memory'), 'INDEX'),
         frontmatter,
         body,
     };
 }
 /** `.claude/rules/<name>.md` → `<sourceDir>/.crouter/memory/<name>.md`. A
- *  `paths:` rule becomes an `applies-to` glob trigger at none/content; a
- *  pathless rule is positional (surfaces like AGENTS.md on any read under its
- *  own project scope) at the same none/content rungs. */
+ *  `paths:` rule keeps its `applies-to` file globs at none/content; a pathless
+ *  rule receives `applies-to: "."` and surfaces when the workspace opens. */
 function prepareRuleCandidate(candidate) {
     const raw = readText(candidate.path);
     const parsed = parseFrontmatterGeneric(raw);
@@ -247,8 +245,7 @@ function prepareRuleCandidate(candidate) {
         'file-read-visibility': 'content',
     };
     const globs = normalizeRulePaths(fm['paths']);
-    if (globs.length > 0)
-        frontmatter['applies-to'] = globs;
+    frontmatter['applies-to'] = globs.length > 0 ? globs : ['.'];
     return {
         candidate,
         name,
@@ -299,7 +296,7 @@ function renderSummary(results) {
 export const sysSyncProjectGuidanceLeaf = defineLeaf({
     name: 'project-guidance',
     description: "migrate CLAUDE.md/AGENTS.md/.claude/rules into that directory's own crouter memory docs",
-    whenToUse: "migrating per-project CLAUDE.md/AGENTS.md/.claude/rules into the crouter memory-doc model: one-way copy into that same directory's OWN .crouter/memory/, so the doc travels with the repo and gets positional on-read for free. Never exports memory docs back to these files; crouter stops reading the originals unconditionally.",
+    whenToUse: "migrating per-project CLAUDE.md/AGENTS.md/.claude/rules into the crouter memory-doc model: one-way copy into that same directory's OWN .crouter/memory/. The project guide becomes its root INDEX front door; path-scoped rules keep their globs and pathless rules open with the workspace. Never exports memory docs back to these source files.",
     help: {
         name: 'sys sync project-guidance',
         summary: "one-way migration: CLAUDE.md/AGENTS.md/.claude/rules → that dir's own crouter memory docs",
@@ -316,7 +313,7 @@ export const sysSyncProjectGuidanceLeaf = defineLeaf({
         ],
         outputKind: 'object',
         effects: [
-            "Copies each discovered CLAUDE.md/AGENTS.md into <dir>/.crouter/memory/AGENTS.md at system-prompt-visibility/file-read-visibility content/content, and each .claude/rules/*.md into <dir>/.crouter/memory/<name>.md at none/content (applies-to set from the rule's paths: globs when present) — copy, not move; original files are left untouched.",
+            "Copies each discovered CLAUDE.md/AGENTS.md into <dir>/.crouter/memory/INDEX.md with an explicit project name at system-prompt-visibility none, file-read-visibility content, and applies-to `.`. Copies each .claude/rules/*.md into <dir>/.crouter/memory/<name>.md at none/content, using the source paths as applies-to globs or `.` when no paths are declared. Originals are left untouched.",
             'Skips existing memory docs unless --overwrite is present.',
             'With --dry-run: read-only; writes nothing.',
         ],

package/dist/core/__tests__/migration.test.js

@@ -7,12 +7,17 @@ import { fileURLToPath } from 'node:url';
 import { DatabaseSync } from 'node:sqlite';
 import { openDb, closeDb, migrate, MIGRATIONS } from '../canvas/db.js';
 import { canvasDbPath, ensureHome } from '../canvas/paths.js';
-import { CANVAS_EXTENSION_NAMES, customExtensionPaths } from '../canvas/extensions.js';
+import { customExtensionPaths } from '../canvas/extensions.js';
 import { updateNode } from '../canvas/canvas.js';
 import { spawn, spawnSync } from 'node:child_process';
 const HERE = dirname(fileURLToPath(import.meta.url));
 const RUNTIME_COLUMNS = ['intent', 'pi_pid', 'window', 'tmux_session'];
 const RACE_FIXTURE = join(HERE, 'fixtures', 'metadata-migration-race.ts');
+const PRE_TOOL_GUIDE_CANVAS_EXTENSION_NAMES = [
+    'canvas-inbox-watcher', 'canvas-stophook', 'canvas-recap',
+    'canvas-goal-capture', 'canvas-passive-context', 'canvas-context-intro',
+    'canvas-doc-substrate', 'canvas-structured-output', 'canvas-bash-valve',
+];
 let home;
 async function waitForPath(path) {
     for (;;) {
@@ -76,7 +81,7 @@ test('a v14 canvas normalizes historical canvas paths while retaining custom lau
         node_id: 'saved', name: 'saved', created: '2026-01-01T00:00:00.000Z', cwd: '/tmp',
         kind: 'developer', mode: 'base', lifecycle: 'terminal', status: 'idle',
         launch: { extensions: [
-                ...CANVAS_EXTENSION_NAMES.map((name) => `/old-generation/pi-extensions/${name}.js`),
+                ...PRE_TOOL_GUIDE_CANVAS_EXTENSION_NAMES.map((name) => `/old-generation/pi-extensions/${name}.js`),
                 '/plugins/canvas-inbox-watcher.js',
             ] },
     }));
@@ -102,7 +107,7 @@ test('a v14 migration is protected against concurrent writeback by normal update
         lifecycle: 'terminal',
         status: 'idle',
         launch: {
-            extensions: [...CANVAS_EXTENSION_NAMES.map((name) => `/old-generation/pi-extensions/${name}.js`), '/plugins/canvas-inbox-watcher.js'],
+            extensions: [...PRE_TOOL_GUIDE_CANVAS_EXTENSION_NAMES.map((name) => `/old-generation/pi-extensions/${name}.js`), '/plugins/canvas-inbox-watcher.js'],
         },
     }));
     ensureHome();

package/dist/core/__tests__/on-read-crouter-home-fence.test.js

@@ -1,12 +1,8 @@
-// The on-read POSITIONAL walk must never treat the crouter home (`~/.crouter`,
-// the user scope root) as a project ancestor. Canvas runtime artifacts live at
-// `~/.crouter/canvas/nodes/<id>/{reports,context}/...`, so a naive ancestor
-// walk from such a read climbs THROUGH `~/.crouter` and would inject whatever
-// lives at `~/.crouter/.crouter/memory/` — e.g. a differently-scoped node whose
-// cwd resolved its private project store there. That leaks one node's private
-// memory into every unrelated node that reads a canvas file. This test pins the
-// fence: reading a canvas artifact must not surface a store nested in the
-// crouter home.
+// Explicit file-context discovery never treats the crouter home
+// (`~/.crouter`, the user scope root) as a project ancestor. Canvas runtime
+// artifacts live below that root, while a nested `~/.crouter/.crouter/memory/`
+// store can belong to a differently scoped node. The user-root fence keeps its
+// explicitly routed docs out of unrelated canvas-file reads.
 //
 // Run: node --import tsx/esm --test src/core/__tests__/on-read-crouter-home-fence.test.ts
 import { test, before, beforeEach, after } from 'node:test';
@@ -54,7 +50,8 @@ test('a store nested in the crouter home does not leak into a canvas-artifact re
     mkdirSync(leakedStore, { recursive: true });
     writeFileSync(join(leakedStore, 'private-thing.md'), '---\nkind: knowledge\n' +
         "when-and-why-to-read: When X, read this because Y.\n" +
-        'file-read-visibility: content\n---\n' +
+        'file-read-visibility: content\n' +
+        'applies-to: "**/*.md"\n---\n' +
         'PRIVATE ASSISTANT MEMORY MUST NOT LEAK\n');
     // A canvas runtime artifact under the crouter home — the shape of every node
     // report/context file the harness auto-reads.