@pleri/olam-cli 0.1.201 → 0.1.205

package/dist/commands/kg-build.js

@@ -1,282 +0,0 @@
-/**
- * `olam kg build` — pristine workspace KG build via kg-service `/build`.
- *
- * kg-service-container-v2 Phase F (2026-05-14) migrates this command
- * from the legacy host-side scratch-copy + docker-run-graphify pattern
- * to a single HTTP POST to the always-running `olam-kg-service`
- * container. The scratch-copy now happens INSIDE the container as root
- * (no host UID permission issues), so multi-submodule workspaces with
- * non-operator-owned `.git/objects/pack/*` files and broken symlinks
- * build cleanly — closes Samuel's atlas-core failure from 2026-05-13.
- *
- * Flow:
- *   1. Resolve workspace name + source path (cwd by default).
- *   2. Translate cwd to container-side path under `/host-home/…`
- *      (kg-service container mounts $HOME read-only at /host-home).
- *   3. POST {workspace, repo_path} to localhost:9997/build.
- *   4. Server-side: cp source → /tmp/scratch (root-perms), graphify
- *      update, move output to /kg-data/<workspace>/graphify-out/, clean.
- *   5. Write host-side freshness.json mirroring the server's response.
- *
- * Failure modes surfaced with remedies:
- *   - kg-service not reachable → "run `olam services up`".
- *   - cwd not under $HOME → operator hint (mount path is $HOME:/host-home).
- *   - graphify timeout / failure / scratch_copy_failed → pass-through error.
- *
- * Out of scope (v1 behaviour retained):
- *   - Workspace-catalog lookup (deferred follow-on); cwd-as-source.
- *   - Watching / progress streaming — `/build` is synchronous, blocking.
- */
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-import { kgPristinePath } from '@olam/core/src/kg/storage-paths.js';
-import { validateWorkspaceName } from '@olam/core/src/world/workspace-name.js';
-import { build as kgServiceBuild, KgServiceUnreachableError, } from '@olam/core/src/kg/kg-service-client.js';
-import { printError, printInfo, printSuccess } from '../output.js';
-import { registerKgStatusCommand } from './kg-status.js';
-import { registerKgWatchCommand } from './kg-watch.js';
-import { registerKgClassifyCommand } from './kg-classify.js';
-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';
-import { registerKgMirrorCommand } from './kg-mirror.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.
- * Validates the workspace name regex via @olam/core's single source of truth.
- */
-function resolveWorkspace(arg) {
-    const cwd = process.cwd();
-    const name = arg ?? path.basename(cwd).toLowerCase();
-    validateWorkspaceName(name);
-    return { name, sourcePath: cwd };
-}
-/**
- * Translate a host-side absolute path to the container's view of the same
- * file, given that kg-service mounts `$HOME:/host-home:ro`.
- *
- *   /Users/ernie/Projects/atlas-core   →   /host-home/Projects/atlas-core
- *
- * Throws when the source path doesn't live under $HOME (kg-service can't
- * see it). Operator hint surfaces the mount layout in the error message.
- */
-function toContainerPath(hostPath) {
-    const home = os.homedir();
-    const resolved = path.resolve(hostPath);
-    if (!resolved.startsWith(home + path.sep) && resolved !== home) {
-        throw new Error(`source path "${resolved}" is not under $HOME (${home}). kg-service can only build ` +
-            `repos that live under your home dir (it bind-mounts $HOME:/host-home:ro at start). ` +
-            `Move the repo or set OLAM_HOME if you need a different root.`);
-    }
-    const rel = path.relative(home, resolved);
-    return rel === '' ? '/host-home' : path.posix.join('/host-home', rel.split(path.sep).join('/'));
-}
-/**
- * Programmatic entry point — exported so tests can drive without spawning
- * a sub-process.
- */
-export async function runKgBuild(workspaceArg, options = {}) {
-    let workspace;
-    try {
-        workspace = resolveWorkspace(workspaceArg);
-    }
-    catch (err) {
-        printError(err instanceof Error ? err.message : String(err));
-        return { exitCode: 2 };
-    }
-    let containerRepoPath;
-    try {
-        containerRepoPath = toContainerPath(workspace.sourcePath);
-    }
-    catch (err) {
-        printError(err instanceof Error ? err.message : String(err));
-        return { exitCode: 2 };
-    }
-    // Resolve / pre-create the host-side output directory. kg-service writes
-    // graphify-out/ into /kg-data/<workspace>/, which is bind-mounted at
-    // start time to the OLAM_HOME-aware kgRoot(). We mirror that here so
-    // host-side `olam kg status` can read freshness.json without reaching
-    // into the container.
-    const outDir = kgPristinePath(workspace.name);
-    fs.mkdirSync(outDir, { recursive: true });
-    const human = !options.json;
-    if (human) {
-        printInfo('kg build', `workspace=${workspace.name} source=${workspace.sourcePath}`);
-        printInfo('kg build', `→ kg-service /build (container path ${containerRepoPath}) → ${outDir}/graphify-out/`);
-    }
-    let resp;
-    try {
-        resp = await kgServiceBuild({
-            workspace: workspace.name,
-            repo_path: containerRepoPath,
-        });
-    }
-    catch (err) {
-        if (err instanceof KgServiceUnreachableError) {
-            printError(err.message);
-            printInfo('remedy', 'run `olam services up` to start kg-service, then re-run `olam kg build`.');
-            return { exitCode: 3 };
-        }
-        printError(`kg-service /build failed: ${err instanceof Error ? err.message : String(err)}`);
-        return { exitCode: 1 };
-    }
-    if (!resp.ok) {
-        printError(`kg-service /build returned error: ${resp.error ?? 'unknown'}`);
-        return { exitCode: 1 };
-    }
-    // Mirror the server-authoritative freshness onto the host. The server
-    // already wrote /kg-data/<ws>/freshness.json, but writing again here
-    // keeps the host-side freshness contract identical to v1's shape for
-    // downstream consumers (kg-status, kg-watch) that haven't migrated.
-    const freshness = {
-        built_at: resp.built_at ?? new Date().toISOString(),
-        duration_ms: resp.duration_ms ?? 0,
-        node_count: resp.nodes ?? null,
-        edge_count: resp.edges ?? null,
-        workspace: workspace.name,
-        graphify_path: 'container',
-    };
-    fs.writeFileSync(path.join(outDir, 'freshness.json'), JSON.stringify(freshness, null, 2) + '\n', 'utf-8');
-    const finalOut = path.join(outDir, 'graphify-out');
-    if (options.json) {
-        process.stdout.write(JSON.stringify(freshness) + '\n');
-    }
-    else {
-        printSuccess(`kg build ${workspace.name} — ${resp.nodes ?? '?'} nodes / ${resp.edges ?? '?'} edges in ${((resp.duration_ms ?? 0) / 1000).toFixed(1)}s (via kg-service container)`);
-        printInfo('output', `${finalOut}/graph.json`);
-    }
-    return { exitCode: 0, freshness, outputDir: finalOut };
-}
-/**
- * `olam kg <subcommand>` group — registers the kg subcommand tree.
- */
-export function registerKg(program) {
-    const kg = program.command('kg').description('Knowledge-graph operations (kg-service container)');
-    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;
-    });
-    // Phase C — operational polish (status report + opt-in watcher).
-    registerKgStatusCommand(kg);
-    registerKgWatchCommand(kg);
-    // kg-service-container-v2 Phase C — HTTP-client wrappers around localhost:9997.
-    registerKgClassifyCommand(kg);
-    registerKgDoctorCommand(kg);
-    // kg-service-container-v2 Phase D — settings.json mutation for the PreToolUse hook.
-    registerKgInstallHookCommand(kg);
-    registerKgUninstallHookCommand(kg);
-    // kg-hit-signal — cumulative savings telemetry tallied by /kg-data/savings.jsonl.
-    registerKgSavingsCommand(kg);
-    // cloud-kg-mirror (Phase 1) — `olam kg mirror build` / `olam kg mirror status`.
-    registerKgMirrorCommand(kg);
-}
-//# sourceMappingURL=kg-build.js.map

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

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

package/dist/commands/kg-classify.d.ts

@@ -1,30 +0,0 @@
-/**
- * `olam kg classify <question>` — invoke the 4-layer classifier via kg-service.
- *
- * Thin HTTP wrapper around POST localhost:9997/classify. Optional --workspace
- * scopes the probe gate (L2) to a specific graph; --json prints the raw
- * response for scripting. Default output is operator-friendly text.
- *
- * `runKgClassify` is the injectable core used by unit tests. The commander
- * action is a thin wrapper that sets exitCode on failure.
- */
-import type { Command } from 'commander';
-import { KgServiceUnreachableError, type ClassifyRequest, type ClassifyResponse } from '@olam/core/src/kg/kg-service-client.js';
-export type { ClassifyRequest, ClassifyResponse };
-export { KgServiceUnreachableError };
-export interface KgClassifyResult {
-    readonly exitCode: number;
-    readonly response?: ClassifyResponse;
-    readonly error?: string;
-}
-/**
- * Pure, injectable classify runner. The commander action delegates here.
- * Tests drive this directly with `classifyImpl` injected as a fetch-mocked stub.
- */
-export declare function runKgClassify(req: ClassifyRequest, opts?: {
-    json?: boolean;
-}, classifyImpl?: (req: ClassifyRequest, opts?: {
-    timeoutMs?: number;
-}) => Promise<ClassifyResponse>): Promise<KgClassifyResult>;
-export declare function registerKgClassifyCommand(kg: Command): void;
-//# sourceMappingURL=kg-classify.d.ts.map

package/dist/commands/kg-classify.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kg-classify.d.ts","sourceRoot":"","sources":["../../src/commands/kg-classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAEL,yBAAyB,EACzB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,wCAAwC,CAAC;AAIhD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAIrC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,eAAe,EACpB,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,EAC7B,YAAY,GAAE,CACZ,GAAG,EAAE,eAAe,EACpB,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KAC1B,OAAO,CAAC,gBAAgB,CAAY,GACxC,OAAO,CAAC,gBAAgB,CAAC,CAc3B;AAcD,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CA0C3D"}

package/dist/commands/kg-classify.js

@@ -1,88 +0,0 @@
-/**
- * `olam kg classify <question>` — invoke the 4-layer classifier via kg-service.
- *
- * Thin HTTP wrapper around POST localhost:9997/classify. Optional --workspace
- * scopes the probe gate (L2) to a specific graph; --json prints the raw
- * response for scripting. Default output is operator-friendly text.
- *
- * `runKgClassify` is the injectable core used by unit tests. The commander
- * action is a thin wrapper that sets exitCode on failure.
- */
-import pc from 'picocolors';
-import { classify, KgServiceUnreachableError, } from '@olam/core/src/kg/kg-service-client.js';
-import { printError, printInfo } from '../output.js';
-export { KgServiceUnreachableError };
-/**
- * Pure, injectable classify runner. The commander action delegates here.
- * Tests drive this directly with `classifyImpl` injected as a fetch-mocked stub.
- */
-export async function runKgClassify(req, opts = {}, classifyImpl = classify) {
-    try {
-        const result = await classifyImpl(req);
-        if (opts.json) {
-            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
-        }
-        return { exitCode: 0, response: result };
-    }
-    catch (err) {
-        if (err instanceof KgServiceUnreachableError) {
-            return { exitCode: 1, error: err.message };
-        }
-        const msg = err instanceof Error ? err.message : String(err);
-        return { exitCode: 1, error: `classify failed: ${msg}` };
-    }
-}
-/** Compact token-count formatting (mirrors `kg savings`' `~`-prefix convention). */
-function formatSavedTokens(n) {
-    if (n >= 1_000_000)
-        return `~${(n / 1_000_000).toFixed(1)}M`;
-    if (n >= 1_000)
-        return `~${Math.round(n / 1000)}k`;
-    return `~${n}`;
-}
-export function registerKgClassifyCommand(kg) {
-    kg.command('classify <question>')
-        .description('Route a question to kg | grep | both via the 4-layer classifier (kg-service required)')
-        .option('--workspace <name>', 'Scope the L2 probe gate to a specific workspace graph')
-        .option('--json', 'Emit raw JSON instead of the formatted summary')
-        .action(async (question, opts) => {
-        const r = await runKgClassify({ q: question, workspace: opts.workspace }, { json: opts.json });
-        if (r.exitCode !== 0) {
-            printError(r.error ?? 'classify failed');
-            process.exitCode = r.exitCode;
-            return;
-        }
-        if (opts.json || !r.response)
-            return;
-        // Operator-friendly summary
-        const result = r.response;
-        const routeStr = result.route === 'kg'
-            ? pc.cyan('kg')
-            : result.route === 'grep'
-                ? pc.magenta('grep')
-                : pc.yellow('both');
-        printInfo('route', `${routeStr}  (layer ${result.layer}, took ${result.took_ms}ms)`);
-        printInfo('confidence', String(result.confidence));
-        printInfo('reason', result.reason);
-        if (result.rule_fired)
-            printInfo('rule fired', result.rule_fired);
-        if (result.top_match)
-            printInfo('top match', `${result.top_match} (sim=${result.top_sim ?? '?'})`);
-        if (result.candidate_symbols.length > 0) {
-            printInfo('symbols', result.candidate_symbols.join(', '));
-        }
-        // Hit-signal metadata enriched by the server. `nodes_matched` is the
-        // count of distinct symbol/exemplar matches the route resolved to —
-        // the "matched signals" an operator wants to see at a glance. Only
-        // meaningful (and only emitted) when the route is not grep.
-        if (result.route !== 'grep') {
-            if (result.nodes_matched != null) {
-                printInfo('matched signals', String(result.nodes_matched));
-            }
-            if (result.savings && result.savings.saved_tokens_est > 0) {
-                printInfo('est. savings', `${formatSavedTokens(result.savings.saved_tokens_est)} tokens`);
-            }
-        }
-    });
-}
-//# sourceMappingURL=kg-classify.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"kg-classify.js","sourceRoot":"","sources":["../../src/commands/kg-classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EACL,QAAQ,EACR,yBAAyB,GAG1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIrD,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAUrC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAoB,EACpB,OAA2B,EAAE,EAC7B,eAGiC,QAAQ;IAEzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,yBAAyB,EAAE,CAAC;YAC7C,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7C,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,oBAAoB,GAAG,EAAE,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC;AAOD,oFAAoF;AACpF,SAAS,iBAAiB,CAAC,CAAS;IAClC,IAAI,CAAC,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7D,IAAI,CAAC,IAAI,KAAK;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;IACnD,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,EAAW;IACnD,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,uFAAuF,CAAC;SACpG,MAAM,CAAC,oBAAoB,EAAE,uDAAuD,CAAC;SACrF,MAAM,CAAC,QAAQ,EAAE,gDAAgD,CAAC;SAClE,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,IAAuB,EAAE,EAAE;QAC1D,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/F,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACrB,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,iBAAiB,CAAC,CAAC;YACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ;YAAE,OAAO;QACrC,4BAA4B;QAC5B,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC;QAC1B,MAAM,QAAQ,GACZ,MAAM,CAAC,KAAK,KAAK,IAAI;YACnB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;YACf,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM;gBACvB,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;gBACpB,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,SAAS,CAAC,OAAO,EAAE,GAAG,QAAQ,YAAY,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC;QACrF,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QACnD,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,UAAU;YAAE,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,SAAS;YAAE,SAAS,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,SAAS,SAAS,MAAM,CAAC,OAAO,IAAI,GAAG,GAAG,CAAC,CAAC;QACnG,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,qEAAqE;QACrE,oEAAoE;QACpE,mEAAmE;QACnE,4DAA4D;QAC5D,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC5B,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;gBACjC,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;gBAC1D,SAAS,CAAC,cAAc,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/kg-doctor.d.ts

@@ -1,76 +0,0 @@
-/**
- * `olam kg doctor` — diagnostic table for the kg-service container.
- *
- * Probes (in order):
- *   1. container  — Container state (running / stopped / missing)
- *   2. health     — /health responds with ready=true (+ version + uptime)
- *   3. workspaces — /status lists at least one workspace (advisory; warn if empty)
- *   4. classify   — /classify round-trip works end-to-end (synthetic probe)
- *   5. savings     — cumulative KG-hit tally (advisory; "is the hook firing?")
- *
- * Exit 0 on all-green; non-zero on the first hard failure with a remedy hint.
- * Advisory warnings (empty workspaces, zero hits) never flip the exit code.
- * --json emits a machine-readable structure for monitoring pipelines.
- *
- * The probe walk is a pure, injectable function (`runKgDoctor`) so it can be
- * unit-tested without a live container — mirrors the `runKgStatus` /
- * `runDoctor` testability pattern used elsewhere in the CLI.
- */
-import type { Command } from 'commander';
-import { type ClassifyResponse, type HealthResponse, type SavingsResponse, type StatusResponse } from '@olam/core/src/kg/kg-service-client.js';
-interface KgDoctorOptions {
-    readonly json?: boolean;
-}
-interface ProbeResult {
-    readonly name: string;
-    readonly status: 'ok' | 'warn' | 'fail';
-    readonly detail?: string;
-    readonly remedy?: string;
-}
-/**
- * Minimal surface of `KgServiceContainerController` the probe walk needs.
- * Declaring it as an interface lets tests inject a fake without spawning
- * `docker inspect`.
- */
-export interface KgDoctorContainerProbe {
-    status(): {
-        state: 'running' | 'stopped' | 'missing';
-        port: number;
-    };
-    imageMissingEverywhere(): boolean;
-}
-/**
- * Injectable dependencies for `runKgDoctor`. Defaults wire the real
- * kg-service HTTP client + container controller; tests pass fakes.
- */
-export interface KgDoctorDeps {
-    readonly controller?: KgDoctorContainerProbe;
-    readonly health?: (opts?: {
-        timeoutMs?: number;
-    }) => Promise<HealthResponse>;
-    readonly status?: (opts?: {
-        timeoutMs?: number;
-    }) => Promise<StatusResponse>;
-    readonly classify?: (req: {
-        q: string;
-        workspace?: string;
-    }, opts?: {
-        timeoutMs?: number;
-    }) => Promise<ClassifyResponse>;
-    readonly savings?: (opts?: {
-        timeoutMs?: number;
-    }) => Promise<SavingsResponse>;
-}
-export interface KgDoctorResult {
-    readonly exitCode: number;
-    readonly probes: ReadonlyArray<ProbeResult>;
-}
-/**
- * Pure, injectable probe walk. Renders to the configured output when not in
- * JSON mode and returns the structured result + exit code. Tests drive this
- * directly with fake deps; the commander action is a thin wrapper.
- */
-export declare function runKgDoctor(opts: KgDoctorOptions, deps?: KgDoctorDeps): Promise<KgDoctorResult>;
-export declare function registerKgDoctorCommand(kg: Command): void;
-export {};
-//# sourceMappingURL=kg-doctor.d.ts.map

package/dist/commands/kg-doctor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kg-doctor.d.ts","sourceRoot":"","sources":["../../src/commands/kg-doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,wCAAwC,CAAC;AAGhD,UAAU,eAAe;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,IAAI;QAAE,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,sBAAsB,IAAI,OAAO,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAClB,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EACtC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAC1B,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CAC7C;AAoLD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,eAAe,EACrB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,cAAc,CAAC,CAmCzB;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAUzD"}