@pleri/olam-cli 0.1.144 → 0.1.145

package/dist/commands/memory/bridge.js

@@ -0,0 +1,156 @@
+/**
+ * olam memory bridge serve --local — embedded Miniflare bridge.
+ *
+ * `wrangler dev` is a dev iteration loop, not a production-style host
+ * for a long-lived service. This subcommand spawns
+ * `packages/memory-service/scripts/local-bridge-server.mjs` as a
+ * foreground Node process: operators wire it into launchd / systemd
+ * (Type=simple) and get the agent-memory bridge running on their
+ * laptop without a Cloudflare account.
+ *
+ * Flow:
+ *   1. Resolve packages/memory-service/ via the shared candidates list
+ *      (handles workspace / bundled-CLI / cwd-checkout layouts).
+ *   2. Locate scripts/local-bridge-server.mjs inside it.
+ *   3. Ensure ~/.olam/memory-secret (0600) exists; pass it via
+ *      AGENTMEMORY_SECRET env so the bridge can authenticate
+ *      /bridge/stats callers without leaking the secret on argv.
+ *   4. Spawn the .mjs in foreground; stdin/stdout/stderr propagate so
+ *      the service-manager journal captures the bridge's logs.
+ *   5. Forward SIGTERM/SIGINT to the child + exit with its code.
+ *
+ * Mirrors `start.ts`'s service-resolution + secret-handling pattern;
+ * differs in that the spawned process stays in foreground (start.ts
+ * detaches because the agentmemory engine is a separate long-lived
+ * service).
+ *
+ * Plan reference: architecture conversation in PR #612.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { printError, printHeader, printInfo } from '../../output.js';
+import { ensureMemorySecret } from '../../lib/memory-secret.js';
+import { MEMORY_SERVICE_CANDIDATES } from './_paths.js';
+const DEFAULT_PORT = 8788;
+export function resolveMemoryServiceDir() {
+    for (const c of MEMORY_SERVICE_CANDIDATES) {
+        if (existsSync(c))
+            return c;
+    }
+    throw new Error(`Could not find packages/memory-service/. Searched: ${MEMORY_SERVICE_CANDIDATES.join(', ')}. ` +
+        `If running from a published @pleri/olam-cli tarball, this is a packaging bug — please file an issue.`);
+}
+export function resolveLocalBridgeScript(serviceDir) {
+    const path = join(serviceDir, 'scripts', 'local-bridge-server.mjs');
+    if (!existsSync(path)) {
+        throw new Error(`Could not find local-bridge-server.mjs at ${path}. ` +
+            `Verify packages/memory-service ships the scripts/ directory.`);
+    }
+    return path;
+}
+export function validateBridgeOpts(opts) {
+    const local = opts.local ?? false;
+    if (!local) {
+        throw new Error(`'olam memory bridge serve' currently requires --local. ` +
+            `Remote-bridge orchestration is reserved for future flags.`);
+    }
+    const port = opts.port ?? DEFAULT_PORT;
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new Error(`--port must be an integer 0..65535 (got: ${opts.port})`);
+    }
+    const result = {
+        port,
+        local,
+    };
+    if (typeof opts.persistTo === 'string' && opts.persistTo.length > 0) {
+        result.persistTo = opts.persistTo;
+    }
+    return result;
+}
+export async function runBridgeServe(opts, deps = {}) {
+    printHeader('olam memory bridge serve --local');
+    const validated = validateBridgeOpts(opts);
+    printInfo('port', String(validated.port));
+    if (validated.persistTo) {
+        printInfo('persist-to', validated.persistTo);
+    }
+    else {
+        printInfo('persist-to', '(in-memory — DO state lost on restart)');
+    }
+    const serviceDir = (deps.resolveServiceDir ?? resolveMemoryServiceDir)();
+    const scriptPath = resolveLocalBridgeScript(serviceDir);
+    printInfo('entry', scriptPath);
+    const secret = (deps.ensureSecret ?? ensureMemorySecret)();
+    const args = ['--port', String(validated.port)];
+    if (validated.persistTo) {
+        args.push('--persist-to', validated.persistTo);
+    }
+    const env = {
+        ...process.env,
+        AGENTMEMORY_SECRET: secret,
+    };
+    const spawner = deps.spawnChild ??
+        ((command, spawnArgs, spawnEnv) => spawn(command, [...spawnArgs], {
+            env: spawnEnv,
+            stdio: 'inherit',
+        }));
+    const child = spawner(process.execPath, [scriptPath, ...args], env);
+    return new Promise((resolve) => {
+        let resolved = false;
+        const finish = (code) => {
+            if (resolved)
+                return;
+            resolved = true;
+            resolve(code);
+        };
+        const forward = (signal) => () => {
+            if (!child.killed) {
+                try {
+                    child.kill(signal);
+                }
+                catch {
+                    // Best-effort signal forwarding; child may already be exiting.
+                }
+            }
+        };
+        process.on('SIGTERM', forward('SIGTERM'));
+        process.on('SIGINT', forward('SIGINT'));
+        child.on('error', (err) => {
+            printError(`failed to spawn local-bridge-server.mjs: ${err.message}`);
+            finish(1);
+        });
+        child.on('exit', (code, signal) => {
+            if (signal) {
+                // Treat signal-driven exit as success (operator stopped service).
+                finish(0);
+            }
+            else {
+                finish(code ?? 1);
+            }
+        });
+    });
+}
+export function registerMemoryBridge(cmd) {
+    const bridge = cmd
+        .command('bridge')
+        .description('Local bridge service (Miniflare-embedded) for the agent-memory engine');
+    bridge
+        .command('serve')
+        .description('Run the agent-memory bridge as a foreground Node process (suitable for systemd/launchd)')
+        .option('--local', 'Use the embedded Miniflare runtime (currently required)')
+        .option('--port <n>', 'TCP port to bind on', (v) => parseInt(v, 10), DEFAULT_PORT)
+        .option('--persist-to <path>', 'DO SQLite persistence directory')
+        .action(async (opts) => {
+        try {
+            const rc = await runBridgeServe(opts);
+            if (rc !== 0)
+                process.exitCode = rc;
+        }
+        catch (err) {
+            printError(err instanceof Error ? err.message : String(err));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=bridge.js.map

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

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

package/dist/commands/memory/index.d.ts

@@ -9,6 +9,9 @@
  *   secret     — show / rotate the bearer secret at ~/.olam/memory-secret
  *   install    — register agentmemory with the operator's host claude
  *   uninstall  — symmetric (idempotent)
+ *   bridge     — Miniflare-embedded local bridge service (alt to wrangler dev)
+ *   reclassify — bust classifier cache by content_hash OR since_version
+ *   stats      — format /bridge/stats with derived cache-error-rate
  *
  * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md
  */

package/dist/commands/memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAerD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkBrD"}

package/dist/commands/memory/index.js

@@ -9,6 +9,9 @@
  *   secret     — show / rotate the bearer secret at ~/.olam/memory-secret
  *   install    — register agentmemory with the operator's host claude
  *   uninstall  — symmetric (idempotent)
+ *   bridge     — Miniflare-embedded local bridge service (alt to wrangler dev)
+ *   reclassify — bust classifier cache by content_hash OR since_version
+ *   stats      — format /bridge/stats with derived cache-error-rate
  *
  * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md
  */
@@ -20,10 +23,13 @@ import { registerMemorySecret } from './secret.js';
 import { registerMemoryInstall } from './install.js';
 import { registerMemoryUninstall } from './uninstall.js';
 import { registerMemoryMode } from './mode.js';
+import { registerMemoryBridge } from './bridge.js';
+import { registerMemoryReclassify } from './reclassify.js';
+import { registerMemoryStats } from './stats.js';
 export function registerMemory(program) {
     const memory = program
         .command('memory')
-        .description('Host-process agent-memory service for the olam fleet (start, stop, status, logs, secret, install, uninstall)');
+        .description('Host-process agent-memory service for the olam fleet (start, stop, status, logs, secret, install, uninstall, bridge, reclassify, stats)');
     registerMemoryStart(memory);
     registerMemoryStop(memory);
     registerMemoryStatus(memory);
@@ -32,5 +38,8 @@ export function registerMemory(program) {
     registerMemoryInstall(memory);
     registerMemoryUninstall(memory);
     registerMemoryMode(memory);
+    registerMemoryBridge(memory);
+    registerMemoryReclassify(memory);
+    registerMemoryStats(memory);
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CACV,8GAA8G,CAC/G,CAAC;IAEJ,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CACV,yIAAyI,CAC1I,CAAC;IAEJ,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/commands/memory/reclassify.d.ts

@@ -0,0 +1,56 @@
+/**
+ * olam memory reclassify — operator wrapper over the bridge
+ * `/classify/cache-bust` endpoint (Phase B5). Two modes:
+ *
+ *   $ olam memory reclassify --content-hash=sha256:abc...
+ *     # bust one cache entry by content hash
+ *
+ *   $ olam memory reclassify --since-version=haiku-v1+prompt-v1
+ *     # bulk bust by classifier_version (operator-side after a
+ *     # prompt-template change)
+ *
+ *   $ olam memory reclassify --content-hash=sha256:abc... --dry-run
+ *     # show what would be busted without calling the bridge
+ *
+ * Config (env vars):
+ *   AGENTMEMORY_BRIDGE_URL    bridge base URL
+ *                             (default: https://olam-agent-memory.ernestcodes.workers.dev)
+ *   AGENTMEMORY_BRIDGE_SECRET bearer token
+ *
+ * Plan reference:
+ *   docs/plans/agentmemory-classifier-and-regret/phase-b-tasks.md B5
+ *   (Originally bundled into B5; carved out as B5.1 because the
+ *   bridge endpoint shipped in PR #612 + the CLI is convenience.)
+ */
+import type { Command } from 'commander';
+export interface ReclassifyOptions {
+    contentHash?: string;
+    sinceVersion?: string;
+    dryRun?: boolean;
+    bridgeUrl?: string;
+    bearer?: string;
+    json?: boolean;
+}
+export interface ReclassifyResult {
+    ok: boolean;
+    busted: number;
+    mode: 'hash' | 'version' | 'dry-run';
+    memoryId?: string;
+    error?: string;
+}
+/**
+ * Validate that the operator supplied EXACTLY one of `--content-hash`
+ * or `--since-version`. Returns a clean error string for any malformed
+ * input. (Matches the bridge handler's validateCacheBustRequest contract
+ * — operator-side errors fail loudly before any HTTP call.)
+ */
+export declare function validateReclassifyOptions(opts: ReclassifyOptions): string | null;
+/**
+ * Run the reclassify call. Pure-ish: takes opts + fetch (so tests can
+ * stub) + returns a structured result.
+ */
+export declare function runReclassify(opts: ReclassifyOptions, fetchImpl?: typeof fetch): Promise<ReclassifyResult>;
+/** Run + render. Returns the process exit code. */
+export declare function runReclassifyCli(opts: ReclassifyOptions): Promise<number>;
+export declare function registerMemoryReclassify(cmd: Command): void;
+//# sourceMappingURL=reclassify.d.ts.map

package/dist/commands/memory/reclassify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reclassify.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/reclassify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAchF;AAgBD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,EACvB,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAmE3B;AAED,mDAAmD;AACnD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqC/E;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAgB3D"}

package/dist/commands/memory/reclassify.js

@@ -0,0 +1,177 @@
+/**
+ * olam memory reclassify — operator wrapper over the bridge
+ * `/classify/cache-bust` endpoint (Phase B5). Two modes:
+ *
+ *   $ olam memory reclassify --content-hash=sha256:abc...
+ *     # bust one cache entry by content hash
+ *
+ *   $ olam memory reclassify --since-version=haiku-v1+prompt-v1
+ *     # bulk bust by classifier_version (operator-side after a
+ *     # prompt-template change)
+ *
+ *   $ olam memory reclassify --content-hash=sha256:abc... --dry-run
+ *     # show what would be busted without calling the bridge
+ *
+ * Config (env vars):
+ *   AGENTMEMORY_BRIDGE_URL    bridge base URL
+ *                             (default: https://olam-agent-memory.ernestcodes.workers.dev)
+ *   AGENTMEMORY_BRIDGE_SECRET bearer token
+ *
+ * Plan reference:
+ *   docs/plans/agentmemory-classifier-and-regret/phase-b-tasks.md B5
+ *   (Originally bundled into B5; carved out as B5.1 because the
+ *   bridge endpoint shipped in PR #612 + the CLI is convenience.)
+ */
+import { printError, printInfo, printHeader, printWarning } from '../../output.js';
+const DEFAULT_BRIDGE_URL = 'https://olam-agent-memory.ernestcodes.workers.dev';
+const RECLASSIFY_TIMEOUT_MS = 10_000;
+/**
+ * Validate that the operator supplied EXACTLY one of `--content-hash`
+ * or `--since-version`. Returns a clean error string for any malformed
+ * input. (Matches the bridge handler's validateCacheBustRequest contract
+ * — operator-side errors fail loudly before any HTTP call.)
+ */
+export function validateReclassifyOptions(opts) {
+    const hasHash = typeof opts.contentHash === 'string' && opts.contentHash.length > 0;
+    const hasVersion = typeof opts.sinceVersion === 'string' && opts.sinceVersion.length > 0;
+    if (!hasHash && !hasVersion) {
+        return 'must specify one of --content-hash or --since-version';
+    }
+    if (hasHash && hasVersion) {
+        return '--content-hash and --since-version are mutually exclusive';
+    }
+    if (hasHash && !/^sha256:[0-9a-f]{64}$/.test(opts.contentHash)) {
+        return '--content-hash must be sha256:<64hex>';
+    }
+    return null;
+}
+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;
+}
+/**
+ * Run the reclassify call. Pure-ish: takes opts + fetch (so tests can
+ * stub) + returns a structured result.
+ */
+export async function runReclassify(opts, fetchImpl = fetch) {
+    const validationError = validateReclassifyOptions(opts);
+    if (validationError) {
+        return { ok: false, busted: 0, mode: opts.contentHash ? 'hash' : 'version', error: validationError };
+    }
+    if (opts.dryRun) {
+        return {
+            ok: true,
+            busted: 0,
+            mode: 'dry-run',
+        };
+    }
+    const bridgeUrl = resolveBridgeUrl(opts);
+    const bearer = resolveBearer(opts);
+    if (!bearer) {
+        return {
+            ok: false,
+            busted: 0,
+            mode: opts.contentHash ? 'hash' : 'version',
+            error: 'AGENTMEMORY_BRIDGE_SECRET not set (or --bearer not passed)',
+        };
+    }
+    const body = opts.contentHash
+        ? { content_hash: opts.contentHash }
+        : { since_version: opts.sinceVersion };
+    try {
+        const res = await fetchImpl(`${bridgeUrl}/classify/cache-bust`, {
+            method: 'POST',
+            headers: {
+                authorization: `Bearer ${bearer}`,
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(RECLASSIFY_TIMEOUT_MS),
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            return {
+                ok: false,
+                busted: 0,
+                mode: opts.contentHash ? 'hash' : 'version',
+                error: `bridge returned ${res.status} ${res.statusText}${detail ? `: ${detail.slice(0, 200)}` : ''}`,
+            };
+        }
+        const payload = (await res.json());
+        return {
+            ok: true,
+            busted: payload.busted,
+            mode: payload.mode,
+            memoryId: payload.memoryId,
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            busted: 0,
+            mode: opts.contentHash ? 'hash' : 'version',
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/** Run + render. Returns the process exit code. */
+export async function runReclassifyCli(opts) {
+    const result = await runReclassify(opts);
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        return result.ok ? 0 : 1;
+    }
+    printHeader('olam memory reclassify');
+    if (opts.contentHash) {
+        printInfo('content-hash', opts.contentHash);
+    }
+    if (opts.sinceVersion) {
+        printInfo('since-version', opts.sinceVersion);
+    }
+    printInfo('mode', result.mode);
+    if (opts.dryRun) {
+        printInfo('dry-run', 'no HTTP call made');
+        return 0;
+    }
+    if (!result.ok) {
+        printError(`reclassify failed: ${result.error ?? '(unknown error)'}`);
+        return 1;
+    }
+    if (result.busted === 0) {
+        printWarning(`no rows busted (hash not in cache OR no rows matched the version)`);
+    }
+    else {
+        printInfo('busted', `${result.busted}`);
+        if (result.memoryId) {
+            printInfo('memory-id', result.memoryId);
+        }
+    }
+    return 0;
+}
+export function registerMemoryReclassify(cmd) {
+    cmd
+        .command('reclassify')
+        .description('Bust the bridge classifier cache (single entry by content hash OR bulk by classifier_version) so the next batch re-runs the LLM')
+        .option('--content-hash <hash>', 'Bust one entry by sha256:<64hex> content hash')
+        .option('--since-version <version>', 'Bulk bust by classifier_version (e.g. "haiku-v1+prompt-v1")')
+        .option('--dry-run', 'Show what would be busted without calling the bridge', false)
+        .option('--bridge-url <url>', 'Override AGENTMEMORY_BRIDGE_URL')
+        .option('--bearer <token>', 'Override AGENTMEMORY_BRIDGE_SECRET')
+        .option('--json', 'Machine-readable JSON output', false)
+        .action(async (opts) => {
+        const rc = await runReclassifyCli(opts);
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=reclassify.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reclassify.js","sourceRoot":"","sources":["../../../src/commands/memory/reclassify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,MAAM,kBAAkB,GAAG,mDAAmD,CAAC;AAC/E,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAmBrC;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAuB;IAC/D,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IACpF,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAEzF,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5B,OAAO,uDAAuD,CAAC;IACjE,CAAC;IACD,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;QAC1B,OAAO,2DAA2D,CAAC;IACrE,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAY,CAAC,EAAE,CAAC;QAChE,OAAO,uCAAuC,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAuB;IAC/C,OAAO,IAAI,CAAC,SAAS;WAChB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;WACrC,kBAAkB,CAAC;AAC1B,CAAC;AAED,SAAS,aAAa,CAAC,IAAuB;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzD,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAuB,EACvB,YAA0B,KAAK;IAE/B,MAAM,eAAe,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IACvG,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,SAAS;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAC3C,KAAK,EAAE,4DAA4D;SACpE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW;QAC3B,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE;QACpC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;IAEzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,SAAS,sBAAsB,EAAE;YAC9D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,MAAM,EAAE;gBACjC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,qBAAqB,CAAC;SACnD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAChD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,CAAC;gBACT,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBAC3C,KAAK,EAAE,mBAAmB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;aACrG,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAIhC,CAAC;QACF,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAC3C,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAuB;IAC5D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAEzC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,WAAW,CAAC,wBAAwB,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,SAAS,CAAC,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,SAAS,CAAC,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IACD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,UAAU,CAAC,sBAAsB,MAAM,CAAC,KAAK,IAAI,iBAAiB,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,YAAY,CAAC,mEAAmE,CAAC,CAAC;IACpF,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACnD,GAAG;SACA,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CACV,iIAAiI,CAClI;SACA,MAAM,CAAC,uBAAuB,EAAE,+CAA+C,CAAC;SAChF,MAAM,CAAC,2BAA2B,EAAE,6DAA6D,CAAC;SAClG,MAAM,CAAC,WAAW,EAAE,sDAAsD,EAAE,KAAK,CAAC;SAClF,MAAM,CAAC,oBAAoB,EAAE,iCAAiC,CAAC;SAC/D,MAAM,CAAC,kBAAkB,EAAE,oCAAoC,CAAC;SAChE,MAAM,CAAC,QAAQ,EAAE,8BAA8B,EAAE,KAAK,CAAC;SACvD,MAAM,CAAC,KAAK,EAAE,IAAuB,EAAE,EAAE;QACxC,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/memory/stats.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 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 type { Command } from 'commander';
+export interface StatsOptions {
+    bridgeUrl?: string;
+    bearer?: string;
+    json?: boolean;
+}
+/**
+ * The seven counters this command formats. Mirrors the classifier_*
+ * subset of {@link BridgeStatsSnapshot} but renamed to drop the
+ * `classifier_` prefix — operators see "writes_observed" not
+ * "classifier_writes_observed" when scanning output.
+ */
+export interface StatsCounters {
+    writes_observed: number;
+    writes_deduped_hash: number;
+    writes_deduped_semantic: number;
+    recalls_observed: number;
+    cache_busted_hash: number;
+    cache_busted_version: number;
+}
+export interface StatsResult {
+    ok: boolean;
+    counters?: StatsCounters;
+    /** Decimal fraction, 0–1+. Multiply by 100 for display percentage. */
+    cacheErrorRate?: number;
+    /** Raw /bridge/stats envelope (preserved for --json mode). */
+    raw?: unknown;
+    error?: string;
+}
+/**
+ * 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 declare function computeCacheErrorRate(counters: Pick<StatsCounters, 'writes_observed' | 'cache_busted_hash' | 'cache_busted_version'>): number;
+/**
+ * Run the stats call. Pure-ish: takes opts + fetch (so tests can stub) +
+ * returns a structured result. Mirrors `runReclassify` for symmetry.
+ */
+export declare function runStats(opts: StatsOptions, fetchImpl?: typeof fetch): Promise<StatsResult>;
+/** Run + render. Returns the process exit code. */
+export declare function runStatsCli(opts: StatsOptions): Promise<number>;
+export declare function registerMemoryStats(cmd: Command): void;
+//# sourceMappingURL=stats.d.ts.map

package/dist/commands/memory/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,sBAAsB,CAAC,GAC9F,MAAM,CAIR;AAyCD;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,YAAY,EAClB,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,WAAW,CAAC,CA8CtB;AAOD,mDAAmD;AACnD,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCrE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAatD"}