@north-light/crouter 0.3.173 → 0.3.174

package/dist/commands/sys/__tests__/setup-core.test.js

@@ -1,277 +1,13 @@
+// Pure boundaries behind `crtr sys setup`: which pi CLI crouter launches, how a
+// failed provider login is classified, and how a concrete model reference maps
+// back onto a portable provider/strength selection.
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
+import { existsSync } from 'node:fs';
 import { resolveBundledPiCliPath } from '../../../core/runtime/pi-cli.js';
-import { BINDING_CATALOG, resolveKeybindings } from '../../../core/keybindings/index.js';
-import { SetupKeybindingsDraft, buildSetupManifest } from '../setup-core.js';
-import { SetupWizard, classifyLoginFailure } from '../setup-wizard.js';
-import { applyTheme } from '../../../clients/attach/config.js';
-import { createSetupRuntime } from './helpers/setup-runtime.js';
-import { stripVTControlCharacters } from 'node:util';
-// The provider panel only touches the TUI on async OAuth transitions (never in
-// these keybindings-tab render/input tests) and reads auth from `agentDir`; a
-// no-op TUI stub and an empty temp agent dir keep the wizard headless.
-const stubTui = { requestRender() { } };
-const agentDir = mkdtempSync(join(tmpdir(), 'setup-wizard-test-'));
-const { runtime, registry } = await createSetupRuntime(agentDir);
-test('setup keybinding draft edits, disables, resets, and discards transactionally', () => {
-    const draft = new SetupKeybindingsDraft({ 'crtr.attach.graph.toggle': ['alt+x'] });
-    assert.equal(draft.expression('crtr.attach.graph.toggle'), 'alt+x');
-    assert.equal(draft.dirty, false);
-    // M-U (not M-Y): alt+shift+y is now the crtr.attach.copy.message default, so
-    // the uppercase-normalization probe must use a gesture no catalog entry owns.
-    assert.equal(draft.edit('crtr.attach.graph.toggle', 'M-U, ctrl+g').ok, true);
-    assert.deepEqual(draft.overrides()['crtr.attach.graph.toggle'], ['alt+shift+u', 'ctrl+g']);
-    assert.equal(draft.dirty, true);
-    assert.equal(draft.unbind('crtr.attach.graph.toggle').ok, true);
-    assert.deepEqual(draft.overrides()['crtr.attach.graph.toggle'], []);
-    draft.resetRow('crtr.attach.graph.toggle');
-    assert.equal(Object.hasOwn(draft.overrides(), 'crtr.attach.graph.toggle'), false);
-    draft.edit('crtr.attach.graph.toggle', 'alt+y');
-    draft.discard();
-    assert.deepEqual(draft.overrides(), { 'crtr.attach.graph.toggle': ['alt+x'] });
-    assert.equal(draft.dirty, false);
-});
-test('setup keybinding draft binds the comma key, which doubles as the gesture separator', () => {
-    const draft = new SetupKeybindingsDraft(undefined);
-    // A comma with nothing on one side is the comma KEY, not a separator. Bound
-    // onto a menu selector whose default is NOT the comma (settings already
-    // defaults to it), so the draft records a real override.
-    assert.equal(draft.edit('crtr.tmux.menu.attach.whip', ',').ok, true);
-    assert.deepEqual(draft.overrides()['crtr.tmux.menu.attach.whip'], [',']);
-    // A list containing the comma key round-trips through the rendered expression.
-    assert.equal(draft.edit('crtr.attach.graph.toggle', ', , ctrl+g').ok, true);
-    assert.deepEqual(draft.overrides()['crtr.attach.graph.toggle'], [',', 'ctrl+g']);
-    assert.equal(draft.expression('crtr.attach.graph.toggle'), ',, ctrl+g');
-    assert.equal(draft.edit('crtr.attach.graph.toggle', ',, ctrl+g').ok, true);
-    assert.deepEqual(draft.overrides()['crtr.attach.graph.toggle'], [',', 'ctrl+g']);
-});
-test('setup keybinding draft drops a member when the committed value equals the catalog default (N2 sparseness)', () => {
-    const draft = new SetupKeybindingsDraft(undefined);
-    const definition = BINDING_CATALOG.find((entry) => entry.id === 'crtr.attach.graph.toggle');
-    const defaultExpression = draft.expression(definition.id);
-    // Committing the seeded default verbatim must NOT record an override: the row
-    // stays sparse (no member) and the draft stays clean — no spurious unsaved/dot.
-    const result = draft.edit(definition.id, defaultExpression);
-    assert.equal(result.ok, true);
-    assert.equal(Object.hasOwn(draft.overrides(), definition.id), false);
-    assert.equal(draft.dirty, false);
-    // Editing to a real value records the member; re-committing the default drops it.
-    assert.equal(draft.edit(definition.id, 'ctrl+g').ok, true);
-    assert.deepEqual(draft.overrides()[definition.id], ['ctrl+g']);
-    assert.equal(draft.dirty, true);
-    assert.equal(draft.edit(definition.id, defaultExpression).ok, true);
-    assert.equal(Object.hasOwn(draft.overrides(), definition.id), false);
-    assert.equal(draft.dirty, false);
-});
-test('setup keybinding draft keeps the last valid cell value on syntax, collision, and safety errors', () => {
-    const draft = new SetupKeybindingsDraft(undefined);
-    const syntax = draft.edit('crtr.attach.graph.toggle', 'ctrl+not-a-key');
-    assert.equal(syntax.ok, false);
-    assert.deepEqual(draft.overrides(), {});
-    const collision = draft.edit('crtr.attach.graph.toggle', 'alt+m');
-    assert.equal(collision.ok, false);
-    assert.match(collision.diagnostics[0].message, /crtr\.attach\.model-ladder\.next/);
-    assert.deepEqual(draft.overrides(), {});
-    const unsafe = draft.unbind('crtr.setup.keybindings.save');
-    assert.equal(unsafe.ok, false);
-    assert.match(unsafe.diagnostics[0].message, /save-keybindings/);
-    assert.deepEqual(draft.overrides(), {});
-});
-test('setup reset-all removes invalid and unknown raw members without cataloging pi bindings', () => {
-    const invalidRoot = new SetupKeybindingsDraft('alt+x');
-    assert.equal(invalidRoot.resolution().diagnostics[0]?.code, 'invalid-keybindings');
-    invalidRoot.resetAll();
-    assert.equal(invalidRoot.dirty, true);
-    assert.equal(invalidRoot.resolution().diagnostics.length, 0);
-    const draft = new SetupKeybindingsDraft({
-        'crtr.unknown': ['x'],
-        'crtr.attach.graph.toggle': 'alt+x',
-    });
-    assert.equal(draft.resolution().diagnostics.length, 2);
-    draft.resetAll();
-    assert.deepEqual(draft.overrides(), {});
-    assert.equal(draft.resolution().diagnostics.length, 0);
-    assert.equal(BINDING_CATALOG.some((entry) => entry.id.includes('app.') || entry.id.includes('tui.')), false);
-});
-test('setup keybinding draft memoizes resolution() and only recomputes after a state change', () => {
-    const draft = new SetupKeybindingsDraft({ 'crtr.attach.graph.toggle': ['alt+x'] });
-    // Repeated reads of unchanged state must reuse the same resolution instance
-    // (this is the m4 navigation path: reads never mutate the draft).
-    const first = draft.resolution();
-    const second = draft.resolution();
-    assert.equal(first, second);
-    // A state-changing operation must invalidate the cache and recompute.
-    draft.edit('crtr.attach.graph.toggle', 'ctrl+g');
-    const afterEdit = draft.resolution();
-    assert.notEqual(afterEdit, first);
-    assert.equal(draft.resolution(), afterEdit);
-    draft.resetRow('crtr.attach.graph.toggle');
-    const afterReset = draft.resolution();
-    assert.notEqual(afterReset, afterEdit);
-    draft.discard();
-    const afterDiscard = draft.resolution();
-    assert.notEqual(afterDiscard, afterReset);
-    draft.resetAll();
-    const afterResetAll = draft.resolution();
-    assert.notEqual(afterResetAll, afterDiscard);
-    draft.markSaved({});
-    const afterMarkSaved = draft.resolution();
-    assert.notEqual(afterMarkSaved, afterResetAll);
-});
-test('setup keybinding draft refuses edits while the raw root is invalid until reset-all', () => {
-    const draft = new SetupKeybindingsDraft('alt+x');
-    assert.equal(draft.hasInvalidRoot(), true);
-    // An edit against an invalid root must NOT commit (the prior bug: it returned
-    // ok:true against an empty `current` while the row kept showing the default).
-    const rejected = draft.edit('crtr.attach.graph.toggle', 'ctrl+g');
-    assert.equal(rejected.ok, false);
-    assert.equal(rejected.diagnostics[0].code, 'invalid-keybindings');
-    assert.deepEqual(draft.overrides(), {});
-    // reset-all clears the invalid root; edits then succeed and display.
-    draft.resetAll();
-    assert.equal(draft.hasInvalidRoot(), false);
-    const accepted = draft.edit('crtr.attach.graph.toggle', 'ctrl+g');
-    assert.equal(accepted.ok, true);
-    assert.deepEqual(draft.overrides()['crtr.attach.graph.toggle'], ['ctrl+g']);
-});
-test('setup keybindings editor stays visible while paging moves the selection (m3)', () => {
-    applyTheme({ cwd: process.cwd() });
-    const openingBindings = resolveKeybindings(undefined);
-    // A short terminal forces a small scroll window so paging past the edit row
-    // is the reproducible m3 scenario (editor was blind-typing off-screen before).
-    const wizard = new SetupWizard(buildSetupManifest(), new Set(), [], stubTui, agentDir, runtime, registry, openingBindings, undefined, () => 14);
-    wizard.focused = true;
-    const render = () => stripVTControlCharacters(wizard.render(100).join('\n'));
-    // Drive to the Keybindings tab (tab-next = Tab), open the editor on row 0 (Enter).
-    for (let i = 0; i < 4; i += 1)
-        wizard.handleInput('\t');
-    assert.match(render(), /Keybindings/);
-    wizard.handleInput('\r');
-    // Type a distinctive marker into the live editor buffer.
-    wizard.handleInput('zzz');
-    assert.match(render(), /zzz/, 'editor should echo typed input before paging');
-    // PageDown twice: selection moves off, but the editor row must remain on screen.
-    wizard.handleInput('\x1b[6~');
-    wizard.handleInput('\x1b[6~');
-    assert.match(render(), /zzz/, 'editor must stay visible (and keep capturing) after paging');
-});
-test('setup keybindings q-cancel with a dirty draft routes through discard-confirm, not a silent exit (N3)', () => {
-    applyTheme({ cwd: process.cwd() });
-    const wizard = new SetupWizard(buildSetupManifest(), new Set(), [], stubTui, agentDir, runtime, registry, resolveKeybindings(undefined), undefined, () => 40);
-    wizard.focused = true;
-    let cancelled = false;
-    wizard.onCancel = () => { cancelled = true; };
-    const render = () => stripVTControlCharacters(wizard.render(100).join('\n'));
-    for (let i = 0; i < 4; i += 1)
-        wizard.handleInput('\t');
-    // Make the draft dirty: unbind the selected row (delete key) so it has a real
-    // pending override.
-    wizard.handleInput('\x1b[3~');
-    assert.match(render(), /unsaved/, 'draft should be dirty after unbind');
-    // q (crtr.setup.cancel) in list mode must NOT drop the edits: it opens the same
-    // discard-confirm the Escape path uses.
-    wizard.handleInput('q');
-    assert.equal(cancelled, false, 'dirty draft must not silently exit on q');
-    assert.match(render(), /Discard every unsaved keybinding change\?/);
-    // A clean draft still exits on q (cancel elsewhere is unchanged).
-    const clean = new SetupWizard(buildSetupManifest(), new Set(), [], stubTui, agentDir, runtime, registry, resolveKeybindings(undefined), undefined, () => 40);
-    let cleanCancelled = false;
-    clean.onCancel = () => { cleanCancelled = true; };
-    clean.focused = true;
-    for (let i = 0; i < 4; i += 1)
-        clean.handleInput('\t');
-    clean.handleInput('q');
-    assert.equal(cleanCancelled, true, 'clean draft still exits on q');
-});
-test('setup keybindings selection always renders across group boundaries in a short window (m4 residual)', () => {
-    applyTheme({ cwd: process.cwd() });
-    // Small viewport so a window spans several group headings + a diagnostic line —
-    // the fixed-reserve page math used to let the selected row fail to render here.
-    const wizard = new SetupWizard(buildSetupManifest(), new Set(), [], stubTui, agentDir, runtime, registry, resolveKeybindings(undefined), undefined, () => 13);
-    wizard.focused = true;
-    const render = () => stripVTControlCharacters(wizard.render(100).join('\n'));
-    for (let i = 0; i < 4; i += 1)
-        wizard.handleInput('\t');
-    // Render only at the first/final rows and around each group transition. Every
-    // intermediate row still goes through production navigation, but does not pay
-    // for a redundant full viewport render.
-    const groupStarts = BINDING_CATALOG.flatMap((entry, index) => (index === 0 || entry.group !== BINDING_CATALOG[index - 1]?.group ? [index] : []));
-    const samples = [...new Set([
-            0,
-            BINDING_CATALOG.length - 1,
-            ...groupStarts.flatMap((start) => [start - 1, start, start + 1]),
-        ].filter((index) => index >= 0 && index < BINDING_CATALOG.length))].sort((a, b) => a - b);
-    let current = 0;
-    for (const sample of samples) {
-        while (current < sample) {
-            wizard.handleInput('j');
-            current += 1;
-        }
-        assert.match(render(), /\u25b6/, `selection marker must render at sample ${sample}`);
-    }
-});
-test('setup Broker limits tab persists positive user-scope thresholds and rejects invalid values', () => {
-    applyTheme({ cwd: process.cwd() });
-    const home = mkdtempSync(join(tmpdir(), 'setup-broker-limits-home-'));
-    const previousHome = process.env.HOME;
-    process.env.HOME = home;
-    try {
-        // Setup must show the same fallback the daemon receives: an inverted pair
-        // is invalid as a whole even though each individual number is positive.
-        mkdirSync(join(home, '.crouter'), { recursive: true });
-        writeFileSync(join(home, '.crouter', 'config.json'), JSON.stringify({
-            brokerThresholds: { warning: 300, automaticReviveCap: 200 },
-        }));
-        const wizard = new SetupWizard(buildSetupManifest(), new Set(), [], stubTui, agentDir, runtime, registry, resolveKeybindings(undefined), undefined, () => 40);
-        wizard.focused = true;
-        const render = () => stripVTControlCharacters(wizard.render(200).join('\n'));
-        const overridePrecedence = 'Valid CRTR_WARN_LIVE_BROKERS and CRTR_MAX_LIVE_BROKERS environment overrides take precedence over their corresponding configured limits.';
-        // Walk to the Broker limits tab by content rather than a fixed press count:
-        // the tab strip itself always contains the label, so the loop keys off the
-        // tab body and stays correct however many tabs precede it.
-        for (let i = 0; i < 20 && !render().includes('Warning threshold'); i += 1)
-            wizard.handleInput('\t');
-        assert.match(render(), /Warning threshold/);
-        assert.match(render(), /defaults 128 \/ 256/);
-        assert.match(render(), /> 128/);
-        assert.match(render(), /> 256/);
-        assert.ok(render().includes(`Configured limits apply next tick. ${overridePrecedence}`));
-        // Seeded values behave like the other setup editors: a new digit appends
-        // rather than prepending before the displayed default.
-        wizard.handleInput('9');
-        assert.match(render(), /1289/);
-        const remapped = new SetupWizard(buildSetupManifest(), new Set(), [], stubTui, agentDir, runtime, registry, resolveKeybindings({ 'crtr.setup.tab-next': ['1'] }), undefined, () => 40);
-        remapped.focused = true;
-        remapped.setTab(6);
-        remapped.handleInput('1');
-        assert.match(stripVTControlCharacters(remapped.render(120).join('\n')), /1281/, 'a digit must not trigger a remapped tab binding');
-        const inputs = wizard;
-        inputs.brokerWarningInput.setValue('192');
-        inputs.brokerHardCapInput.setValue('384');
-        wizard.handleInput('\r');
-        assert.deepEqual(JSON.parse(readFileSync(join(home, '.crouter', 'config.json'), 'utf8')).brokerThresholds, {
-            warning: 192,
-            automaticReviveCap: 384,
-        });
-        assert.ok(render().includes(`Saved to user config. Applies next tick. ${overridePrecedence}`));
-        inputs.brokerWarningInput.setValue('0');
-        wizard.handleInput('\r');
-        assert.match(render(), /Both broker limits must be positive integers/);
-        assert.deepEqual(JSON.parse(readFileSync(join(home, '.crouter', 'config.json'), 'utf8')).brokerThresholds, {
-            warning: 192,
-            automaticReviveCap: 384,
-        });
-    }
-    finally {
-        if (previousHome === undefined)
-            delete process.env.HOME;
-        else
-            process.env.HOME = previousHome;
-    }
-});
+import { inferPortableModelSelection } from '../../../core/runtime/launch.js';
+import { defaultModelLaddersConfig } from '../../../types.js';
+import { classifyLoginFailure } from '../panels/provider-panel.js';
 test('resolveBundledPiCliPath uses crouter bundled pi instead of a standalone pi on PATH', () => {
     const prevPath = process.env.PATH;
     process.env.PATH = '';
@@ -293,3 +29,14 @@ test('classifyLoginFailure treats an abort as authoritative', () => {
     assert.equal(classifyLoginFailure(new Error('network exploded'), false), 'Login error: network exploded');
     assert.equal(classifyLoginFailure('not an Error object', false), 'Login error: not an Error object');
 });
+test('portable kind selection preserves provider across tokens and concrete ladder refs', () => {
+    const ladders = defaultModelLaddersConfig();
+    ladders.defaultProvider = 'openai';
+    ladders.openai.strong = 'openai-codex/gpt-shared:high';
+    assert.deepEqual(inferPortableModelSelection('anthropic/strong', ladders), { provider: 'anthropic', strength: 'strong' });
+    assert.deepEqual(inferPortableModelSelection('strong', ladders), { provider: 'openai', strength: 'strong' });
+    assert.deepEqual(inferPortableModelSelection('openai-codex/gpt-shared:high', ladders), { provider: 'openai', strength: 'strong' });
+    assert.deepEqual(inferPortableModelSelection('openai-codex/gpt-shared:medium', ladders), { provider: 'openai', strength: 'strong' });
+    assert.deepEqual(inferPortableModelSelection('openai-codex/off-ladder:high', ladders), { provider: 'openai', strength: 'ultra' });
+    assert.deepEqual(inferPortableModelSelection('unknown-provider/off-ladder', ladders), { provider: 'openai', strength: 'ultra' });
+});

package/dist/commands/sys/config.js

@@ -105,7 +105,7 @@ function setNestedValue(cfg, key, rawValue, value) {
         return;
     }
     if (topKey === 'keybindings') {
-        throw usage('keybindings are edited only through `crtr sys setup`');
+        throw usage('keybindings are edited only through `crtr sys settings`');
     }
     if (topKey === 'modelLadders') {
         throw usage('modelLadders keys are written through persistModelLadders, not this path');
@@ -142,12 +142,12 @@ function setNestedValue(cfg, key, rawValue, value) {
 const configGet = defineLeaf({
     name: 'get',
     description: 'read a config value by key',
-    whenToUse: 'you want to inspect one config value — including the whole user keybindings object — optionally from a specific scope. Use sys setup to edit keybindings and sys config set for supported scalar settings.',
+    whenToUse: 'you want to inspect one config value — including the whole user keybindings object — optionally from a specific scope. Use sys settings to edit keybindings and sys config set for supported scalar settings.',
     help: {
         name: 'sys config get',
         summary: 'read a config value by dotted key',
         params: [
-            { kind: 'positional', name: 'key', type: 'string', required: true, constraint: `Dotted key path. Top-level keys: ${CONFIG_TOP_LEVEL_HELP}. brokerThresholds is user-only; keybindings is readable only as the whole user-scope object and editable only through sys setup.` },
+            { kind: 'positional', name: 'key', type: 'string', required: true, constraint: `Dotted key path. Top-level keys: ${CONFIG_TOP_LEVEL_HELP}. brokerThresholds is user-only; keybindings is readable only as the whole user-scope object and editable only through sys settings.` },
             { kind: 'flag', name: 'scope', type: 'enum', choices: ['user', 'project'], required: false, constraint: 'Scope to read from. Default: user.' },
         ],
         output: [
@@ -176,12 +176,12 @@ const configGet = defineLeaf({
 const configSet = defineLeaf({
     name: 'set',
     description: 'write a config value by key',
-    whenToUse: 'you want to change a supported crtr setting in user or project scope. Use sys setup instead for keybindings, and sys config get to inspect values.',
+    whenToUse: 'you want to change a supported crtr setting in user or project scope. Use sys settings instead for keybindings, and sys config get to inspect values.',
     help: {
         name: 'sys config set',
         summary: 'write a config value by dotted key',
         params: [
-            { kind: 'positional', name: 'key', type: 'string', required: true, constraint: `Dotted key path. User-scope scalar settings: ${SCALAR_SETTING_HELP}. Also supported: working_gerunds and whip_messages (non-empty JSON string arrays), brokerThresholds.warning and brokerThresholds.automaticReviveCap (user scope; integer >= 1), modelLadders.defaultProvider, and modelLadders.<anthropic|openai>.<ultra|strong|medium|light>. Keybindings are edited only through sys setup.` },
+            { kind: 'positional', name: 'key', type: 'string', required: true, constraint: `Dotted key path. User-scope scalar settings: ${SCALAR_SETTING_HELP}. Also supported: working_gerunds and whip_messages (non-empty JSON string arrays), brokerThresholds.warning and brokerThresholds.automaticReviveCap (user scope; integer >= 1), modelLadders.defaultProvider, and modelLadders.<anthropic|openai>.<ultra|strong|medium|light>. Keybindings are edited only through sys settings.` },
             { kind: 'flag', name: 'value', type: 'string', required: true, constraint: 'value VALUE — string, required. working_gerunds and whip_messages accept JSON arrays; other values are stored as-is if quoted and coerced to number or boolean when unambiguous.' },
             { kind: 'flag', name: 'scope', type: 'enum', choices: ['user', 'project'], required: false, constraint: 'Scope to write to. Default: user. Project scope is supported only for modelLadders.' },
         ],
@@ -258,7 +258,7 @@ const configPath = defineLeaf({
 export const configBranch = defineBranch({
     name: 'config',
     description: 'read and write configuration',
-    whenToUse: 'inspecting crtr settings, changing supported scalar values, or locating config.json. Keybinding changes belong in sys setup.',
+    whenToUse: 'inspecting crtr settings, changing supported scalar values, or locating config.json. Keybinding changes belong in sys settings.',
     help: {
         name: 'sys config',
         summary: 'read and write crtr configuration, including model ladders',

package/dist/commands/sys/logs.js

@@ -76,7 +76,7 @@ export const sysLogsLeaf = defineLeaf({
         summary: 'show the latest 200 matching local event and raw-residue records, oldest first',
         params: [
             { kind: 'flag', name: 'node', type: 'string', required: false, constraint: 'Safe node ID; the node need not still be active.' },
-            { kind: 'flag', name: 'component', type: 'enum', choices: ['daemon', 'broker', 'web'], required: false, constraint: 'Owning runtime component.' },
+            { kind: 'flag', name: 'component', type: 'enum', choices: ['daemon', 'broker'], required: false, constraint: 'Owning runtime component.' },
             { kind: 'flag', name: 'operation', type: 'string', required: false, constraint: 'Exact 32-character lowercase non-zero hexadecimal operation ID.' },
             { kind: 'flag', name: 'since', type: 'string', required: false, constraint: 'Inclusive ISO 8601 lower bound with a timezone.' },
             { kind: 'flag', name: 'until', type: 'string', required: false, constraint: 'Inclusive ISO 8601 upper bound with a timezone; cannot precede --since.' },

package/dist/commands/sys/panels/broker-limits-panel.d.ts

@@ -0,0 +1,17 @@
+import { Input } from "@earendil-works/pi-tui";
+import { type SetupPanel } from "./panel.js";
+export declare class BrokerLimitsPanel implements SetupPanel {
+    private readonly onChange;
+    readonly warningInput: Input;
+    readonly hardCapInput: Input;
+    private index;
+    private notice;
+    private _focused;
+    constructor(onChange: () => void);
+    set focused(value: boolean);
+    private selected;
+    private move;
+    private save;
+    handleInput(data: string, matches?: (id: string, input: string) => boolean): boolean;
+    render(width: number): string[];
+}

package/dist/commands/sys/panels/broker-limits-panel.js

@@ -0,0 +1,104 @@
+import { Input, truncateToWidth } from "@earendil-works/pi-tui";
+import { readConfig, updateRawConfigAtomically } from "../../../core/config.js";
+import { BROKER_LIMIT_OVERRIDE_PRECEDENCE } from "../setup.js";
+import { padAnsi, theme, wrapText } from "./panel.js";
+function positive(value) {
+    return /^\d+$/.test(value) &&
+        Number.isSafeInteger(Number(value)) &&
+        Number(value) >= 1
+        ? Number(value)
+        : undefined;
+}
+export class BrokerLimitsPanel {
+    onChange;
+    warningInput = new Input();
+    hardCapInput = new Input();
+    index = 0;
+    notice;
+    _focused = false;
+    constructor(onChange) {
+        this.onChange = onChange;
+        const thresholds = readConfig("user").brokerThresholds;
+        this.warningInput.setValue(String(thresholds.warning));
+        this.warningInput.handleInput("\x05");
+        this.hardCapInput.setValue(String(thresholds.automaticReviveCap));
+        this.hardCapInput.handleInput("\x05");
+        this.warningInput.onSubmit = () => this.save();
+        this.hardCapInput.onSubmit = () => this.save();
+    }
+    set focused(value) {
+        this._focused = value;
+        this.warningInput.focused = value && this.index === 0;
+        this.hardCapInput.focused = value && this.index === 1;
+    }
+    selected() {
+        return this.index === 0 ? this.warningInput : this.hardCapInput;
+    }
+    move(delta) {
+        this.index = ((this.index + delta + 2) % 2);
+        this.focused = this._focused;
+        this.notice = undefined;
+    }
+    save() {
+        const warning = positive(this.warningInput.getValue());
+        const cap = positive(this.hardCapInput.getValue());
+        if (warning === undefined || cap === undefined)
+            this.notice = "Both broker limits must be positive integers.";
+        else if (warning > cap)
+            this.notice =
+                "Warning threshold cannot exceed the automatic-revive hard cap.";
+        else {
+            updateRawConfigAtomically("user", (latest) => ({
+                ...latest,
+                brokerThresholds: { warning, automaticReviveCap: cap },
+            }));
+            this.notice = `Saved to user config. Applies next tick. ${BROKER_LIMIT_OVERRIDE_PRECEDENCE}`;
+        }
+        this.onChange();
+    }
+    handleInput(data, matches) {
+        if (/^\d+$/.test(data)) {
+            this.selected().handleInput(data);
+            this.notice = undefined;
+            this.onChange();
+            return true;
+        }
+        if (!matches)
+            return false;
+        if (matches("crtr.setup.list-down", data))
+            this.move(1);
+        else if (matches("crtr.setup.list-up", data))
+            this.move(-1);
+        else if (data.length > 0 &&
+            [...data].every((char) => char.codePointAt(0) >= 32))
+            this.notice = "Broker limits accept digits only.";
+        else {
+            this.selected().handleInput(data);
+            if (data !== "\r" && data !== "\n")
+                this.notice = undefined;
+        }
+        this.onChange();
+        return true;
+    }
+    render(width) {
+        const out = [
+            truncateToWidth(`${theme.fg("accent", theme.bold("Broker limits"))}${theme.fg("dim", "  user scope · defaults 128 / 256")}`, width),
+            truncateToWidth(theme.fg("dim", "These bounds govern daemon automatic revive; explicit node revives remain available."), width),
+            "",
+        ];
+        const line = (index, label, description, input) => {
+            const selected = index === this.index;
+            out.push(truncateToWidth(`${selected ? theme.fg("accent", "▶") : " "} ${padAnsi(selected ? theme.fg("accent", label) : label, 24)} ${input.render(Math.max(8, width - 28))[0] ?? ""}`, width));
+            out.push(truncateToWidth(theme.fg("dim", `    ${description}`), width));
+        };
+        line(0, "Warning threshold", "Warn when live brokers reach this count. Default: 128.", this.warningInput);
+        line(1, "Automatic-revive hard cap", "Defer automatic revives at this count. Default: 256.", this.hardCapInput);
+        out.push("");
+        for (const text of wrapText(`Configured limits apply next tick. ${BROKER_LIMIT_OVERRIDE_PRECEDENCE}`, width))
+            out.push(theme.fg("dim", text));
+        if (this.notice)
+            for (const text of wrapText(this.notice, width))
+                out.push(theme.fg(this.notice.startsWith("Saved") ? "success" : "warning", text));
+        return out;
+    }
+}

package/dist/commands/sys/panels/dependencies-panel.d.ts

@@ -0,0 +1,14 @@
+import type { SetupSystemInstallPlan } from "../setup-core.js";
+import { type SetupPanel } from "./panel.js";
+export declare class DependenciesPanel implements SetupPanel {
+    private readonly plans;
+    private readonly onChange;
+    private readonly selectedTools;
+    private index;
+    constructor(plans: SetupSystemInstallPlan[], onChange: () => void);
+    badge(): string;
+    get selected(): readonly SetupSystemInstallPlan[];
+    private current;
+    handleInput(data: string, matches?: (id: string, input: string) => boolean): boolean;
+    render(width: number): string[];
+}

package/dist/commands/sys/panels/dependencies-panel.js

@@ -0,0 +1,80 @@
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { theme } from "./panel.js";
+function toolLabel(tool) {
+    return tool === "nvim" ? "nvim" : tool === "nerd-font" ? "Nerd Font" : "tmux";
+}
+export class DependenciesPanel {
+    plans;
+    onChange;
+    selectedTools = new Set();
+    index = 0;
+    constructor(plans, onChange) {
+        this.plans = plans;
+        this.onChange = onChange;
+        for (const plan of plans)
+            if (!plan.installed && plan.autoInstall)
+                this.selectedTools.add(plan.tool);
+        const firstMissing = plans.findIndex((plan) => !plan.installed);
+        this.index = firstMissing >= 0 ? firstMissing : 0;
+    }
+    badge() {
+        const missing = this.plans.filter((plan) => !plan.installed).length;
+        return missing === 0 ? "\u2713" : `${missing} missing`;
+    }
+    get selected() {
+        return this.plans.filter((tool) => !tool.installed && this.selectedTools.has(tool.tool));
+    }
+    current() {
+        return this.plans[this.index];
+    }
+    handleInput(data, matches) {
+        if (!matches)
+            return false;
+        if (matches("crtr.setup.list-down", data) ||
+            matches("crtr.setup.list-up", data)) {
+            const entries = this.plans
+                .map((tool, index) => ({ tool, index }))
+                .filter(({ tool }) => !tool.installed);
+            if (entries.length === 0)
+                return true;
+            const current = entries.findIndex(({ index }) => index === this.index);
+            const delta = matches("crtr.setup.list-down", data) ? 1 : -1;
+            this.index =
+                entries[((current >= 0 ? current : 0) + delta + entries.length) %
+                    entries.length].index;
+        }
+        else if (matches("crtr.setup.toggle", data)) {
+            const tool = this.current();
+            if (tool && !tool.installed)
+                this.selectedTools.has(tool.tool)
+                    ? this.selectedTools.delete(tool.tool)
+                    : this.selectedTools.add(tool.tool);
+        }
+        else
+            return false;
+        this.onChange();
+        return true;
+    }
+    render(width) {
+        const out = [
+            truncateToWidth(`${theme.fg("accent", theme.bold("System deps"))}${theme.fg("dim", "  tmux + nvim + Nerd Font check")}`, width),
+        ];
+        for (const [index, tool] of this.plans.entries()) {
+            const selected = index === this.index;
+            const marker = selected ? theme.fg("accent", "▶") : theme.fg("dim", " ");
+            if (tool.installed) {
+                out.push(truncateToWidth(`${marker} ${theme.fg("success", "✓ installed")} ${theme.fg("muted", toolLabel(tool.tool))}`, width));
+                continue;
+            }
+            const checked = this.selectedTools.has(tool.tool)
+                ? theme.fg("success", "[x]")
+                : theme.fg("dim", "[ ]");
+            const label = tool.command ?? tool.hint;
+            const name = selected
+                ? theme.fg("accent", `Install ${toolLabel(tool.tool)}`)
+                : `Install ${toolLabel(tool.tool)}`;
+            out.push(truncateToWidth(`${marker} ${checked} ${name} ${theme.fg("dim", "—")} ${theme.fg("muted", label)} ${theme.fg("warning", "not installed")}`, width));
+        }
+        return out;
+    }
+}

package/dist/commands/sys/panels/keybindings-panel.d.ts

@@ -0,0 +1,56 @@
+import { type BindingId, type BindingResolution } from "../../../core/keybindings/index.js";
+export declare class KeybindingsPanel {
+    private readonly openingBindings;
+    private readonly terminalRows;
+    private readonly onChange;
+    private readonly keyInput;
+    private readonly keyDraft;
+    private keyIndex;
+    private keyFieldIndex;
+    private keyScroll;
+    private keyFilter;
+    private filteringKeys;
+    private editingKey;
+    private keyEditError;
+    private keyDiagnostics;
+    private keyConfirm;
+    private keyNotice;
+    private keyTmuxOccupancy;
+    private _focused;
+    constructor(openingBindings: BindingResolution<BindingId>, rawKeybindings: unknown, rawTmuxPassthrough: unknown, terminalRows: () => number, onChange: () => void);
+    set focused(value: boolean);
+    get focused(): boolean;
+    get dirty(): boolean;
+    badge(): string;
+    get takesPriorityInput(): boolean;
+    requestDiscard(): void;
+    private invalidate;
+    private matches;
+    private label;
+    private filteredKeybindings;
+    private selectedKeyRow;
+    private selectedKeybinding;
+    private tmuxPassthroughOffer;
+    private toggleTmuxPassthrough;
+    private moveKey;
+    private moveKeyField;
+    private keyViewportLines;
+    private keyPageSize;
+    private beginKeyEdit;
+    private commitKeyEdit;
+    private cancelKeyEdit;
+    private saveKeybindings;
+    private refreshTmuxBindingsAfterSave;
+    private confirmKeyAction;
+    private handleKeybindingsInput;
+    private keyRowMessage;
+    /** 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. */
+    private keyRowBodyLineCount;
+    private keyLineCost;
+    private renderKeybindings;
+    handleInput(data: string): boolean;
+    render(width: number, _height?: number): string[];
+    footerHint(): string;
+}