talos-code 0.0.1 → 0.1.0

package/dist/tui/overlays/model-picker.js

@@ -0,0 +1,72 @@
+import { t, tn } from "../../i18n/index.js";
+import { normalizeModels } from "../catalog-service.js";
+import { pickerSection } from "./scroll-window.js";
+/**
+ * R4 (gate E10): `current` is the model in use; when it belongs to this provider and the list does not have it, it is still
+ * listed (not verified) and the notice says so, so the picker never hides what TALOS is set to use.
+ */
+export function createModelPickerModel(catalog, input) {
+    let models = [];
+    let cancelled = false;
+    let loadError = null;
+    let verified = false;
+    let notice = '';
+    let label = input.provider ?? '';
+    let abort = null;
+    return {
+        async open() {
+            cancelled = false;
+            loadError = null;
+            models = [];
+            verified = false;
+            if (!input.provider) {
+                notice = t('screen.model.chooseProviderFirst');
+                return;
+            }
+            abort?.abort();
+            abort = new AbortController();
+            try {
+                const list = await catalog.providerModels(input.provider, abort.signal);
+                if (cancelled)
+                    return;
+                models = list.rows;
+                verified = list.verified;
+                notice = list.notice;
+                label = list.label;
+                const current = input.current;
+                if (current && current.startsWith(`${input.provider}:`) && !models.some(row => row.id === current)) {
+                    models = [...models, ...normalizeModels([{ id: current }], input.provider, 'configured')];
+                    verified = false;
+                    notice = [notice, t('firstrun.models.chosenMissing', { model: current, label })].filter(Boolean).join(' ');
+                }
+            }
+            catch (error) {
+                if (!cancelled) {
+                    loadError = error;
+                    notice = t('screen.model.listFailed');
+                }
+            }
+        },
+        cancel() { cancelled = true; abort?.abort(); abort = null; },
+        rows: () => models,
+        error: () => loadError,
+        verified: () => verified,
+        notice: () => notice,
+        label: () => label,
+    };
+}
+export async function commitModelSelection({ id, catalog, setControllerModel }) {
+    await catalog.selectModel(id, 'project-user');
+    setControllerModel(id);
+}
+// R1 Q-R1-3: the model list and the effort step as app.ts draws them, capped and scrolled by overlays/scroll-window.ts.
+export function modelPickerOverlay({ label, provider, loading, verified, notice, query, rows, selected }) {
+    return {
+        head: [
+            { text: t('screen.model.title', { label: label || provider || '', state: t(loading ? 'screen.model.stateLoading' : verified ? 'screen.model.stateLive' : 'screen.model.stateUnverified') }), tone: 'title' },
+            ...(notice ? [{ text: notice, tone: loading || verified ? 'dim' : 'plain' }] : []),
+            { text: tn('screen.model.count', rows.length, { query: query || t('screen.none') }), tone: 'dim' },
+        ],
+        sections: [pickerSection(rows, selected, row => { const remote = row.id.slice(row.provider.length + 1); const efforts = row.reasoningEfforts?.length ? ` · ${t('screen.model.rowEffort', { efforts: row.reasoningEfforts.join('/') })}` : ''; return `${row.name}${row.name !== remote ? ` · ${remote}` : ''}${row.contextWindow ? ` · ${row.contextWindow}` : ''}${row.reasoning ? ` · ${t('screen.model.rowReasoning')}` : ''}${efforts}${row.images ? ` · ${t('screen.model.rowImage')}` : ''}${verified || loading ? '' : ` ${t('screen.model.rowUnverified')}`}`; })],
+    };
+}

package/dist/tui/overlays/notes-center.js

@@ -0,0 +1,53 @@
+import { en, t } from "../../i18n/index.js";
+import { centerTones, listOverlay } from "./scroll-window.js";
+const UNSAFE = /[\\\x00-\x1f\x7f-\x9f\u2028\u2029\p{Bidi_Control}\p{Default_Ignorable_Code_Point}]/gu;
+function inert(value) { return String(value ?? '').replace(UNSAFE, ch => { if (ch === '\\')
+    return '\\\\'; const cp = ch.codePointAt(0) ?? 0; return cp <= 0xffff ? '\\u' + cp.toString(16).padStart(4, '0') : '\\u{' + cp.toString(16) + '}'; }); }
+/* R2 (gate §1.5, E4): the kernel's `origine` value (modello|persona) is mapped by value, never printed raw. */
+function writerLabel(value) { const id = `screen.writer.${String(value)}`; return Object.hasOwn(en, id) ? t(id) : inert(value); }
+/* R2 (gate §1.5, E4): the kernel's note `formato` value (testo|markdown) is mapped by value, never printed raw. */
+function formatLabel(value) { const id = `screen.noteFormat.${String(value)}`; return Object.hasOwn(en, id) ? t(id) : inert(value); }
+function clamp(value, count) { return count ? Math.max(0, Math.min(count - 1, value)) : 0; }
+export function createNotesCenterModel(snapshot, selected = 0) { return { snapshot, selected: clamp(selected, snapshot.rows.length) }; }
+export function moveNotesCenterSelection(model, delta) { return { ...model, selected: clamp(model.selected + delta, model.snapshot.rows.length) }; }
+export function selectedNote(model) { return model.snapshot.rows[model.selected] ?? null; }
+export function renderNotesCenterLines(model) {
+    const lines = [t('screen.notes.title')];
+    if (model.snapshot.state === 'invalid') {
+        lines.push('Store: invalid · ' + inert(model.snapshot.error?.code ?? 'NOTES_STORE_INVALID') + ' · ' + inert(model.snapshot.error?.message ?? 'unavailable'));
+        lines.push(t('screen.center.closeRefresh'));
+        return lines;
+    }
+    if (!model.snapshot.rows.length) {
+        lines.push(t('screen.notes.empty'));
+        lines.push(t('screen.center.closeRefresh'));
+        return lines;
+    }
+    lines.push(...model.snapshot.rows.map((row, index) => (index === model.selected ? '› ' : '  ') + inert(row.id) + ' · ' + inert(row.title) + ' · ' + formatLabel(row.format)));
+    const row = selectedNote(model);
+    if (row) {
+        lines.push('ID: ' + inert(row.id));
+        lines.push('Format: ' + formatLabel(row.format) + ' (' + inert(row.formatEvidence) + ')');
+        lines.push('Writer: ' + writerLabel(row.writer) + ' (' + inert(row.writerEvidence) + ')');
+        lines.push('Created: ' + inert(row.createdAt ?? 'unavailable') + ' · Updated: ' + inert(row.updatedAt ?? 'unavailable'));
+        lines.push('Content: ' + inert(row.content));
+        if (row.relations.length) {
+            lines.push('Links:');
+            for (const relation of row.relations)
+                lines.push('- ' + inert(relation.target.kind) + ':' + inert(relation.target.id) + ' · ' + inert(relation.state) + (relation.label ? ' · ' + inert(relation.label) : ''));
+        }
+        else
+            lines.push('Links: none');
+    }
+    lines.push(t('screen.notes.keys'));
+    lines.push(t('screen.notes.linkHelp'));
+    lines.push(t('screen.notes.unlinkHelp'));
+    return lines;
+}
+// R1 Q-R1-3: the same lines as a capped, scrolling overlay — the list keeps the selection visible, the detail scrolls.
+// The /notes link|unlink reference lines follow the key hint: they scroll with the detail, the hint stays.
+export function notesCenterOverlay(model) {
+    const lines = renderNotesCenterLines(model), list = model.snapshot.state === 'invalid' ? 0 : model.snapshot.rows.length;
+    const reference = list ? 2 : 0, hint = lines.length - 1 - reference;
+    return listOverlay([...lines.slice(0, hint), ...lines.slice(hint + 1), lines[hint]], { head: 1, list, selected: model.selected, foot: 1, tones: centerTones });
+}

package/dist/tui/overlays/overlay-host.js

@@ -0,0 +1,8 @@
+export function createOverlayHost(React, components) {
+    return function OverlayHost({ overlay, ...shared }) {
+        if (!overlay)
+            return null;
+        const component = components[overlay.kind];
+        return React.createElement(component, { ...shared, ...overlay });
+    };
+}

package/dist/tui/overlays/plugin-center.js

@@ -0,0 +1,76 @@
+import { t } from "../../i18n/index.js";
+import { centerTones, listOverlay } from "./scroll-window.js";
+const UNSAFE = /[\\\x00-\x1f\x7f-\x9f\u2028\u2029\p{Bidi_Control}\p{Default_Ignorable_Code_Point}]/gu;
+const BACKSLASH = String.fromCharCode(92);
+function inert(value) {
+    return String(value).replace(UNSAFE, character => {
+        if (character === BACKSLASH)
+            return BACKSLASH + BACKSLASH;
+        const code = character.codePointAt(0);
+        return code > 0xffff ? BACKSLASH + 'u{' + code.toString(16) + '}' : BACKSLASH + 'u' + code.toString(16).padStart(4, '0');
+    });
+}
+function shown(value) { return inert(String(value ?? '—')); }
+function list(values) { return values.length ? values.map(shown).join(', ') : 'none'; }
+export function createPluginCenterModel(rows, selected = 0) {
+    const copy = rows.map(row => ({ ...row }));
+    return { title: t('screen.plugins.title'), rows: copy, selected: copy.length ? Math.max(0, Math.min(copy.length - 1, selected)) : 0 };
+}
+export function movePluginCenterSelection(model, delta) {
+    if (!model.rows.length)
+        return model;
+    return { ...model, selected: Math.max(0, Math.min(model.rows.length - 1, model.selected + delta)) };
+}
+export function selectedPlugin(model) { return model.rows[model.selected] ?? null; }
+export function replacePluginCenterRow(model, row) {
+    const index = model.rows.findIndex(value => value.id === row.id);
+    if (index < 0)
+        return model;
+    const rows = [...model.rows];
+    rows[index] = row;
+    return { ...model, rows };
+}
+export function renderPluginCenterLines(model) {
+    const lines = [model.title, ''];
+    if (!model.rows.length)
+        return [...lines, t('screen.plugins.empty'), '', t('screen.center.escRefresh')];
+    for (const [index, row] of model.rows.entries()) {
+        const status = row.registry.state !== 'loaded'
+            ? row.registry.state
+            : row.quarantine.active ? 'quarantined'
+                : row.guard?.verdict === 'dangerous' ? 'dangerous'
+                    : row.trust.effectiveTrusted ? 'trusted' : 'untrusted';
+        lines.push((index === model.selected ? '›' : ' ') + ' ' + shown(row.id) + ' · ' + status + ' · ' + row.provenance.kind);
+    }
+    const row = selectedPlugin(model);
+    if (!row)
+        return lines;
+    lines.push('', 'Selected: ' + shown(row.id) + (row.name ? ' · ' + shown(row.name) : ''), 'Registry: ' + row.registry.state + (row.registry.code ? ' · ' + shown(row.registry.code) : '') + (row.registry.message ? ' · ' + shown(row.registry.message) : ''), 'Provenance: ' + row.provenance.kind + (row.provenance.extension ? ' · ' + shown(row.provenance.extension.name) + ' ' + shown(row.provenance.extension.version) : ''), 'Package copy: ' + (row.provenance.packageCopyPresent ? 'present' : 'not verified') + ' · ' + shown(row.provenance.packageCopy), 'Recorded source (' + row.provenance.recordedSourceAuthority + '): ' + (row.provenance.recordedSource ? shown(row.provenance.recordedSource) : 'none') + ' · ' + (row.provenance.recordedSourceAvailable ? 'available' : 'unavailable / unverified'), 'Guard: ' + (row.guard ? row.guard.verdict : 'unavailable') + (row.guardError ? ' · ' + shown(row.guardError) : ''), 'Capabilities: ' + (row.guard ? list(row.guard.capabilities) : 'unavailable'), 'Trust: scope ' + (row.trust.scopeTrusted ? 'trusted' : 'not trusted') + ' · effective ' + (row.trust.effectiveTrusted ? 'trusted' : 'NOT TRUSTED') + ' · project ' + (row.trust.projectTrusted ? 'trusted' : 'not fully trusted'), 'Fingerprint current set: ' + shown(row.fingerprints.currentSetDigest), 'Fingerprint trusted set: ' + shown(row.fingerprints.trustedSetDigest));
+    if (row.fingerprints.changedPaths.length)
+        lines.push('Changed: ' + list(row.fingerprints.changedPaths));
+    if (row.fingerprints.addedPaths.length)
+        lines.push('Added: ' + list(row.fingerprints.addedPaths));
+    if (row.fingerprints.removedPaths.length)
+        lines.push('Removed: ' + list(row.fingerprints.removedPaths));
+    lines.push('Quarantine: ' + (row.quarantine.active ? 'active' : 'none') + (row.quarantine.reason ? ' · ' + shown(row.quarantine.reason) : ''));
+    if (row.guard === null)
+        lines.push('Guard findings: unavailable');
+    else if (row.guard.findings.length) {
+        lines.push('Guard findings');
+        for (const finding of row.guard.findings.slice(0, 12)) {
+            lines.push('  ' + finding.severity + ' · ' + shown(finding.code) + ' · ' + shown(finding.origin) + ' · ' + shown(finding.message));
+        }
+        if (row.guard.findings.length > 12)
+            lines.push('  … ' + (row.guard.findings.length - 12) + ' more finding(s)');
+    }
+    else if (row.guard)
+        lines.push('Guard findings: none');
+    if (row.guard?.verdict === 'dangerous')
+        lines.push(t('screen.plugins.blocked'));
+    lines.push('', t('screen.plugins.keys'));
+    return lines;
+}
+// R1 Q-R1-3: the same lines as a capped, scrolling overlay — the list keeps the selection visible, the detail scrolls.
+export function pluginCenterOverlay(model) {
+    return listOverlay(renderPluginCenterLines(model), { head: 2, list: model.rows.length, selected: model.selected, foot: 1, tones: centerTones });
+}

package/dist/tui/overlays/provider-picker.js

@@ -0,0 +1,145 @@
+import { t } from "../../i18n/index.js";
+import { benchClock } from "../catalog-service.js";
+import { pickerSection } from "./scroll-window.js";
+import { filterItems } from "../selection-list.js";
+const KEY_REMEDIATION_CODES = new Set(['PROVIDER_KEY_MISSING', 'PROVIDER_KEY_BENCHED', 'PROVIDER_AUTH_FAILED']);
+export function providerPickerEnter(input) {
+    if (input.keySource === 'environment-unanswered' && !input.probe)
+        return { kind: 'environment-consent', provider: input.selectedProvider };
+    const remediation = input.probe?.remediation ?? null;
+    const readinessCode = input.probe?.readinessCode ?? null;
+    const requiresKey = input.requiresKey !== false;
+    if (readinessCode) {
+        if (requiresKey && KEY_REMEDIATION_CODES.has(readinessCode))
+            return { kind: 'provider-setup', provider: input.selectedProvider, remediation };
+        return { kind: 'provider-remediation', provider: input.selectedProvider, remediation };
+    }
+    if (input.configured)
+        return remediation && remediation.code !== 'none'
+            ? { kind: 'open-model-picker', provider: input.selectedProvider, remediation }
+            : { kind: 'open-model-picker', provider: input.selectedProvider };
+    if (input.keySource === 'environment-unanswered')
+        return { kind: 'environment-consent', provider: input.selectedProvider };
+    if (requiresKey)
+        return remediation ? { kind: 'provider-setup', provider: input.selectedProvider, remediation } : { kind: 'provider-setup', provider: input.selectedProvider };
+    return { kind: 'provider-remediation', provider: input.selectedProvider, remediation };
+}
+/** "No" is first and preselected; the question names the variable, never any part of its value. */
+export function consentQuestion(row) {
+    return {
+        question: t('screen.provider.consentQuestion', { variable: row.environmentVariable ?? t('screen.provider.consentVariableFallback'), provider: row.label }),
+        options: [{ choice: 'no', label: t('screen.provider.consentNo') }, { choice: 'yes', label: t('screen.provider.consentYes') }],
+    };
+}
+/* B1 slice 25: a provider whose stored keys are all benched is shown as benched, with the cause and until when, not as "key saved". */
+export function providerKeySourceLabel(row) {
+    if (row.benched)
+        return t('screen.provider.keyBenched') + (row.benched.cause ? t('screen.provider.keyBenchedCause', { cause: row.benched.cause }) : '') + (row.benched.until !== null ? t('screen.provider.keyBenchedUntil', { clock: benchClock(row.benched.until) }) : '');
+    switch (row.keySource) {
+        case 'saved': return t('screen.provider.keySavedLabel');
+        case 'environment': return t('screen.provider.keyFrom', { variable: row.environmentVariable ?? t('screen.provider.keyFromEnvironment') });
+        case 'environment-unanswered': return t('screen.provider.keyUnanswered');
+        case 'environment-declined': return t('screen.provider.keyDeclined');
+        case 'not-required': return t('screen.provider.keyNotRequired');
+        default: return t('screen.provider.keyMissing');
+    }
+}
+/*
+ * R4 Q-R4-11 (owner, 2026-09-24): what can be used now comes first. A local engine that needs no key and answered when the
+ * list opened; then a provider with a key usable now (or a configured external agent); then a local engine not checked; then
+ * one that did not answer; then the rest. Alphabetical inside each group, and a typed query still ranks first (the same
+ * `filterItems`), so "ollama" highlights Ollama Local. The groups are sort keys only: nothing is hidden.
+ */
+export function providerUsabilityRank(row, reachable) {
+    if (row.local && !row.requiresKey)
+        return reachable === true ? 0 : reachable === false ? 3 : 2;
+    return row.configured ? 1 : 4;
+}
+export function providerPickerItems(rows, query, { reachable = () => null } = {}) {
+    return filterItems(rows.map(row => ({ id: row.id, label: row.label, searchText: `${row.id} ${row.label} ${row.description}`, group: String(providerUsabilityRank(row, reachable(row.id))), value: row })), query).map(item => item.value);
+}
+/* How long opening the list waits for local engines to answer; one that has not answered by then is "not checked". */
+export const LOCAL_ENGINE_CHECK_MS = 800;
+function reachableFrom(probe) {
+    if (!probe)
+        return null;
+    return probe.state === 'available' ? true : probe.state === 'unavailable' ? false : null;
+}
+export function maskedSecret(secret) { return '•'.repeat([...secret].length); }
+export function createProviderPickerModel(catalog) {
+    let providers = [];
+    let selected = 0;
+    let abort = null;
+    const probes = new Map();
+    return {
+        async open() {
+            abort?.abort();
+            abort = null;
+            providers = await catalog.listProviders();
+            selected = 0;
+            /* R4 Q-R4-11: only local engines that need no key are checked, all at once and briefly; nothing on the network is. */
+            const locals = providers.filter(row => row.local && !row.requiresKey);
+            if (!locals.length)
+                return;
+            const check = new AbortController();
+            const timer = setTimeout(() => check.abort(), LOCAL_ENGINE_CHECK_MS);
+            const answered = Promise.all(locals.map(async (row) => { try {
+                probes.set(row.id, await catalog.probeProvider(row.id, check.signal));
+            }
+            catch { /* not checked */ } }));
+            try {
+                await Promise.race([answered, new Promise(resolve => check.signal.addEventListener('abort', () => resolve(), { once: true }))]);
+            }
+            finally {
+                clearTimeout(timer);
+                check.abort();
+            }
+        },
+        async probeSelected() { const row = providers[selected]; if (!row)
+            return null; abort?.abort(); abort = new AbortController(); const result = await catalog.probeProvider(row.id, abort.signal); probes.set(row.id, result); return result; },
+        cancel() { abort?.abort(); abort = null; },
+        rows: () => providers,
+        selected: () => selected,
+        select(index) { selected = Math.max(0, Math.min(Math.max(0, providers.length - 1), index)); },
+        probeState: id => probes.get(id),
+        reachable: id => reachableFrom(probes.get(id)),
+        async setSecret(secret) { const row = providers[selected]; if (!row)
+            return null; try {
+            return await catalog.setProviderKey(row.id, secret);
+        }
+        finally {
+            secret = '';
+        } },
+        async clearSecret() { const row = providers[selected]; if (!row)
+            return; await catalog.clearProviderKey(row.id); },
+    };
+}
+// R1 Q-R1-3: the three provider steps as app.ts draws them, capped and scrolled by overlays/scroll-window.ts.
+/* R4 Q-R4-11: `chosen` marks the provider in use; `reachable` says whether a local engine is running (nothing when not checked). */
+export function providerPickerOverlay({ query, rows, selected, chosen = null, reachable = () => null }) {
+    const running = (row) => { if (!row.local)
+        return ''; const state = reachable(row.id); return state === null ? '' : ` · ${t(state ? 'firstrun.providers.running' : 'firstrun.providers.notRunning')}`; };
+    return {
+        head: [{ text: t('screen.provider.title'), tone: 'title' }, { text: t('screen.picker.searchChoose', { query: query || t('screen.none') }), tone: 'dim' }],
+        sections: [pickerSection(rows, selected, row => `${row.label}${row.id === chosen ? ` · ${t('firstrun.providers.chosen')}` : ''} · ${providerKeySourceLabel(row)} · ${t(row.local ? 'screen.word.local' : 'screen.word.cloud')}${running(row)}${row.endpointHost ? ` · ${row.endpointHost}` : ''}`)],
+    };
+}
+// The question scrolls with its options, so a short budget keeps the chosen answer on screen before the question.
+export function providerConsentOverlay({ provider, choice }) {
+    const asked = consentQuestion(provider), index = asked.options.findIndex(option => option.choice === choice);
+    return {
+        head: [{ text: t('screen.provider.titleNamed', { provider: provider.label }), tone: 'title' }],
+        sections: [{ lines: [{ text: asked.question, tone: 'plain' }, ...asked.options.map(option => ({ text: `${option.choice === choice ? '›' : ' '} ${option.label}`, tone: option.choice === choice ? 'selected' : 'accent' }))], selected: 1 + Math.max(0, index) }],
+        foot: [{ text: t('screen.provider.consentFoot'), tone: 'dim' }],
+    };
+}
+// Only the MASK reaches this view, never the typed key. The key line is the "selected" row: it is where the person types.
+export function providerKeyOverlay({ label, remediation, benched, masked, keyTestNotice, testing, result }) {
+    const lines = [...(remediation ? [remediation] : []), ...(benched ? [benched] : [])];
+    const keyLine = lines.length;
+    lines.push(t('screen.provider.keyPrompt', { provider: label, masked: masked || ' ' }), ...(keyTestNotice ? [keyTestNotice] : []));
+    const status = testing ? { text: t('screen.provider.keyTesting', { provider: label }), tone: 'dim' }
+        : result ? { text: t('screen.provider.keyResult', { result }), tone: 'plain' }
+            : { text: t('screen.provider.keyFoot'), tone: 'dim' };
+    return { head: [{ text: t('screen.provider.titleNamed', { provider: label }), tone: 'title' }], sections: [{ lines: lines.map(text => ({ text, tone: 'plain' })), selected: keyLine }], foot: [status] };
+}

package/dist/tui/overlays/queue-editor.js

@@ -0,0 +1,32 @@
+import { t, tn } from "../../i18n/index.js";
+import { queuedActionPreview } from "../shell-model.js";
+import { centerTones, listOverlay } from "./scroll-window.js";
+export function queueEditorSelected(entries, selected) {
+    if (entries.length === 0)
+        return null;
+    return entries[Math.max(0, Math.min(entries.length - 1, Math.trunc(selected) || 0))] ?? null;
+}
+export function queueEditorLines({ entries, selected, paused, editing, draft }) {
+    const active = queueEditorSelected(entries, selected), index = active ? entries.findIndex(row => row.id === active.id) : -1;
+    const lines = [t(paused ? 'screen.queueEditor.restored' : 'screen.queueEditor.live'), entries.length ? tn('screen.queueEditor.count', entries.length) : t('screen.queue.empty')];
+    for (let i = 0; i < entries.length; i++) {
+        const row = entries[i], status = row.status === 'uncertain' ? ` · ${t('screen.queueEditor.uncertain')}` : '';
+        const attachments = row.attachments?.length ? ` · ${tn('screen.queueEditor.attachments', row.attachments.length)}` : '';
+        /* R5a Q-R5-8: a queued slash command (`kind:'slash'`) is shown as the command it is, not as a follow-up message. */
+        const label = row.kind === 'command' ? '!' : row.kind === 'slash' ? '' : t('screen.queueEditor.followUp');
+        lines.push(`${i === index ? '›' : ' '} ${i + 1}. ${label}${queuedActionPreview(row.text).slice(0, 180)}${attachments}${status}`);
+    }
+    if (editing)
+        lines.push(t('screen.queueEditor.edit', { draft: queuedActionPreview(draft).slice(0, 220) || t('screen.none') }), t('screen.queueEditor.editKeys'));
+    else
+        lines.push(t('screen.queueEditor.keys'));
+    if (paused && entries.some(row => row.status === 'uncertain'))
+        lines.push(t('screen.queueEditor.retryWarning'));
+    return lines;
+}
+// R1 Q-R1-3: the same lines as a capped, scrolling overlay (overlays/scroll-window.ts).
+export function queueEditorOverlay(view) {
+    const lines = queueEditorLines(view), active = queueEditorSelected(view.entries, view.selected);
+    const selected = active ? view.entries.findIndex(row => row.id === active.id) : 0;
+    return listOverlay(lines, { head: 2, list: view.entries.length, selected, foot: lines.length - 2 - view.entries.length, tones: centerTones });
+}

package/dist/tui/overlays/research-center.js

@@ -0,0 +1,59 @@
+import { t } from "../../i18n/index.js";
+import { centerTones, listOverlay } from "./scroll-window.js";
+const UNSAFE = /[\\\x00-\x1f\x7f-\x9f\u2028\u2029\p{Bidi_Control}\p{Default_Ignorable_Code_Point}]/gu;
+function inert(value, max = 360) { const safe = String(value ?? '').replace(UNSAFE, ch => { if (ch === '\\')
+    return '\\\\'; const cp = ch.codePointAt(0) ?? 0; return cp <= 0xffff ? '\\u' + cp.toString(16).padStart(4, '0') : '\\u{' + cp.toString(16) + '}'; }); return safe.length > max ? safe.slice(0, max - 1) + '…' : safe; }
+function clamp(value, count) { return count ? Math.max(0, Math.min(count - 1, value)) : 0; }
+export function createResearchCenterModel(snapshot, selected = 0) { return { snapshot, selected: clamp(selected, snapshot.rows.length), detail: null }; }
+export function moveResearchCenterSelection(model, delta) { return { ...model, selected: clamp(model.selected + delta, model.snapshot.rows.length), detail: null }; }
+export function selectedResearch(model) { return model.snapshot.rows[model.selected] ?? null; }
+export function setResearchCenterDetail(model, detail) { return { ...model, detail }; }
+export function renderResearchCenterLines(model) {
+    const lines = [t('screen.research.title')];
+    if (model.snapshot.state === 'invalid') {
+        lines.push('Store: invalid · ' + inert(model.snapshot.error?.code ?? 'RESEARCH_STORE_INVALID') + ' · ' + inert(model.snapshot.error?.message ?? 'unavailable'));
+        lines.push(t('screen.center.closeRefreshU'));
+        return lines;
+    }
+    if (!model.snapshot.rows.length) {
+        lines.push(t('screen.research.empty'));
+        lines.push(t('screen.center.closeRefreshU'));
+        return lines;
+    }
+    lines.push(...model.snapshot.rows.map((row, index) => (index === model.selected ? '› ' : '  ') + inert(row.status) + ' · ' + inert(row.question ?? row.name ?? 'untitled') + ' · ' + inert(row.id)));
+    const row = selectedResearch(model), detail = model.detail?.id === row?.id ? model.detail : null;
+    if (row) {
+        lines.push('ID: ' + inert(row.id) + ' · status ' + inert(row.status));
+        if (detail) {
+            lines.push('Phase: ' + inert(detail.phase ?? 'unavailable') + ' · progress ' + (detail.progress ? detail.progress.done + '/' + detail.progress.total : 'unmeasured'));
+            lines.push('Journal: ' + (detail.journal ? detail.journal.events + ' events · skipped ' + detail.journal.skippedRows : 'unavailable'));
+            if (detail.verification)
+                lines.push('Verification: total ' + detail.verification.total + ' · yes ' + detail.verification.supported + ' · partial ' + detail.verification.partial + ' · no ' + detail.verification.unsupported + ' · unchecked ' + detail.verification.unchecked + ' · contested ' + detail.verification.contested);
+            else
+                lines.push('Verification: unmeasured');
+            if (detail.summary)
+                lines.push('Summary: ' + inert(detail.summary));
+            if (detail.claims?.length) {
+                lines.push('Claims / evidence:');
+                for (const claim of detail.claims) {
+                    lines.push('- Claim ' + claim.number + ' [' + inert(claim.verification ?? 'unmeasured') + ']: ' + inert(claim.text));
+                    lines.push('  Source: ' + (claim.source ? claim.source.number + ' · ' + inert(claim.source.title) + ' · ' + inert(claim.source.url) : 'unavailable'));
+                    lines.push('  Passage: ' + inert(claim.passage || 'unavailable'));
+                    if (claim.reason)
+                        lines.push('  Reason: ' + inert(claim.reason));
+                }
+            }
+            else
+                lines.push('Claims / evidence: unmeasured');
+        }
+        else
+            lines.push('Detail: loading/unavailable');
+    }
+    lines.push(t('screen.research.keys'));
+    return lines;
+}
+// R1 Q-R1-3: the same lines as a capped, scrolling overlay — the list keeps the selection visible, the detail scrolls.
+export function researchCenterOverlay(model) {
+    const list = model.snapshot.state === 'invalid' ? 0 : model.snapshot.rows.length;
+    return listOverlay(renderResearchCenterLines(model), { head: 1, list, selected: model.selected, foot: 1, tones: centerTones });
+}