npm - @north-light/crouter - Versions diffs - 0.3.231 → 0.3.233 - Mend

@north-light/crouter 0.3.231 → 0.3.233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (187) hide show

package/dist/api/client.d.ts +3 -1
package/dist/api/client.js +4 -0
package/dist/api/dto/canvas.d.ts +10 -0
package/dist/api/dto/common.d.ts +1 -1
package/dist/api/dto/health.d.ts +2 -1
package/dist/api/dto/lifecycle.d.ts +3 -4
package/dist/api/dto/messages.d.ts +5 -4
package/dist/api/dto/nodes.d.ts +2 -0
package/dist/api/dto/profiles.d.ts +5 -0
package/dist/api/routes.d.ts +1 -0
package/dist/api/routes.js +1 -0
package/dist/builtin-memory/00-runtime-base/00-authoring.md +8 -0
package/dist/builtin-memory/00-runtime-base/01-escalation.md +1 -1
package/dist/builtin-memory/01-spine/00-has-manager.md +1 -1
package/dist/builtin-memory/02-turn-lifecycle/00-ending-a-turn.md +5 -0
package/dist/builtin-memory/02-turn-lifecycle/02-resident.md +5 -3
package/dist/builtin-memory/04-orchestration-kernel.md +2 -2
package/dist/builtin-memory/insights/capture.md +3 -2
package/dist/builtin-memory/internal/memory-loading.md +4 -3
package/dist/builtin-pi-packages/pi-crtr-extensions/README.md +6 -1
package/dist/clients/attach/render/diagram.js +13 -5
package/dist/clients/attach/render/page-block.d.ts +0 -1
package/dist/clients/attach/render/page-block.js +4 -57
package/dist/clients/attach/viewer.js +570 -563
package/dist/clients/inbox/__tests__/integration/inbox-controller.test.js +9 -0
package/dist/clients/inbox/__tests__/integration/mount-panel.test.js +62 -1
package/dist/clients/inbox/controller.d.ts +10 -0
package/dist/clients/inbox/controller.js +56 -12
package/dist/clients/inbox/tui/input.js +38 -10
package/dist/clients/inbox/tui/page-body.d.ts +10 -0
package/dist/clients/inbox/tui/page-body.js +66 -0
package/dist/clients/inbox/tui/panel.js +6 -4
package/dist/clients/inbox/tui/render.js +89 -17
package/dist/clients/inbox/tui/types.d.ts +4 -4
package/dist/commands/__tests__/human.test.js +18 -3
package/dist/commands/__tests__/node-message.test.js +3 -3
package/dist/commands/api-client.js +1 -7
package/dist/commands/canvas-config.js +6 -14
package/dist/commands/canvas-use.js +4 -6
package/dist/commands/cron.js +16 -22
package/dist/commands/human/prompts.d.ts +1 -1
package/dist/commands/human/prompts.js +118 -112
package/dist/commands/human/request.js +13 -14
package/dist/commands/human/review.js +3 -4
package/dist/commands/human/shared.d.ts +6 -0
package/dist/commands/human/shared.js +43 -5
package/dist/commands/human.js +1 -1
package/dist/commands/memory/delete.js +4 -6
package/dist/commands/memory/edit.js +0 -4
package/dist/commands/memory/move.js +3 -5
package/dist/commands/memory/shared.d.ts +1 -1
package/dist/commands/memory/shared.js +11 -7
package/dist/commands/memory/write.js +60 -29
package/dist/commands/memory.js +1 -1
package/dist/commands/node/bash.js +6 -9
package/dist/commands/node/create.js +89 -22
package/dist/commands/node/inspect.js +3 -3
package/dist/commands/node/lifecycle.js +30 -27
package/dist/commands/node/message.js +24 -45
package/dist/commands/node/subscription.js +6 -15
package/dist/commands/node/wait.js +2 -3
package/dist/commands/node-lifecycle-revive.js +1 -12
package/dist/commands/pkg/browse/actions.js +2 -3
package/dist/commands/pkg/market-manage.js +2 -5
package/dist/commands/pkg/plugin-manage.js +7 -8
package/dist/commands/profile/default.js +5 -5
package/dist/commands/profile/delete.js +1 -1
package/dist/commands/profile/env.js +9 -15
package/dist/commands/profile/kind.js +3 -7
package/dist/commands/profile/meta.js +3 -5
package/dist/commands/profile/new.js +0 -6
package/dist/commands/profile/pause.js +4 -8
package/dist/commands/profile/project.js +5 -9
package/dist/commands/profile/rename.js +3 -7
package/dist/commands/profile/show.js +3 -3
package/dist/commands/profile.js +4 -3
package/dist/commands/surface-tmux-spread.js +1 -3
package/dist/commands/sys/config.js +3 -4
package/dist/commands/sys/support/prepare.js +8 -4
package/dist/commands/sys/support/submit.js +2 -3
package/dist/commands/sys/sync-deps.js +1 -9
package/dist/commands/sys/sync-project-guidance.js +1 -7
package/dist/commands/sys/sync-skills.js +1 -11
package/dist/core/__tests__/cron-node-sink-parked-root.test.d.ts +1 -0
package/dist/core/__tests__/cron-node-sink-parked-root.test.js +147 -0
package/dist/core/__tests__/history-inbox.test.js +11 -1
package/dist/core/__tests__/human-deliver.test.js +2 -1
package/dist/core/__tests__/integration/command-plugins.test.js +0 -1
package/dist/core/__tests__/integration/deferred-no-wake.test.js +0 -1
package/dist/core/__tests__/lifecycle.test.js +30 -2
package/dist/core/__tests__/revive-parked-fresh.test.d.ts +1 -0
package/dist/core/__tests__/revive-parked-fresh.test.js +109 -0
package/dist/core/__tests__/seam/dormancy-release.test.js +32 -5
package/dist/core/canvas/attention.d.ts +2 -0
package/dist/core/canvas/attention.js +25 -18
package/dist/core/canvas/extensions.d.ts +1 -1
package/dist/core/canvas/extensions.js +7 -1
package/dist/core/canvas/history.js +20 -2
package/dist/core/canvas/types.d.ts +1 -1
package/dist/core/command.js +33 -8
package/dist/core/help.d.ts +28 -2
package/dist/core/help.js +46 -10
package/dist/core/human/__tests__/page-html-markdown.test.d.ts +1 -0
package/dist/core/human/__tests__/page-html-markdown.test.js +48 -0
package/dist/core/human/component-docs.js +4 -4
package/dist/core/human/page-html-markdown.d.ts +8 -0
package/dist/core/human/page-html-markdown.js +260 -0
package/dist/core/memory/lint.d.ts +15 -0
package/dist/core/memory/lint.js +150 -90
package/dist/core/profiles/__tests__/fuzzy-match.test.d.ts +1 -0
package/dist/core/profiles/__tests__/fuzzy-match.test.js +51 -0
package/dist/core/profiles/fuzzy-match.d.ts +19 -0
package/dist/core/profiles/fuzzy-match.js +92 -0
package/dist/core/profiles/manifest.d.ts +14 -7
package/dist/core/profiles/manifest.js +62 -12
package/dist/core/profiles/select.d.ts +3 -1
package/dist/core/profiles/select.js +5 -3
package/dist/core/profiles/state-block.js +4 -3
package/dist/core/runtime/boot-root.d.ts +3 -2
package/dist/core/runtime/canvas-extensions.d.ts +7 -1
package/dist/core/runtime/canvas-extensions.js +8 -1
package/dist/core/runtime/lifecycle.d.ts +11 -2
package/dist/core/runtime/lifecycle.js +15 -2
package/dist/core/runtime/model-selection.d.ts +4 -0
package/dist/core/runtime/model-selection.js +5 -0
package/dist/core/runtime/nodes.js +5 -0
package/dist/core/runtime/reopen.d.ts +6 -0
package/dist/core/runtime/reopen.js +12 -1
package/dist/core/runtime/revive.d.ts +6 -0
package/dist/core/runtime/revive.js +22 -2
package/dist/core/runtime/spawn.d.ts +5 -2
package/dist/core/runtime/spawn.js +18 -32
package/dist/core/runtime/structured-output.d.ts +6 -0
package/dist/core/runtime/structured-output.js +6 -0
package/dist/core/substrate/__tests__/surface-match-command.test.d.ts +1 -0
package/dist/core/substrate/__tests__/surface-match-command.test.js +89 -0
package/dist/core/substrate/__tests__/surface-match-pre-command.test.d.ts +1 -0
package/dist/core/substrate/__tests__/surface-match-pre-command.test.js +92 -0
package/dist/core/substrate/frontmatter-validation.js +1 -1
package/dist/core/substrate/injected-store.d.ts +6 -0
package/dist/core/substrate/injected-store.js +24 -0
package/dist/core/substrate/on-read.d.ts +17 -1
package/dist/core/substrate/on-read.js +38 -3
package/dist/core/substrate/schema.d.ts +3 -3
package/dist/core/substrate/schema.js +4 -4
package/dist/core/substrate/surface-match.d.ts +19 -0
package/dist/core/substrate/surface-match.js +224 -12
package/dist/core/termrender/version.d.ts +1 -1
package/dist/core/termrender/version.js +1 -1
package/dist/core/user-settings.js +1 -1
package/dist/daemon/api/__tests__/broker-settle-park.test.d.ts +1 -0
package/dist/daemon/api/__tests__/broker-settle-park.test.js +102 -0
package/dist/daemon/api/__tests__/canvas-snapshot-fields.test.d.ts +1 -0
package/dist/daemon/api/__tests__/canvas-snapshot-fields.test.js +188 -0
package/dist/daemon/api/__tests__/node-create-description.test.d.ts +1 -0
package/dist/daemon/api/__tests__/node-create-description.test.js +83 -0
package/dist/daemon/api/__tests__/profile-metadata-route.test.d.ts +1 -0
package/dist/daemon/api/__tests__/profile-metadata-route.test.js +92 -0
package/dist/daemon/api/__tests__/reopen-delivery.test.d.ts +1 -0
package/dist/daemon/api/__tests__/reopen-delivery.test.js +173 -0
package/dist/daemon/api/handlers/broker-ops.js +21 -0
package/dist/daemon/api/handlers/canvas.js +10 -0
package/dist/daemon/api/handlers/messages.js +25 -16
package/dist/daemon/api/handlers/nodes.js +5 -0
package/dist/daemon/api/handlers/profiles.js +22 -1
package/dist/daemon/cron-run.js +19 -1
package/dist/daemon/manage.d.ts +16 -1
package/dist/daemon/manage.js +20 -1
package/dist/daemon/park-pending.d.ts +13 -0
package/dist/daemon/park-pending.js +42 -0
package/dist/daemon/reconcilers/broker-supervision.d.ts +13 -0
package/dist/daemon/reconcilers/broker-supervision.js +139 -21
package/dist/daemon/reconcilers/live-obligation.d.ts +10 -4
package/dist/daemon/reconcilers/live-obligation.js +7 -3
package/dist/daemon/reconcilers/storage-maintenance.d.ts +0 -4
package/dist/daemon/reconcilers/storage-maintenance.js +1 -33
package/dist/pi-extensions/__tests__/pre-command-gate.test.d.ts +1 -0
package/dist/pi-extensions/__tests__/pre-command-gate.test.js +220 -0
package/dist/pi-extensions/canvas-doc-substrate.d.ts +14 -0
package/dist/pi-extensions/canvas-doc-substrate.js +75 -2
package/dist/pi-extensions/canvas-prompt-scrub.d.ts +13 -0
package/dist/pi-extensions/canvas-prompt-scrub.js +53 -0
package/dist/shared/generated-context.d.ts +7 -0
package/dist/shared/generated-context.js +11 -0
package/package.json +4 -4
package/runtime.lock.json +2 -2
package/dist/builtin-pi-packages/pi-crtr-extensions/extensions/strip-skills-docs.ts +0 -47

package/dist/clients/inbox/__tests__/integration/inbox-controller.test.js CHANGED Viewed

@@ -61,6 +61,15 @@ try {
     preview.activate();
     assert.match(preview.render().join('\n'), /chart — bar: day vs count/, 'a page uses the manifest-backed terminal projection');
     preview.close();
+    // The list preview shows what the page says, because `s` settles the selected
+    // ticket from this screen without ever opening it.
+    submitPage({ dir: ticketDir('preview-page'), sourceFile: ask, delivery: inboxDelivery });
+    const listing = controller({ cols: 100, rows: 40 });
+    const shown = listing.render().join('\n');
+    assert.match(shown, /Pick one to continue/, 'the preview carries the question body');
+    assert.match(shown, /Yes/, 'the preview carries the options the reader would pick from');
+    assert.doesNotMatch(shown, /\d+ components?\b/, 'the component count no longer stands in for the content');
+    listing.close();
 }
 finally {
     server.closeAllConnections();

package/dist/clients/inbox/__tests__/integration/mount-panel.test.js CHANGED Viewed

@@ -44,6 +44,20 @@ const displayPanel = mountPanel({ manifest: manifest([]), cols: 80, rows: 24, on
 displayPanel.handleKey('q', key());
 assert.deepEqual(displayResponses, {});
 displayPanel.unmount();
+// An HTML page has no slots to carry its content, so the document itself is
+// projected into the panel — dismissing it with q means the reader saw it.
+const html = manifest([], { dialect: 'html', title: 'Deploy sign-off', document: 'page.html' });
+const htmlDoc = '<html><body><h1>Deploy sign-off</h1><p>Staging is green for <strong>6 hours</strong>.</p><ul><li>Smoke suite passed</li></ul></body></html>';
+const htmlPanel = mountPanel({ manifest: html, document: htmlDoc, cols: 80, rows: 24 });
+const htmlView = htmlPanel.render().join('\n');
+assert.match(htmlView, /Staging is green for/);
+assert.match(htmlView, /Smoke suite passed/);
+assert.match(htmlView, /q.*dismiss/);
+htmlPanel.unmount();
+// An HTML page whose document never arrived says so rather than showing a bare title.
+const blindPanel = mountPanel({ manifest: html, cols: 80, rows: 24 });
+assert.match(blindPanel.render().join('\n'), /open in Northlight to read this/);
+blindPanel.unmount();
 // A single-slot page opens straight in item-review.
 const lone = manifest([{ id: 'only', kind: 'options', step: 0, config: { label: 'Pick one', mode: 'single', options: [{ id: 'a', label: 'Alpha' }] } }]);
 const lonePanel = mountPanel({ manifest: lone, cols: 80, rows: 24 });
@@ -55,11 +69,22 @@ let unvalidatedResponses;
 const unvalidatedPanel = mountPanel({ manifest: unvalidated, cols: 80, rows: 24, productKinds: [{ kind: 'acme.widget' }], onComplete: (r) => { unvalidatedResponses = r; } });
 unvalidatedPanel.handleKey('c', key());
 assert.equal(unvalidatedPanel.getInputBuffer(), undefined);
+// The item screen names the route out instead of dead-ending on a submit gate
+// that cannot open.
+assert.match(unvalidatedPanel.render().join('\n'), /the terminal cannot submit/);
+assert.match(unvalidatedPanel.render().join('\n'), /q leaves it in your inbox/);
 unvalidatedPanel.handleKey('n', key());
-assert.match(unvalidatedPanel.render().join('\n'), /must be answered in Northlight/);
 unvalidatedPanel.handleKey('', enter);
 assert.equal(unvalidatedResponses, undefined);
 unvalidatedPanel.unmount();
+const mixed = manifest([
+    { id: 'widget', kind: 'acme.widget', step: 0, config: {}, unvalidated: true },
+    { id: 'choice', kind: 'options', step: 0, config: { mode: 'single', options: [{ id: 'a', label: 'Alpha' }] } },
+]);
+// The overview says the same before the reader answers anything else.
+const mixedPanel = mountPanel({ manifest: mixed, cols: 80, rows: 24, productKinds: [{ kind: 'acme.widget' }] });
+assert.match(mixedPanel.render().join('\n'), /This page must be answered in Northlight/);
+mixedPanel.unmount();
 // Overview groups slots by step, without adding a progression gate.
 const stepped = manifest([
     { id: 'one', kind: 'options', step: 0, config: { mode: 'single', options: [{ id: 'a', label: 'Alpha' }] } },
@@ -71,4 +96,40 @@ assert.match(overview, /Test page/);
 assert.match(overview, /Step 1\/2/);
 assert.match(overview, /Step 2\/2/);
 steppedPanel.unmount();
+// A page taller than the pane scrolls on overview and on the summary; before
+// this, only item-review moved its window, so a long page was truncated with no
+// key that could reach the rest of it.
+const long = manifest(Array.from({ length: 30 }, (_v, i) => ({ id: `q${i}`, kind: 'options', step: 0, config: { label: `Question ${i}`, mode: 'single', options: [{ id: 'a', label: 'Alpha' }] } })));
+const longPanel = mountPanel({ manifest: long, cols: 80, rows: 24 });
+assert.doesNotMatch(longPanel.render().join('\n'), /Question 29/);
+for (let i = 0; i < 5; i++)
+    longPanel.handleKey('d', key());
+assert.match(longPanel.render().join('\n'), /Question 29/);
+longPanel.handleKey('u', key());
+assert.match(longPanel.render().join('\n'), /Question 2\b/);
+// j/k keeps steering the selection, and the window follows it rather than
+// letting the cursor wander off screen.
+for (let i = 0; i < 29; i++)
+    longPanel.handleKey('j', key());
+assert.match(longPanel.render().join('\n'), /Question 29/);
+// The key hints hold the bottom row instead of scrolling away with the content,
+// and carry the position badge that says there is more to scroll to.
+const plain = (line) => line.replace(/\x1b\[[0-9;]*m/g, '');
+const lastRow = () => plain(longPanel.render().at(-1) ?? '');
+for (let i = 0; i < 20; i++)
+    longPanel.handleKey('u', key());
+assert.match(lastRow(), /j\/k navigate/);
+assert.match(lastRow(), /▾ 1–\d+\/\d+/);
+assert.doesNotMatch(lastRow(), /▴/);
+for (let i = 0; i < 20; i++)
+    longPanel.handleKey('d', key());
+assert.match(lastRow(), /j\/k navigate/);
+assert.match(lastRow(), /▴/);
+assert.doesNotMatch(lastRow(), /▾/);
+longPanel.unmount();
+// A page shorter than the pane keeps its hints and shows no position badge.
+const shortPanel = mountPanel({ manifest: manifest([{ id: 'only', kind: 'options', step: 0, config: { label: 'Pick one', mode: 'single', options: [{ id: 'a', label: 'Alpha' }] } }]), cols: 80, rows: 24 });
+assert.match(plain(shortPanel.render().at(-1) ?? ''), /q close/);
+assert.doesNotMatch(shortPanel.render().join('\n'), /[▴▾]/);
+shortPanel.unmount();
 console.log('OK');

package/dist/clients/inbox/controller.d.ts CHANGED Viewed

@@ -39,6 +39,9 @@ export declare class InboxController {
     private heartbeat;
     private started;
     private closed;
+    /** The selected page's projected body, kept across frames because building it
+     *  reads and evaluates the page document. Keyed by what changes it. */
+    private preview;
     constructor(options: InboxControllerOptions);
     snapshot(): {
         items: TicketSummary[];
@@ -74,6 +77,13 @@ export declare class InboxController {
     private focusAvailable;
     /** Ask the host to bring the selected ticket's node viewer into view. */
     private focusSelectedSource;
+    /** What the selected page actually says, projected once per document and
+     *  kept until the document, the selection, or the pane width changes — the
+     *  projection reads the ticket from disk and evaluates it. */
+    private pagePreviewBody;
+    /** The read-only preview beside the list. It shows the page's own content,
+     *  because `s` settles the selected ticket from here without ever opening
+     *  it — a reader must not answer something they were never shown. */
     private passiveDetailLines;
     private withStatus;
     private markDirty;

package/dist/clients/inbox/controller.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { watch } from 'node:fs';
+import { statSync, watch } from 'node:fs';
 import { renderMarkdown } from '../../core/termrender/termrender.js';
 import { BOLD, CYAN, DIM, GRAY, RESET, YELLOW, clipLine } from './tui/ansi.js';
 import { buildInboxLines, recommendedLabel } from './tui.js';
@@ -8,7 +8,10 @@ import { resolvePageComponents } from '../../core/config.js';
 import { watchInboxActivity } from '../../core/human/root.js';
 import { claimTicket, heartbeatClaim, releaseClaim } from '../../core/human/claim.js';
 import { readPageTicket, readTicketResult } from '../../core/human/tickets.js';
-import { clearProgress } from '../../core/human/convention.js';
+import { clearProgress, pagePath } from '../../core/human/convention.js';
+import { projectPageDisplayMarkdown } from '../../core/human/page-markdown.js';
+import { projectHtmlDocumentMarkdown } from '../../core/human/page-html-markdown.js';
+import { pageBodyLines } from './tui/page-body.js';
 import { PageAdapter } from './page-adapter.js';
 import { ReviewAdapter } from './review-adapter.js';
 import { editBufferInEditor } from './review/roundtrip.js';
@@ -36,6 +39,9 @@ export class InboxController {
     heartbeat;
     started = false;
     closed = false;
+    /** The selected page's projected body, kept across frames because building it
+     *  reads and evaluates the page document. Keyed by what changes it. */
+    preview;
     constructor(options) {
         this.options = options;
         this.host = options.host;
@@ -400,7 +406,7 @@ export class InboxController {
             return this.adapter.render();
         const selected = this.items[this.selectedIndex];
         if (selected === undefined)
-            return this.passiveDetailLines(width).slice(0, rows);
+            return this.passiveDetailLines(width, rows);
         const focusHint = this.focusAvailable(selected.dir) ? `  ${DIM}g${RESET} chat` : '';
         const sendHint = selected.kind === 'page' && selected.fastAction !== undefined
             ? `  ${DIM}s${RESET} ${selected.fastAction.kind === 'acknowledge' ? 'acknowledge' : 'send recommended'}`
@@ -408,7 +414,12 @@ export class InboxController {
         const footer = selected.kind === 'page'
             ? [`  ${DIM}Enter${RESET} opens the full page  ${DIM}j/k${RESET} select${sendHint}  ${DIM}x${RESET} cancel`, `  ${DIM}Page:${RESET} c comment  u/d scroll${focusHint}  ${DIM}q${RESET} close`]
             : [`  ${DIM}Enter${RESET} opens the full review  ${DIM}j/k${RESET} select  ${DIM}x${RESET} cancel`, ` ${focusHint}  ${DIM}q${RESET} close`];
-        const preview = this.passiveDetailLines(width).slice(0, Math.max(0, rows - footer.length));
+        // The hints hold the bottom of the pane rather than trailing the preview,
+        // so they stay in one place as the preview grows and shrinks.
+        const room = Math.max(0, rows - footer.length);
+        const preview = this.passiveDetailLines(width, room);
+        while (preview.length < room)
+            preview.push('');
         return [...preview, ...footer.map((line) => clipLine(line, width))];
     }
     focusAvailable(_dir) {
@@ -433,20 +444,53 @@ export class InboxController {
             this.focusingSource = false;
         }
     }
-    passiveDetailLines(width) {
+    /** What the selected page actually says, projected once per document and
+     *  kept until the document, the selection, or the pane width changes — the
+     *  projection reads the ticket from disk and evaluates it. */
+    pagePreviewBody(item, width) {
+        let stamp;
+        try {
+            stamp = String(statSync(pagePath(item.dir, item.dialect)).mtimeMs);
+        }
+        catch {
+            stamp = 'missing';
+        }
+        const cached = this.preview;
+        if (cached !== undefined && cached.dir === item.dir && cached.width === width && cached.stamp === stamp)
+            return cached.lines;
+        let lines = [];
+        try {
+            const ticket = readPageTicket(item.dir);
+            const display = ticket.manifest.dialect === 'html'
+                ? projectHtmlDocumentMarkdown(ticket.document)
+                : projectPageDisplayMarkdown(ticket.document, ticket.manifest);
+            lines = pageBodyLines(ticket.manifest, display, Math.min(Math.max(20, width - 4), 100), Math.max(20, width - 4));
+        }
+        catch { /* a half-written or removed ticket previews as its title alone */ }
+        this.preview = { dir: item.dir, width, stamp, lines };
+        return lines;
+    }
+    /** The read-only preview beside the list. It shows the page's own content,
+     *  because `s` settles the selected ticket from here without ever opening
+     *  it — a reader must not answer something they were never shown. */
+    passiveDetailLines(width, rows) {
         const selected = this.items[this.selectedIndex];
         if (selected === undefined)
             return [`  ${DIM}Select a pending interaction.${RESET}`];
         const lines = [`  ${BOLD}${CYAN}${selected.title}${RESET}`, ''];
         for (const rendered of renderMarkdown(selected.subtitle, Math.max(1, width - 2)))
             lines.push(`  ${rendered}`);
-        const count = selected.kind === 'page'
-            ? `${selected.slotKinds.length} component${selected.slotKinds.length === 1 ? '' : 's'}`
-            : '1 file to review';
-        lines.push('', `  ${DIM}${count}${RESET}`);
-        if (selected.kind === 'page' && selected.dialect === 'html')
-            lines.push(`  ${DIM}HTML pages render in a browser surface${RESET}`);
-        return lines.map((line) => clipLine(line, width));
+        const body = selected.kind === 'page' ? this.pagePreviewBody(selected, width) : [`${DIM}1 file to review${RESET}`];
+        if (body.length > 0) {
+            lines.push('');
+            const room = Math.max(0, rows - lines.length);
+            const shown = body.length <= room ? body : body.slice(0, Math.max(0, room - 1));
+            for (const line of shown)
+                lines.push(`  ${line}`);
+            if (shown.length < body.length)
+                lines.push(`  ${DIM}… +${body.length - shown.length} more lines${RESET}`);
+        }
+        return lines.map((line) => clipLine(line, width)).slice(0, Math.max(1, rows));
     }
     withStatus(lines) {
         const status = this.cancelConfirmation === undefined

package/dist/clients/inbox/tui/input.js CHANGED Viewed

@@ -20,11 +20,36 @@ export function handleKeypress(input, key, state, render, exit) {
     else
         handleFinal(input, key, state, render, exit);
 }
+/** The one vertical-scroll gesture, shared by all three page screens: a long
+ *  page must be readable wherever its content sits, and every screen draws its
+ *  content into the same windowed rectangle. Each screen clamps the offset
+ *  against its own rendered length at draw time, so this only ever moves it. */
+function scrollKey(input, key, state) {
+    if (input === 'd' || key.pageDown || (key.ctrl && (input === 'd' || input === 'e'))) {
+        state.scrollOffset += input === 'e' ? 1 : 10;
+        state.followSelection = false;
+        return true;
+    }
+    if (input === 'u' || key.pageUp || (key.ctrl && (input === 'u' || input === 'y'))) {
+        state.scrollOffset = Math.max(0, state.scrollOffset - (input === 'y' ? 1 : 10));
+        state.followSelection = false;
+        return true;
+    }
+    return false;
+}
 function handleOverview(input, key, state, render, exit) {
-    if (input === 'j' || key.downArrow)
+    if (scrollKey(input, key, state)) {
+        render();
+        return;
+    }
+    if (input === 'j' || key.downArrow) {
         state.currentIndex = Math.min(state.currentIndex + 1, Math.max(0, state.slots.length - 1));
-    else if (input === 'k' || key.upArrow)
+        state.followSelection = true;
+    }
+    else if (input === 'k' || key.upArrow) {
         state.currentIndex = Math.max(state.currentIndex - 1, 0);
+        state.followSelection = true;
+    }
     else if ((key.return || input === ' ') && state.slots.length > 0) {
         state.phase = 'item-review';
         resetItem(state);
@@ -59,13 +84,7 @@ function handleItemReview(input, key, state, render, exit) {
         exit(false);
         return;
     }
-    if (input === 'd' || key.pageDown || (key.ctrl && (input === 'd' || input === 'e'))) {
-        state.scrollOffset += input === 'e' ? 1 : 10;
-        render();
-        return;
-    }
-    if (input === 'u' || key.pageUp || (key.ctrl && (input === 'u' || input === 'y'))) {
-        state.scrollOffset = Math.max(0, state.scrollOffset - (input === 'y' ? 1 : 10));
+    if (scrollKey(input, key, state)) {
         render();
         return;
     }
@@ -175,19 +194,28 @@ function handleFinal(input, key, state, render, exit) {
         render();
         return;
     }
+    if (scrollKey(input, key, state)) {
+        render();
+        return;
+    }
     if (key.return && (pageComplete(state) || !state.manifest.slots.some(isResponseBearingSlot)))
         exit(true);
 }
-function resetItem(state) { state.selectedAction = 0; state.scrollOffset = 0; state.hscrollOffset = 0; state.hscrollMax = 0; }
+function resetItem(state) { state.selectedAction = 0; state.scrollOffset = 0; state.followSelection = true; state.hscrollOffset = 0; state.hscrollMax = 0; }
 function advanceItem(state, delta) {
     const next = state.currentIndex + delta;
+    // Every phase reads the one scrollOffset, so entering a screen starts it at
+    // the top rather than inheriting how far the previous screen was scrolled.
     if (next < 0) {
         state.phase = state.slots.length > 1 ? 'overview' : 'item-review';
+        state.scrollOffset = 0;
+        state.followSelection = true;
         return;
     }
     if (next >= state.slots.length) {
         state.phase = 'final';
         state.scrollOffset = 0;
+        state.followSelection = true;
         return;
     }
     state.currentIndex = next;

package/dist/clients/inbox/tui/page-body.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+import type { PageManifest } from '../../../core/human/page-schema.js';
+/** What a page says, as terminal rows: the authored prose, then each question
+ *  with its own body and the choices it offers. One projection serves every
+ *  read-only view of a page — the inline transcript block and the inbox list's
+ *  preview — so a reader is never asked to settle a page from a summary that
+ *  showed them less than the page itself does.
+ *
+ *  `maxW` is the prose measure, `paneW` the full rectangle a wide block (a
+ *  table, a code fence) may use. Callers window or fold the result. */
+export declare function pageBodyLines(manifest: PageManifest, displayMarkdown: string, maxW: number, paneW: number): string[];

package/dist/clients/inbox/tui/page-body.js ADDED Viewed

@@ -0,0 +1,66 @@
+import { renderMarkdownBlockAwareLines } from '../../../core/termrender/termrender.js';
+import { describeSlot, tableMarkdown, terminalAnswerable } from './slots.js';
+import { BOLD, DIM, RESET, sanitize, singleLine, truncate, wrap } from './ansi.js';
+/** What a page says, as terminal rows: the authored prose, then each question
+ *  with its own body and the choices it offers. One projection serves every
+ *  read-only view of a page — the inline transcript block and the inbox list's
+ *  preview — so a reader is never asked to settle a page from a summary that
+ *  showed them less than the page itself does.
+ *
+ *  `maxW` is the prose measure, `paneW` the full rectangle a wide block (a
+ *  table, a code fence) may use. Callers window or fold the result. */
+export function pageBodyLines(manifest, displayMarkdown, maxW, paneW) {
+    const md = (text) => renderMarkdownBlockAwareLines(text, maxW, paneW);
+    // An HTML page carries no slots, so its projected document is the whole of
+    // what a terminal reader gets — a browser renders it, this one reads it.
+    if (manifest.dialect === 'html')
+        return displayMarkdown === '' ? [`${DIM}HTML page — open in Northlight to read this${RESET}`] : md(displayMarkdown);
+    const lines = displayMarkdown === '' ? [] : md(displayMarkdown);
+    let priorStep = -1;
+    for (const slot of manifest.slots) {
+        if (manifest.steps > 1 && slot.step !== priorStep) {
+            if (lines.length > 0)
+                lines.push('');
+            lines.push(`${BOLD}Step ${slot.step + 1}/${manifest.steps}${RESET}`);
+            priorStep = slot.step;
+        }
+        if (lines.length > 0)
+            lines.push('');
+        lines.push(`${BOLD}${truncate(sanitize(singleLine(describeSlot(slot))), maxW)}${RESET}`);
+        const body = slot.config.body;
+        if (typeof body === 'string' && body !== '')
+            lines.push(...md(body));
+        if (!terminalAnswerable(slot)) {
+            lines.push(`${DIM}${sanitize(slot.kind)} — open in Northlight to answer this${RESET}`);
+            continue;
+        }
+        if (slot.kind === 'text') {
+            lines.push(...md(slot.config.initialText));
+        }
+        else if (slot.kind === 'table') {
+            lines.push(...md(tableMarkdown(slot.config)));
+        }
+        else if (slot.kind === 'cards') {
+            for (const card of slot.config.cards ?? []) {
+                lines.push(`  • ${truncate(sanitize(singleLine(card.subtitle === undefined ? card.title : `${card.title} — ${card.subtitle}`)), Math.max(10, maxW - 4))}`);
+                if (card.body !== undefined)
+                    for (const line of wrap(sanitize(card.body), Math.max(10, maxW - 6)))
+                        lines.push(`    ${DIM}${line}${RESET}`);
+            }
+        }
+        else if (slot.kind === 'options') {
+            for (const option of slot.config.options) {
+                lines.push(`  • ${truncate(sanitize(singleLine(option.label)), Math.max(10, maxW - 4))}`);
+                if (option.description !== undefined)
+                    for (const line of wrap(sanitize(option.description), Math.max(10, maxW - 6)))
+                        lines.push(`    ${DIM}${line}${RESET}`);
+            }
+        }
+        else if (slot.kind === 'chart') {
+            const config = slot.config;
+            const title = config.title ?? `${config.x ?? ''} vs ${(config.y ?? []).map((y) => y.label ?? y.field).join(', ')}`;
+            lines.push(`${DIM}chart — ${sanitize(config.kind ?? 'chart')}: ${sanitize(title)}${RESET}`);
+        }
+    }
+    return lines;
+}

package/dist/clients/inbox/tui/panel.js CHANGED Viewed

@@ -1,15 +1,17 @@
 import { projectPageDisplayMarkdown } from '../../../core/human/page-markdown.js';
+import { projectHtmlDocumentMarkdown } from '../../../core/human/page-html-markdown.js';
 import { handleKeypress } from './input.js';
 import { clampItemReviewScroll, renderFinal, renderItemReview, renderOverview } from './render.js';
 import { pageComplete, slotAnswered } from './slots.js';
 /** Same projection the inline chat block reads (page-block.ts) — the authored
- *  prose outside slot tags. A malformed or unreadable document just yields no
+ *  prose outside slot tags, or the whole document for an HTML page, which has
+ *  no slots to carry it. A malformed or unreadable document just yields no
  *  display content here, same as the inline block's own reload() fallback. */
 function displayMarkdownOf(manifest, document) {
-    if (manifest.dialect !== 'jsx' || document === undefined)
+    if (document === undefined)
         return '';
     try {
-        return projectPageDisplayMarkdown(document, manifest);
+        return manifest.dialect === 'html' ? projectHtmlDocumentMarkdown(document) : projectPageDisplayMarkdown(document, manifest);
     }
     catch {
         return '';
@@ -26,7 +28,7 @@ function buildInitialState(manifest, document, initialResponses, productKinds, e
     // when there is no display prose to show first; otherwise that prose would
     // never be seen.
     const phase = manifest.slots.length === 1 && displayMarkdown === '' ? 'item-review' : 'overview';
-    const state = { phase, currentIndex: 0, manifest, displayMarkdown, slots: manifest.slots, responses, productKinds, inputMode: null, selectedAction: 0, bodyMode: 'question', scrollOffset: 0, bodyScrollOffsets: { question: 0 }, hscrollOffset: 0, hscrollMax: 0, wrapWidth, editorAvailable };
+    const state = { phase, currentIndex: 0, manifest, displayMarkdown, slots: manifest.slots, responses, productKinds, inputMode: null, selectedAction: 0, scrollOffset: 0, followSelection: true, hscrollOffset: 0, hscrollMax: 0, wrapWidth, editorAvailable };
     const first = manifest.slots.findIndex((slot) => slot.id !== undefined && !slotAnswered(state, slot));
     if (first >= 0)
         state.currentIndex = first;

package/dist/clients/inbox/tui/render.js CHANGED Viewed

@@ -39,11 +39,17 @@ export function renderOverview(state, cols, rows) {
         for (const line of mdLines(state.displayMarkdown, maxW, paneW))
             lines.push(`  ${line}`);
     }
+    else if (state.manifest.dialect === 'html') {
+        // An HTML page has no slots, so an unreadable document would otherwise
+        // leave the reader dismissing a title with nothing under it.
+        lines.push('', `  ${DIM}HTML page — open in Northlight to read this${RESET}`);
+    }
     const hasBody = state.slots.length > 0;
     if (hasBody)
         lines.push(`  ${DIM}${hline(maxW)}${RESET}`, '');
     const answer = pageAnswer(state);
     let priorStep = -1;
+    let cursorLine;
     for (let i = 0; i < state.slots.length; i++) {
         const slot = state.slots[i];
         if (state.manifest.steps > 1 && slot.step !== priorStep) {
@@ -55,16 +61,26 @@ export function renderOverview(state, cols, rows) {
         const response = slot.id === undefined ? undefined : state.responses.get(slot.id);
         const icon = isResponseBearingSlot(slot) ? (slotAnswered(state, slot) ? `${GREEN}✓${RESET}` : `${DIM}○${RESET}`) : `${DIM}·${RESET}`;
         const cursor = i === state.currentIndex ? `${CYAN}▸${RESET} ` : '  ';
+        if (i === state.currentIndex)
+            cursorLine = lines.length;
         lines.push(`  ${cursor}${icon} ${truncate(singleLine(describeSlot(slot)), Math.max(10, cols - 16))}`);
         if (response !== undefined)
             lines.push(`      ${DIM}${truncate(singleLine(answerSummary(answerSlot(answer, slot))), Math.max(10, cols - 10))}${RESET}`);
     }
+    // A page whose question the terminal cannot author can never be submitted
+    // here, so it says so on the way in rather than letting the reader answer
+    // everything else and meet a submit gate that never opens.
+    if (state.manifest.slots.some((slot) => isResponseBearingSlot(slot) && !terminalAnswerable(slot))) {
+        lines.push('');
+        for (const line of wrap('This page must be answered in Northlight. Leaving it here keeps it in your inbox; x on the list cancels it.', maxW - 2))
+            lines.push(`  ${YELLOW}${line}${RESET}`);
+    }
     if (hasBody)
         lines.push('');
     lines.push(`  ${DIM}${hline(maxW)}${RESET}`);
     const display = !state.manifest.slots.some(isResponseBearingSlot);
-    lines.push(display ? `  ${DIM}q${RESET} dismiss` : `  ${DIM}enter${RESET} review  ${DIM}j/k${RESET} navigate  ${DIM}q${RESET} close`);
-    return centeredWindow(lines, state, cols, rows, maxW + 2);
+    const footer = display ? `  ${DIM}u/d${RESET} scroll  ${DIM}q${RESET} dismiss` : `  ${DIM}enter${RESET} review  ${DIM}j/k${RESET} navigate  ${DIM}u/d${RESET} scroll  ${DIM}q${RESET} close`;
+    return centeredWindow(lines, footer, state, cols, rows, maxW + 2, state.followSelection ? cursorLine : undefined);
 }
 /** Wrap an input buffer and paint the cursor the way a terminal does: the
  *  character under it is drawn in reverse video, occupying its own cell rather
@@ -183,8 +199,12 @@ function itemLines(state, cols) {
         for (const line of mdLines(body, maxW, paneW))
             lines.push(`  ${line}`);
     }
-    if (!terminalAnswerable(slot))
-        lines.push('', `  ${DIM}${sanitize(slot.kind)} — cannot be answered in the terminal; open in Northlight${RESET}`);
+    if (!terminalAnswerable(slot)) {
+        lines.push('');
+        for (const line of wrap(`${sanitize(slot.kind)} — must be answered in Northlight; the terminal cannot submit this page`, Math.max(10, maxW - 2)))
+            lines.push(`  ${YELLOW}${line}${RESET}`);
+        lines.push(`  ${DIM}q leaves it in your inbox; x on the list cancels it${RESET}`);
+    }
     else if (slot.kind === 'chart') {
         const c = slot.config;
         const title = c.title ?? `${c.x} vs ${(c.y ?? []).map((y) => y.label ?? y.field).join(', ')}`;
@@ -206,12 +226,13 @@ function itemLines(state, cols) {
             lines.push(`  ${line}`);
     }
     lines.push('', `  ${DIM}${hline(maxW)}${RESET}`);
+    let footer;
     if (state.inputMode !== null) {
         const label = state.inputMode.kind === 'comment' ? `Comment on ${commentLabel(slot, state.inputMode.anchor)}` : state.inputMode.kind === 'text' ? 'Edit text' : 'Other response';
         lines.push(`  ${BOLD}${label}${RESET}`);
         for (const line of renderInputBuffer(state.inputMode.buffer, state.inputMode.cursor, Math.max(10, maxW - 4)))
             lines.push(`  ${line}`);
-        lines.push(`  ${DIM}enter save  esc cancel${state.editorAvailable ? '  ^o editor' : ''}${RESET}`);
+        footer = `  ${DIM}enter save  esc cancel${state.editorAvailable ? '  ^o editor' : ''}${RESET}`;
     }
     else {
         const actions = slotActions(slot);
@@ -234,10 +255,10 @@ function itemLines(state, cols) {
                 lines.push(`  ${DIM}${line}${RESET}`);
         if (state.hint)
             lines.push(`  ${YELLOW}${sanitize(state.hint)}${RESET}`);
-        lines.push(`  ${DIM}n/p next/previous  j/k actions${commentAnchors(slot).length > 0 ? '  c comment' : ''}  u/d scroll  h/l pan  q close${RESET}`);
+        footer = `  ${DIM}n/p next/previous  j/k actions${commentAnchors(slot).length > 0 ? '  c comment' : ''}  u/d scroll  h/l pan  q close${RESET}`;
     }
     const maxLine = Math.max(0, ...lines.map(visibleWidth));
-    return { lines, maxW, maxH: Math.max(0, maxLine - Math.max(1, cols)) };
+    return { lines, footer, maxW, maxH: Math.max(0, maxLine - Math.max(1, cols)) };
 }
 export function clampItemReviewScroll(state, cols, rows) {
     if (state.slots[state.currentIndex] === undefined) {
@@ -249,19 +270,25 @@ export function clampItemReviewScroll(state, cols, rows) {
     const layout = itemLines(state, cols);
     state.hscrollMax = layout.maxH;
     state.hscrollOffset = Math.max(0, Math.min(state.hscrollOffset, state.hscrollMax));
-    state.scrollOffset = Math.max(0, Math.min(state.scrollOffset, Math.max(0, layout.lines.length - rows)));
+    state.scrollOffset = Math.max(0, Math.min(state.scrollOffset, Math.max(0, layout.lines.length - bodyRows(rows))));
 }
 export function panItemReview(state, direction) {
     state.hscrollOffset = Math.max(0, Math.min(state.hscrollMax, state.hscrollOffset + direction * PAN_STEP));
 }
 export function renderItemReview(state, cols, rows) {
     const layout = itemLines(state, cols);
+    const body = bodyRows(rows);
     const start = state.scrollOffset;
-    const sliced = layout.lines.slice(start, start + rows);
-    while (sliced.length < rows)
+    const sliced = layout.lines.slice(start, start + body);
+    while (sliced.length < body)
         sliced.push('');
     const panned = state.hscrollOffset > 0 ? sliced.map((line) => panLine(line, state.hscrollOffset, cols)) : sliced;
-    return centerHorizontal(panned.map((line) => clipLine(line, cols)), cols, Math.min(cols, layout.maxW + 2));
+    const width = Math.min(cols, layout.maxW + 2);
+    // The key hints never pan: a horizontal pan moves the content the user is
+    // reading, not the controls they steer it with.
+    if (body < rows)
+        panned.push(pinnedFooter(layout.footer, scrollBadge(start, body, layout.lines.length), layout.maxW + 2));
+    return centerHorizontal(panned.map((line) => clipLine(line, cols)), cols, width);
 }
 export function renderFinal(state, cols, rows) {
     const maxW = Math.min(Math.max(20, cols - 4), 120);
@@ -283,14 +310,59 @@ export function renderFinal(state, cols, rows) {
                     lines.push(`  ${DIM}${slot.id} must be answered in Northlight${RESET}`);
             }
     }
-    lines.push('', `  ${DIM}${hline(maxW)}${RESET}`, complete ? `  ${DIM}enter${RESET} submit  ${DIM}q${RESET} back` : `  ${DIM}q${RESET} back`);
-    return centeredWindow(lines, state, cols, rows, maxW + 2);
+    lines.push('', `  ${DIM}${hline(maxW)}${RESET}`);
+    const footer = complete ? `  ${DIM}enter${RESET} submit  ${DIM}u/d${RESET} scroll  ${DIM}q${RESET} back` : `  ${DIM}u/d${RESET} scroll  ${DIM}q${RESET} back`;
+    return centeredWindow(lines, footer, state, cols, rows, maxW + 2);
+}
+/** Rows left for content once the pinned key-hint row is reserved. Below two
+ *  rows there is nothing to pin a footer against, so the whole pane is body. */
+function bodyRows(rows) { return rows >= 2 ? rows - 1 : rows; }
+/** How much of the content this window is showing, and which directions still
+ *  have more. Without it a long page looks like a short one: the scroll keys
+ *  exist but nothing says there is anything to scroll to. The arrow cells are
+ *  held even when empty so the badge does not change width as it moves. */
+function scrollBadge(offset, visibleRows, total) {
+    if (visibleRows <= 0 || total <= visibleRows)
+        return { marks: '', full: '' };
+    const end = Math.min(total, offset + visibleRows);
+    const marks = `${offset > 0 ? '▴' : ' '}${end < total ? '▾' : ' '}`;
+    return { marks: `${DIM}${marks}${RESET}`, full: `${DIM}${marks} ${offset + 1}–${end}/${total}${RESET}` };
 }
-function centeredWindow(lines, state, cols, rows, width) {
-    const max = Math.max(0, lines.length - rows);
+/** The key hints with the scroll badge trailing at the right edge of the
+ *  column. A row too narrow for both drops the counts and keeps the arrows,
+ *  and one too narrow even for those moves them ahead of the hints — the keys
+ *  themselves are never the thing that gets clipped away. */
+function pinnedFooter(footer, badge, width) {
+    if (badge.full === '')
+        return footer;
+    const room = (candidate) => width - visibleWidth(footer) - visibleWidth(candidate) - 2;
+    for (const candidate of [badge.full, badge.marks])
+        if (room(candidate) >= 2)
+            return `${footer}${' '.repeat(room(candidate))}${candidate}`;
+    return `  ${badge.marks} ${footer.trimStart()}`;
+}
+/** Window `lines` to the pane, clamping the shared scroll offset to what this
+ *  screen actually rendered, and pinning `footer` to the bottom row. The key
+ *  hints are durable controls, so they hold the same row instead of scrolling
+ *  out of reach with the content they describe. `focusLine`, when given, is a
+ *  row the user is steering with j/k, so the window is nudged to keep it on
+ *  screen — otherwise a long page lets the selection wander out of view while
+ *  it still moves. It is passed only while the window is following the
+ *  selection, so a window the user scrolled themselves is never dragged back. */
+function centeredWindow(lines, footer, state, cols, rows, width, focusLine) {
+    const body = bodyRows(rows);
+    const max = Math.max(0, lines.length - body);
     state.scrollOffset = Math.max(0, Math.min(state.scrollOffset, max));
-    const out = lines.slice(state.scrollOffset, state.scrollOffset + rows);
-    while (out.length < rows)
+    if (focusLine !== undefined && body > 0) {
+        if (focusLine < state.scrollOffset)
+            state.scrollOffset = focusLine;
+        else if (focusLine >= state.scrollOffset + body)
+            state.scrollOffset = Math.min(max, focusLine - body + 1);
+    }
+    const out = lines.slice(state.scrollOffset, state.scrollOffset + body);
+    while (out.length < body)
         out.push('');
+    if (body < rows)
+        out.push(pinnedFooter(footer, scrollBadge(state.scrollOffset, body, lines.length), width));
     return centerHorizontal(out.map((line) => clipLine(line, cols)), cols, Math.min(cols, width));
 }

package/dist/clients/inbox/tui/types.d.ts CHANGED Viewed

@@ -29,11 +29,11 @@ export interface TuiState {
     productKinds: ProductPageComponents;
     inputMode: InputMode;
     selectedAction: number;
-    bodyMode: 'question';
     scrollOffset: number;
-    bodyScrollOffsets: {
-        question: number;
-    };
+    /** Whether the overview window is following the j/k selection. Set by moving
+     *  the selection, cleared the moment the user scrolls the window themselves —
+     *  otherwise the follow would drag the window back on every manual scroll. */
+    followSelection: boolean;
     hscrollOffset: number;
     hscrollMax: number;
     wrapWidth: number;