@pleri/olam-cli 0.1.148 → 0.1.151

package/dist/commands/kg-build.js

@@ -41,6 +41,95 @@ import { registerKgDoctorCommand } from './kg-doctor.js';
 import { registerKgInstallHookCommand } from './kg-install-hook.js';
 import { registerKgUninstallHookCommand } from './kg-uninstall-hook.js';
 import { registerKgSavingsCommand } from './kg-savings.js';
+/** Read JSONL queue entries from disk (real implementation). */
+function readQueueFromDisk(queuePath) {
+    if (!fs.existsSync(queuePath))
+        return [];
+    const raw = fs.readFileSync(queuePath, 'utf-8');
+    const entries = [];
+    for (const line of raw.split('\n')) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        try {
+            entries.push(JSON.parse(t));
+        }
+        catch { /* skip malformed */ }
+    }
+    return entries;
+}
+/** Write JSONL queue entries to disk (real implementation). */
+function writeQueueToDisk(queuePath, entries) {
+    fs.mkdirSync(path.dirname(queuePath), { recursive: true });
+    const content = entries.map((e) => JSON.stringify(e)).join('\n') + (entries.length > 0 ? '\n' : '');
+    fs.writeFileSync(queuePath, content, 'utf-8');
+}
+/**
+ * Drain the kg-pending.jsonl queue: build each entry sequentially via kg-service,
+ * remove successfully-built entries from the queue, leave failures with failedAt/failedReason.
+ */
+export async function runKgBuildPending(opts = {}) {
+    const queuePath = opts.queuePath ??
+        (() => {
+            const stateDir = process.env['OLAM_STATE_DIR'] ??
+                path.join(os.homedir(), '.olam', 'state');
+            return path.join(stateDir, 'kg-pending.jsonl');
+        })();
+    const readQueue = opts.readQueueFn ?? readQueueFromDisk;
+    const writeQueue = opts.writeQueueFn ?? writeQueueToDisk;
+    const rawEntries = readQueue(queuePath);
+    // Dedupe at drain-time: collapse duplicates by path, keeping the latest entry
+    // (Map insertion order: later entries overwrite earlier ones for the same key).
+    const deduped = [...new Map(rawEntries.map((e) => [e.path, e])).values()];
+    if (deduped.length === 0) {
+        printInfo('kg build --pending', 'queue is empty');
+        return { exitCode: 0, built: [], failed: [] };
+    }
+    printInfo('kg build --pending', `draining ${deduped.length} queued repo(s)`);
+    const built = [];
+    const failed = [];
+    const remaining = [];
+    for (const entry of deduped) {
+        const repoPath = entry.path;
+        const workspaceName = path.basename(repoPath).toLowerCase();
+        printInfo('kg build --pending', `building ${repoPath} (workspace=${workspaceName})`);
+        let containerPath;
+        try {
+            containerPath = toContainerPath(repoPath);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            printError(`skipping ${repoPath}: ${msg}`);
+            failed.push(repoPath);
+            remaining.push({ ...entry, failedAt: Date.now(), failedReason: msg });
+            continue;
+        }
+        let resp;
+        try {
+            resp = await kgServiceBuild({ workspace: workspaceName, repo_path: containerPath });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            printError(`build failed for ${repoPath}: ${msg}`);
+            failed.push(repoPath);
+            remaining.push({ ...entry, failedAt: Date.now(), failedReason: msg });
+            continue;
+        }
+        if (!resp.ok) {
+            const msg = resp.error ?? 'unknown error';
+            printError(`build failed for ${repoPath}: ${msg}`);
+            failed.push(repoPath);
+            remaining.push({ ...entry, failedAt: Date.now(), failedReason: msg });
+            continue;
+        }
+        built.push(repoPath);
+        printSuccess(`built ${repoPath} (${resp.nodes ?? '?'} nodes / ${resp.edges ?? '?'} edges)`);
+        // Do NOT add to remaining — successful builds are removed from queue
+    }
+    writeQueue(queuePath, remaining);
+    printInfo('kg build --pending', `done: ${built.length} built, ${failed.length} failed, ${remaining.length} remaining in queue`);
+    return { exitCode: failed.length > 0 && built.length === 0 ? 1 : 0, built, failed };
+}
 /**
  * Resolve workspace name + source path. `name` defaults to the basename
  * of the operator's cwd — the "build KG for the repo I'm in" common case.
@@ -153,11 +242,24 @@ export async function runKgBuild(workspaceArg, options = {}) {
  */
 export function registerKg(program) {
     const kg = program.command('kg').description('Knowledge-graph operations (kg-service container)');
-    kg.command('build')
-        .description('Build pristine KG for a workspace (default: current dir). Routes through olam-kg-service /build endpoint.')
+    const buildCmd = kg.command('build');
+    buildCmd
+        .description('Build pristine KG for a workspace (default: current dir). Routes through olam-kg-service /build endpoint. Use --pending to drain the pending queue.')
         .argument('[workspace]', 'workspace name (lowercase alphanumeric + hyphens/underscores)')
         .option('--json', 'emit freshness record as JSON instead of human-readable status')
+        .option('--pending', 'drain the kg-pending.jsonl queue (mutually exclusive with [workspace])')
         .action(async (workspaceArg, opts) => {
+        if (opts.pending && workspaceArg !== undefined) {
+            printError('--pending is mutually exclusive with [workspace] argument');
+            process.exitCode = 2;
+            return;
+        }
+        if (opts.pending) {
+            const r = await runKgBuildPending();
+            if (r.exitCode !== 0)
+                process.exitCode = r.exitCode;
+            return;
+        }
         const r = await runKgBuild(workspaceArg, opts);
         if (r.exitCode !== 0)
             process.exitCode = r.exitCode;

package/dist/commands/kg-build.js.map

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

package/dist/commands/restart.d.ts

@@ -0,0 +1,18 @@
+/**
+ * olam restart <world> — Restart a world container, auto-building the
+ * agent-stream bundle first when the host dist is stale.
+ *
+ * Phase B2 (olam-world-bundle-freshness): closes the silent-staleness
+ * loop where operators run `olam restart` expecting a fresh bundle but
+ * instead get the image-baked dist from the last docker build.
+ *
+ * With Phase B1's bind-mount overlay, the freshly-built dist is
+ * immediately visible inside the restarted container — no docker cp
+ * required.
+ *
+ * Fast path (dist current): ≤ 15s.
+ * Slow path (dist absent or stale): ≤ 90s (dominated by tsc compile).
+ */
+import type { Command } from 'commander';
+export declare function registerRestart(program: Command): void;
+//# sourceMappingURL=restart.d.ts.map

package/dist/commands/restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../src/commands/restart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmCzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuEtD"}

package/dist/commands/restart.js

@@ -0,0 +1,113 @@
+/**
+ * olam restart <world> — Restart a world container, auto-building the
+ * agent-stream bundle first when the host dist is stale.
+ *
+ * Phase B2 (olam-world-bundle-freshness): closes the silent-staleness
+ * loop where operators run `olam restart` expecting a fresh bundle but
+ * instead get the image-baked dist from the last docker build.
+ *
+ * With Phase B1's bind-mount overlay, the freshly-built dist is
+ * immediately visible inside the restarted container — no docker cp
+ * required.
+ *
+ * Fast path (dist current): ≤ 15s.
+ * Slow path (dist absent or stale): ≤ 90s (dominated by tsc compile).
+ */
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { loadContext } from '../context.js';
+import { printError, printInfo, printHeader } from '../output.js';
+import { buildIfStale } from '../lib/build-if-stale.js';
+import { resolveBundleSource, BundleSourceNotFoundError } from '../lib/bundle-source.js';
+const RESTART_TIMEOUT_S = 30;
+function docker(args) {
+    const result = spawnSync('docker', args, {
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    return {
+        ok: result.status === 0 && result.error === undefined,
+        stderr: result.stderr ?? '',
+    };
+}
+/**
+ * Walk up from `start` until we find a directory containing both
+ * `packages/` and `package.json`. Returns `start` if not found.
+ */
+function resolveRepoRoot(start) {
+    let cur = start;
+    while (true) {
+        if (existsSync(resolve(cur, 'packages')) && existsSync(resolve(cur, 'package.json'))) {
+            return cur;
+        }
+        const parent = dirname(cur);
+        if (parent === cur)
+            return start;
+        cur = parent;
+    }
+}
+export function registerRestart(program) {
+    program
+        .command('restart')
+        .description('Restart a world container (auto-builds agent-stream bundle when stale)')
+        .argument('<world>', 'World ID or name')
+        .action(async (worldIdOrName) => {
+        const { ctx, error } = await loadContext();
+        if (!ctx) {
+            printError(error?.message ?? 'Olam is not configured. Run `olam init` first.');
+            process.exitCode = 1;
+            return;
+        }
+        const world = ctx.worldManager.getWorld(worldIdOrName);
+        if (!world) {
+            printError(`World "${worldIdOrName}" not found. Run \`olam list\` to see worlds.`);
+            process.exitCode = 1;
+            return;
+        }
+        printHeader(`olam restart: ${world.name}`);
+        // C3 (olam-world-bundle-freshness): resolve bundle source and branch on mode.
+        // source-mode: auto-build if stale (B2 path).
+        // install-mode: skip build, log one line, proceed immediately.
+        try {
+            const bundleSource = resolveBundleSource();
+            if (bundleSource.mode === 'install') {
+                // C3 acceptance: log exactly this line to stderr.
+                process.stderr.write('bundle source: install-mode; skipping rebuild\n');
+            }
+            else {
+                // source-mode: B2 path — auto-build if stale.
+                const repoRoot = resolveRepoRoot(process.cwd());
+                const buildResult = buildIfStale(repoRoot);
+                if (!buildResult.ok) {
+                    printError('Agent-stream bundle build failed. Not restarting with a stale bundle.\n' +
+                        'Fix the build error and re-run `olam restart`.');
+                    process.exitCode = 1;
+                    return;
+                }
+                printInfo('Bundle', buildResult.message);
+            }
+        }
+        catch (err) {
+            if (err instanceof BundleSourceNotFoundError) {
+                // Graceful degradation: bundle path unresolved, but still restart.
+                // The container uses its image-baked dist as fallback.
+                process.stderr.write(`Warning: agent-stream bundle path unresolved; container uses image-baked dist.\n`);
+            }
+            else {
+                throw err;
+            }
+        }
+        // Restart the container.
+        const containerName = `olam-${world.id}-devbox`;
+        printInfo('Container', containerName);
+        const result = docker(['restart', '--time', String(RESTART_TIMEOUT_S), containerName]);
+        if (!result.ok) {
+            printError(`docker restart failed: ${result.stderr.trim() || '(no stderr)'}`);
+            process.exitCode = 1;
+            return;
+        }
+        printInfo('Status', 'restarted');
+    });
+}
+//# sourceMappingURL=restart.js.map

package/dist/commands/restart.js.map

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

package/dist/commands/setup-linux-gate.d.ts

@@ -0,0 +1,26 @@
+/**
+ * olam setup linux-gate-status — Linux gate detector subcommand
+ * (olam-setup-epic Phase F, F3).
+ *
+ * Checks two signals and reports whether the Linux platform gate is triggered:
+ *   (a) ≥1 GitHub issue labeled `linux-platform-request` (any state)
+ *   (b) ≥3 trust-audit-log entries with platform = 'linux'
+ *
+ * Usage:
+ *   olam setup linux-gate-status
+ *
+ * Outputs JSON to stdout:
+ *   { triggered, source, ghIssues, linuxInvocations }
+ *   (plus ghError when the `gh` CLI is unavailable)
+ *
+ * Exit codes:
+ *   0  — gate not triggered OR triggered (both cases print JSON; caller decides)
+ *   1  — unexpected runtime error (not the same as "triggered")
+ *
+ * Design constraint: this file lives in @pleri/olam-cli and delegates to
+ * the pure @olam/core helper (detectLinuxGateTrigger). @olam/core does NOT
+ * import from @pleri/olam-cli (dep-cycle rule).
+ */
+import type { Command } from 'commander';
+export declare function registerSetupLinuxGate(program: Command): void;
+//# sourceMappingURL=setup-linux-gate.d.ts.map

package/dist/commands/setup-linux-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-linux-gate.d.ts","sourceRoot":"","sources":["../../src/commands/setup-linux-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmB7D"}

package/dist/commands/setup-linux-gate.js

@@ -0,0 +1,42 @@
+/**
+ * olam setup linux-gate-status — Linux gate detector subcommand
+ * (olam-setup-epic Phase F, F3).
+ *
+ * Checks two signals and reports whether the Linux platform gate is triggered:
+ *   (a) ≥1 GitHub issue labeled `linux-platform-request` (any state)
+ *   (b) ≥3 trust-audit-log entries with platform = 'linux'
+ *
+ * Usage:
+ *   olam setup linux-gate-status
+ *
+ * Outputs JSON to stdout:
+ *   { triggered, source, ghIssues, linuxInvocations }
+ *   (plus ghError when the `gh` CLI is unavailable)
+ *
+ * Exit codes:
+ *   0  — gate not triggered OR triggered (both cases print JSON; caller decides)
+ *   1  — unexpected runtime error (not the same as "triggered")
+ *
+ * Design constraint: this file lives in @pleri/olam-cli and delegates to
+ * the pure @olam/core helper (detectLinuxGateTrigger). @olam/core does NOT
+ * import from @pleri/olam-cli (dep-cycle rule).
+ */
+import { detectLinuxGateTrigger } from '@olam/core/src/setup/linux-gate.js';
+export function registerSetupLinuxGate(program) {
+    program
+        .command('setup-linux-gate-status')
+        .description('Detect whether the Linux platform expansion gate has been triggered. ' +
+        'Checks GitHub issues labeled linux-platform-request and the trust-audit-log ' +
+        'for ≥3 Linux invocations. Outputs JSON.')
+        .action(() => {
+        try {
+            const result = detectLinuxGateTrigger();
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        }
+        catch (err) {
+            process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\n`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=setup-linux-gate.js.map

package/dist/commands/setup-linux-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-linux-gate.js","sourceRoot":"","sources":["../../src/commands/setup-linux-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,yBAAyB,CAAC;SAClC,WAAW,CACV,uEAAuE;QACrE,8EAA8E;QAC9E,yCAAyC,CAC5C;SACA,MAAM,CAAC,GAAG,EAAE;QACX,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC/D,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/setup-metrics.d.ts

@@ -0,0 +1,26 @@
+/**
+ * olam setup metrics — dogfood metrics subcommand (olam-setup-epic Phase F, F2).
+ *
+ * Reads the trust-audit-log and computes aggregate setup statistics:
+ *   medianMinutes, p95Minutes, completedCount, abortedCount, ratio
+ *
+ * Usage:
+ *   olam setup metrics --since <date>
+ *
+ * --since accepts ISO 8601 (2026-05-18 or 2026-05-18T00:00:00Z).
+ * Malformed dates are rejected with a clear error message (exit 1).
+ *
+ * The command outputs JSON to stdout so it is pipeline-friendly.
+ *
+ * Design constraint: this file lives in @pleri/olam-cli and delegates to
+ * the pure @olam/core helper (queryDogfoodMetrics). @olam/core does NOT
+ * import from @pleri/olam-cli (dep-cycle rule).
+ */
+import type { Command } from 'commander';
+/**
+ * Parse an ISO 8601 date string (date-only or datetime).
+ * Returns a Date object or throws with a descriptive message on failure.
+ */
+export declare function parseSinceDate(raw: string): Date;
+export declare function registerSetupMetrics(program: Command): void;
+//# sourceMappingURL=setup-metrics.d.ts.map

package/dist/commands/setup-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-metrics.d.ts","sourceRoot":"","sources":["../../src/commands/setup-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAahD;AAID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqB3D"}

package/dist/commands/setup-metrics.js

@@ -0,0 +1,57 @@
+/**
+ * olam setup metrics — dogfood metrics subcommand (olam-setup-epic Phase F, F2).
+ *
+ * Reads the trust-audit-log and computes aggregate setup statistics:
+ *   medianMinutes, p95Minutes, completedCount, abortedCount, ratio
+ *
+ * Usage:
+ *   olam setup metrics --since <date>
+ *
+ * --since accepts ISO 8601 (2026-05-18 or 2026-05-18T00:00:00Z).
+ * Malformed dates are rejected with a clear error message (exit 1).
+ *
+ * The command outputs JSON to stdout so it is pipeline-friendly.
+ *
+ * Design constraint: this file lives in @pleri/olam-cli and delegates to
+ * the pure @olam/core helper (queryDogfoodMetrics). @olam/core does NOT
+ * import from @pleri/olam-cli (dep-cycle rule).
+ */
+import { queryDogfoodMetrics } from '@olam/core/src/setup/dogfood-metrics.js';
+// ── Date parsing ──────────────────────────────────────────────────────────────
+/**
+ * Parse an ISO 8601 date string (date-only or datetime).
+ * Returns a Date object or throws with a descriptive message on failure.
+ */
+export function parseSinceDate(raw) {
+    // Accept date-only (YYYY-MM-DD) by normalising to midnight UTC.
+    const normalised = /^\d{4}-\d{2}-\d{2}$/.test(raw.trim())
+        ? `${raw.trim()}T00:00:00Z`
+        : raw.trim();
+    const d = new Date(normalised);
+    if (Number.isNaN(d.getTime())) {
+        throw new Error(`--since: invalid date "${raw}". Use ISO 8601 format, e.g. 2026-05-18 or 2026-05-18T00:00:00Z`);
+    }
+    return d;
+}
+// ── Command registration ──────────────────────────────────────────────────────
+export function registerSetupMetrics(program) {
+    program
+        .command('setup-metrics')
+        .description('Query trust-audit-log for olam setup dogfood statistics. ' +
+        'Returns { medianMinutes, p95Minutes, completedCount, abortedCount, ratio }.')
+        .requiredOption('--since <date>', 'ISO 8601 lower bound (e.g. 2026-05-18)')
+        .action((opts) => {
+        let since;
+        try {
+            since = parseSinceDate(opts.since);
+        }
+        catch (err) {
+            process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const result = queryDogfoodMetrics({ since });
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+    });
+}
+//# sourceMappingURL=setup-metrics.js.map

package/dist/commands/setup-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-metrics.js","sourceRoot":"","sources":["../../src/commands/setup-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,gEAAgE;IAChE,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACvD,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,YAAY;QAC3B,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAEf,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,0BAA0B,GAAG,iEAAiE,CAC/F,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CACV,2DAA2D;QACzD,6EAA6E,CAChF;SACA,cAAc,CAAC,gBAAgB,EAAE,wCAAwC,CAAC;SAC1E,MAAM,CAAC,CAAC,IAAuB,EAAE,EAAE;QAClC,IAAI,KAAW,CAAC;QAChB,IAAI,CAAC;YACH,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/setup-phase-5a-skill-source.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Phase 5a — Skill-source picker (olam-setup-epic Phase B).
+ *
+ * Three paths (in evaluation order):
+ *   1. Skip-on-flag  — opts.skipSkillSource is true
+ *   2. Non-interactive — opts.skillSource provides a curated name or git URL
+ *   3. Interactive TUI — @inquirer/prompts select + optional custom-URL input
+ *
+ * After path 2 or 3 resolves a git URL: addSkillSource → cloneSkillSource →
+ * appendTrustAudit('setup-skill-source-picked').
+ *
+ * TTY-safety: when !process.stdin.isTTY and no --skill-source flag, falls back
+ * to the recommended default (atlas-toolbox) with a stderr hint — mirrors the
+ * defaultPrompt pattern in setup.ts.
+ *
+ * Dependency injection: real @olam/core functions are lazily imported so this
+ * module resolves in vitest without a pre-built @olam/core dist. Callers
+ * inject stubs via RunSetupDeps for unit tests.
+ */
+import type { RunSetupOptions, RunSetupDeps, PhaseResult } from './setup.js';
+import type { SkillSource } from '@olam/core/src/skill-sources/schema.js';
+import type { TrustAuditEntry } from '@olam/core/src/skill-sources/trust-audit-log.js';
+declare const CURATED_SOURCES: readonly [{
+    readonly value: "atlas-toolbox";
+    readonly name: "atlas-toolbox (recommended)";
+    readonly gitUrl: "https://github.com/grain-tech/atlas-toolbox.git";
+}, {
+    readonly value: "grain-tech/ai-skills";
+    readonly name: "grain-tech/ai-skills";
+    readonly gitUrl: "https://github.com/grain-tech/ai-skills.git";
+}, {
+    readonly value: "custom";
+    readonly name: "Custom git URL…";
+    readonly gitUrl: null;
+}];
+type CuratedValue = (typeof CURATED_SOURCES)[number]['value'];
+export type AddSkillSourceFn = (entry: {
+    name: string;
+    gitUrl: string;
+    branch?: string;
+    trustMethod: 'flag' | 'interactive';
+}) => SkillSource;
+export type CloneSkillSourceFn = (opts: {
+    gitUrl: string;
+    branch: string;
+    id: string;
+}) => {
+    clonePath: string;
+    headSha: string;
+};
+export type AppendTrustAuditFn = (entry: Omit<TrustAuditEntry, 'timestamp'> & {
+    timestamp?: string;
+}) => TrustAuditEntry;
+export type RedactUrlFn = (url: string) => string;
+export type SelectPromptFn = (config: {
+    message: string;
+    choices: ReadonlyArray<{
+        value: CuratedValue;
+        name: string;
+    }>;
+}) => Promise<CuratedValue>;
+export type InputPromptFn = (config: {
+    message: string;
+    validate: (v: string) => boolean | string;
+}) => Promise<string>;
+export declare function pickSkillSourcePhase(opts: RunSetupOptions, deps: RunSetupDeps): Promise<PhaseResult>;
+export {};
+//# sourceMappingURL=setup-phase-5a-skill-source.d.ts.map

package/dist/commands/setup-phase-5a-skill-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-phase-5a-skill-source.d.ts","sourceRoot":"","sources":["../../src/commands/setup-phase-5a-skill-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAIvF,QAAA,MAAM,eAAe;;;;;;;;;;;;EAgBX,CAAC;AAEX,KAAK,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAY9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,aAAa,CAAC;CACrC,KAAK,WAAW,CAAC;AAElB,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ,KAAK;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KAC/D,eAAe,CAAC;AAErB,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAE5B,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAAC;CAC3C,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAqGtB,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CA2EtB"}