@north-light/crouter 0.3.173 → 0.3.174

package/dist/commands/sys/__tests__/setup-providers-viewport.test.js

@@ -1,155 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { mkdtempSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { stripVTControlCharacters } from 'node:util';
-import { applyTheme } from '../../../clients/attach/config.js';
-import { setAuthCredential } from '../../../core/auth-file.js';
-import { createSetupRuntime } from './helpers/setup-runtime.js';
-import { resolveKeybindings } from '../../../core/keybindings/index.js';
-import { buildSetupManifest } from '../setup-core.js';
-import { SetupWizard, visibleRange } from '../setup-wizard.js';
-// The provider panel only touches the TUI on async OAuth transitions, never in
-// these synchronous render/input tests; a no-op stub keeps the wizard headless.
-const stubTui = { requestRender() { } };
-// --- Unit coverage of the windowing math itself -----------------------------
-test('visibleRange keeps the selection inside the window at every position and capacity', () => {
-    const count = 30;
-    for (const capacity of [1, 2, 5, 12, count, count + 10]) {
-        for (const selected of [0, 1, Math.floor(count / 2), count - 2, count - 1]) {
-            const { start, end } = visibleRange(count, selected, capacity);
-            assert.ok(start <= selected && selected < end, `selected ${selected} must be within [${start},${end}) at capacity ${capacity}`);
-            assert.ok(end - start <= Math.max(1, Math.min(capacity, count)), `window must not exceed capacity ${capacity}`);
-            assert.ok(start >= 0 && end <= count, `window must stay within bounds at capacity ${capacity}`);
-        }
-    }
-});
-test('visibleRange returns an empty window for an empty collection', () => {
-    assert.deepEqual(visibleRange(0, 0, 5), { start: 0, end: 0 });
-});
-// --- Rendered-viewport coverage of the actual bug ---------------------------
-//
-// Providers is tab 0 (the wizard's default), so no tab-advance is needed. 'a'
-// opens the add-provider catalog; Escape returns to the configured roster.
-function makeWizard(rows, agentDir, runtime, registry) {
-    applyTheme({ cwd: process.cwd() });
-    const wizard = new SetupWizard(buildSetupManifest(), new Set(), [], stubTui, agentDir, runtime, registry, resolveKeybindings(undefined), undefined, rows);
-    wizard.focused = true;
-    return wizard;
-}
-// Every registry provider (35+) is a real, oversized catalog — no fixture needed.
-test('Providers add-catalog stays within the terminal-row budget and keeps the selection visible', async () => {
-    const agentDir = mkdtempSync(join(tmpdir(), 'setup-providers-catalog-'));
-    const { runtime, registry } = await createSetupRuntime(agentDir);
-    for (const terminalRows of [7, 8, 9, 10, 11, 12, 16, 24, 40]) {
-        const wizard = makeWizard(() => terminalRows, agentDir, runtime, registry);
-        const render = () => stripVTControlCharacters(wizard.render(100).join('\n')).split('\n');
-        wizard.handleInput('a'); // open the add-provider catalog
-        let lines = render();
-        assert.ok(lines.length <= terminalRows, `rows=${terminalRows}: emitted ${lines.length} lines, budget ${terminalRows}`);
-        assert.ok(lines.some((line) => line.includes('crtr sys setup')), `rows=${terminalRows}: wizard header must stay visible`);
-        assert.ok(lines.some((line) => line.includes('\u25b6')), `rows=${terminalRows}: selected row must be visible at top`);
-        // Walk to the middle of the catalog, then all the way to its last entry.
-        for (let i = 0; i < 15; i += 1)
-            wizard.handleInput('j');
-        lines = render();
-        assert.ok(lines.length <= terminalRows, `rows=${terminalRows}: overflowed after moving to the middle`);
-        assert.ok(lines.some((line) => line.includes('\u25b6')), `rows=${terminalRows}: selected row must be visible in the middle`);
-        for (let i = 0; i < 60; i += 1)
-            wizard.handleInput('j'); // clamp past the end
-        lines = render();
-        assert.ok(lines.length <= terminalRows, `rows=${terminalRows}: overflowed after moving to the last entry`);
-        assert.ok(lines.some((line) => line.includes('\u25b6')), `rows=${terminalRows}: selected row must be visible at the end`);
-        wizard.handleInput('\u001b'); // escape back to the roster
-    }
-});
-// A tiny fixture of configured API-key providers so the roster itself (not just
-// the catalog) also outgrows the viewport, exercising the "Add provider" sentinel.
-test('Providers configured roster stays within the terminal-row budget, including the Add-provider sentinel', async () => {
-    const agentDir = mkdtempSync(join(tmpdir(), 'setup-providers-roster-'));
-    const { runtime, registry } = await createSetupRuntime(agentDir);
-    const oauthIds = new Set(runtime.getProviders().filter((provider) => provider.auth.oauth !== undefined).map((provider) => provider.id));
-    const candidateProviders = [...new Set(registry.getAll().map((model) => model.provider))].filter((id) => !oauthIds.has(id) && id !== 'anthropic' && id !== 'openai-codex');
-    for (const providerId of candidateProviders.slice(0, 20)) {
-        await setAuthCredential(providerId, { type: 'api_key', key: 'sk-test-fixture' }, join(agentDir, 'auth.json'));
-    }
-    const panelRuntime = await createSetupRuntime(agentDir);
-    for (const terminalRows of [7, 8, 9, 10, 11, 12, 16, 24, 40]) {
-        const wizard = makeWizard(() => terminalRows, agentDir, panelRuntime.runtime, panelRuntime.registry);
-        const render = () => stripVTControlCharacters(wizard.render(100).join('\n')).split('\n');
-        let lines = render();
-        assert.ok(lines.length <= terminalRows, `rows=${terminalRows}: emitted ${lines.length} lines, budget ${terminalRows}`);
-        assert.ok(lines.some((line) => line.includes('crtr sys setup')), `rows=${terminalRows}: wizard header must stay visible`);
-        assert.ok(lines.some((line) => line.includes('\u25b6')), `rows=${terminalRows}: selected row must be visible at top`);
-        for (let i = 0; i < 10; i += 1)
-            wizard.handleInput('j');
-        lines = render();
-        assert.ok(lines.length <= terminalRows, `rows=${terminalRows}: overflowed after moving to the middle`);
-        assert.ok(lines.some((line) => line.includes('\u25b6')), `rows=${terminalRows}: selected row must be visible in the middle`);
-        for (let i = 0; i < 60; i += 1)
-            wizard.handleInput('j'); // clamp onto the trailing "Add provider" sentinel
-        lines = render();
-        assert.ok(lines.length <= terminalRows, `rows=${terminalRows}: overflowed after moving to the Add-provider sentinel`);
-        assert.ok(lines.some((line) => line.includes('\u25b6')), `rows=${terminalRows}: selected row must be visible at the sentinel`);
-        assert.ok(lines.some((line) => line.includes('Add provider')), `rows=${terminalRows}: Add-provider sentinel must render while selected`);
-    }
-});
-// Below 7 rows the wizard's OWN fixed chrome (header/tabs/divider/blank/footer,
-// 6 non-collapsible lines) already consumes the terminal, so the panel is
-// floored at its 1-row minimum regardless of terminal height — 7 is the lowest
-// height the renderer can meaningfully bound to. The panel itself must still
-// never overflow whatever budget it's actually given at that floor.
-test('Providers add-catalog degrades to just the selected row below the renderer\'s usable-height floor', async () => {
-    const agentDir = mkdtempSync(join(tmpdir(), 'setup-providers-catalog-floor-'));
-    const { runtime, registry } = await createSetupRuntime(agentDir);
-    for (const terminalRows of [1, 2, 3, 4, 5, 6]) {
-        const wizard = makeWizard(() => terminalRows, agentDir, runtime, registry);
-        const render = () => stripVTControlCharacters(wizard.render(100).join('\n')).split('\n');
-        wizard.handleInput('a');
-        const lines = render();
-        // The wizard's own 6 fixed chrome lines plus the panel's 1-row floor is the
-        // true minimum — assert that floor, not the (unreachable) terminalRows budget.
-        assert.ok(lines.length <= 7, `rows=${terminalRows}: emitted ${lines.length} lines, expected the 7-line floor`);
-        assert.ok(lines.some((line) => line.includes('\u25b6')), `rows=${terminalRows}: selected row must still be visible`);
-    }
-});
-// Below 7 rows the wizard's OWN fixed chrome (header/tabs/divider/blank/footer,
-// 6 non-collapsible lines) already consumes the terminal, so the panel is
-// floored at its 1-row minimum regardless of terminal height — 7 is the lowest
-// height the renderer can meaningfully bound to. The panel itself must still
-// never overflow whatever budget it's actually given at that floor.
-test('Providers configured roster degrades to just the selected row below the renderer\'s usable-height floor', async () => {
-    const agentDir = mkdtempSync(join(tmpdir(), 'setup-providers-roster-floor-'));
-    const { runtime, registry } = await createSetupRuntime(agentDir);
-    const oauthIds = new Set(runtime.getProviders().filter((provider) => provider.auth.oauth !== undefined).map((provider) => provider.id));
-    const candidateProviders = [...new Set(registry.getAll().map((model) => model.provider))].filter((id) => !oauthIds.has(id) && id !== 'anthropic' && id !== 'openai-codex');
-    for (const providerId of candidateProviders.slice(0, 20)) {
-        await setAuthCredential(providerId, { type: 'api_key', key: 'sk-test-fixture' }, join(agentDir, 'auth.json'));
-    }
-    const panelRuntime = await createSetupRuntime(agentDir);
-    for (const terminalRows of [1, 2, 3, 4, 5, 6]) {
-        const wizard = makeWizard(() => terminalRows, agentDir, panelRuntime.runtime, panelRuntime.registry);
-        const render = () => stripVTControlCharacters(wizard.render(100).join('\n')).split('\n');
-        const lines = render();
-        assert.ok(lines.length <= 7, `rows=${terminalRows}: emitted ${lines.length} lines, expected the 7-line floor`);
-        assert.ok(lines.some((line) => line.includes('\u25b6')), `rows=${terminalRows}: selected row must still be visible`);
-    }
-});
-// A height-only resize (no keypress) must invalidate the cached render.
-test('a height-only resize reflows the Providers viewport without a keypress', async () => {
-    const agentDir = mkdtempSync(join(tmpdir(), 'setup-providers-resize-'));
-    let terminalRows = 40;
-    const { runtime, registry } = await createSetupRuntime(agentDir);
-    const wizard = makeWizard(() => terminalRows, agentDir, runtime, registry);
-    wizard.handleInput('a');
-    for (let i = 0; i < 15; i += 1)
-        wizard.handleInput('j'); // selection in the middle of the catalog
-    const render = () => stripVTControlCharacters(wizard.render(100).join('\n')).split('\n');
-    const wide = render();
-    assert.ok(wide.length <= 40);
-    terminalRows = 12; // shrink WITHOUT sending any input
-    const shrunk = render();
-    assert.ok(shrunk.length <= 12, `resize must reflow immediately: emitted ${shrunk.length} lines at rows=12`);
-    assert.ok(shrunk.some((line) => line.includes('\u25b6')), 'selection must still be visible immediately after a height-only shrink');
-});

package/dist/commands/sys/__tests__/sync-deps.test.d.ts

@@ -1 +0,0 @@
-export {};

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

@@ -1,179 +0,0 @@
-// Regression: exact dependency-skill exclusions must remove only the selected
-// bundle, including its sidecars and catalog entry, while safe siblings remain.
-import { afterEach, test } from 'node:test';
-import assert from 'node:assert/strict';
-import { existsSync, mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { dirname, join } from 'node:path';
-import { closeDb } from '../../../core/canvas/db.js';
-import { resetScopeCache } from '../../../core/scope.js';
-import { spawnNode } from '../../../core/runtime/nodes.js';
-import { renderKnowledgeBlock } from '../../../core/substrate/render-node.js';
-import { clearSessionCache } from '../../../core/substrate/session-cache.js';
-import { runDepsSync, sysSyncDepsLeaf } from '../sync-deps.js';
-const projects = [];
-afterEach(() => {
-    for (const project of projects.splice(0))
-        rmSync(project, { recursive: true, force: true });
-});
-function write(path, content) {
-    mkdirSync(dirname(path), { recursive: true });
-    writeFileSync(path, content, 'utf8');
-}
-function assertVisibility(path, system, fileRead) {
-    const doc = readFileSync(path, 'utf8');
-    assert.match(doc, new RegExp(`^system-prompt-visibility: ${system}$`, 'm'));
-    assert.match(doc, new RegExp(`^file-read-visibility: ${fileRead}$`, 'm'));
-}
-test('renders the dependency boot catalog preview and generated bundle names without leaf prose', () => {
-    const originalHome = process.env.HOME;
-    const originalCrtrHome = process.env.CRTR_HOME;
-    const originalCwd = process.cwd();
-    const home = mkdtempSync(join(tmpdir(), 'crtr-sync-deps-render-home-'));
-    const project = join(home, 'project');
-    const canvasHome = join(home, 'canvas');
-    projects.push(home);
-    mkdirSync(project, { recursive: true });
-    try {
-        process.env.HOME = home;
-        process.env.CRTR_HOME = canvasHome;
-        process.chdir(project);
-        write(join(project, 'package.json'), JSON.stringify({ name: 'fixture' }));
-        const pkg = join(project, 'node_modules', 'fixture-skills');
-        write(join(pkg, 'package.json'), JSON.stringify({ name: 'fixture-skills', version: '1.2.3' }));
-        write(join(pkg, 'skills', 'flat', 'SKILL.md'), '---\ndescription: Flat bundle routing prose.\n---\n# Flat\n\nFLAT_BUNDLE_BODY\n');
-        write(join(pkg, 'skills', 'flat', 'reference.md'), '# Flat reference\n\nFLAT_SIDECAR_BODY\n');
-        write(join(pkg, 'skills', 'nested', 'child', 'SKILL.md'), '---\ndescription: Nested bundle routing prose.\n---\n# Nested\n\nNESTED_BUNDLE_BODY\n');
-        write(join(pkg, 'skills', 'nested', 'child', 'notes.md'), '# Nested notes\n\nNESTED_SIDECAR_BODY\n');
-        runDepsSync({ sourceArg: project, dryRun: false });
-        closeDb();
-        resetScopeCache();
-        clearSessionCache();
-        const node = spawnNode({ kind: 'general', cwd: project, parent: null }).node_id;
-        const boot = renderKnowledgeBlock(node);
-        assert.match(boot, /When writing code against this project's dependencies/, 'the top catalog stays preview-visible');
-        assert.doesNotMatch(boot, /Dependency-shipped agent docs \(generated\)/, 'the top catalog body stays hidden');
-        for (const name of ['flat', 'reference', 'nested', 'child', 'notes']) {
-            assert.ok(boot.includes(name), `expected generated name ${name} in boot output`);
-        }
-        for (const leaked of ['FLAT_BUNDLE_BODY', 'FLAT_SIDECAR_BODY', 'NESTED_BUNDLE_BODY', 'NESTED_SIDECAR_BODY', 'Flat bundle routing prose.', 'Nested bundle routing prose.']) {
-            assert.ok(!boot.includes(leaked), `generated leaf prose must not render: ${leaked}`);
-        }
-    }
-    finally {
-        closeDb();
-        resetScopeCache();
-        clearSessionCache();
-        process.chdir(originalCwd);
-        if (originalHome === undefined)
-            delete process.env.HOME;
-        else
-            process.env.HOME = originalHome;
-        if (originalCrtrHome === undefined)
-            delete process.env.CRTR_HOME;
-        else
-            process.env.CRTR_HOME = originalCrtrHome;
-    }
-});
-test('excludes one exact dependency bundle before vendoring while retaining safe sibling skills', async () => {
-    const project = mkdtempSync(join(tmpdir(), 'crtr-sync-deps-'));
-    projects.push(project);
-    writeFileSync(join(project, 'package.json'), JSON.stringify({
-        name: 'fixture',
-        crtr: {
-            sync: {
-                deps: {
-                    exclude: [{ package: '@fixture/skills', version: '1.2.3', skill: 'unsafe' }],
-                },
-            },
-        },
-    }), 'utf8');
-    const pkg = join(project, 'node_modules', '@fixture', 'skills');
-    write(join(pkg, 'package.json'), JSON.stringify({ name: '@fixture/skills', version: '1.2.3' }));
-    write(join(pkg, 'skills', 'safe', 'SKILL.md'), '---\ndescription: Safe dependency guidance.\n---\n# Safe\n');
-    write(join(pkg, 'skills', 'safe', 'reference.md'), '# Safe sidecar\n');
-    write(join(pkg, 'skills', 'unsafe', 'SKILL.md'), '---\ndescription: Unsafe dependency guidance.\n---\n# Unsafe\n');
-    write(join(pkg, 'skills', 'unsafe', 'reference.md'), '# Unsafe sidecar\n');
-    const dry = await sysSyncDepsLeaf.run({ source: project, dryRun: true });
-    const dryReport = sysSyncDepsLeaf.render(dry);
-    const result = await sysSyncDepsLeaf.run({ source: project });
-    const report = sysSyncDepsLeaf.render(result);
-    const rows = result?.results;
-    assert.match(dryReport, /dry run: 2 would import, 0 skipped, 1 excluded/);
-    assert.match(report, /2 imported, 0 skipped, 1 excluded/);
-    assert.ok(rows.some((row) => row.status === 'excluded' && row.name === '@fixture/skills@1.2.3:unsafe'));
-    const deps = join(project, '.crouter', 'memory', 'deps');
-    assert.equal(existsSync(join(deps, 'safe', 'INDEX.md')), true);
-    assert.equal(existsSync(join(deps, 'unsafe', 'INDEX.md')), false);
-    assert.equal(existsSync(join(deps, 'unsafe', 'reference.md')), false);
-    assertVisibility(join(deps, 'safe', 'INDEX.md'), 'name', 'none');
-    assertVisibility(join(deps, 'safe', 'reference.md'), 'name', 'none');
-    const catalog = join(deps, 'INDEX.md');
-    assertVisibility(catalog, 'preview', 'none');
-    const catalogBody = readFileSync(catalog, 'utf8');
-    assert.match(catalogBody, /deps\/safe/);
-    assert.doesNotMatch(catalogBody, /unsafe/);
-    write(join(project, 'package.json'), JSON.stringify({
-        name: 'fixture',
-        crtr: { sync: { deps: { exclude: [{ package: '@fixture/skills', version: '1.2.4', skill: 'unsafe' }] } } },
-    }));
-    assert.throws(() => runDepsSync({ sourceArg: project, dryRun: true }), /does not match an installed dependency skill bundle/);
-});
-test('excludes a parent bundle without deleting its included nested bundle', () => {
-    const project = mkdtempSync(join(tmpdir(), 'crtr-sync-deps-nested-'));
-    projects.push(project);
-    write(join(project, 'package.json'), JSON.stringify({
-        name: 'fixture',
-        crtr: { sync: { deps: { exclude: [{ package: 'fixture-skills', version: '1.2.3', skill: 'parent' }] } } },
-    }));
-    const pkg = join(project, 'node_modules', 'fixture-skills');
-    write(join(pkg, 'package.json'), JSON.stringify({ name: 'fixture-skills', version: '1.2.3' }));
-    write(join(pkg, 'skills', 'parent', 'SKILL.md'), '---\ndescription: Parent guidance.\n---\n# Parent\n');
-    write(join(pkg, 'skills', 'parent', 'reference.md'), '# Parent sidecar\n');
-    write(join(pkg, 'skills', 'parent', 'child', 'SKILL.md'), '---\ndescription: Child guidance.\n---\n# Child\n');
-    write(join(pkg, 'skills', 'parent', 'child', 'reference.md'), '# Child sidecar\n');
-    runDepsSync({ sourceArg: project, dryRun: false });
-    const deps = join(project, '.crouter', 'memory', 'deps', 'parent');
-    assert.equal(existsSync(join(deps, 'INDEX.md')), false);
-    assert.equal(existsSync(join(deps, 'reference.md')), false);
-    assert.equal(existsSync(join(deps, 'child', 'INDEX.md')), true);
-    assert.equal(existsSync(join(deps, 'child', 'reference.md')), true);
-    assertVisibility(join(deps, 'child', 'INDEX.md'), 'name', 'none');
-    assertVisibility(join(deps, 'child', 'reference.md'), 'name', 'none');
-});
-test('writes a truthful empty catalog when exclusions remove every bundle', () => {
-    const project = mkdtempSync(join(tmpdir(), 'crtr-sync-deps-empty-'));
-    projects.push(project);
-    write(join(project, 'package.json'), JSON.stringify({
-        name: 'fixture',
-        crtr: { sync: { deps: { exclude: [{ package: 'fixture-skills', version: '1.2.3', skill: 'unsafe' }] } } },
-    }));
-    const pkg = join(project, 'node_modules', 'fixture-skills');
-    write(join(pkg, 'package.json'), JSON.stringify({ name: 'fixture-skills', version: '1.2.3' }));
-    write(join(pkg, 'skills', 'unsafe', 'SKILL.md'), '---\ndescription: Unsafe guidance.\n---\n# Unsafe\n');
-    write(join(pkg, 'skills', 'loose.md'), '# Not an Agent Skill bundle\n');
-    runDepsSync({ sourceArg: project, dryRun: false });
-    const deps = join(project, '.crouter', 'memory', 'deps');
-    const catalog = readFileSync(join(deps, 'INDEX.md'), 'utf8');
-    assert.equal(existsSync(join(deps, 'loose.md')), false);
-    assert.match(catalog, /No dependency agent docs are currently vendored\./);
-    assert.doesNotMatch(catalog, /vendored below/);
-    assert.doesNotMatch(catalog, /dependencies \(\)/);
-});
-test('excludes root-bundle nested sidecars without removing a sibling bundle', () => {
-    const project = mkdtempSync(join(tmpdir(), 'crtr-sync-deps-root-'));
-    projects.push(project);
-    write(join(project, 'package.json'), JSON.stringify({
-        name: 'fixture',
-        crtr: { sync: { deps: { exclude: [{ package: 'fixture-skills', version: '1.2.3', skill: '.' }] } } },
-    }));
-    const pkg = join(project, 'node_modules', 'fixture-skills');
-    write(join(pkg, 'package.json'), JSON.stringify({ name: 'fixture-skills', version: '1.2.3' }));
-    write(join(pkg, 'skills', 'SKILL.md'), '---\ndescription: Root guidance.\n---\n# Root\n');
-    write(join(pkg, 'skills', 'references', 'unsafe.md'), '# Root sidecar\n');
-    write(join(pkg, 'skills', 'safe', 'SKILL.md'), '---\ndescription: Safe guidance.\n---\n# Safe\n');
-    runDepsSync({ sourceArg: project, dryRun: false });
-    assert.equal(existsSync(join(project, '.crouter', 'memory', 'deps', 'fixture-skills', 'INDEX.md')), false);
-    assert.equal(existsSync(join(project, '.crouter', 'memory', 'deps', 'references', 'unsafe.md')), false);
-    assert.equal(existsSync(join(project, '.crouter', 'memory', 'deps', 'safe', 'INDEX.md')), true);
-});

package/dist/commands/sys/__tests__/sync-import.test.d.ts

@@ -1 +0,0 @@
-export {};