agentic-workflow-manager 2.1.0 → 3.0.0

package/dist/src/index.js

@@ -9,6 +9,8 @@ const commander_1 = require("commander");
 const config_1 = require("./utils/config");
 const grouping_1 = require("./utils/grouping");
 const registry_view_1 = require("./utils/registry-view");
+const tty_1 = require("./ui/tty");
+const picker_1 = require("./ui/picker");
 const providers_1 = require("./providers");
 const executor_1 = require("./core/executor");
 const regenerate_1 = require("./core/context/regenerate");
@@ -73,6 +75,7 @@ program.command('add [name]')
     .option('-s, --scope <scope>', 'Scope: local or global')
     .option('-m, --method <method>', 'Install method: symlink or copy')
     .option('-y, --yes', 'Skip confirmation prompts')
+    .option('--all', 'install all artifacts from all packages without prompting')
     .action(async (name, options) => {
     (0, prompts_1.intro)(picocolors_1.default.bgCyan(picocolors_1.default.black(' AWM - Agentic Workflow Manager ')));
     // 1. Sync the registry
@@ -142,6 +145,10 @@ program.command('add [name]')
             (0, prompts_1.outro)(`✅ Installed bundle ${picocolors_1.default.cyan(matchedBundle.name)}:\n  ${lines}${recordNote}`);
             return;
         }
+        // name given but no matching bundle found — report clearly regardless of TTY
+        console.error(picocolors_1.default.red(`Bundle "${name}" not found in registry.`));
+        console.error(picocolors_1.default.dim('Run `awm list` to see available packages.'));
+        process.exit(1);
     }
     // 2. Discover artifacts
     const skills = (0, discovery_1.discoverSkills)();
@@ -152,6 +159,103 @@ program.command('add [name]')
         process.exit(0);
     }
     const prefs = (0, config_1.getPreferences)();
+    // --all: install everything from every package headlessly
+    if (options.all) {
+        let targetAgents;
+        if (options.agent) {
+            const validAgents = Object.keys(providers_1.PROVIDERS);
+            const parsed = options.agent.split(',').map((a) => a.trim());
+            for (const a of parsed) {
+                if (!validAgents.includes(a)) {
+                    console.error(picocolors_1.default.red(`Invalid agent "${a}". Use: ${validAgents.join(', ')}.`));
+                    process.exit(1);
+                }
+            }
+            targetAgents = parsed;
+        }
+        else {
+            targetAgents = [prefs.defaultAgent];
+        }
+        let scopeVal;
+        if (options.scope) {
+            if (!['local', 'global'].includes(options.scope)) {
+                console.error(picocolors_1.default.red(`Invalid scope "${options.scope}". Use: local or global.`));
+                process.exit(1);
+            }
+            scopeVal = options.scope;
+        }
+        else {
+            scopeVal = prefs.defaultScope;
+        }
+        let methodVal;
+        if (options.method) {
+            if (!['symlink', 'copy'].includes(options.method)) {
+                console.error(picocolors_1.default.red(`Invalid method "${options.method}". Use: symlink or copy.`));
+                process.exit(1);
+            }
+            methodVal = options.method;
+        }
+        else {
+            methodVal = scopeVal === 'local' ? 'copy' : 'symlink';
+        }
+        const includeWorkflows = targetAgents.some((a) => providers_1.PROVIDERS[a].workflow !== null);
+        const includeAgents = targetAgents.some((a) => providers_1.PROVIDERS[a].agent !== null);
+        const allView = (0, registry_view_1.buildPackageView)(skills, includeWorkflows ? workflows : [], includeAgents ? agents : [], (0, bundles_1.discoverAllBundles)());
+        const allDedup = new Map();
+        for (const pkg of allView) {
+            for (const a of pkg.artifacts) {
+                allDedup.set((0, registry_view_1.artifactValue)(a), a);
+            }
+        }
+        const artifactsToInstall = Array.from(allDedup.values()).map((a) => ({
+            name: a.installName,
+            sourcePath: a.sourcePath,
+            type: a.type,
+        }));
+        if (artifactsToInstall.length === 0) {
+            (0, prompts_1.outro)(picocolors_1.default.yellow('No artifacts available.'));
+            return;
+        }
+        const installSpinner = (0, prompts_1.spinner)();
+        installSpinner.start('Installing artifacts...');
+        try {
+            const installed = [];
+            const skipped = [];
+            for (const currentAgent of targetAgents) {
+                for (const artifact of artifactsToInstall) {
+                    if (providers_1.PROVIDERS[currentAgent][artifact.type] === null) {
+                        skipped.push(`${artifact.name} (${currentAgent})`);
+                        continue;
+                    }
+                    const targetDir = (0, providers_1.getTargetPath)(artifact.type, currentAgent, scopeVal);
+                    const finalDest = path_1.default.join(targetDir, artifact.name);
+                    (0, executor_1.installArtifact)(artifact.sourcePath, finalDest, methodVal);
+                    installed.push(`${artifact.name} → ${currentAgent} (${scopeVal})`);
+                }
+            }
+            (0, config_1.savePreferences)({ defaultAgent: targetAgents[0], defaultScope: scopeVal, installMethod: methodVal });
+            installSpinner.stop('Installation complete!');
+            if (skipped.length > 0) {
+                for (const sk of skipped) {
+                    console.log(picocolors_1.default.yellow(`  ⚠️  Skipped: ${sk} (not supported by target agent)`));
+                }
+            }
+            const names = installed.map((n) => picocolors_1.default.green(n)).join('\n  ');
+            (0, prompts_1.outro)(`✅ Installed:\n  ${names}`);
+        }
+        catch (e) {
+            installSpinner.stop('Installation failed.');
+            console.error(picocolors_1.default.red(e.message));
+            process.exit(1);
+        }
+        return;
+    }
+    // Interactive selection requires a TTY. Bundle-by-name (handled above) works headless.
+    if (!(0, tty_1.isInteractive)()) {
+        console.error(picocolors_1.default.red('`awm add` needs an interactive terminal for selection.'));
+        console.error(picocolors_1.default.dim('Install a bundle non-interactively: `awm add <bundle>` (optionally with --agent/--scope).'));
+        process.exit(1);
+    }
     // 3. Agent & Scope Prompts (Moved up)
     let targetAgents;
     if (options.agent) {
@@ -207,27 +311,35 @@ program.command('add [name]')
         process.exit(0);
     }
     // 5. Level 1 — pick package(s)
-    const pkgChoice = await (0, prompts_1.multiselect)({
-        message: 'Select package(s)',
-        options: (0, registry_view_1.buildLevel1Options)(view),
-        required: true
+    const pickedPackages = await (0, picker_1.multiselectPicker)({
+        title: 'Select package(s)',
+        items: (0, registry_view_1.packagePickerItems)(view),
     });
-    handleCancel(pkgChoice);
-    const selectedPackages = pkgChoice
-        .map(name => view.find(p => p.name === name))
+    if (pickedPackages === null) {
+        (0, prompts_1.outro)('Operation cancelled.');
+        process.exit(0);
+    }
+    if (pickedPackages.length === 0) {
+        (0, prompts_1.outro)(picocolors_1.default.yellow('No packages selected.'));
+        return;
+    }
+    const selectedPackages = pickedPackages
+        .map((name) => view.find((p) => p.name === name))
         .filter(Boolean);
     // 5b. Level 2 — pick skills within each package, in sequence
     const dedup = new Map();
     for (let i = 0; i < selectedPackages.length; i++) {
         const pkg = selectedPackages[i];
-        const skillChoice = await (0, prompts_1.multiselect)({
-            message: `[${i + 1}/${selectedPackages.length}] ${pkg.name} — select artifacts`,
-            options: (0, registry_view_1.buildLevel2Options)(pkg),
-            initialValues: [registry_view_1.ALL_SENTINEL],
-            required: true
+        const picked = await (0, picker_1.multiselectPicker)({
+            title: `[${i + 1}/${selectedPackages.length}] ${pkg.name} — select artifacts`,
+            items: (0, registry_view_1.artifactPickerItems)(pkg),
+            initialSelected: [registry_view_1.ALL_SENTINEL, ...pkg.artifacts.map((a) => (0, registry_view_1.artifactValue)(a))],
         });
-        handleCancel(skillChoice);
-        for (const a of (0, registry_view_1.resolveLevel2Selection)(pkg, skillChoice)) {
+        if (picked === null) {
+            (0, prompts_1.outro)('Operation cancelled.');
+            process.exit(0);
+        }
+        for (const a of (0, registry_view_1.resolveLevel2Selection)(pkg, picked)) {
             dedup.set((0, registry_view_1.artifactValue)(a), a);
         }
     }
@@ -469,6 +581,7 @@ program.command('list [package]')
     if (packageName && options.all) {
         console.log(picocolors_1.default.dim('(Ignoring --all when a package name is provided.)'));
     }
+    const listWidth = process.stdout.isTTY ? process.stdout.columns : undefined;
     // Detail for a single package.
     if (packageName) {
         const { match, suggestion } = (0, registry_view_1.findPackage)(fullView, packageName);
@@ -480,7 +593,7 @@ program.command('list [package]')
             process.exit(1);
         }
         console.log();
-        for (const line of (0, registry_view_1.packageDetailLines)(match))
+        for (const line of (0, registry_view_1.packageDetailLines)(match, listWidth))
             console.log(line);
         console.log();
         (0, prompts_1.outro)(`Run ${picocolors_1.default.green(`awm add`)} to install artifacts from ${picocolors_1.default.cyan(match.name)}.`);
@@ -490,7 +603,7 @@ program.command('list [package]')
     if (options.all) {
         for (const pkg of view) {
             console.log();
-            for (const line of (0, registry_view_1.packageDetailLines)(pkg))
+            for (const line of (0, registry_view_1.packageDetailLines)(pkg, listWidth))
                 console.log(line);
         }
         console.log();
@@ -499,7 +612,7 @@ program.command('list [package]')
     }
     // Default: compact summary.
     console.log();
-    for (const line of (0, registry_view_1.packageSummaryLines)(view))
+    for (const line of (0, registry_view_1.packageSummaryLines)(view, listWidth))
         console.log(line);
     console.log();
     console.log(picocolors_1.default.dim(`  awm list <pkg>  ·  awm list --all`));

package/dist/src/release/core.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GIT_LOG_FORMAT = exports.US = exports.RS = exports.PKG_NAME = void 0;
+exports.parseCommits = parseCommits;
+exports.determineBump = determineBump;
+exports.nextVersion = nextVersion;
+exports.selectFloor = selectFloor;
+exports.renderChangelog = renderChangelog;
+const versioning_1 = require("../core/versioning");
+exports.PKG_NAME = 'agentic-workflow-manager';
+exports.RS = '\x1e';
+exports.US = '\x1f';
+exports.GIT_LOG_FORMAT = `%s${exports.US}%b${exports.RS}`;
+const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)$/;
+const HEADER_RE = /^(\w+)(?:\(([^)]+)\))?(!)?:\s+(.+)$/;
+function parseOne(record) {
+    const [header, ...rest] = record.split(exports.US);
+    const body = rest.join(exports.US);
+    const m = HEADER_RE.exec(header.trim());
+    if (!m)
+        return null;
+    return {
+        type: m[1],
+        scope: m[2] ?? null,
+        breaking: Boolean(m[3]) || /^BREAKING CHANGE:/m.test(body),
+        subject: m[4].trim(),
+    };
+}
+function parseCommits(raw) {
+    return raw
+        .split(exports.RS)
+        .map((r) => r.trim())
+        .filter(Boolean)
+        .map(parseOne)
+        .filter((c) => c !== null);
+}
+function determineBump(commits) {
+    if (commits.some((c) => c.breaking))
+        return 'major';
+    if (commits.some((c) => c.type === 'feat'))
+        return 'minor';
+    if (commits.some((c) => c.type === 'fix' || c.type === 'perf'))
+        return 'patch';
+    return null;
+}
+function nextVersion(base, bump) {
+    const m = SEMVER_RE.exec((base ?? '').trim());
+    if (!m)
+        throw new Error(`Invalid base version: "${base}"`);
+    const [maj, min, pat] = [Number(m[1]), Number(m[2]), Number(m[3])];
+    if (bump === 'major')
+        return `${maj + 1}.0.0`;
+    if (bump === 'minor')
+        return `${maj}.${min + 1}.0`;
+    return `${maj}.${min}.${pat + 1}`;
+}
+function selectFloor(current, lastTagVersion) {
+    if (!SEMVER_RE.test((current ?? '').trim())) {
+        throw new Error(`Invalid current version: "${current}"`);
+    }
+    const cur = current.trim();
+    if (!lastTagVersion)
+        return cur;
+    return (0, versioning_1.compareSemver)(cur, lastTagVersion) >= 0 ? cur : lastTagVersion;
+}
+function line(c) {
+    return c.scope ? `- **${c.scope}:** ${c.subject}` : `- ${c.subject}`;
+}
+function renderChangelog(version, dateISO, commits) {
+    const sections = [`## v${version} - ${dateISO}`, ''];
+    const groups = [
+        ['Breaking Changes', (c) => c.breaking],
+        ['Features', (c) => !c.breaking && c.type === 'feat'],
+        ['Fixes', (c) => !c.breaking && (c.type === 'fix' || c.type === 'perf')],
+    ];
+    for (const [title, pred] of groups) {
+        const items = commits.filter(pred);
+        if (items.length === 0)
+            continue;
+        sections.push(`### ${title}`, ...items.map(line), '');
+    }
+    return sections.join('\n').trimEnd() + '\n';
+}

package/dist/src/release/index.js

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+exports.main = main;
+// cli/src/release/index.ts
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const orchestrator_1 = require("./orchestrator");
+function parseArgs(argv) {
+    const opts = { dryRun: false, force: null, push: true, branch: 'main', cliDir: '' };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--dry-run')
+            opts.dryRun = true;
+        else if (a === '--no-push')
+            opts.push = false;
+        else if (a === '--branch') {
+            const val = argv[++i];
+            if (val === undefined || val.startsWith('--')) {
+                throw new Error('--branch requiere un valor (ej: --branch main)');
+            }
+            opts.branch = val;
+        }
+        else if (a === '--force') {
+            const lvl = argv[++i];
+            if (lvl !== 'major' && lvl !== 'minor' && lvl !== 'patch') {
+                throw new Error(`--force requiere major|minor|patch, recibió "${lvl}"`);
+            }
+            opts.force = lvl;
+        }
+        else {
+            throw new Error(`Flag desconocida: ${a}`);
+        }
+    }
+    return opts;
+}
+function realIO(repoRoot, cliDir) {
+    const pkgPath = path_1.default.join(cliDir, 'package.json');
+    const changelogPath = path_1.default.join(repoRoot, 'CHANGELOG.md');
+    const npmrcPath = path_1.default.join(cliDir, '.npmrc');
+    return {
+        run(cmd, args, o) {
+            return (0, child_process_1.execFileSync)(cmd, args, { cwd: o?.cwd ?? repoRoot, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+        },
+        readPackageVersion: () => JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf8')).version,
+        writePackageVersion: (v) => {
+            const pkg = JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf8'));
+            pkg.version = v;
+            fs_1.default.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+        },
+        readChangelog: () => (fs_1.default.existsSync(changelogPath) ? fs_1.default.readFileSync(changelogPath, 'utf8') : ''),
+        writeChangelog: (c) => fs_1.default.writeFileSync(changelogPath, c),
+        writeNpmrc: (token) => fs_1.default.writeFileSync(npmrcPath, `//registry.npmjs.org/:_authToken=${token}\n`),
+        removeNpmrc: () => { if (fs_1.default.existsSync(npmrcPath))
+            fs_1.default.rmSync(npmrcPath); },
+        today: () => new Date().toISOString().slice(0, 10),
+        log: (m) => console.log(m),
+        env: process.env,
+    };
+}
+function main(argv) {
+    let opts;
+    try {
+        opts = parseArgs(argv);
+    }
+    catch (e) {
+        console.error(e.message);
+        return 2;
+    }
+    // __dirname en dist/src/release/ → 4 niveles arriba = repoRoot
+    // dist/src/release → dist/src → dist → cli → repoRoot
+    const repoRoot = path_1.default.resolve(__dirname, '..', '..', '..', '..');
+    const cliDir = path_1.default.resolve(repoRoot, 'cli');
+    opts.cliDir = cliDir;
+    try {
+        const res = (0, orchestrator_1.release)(opts, realIO(repoRoot, cliDir));
+        if (res.released)
+            console.log(`✓ Publicado v${res.version}`);
+        else
+            console.log(`· Sin release: ${res.reason}${res.version ? ` (v${res.version})` : ''}`);
+        return 0;
+    }
+    catch (e) {
+        console.error(`✗ ${e.message}`);
+        return 1;
+    }
+}
+if (require.main === module) {
+    process.exit(main(process.argv.slice(2)));
+}

package/dist/src/release/orchestrator.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.release = release;
+// cli/src/release/orchestrator.ts
+const core_1 = require("./core");
+const TAG_RE = /^v(\d+)\.(\d+)\.(\d+)$/;
+function highestTag(io) {
+    const raw = io.run('git', ['tag', '--list', 'v*']).trim();
+    const tags = raw.split('\n').map((t) => t.trim()).filter((t) => TAG_RE.test(t));
+    if (tags.length === 0)
+        return null;
+    tags.sort((a, b) => {
+        const [, a1, a2, a3] = TAG_RE.exec(a).map(Number);
+        const [, b1, b2, b3] = TAG_RE.exec(b).map(Number);
+        return a1 - b1 || a2 - b2 || a3 - b3;
+    });
+    return tags[tags.length - 1];
+}
+function release(opts, io) {
+    // --- preflight gates (contrato, antes de cualquier early-exit) ---
+    if (!opts.force) {
+        const branch = io.run('git', ['rev-parse', '--abbrev-ref', 'HEAD']).trim();
+        if (branch !== opts.branch) {
+            throw new Error(`Rama actual "${branch}" != esperada "${opts.branch}" (usá --force para relajar)`);
+        }
+    }
+    if (!opts.dryRun) {
+        const dirty = io.run('git', ['status', '--porcelain']).trim();
+        if (dirty)
+            throw new Error('Working tree con cambios sin commitear — abortando');
+        if (!io.env.NPM_TOKEN && !io.env.NODE_AUTH_TOKEN && !io.env.ACTIONS_ID_TOKEN_REQUEST_URL) {
+            throw new Error('Falta credencial de publicación: configurá NPM_TOKEN, NODE_AUTH_TOKEN, o usa OIDC (id-token: write en GitHub Actions)');
+        }
+    }
+    // baseline
+    const current = io.readPackageVersion();
+    const lastTag = highestTag(io); // "vX.Y.Z" | null
+    const lastTagVersion = lastTag ? lastTag.slice(1) : null;
+    const floor = (0, core_1.selectFloor)(current, lastTagVersion);
+    // rango de commits (solo cli/)
+    const range = lastTag ? [`${lastTag}..HEAD`] : [];
+    const logArgs = ['log', ...range, '--no-merges', `--format=${core_1.GIT_LOG_FORMAT}`, '--', 'cli/'];
+    const commits = (0, core_1.parseCommits)(io.run('git', logArgs));
+    // bump
+    const bump = opts.force ?? (0, core_1.determineBump)(commits);
+    if (!bump)
+        return { released: false, reason: 'nada que publicar (no releasable commits)' };
+    const version = (0, core_1.nextVersion)(floor, bump);
+    // GATE idempotencia
+    if (io.run('git', ['tag', '--list', `v${version}`]).trim()) {
+        throw new Error(`El tag v${version} ya existe — abortando`);
+    }
+    let published = '';
+    try {
+        published = io.run('npm', ['view', `${core_1.PKG_NAME}@${version}`, 'version']).trim();
+    }
+    catch {
+        published = '';
+    }
+    if (published)
+        throw new Error(`${core_1.PKG_NAME}@${version} ya está publicado en npm — abortando`);
+    if (opts.dryRun) {
+        io.log(`[dry-run] publicaría v${version} (bump=${bump}, base=${floor})`);
+        return { released: false, version, reason: 'dry-run' };
+    }
+    // aplicar
+    io.writePackageVersion(version);
+    const section = (0, core_1.renderChangelog)(version, io.today(), commits);
+    io.writeChangelog(section + '\n' + io.readChangelog());
+    io.run('git', ['add', 'cli/package.json', 'CHANGELOG.md']);
+    io.run('git', ['commit', '-m', `chore(release): v${version} [skip ci]`]);
+    io.run('git', ['tag', '-a', `v${version}`, '-m', `v${version}`]);
+    // OIDC mode: GitHub inyecta ACTIONS_ID_TOKEN_REQUEST_URL con id-token:write
+    //            o NODE_AUTH_TOKEN sin NPM_TOKEN (setup-node legacy con OIDC)
+    // Legacy mode (NPM_TOKEN): write .npmrc temporal, cleanup en finally
+    const useOidc = !io.env.NPM_TOKEN &&
+        (!!io.env.ACTIONS_ID_TOKEN_REQUEST_URL || !!io.env.NODE_AUTH_TOKEN);
+    let publishError;
+    if (useOidc) {
+        try {
+            io.run('npm', ['publish', '--provenance'], { cwd: opts.cliDir });
+        }
+        catch (e) {
+            publishError = e;
+        }
+    }
+    else {
+        const token = io.env.NPM_TOKEN;
+        try {
+            io.writeNpmrc(token);
+            io.run('npm', ['publish'], { cwd: opts.cliDir });
+        }
+        catch (e) {
+            publishError = e;
+        }
+        finally {
+            io.removeNpmrc();
+        }
+    }
+    if (publishError) {
+        try {
+            io.run('git', ['tag', '-d', `v${version}`]);
+        }
+        catch { /* best effort */ }
+        try {
+            io.run('git', ['reset', '--hard', 'HEAD~1']);
+        }
+        catch { /* best effort */ }
+        throw publishError;
+    }
+    if (opts.push) {
+        io.run('git', ['push', 'origin', opts.branch]);
+        io.run('git', ['push', 'origin', `v${version}`]);
+    }
+    return { released: true, version };
+}

package/dist/src/ui/picker-view.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TWO_PANE_MIN_COLUMNS = void 0;
+exports.visibleItems = visibleItems;
+exports.renderPicker = renderPicker;
+const picocolors_1 = __importDefault(require("picocolors"));
+const text_1 = require("./text");
+exports.TWO_PANE_MIN_COLUMNS = 72;
+const FOOTER = '↑↓ move · space select · tab all · ⏎ confirm · esc clear';
+function visibleItems(state) {
+    if (!state.filter)
+        return state.items;
+    const q = state.filter.toLowerCase();
+    return state.items.filter((i) => i.label.toLowerCase().includes(q));
+}
+/** Compute a scroll window [start, end) around the cursor that fits `height` rows. */
+function windowFor(cursor, total, height) {
+    if (total <= height)
+        return [0, total];
+    let start = cursor - Math.floor(height / 2);
+    start = Math.max(0, Math.min(start, total - height));
+    return [start, start + height];
+}
+function checkbox(selected) {
+    return selected ? picocolors_1.default.green('◼') : '◻';
+}
+function renderPicker(state, vp) {
+    const vis = visibleItems(state);
+    const cursor = Math.max(0, Math.min(state.cursor, vis.length - 1));
+    const selCount = state.selected.size;
+    const filterPart = state.filter ? `   filter: ${state.filter}` : '';
+    const header = picocolors_1.default.bold(state.title) + filterPart + (selCount ? picocolors_1.default.dim(`   ${selCount} sel`) : '');
+    const out = [header];
+    if (vis.length === 0) {
+        out.push(picocolors_1.default.dim('  (no matches)'));
+        out.push(FOOTER);
+        return out;
+    }
+    const bodyHeight = Math.max(3, vp.rows - 4); // header + footer + breathing room
+    const [start, end] = windowFor(cursor, vis.length, bodyHeight);
+    const twoPane = vp.columns >= exports.TWO_PANE_MIN_COLUMNS;
+    const listWidth = twoPane ? Math.floor(vp.columns * 0.5) : vp.columns - 2;
+    const rows = [];
+    for (let i = start; i < end; i++) {
+        const item = vis[i];
+        const isCursor = i === cursor;
+        const marker = isCursor ? picocolors_1.default.cyan('❯') : ' ';
+        const box = checkbox(state.selected.has(item.value));
+        const labelWidth = listWidth - 5; // wide cursor marker (2 cells) + space + checkbox + space
+        const label = (0, text_1.truncate)(item.label, labelWidth);
+        rows.push(`${marker} ${box} ${label}`);
+    }
+    if (twoPane) {
+        const detailWidth = vp.columns - listWidth - 3; // gutter " │ "
+        const detail = (0, text_1.wrap)(vis[cursor].description, detailWidth).slice(0, rows.length);
+        const height = Math.max(rows.length, detail.length);
+        for (let i = 0; i < height; i++) {
+            const leftPadded = padToWidth(rows[i] ?? '', listWidth);
+            const right = detail[i] ?? '';
+            out.push(`${leftPadded} ${picocolors_1.default.dim('│')} ${picocolors_1.default.dim(right)}`);
+        }
+    }
+    else {
+        out.push(...rows);
+        out.push(picocolors_1.default.dim('  ' + ((0, text_1.wrap)(vis[cursor].description, vp.columns - 4)[0] ?? '')));
+    }
+    out.push(FOOTER);
+    return out;
+}
+/** Pad a possibly-colored string to `width` visible cells. */
+function padToWidth(s, width) {
+    const pad = width - (0, text_1.displayWidth)(s);
+    return pad > 0 ? s + ' '.repeat(pad) : s;
+}