@pleri/olam-cli 0.1.153 → 0.1.157

package/dist/commands/kg-install-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kg-install-hook.d.ts","sourceRoot":"","sources":["../../src/commands/kg-install-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCzC,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAyD9D"}
+{"version":3,"file":"kg-install-hook.d.ts","sourceRoot":"","sources":["../../src/commands/kg-install-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuKzC,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAmE9D"}

package/dist/commands/kg-install-hook.js

@@ -1,7 +1,13 @@
 /**
- * `olam kg install-hook [--scope project|user]` — wire the kg-service PreToolUse
+ * `olam kg install-hook [--scope project|user] [--for claude|hermes]`
+ *
+ * Default (--for claude, --scope project): wire the kg-service PreToolUse
  * hook into .claude/settings.json.
  *
+ * --for hermes: install kg-first.sh into ~/.hermes/hooks/ and patch
+ * ~/.hermes/config.yaml hooks.pre_tool_call. Refuses if
+ * ~/.hermes/config.yaml doesn't exist.
+ *
  * Default scope=project writes to `<cwd>/.claude/settings.json`. Per-repo
  * opt-in keeps blast radius small (operator can try it on one repo before
  * promoting to --scope user which targets `~/.claude/settings.json`).
@@ -12,9 +18,11 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
+import { parse as yamlParse, stringify as yamlStringify } from 'yaml';
 import { mergeHomeSettingsJson } from '@olam/core/src/world/merge-settings.js';
 import { buildHookMatcherEntry, KG_HOOK_SENTINEL, } from '@olam/core/src/kg/hook-template.js';
 import { printError, printInfo, printSuccess, printWarning } from '../output.js';
+import { installKgFirstHookForHermes, HERMES_KG_HOOK_SENTINEL, } from './hermes-kg-hook.js';
 function settingsPathFor(scope) {
     if (scope === 'user') {
         return path.join(os.homedir(), '.claude', 'settings.json');
@@ -29,14 +37,125 @@ function backup(filePath) {
     fs.copyFileSync(filePath, backupPath);
     return backupPath;
 }
+const HERMES_HOOK_MATCHERS = ['terminal', 'bash', 'shell', 'search_files', 'grep', 'ripgrep'];
+function hermesConfigPath() {
+    return path.join(os.homedir(), '.hermes', 'config.yaml');
+}
+function hermesHooksDir() {
+    return path.join(os.homedir(), '.hermes', 'hooks');
+}
+/**
+ * Patch ~/.hermes/config.yaml to add / remove the pre_tool_call entry.
+ * Idempotent: checks for HERMES_KG_HOOK_SENTINEL before writing.
+ */
+function patchHermesConfigForHook(action) {
+    const configPath = hermesConfigPath();
+    const raw = fs.readFileSync(configPath, 'utf-8');
+    const config = yamlParse(raw);
+    const hooks = (config['hooks'] ?? {});
+    const preToolCall = Array.isArray(hooks['pre_tool_call'])
+        ? hooks['pre_tool_call']
+        : [];
+    if (action === 'install') {
+        const alreadyPresent = preToolCall.some((e) => typeof e['command'] === 'string' && e['command'].includes(HERMES_KG_HOOK_SENTINEL));
+        if (alreadyPresent)
+            return 'already-present';
+        const hookScriptPath = path.join(hermesHooksDir(), 'kg-first.sh');
+        const entry = {
+            matcher: HERMES_HOOK_MATCHERS.join('|'),
+            command: `${hookScriptPath} # ${HERMES_KG_HOOK_SENTINEL}`,
+        };
+        const updated = {
+            ...config,
+            hooks: { ...hooks, pre_tool_call: [...preToolCall, entry] },
+            hooks_auto_accept: true,
+        };
+        fs.writeFileSync(configPath, yamlStringify(updated), 'utf-8');
+        return 'patched';
+    }
+    // uninstall
+    const filtered = preToolCall.filter((e) => !(typeof e['command'] === 'string' && e['command'].includes(HERMES_KG_HOOK_SENTINEL)));
+    if (filtered.length === preToolCall.length)
+        return 'already-absent';
+    const updated = {
+        ...config,
+        hooks: { ...hooks, pre_tool_call: filtered },
+    };
+    fs.writeFileSync(configPath, yamlStringify(updated), 'utf-8');
+    return 'patched';
+}
+// ── Action: install for Hermes ────────────────────────────────────────────────
+function doInstallForHermes() {
+    const configPath = hermesConfigPath();
+    if (!fs.existsSync(configPath)) {
+        printError(`~/.hermes/config.yaml not found at ${configPath}`);
+        printInfo('remedy', 'Install Hermes first, then re-run `olam kg install-hook --for hermes`');
+        process.exitCode = 1;
+        return;
+    }
+    const hooksDir = hermesHooksDir();
+    const hookResult = installKgFirstHookForHermes(hooksDir, /* dryRun */ false);
+    const configResult = patchHermesConfigForHook('install');
+    if (hookResult.status === 'already-present' && configResult === 'already-present') {
+        printInfo('kg-first hook', `already installed for Hermes`);
+        return;
+    }
+    if (hookResult.status === 'installed') {
+        printSuccess(`kg-first.sh installed → ${hookResult.destPath}`);
+    }
+    if (configResult === 'patched') {
+        printSuccess(`${configPath} patched — hooks.pre_tool_call entry added`);
+    }
+    printInfo('next', 'hermes gateway restart');
+}
+// ── Action: uninstall for Hermes ──────────────────────────────────────────────
+function doUninstallForHermes() {
+    const configPath = hermesConfigPath();
+    const hooksDir = hermesHooksDir();
+    const hookScriptPath = path.join(hooksDir, 'kg-first.sh');
+    let scriptRemoved = false;
+    if (fs.existsSync(hookScriptPath)) {
+        const content = fs.readFileSync(hookScriptPath, 'utf-8');
+        if (content.includes(HERMES_KG_HOOK_SENTINEL)) {
+            fs.unlinkSync(hookScriptPath);
+            scriptRemoved = true;
+        }
+    }
+    let configPatched = false;
+    if (fs.existsSync(configPath)) {
+        const result = patchHermesConfigForHook('uninstall');
+        configPatched = result === 'patched';
+    }
+    if (!scriptRemoved && !configPatched) {
+        printInfo('kg-first hook', 'not installed for Hermes — nothing to remove');
+        return;
+    }
+    if (scriptRemoved)
+        printSuccess(`kg-first.sh removed from ${hooksDir}`);
+    if (configPatched)
+        printSuccess(`${configPath} patched — pre_tool_call entry removed`);
+}
+// ── Command registration ──────────────────────────────────────────────────────
 export function registerKgInstallHookCommand(kg) {
     kg.command('install-hook')
-        .description('Install kg-service PreToolUse hook into .claude/settings.json (idempotent)')
+        .description('Install kg-service hook (idempotent). --for hermes targets ~/.hermes/; default targets .claude/settings.json')
         .option('--scope <scope>', 'project (default; <cwd>/.claude/settings.json) or user (~/.claude/settings.json)', 'project')
+        .option('--for <target>', 'Target agent: claude (default) or hermes', 'claude')
+        .option('--uninstall', 'Uninstall instead of install')
         .action((opts) => {
+        const target = opts.for === 'hermes' ? 'hermes' : 'claude';
+        if (target === 'hermes') {
+            if (opts.uninstall) {
+                doUninstallForHermes();
+            }
+            else {
+                doInstallForHermes();
+            }
+            return;
+        }
+        // ── Claude target (original behaviour) ──────────────────────────────
         const scope = opts.scope === 'user' ? 'user' : 'project';
         const filePath = settingsPathFor(scope);
-        // Ensure parent .claude/ dir exists (settings.json may not yet be present).
         try {
             fs.mkdirSync(path.dirname(filePath), { recursive: true });
         }
@@ -45,7 +164,6 @@ export function registerKgInstallHookCommand(kg) {
             process.exitCode = 1;
             return;
         }
-        // Back up any existing settings.json before mutation.
         const backupPath = backup(filePath);
         try {
             const result = mergeHomeSettingsJson(filePath, {
@@ -65,7 +183,6 @@ export function registerKgInstallHookCommand(kg) {
                     return;
                 case 'already-present':
                     printInfo('kg-service hook', `already installed at ${filePath}`);
-                    // Backup was unnecessary; clean up to avoid backup-file proliferation.
                     if (backupPath) {
                         try {
                             fs.unlinkSync(backupPath);
@@ -76,7 +193,6 @@ export function registerKgInstallHookCommand(kg) {
                     }
                     return;
                 case 'no-op':
-                    // mergeHomeSettingsJson returns no-op when there's no patch — shouldn't happen with ensureHook
                     printWarning(`no change made to ${filePath}`);
                     return;
             }

package/dist/commands/kg-install-hook.js.map

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

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

@@ -1,10 +1,20 @@
 /**
  * Shared file-path + URL constants for `olam memory` subcommands.
- * Centralised so start/stop/status/logs all agree.
+ *
+ * memory-service-as-docker-peripheral Phase C C4 dropped `OLAM_BIN_DIR` and
+ * `III_BINARY_PATH` (no consumers after Phase B replaced the host-process
+ * substrate with `MemoryServiceContainerController`). `MEMORY_PID_PATH` +
+ * `MEMORY_LOG_PATH` are retained for the legacy-state migration helper —
+ * upgraders from the pre-Phase-B substrate still need cleanup of these
+ * artefacts on first new-substrate `olam memory start`.
+ *
+ * `MEMORY_SERVICE_CANDIDATES` is retained for `bridge.ts` (a separate
+ * Cloudflare-bridging subcommand that resolves `packages/memory-service/`
+ * for its `local-bridge-server.mjs`). Phase C also dropped the
+ * `memory-service-bundle/` candidate — that bundle no longer ships in the
+ * @pleri/olam-cli tarball.
  */
 export declare const OLAM_HOME: string;
-export declare const OLAM_BIN_DIR: string;
-export declare const III_BINARY_PATH: string;
 export declare const MEMORY_PID_PATH: string;
 export declare const MEMORY_LOG_PATH: string;
 export declare const MEMORY_DATA_DIR: string;

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

@@ -1 +1 @@
-{"version":3,"file":"_paths.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/_paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,eAAO,MAAM,SAAS,QAA2B,CAAC;AAClD,eAAO,MAAM,YAAY,QAAyB,CAAC;AACnD,eAAO,MAAM,eAAe,QAA4B,CAAC;AACzD,eAAO,MAAM,eAAe,QAAgC,CAAC;AAC7D,eAAO,MAAM,eAAe,QAAwC,CAAC;AACrE,eAAO,MAAM,eAAe,QAAiC,CAAC;AAE9D,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,gBAAgB,4CAA2D,CAAC;AAuCzF,eAAO,MAAM,yBAAyB,UAAa,CAAC"}
+{"version":3,"file":"_paths.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/_paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,eAAO,MAAM,SAAS,QAA2B,CAAC;AAClD,eAAO,MAAM,eAAe,QAAgC,CAAC;AAC7D,eAAO,MAAM,eAAe,QAAwC,CAAC;AACrE,eAAO,MAAM,eAAe,QAAiC,CAAC;AAE9D,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,gBAAgB,4CAA2D,CAAC;AAgCzF,eAAO,MAAM,yBAAyB,UAAa,CAAC"}

package/dist/commands/memory/_paths.js

@@ -1,13 +1,23 @@
 /**
  * Shared file-path + URL constants for `olam memory` subcommands.
- * Centralised so start/stop/status/logs all agree.
+ *
+ * memory-service-as-docker-peripheral Phase C C4 dropped `OLAM_BIN_DIR` and
+ * `III_BINARY_PATH` (no consumers after Phase B replaced the host-process
+ * substrate with `MemoryServiceContainerController`). `MEMORY_PID_PATH` +
+ * `MEMORY_LOG_PATH` are retained for the legacy-state migration helper —
+ * upgraders from the pre-Phase-B substrate still need cleanup of these
+ * artefacts on first new-substrate `olam memory start`.
+ *
+ * `MEMORY_SERVICE_CANDIDATES` is retained for `bridge.ts` (a separate
+ * Cloudflare-bridging subcommand that resolves `packages/memory-service/`
+ * for its `local-bridge-server.mjs`). Phase C also dropped the
+ * `memory-service-bundle/` candidate — that bundle no longer ships in the
+ * @pleri/olam-cli tarball.
  */
 import { homedir } from 'node:os';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 export const OLAM_HOME = join(homedir(), '.olam');
-export const OLAM_BIN_DIR = join(OLAM_HOME, 'bin');
-export const III_BINARY_PATH = join(OLAM_BIN_DIR, 'iii');
 export const MEMORY_PID_PATH = join(OLAM_HOME, 'memory.pid');
 export const MEMORY_LOG_PATH = join(OLAM_HOME, 'memory-service.log');
 export const MEMORY_DATA_DIR = join(OLAM_HOME, 'memory-data');
@@ -15,38 +25,31 @@ export const MEMORY_DATA_DIR = join(OLAM_HOME, 'memory-data');
 export const MEMORY_REST_PORT = 3111;
 export const MEMORY_LIVEZ_URL = `http://localhost:${MEMORY_REST_PORT}/agentmemory/livez`;
 /**
- * Resolve packages/memory-service/ from the CLI source/bundle location.
+ * Resolve packages/memory-service/ from the CLI source location.
  *
- * Three layouts to probe:
+ * Two layouts (Phase C removed the bundled-CLI candidate):
  *
  * 1. **Workspace dev (built)** — `packages/cli/dist/commands/memory/_paths.js`
  *    runs in the monorepo. Sibling: `packages/memory-service/`.
  *
- * 2. **Bundled dist (workspace OR published)** — `packages/cli/dist/index.js`
- *    is the esbuild bundle. In dev: sibling `packages/memory-service/`.
- *    In a published @pleri/olam-cli tarball: sibling `memory-service-bundle/`
- *    (a stripped-down copy containing just scripts/ensure-iii-engine.mjs;
- *    see bundle-cli.mjs for the copy step).
+ * 2. **Workspace bundled** — `packages/cli/dist/index.js` is the esbuild
+ *    bundle (workspace dev path). Sibling: `packages/memory-service/`.
  *
- * 3. **CWD fallback** — operator runs `olam memory start` from a repo
- *    checkout; `./packages/memory-service` exists.
+ * 3. **CWD fallback** — operator runs from a repo checkout;
+ *    `./packages/memory-service` exists.
  *
- * The publish-shape `memory-service-bundle/` only contains `scripts/`,
- * not `src/` or `Dockerfile` — host-mode start.ts only references the
- * scripts/ subdir, so the partial mirror is sufficient. Cloud-mode
- * (`wrangler deploy`) runs from a repo checkout where the full
- * `packages/memory-service/` is present.
+ * In a published @pleri/olam-cli tarball, `packages/memory-service/` does
+ * NOT ship — operators consume memory-service via the
+ * `ghcr.io/pleri/olam-memory-service:latest` Docker image instead. `bridge.ts`
+ * is the only remaining consumer of this list; it requires the operator to
+ * run from a checkout when invoking `olam memory bridge serve --local`.
  */
 const here = dirname(fileURLToPath(import.meta.url));
 const candidates = [
     // 1. Workspace dev (built): packages/cli/dist/commands/memory/_paths.js → packages/cli → packages/memory-service
     join(here, '..', '..', '..', '..', 'memory-service'),
-    // 2a. Workspace bundled: packages/cli/dist/index.js → packages/cli → packages/memory-service
+    // 2. Workspace bundled: packages/cli/dist/index.js → packages/cli → packages/memory-service
     join(here, '..', '..', 'memory-service'),
-    // 2b. Published tarball: <prefix>/node_modules/@pleri/olam-cli/dist/index.js
-    //     → <prefix>/node_modules/@pleri/olam-cli/memory-service-bundle
-    //     (copied at publish time by bundle-cli.mjs)
-    join(here, '..', 'memory-service-bundle'),
     // 3. CWD fallback
     join(process.cwd(), 'packages', 'memory-service'),
 ];

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

@@ -1 +1 @@
-{"version":3,"file":"_paths.js","sourceRoot":"","sources":["../../../src/commands/memory/_paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAE9D,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,gBAAgB,oBAAoB,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,UAAU,GAAG;IACjB,iHAAiH;IACjH,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC;IACpD,6FAA6F;IAC7F,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC;IACxC,6EAA6E;IAC7E,oEAAoE;IACpE,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,uBAAuB,CAAC;IACzC,kBAAkB;IAClB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,gBAAgB,CAAC;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC"}
+{"version":3,"file":"_paths.js","sourceRoot":"","sources":["../../../src/commands/memory/_paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAE9D,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,gBAAgB,oBAAoB,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,UAAU,GAAG;IACjB,iHAAiH;IACjH,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC;IACpD,4FAA4F;IAC5F,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC;IACxC,kBAAkB;IAClB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,gBAAgB,CAAC;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC"}

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

@@ -1,10 +1,14 @@
 /**
- * olam memory logs — tail ~/.olam/memory-service.log.
+ * olam memory logs — stream the agent-memory Docker container's stdout/stderr.
  *
- * --follow (alias -f): tail -f-style; Ctrl-C to stop.
- * --tail N (default 50): last N lines.
+ * Phase B substrate: shells to `docker logs olam-memory-service`. The Phase A
+ * file-tail path (`tail -f ~/.olam/memory-service.log`) is retired because the
+ * log file no longer exists once the container substrate is in place.
  *
- * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ *   --follow (alias -f): docker logs --follow (Ctrl-C to stop).
+ *   --tail N (default 50): docker logs --tail N.
+ *
+ * Plan reference: docs/plans/memory-service-as-docker-peripheral/phase-b-tasks.md B4
  */
 import type { Command } from 'commander';
 export declare function runMemoryLogs(opts: {

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

@@ -1 +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"}
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB9F;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAUrD"}

package/dist/commands/memory/logs.js

@@ -1,18 +1,23 @@
 /**
- * olam memory logs — tail ~/.olam/memory-service.log.
+ * olam memory logs — stream the agent-memory Docker container's stdout/stderr.
  *
- * --follow (alias -f): tail -f-style; Ctrl-C to stop.
- * --tail N (default 50): last N lines.
+ * Phase B substrate: shells to `docker logs olam-memory-service`. The Phase A
+ * file-tail path (`tail -f ~/.olam/memory-service.log`) is retired because the
+ * log file no longer exists once the container substrate is in place.
  *
- * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ *   --follow (alias -f): docker logs --follow (Ctrl-C to stop).
+ *   --tail N (default 50): docker logs --tail N.
+ *
+ * Plan reference: docs/plans/memory-service-as-docker-peripheral/phase-b-tasks.md B4
  */
-import { existsSync } from 'node:fs';
 import { spawn } from 'node:child_process';
 import { printWarning, printHeader } from '../../output.js';
-import { MEMORY_LOG_PATH } from './_paths.js';
+import { MEMORY_SERVICE_CONTAINER, MemoryServiceContainerController } from '../memory-service-container.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')`);
+    const controller = new MemoryServiceContainerController();
+    const status = controller.status();
+    if (status.state === 'missing') {
+        printWarning(`no olam-memory-service container exists. Start it via 'olam memory start'.`);
         return 1;
     }
     const tailN = opts.tail ? parseInt(opts.tail, 10) : 50;
@@ -20,12 +25,12 @@ export async function runMemoryLogs(opts) {
         printWarning(`invalid --tail value: ${opts.tail}`);
         return 1;
     }
-    const args = ['-n', `${tailN}`];
+    const args = ['logs', '--tail', String(tailN)];
     if (opts.follow)
-        args.push('-f');
-    args.push(MEMORY_LOG_PATH);
+        args.push('--follow');
+    args.push(MEMORY_SERVICE_CONTAINER);
     printHeader(`olam memory logs (${opts.follow ? 'follow' : `tail -n ${tailN}`})`);
-    const child = spawn('tail', args, { stdio: 'inherit' });
+    const child = spawn('docker', args, { stdio: 'inherit' });
     return new Promise((resolve) => {
         child.on('exit', (code) => resolve(code ?? 0));
     });
@@ -33,7 +38,7 @@ export async function runMemoryLogs(opts) {
 export function registerMemoryLogs(cmd) {
     cmd
         .command('logs')
-        .description('Tail the memory service log file at ~/.olam/memory-service.log')
+        .description('Stream the olam-memory-service container logs (Phase B substrate).')
         .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) => {

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

@@ -1 +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"}
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/commands/memory/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAE5G,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAyC;IAC3E,MAAM,UAAU,GAAG,IAAI,gCAAgC,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;IACnC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,YAAY,CACV,4EAA4E,CAC7E,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,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;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAEpC,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,QAAQ,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1D,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,oEAAoE,CAAC;SACjF,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/mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,kCAAkC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAoDD,MAAM,MAAM,WAAW,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE,GAC5C;IAAE,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAC/B;IAAE,OAAO,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA0BlF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA2ElF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CA+BrD"}
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,kCAAkC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAoDD,MAAM,MAAM,WAAW,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE,GAC5C;IAAE,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAC/B;IAAE,OAAO,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA8BlF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA2ElF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CA+BrD"}

package/dist/commands/memory/mode.js

@@ -70,7 +70,11 @@ export async function runMemoryModeLocal(deps = {}) {
     const { parsed } = readConfigYaml(cfg.absPath);
     const currentMode = parsed.memory?.mode ?? 'local';
     if (currentMode === 'local') {
-        printInfo('memory.mode', 'already local — ensuring host-process is up');
+        // Phase B substrate semantics: `mode local` ensures the Docker container
+        // is running. Mechanism shifted from host-process spawn → docker container
+        // (memory-service-as-docker-peripheral Phase B B8). Intent — "the memory
+        // service runs locally rather than against a remote URL" — is preserved.
+        printInfo('memory.mode', 'already local — ensuring Docker container is up');
         const rc = (deps.runStart ?? runMemoryStart)();
         await rc;
         return { outcome: 'noop', mode: 'local' };
@@ -79,10 +83,10 @@ export async function runMemoryModeLocal(deps = {}) {
     parsed.memory = { mode: 'local' };
     writeConfigYaml(cfg.absPath, parsed);
     printSuccess(`flipped .olam/config.yaml memory.mode → local`);
-    printInfo('host-process', 'starting');
+    printInfo('container', 'starting (Docker substrate)');
     const rc = await (deps.runStart ?? runMemoryStart)();
     if (rc !== 0) {
-        printWarning('local host-process failed to start. Config flipped but service is down — fix the underlying issue and run `olam memory start`.');
+        printWarning('local Docker container failed to start. Config flipped but service is down — fix the underlying issue and run `olam memory start`.');
     }
     return { outcome: 'flipped-to-local' };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../../src/commands/memory/mode.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../../src/commands/memory/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAwBvC,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACtC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,MAAM,UAAU,OAAO,GAAG,mDAAmD,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;IACjE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,uBAAuB,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,MAAe;IACvD,oEAAoE;IACpE,uEAAuE;IACvE,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACjD,OAAO,iBAAiB,CAAC,GAAG,QAAQ,8CAA8C,CAAC,CAAC;AACtF,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAiB,EAAE;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE/C,MAAM,WAAW,GAAI,MAAM,CAAC,MAAwC,EAAE,IAAI,IAAI,OAAO,CAAC;IACtF,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QAC5B,yEAAyE;QACzE,2EAA2E;QAC3E,yEAAyE;QACzE,yEAAyE;QACzE,SAAS,CAAC,aAAa,EAAE,iDAAiD,CAAC,CAAC;QAC5E,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,cAAc,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,0EAA0E;IAC1E,MAAM,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAClC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,CAAC,+CAA+C,CAAC,CAAC;IAE9D,SAAS,CAAC,WAAW,EAAE,6BAA6B,CAAC,CAAC;IACtD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,cAAc,CAAC,EAAE,CAAC;IACrD,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QACb,YAAY,CACV,oIAAoI,CACrI,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAiB,EAAE;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE/C,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAgD,CAAC;IACxF,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC;IAE/C,yDAAyD;IACzD,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACnB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC;QACrD,GAAG,GAAG,CACJ,MAAM,OAAO,CAAC,sEAAsE,CAAC,CACtF,CAAC,IAAI,EAAE,CAAC;IACX,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,6CAA6C;IAC7C,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,OAAgB,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;IAC7D,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,mEAAmE;IACnE,qEAAqE;IACrE,uEAAuE;IACvE,sEAAsE;IACtE,iDAAiD;IACjD,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,IAAI,mBAAmB,CAAC;QAC3D,MAAM,GAAG,MAAM,SAAS,CAAC,2CAA2C,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAED,mFAAmF;IACnF,MAAM,OAAO,GAAG,WAAW,KAAK,OAAO,IAAI,UAAU,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;IACzE,IAAI,OAAO,EAAE,CAAC;QACZ,SAAS,CAAC,aAAa,EAAE,sBAAsB,GAAG,4BAA4B,CAAC,CAAC;QAChF,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACzE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,kEAAkE;IAClE,SAAS,CAAC,cAAc,EAAE,uCAAuC,CAAC,CAAC;IACnE,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC,EAAE,CAAC;IAExC,kEAAkE;IAClE,mEAAmE;IACnE,kEAAkE;IAClE,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACzE,YAAY,CAAC,gCAAgC,wBAAwB,SAAS,CAAC,CAAC;IAEhF,MAAM,CAAC,MAAM,GAAG;QACd,IAAI,EAAE,OAAO;QACb,KAAK,EAAE;YACL,GAAG;YACH,UAAU,EAAE,6BAA6B;SAC1C;KACF,CAAC;IACF,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,CAAC,kDAAkD,GAAG,GAAG,CAAC,CAAC;IAEvE,YAAY,CACV,yEAAyE;QACvE,2EAA2E,CAC9E,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,MAAM,IAAI,GAAG,GAAG;SACb,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CACV,iGAAiG,CAClG;SACA,MAAM,CAAC,aAAa,EAAE,2DAA2D,CAAC;SAClF,MAAM,CACL,kBAAkB,EAClB,6EAA6E,CAC9E,CAAC;IAEJ,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAuC,EAAE,EAAE;QAC5E,WAAW,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBACvB,MAAM,kBAAkB,EAAE,CAAC;YAC7B,CAAC;iBAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC9B,MAAM,kBAAkB,CAAC;oBACvB,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpD,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9D,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,yCAAyC,MAAM,GAAG,CAAC,CAAC;gBAC/D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,21 +1,23 @@
 /**
- * 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
+ * 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).
+ *
+ * Plan reference: docs/plans/memory-service-as-docker-peripheral/phase-b-tasks.md B1
  */
 import type { Command } from 'commander';
 export declare function runMemoryStart(): Promise<number>;

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

@@ -1 +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;AAoHzC,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAsGtD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQtD"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CA4DtD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQtD"}