@pleri/olam-cli 0.1.144 → 0.1.146

package/dist/commands/memory/stats.js

@@ -0,0 +1,164 @@
+/**
+ * olam memory stats — operator-facing formatter over `/bridge/stats`.
+ *
+ *   $ olam memory stats
+ *     # human-readable counters + derived cache_error_rate
+ *
+ *   $ olam memory stats --json
+ *     # raw /bridge/stats response (for jq / monitoring scripts)
+ *
+ * Config (env vars):
+ *   AGENTMEMORY_BRIDGE_URL    bridge base URL
+ *                             (default: https://olam-agent-memory.ernestcodes.workers.dev)
+ *   AGENTMEMORY_BRIDGE_SECRET bearer token
+ *
+ * Derived metric: cache_error_rate =
+ *     (cache_busted_hash + cache_busted_version) / max(writes_observed, 1)
+ *
+ *   Interpretation: high rates (>5%) mean operators have been forced to
+ *   reclassify a lot of recent writes — usually a sign that the prompt
+ *   template / classifier_version is churning. The denominator is
+ *   classifier_writes_observed (NOT bridge writes_observed).
+ *
+ * Plan reference:
+ *   docs/plans/agentmemory-classifier-and-regret/phase-b-tasks.md (B5/B6)
+ */
+import { printError, printHeader, printInfo } from '../../output.js';
+const DEFAULT_BRIDGE_URL = 'https://olam-agent-memory.ernestcodes.workers.dev';
+const STATS_TIMEOUT_MS = 10_000;
+/**
+ * Pure helper — separated so it's unit-testable without HTTP.
+ * Guards divide-by-zero (returns 0 when writes_observed === 0, even
+ * if busts are nonzero — Infinity / NaN would be operator-hostile).
+ */
+export function computeCacheErrorRate(counters) {
+    if (counters.writes_observed <= 0)
+        return 0;
+    const busted = counters.cache_busted_hash + counters.cache_busted_version;
+    return busted / counters.writes_observed;
+}
+function resolveBridgeUrl(opts) {
+    return opts.bridgeUrl
+        ?? process.env['AGENTMEMORY_BRIDGE_URL']
+        ?? DEFAULT_BRIDGE_URL;
+}
+function resolveBearer(opts) {
+    const fromOpt = opts.bearer;
+    if (fromOpt && fromOpt.length > 0)
+        return fromOpt;
+    const fromEnv = process.env['AGENTMEMORY_BRIDGE_SECRET'];
+    if (fromEnv && fromEnv.length > 0)
+        return fromEnv;
+    return null;
+}
+function intOrZero(v) {
+    if (typeof v !== 'number' || !Number.isFinite(v))
+        return 0;
+    return Math.trunc(v);
+}
+function extractCounters(stats) {
+    return {
+        writes_observed: intOrZero(stats.classifier_writes_observed),
+        writes_deduped_hash: intOrZero(stats.classifier_writes_deduped_hash),
+        writes_deduped_semantic: intOrZero(stats.classifier_writes_deduped_semantic),
+        recalls_observed: intOrZero(stats.classifier_recalls_observed),
+        cache_busted_hash: intOrZero(stats.classifier_cache_busted_hash),
+        cache_busted_version: intOrZero(stats.classifier_cache_busted_version),
+    };
+}
+/**
+ * Run the stats call. Pure-ish: takes opts + fetch (so tests can stub) +
+ * returns a structured result. Mirrors `runReclassify` for symmetry.
+ */
+export async function runStats(opts, fetchImpl = fetch) {
+    const bridgeUrl = resolveBridgeUrl(opts);
+    const bearer = resolveBearer(opts);
+    if (!bearer) {
+        return {
+            ok: false,
+            error: 'AGENTMEMORY_BRIDGE_SECRET not set (or --bearer not passed)',
+        };
+    }
+    try {
+        const res = await fetchImpl(`${bridgeUrl}/bridge/stats`, {
+            method: 'GET',
+            headers: {
+                authorization: `Bearer ${bearer}`,
+            },
+            signal: AbortSignal.timeout(STATS_TIMEOUT_MS),
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            return {
+                ok: false,
+                error: `bridge returned ${res.status} ${res.statusText}${detail ? `: ${detail.slice(0, 200)}` : ''}`,
+            };
+        }
+        const payload = (await res.json());
+        if (!payload || typeof payload !== 'object' || !payload.stats || typeof payload.stats !== 'object') {
+            return {
+                ok: false,
+                error: 'bridge response missing stats envelope',
+            };
+        }
+        const counters = extractCounters(payload.stats);
+        const cacheErrorRate = computeCacheErrorRate(counters);
+        return {
+            ok: true,
+            counters,
+            cacheErrorRate,
+            raw: payload,
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+function formatPct(numerator, denominator) {
+    if (denominator <= 0)
+        return '0.0%';
+    return `${((numerator / denominator) * 100).toFixed(1)}%`;
+}
+/** Run + render. Returns the process exit code. */
+export async function runStatsCli(opts) {
+    const result = await runStats(opts);
+    if (opts.json) {
+        // Preserve the raw bridge envelope when possible so jq pipelines
+        // see the same shape they'd get from curl. Fall back to the
+        // structured result on error so callers can still inspect.
+        const out = result.ok && result.raw !== undefined ? result.raw : result;
+        process.stdout.write(JSON.stringify(out, null, 2) + '\n');
+        return result.ok ? 0 : 1;
+    }
+    printHeader('olam memory stats — bridge counters');
+    if (!result.ok) {
+        printError(`stats failed: ${result.error ?? '(unknown error)'}`);
+        return 1;
+    }
+    const c = result.counters;
+    printInfo('writes_observed', String(c.writes_observed));
+    printInfo('writes_deduped_hash', `${c.writes_deduped_hash}  (${formatPct(c.writes_deduped_hash, c.writes_observed)})`);
+    printInfo('writes_deduped_semantic', `${c.writes_deduped_semantic}  (${formatPct(c.writes_deduped_semantic, c.writes_observed)})`);
+    printInfo('recalls_observed', String(c.recalls_observed));
+    printInfo('cache_busted_hash', String(c.cache_busted_hash));
+    printInfo('cache_busted_version', String(c.cache_busted_version));
+    printInfo('cache_error_rate', `${(result.cacheErrorRate * 100).toFixed(1)}%`);
+    return 0;
+}
+export function registerMemoryStats(cmd) {
+    cmd
+        .command('stats')
+        .description('Fetch /bridge/stats from the agent-memory bridge and format classifier counters (writes_observed, dedup rates, recalls, cache busts, derived cache_error_rate)')
+        .option('--bridge-url <url>', 'Override AGENTMEMORY_BRIDGE_URL')
+        .option('--bearer <token>', 'Override AGENTMEMORY_BRIDGE_SECRET')
+        .option('--json', 'Machine-readable JSON output (raw bridge envelope)', false)
+        .action(async (opts) => {
+        const rc = await runStatsCli(opts);
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=stats.js.map

package/dist/commands/memory/stats.js.map

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

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

@@ -0,0 +1,14 @@
+/**
+ * olam skills doctor — diagnostic + auto-repair for the skills surface.
+ *
+ *   olam skills doctor                  # print report; interactive prompts
+ *                                       # per issue when TTY
+ *   olam skills doctor --auto-fix       # apply every repair without prompt
+ *   olam skills doctor --check-only     # exit 1 on any issue; never modify
+ *                                       # state (read-only health probe)
+ *
+ * Mirrors `olam kg doctor`'s shape; per OQ12 [assumed].
+ */
+import type { Command } from 'commander';
+export declare function registerSkillsDoctor(program: Command): void;
+//# sourceMappingURL=skills-doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills-doctor.d.ts","sourceRoot":"","sources":["../../src/commands/skills-doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgDzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6E3D"}

package/dist/commands/skills-doctor.js

@@ -0,0 +1,126 @@
+/**
+ * olam skills doctor — diagnostic + auto-repair for the skills surface.
+ *
+ *   olam skills doctor                  # print report; interactive prompts
+ *                                       # per issue when TTY
+ *   olam skills doctor --auto-fix       # apply every repair without prompt
+ *   olam skills doctor --check-only     # exit 1 on any issue; never modify
+ *                                       # state (read-only health probe)
+ *
+ * Mirrors `olam kg doctor`'s shape; per OQ12 [assumed].
+ */
+import * as readline from 'node:readline';
+import pc from 'picocolors';
+import { runAllDoctorChecks, } from '@olam/core/src/skill-sources/index.js';
+import { printError, printHeader, printSuccess, printWarning } from '../output.js';
+function asMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function defaultDoctorPrompt(question) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(question, (a) => {
+            rl.close();
+            resolve(a);
+        });
+    });
+}
+async function confirmRepair(check) {
+    const testFn = globalThis.__olamTestDoctorPrompt;
+    const prompt = testFn ?? (() => defaultDoctorPrompt(`Apply repair for "${check.name}"? [y/N] `));
+    const answer = (await prompt()).trim().toLowerCase();
+    return answer === 'y' || answer === 'yes';
+}
+function printCheck(check) {
+    if (check.healthy) {
+        console.log(`  ${pc.green('✓')} ${pc.bold(check.name.padEnd(22))} ${pc.dim(check.description)}`);
+        if (check.details && check.details.length > 0) {
+            for (const d of check.details)
+                console.log(`      ${pc.dim(d)}`);
+        }
+    }
+    else {
+        console.log(`  ${pc.red('✗')} ${pc.bold(check.name.padEnd(22))} ${pc.yellow(check.issue ?? 'unhealthy')}`);
+        console.log(`      ${pc.dim(check.description)}`);
+        if (check.details) {
+            for (const d of check.details.slice(0, 10))
+                console.log(`      ${pc.dim('· ' + d)}`);
+            if (check.details.length > 10)
+                console.log(`      ${pc.dim(`… and ${check.details.length - 10} more`)}`);
+        }
+    }
+}
+export function registerSkillsDoctor(program) {
+    const skills = program.commands.find((c) => c.name() === 'skills') ??
+        program.command('skills').description('Manage skill sources and synchronization');
+    skills
+        .command('doctor')
+        .description('Diagnose 4 corruption classes; auto-repair available with --auto-fix')
+        .option('--auto-fix', 'Apply each repair without prompting')
+        .option('--check-only', 'Report issues + exit non-zero without modifying state')
+        .action(async (opts) => {
+        if (opts.autoFix && opts.checkOnly) {
+            printError('--auto-fix and --check-only are mutually exclusive');
+            process.exitCode = 1;
+            return;
+        }
+        printHeader('skills doctor');
+        let checks;
+        try {
+            checks = runAllDoctorChecks();
+        }
+        catch (err) {
+            printError(`doctor checks crashed: ${asMessage(err)}`);
+            process.exitCode = 1;
+            return;
+        }
+        for (const c of checks)
+            printCheck(c);
+        const unhealthy = checks.filter((c) => !c.healthy);
+        if (unhealthy.length === 0) {
+            console.log();
+            printSuccess('all 4 checks PASS');
+            return;
+        }
+        console.log();
+        printWarning(`${unhealthy.length} of ${checks.length} check(s) report issues`);
+        if (opts.checkOnly) {
+            console.log(pc.dim('(--check-only — exiting without repair)'));
+            process.exitCode = 1;
+            return;
+        }
+        let repaired = 0;
+        let skipped = 0;
+        for (const check of unhealthy) {
+            if (!check.repair) {
+                console.log(pc.dim(`  (no auto-repair for ${check.name} — operator-attention required)`));
+                skipped += 1;
+                continue;
+            }
+            const shouldRepair = opts.autoFix ? true : await confirmRepair(check);
+            if (!shouldRepair) {
+                console.log(pc.dim(`  skipped: ${check.name}`));
+                skipped += 1;
+                continue;
+            }
+            try {
+                await check.repair();
+                console.log(pc.green(`  repaired: ${check.name}`));
+                repaired += 1;
+            }
+            catch (err) {
+                printError(`  repair failed for ${check.name}: ${asMessage(err)}`);
+                skipped += 1;
+            }
+        }
+        console.log();
+        if (skipped > 0) {
+            printWarning(`repaired ${repaired}; skipped ${skipped}. Re-run doctor to verify.`);
+            process.exitCode = skipped > 0 ? 1 : 0;
+        }
+        else {
+            printSuccess(`repaired ${repaired} issue(s). Re-run doctor to verify.`);
+        }
+    });
+}
+//# sourceMappingURL=skills-doctor.js.map

package/dist/commands/skills-doctor.js.map

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

package/dist/commands/skills-hook.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `olam skills install-hook [--scope project|user]` — install the
+ * SessionStart hook that runs `olam skills sync --quiet` on every
+ * Claude Code session start.
+ *
+ * `olam skills uninstall-hook [--scope project|user]` — surgical
+ * sentinel-matched removal.
+ *
+ * Mirrors `olam kg install-hook` / `olam kg uninstall-hook` shape:
+ *   - `--scope project` (default) → <cwd>/.claude/settings.json
+ *   - `--scope user`              → ~/.claude/settings.json
+ *
+ * Idempotent install via OLAM_SKILLS_HOOK_SENTINEL substring-match.
+ * Surgical uninstall: only entries whose command contains the sentinel
+ * are dropped; user-authored hooks are preserved.
+ */
+import type { Command } from 'commander';
+export declare function registerSkillsHook(program: Command): void;
+//# sourceMappingURL=skills-hook.d.ts.map

package/dist/commands/skills-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-hook.d.ts","sourceRoot":"","sources":["../../src/commands/skills-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuEzD"}

package/dist/commands/skills-hook.js

@@ -0,0 +1,99 @@
+/**
+ * `olam skills install-hook [--scope project|user]` — install the
+ * SessionStart hook that runs `olam skills sync --quiet` on every
+ * Claude Code session start.
+ *
+ * `olam skills uninstall-hook [--scope project|user]` — surgical
+ * sentinel-matched removal.
+ *
+ * Mirrors `olam kg install-hook` / `olam kg uninstall-hook` shape:
+ *   - `--scope project` (default) → <cwd>/.claude/settings.json
+ *   - `--scope user`              → ~/.claude/settings.json
+ *
+ * Idempotent install via OLAM_SKILLS_HOOK_SENTINEL substring-match.
+ * Surgical uninstall: only entries whose command contains the sentinel
+ * are dropped; user-authored hooks are preserved.
+ */
+import { installSkillsHookToFile, skillsHookSettingsPathFor, uninstallSkillsHookFromFile, } from '@olam/core/src/skill-sources/index.js';
+import * as fs from 'node:fs';
+import { printError, printInfo, printSuccess, printWarning } from '../output.js';
+function backup(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = `${filePath}.olam-bak.${ts}`;
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+export function registerSkillsHook(program) {
+    const skills = program.commands.find((c) => c.name() === 'skills') ??
+        program.command('skills').description('Manage skill sources and synchronization');
+    skills
+        .command('install-hook')
+        .description('Install the SessionStart hook that runs `olam skills sync --quiet` on session start')
+        .option('--scope <scope>', 'project (default; <cwd>/.claude/settings.json) or user (~/.claude/settings.json)', 'project')
+        .action((opts) => {
+        const scope = opts.scope === 'user' ? 'user' : 'project';
+        const filePath = skillsHookSettingsPathFor(scope);
+        try {
+            const result = installSkillsHookToFile(filePath);
+            switch (result.status) {
+                case 'installed':
+                    printSuccess(`olam-skills SessionStart hook installed (${scope} scope)`);
+                    printInfo('settings', filePath);
+                    if (result.backupPath)
+                        printInfo('backup', result.backupPath);
+                    printInfo('next', 'open a new Claude Code session; `olam skills sync --quiet` will run on start');
+                    return;
+                case 'already-present':
+                    printInfo('olam-skills hook', `already installed at ${filePath}`);
+                    return;
+                case 'no-op':
+                    printWarning(`no change made to ${filePath}`);
+                    return;
+            }
+        }
+        catch (err) {
+            printError(`install-hook failed: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+    });
+    skills
+        .command('uninstall-hook')
+        .description('Remove the olam-skills SessionStart hook from settings.json (sentinel-matched; surgical)')
+        .option('--scope <scope>', 'project (default) or user', 'project')
+        .action((opts) => {
+        const scope = opts.scope === 'user' ? 'user' : 'project';
+        const filePath = skillsHookSettingsPathFor(scope);
+        const backupPath = backup(filePath);
+        try {
+            const result = uninstallSkillsHookFromFile(filePath);
+            switch (result.status) {
+                case 'removed':
+                    printSuccess(`olam-skills SessionStart hook removed from ${filePath}`);
+                    if (backupPath)
+                        printInfo('backup', backupPath);
+                    return;
+                case 'not-found':
+                    printInfo('olam-skills hook', `not found in ${filePath} — already uninstalled`);
+                    if (backupPath) {
+                        try {
+                            fs.unlinkSync(backupPath);
+                        }
+                        catch { /* best-effort */ }
+                    }
+                    return;
+                case 'no-settings':
+                    printInfo('olam-skills hook', `no settings.json at ${filePath} — nothing to remove`);
+                    return;
+            }
+        }
+        catch (err) {
+            printError(`uninstall-hook failed: ${err instanceof Error ? err.message : String(err)}`);
+            if (backupPath)
+                printInfo('backup', `settings.json preserved at ${backupPath}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=skills-hook.js.map

package/dist/commands/skills-hook.js.map

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

package/dist/commands/skills-migrate-back.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `olam skills migrate-back-to-toolbox` — reverse the migration performed
+ * by `migrate-from-toolbox`, consuming the pre-migration snapshot written
+ * at ~/.olam/state/migration-snapshots/<namespace>-<ISO>.json.
+ *
+ * Reverse order of migrate-from-toolbox operations:
+ *   1. resolve snapshot (latest matching --path / --namespace / --snapshot)
+ *   2. uninstall olam-skills SessionStart hook (sentinel-matched)
+ *   3. delete olam-managed symlinks under ~/.claude/ (any symlink whose
+ *      target lives under ~/.olam/state/skill-sources/<id>/)
+ *   4. restore the original SessionStart hook block from snapshot
+ *   5. restore the toolbox-managed symlinks from snapshot
+ *   6. restore ~/.claude/.atlas-user from snapshot (atlas-shape only)
+ *   7. unless --keep-source: remove the toolbox olam source registration
+ *      (skill-sources slice + clone dir)
+ */
+import type { Command } from 'commander';
+/** Stable command identifier — referenced by tests to keep them rename-resilient. */
+export declare const MIGRATE_BACK_TO_TOOLBOX_COMMAND = "migrate-back-to-toolbox";
+export declare function registerSkillsMigrateBack(program: Command): void;
+//# sourceMappingURL=skills-migrate-back.d.ts.map

package/dist/commands/skills-migrate-back.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-migrate-back.d.ts","sourceRoot":"","sources":["../../src/commands/skills-migrate-back.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,qFAAqF;AACrF,eAAO,MAAM,+BAA+B,4BAA4B,CAAC;AAiGzE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoHhE"}