@pleri/olam-cli 0.1.153 → 0.1.158

package/dist/commands/memory/start.js

@@ -1,217 +1,83 @@
 /**
- * olam memory start — spawn agentmemory as a managed host child process.
+ * olam memory start — bring up the agent-memory service.
  *
- * 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)
+ * Phase B substrate: delegates to `MemoryServiceContainerController` so the
+ * service runs as a Docker container managed by the same lifecycle as
+ * kg-service / auth-service / mcp-auth-service. The legacy Phase A host-process
+ * model (spawning the `agentmemory` npm bin + writing `~/.olam/memory.pid`)
+ * is retired; legacy on-disk state is migrated away on first new-substrate
+ * invocation via `migrateFromHostProcess()`.
  *
- * Idempotent: re-running while the service is healthy prints status and exits 0.
+ * Operator-facing surface unchanged:
+ *   - `olam memory start` still produces a running service on :3111.
+ *   - `bootstrap.ts:429` `runOlam(['memory', 'start'])` call site untouched.
+ *   - `--skip-memory` / `OLAM_BOOTSTRAP_SKIP_MEMORY=1` still skip.
  *
- * 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 { pathToFileURL } from 'node:url';
-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;
-}
-/**
- * Auto-fetch the iii binary via A1's `ensure-iii-engine.mjs` helper.
+ * Phase C deletes the host-process helpers from `_paths.ts` + drops the
+ * `@agentmemory/agentmemory` PUBLISH_DEPS entry. Until then, the host-process
+ * code paths are unreachable but present (clean-revert insurance).
  *
- * Called from `runMemoryStart` when `~/.olam/bin/iii` is missing. Closes
- * the bootstrap-time UX gap surfaced by `olam bootstrap` in CI: A5
- * wires `olam memory start` into the bootstrap flow, but A2's start
- * command previously failed with a "Run: node ... ensure-iii-engine.mjs"
- * remedy that operators on fresh hosts couldn't auto-resolve. Now
- * `olam memory start` (and therefore `olam bootstrap`) auto-fetches the
- * SHA256-pinned binary on first use.
- *
- * Dynamic-imported because the helper is in `packages/memory-service/`,
- * a sibling workspace — resolving statically would invert the package
- * graph. Path resolution reuses `resolveMemoryServiceDir` so the bundle-
- * vs-source layout fallbacks stay consistent.
+ * Plan reference: docs/plans/memory-service-as-docker-peripheral/phase-b-tasks.md B1
  */
-async function autoEnsureIiiBinary(serviceDir) {
-    const helperPath = join(serviceDir, 'scripts', 'ensure-iii-engine.mjs');
-    const mod = (await import(pathToFileURL(helperPath).href));
-    const result = await mod.ensureIiiEngine();
-    if (!result.ok) {
-        throw new Error(`ensureIiiEngine returned ok=false (path=${result.path})`);
-    }
-}
+import { printError, printSuccess, printInfo, printHeader, printWarning } from '../../output.js';
+import { MEMORY_SERVICE_PORT, MemoryServiceContainerController, } from '../memory-service-container.js';
+import { migrateFromHostProcess } from '../../lib/memory-host-process-migration.js';
 export async function runMemoryStart() {
     printHeader('olam memory start');
-    // 3. Locate the service first (needed for both auto-fetch and bin
-    //    resolution below). Throws with a clear remedy if the packaging
-    //    is broken (e.g. running outside a checkout).
-    let serviceDir;
-    try {
-        serviceDir = resolveMemoryServiceDir();
-    }
-    catch (err) {
-        printError(err instanceof Error ? err.message : String(err));
-        return 1;
-    }
-    // 1. iii binary (A1's deliverable). Auto-fetch when missing so
-    //    `olam bootstrap` succeeds on fresh hosts (CI runners, new
-    //    operator machines) without a manual ensure-iii-engine step.
-    if (!existsSync(III_BINARY_PATH)) {
-        printInfo('iii binary', `missing at ${III_BINARY_PATH} — auto-fetching v0.11.2`);
-        try {
-            await autoEnsureIiiBinary(serviceDir);
-        }
-        catch (err) {
-            printError(`iii binary auto-fetch failed: ${err instanceof Error ? err.message : String(err)}. ` +
-                `Run manually: node packages/memory-service/scripts/ensure-iii-engine.mjs`);
-            return 1;
-        }
+    // 1. Migrate away from any Phase A host-process state on disk. Idempotent
+    //    no-op on hosts that never ran the legacy substrate. PID-reuse defence
+    //    is in the helper — we never SIGTERM a process whose comm name isn't
+    //    `node`.
+    const migration = migrateFromHostProcess();
+    if (migration.cleaned) {
+        printInfo('migration', migration.summary);
     }
-    printInfo('iii binary', III_BINARY_PATH);
-    // 2. Secret (A3 lib)
-    const secret = ensureMemorySecret();
-    printInfo('secret', '~/.olam/memory-secret (0600)');
-    // 3b. Locate the agentmemory bin (serviceDir was resolved above for
-    //     the auto-fetch path).
-    const agentmemoryBin = resolveAgentMemoryBin(serviceDir);
-    printInfo('agentmemory', agentmemoryBin);
-    // 4. Idempotency: already running?
-    const existingPid = readPidFromFile();
-    if (existingPid !== null && isProcessAlive(existingPid)) {
-        const ready = await probeLivez(secret);
+    // 2. Substrate handoff to MemoryServiceContainerController (Phase A A1).
+    const controller = new MemoryServiceContainerController();
+    const current = controller.status();
+    if (current.state === 'running') {
+        const ready = await controller.waitForReady(5_000);
         if (ready) {
-            printSuccess(`already running (pid ${existingPid}); /agentmemory/livez ok`);
+            printSuccess(`olam-memory-service already running on :${current.port}; /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.`);
+        printWarning(`olam-memory-service container is running but /agentmemory/livez did not respond. ` +
+            `Run 'olam memory stop' then retry, or 'olam memory logs' to diagnose.`);
         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,
-            // Bind 0.0.0.0 so worlds inside Docker can reach the host service
-            // via `host.docker.internal:3111`. Defaults to 127.0.0.1 in the
-            // upstream iii-config, which would make the service host-only.
-            // The bearer-secret gate above prevents non-authed access from
-            // any other LAN host that can route to this machine.
-            AGENTMEMORY_HOST: '0.0.0.0',
-            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)');
+    if (controller.imageMissingEverywhere()) {
+        printError('olam-memory-service image not found locally. ' +
+            'Run `olam bootstrap` to pull the published image, or ' +
+            '`node packages/cli/scripts/build-memory-service-image.mjs` to build from source.');
+        return 1;
+    }
+    try {
+        controller.start();
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        const stderr = err instanceof Error && 'stderr' in err
+            ? String(err.stderr ?? '').trim()
+            : '';
+        printError(`olam-memory-service failed to start: ${errMsg}${stderr ? `\n  stderr: ${stderr}` : ''}`);
         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);
+    const ready = await controller.waitForReady();
     if (!ready) {
-        printError(`agentmemory failed to come up within ${READINESS_TIMEOUT_MS / 1000}s. ` +
-            `Inspect ${MEMORY_LOG_PATH} for engine errors.`);
+        printError(`olam-memory-service started but /agentmemory/livez did not respond within 60s. ` +
+            `Inspect logs with 'olam memory logs'.`);
         return 1;
     }
-    printSuccess(`memory service ready (pid ${child.pid}; logs at ${MEMORY_LOG_PATH})`);
+    printSuccess(`olam-memory-service started on :${MEMORY_SERVICE_PORT}; /agentmemory/livez ok`);
     return 0;
 }
 export function registerMemoryStart(cmd) {
     cmd
         .command('start')
-        .description('Start the host agent-memory process (idempotent; polls livez until ready)')
+        .description('Start the agent-memory Docker container (Phase B substrate).')
         .action(async () => {
-        const rc = await runMemoryStart();
-        if (rc !== 0)
-            process.exitCode = rc;
+        const exitCode = await runMemoryStart();
+        process.exit(exitCode);
     });
 }
 //# sourceMappingURL=start.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/commands/memory/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,MAAM,oBAAoB,GAAG,MAAM,CAAC;AACpC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,SAAS,uBAAuB;IAC9B,KAAK,MAAM,CAAC,IAAI,yBAAyB,EAAE,CAAC;QAC1C,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,IAAI,KAAK,CACb,sDAAsD,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAC5F,sGAAsG,CACzG,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,UAAkB;IAC/C,8EAA8E;IAC9E,oCAAoC;IACpC,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,CAAC;QACvD,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,CAAC;QACnE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,CAAC;KAC1E,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,IAAI,KAAK,CACb,6CAA6C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACpE,uCAAuC,CAC1C,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,8DAA8D;QAC9D,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,MAAoB;IAC5D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,gBAAgB,EAAE;YACzC,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;YAC9C,MAAM;SACP,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAC3B,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAwB,CAAC;QACxD,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,MAAc;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,oBAAoB,CAAC;IACnD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAExD,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAEjC,kEAAkE;IAClE,oEAAoE;IACpE,kDAAkD;IAClD,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,uBAAuB,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,UAAU,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,+DAA+D;IAC/D,+DAA+D;IAC/D,iEAAiE;IACjE,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,SAAS,CAAC,YAAY,EAAE,cAAc,eAAe,0BAA0B,CAAC,CAAC;QACjF,IAAI,CAAC;YACH,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,CACR,iCAAiC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI;gBACnF,0EAA0E,CAC7E,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,SAAS,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAEzC,qBAAqB;IACrB,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACpC,SAAS,CAAC,QAAQ,EAAE,8BAA8B,CAAC,CAAC;IAEpD,oEAAoE;IACpE,4BAA4B;IAC5B,MAAM,cAAc,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACzD,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAEzC,mCAAmC;IACnC,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,IAAI,WAAW,KAAK,IAAI,IAAI,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,wBAAwB,WAAW,0BAA0B,CAAC,CAAC;YAC5E,OAAO,CAAC,CAAC;QACX,CAAC;QACD,sFAAsF;QACtF,UAAU,CACR,OAAO,WAAW,qDAAqD;YACrE,8CAA8C,CACjD,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,uBAAuB;IACvB,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,2DAA2D;IAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,EAAE;QACtC,GAAG,EAAE,SAAS;QACd,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,kBAAkB,EAAE,MAAM;YAC1B,kEAAkE;YAClE,gEAAgE;YAChE,+DAA+D;YAC/D,+DAA+D;YAC/D,qDAAqD;YACrD,gBAAgB,EAAE,SAAS;YAC3B,IAAI,EAAE,GAAG,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE;SAClD;QACD,KAAK,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC;QAC/B,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC5B,UAAU,CAAC,iDAAiD,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,iBAAiB;IACjB,aAAa,CAAC,eAAe,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAEjC,wBAAwB;IACxB,SAAS,CAAC,WAAW,EAAE,WAAW,gBAAgB,EAAE,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,UAAU,CACR,wCAAwC,oBAAoB,GAAG,IAAI,KAAK;YACtE,WAAW,eAAe,qBAAqB,CAClD,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,YAAY,CAAC,6BAA6B,KAAK,CAAC,GAAG,aAAa,eAAe,GAAG,CAAC,CAAC;IACpF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,GAAG;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,2EAA2E,CAAC;SACxF,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;QAClC,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/commands/memory/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EACL,mBAAmB,EACnB,gCAAgC,GACjC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEpF,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAEjC,0EAA0E;IAC1E,2EAA2E;IAC3E,yEAAyE;IACzE,aAAa;IACb,MAAM,SAAS,GAAG,sBAAsB,EAAE,CAAC;IAC3C,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACtB,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,yEAAyE;IACzE,MAAM,UAAU,GAAG,IAAI,gCAAgC,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;IAEpC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,2CAA2C,OAAO,CAAC,IAAI,yBAAyB,CAAC,CAAC;YAC/F,OAAO,CAAC,CAAC;QACX,CAAC;QACD,YAAY,CACV,mFAAmF;YACjF,uEAAuE,CAC1E,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,UAAU,CAAC,sBAAsB,EAAE,EAAE,CAAC;QACxC,UAAU,CACR,+CAA+C;YAC7C,uDAAuD;YACvD,kFAAkF,CACrF,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,IAAI,QAAQ,IAAI,GAAG;YACpD,CAAC,CAAC,MAAM,CAAE,GAAmC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAClE,CAAC,CAAC,EAAE,CAAC;QACP,UAAU,CAAC,wCAAwC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrG,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,YAAY,EAAE,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,UAAU,CACR,iFAAiF;YAC/E,uCAAuC,CAC1C,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,YAAY,CAAC,mCAAmC,mBAAmB,yBAAyB,CAAC,CAAC;IAC9F,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,GAAG;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,8DAA8D,CAAC;SAC3E,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -1,20 +1,22 @@
 /**
- * olam memory status — diagnostic dump for the host memory service.
+ * olam memory status — diagnostic dump for the agent-memory Docker container.
  *
- * 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).
+ * Phase B substrate: queries `MemoryServiceContainerController.status()` +
+ * bearer-authenticated livez probe. Output schema preserves the Phase A
+ * shape — `state | livez | secret | port` — but the `state` field now
+ * reports container lifecycle (`running | stopped | missing`) instead of
+ * pid/alive.
  *
- * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ * Plan reference: docs/plans/memory-service-as-docker-peripheral/phase-b-tasks.md B3
  */
 import type { Command } from 'commander';
 interface MemoryStatus {
-    pid: number | null;
-    alive: boolean | null;
+    state: 'running' | 'stopped' | 'missing';
+    containerId: string | null;
     livez: 'ok' | 'unreachable' | 'unauthorized' | 'unknown';
     secretSet: boolean;
-    iiiBinary: string | null;
     port: number;
+    legacyPidfilePresent: boolean;
 }
 export declare function collectMemoryStatus(): Promise<MemoryStatus>;
 export declare function runMemoryStatus(opts?: {

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

@@ -1 +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"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,UAAU,YAAY;IACpB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,IAAI,GAAG,aAAa,GAAG,cAAc,GAAG,SAAS,CAAC;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAgBD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,YAAY,CAAC,CAajE;AAED,wBAAsB,eAAe,CAAC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA+CpF;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CASvD"}

package/dist/commands/memory/status.js

@@ -1,25 +1,19 @@
 /**
- * olam memory status — diagnostic dump for the host memory service.
+ * olam memory status — diagnostic dump for the agent-memory Docker container.
  *
- * 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).
+ * Phase B substrate: queries `MemoryServiceContainerController.status()` +
+ * bearer-authenticated livez probe. Output schema preserves the Phase A
+ * shape — `state | livez | secret | port` — but the `state` field now
+ * reports container lifecycle (`running | stopped | missing`) instead of
+ * pid/alive.
  *
- * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ * Plan reference: docs/plans/memory-service-as-docker-peripheral/phase-b-tasks.md B3
  */
-import { existsSync, readFileSync } from 'node:fs';
-import { printError, printInfo, printHeader, printWarning } from '../../output.js';
+import { existsSync } from 'node:fs';
+import { 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;
-    }
-}
+import { MEMORY_LIVEZ_URL, MEMORY_REST_PORT, MEMORY_PID_PATH, } from './_paths.js';
+import { MemoryServiceContainerController } from '../memory-service-container.js';
 async function probe(secret) {
     try {
         const headers = {};
@@ -38,22 +32,17 @@ async function probe(secret) {
     }
 }
 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 controller = new MemoryServiceContainerController();
+    const containerStatus = controller.status();
     const secret = readMemorySecretOrNull();
     const livez = await probe(secret);
     return {
-        pid,
-        alive,
+        state: containerStatus.state,
+        containerId: containerStatus.containerId ?? null,
         livez,
         secretSet: hasMemorySecret(),
-        iiiBinary: existsSync(III_BINARY_PATH) ? III_BINARY_PATH : null,
         port: MEMORY_REST_PORT,
+        legacyPidfilePresent: existsSync(MEMORY_PID_PATH),
     };
 }
 export async function runMemoryStatus(opts = {}) {
@@ -63,24 +52,32 @@ export async function runMemoryStatus(opts = {}) {
         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('state', s.state);
+    if (s.containerId)
+        printInfo('container', s.containerId.slice(0, 12));
     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)
+    if (s.legacyPidfilePresent) {
+        printWarning('~/.olam/memory.pid is present (Phase A legacy artefact). ' +
+            'Will be cleaned up on next `olam memory start` or `olam memory stop`.');
+    }
+    if (s.state === 'running' && s.livez === 'ok')
         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`.');
+    if (s.state === 'missing') {
+        printWarning('no olam-memory-service container exists; run `olam memory start`');
         return 1;
     }
-    if (s.alive === false && s.pid !== null) {
-        printWarning('pidfile points at a dead process; run `olam memory stop` to clean up');
+    if (s.livez === 'unauthorized') {
+        printWarning('livez returned 401 — the container is up but the local secret does not match. ' +
+            'The container was likely started with a different secret. ' +
+            '`olam memory stop && olam memory start` will reconcile.');
         return 1;
     }
-    if (!s.iiiBinary) {
-        printWarning('iii binary missing; run `node packages/memory-service/scripts/ensure-iii-engine.mjs`');
+    if (s.livez === 'unreachable' && s.state === 'running') {
+        printWarning('container is running but /agentmemory/livez did not respond. ' +
+            'Check `olam memory logs` for startup errors.');
+        return 1;
     }
     if (!s.secretSet) {
         printWarning('secret missing; `olam memory start` will generate it');
@@ -90,7 +87,7 @@ export async function runMemoryStatus(opts = {}) {
 export function registerMemoryStatus(cmd) {
     cmd
         .command('status')
-        .description('Diagnostic dump for the host memory service (pid + livez + secret-set check)')
+        .description('Diagnostic dump for the agent-memory Docker container (Phase B substrate).')
         .option('--json', 'Machine-readable JSON output', false)
         .action(async (opts) => {
         const rc = await runMemoryStatus(opts);

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

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

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

@@ -1,10 +1,11 @@
 /**
- * olam memory stop — terminate the host agent-memory process gracefully.
+ * olam memory stop — stop the agent-memory Docker container.
  *
- * SIGTERM → wait 10s → SIGKILL. Removes the pidfile on clean exit.
- * Idempotent: no pidfile or stale pidfile → exit 0 with informational message.
+ * Phase B substrate: delegates to `MemoryServiceContainerController.stop()`.
+ * Also cleans up any residual Phase A legacy state (`~/.olam/memory.pid` +
+ * the log file) via `migrateFromHostProcess({ removeLog: true })`.
  *
- * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ * Plan reference: docs/plans/memory-service-as-docker-peripheral/phase-b-tasks.md B2
  */
 import type { Command } from 'commander';
 export declare function runMemoryStop(): Promise<number>;

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

@@ -1 +1 @@
-{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/stop.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAmDrD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQrD"}
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/stop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CA8BrD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQrD"}

package/dist/commands/memory/stop.js

@@ -1,77 +1,48 @@
 /**
- * olam memory stop — terminate the host agent-memory process gracefully.
+ * olam memory stop — stop the agent-memory Docker container.
  *
- * SIGTERM → wait 10s → SIGKILL. Removes the pidfile on clean exit.
- * Idempotent: no pidfile or stale pidfile → exit 0 with informational message.
+ * Phase B substrate: delegates to `MemoryServiceContainerController.stop()`.
+ * Also cleans up any residual Phase A legacy state (`~/.olam/memory.pid` +
+ * the log file) via `migrateFromHostProcess({ removeLog: true })`.
  *
- * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ * Plan reference: docs/plans/memory-service-as-docker-peripheral/phase-b-tasks.md B2
  */
-import { existsSync, readFileSync, unlinkSync } from 'node:fs';
-import { printSuccess, printWarning, printInfo, printHeader } from '../../output.js';
-import { MEMORY_PID_PATH } from './_paths.js';
-const SIGTERM_GRACE_MS = 10_000;
-const POLL_MS = 250;
-function isAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
+import { printSuccess, printInfo, printHeader, printWarning } from '../../output.js';
+import { MemoryServiceContainerController } from '../memory-service-container.js';
+import { migrateFromHostProcess } from '../../lib/memory-host-process-migration.js';
 export async function runMemoryStop() {
     printHeader('olam memory stop');
-    if (!existsSync(MEMORY_PID_PATH)) {
-        printSuccess('no pidfile present (nothing to stop)');
+    // Always sweep up legacy state. Stop is the canonical "remove all running
+    // agent-memory" verb; we additionally remove the log file here (vs start.ts
+    // which leaves it in place — see B5's removeLog flag).
+    const migration = migrateFromHostProcess({ removeLog: true });
+    if (migration.cleaned) {
+        printInfo('migration', migration.summary);
+    }
+    const controller = new MemoryServiceContainerController();
+    const current = controller.status();
+    if (current.state === 'missing') {
+        printSuccess('no olam-memory-service container present (nothing to stop)');
         return 0;
     }
-    const pid = parseInt(readFileSync(MEMORY_PID_PATH, 'utf8').trim(), 10);
-    if (!Number.isFinite(pid) || pid <= 0) {
-        printWarning(`pidfile contained invalid value; removing`);
-        unlinkSync(MEMORY_PID_PATH);
+    if (current.state === 'stopped') {
+        printSuccess('olam-memory-service container already stopped');
         return 0;
     }
-    if (!isAlive(pid)) {
-        printSuccess(`pid ${pid} is not running (stale pidfile); cleaned up`);
-        unlinkSync(MEMORY_PID_PATH);
-        return 0;
-    }
-    printInfo('pid', `${pid}`);
     try {
-        process.kill(pid, 'SIGTERM');
+        controller.stop();
     }
     catch (err) {
-        printWarning(`SIGTERM to pid ${pid} failed: ${err.message}`);
-    }
-    // Wait for graceful exit
-    const deadline = Date.now() + SIGTERM_GRACE_MS;
-    while (Date.now() < deadline) {
-        if (!isAlive(pid))
-            break;
-        await new Promise((r) => setTimeout(r, POLL_MS));
-    }
-    if (isAlive(pid)) {
-        printWarning(`pid ${pid} did not exit within ${SIGTERM_GRACE_MS / 1000}s; sending SIGKILL`);
-        try {
-            process.kill(pid, 'SIGKILL');
-        }
-        catch (err) {
-            printWarning(`SIGKILL to pid ${pid} failed: ${err.message}`);
-        }
-        // Brief wait for SIGKILL to take effect
-        await new Promise((r) => setTimeout(r, 500));
-    }
-    if (existsSync(MEMORY_PID_PATH)) {
-        unlinkSync(MEMORY_PID_PATH);
+        printWarning(`docker stop failed: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
     }
-    printSuccess(`stopped (pid ${pid})`);
+    printSuccess('olam-memory-service stopped');
     return 0;
 }
 export function registerMemoryStop(cmd) {
     cmd
         .command('stop')
-        .description('Stop the host agent-memory process (SIGTERM → SIGKILL after 10s; idempotent)')
+        .description('Stop the agent-memory Docker container (Phase B substrate; idempotent).')
         .action(async () => {
         const rc = await runMemoryStop();
         if (rc !== 0)