@pleri/olam-cli 0.1.120 → 0.1.126

package/dist/commands/memory/install.js

@@ -0,0 +1,114 @@
+/**
+ * olam memory install — Register `agentmemory` as an MCP server with the
+ * operator's host claude.
+ *
+ * Shells to:
+ *   claude mcp add agentmemory --scope <s>
+ *     --env AGENTMEMORY_URL=http://localhost:3111
+ *     --env AGENTMEMORY_SECRET=<from-file>
+ *     -- npx -y @agentmemory/mcp
+ *
+ * The secret is read from ~/.olam/memory-secret (generated by A2 start or
+ * A3 secret rotate). Missing secret → exit 1 with remedy.
+ *
+ * Rotation note: claude stores the env value at install-time. After
+ * `olam memory secret rotate`, re-run `olam memory install` so claude
+ * picks up the new value (the rotate command surfaces this as a warning).
+ *
+ * Security note (CP3 audit, 2026-05-13): the bearer secret transits as
+ * an argv element of the spawned `claude` invocation. On Linux + macOS,
+ * argv is briefly readable via `/proc/<pid>/cmdline` (Linux) or `ps -E`
+ * (macOS) by any local user during the few ms claude runs. Blast radius:
+ * operator's own machine (single-user dev laptop = effectively nil;
+ * shared dev VM / interactive tmux = full secret disclosure to anyone
+ * on the box). Same shape as every other `--env KEY=VAL` CLI. Operator
+ * docs (A6) call this out + name the mitigation: don't run install on
+ * boxes with untrusted local users. If/when `claude mcp add` grows a
+ * `--env-stdin` form upstream, switch to it.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A4
+ */
+import { printError, printSuccess } from '../../output.js';
+import { DEFAULT_CLAUDE_SHELL_DEPS, REMEDY_CLAUDE_MISSING, isOnPath, normaliseScope, } from '../mcp/install-shared.js';
+import { MEMORY_REST_PORT } from './_paths.js';
+import { MEMORY_SECRET_PATH, readMemorySecretOrNull, } from '../../lib/memory-secret.js';
+const MCP_NAME = 'agentmemory';
+const NPM_PACKAGE_NAME = '@agentmemory/mcp';
+export const DEFAULT_SECRET_READER = () => readMemorySecretOrNull();
+export function buildClaudeMcpAddArgs(scope, agentmemoryUrl, secret) {
+    return {
+        command: 'claude',
+        args: [
+            'mcp',
+            'add',
+            MCP_NAME,
+            '--scope',
+            scope,
+            '--env',
+            `AGENTMEMORY_URL=${agentmemoryUrl}`,
+            '--env',
+            `AGENTMEMORY_SECRET=${secret}`,
+            '--',
+            'npx',
+            '-y',
+            NPM_PACKAGE_NAME,
+        ],
+    };
+}
+const REMEDY_SECRET_MISSING = `No memory-secret found at ${MEMORY_SECRET_PATH}. ` +
+    `Run 'olam memory start' first — it generates the secret on first launch.`;
+/**
+ * Defensive redaction for any stderr/stdout we echo back. If `claude`
+ * (or an upstream bug) ever prints the env values on parse failure, we
+ * don't want the secret hitting the operator's terminal scrollback.
+ */
+function redactSecretInText(text) {
+    return text.replace(/AGENTMEMORY_SECRET=\S+/g, 'AGENTMEMORY_SECRET=<redacted>');
+}
+export async function runInstall(opts, deps = DEFAULT_CLAUDE_SHELL_DEPS) {
+    if (!isOnPath(deps, 'claude')) {
+        printError(REMEDY_CLAUDE_MISSING);
+        return 1;
+    }
+    const readSecret = opts.readSecret ?? DEFAULT_SECRET_READER;
+    const secret = opts.secret ?? readSecret();
+    if (!secret) {
+        printError(REMEDY_SECRET_MISSING);
+        return 1;
+    }
+    const agentmemoryUrl = `http://localhost:${MEMORY_REST_PORT}`;
+    const { command, args } = buildClaudeMcpAddArgs(opts.scope, agentmemoryUrl, secret);
+    // Log without leaking the secret. Replace the AGENTMEMORY_SECRET arg with a redacted shape.
+    const redacted = args.map((a) => a.startsWith('AGENTMEMORY_SECRET=') ? 'AGENTMEMORY_SECRET=<redacted>' : a);
+    deps.log(`Wiring: ${command} ${redacted.join(' ')}`);
+    const result = deps.spawn(command, args, {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    if (result.status !== 0) {
+        const detail = redactSecretInText(result.stderr?.trim() || result.stdout?.trim() || '(no output)');
+        printError(`claude mcp add failed (rc=${result.status ?? 'unknown'}): ${detail}`);
+        return result.status ?? 1;
+    }
+    printSuccess(`agentmemory MCP registered with claude (--scope ${opts.scope}; url ${agentmemoryUrl}).`);
+    return 0;
+}
+export function registerMemoryInstall(cmd) {
+    cmd
+        .command('install')
+        .description('Register agentmemory as an MCP server with the operator\'s host claude (shells to `claude mcp add`)')
+        .option('--scope <scope>', 'claude mcp scope: user | project | local', 'user')
+        .action(async (rawOpts) => {
+        const scope = normaliseScope(rawOpts.scope);
+        if (scope === null) {
+            printError(`--scope must be one of: user, project, local (got: ${rawOpts.scope})`);
+            process.exitCode = 1;
+            return;
+        }
+        const rc = await runInstall({ scope });
+        if (rc !== 0) {
+            process.exitCode = rc;
+        }
+    });
+}
+//# sourceMappingURL=install.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * olam memory logs — tail ~/.olam/memory-service.log.
+ *
+ * --follow (alias -f): tail -f-style; Ctrl-C to stop.
+ * --tail N (default 50): last N lines.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import type { Command } from 'commander';
+export declare function runMemoryLogs(opts: {
+    follow?: boolean;
+    tail?: string;
+}): Promise<number>;
+export declare function registerMemoryLogs(cmd: Command): void;
+//# sourceMappingURL=logs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB9F;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAUrD"}

package/dist/commands/memory/logs.js

@@ -0,0 +1,45 @@
+/**
+ * olam memory logs — tail ~/.olam/memory-service.log.
+ *
+ * --follow (alias -f): tail -f-style; Ctrl-C to stop.
+ * --tail N (default 50): last N lines.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import { existsSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { printWarning, printHeader } from '../../output.js';
+import { MEMORY_LOG_PATH } from './_paths.js';
+export async function runMemoryLogs(opts) {
+    if (!existsSync(MEMORY_LOG_PATH)) {
+        printWarning(`no log at ${MEMORY_LOG_PATH} (start the service first via 'olam memory start')`);
+        return 1;
+    }
+    const tailN = opts.tail ? parseInt(opts.tail, 10) : 50;
+    if (!Number.isFinite(tailN) || tailN < 0) {
+        printWarning(`invalid --tail value: ${opts.tail}`);
+        return 1;
+    }
+    const args = ['-n', `${tailN}`];
+    if (opts.follow)
+        args.push('-f');
+    args.push(MEMORY_LOG_PATH);
+    printHeader(`olam memory logs (${opts.follow ? 'follow' : `tail -n ${tailN}`})`);
+    const child = spawn('tail', args, { stdio: 'inherit' });
+    return new Promise((resolve) => {
+        child.on('exit', (code) => resolve(code ?? 0));
+    });
+}
+export function registerMemoryLogs(cmd) {
+    cmd
+        .command('logs')
+        .description('Tail the memory service log file at ~/.olam/memory-service.log')
+        .option('-f, --follow', 'Stream new log lines (Ctrl-C to stop)', false)
+        .option('--tail <n>', 'Number of trailing lines (default 50)', '50')
+        .action(async (opts) => {
+        const rc = await runMemoryLogs(opts);
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=logs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/commands/memory/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAyC;IAC3E,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,YAAY,CAAC,aAAa,eAAe,oDAAoD,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,YAAY,CAAC,yBAAyB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAE3B,WAAW,CAAC,qBAAqB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,KAAK,EAAE,GAAG,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACxD,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gEAAgE,CAAC;SAC7E,MAAM,CAAC,cAAc,EAAE,uCAAuC,EAAE,KAAK,CAAC;SACtE,MAAM,CAAC,YAAY,EAAE,uCAAuC,EAAE,IAAI,CAAC;SACnE,MAAM,CAAC,KAAK,EAAE,IAAyC,EAAE,EAAE;QAC1D,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * olam memory secret — show or rotate the bearer secret at ~/.olam/memory-secret.
+ *
+ * Subcommands:
+ *   show     — print the current secret value (use with care; do not pipe to logs)
+ *   rotate   — generate a fresh secret + restart the running memory service so
+ *              it picks up the new value. Worlds created BEFORE the rotation
+ *              continue to use the old value until they're re-created.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A3
+ */
+import type { Command } from 'commander';
+export declare function runMemorySecretShow(): Promise<number>;
+export declare function runMemorySecretRotate(): Promise<number>;
+export declare function registerMemorySecret(cmd: Command): void;
+//# sourceMappingURL=secret.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"secret.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/secret.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAU3D;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAoC7D;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAsBvD"}

package/dist/commands/memory/secret.js

@@ -0,0 +1,79 @@
+/**
+ * olam memory secret — show or rotate the bearer secret at ~/.olam/memory-secret.
+ *
+ * Subcommands:
+ *   show     — print the current secret value (use with care; do not pipe to logs)
+ *   rotate   — generate a fresh secret + restart the running memory service so
+ *              it picks up the new value. Worlds created BEFORE the rotation
+ *              continue to use the old value until they're re-created.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A3
+ */
+import { existsSync } from 'node:fs';
+import { MEMORY_SECRET_PATH, hasMemorySecret, readMemorySecret, rotateMemorySecret, } from '../../lib/memory-secret.js';
+import { printError, printSuccess, printInfo, printWarning, printHeader } from '../../output.js';
+import { runMemoryStart } from './start.js';
+import { runMemoryStop } from './stop.js';
+import { MEMORY_PID_PATH } from './_paths.js';
+export async function runMemorySecretShow() {
+    if (!hasMemorySecret()) {
+        printError(`secret missing at ${MEMORY_SECRET_PATH}. Run 'olam memory start' to generate it.`);
+        return 1;
+    }
+    // Plain stdout so it's pipeable; helper helpers go to stderr in the lib.
+    process.stdout.write(`${readMemorySecret()}\n`);
+    return 0;
+}
+export async function runMemorySecretRotate() {
+    printHeader('olam memory secret rotate');
+    const wasRunning = existsSync(MEMORY_PID_PATH);
+    if (wasRunning) {
+        printInfo('current state', 'service running; will restart with new secret');
+        const stopRc = await runMemoryStop();
+        if (stopRc !== 0) {
+            printError('failed to stop the running service; rotation aborted to avoid split-brain');
+            return stopRc;
+        }
+    }
+    else {
+        printInfo('current state', 'service stopped');
+    }
+    const fresh = rotateMemorySecret();
+    printSuccess(`secret rotated (${fresh.length / 2}-byte hex written to ${MEMORY_SECRET_PATH})`);
+    if (wasRunning) {
+        printInfo('restarting', 'memory service with new secret');
+        const startRc = await runMemoryStart();
+        if (startRc !== 0) {
+            printError('service failed to restart after rotation. The new secret is on disk; run `olam memory start` once you fix the underlying issue.');
+            return startRc;
+        }
+    }
+    else {
+        printWarning('service was not running; new secret will be picked up on next `olam memory start`');
+    }
+    // Heads-up: worlds created before this rotation still have the old value in env.
+    printWarning('worlds created BEFORE this rotation still have the old secret in their env. Re-create them (olam destroy + olam create) to pick up the new value.');
+    return 0;
+}
+export function registerMemorySecret(cmd) {
+    const secret = cmd
+        .command('secret')
+        .description('Show or rotate the bearer secret at ~/.olam/memory-secret');
+    secret
+        .command('show')
+        .description('Print the current secret value (use with care; do not pipe to logs)')
+        .action(async () => {
+        const rc = await runMemorySecretShow();
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+    secret
+        .command('rotate')
+        .description('Regenerate the secret and restart the running memory service (worlds created before rotation must be re-created)')
+        .action(async () => {
+        const rc = await runMemorySecretRotate();
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=secret.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * olam memory start — spawn agentmemory as a managed host child process.
+ *
+ * Flow:
+ *   1. Ensure iii v0.11.2 binary at ~/.olam/bin/iii (calls A1's ensure-iii-engine.mjs equivalent)
+ *   2. Ensure ~/.olam/memory-secret (0600) exists
+ *   3. Locate packages/memory-service/ (the npm-installed agentmemory)
+ *   4. Spawn `agentmemory` (the bin from @agentmemory/agentmemory@0.9.6) with:
+ *        env: { AGENTMEMORY_SECRET, PATH: ~/.olam/bin:$PATH, ...inherit }
+ *        cwd: ~/.olam (so agentmemory writes state under ~/.olam/data/)
+ *        stdio: append to ~/.olam/memory-service.log
+ *        detached: true so the child outlives this CLI invocation
+ *   5. Write child pid to ~/.olam/memory.pid
+ *   6. Poll http://localhost:3111/agentmemory/livez until 200 (timeout 30s)
+ *
+ * Idempotent: re-running while the service is healthy prints status and exits 0.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import type { Command } from 'commander';
+export declare function runMemoryStart(): Promise<number>;
+export declare function registerMemoryStart(cmd: Command): void;
+//# sourceMappingURL=start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwFzC,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CA6EtD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQtD"}

package/dist/commands/memory/start.js

@@ -0,0 +1,166 @@
+/**
+ * olam memory start — spawn agentmemory as a managed host child process.
+ *
+ * Flow:
+ *   1. Ensure iii v0.11.2 binary at ~/.olam/bin/iii (calls A1's ensure-iii-engine.mjs equivalent)
+ *   2. Ensure ~/.olam/memory-secret (0600) exists
+ *   3. Locate packages/memory-service/ (the npm-installed agentmemory)
+ *   4. Spawn `agentmemory` (the bin from @agentmemory/agentmemory@0.9.6) with:
+ *        env: { AGENTMEMORY_SECRET, PATH: ~/.olam/bin:$PATH, ...inherit }
+ *        cwd: ~/.olam (so agentmemory writes state under ~/.olam/data/)
+ *        stdio: append to ~/.olam/memory-service.log
+ *        detached: true so the child outlives this CLI invocation
+ *   5. Write child pid to ~/.olam/memory.pid
+ *   6. Poll http://localhost:3111/agentmemory/livez until 200 (timeout 30s)
+ *
+ * Idempotent: re-running while the service is healthy prints status and exits 0.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, openSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { printError, printSuccess, printInfo, printHeader } from '../../output.js';
+import { ensureMemorySecret } from '../../lib/memory-secret.js';
+import { III_BINARY_PATH, MEMORY_DATA_DIR, MEMORY_LIVEZ_URL, MEMORY_LOG_PATH, MEMORY_PID_PATH, MEMORY_SERVICE_CANDIDATES, OLAM_BIN_DIR, OLAM_HOME, } from './_paths.js';
+const READINESS_TIMEOUT_MS = 30_000;
+const READINESS_POLL_MS = 500;
+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.`);
+}
+function resolveAgentMemoryBin(serviceDir) {
+    // npm hoists @agentmemory/agentmemory to the workspace root in monorepo mode.
+    // Search likely locations in order.
+    const candidates = [
+        join(serviceDir, 'node_modules', '.bin', 'agentmemory'),
+        join(serviceDir, '..', '..', 'node_modules', '.bin', 'agentmemory'),
+        join(serviceDir, '..', '..', '..', 'node_modules', '.bin', 'agentmemory'),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    throw new Error(`Could not find agentmemory bin. Searched: ${candidates.join(', ')}. ` +
+        `Run 'npm install' from the repo root.`);
+}
+function isProcessAlive(pid) {
+    try {
+        // signal 0 doesn't deliver; just tests existence + permission
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readPidFromFile() {
+    if (!existsSync(MEMORY_PID_PATH))
+        return null;
+    const raw = readFileSync(MEMORY_PID_PATH, 'utf8').trim();
+    const pid = parseInt(raw, 10);
+    if (!Number.isFinite(pid) || pid <= 0)
+        return null;
+    return pid;
+}
+async function probeLivez(secret, signal) {
+    try {
+        const resp = await fetch(MEMORY_LIVEZ_URL, {
+            headers: { authorization: `Bearer ${secret}` },
+            signal,
+        });
+        if (!resp.ok)
+            return false;
+        const body = (await resp.json());
+        return body.status === 'ok';
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForReady(secret) {
+    const deadline = Date.now() + READINESS_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        if (await probeLivez(secret))
+            return true;
+        await new Promise((r) => setTimeout(r, READINESS_POLL_MS));
+    }
+    return false;
+}
+export async function runMemoryStart() {
+    printHeader('olam memory start');
+    // 1. iii binary (A1's deliverable)
+    if (!existsSync(III_BINARY_PATH)) {
+        printError(`iii binary missing at ${III_BINARY_PATH}. Run: node packages/memory-service/scripts/ensure-iii-engine.mjs`);
+        return 1;
+    }
+    printInfo('iii binary', III_BINARY_PATH);
+    // 2. Secret (A3 lib)
+    const secret = ensureMemorySecret();
+    printInfo('secret', '~/.olam/memory-secret (0600)');
+    // 3. Locate the service + agentmemory bin
+    const serviceDir = resolveMemoryServiceDir();
+    const agentmemoryBin = resolveAgentMemoryBin(serviceDir);
+    printInfo('agentmemory', agentmemoryBin);
+    // 4. Idempotency: already running?
+    const existingPid = readPidFromFile();
+    if (existingPid !== null && isProcessAlive(existingPid)) {
+        const ready = await probeLivez(secret);
+        if (ready) {
+            printSuccess(`already running (pid ${existingPid}); /agentmemory/livez ok`);
+            return 0;
+        }
+        // Pidfile points at a live process that isn't responding — leave it alone, error out.
+        printError(`pid ${existingPid} is alive but /agentmemory/livez isn't responding. ` +
+            `Run 'olam memory stop' to clear, then retry.`);
+        return 1;
+    }
+    // 5. Ensure dirs exist
+    mkdirSync(OLAM_HOME, { recursive: true });
+    mkdirSync(MEMORY_DATA_DIR, { recursive: true });
+    // 6. Spawn detached, redirect output to log file (append).
+    const logFd = openSync(MEMORY_LOG_PATH, 'a');
+    const child = spawn(agentmemoryBin, [], {
+        cwd: OLAM_HOME,
+        env: {
+            ...process.env,
+            AGENTMEMORY_SECRET: secret,
+            PATH: `${OLAM_BIN_DIR}:${process.env.PATH ?? ''}`,
+        },
+        stdio: ['ignore', logFd, logFd],
+        detached: true,
+    });
+    child.unref();
+    if (child.pid === undefined) {
+        printError('spawn returned no pid (process failed to start)');
+        return 1;
+    }
+    // 7. Persist pid
+    writeFileSync(MEMORY_PID_PATH, `${child.pid}\n`, { mode: 0o644 });
+    printInfo('pid', `${child.pid}`);
+    // 8. Wait for readiness
+    printInfo('readiness', `polling ${MEMORY_LIVEZ_URL}`);
+    const ready = await waitForReady(secret);
+    if (!ready) {
+        printError(`agentmemory failed to come up within ${READINESS_TIMEOUT_MS / 1000}s. ` +
+            `Inspect ${MEMORY_LOG_PATH} for engine errors.`);
+        return 1;
+    }
+    printSuccess(`memory service ready (pid ${child.pid}; logs at ${MEMORY_LOG_PATH})`);
+    return 0;
+}
+export function registerMemoryStart(cmd) {
+    cmd
+        .command('start')
+        .description('Start the host agent-memory process (idempotent; polls livez until ready)')
+        .action(async () => {
+        const rc = await runMemoryStart();
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=start.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * olam memory status — diagnostic dump for the host memory service.
+ *
+ * Reports: pidfile state, process liveness, /agentmemory/livez response,
+ * secret-set Y/N, iii binary location, REST port. Intended for both
+ * humans (default output) and machines (--json).
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import type { Command } from 'commander';
+interface MemoryStatus {
+    pid: number | null;
+    alive: boolean | null;
+    livez: 'ok' | 'unreachable' | 'unauthorized' | 'unknown';
+    secretSet: boolean;
+    iiiBinary: string | null;
+    port: number;
+}
+export declare function collectMemoryStatus(): Promise<MemoryStatus>;
+export declare function runMemoryStatus(opts?: {
+    json?: boolean;
+}): Promise<number>;
+export declare function registerMemoryStatus(cmd: Command): void;
+export {};
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,IAAI,GAAG,aAAa,GAAG,cAAc,GAAG,SAAS,CAAC;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAyBD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,YAAY,CAAC,CAkBjE;AAED,wBAAsB,eAAe,CAAC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCpF;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CASvD"}

package/dist/commands/memory/status.js

@@ -0,0 +1,101 @@
+/**
+ * olam memory status — diagnostic dump for the host memory service.
+ *
+ * Reports: pidfile state, process liveness, /agentmemory/livez response,
+ * secret-set Y/N, iii binary location, REST port. Intended for both
+ * humans (default output) and machines (--json).
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { printError, printInfo, printHeader, printWarning } from '../../output.js';
+import { hasMemorySecret, readMemorySecretOrNull } from '../../lib/memory-secret.js';
+import { III_BINARY_PATH, MEMORY_LIVEZ_URL, MEMORY_PID_PATH, MEMORY_REST_PORT, } from './_paths.js';
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function probe(secret) {
+    try {
+        const headers = {};
+        if (secret)
+            headers.authorization = `Bearer ${secret}`;
+        const resp = await fetch(MEMORY_LIVEZ_URL, { headers });
+        if (resp.status === 401)
+            return 'unauthorized';
+        if (!resp.ok)
+            return 'unknown';
+        const body = (await resp.json());
+        return body.status === 'ok' ? 'ok' : 'unknown';
+    }
+    catch {
+        return 'unreachable';
+    }
+}
+export async function collectMemoryStatus() {
+    let pid = null;
+    if (existsSync(MEMORY_PID_PATH)) {
+        const raw = readFileSync(MEMORY_PID_PATH, 'utf8').trim();
+        const parsed = parseInt(raw, 10);
+        pid = Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+    }
+    const alive = pid === null ? null : isAlive(pid);
+    const secret = readMemorySecretOrNull();
+    const livez = await probe(secret);
+    return {
+        pid,
+        alive,
+        livez,
+        secretSet: hasMemorySecret(),
+        iiiBinary: existsSync(III_BINARY_PATH) ? III_BINARY_PATH : null,
+        port: MEMORY_REST_PORT,
+    };
+}
+export async function runMemoryStatus(opts = {}) {
+    const s = await collectMemoryStatus();
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(s, null, 2) + '\n');
+        return s.livez === 'ok' ? 0 : 1;
+    }
+    printHeader('olam memory status');
+    printInfo('pid', s.pid === null ? '(no pidfile)' : `${s.pid}`);
+    printInfo('alive', s.alive === null ? 'n/a' : s.alive ? 'yes' : 'no (stale pidfile)');
+    printInfo('livez', s.livez);
+    printInfo('secret', s.secretSet ? '~/.olam/memory-secret (set)' : '(missing)');
+    printInfo('iii', s.iiiBinary ?? '(not installed)');
+    printInfo('port', `${s.port}`);
+    if (s.livez === 'ok' && s.alive)
+        return 0;
+    if (s.livez === 'unauthorized') {
+        printWarning('livez returned 401 — the memory service is up but the local secret does not match. Try `olam memory secret rotate`.');
+        return 1;
+    }
+    if (s.alive === false && s.pid !== null) {
+        printWarning('pidfile points at a dead process; run `olam memory stop` to clean up');
+        return 1;
+    }
+    if (!s.iiiBinary) {
+        printWarning('iii binary missing; run `node packages/memory-service/scripts/ensure-iii-engine.mjs`');
+    }
+    if (!s.secretSet) {
+        printWarning('secret missing; `olam memory start` will generate it');
+    }
+    return s.livez === 'ok' ? 0 : 1;
+}
+export function registerMemoryStatus(cmd) {
+    cmd
+        .command('status')
+        .description('Diagnostic dump for the host memory service (pid + livez + secret-set check)')
+        .option('--json', 'Machine-readable JSON output', false)
+        .action(async (opts) => {
+        const rc = await runMemoryStatus(opts);
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=status.js.map

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

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