@event4u/agent-config 2.26.0 → 3.1.0

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,119 @@
+/**
+ * `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, projectScopeRoot, 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 dryRun = opts.dryRun === true;
+    const { token, path: tokenPath } = mintToken({ persist: !dryRun });
+    if (dryRun) {
+        logger.info('dry-run mode: no files will be written');
+        logger.info(`storage (suppressed in dry-run): ${mode} → ${writeRoot}`);
+    }
+    else {
+        logger.info(`storage: ${mode} → ${writeRoot}`);
+    }
+    if (legacyReadRoot !== null) {
+        logger.info(`legacy-read fallback: ${legacyReadRoot}`);
+    }
+    const app = await createApp({
+        writeRoot,
+        legacyReadRoot,
+        projectScopeRoot,
+        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)`);
+    if (tokenPath !== null) {
+        logger.info(`token file: ${tokenPath}`);
+    }
+    else {
+        logger.info('token file (suppressed in dry-run): in-memory only');
+    }
+    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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"}

package/dist/cli/commands/workspaces.js

@@ -0,0 +1,58 @@
+/**
+ * `agent-config workspaces ls` — native TS implementation.
+ *
+ * Reads `dist/discovery/discovery-manifest.json` and prints a stable
+ * table to stdout (`id`, `label`, `default_packs`) 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(workspaces) {
+    const header = ['id', 'label', 'default_packs'];
+    const rows = workspaces.map((w) => [
+        w.id,
+        w.label,
+        w.default_packs.join(','),
+    ]);
+    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 runWorkspacesLs(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({ workspaces: manifest.workspaces }, null, 2)}\n`);
+        return 0;
+    }
+    logger.info(renderTable(manifest.workspaces));
+    return 0;
+}
+//# sourceMappingURL=workspaces.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../../src/cli/commands/workspaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvG,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAM1C,SAAS,WAAW,CAAC,UAAyC;IAC1D,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IAChD,MAAM,IAAI,GAAe,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3C,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;KAC5B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,CAAC,KAAe,EAAU,EAAE,CACpC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACvE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA4B,EAAE;IAC1D,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACD,QAAQ,GAAG,YAAY,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;YACvC,MAAM,CAAC,KAAK,CACR,mCAAmC,GAAG,CAAC,IAAI,SAAS;gBAChD,wDAAwD;gBACxD,iCAAiC,CACxC,CAAC;YACF,OAAO,CAAC,CAAC;QACb,CAAC;QACD,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1B,OAAO,CAAC,CAAC;QACb,CAAC;QACD,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,OAAO,CAAC,CAAC;QACtB,OAAO,CAAC,CAAC;IACb,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1F,OAAO,CAAC,CAAC;IACb,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,CAAC;AACb,CAAC"}

package/dist/cli/discovery/loadManifest.js

@@ -0,0 +1,62 @@
+/**
+ * Discovery-manifest loader — single source of truth for reading
+ * `dist/discovery/discovery-manifest.json` from both the CLI and the
+ * Fastify server route.
+ *
+ * The manifest is a release-time artefact (see ADR-013 and
+ * `agents/roadmaps/archive/automated-pack-workspace-and-skill-discovery.md`,
+ * archived at status: completed).
+ * Absence at runtime is operator error, not a crash — callers either
+ * print a clear CLI message or surface HTTP 503.
+ */
+import { readFileSync } from 'node:fs';
+import { DISCOVERY_MANIFEST } from '../paths.js';
+/** Thrown when the manifest file is not on disk. */
+export class ManifestNotFoundError extends Error {
+    path;
+    constructor(path) {
+        super(`discovery manifest not found at ${path}`);
+        this.name = 'ManifestNotFoundError';
+        this.path = path;
+    }
+}
+/** Thrown when the manifest exists but is unparseable / malformed. */
+export class ManifestParseError extends Error {
+    path;
+    constructor(path, cause) {
+        const reason = cause instanceof Error ? cause.message : String(cause);
+        super(`discovery manifest at ${path} is not valid JSON: ${reason}`);
+        this.name = 'ManifestParseError';
+        this.path = path;
+    }
+}
+/**
+ * Load and parse the discovery manifest.
+ *
+ * Throws `ManifestNotFoundError` if the file is missing, or
+ * `ManifestParseError` if the file is present but cannot be parsed.
+ * Callers handle these distinctly: CLI prints a helpful message and
+ * exits non-zero; the server route returns HTTP 503.
+ */
+export function loadManifest(opts = {}) {
+    const path = opts.path ?? DISCOVERY_MANIFEST;
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf8');
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            throw new ManifestNotFoundError(path);
+        }
+        throw err;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new ManifestParseError(path, err);
+    }
+    return parsed;
+}
+//# sourceMappingURL=loadManifest.js.map

package/dist/cli/discovery/loadManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadManifest.js","sourceRoot":"","sources":["../../../src/cli/discovery/loadManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,oDAAoD;AACpD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC5B,IAAI,CAAS;IAC7B,YAAmB,IAAY;QAC3B,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ;AAED,sEAAsE;AACtE,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzB,IAAI,CAAS;IAC7B,YAAmB,IAAY,EAAE,KAAc;QAC3C,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,KAAK,CAAC,yBAAyB,IAAI,uBAAuB,MAAM,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ;AAgED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B,EAAE;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,kBAAkB,CAAC;IAC7C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACD,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5F,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,GAAG,CAAC;IACd,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,IAAI,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,MAA2B,CAAC;AACvC,CAAC"}

package/dist/cli/log/logger.js

@@ -0,0 +1,41 @@
+/**
+ * Sanctioned logger for the TS CLI shell.
+ *
+ * Per ADR-012, plain `console.log` is banned outside this file. Tests
+ * and the Vitest reporter override the ban via the `.eslintrc.cjs`
+ * `overrides` block.
+ *
+ * Output rules:
+ *   - Level `error` → stderr, prefixed `agent-config: error:`.
+ *   - Level `warn`  → stderr, prefixed `agent-config: warn:`.
+ *   - Level `info`  → stdout, no prefix (this is the user-visible
+ *     pass-through line for native commands).
+ *   - Level `debug` → stderr, only when `AGENT_CONFIG_LOG=debug`.
+ *
+ * No colour codes. Detecting a TTY and switching to colour belongs to
+ * downstream commands that genuinely want it (none today).
+ */
+function envLevel() {
+    const raw = process.env.AGENT_CONFIG_LOG?.toLowerCase();
+    if (raw === 'debug' || raw === 'info' || raw === 'warn' || raw === 'error')
+        return raw;
+    return 'info';
+}
+const ORDER = { debug: 10, info: 20, warn: 30, error: 40 };
+function emit(level, message) {
+    if (ORDER[level] < ORDER[envLevel()])
+        return;
+    if (level === 'info') {
+        process.stdout.write(`${message}\n`);
+        return;
+    }
+    const prefix = level === 'debug' ? '' : `agent-config: ${level}: `;
+    process.stderr.write(`${prefix}${message}\n`);
+}
+export const logger = {
+    debug: (msg) => emit('debug', msg),
+    info: (msg) => emit('info', msg),
+    warn: (msg) => emit('warn', msg),
+    error: (msg) => emit('error', msg),
+};
+//# sourceMappingURL=logger.js.map

package/dist/cli/log/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/cli/log/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,SAAS,QAAQ;IACb,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,WAAW,EAAE,CAAC;IACxD,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,GAAG,CAAC;IACvF,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,KAAK,GAA6B,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAErF,SAAS,IAAI,CAAC,KAAe,EAAE,OAAe;IAC1C,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAAE,OAAO;IAC7C,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACrC,OAAO;IACX,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,KAAK,IAAI,CAAC;IACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,OAAO,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC;IAChD,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;IAC9C,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;IAC9C,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC;CACnD,CAAC"}

package/dist/cli/paths.js

@@ -0,0 +1,60 @@
+/**
+ * Package-root and script-path resolution for the TS CLI shell.
+ *
+ * PACKAGE_ROOT is derived from this file's location at runtime. After
+ * compilation the layout is `dist/cli/paths.js`, so two parent hops
+ * land on the package root regardless of how the binary was invoked
+ * (npm-global, vendor/bin symlink, npx, …).
+ *
+ * CONSUMER_ROOT is `process.cwd()` at entry — the Bash entry kept it
+ * stable for downstream Python scripts; we preserve that invariant.
+ */
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+import { existsSync, realpathSync } from 'node:fs';
+const here = dirname(fileURLToPath(import.meta.url));
+/** Absolute path to the package root (where package.json lives). */
+export const PACKAGE_ROOT = realpathSync(resolve(here, '..', '..'));
+/** Absolute path to the consumer's repo root (CWD on entry). */
+export const CONSUMER_ROOT = process.cwd();
+/**
+ * Absolute path to the legacy Bash dispatcher.
+ *
+ * Phase 5 moved the dispatcher to `scripts/_dispatch.bash` so the
+ * public-facing `scripts/agent-config` could become a 30-line
+ * deprecation shim that forwards to the compiled TS binary. The
+ * dispatcher is invoked directly here to avoid an infinite loop
+ * (shim → TS → shim → …).
+ */
+export const BASH_ENTRY = resolve(PACKAGE_ROOT, 'scripts', '_dispatch.bash');
+/**
+ * Absolute path to the public-facing Bash deprecation shim.
+ * Retained as a path constant for `doctor-shell` and future tooling
+ * that needs to detect "is the shim still present?".
+ */
+export const BASH_SHIM = resolve(PACKAGE_ROOT, 'scripts', 'agent-config');
+/** Absolute path to the package.json. */
+export const PACKAGE_JSON = resolve(PACKAGE_ROOT, 'package.json');
+/**
+ * Absolute path to the release-time discovery manifest.
+ *
+ * Release-only artefact — built by `scripts/build_discovery_manifest.py`
+ * into `dist/discovery/discovery-manifest.json` and shipped inside the
+ * published tarball. Never present in PR working trees; absence at
+ * runtime is operator error, not a crash (see Roadmap R3 Phase 3).
+ */
+export const DISCOVERY_MANIFEST = resolve(PACKAGE_ROOT, 'dist', 'discovery', 'discovery-manifest.json');
+/**
+ * Resolve a script that may live in either the package root or one
+ * of the projected template paths. Mirrors `resolve_script` in the
+ * Bash dispatcher.
+ */
+export function resolveScript(...candidates) {
+    for (const rel of candidates) {
+        const abs = resolve(PACKAGE_ROOT, rel);
+        if (existsSync(abs))
+            return abs;
+    }
+    return null;
+}
+//# sourceMappingURL=paths.js.map

package/dist/cli/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErD,oEAAoE;AACpE,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEpE,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;AAE1E,yCAAyC;AACzC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,yBAAyB,CAAC,CAAC;AAExG;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAG,UAAoB;IACjD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}