@event4u/agent-config 2.25.0 → 3.0.0

package/dist/cli/agent-config.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+/**
+ * `agent-config` — TS shell entry point.
+ *
+ * Phase 2 behaviour:
+ *   - Parses `--version`, `--help`, `versions`, `doctor-shell` natively.
+ *   - Forwards every other registered subcommand to the Bash dispatcher
+ *     via `delegateToBash` (preserves all existing dispatch logic).
+ *   - Unknown subcommands also forward (the Bash dispatcher prints
+ *     the canonical "unknown command" error) so the TS shell never
+ *     drifts from the Bash subcommand surface.
+ *
+ * Phase 5 will reverse the delegation direction.
+ */
+import { readFileSync } from 'node:fs';
+import { Command } from 'commander';
+import { PACKAGE_JSON } from './paths.js';
+import { delegateToBash } from './bash/runBash.js';
+import { runVersions } from './commands/versions.js';
+import { runDoctorShell } from './commands/doctorShell.js';
+import { runUiServe } from './commands/uiServe.js';
+import { runSettings } from './commands/settings.js';
+import { runWorkspacesLs } from './commands/workspaces.js';
+import { runPacksLs } from './commands/packs.js';
+import { logger } from './log/logger.js';
+import { REGISTRY } from './registry.js';
+function readVersion() {
+    const pkg = JSON.parse(readFileSync(PACKAGE_JSON, 'utf8'));
+    return typeof pkg.version === 'string' ? pkg.version : '0.0.0';
+}
+function buildHelp() {
+    const lines = [
+        'agent-config — event4u/agent-config CLI (TS shell)',
+        '',
+        'Usage:',
+        '  agent-config <command> [options]',
+        '  agent-config --help',
+        '  agent-config --version',
+        '',
+        'Native commands (TS shell):',
+    ];
+    for (const entry of REGISTRY) {
+        if (entry.disposition !== 'native')
+            continue;
+        const synopsis = entry.synopsis ?? '';
+        lines.push(`  ${entry.name.padEnd(22)} ${synopsis}`);
+    }
+    lines.push('');
+    lines.push('All other subcommands delegate to the Bash dispatcher.');
+    lines.push('Run `agent-config help --tier=all` for the full Bash-side surface.');
+    return lines.join('\n');
+}
+async function main(argv) {
+    const program = new Command();
+    program
+        .name('agent-config')
+        .description('event4u/agent-config CLI shell')
+        .version(readVersion(), '-V, --version', 'Print package version')
+        .helpOption('-h, --help', 'Show this help')
+        .allowUnknownOption(true)
+        .allowExcessArguments(true);
+    program
+        .command('versions')
+        .description('List @event4u/agent-config versions')
+        .option('--offline', 'Skip npm registry probe')
+        .option('--json', 'Emit machine-readable JSON')
+        .option('--limit <n>', 'Show at most N recent versions', (v) => Number.parseInt(v, 10), 10)
+        .action(async (opts) => {
+        const code = await runVersions(opts);
+        process.exit(code);
+    });
+    program
+        .command('doctor-shell')
+        .description('Probe the TS-shell environment')
+        .action(() => {
+        const code = runDoctorShell();
+        process.exit(code);
+    });
+    program
+        .command('ui:serve')
+        .description('Start the local UI server (127.0.0.1, auto-picked port)')
+        .option('--port <n>', 'Override the auto-picked port', (v) => Number.parseInt(v, 10))
+        .option('--no-open', 'Do not launch the browser')
+        .option('--ui-dist <path>', 'Override the dist/ui directory')
+        .option('--allow-headless', 'Start even when SSH/no-DISPLAY is detected')
+        .option('--project-root <path>', 'Override the project root used to resolve .agent-config/')
+        .option('--dry-run', 'Boot with all writes suppressed (preview-only — no .agent-settings.yml / .agent-user.md / wizard-state.json mutations)')
+        .action(async (opts) => {
+        const code = await runUiServe(opts);
+        process.exit(code);
+    });
+    program
+        .command('settings')
+        .description('Open the local Settings GUI (boots the UI server and lands on #/settings)')
+        .option('--port <n>', 'Override the auto-picked port', (v) => Number.parseInt(v, 10))
+        .option('--no-open', 'Do not launch the browser')
+        .option('--ui-dist <path>', 'Override the dist/ui directory')
+        .option('--allow-headless', 'Start even when SSH/no-DISPLAY is detected')
+        .option('--project-root <path>', 'Override the project root used to resolve .agent-config/')
+        .option('--dry-run', 'Boot with all writes suppressed (preview-only)')
+        .action(async (opts) => {
+        const code = await runSettings(opts);
+        process.exit(code);
+    });
+    // `setup` — onboarding-only alias for `ui:serve` that lands on the
+    // `#/wizard` route. Replaces the deprecated `/onboard` chat skill.
+    program
+        .command('setup')
+        .description('Open the onboarding wizard (boots the UI server and lands on #/wizard)')
+        .option('--port <n>', 'Override the auto-picked port', (v) => Number.parseInt(v, 10))
+        .option('--no-open', 'Do not launch the browser')
+        .option('--ui-dist <path>', 'Override the dist/ui directory')
+        .option('--allow-headless', 'Start even when SSH/no-DISPLAY is detected')
+        .option('--project-root <path>', 'Override the project root used to resolve .agent-config/')
+        .option('--dry-run', 'Boot with all writes suppressed (preview-only)')
+        .action(async (opts) => {
+        const forwarded = { initialRoute: '/wizard' };
+        if (opts.port !== undefined)
+            forwarded.port = opts.port;
+        if (opts.open !== undefined)
+            forwarded.open = opts.open;
+        if (opts.uiDist !== undefined)
+            forwarded.uiDist = opts.uiDist;
+        if (opts.allowHeadless !== undefined)
+            forwarded.allowHeadless = opts.allowHeadless;
+        if (opts.projectRoot !== undefined)
+            forwarded.projectRoot = opts.projectRoot;
+        if (opts.dryRun !== undefined)
+            forwarded.dryRun = opts.dryRun;
+        const code = await runUiServe(forwarded);
+        process.exit(code);
+    });
+    const workspaces = program
+        .command('workspaces')
+        .description('Inspect workspaces from the discovery manifest');
+    workspaces
+        .command('ls')
+        .description('List workspaces (id, label, default_packs)')
+        .option('--json', 'Emit machine-readable JSON')
+        .action((opts) => {
+        const code = runWorkspacesLs(opts);
+        process.exit(code);
+    });
+    const packs = program
+        .command('packs')
+        .description('Inspect packs from the discovery manifest');
+    packs
+        .command('ls')
+        .description('List packs (id, label, workspaces, artefact_count)')
+        .option('--json', 'Emit machine-readable JSON')
+        .action((opts) => {
+        const code = runPacksLs(opts);
+        process.exit(code);
+    });
+    program
+        .command('help')
+        .description('Show help (delegates to Bash for --tier=1|all)')
+        .allowUnknownOption(true)
+        .allowExcessArguments(true)
+        .action(async () => {
+        const rest = argv.slice(argv.indexOf('help') + 1);
+        if (rest.length === 0) {
+            process.stdout.write(`${buildHelp()}\n`);
+            process.exit(0);
+        }
+        const code = await delegateToBash({ args: ['help', ...rest] });
+        process.exit(code);
+    });
+    // Bare invocation → print TS-shell help.
+    if (argv.length === 0) {
+        process.stdout.write(`${buildHelp()}\n`);
+        return 0;
+    }
+    const head = argv[0];
+    if (head === '--help' || head === '-h') {
+        process.stdout.write(`${buildHelp()}\n`);
+        return 0;
+    }
+    if (head === '--version' || head === '-V') {
+        process.stdout.write(`${readVersion()}\n`);
+        return 0;
+    }
+    // Native subcommand → commander handles it (exits inside action).
+    const native = ['versions', 'doctor-shell', 'ui:serve', 'settings', 'setup', 'workspaces', 'packs', 'help'];
+    if (head !== undefined && native.includes(head)) {
+        await program.parseAsync(['node', 'agent-config', ...argv]);
+        return 0;
+    }
+    // Everything else forwards to the Bash dispatcher verbatim.
+    return delegateToBash({ args: argv });
+}
+main(process.argv.slice(2))
+    .then((code) => { process.exit(code); })
+    .catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    logger.error(message);
+    process.exit(1);
+});
+//# sourceMappingURL=agent-config.js.map

package/dist/cli/agent-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config.js","sourceRoot":"","sources":["../../src/cli/agent-config.ts"],"names":[],"mappings":"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"}

package/dist/cli/bash/runBash.js

@@ -0,0 +1,40 @@
+/**
+ * Bash-dispatcher delegate.
+ *
+ * Phase 2 strategy: the TS binary keeps the existing Bash dispatcher
+ * (`scripts/agent-config`) as the canonical router. Native commands
+ * (`versions`, `doctor-shell`, `--help`, `--version`) are handled in
+ * TS; every other subcommand is forwarded verbatim with `exec`-style
+ * semantics (`stdio: 'inherit'`, exit code propagated).
+ *
+ * Phase 5 (Shadow-Mode → flip) will reverse this: Bash becomes a thin
+ * shim that forwards to TS. The contract here is exit-code parity.
+ */
+import { execa } from 'execa';
+import { BASH_ENTRY } from '../paths.js';
+import { logger } from '../log/logger.js';
+/**
+ * Forward to the Bash dispatcher. Returns the child's exit code; the
+ * caller is responsible for `process.exit(code)`.
+ *
+ * Errors thrown by execa (ENOENT, non-executable file, …) are caught
+ * and reported via the logger; we exit with code 127 in that case so
+ * the failure is distinguishable from a normal subcommand non-zero.
+ */
+export async function delegateToBash(opts) {
+    try {
+        const child = execa('bash', [BASH_ENTRY, ...opts.args], {
+            stdio: 'inherit',
+            reject: false,
+            env: process.env,
+        });
+        const result = await child;
+        return result.exitCode ?? 1;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error(`failed to invoke Bash dispatcher: ${message}`);
+        return 127;
+    }
+}
+//# sourceMappingURL=runBash.js.map

package/dist/cli/bash/runBash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runBash.js","sourceRoot":"","sources":["../../../src/cli/bash/runBash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAO1C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAyB;IAC1D,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE;YACpD,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,OAAO,CAAC,GAAG;SACnB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QAC3B,OAAO,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO,GAAG,CAAC;IACf,CAAC;AACL,CAAC"}

package/dist/cli/commands/doctorShell.js

@@ -0,0 +1,91 @@
+/**
+ * `doctor-shell` — native TS implementation.
+ *
+ * Probes the TS-shell environment: Node version, python3 availability,
+ * package root resolution, and the Bash dispatcher's existence. This
+ * complements (not replaces) the existing Python-side `doctor`, which
+ * audits the consumer project itself.
+ */
+import { existsSync } from 'node:fs';
+import { PythonNotFoundError, resolvePython } from '../python/resolvePython.js';
+import { BASH_ENTRY, BASH_SHIM, CONSUMER_ROOT, PACKAGE_ROOT } from '../paths.js';
+import { logger } from '../log/logger.js';
+function checkNode() {
+    const required = 20;
+    const version = process.versions.node;
+    const major = Number.parseInt(version.split('.')[0] ?? '0', 10);
+    return {
+        name: 'node',
+        ok: major >= required,
+        detail: major >= required
+            ? `v${version} (>= v${required}.0.0)`
+            : `v${version} — need >= v${required}.11.0`,
+    };
+}
+function checkPython() {
+    try {
+        const resolved = resolvePython();
+        return {
+            name: 'python3',
+            ok: true,
+            detail: `${resolved.bin} — ${resolved.version}`,
+        };
+    }
+    catch (err) {
+        const message = err instanceof PythonNotFoundError
+            ? 'not on PATH'
+            : err instanceof Error ? err.message : String(err);
+        return { name: 'python3', ok: false, detail: message };
+    }
+}
+function checkPackageRoot() {
+    const ok = existsSync(`${PACKAGE_ROOT}/package.json`);
+    return {
+        name: 'package_root',
+        ok,
+        detail: ok ? PACKAGE_ROOT : `${PACKAGE_ROOT} (package.json missing)`,
+    };
+}
+function checkBashEntry() {
+    const ok = existsSync(BASH_ENTRY);
+    return {
+        name: 'bash_entry',
+        ok,
+        detail: ok ? BASH_ENTRY : `${BASH_ENTRY} (not found)`,
+    };
+}
+function checkBashShim() {
+    const ok = existsSync(BASH_SHIM);
+    return {
+        name: 'bash_shim',
+        ok,
+        detail: ok ? BASH_SHIM : `${BASH_SHIM} (not found)`,
+    };
+}
+export function runDoctorShell() {
+    const checks = [
+        checkNode(),
+        checkPython(),
+        checkPackageRoot(),
+        checkBashEntry(),
+        checkBashShim(),
+    ];
+    logger.info(`consumer_root: ${CONSUMER_ROOT}`);
+    logger.info(`package_root:  ${PACKAGE_ROOT}`);
+    logger.info('');
+    let failed = 0;
+    for (const c of checks) {
+        const mark = c.ok ? 'ok  ' : 'FAIL';
+        logger.info(`[${mark}] ${c.name.padEnd(14)} ${c.detail}`);
+        if (!c.ok)
+            failed += 1;
+    }
+    logger.info('');
+    if (failed > 0) {
+        logger.error(`${failed} check(s) failed`);
+        return 1;
+    }
+    logger.info('all checks passed');
+    return 0;
+}
+//# sourceMappingURL=doctorShell.js.map

package/dist/cli/commands/doctorShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctorShell.js","sourceRoot":"","sources":["../../../src/cli/commands/doctorShell.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/packs.js

@@ -0,0 +1,59 @@
+/**
+ * `agent-config packs ls` — native TS implementation.
+ *
+ * Reads `dist/discovery/discovery-manifest.json` and prints a stable
+ * table to stdout (`id`, `label`, `workspaces`, `artefact_count`) or,
+ * with `--json`, dumps the relevant manifest slice verbatim.
+ *
+ * Exits 0 on success, 1 when the manifest is missing or malformed.
+ */
+import { loadManifest, ManifestNotFoundError, ManifestParseError } from '../discovery/loadManifest.js';
+import { logger } from '../log/logger.js';
+function renderTable(packs) {
+    const header = ['id', 'label', 'workspaces', 'artefact_count'];
+    const rows = packs.map((p) => [
+        p.id,
+        p.label,
+        p.workspaces.join(','),
+        String(p.artefact_count),
+    ]);
+    const widths = header.map((h, i) => {
+        const colMax = rows.reduce((acc, r) => Math.max(acc, (r[i] ?? '').length), 0);
+        return Math.max(h.length, colMax);
+    });
+    const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i] ?? 0)).join('  ').trimEnd();
+    const lines = [];
+    lines.push(fmt(header));
+    lines.push(fmt(widths.map((w) => '-'.repeat(w))));
+    for (const row of rows)
+        lines.push(fmt(row));
+    return lines.join('\n');
+}
+export function runPacksLs(opts = {}) {
+    let manifest;
+    try {
+        manifest = loadManifest();
+    }
+    catch (err) {
+        if (err instanceof ManifestNotFoundError) {
+            logger.error(`discovery manifest not found at ${err.path} — run ` +
+                "'python3 scripts/build_discovery_manifest.py --write' " +
+                'or install a published release.');
+            return 1;
+        }
+        if (err instanceof ManifestParseError) {
+            logger.error(err.message);
+            return 1;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error(message);
+        return 1;
+    }
+    if (opts.json) {
+        process.stdout.write(`${JSON.stringify({ packs: manifest.packs }, null, 2)}\n`);
+        return 0;
+    }
+    logger.info(renderTable(manifest.packs));
+    return 0;
+}
+//# sourceMappingURL=packs.js.map

package/dist/cli/commands/packs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packs.js","sourceRoot":"","sources":["../../../src/cli/commands/packs.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/settings.js

@@ -0,0 +1,35 @@
+/**
+ * `agent-config settings` — open the local Settings GUI.
+ *
+ * Thin wrapper around `runUiServe` that lands on the `#/settings`
+ * route instead of the wizard. Per roadmap
+ * `unified-setup-and-settings-gui.md` § 2.4, the only difference vs
+ * `ui:serve` is the initial URL hash; the server stack is shared.
+ *
+ * Flags:
+ *   --port <n>     Override the auto-picked port.
+ *   --no-open      Do not launch the browser.
+ *   --ui-dist <p>  Override the dist/ui directory.
+ *   --allow-headless  Start even when SSH/no-DISPLAY is detected.
+ *   --project-root    Override the project root.
+ */
+import { runUiServe } from './uiServe.js';
+export async function runSettings(opts) {
+    const forwarded = {
+        initialRoute: '/settings',
+    };
+    if (opts.port !== undefined)
+        forwarded.port = opts.port;
+    if (opts.open !== undefined)
+        forwarded.open = opts.open;
+    if (opts.uiDist !== undefined)
+        forwarded.uiDist = opts.uiDist;
+    if (opts.allowHeadless !== undefined)
+        forwarded.allowHeadless = opts.allowHeadless;
+    if (opts.projectRoot !== undefined)
+        forwarded.projectRoot = opts.projectRoot;
+    if (opts.dryRun !== undefined)
+        forwarded.dryRun = opts.dryRun;
+    return runUiServe(forwarded);
+}
+//# sourceMappingURL=settings.js.map

package/dist/cli/commands/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../src/cli/commands/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAuB,MAAM,cAAc,CAAC;AAY/D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAA4B;IAC1D,MAAM,SAAS,GAAmB;QAC9B,YAAY,EAAE,WAAW;KAC5B,CAAC;IACF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9D,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;QAAE,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IACnF,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC7E,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9D,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/cli/commands/uiServe.js

@@ -0,0 +1,110 @@
+/**
+ * `agent-config ui:serve` — launch the embedded local server.
+ *
+ * Flow:
+ *   1. Refuse to start in a headless context (no DISPLAY, $SSH_CONNECTION
+ *      set) unless `--allow-headless` is passed. Council critical-challenger
+ *      mandate: the GUI must not silently break the headless contract.
+ *   2. Pick a free port in 41000–41999 (or honour `--port`).
+ *   3. Mint a per-process bearer token + persist it under
+ *      `~/.event4u/agent-config/local-server.token` (mode 0600).
+ *   4. Boot Fastify via `createApp`, listen on 127.0.0.1 only.
+ *   5. Print the URL (with token query param) on stdout, install
+ *      SIGINT/SIGTERM handlers that close the server cleanly.
+ *   6. Open the user's browser unless `--no-open` is set.
+ *
+ * Anti-regression: if `dist/ui/index.html` is missing we refuse to
+ * start and point at `npm run build:ui` — same exit code as the rest
+ * of the CLI's "missing prerequisite" failures.
+ */
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { pickFreePort, DEFAULT_PORT_RANGE } from '../../server/port.js';
+import { mintToken } from '../../server/token.js';
+import { createApp } from '../../server/app.js';
+import { resolveWriteRoot, ensureWriteRoot } from '../../server/writeRoot.js';
+import { PACKAGE_ROOT } from '../paths.js';
+import { logger } from '../log/logger.js';
+function isHeadless() {
+    if (process.env['SSH_CONNECTION'])
+        return true;
+    if (process.platform === 'linux' && !process.env['DISPLAY'])
+        return true;
+    return false;
+}
+async function openBrowser(url) {
+    try {
+        const mod = (await import('open'));
+        await mod.default(url);
+    }
+    catch (err) {
+        logger.warn(`unable to open browser automatically: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export async function runUiServe(opts) {
+    const uiDistDir = resolve(opts.uiDist ?? resolve(PACKAGE_ROOT, 'dist', 'ui'));
+    const indexHtml = resolve(uiDistDir, 'index.html');
+    if (!existsSync(indexHtml)) {
+        logger.error(`UI bundle not found at ${uiDistDir}.`);
+        logger.error("Run 'npm run build:ui' (or 'npm run build') first.");
+        return 1;
+    }
+    const { writeRoot, legacyReadRoot, mode } = resolveWriteRoot(opts.projectRoot !== undefined ? { override: opts.projectRoot } : {});
+    ensureWriteRoot(writeRoot);
+    if (isHeadless() && opts.allowHeadless !== true) {
+        logger.error('Headless environment detected (SSH or no DISPLAY).');
+        logger.error("The local UI requires a desktop browser. Re-run with '--allow-headless' to start the server anyway");
+        logger.error('and connect to it manually, or use the CLI subcommands instead.');
+        return 2;
+    }
+    const port = opts.port ?? (await pickFreePort(DEFAULT_PORT_RANGE));
+    const { token, path: tokenPath } = mintToken();
+    const dryRun = opts.dryRun === true;
+    if (dryRun) {
+        logger.info('dry-run mode: no files will be written');
+    }
+    logger.info(`storage: ${mode} → ${writeRoot}`);
+    if (legacyReadRoot !== null) {
+        logger.info(`legacy-read fallback: ${legacyReadRoot}`);
+    }
+    const app = await createApp({
+        writeRoot,
+        legacyReadRoot,
+        mode,
+        uiDistDir,
+        token,
+        expectedPort: port,
+        dryRun,
+    });
+    try {
+        await app.listen({ port, host: '127.0.0.1' });
+    }
+    catch (err) {
+        logger.error(`failed to bind to 127.0.0.1:${port}: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    const hash = opts.initialRoute !== undefined && opts.initialRoute.length > 0
+        ? `#${opts.initialRoute.startsWith('/') ? opts.initialRoute : `/${opts.initialRoute}`}`
+        : '';
+    const url = `http://127.0.0.1:${port}/?token=${token}${hash}`;
+    logger.info(`agent-config UI on ${url}  (Ctrl-C to stop)`);
+    logger.info(`token file: ${tokenPath}`);
+    if (opts.open !== false && !isHeadless()) {
+        await openBrowser(url);
+    }
+    const stop = async (signal) => {
+        logger.info(`received ${signal} — shutting down`);
+        try {
+            await app.close();
+        }
+        finally {
+            process.exit(0);
+        }
+    };
+    process.on('SIGINT', () => { void stop('SIGINT'); });
+    process.on('SIGTERM', () => { void stop('SIGTERM'); });
+    return new Promise(() => {
+        // Resolves when the process exits via signal handler above.
+    });
+}
+//# sourceMappingURL=uiServe.js.map

package/dist/cli/commands/uiServe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiServe.js","sourceRoot":"","sources":["../../../src/cli/commands/uiServe.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/versions.js

@@ -0,0 +1,64 @@
+/**
+ * `versions` — native TS implementation.
+ *
+ * Lists the currently-pinned `@event4u/agent-config` version (from
+ * package.json), plus the latest available on npm. Offline mode skips
+ * the registry probe.
+ *
+ * Bash equivalent: `cmd_versions` in `scripts/agent-config`.
+ */
+import { readFileSync } from 'node:fs';
+import { execa } from 'execa';
+import { PACKAGE_JSON } from '../paths.js';
+import { logger } from '../log/logger.js';
+function readCurrent() {
+    const raw = readFileSync(PACKAGE_JSON, 'utf8');
+    const pkg = JSON.parse(raw);
+    if (typeof pkg.version !== 'string') {
+        throw new Error('package.json missing string `version` field');
+    }
+    return pkg.version;
+}
+async function fetchAvailable(limit) {
+    try {
+        const { stdout } = await execa('npm', ['view', '@event4u/agent-config', 'versions', '--json'], { reject: false, timeout: 10_000 });
+        const parsed = JSON.parse(stdout);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.slice(-limit).reverse();
+    }
+    catch {
+        return [];
+    }
+}
+export async function runVersions(opts = {}) {
+    const current = readCurrent();
+    const limit = opts.limit ?? 10;
+    const available = opts.offline ? [] : await fetchAvailable(limit);
+    const latest = available[0] ?? null;
+    const result = { current, latest, available };
+    if (opts.json) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        return 0;
+    }
+    logger.info(`current: ${current}`);
+    if (opts.offline) {
+        logger.info('(offline — registry not queried)');
+        return 0;
+    }
+    if (!latest) {
+        logger.info('latest:  (npm registry unreachable)');
+        return 0;
+    }
+    logger.info(`latest:  ${latest}${latest === current ? ' (you are on latest)' : ''}`);
+    if (available.length > 1) {
+        logger.info('');
+        logger.info('Recent versions:');
+        for (const v of available) {
+            const marker = v === current ? ' (current)' : v === latest ? ' (latest)' : '';
+            logger.info(`  - ${v}${marker}`);
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=versions.js.map

package/dist/cli/commands/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../../src/cli/commands/versions.ts"],"names":[],"mappings":"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"}