omo-memory 0.1.12 → 0.1.13

package/README.md

@@ -39,6 +39,7 @@ After the package is published to npm, use the same package for CLI and MCP:
 
 ```sh
 npx -y omo-memory init
+npx -y omo-memory update
 npx -y omo-memory global scan --root .
 npx -y omo-memory global migrate --root . --global-db ~/.omo/memory/global.sqlite
 npx -y omo-memory session bootstrap --host codex --adapter lazycodex --limit 5
@@ -140,6 +141,22 @@ Initial stdio MCP tools:
 - `memory_ontology_supersede`
 - `memory_ontology_recall`
 
+## Updates
+
+Installed CLI commands automatically launch a quiet background `npm install -g omo-memory@latest` at most once per day. MCP startup does not run the updater, so stdio handshakes stay clean.
+
+Manual update:
+
+```sh
+omo-memory update
+```
+
+Disable automatic update for pinned environments:
+
+```sh
+OMO_MEMORY_AUTO_UPDATE=0 omo-memory doctor
+```
+
 ## Second-brain layer
 
 The base ledger remains project-local and chronological: sessions, events, handoffs, and explicit recall. The second-brain layer adds deterministic ontology tables and lifecycle commands:

package/dist/autoUpdate.js

@@ -0,0 +1,84 @@
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const PACKAGE_NAME = "omo-memory";
+const DEFAULT_INTERVAL_MS = 86_400_000;
+const STATE_PATH = join(homedir(), ".omo", "memory", "auto-update.json");
+export function maybeRunAutoUpdate(currentVersion, nowMs = Date.now()) {
+    const statePath = process.env["OMO_MEMORY_UPDATE_STATE"] ?? STATE_PATH;
+    if (!shouldAttemptAutoUpdate({ nowMs, statePath }))
+        return;
+    writeAttemptStamp(statePath, nowMs);
+    const child = spawn(npmCommand(), installArgs(), {
+        detached: true,
+        stdio: "ignore",
+        env: updateEnv(currentVersion),
+    });
+    child.unref();
+}
+export function runAutoUpdate(currentVersion) {
+    const command = npmCommand();
+    const args = installArgs();
+    const result = spawnSync(command, args, { encoding: "utf8", env: updateEnv(currentVersion) });
+    return {
+        ok: result.status === 0,
+        packageName: PACKAGE_NAME,
+        currentVersion,
+        command: [command, ...args],
+        status: result.status,
+        stdout: result.stdout,
+        stderr: result.stderr,
+    };
+}
+function shouldAttemptAutoUpdate(input) {
+    if (process.env["OMO_MEMORY_AUTO_UPDATE"] === "0")
+        return false;
+    if (process.env["OMO_MEMORY_AUTO_UPDATE"] === "false")
+        return false;
+    if (process.env["OMO_MEMORY_AUTO_UPDATE_CHILD"] === "1")
+        return false;
+    const intervalMs = updateIntervalMs();
+    if (!existsSync(input.statePath))
+        return true;
+    const lastAttemptMs = readLastAttemptMs(input.statePath);
+    return lastAttemptMs === null || input.nowMs - lastAttemptMs >= intervalMs;
+}
+function updateIntervalMs() {
+    const raw = process.env["OMO_MEMORY_AUTO_UPDATE_INTERVAL_MS"];
+    if (raw === undefined)
+        return DEFAULT_INTERVAL_MS;
+    const parsed = Number(raw);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : DEFAULT_INTERVAL_MS;
+}
+function readLastAttemptMs(statePath) {
+    try {
+        const parsed = JSON.parse(readFileSync(statePath, "utf8"));
+        if (!isRecord(parsed))
+            return null;
+        const value = parsed["lastAttemptMs"];
+        return typeof value === "number" && Number.isFinite(value) ? value : null;
+    }
+    catch (error) {
+        if (error instanceof Error)
+            return null;
+        throw error;
+    }
+}
+function writeAttemptStamp(statePath, nowMs) {
+    mkdirSync(dirname(statePath), { recursive: true });
+    writeFileSync(statePath, `${JSON.stringify({ lastAttemptMs: nowMs })}\n`);
+}
+function npmCommand() {
+    return process.env["OMO_MEMORY_NPM_COMMAND"] ?? "npm";
+}
+function installArgs() {
+    const target = process.env["OMO_MEMORY_UPDATE_TARGET"] ?? `${PACKAGE_NAME}@latest`;
+    return ["install", "-g", target];
+}
+function updateEnv(currentVersion) {
+    return { ...process.env, OMO_MEMORY_AUTO_UPDATE_CHILD: "1", OMO_MEMORY_CURRENT_VERSION: currentVersion };
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object";
+}

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { readFileSync } from "node:fs";
+import { maybeRunAutoUpdate, runAutoUpdate } from "./autoUpdate.js";
 import { applyConceptExtraction } from "./conceptExtraction.js";
 import { migrateToGlobalMemory, scanForMemoryDbs } from "./globalMemory.js";
 import { runGraphTui } from "./graphTui.js";
@@ -21,6 +22,12 @@ async function main(argv) {
         await runMcpServer();
         return;
     }
+    const currentVersion = readPackageVersion();
+    if (command === "update") {
+        process.stdout.write(`${JSON.stringify(runAutoUpdate(currentVersion), null, 2)}\n`);
+        return;
+    }
+    maybeRunAutoUpdate(currentVersion);
     if (command === "graph" && subcommand === "tui") {
         const query = readFlag(rest, "--query");
         await runGraphTui({ dbPath: readFlag(rest, "--db") ?? defaultDbPath(), ...(query === undefined ? {} : { query }) });
@@ -200,7 +207,17 @@ function fail(message) {
     throw new Error(message);
 }
 function printHelp() {
-    process.stdout.write(`OMO Memory\n\nCommands:\n  omo-memory init\n  omo-memory doctor\n  omo-memory export\n  omo-memory purge --yes\n  omo-memory global scan --root <path> [--json]\n  omo-memory global migrate --root <path> --global-db <path> [--json]\n  omo-memory ontology candidates\n  omo-memory ontology score\n  omo-memory ontology promote --concept <label|id> [--summary <text>] [--body <text>]\n  omo-memory ontology demote --id <durable-id>\n  omo-memory ontology supersede --id <durable-id> [--summary <text>]\n  omo-memory ontology recall --query <text> [--limit <n>]\n  omo-memory session start --host <codex|opencode|grok|unknown> --adapter <name>\n  omo-memory session bootstrap --host <codex|opencode|grok|unknown> --adapter <name> [--limit <n>]\n  omo-memory event record --type <type> --summary <text> [--session-id <id>]\n  omo-memory recent [--limit <n>]\n  omo-memory recall --query <text> [--limit <n>]\n  omo-memory handoff write (--summary <text> | --summary-file <path>) [--session-id <id>]\n  omo-memory graph tui [--db <path>] [--query <text>]  (requires Bun on PATH)\n  omo-memory mcp\n`);
+    process.stdout.write(`OMO Memory\n\nCommands:\n  omo-memory init\n  omo-memory doctor\n  omo-memory update\n  omo-memory export\n  omo-memory purge --yes\n  omo-memory global scan --root <path> [--json]\n  omo-memory global migrate --root <path> --global-db <path> [--json]\n  omo-memory ontology candidates\n  omo-memory ontology score\n  omo-memory ontology promote --concept <label|id> [--summary <text>] [--body <text>]\n  omo-memory ontology demote --id <durable-id>\n  omo-memory ontology supersede --id <durable-id> [--summary <text>]\n  omo-memory ontology recall --query <text> [--limit <n>]\n  omo-memory session start --host <codex|opencode|grok|unknown> --adapter <name>\n  omo-memory session bootstrap --host <codex|opencode|grok|unknown> --adapter <name> [--limit <n>]\n  omo-memory event record --type <type> --summary <text> [--session-id <id>]\n  omo-memory recent [--limit <n>]\n  omo-memory recall --query <text> [--limit <n>]\n  omo-memory handoff write (--summary <text> | --summary-file <path>) [--session-id <id>]\n  omo-memory graph tui [--db <path>] [--query <text>]  (requires Bun on PATH)\n  omo-memory mcp\n`);
+}
+function readPackageVersion() {
+    const rawPackage = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+    if (!isObject(rawPackage))
+        return "0.0.0";
+    const version = rawPackage["version"];
+    return typeof version === "string" && version.length > 0 ? version : "0.0.0";
+}
+function isObject(value) {
+    return value !== null && typeof value === "object";
 }
 main(process.argv.slice(2)).catch((error) => {
     const message = error instanceof Error ? error.message : String(error);

package/docs/adapter-integration.md

@@ -150,6 +150,8 @@ Use these tools:
 - `memory_ontology_supersede`
 - `memory_ontology_recall`
 
+CLI updates: normal CLI commands automatically launch a quiet background `npm install -g omo-memory@latest` at most once per day. MCP startup intentionally does not auto-update because stdout/stderr must remain reserved for the protocol. Hosts that need pinned installs should set `OMO_MEMORY_AUTO_UPDATE=0` in the CLI environment.
+
 Global migration is copy/import only. Adapters may scan for existing project-local `.omo/memory/state.sqlite` databases and import them into a user-selected global SQLite file, but they must preserve source DBs and retain source provenance in the global store.
 
 Global migration also materializes an aggregate OMO schema view inside the global SQLite file. This lets existing ontology extraction, retention scoring, recall, and OpenTUI graph code operate on integrated cross-project events while `global_*` tables retain source database provenance.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omo-memory",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "Host-neutral local SQLite memory and session ledger for OMO adapters, exposed through CLI and MCP.",
   "type": "module",
   "files": [