om-memory-system 5.4.1 → 5.5.0

package/dist/services/spaces/storage-resolution.js

@@ -0,0 +1,29 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { resolveDefaultStoragePath } from "../legacy-migration.js";
+/** The OMMS folder, normally `~/.omms`. It holds `spaces.json`, `spaces/` and `backups/`. */
+export function ommsHomeDir() {
+    return join(homedir(), ".omms");
+}
+/** Expands a leading `~` to the home folder. */
+export function expandPath(path) {
+    if (path.startsWith("~/")) {
+        return join(homedir(), path.slice(2));
+    }
+    if (path === "~") {
+        return homedir();
+    }
+    return path;
+}
+/** The global store folder: the config's `storagePath`, or the default `~/.omms/data`. */
+export function storagePathFrom(fileConfig) {
+    return fileConfig.storagePath ? expandPath(fileConfig.storagePath) : resolveDefaultStoragePath();
+}
+/**
+ * Keeps skills.db and the embedding model cache in the global storage path when a
+ * project config or the active space moves `storagePath` (ADR-036, ADR-041).
+ */
+export function withSkillStorage(config, global) {
+    const path = storagePathFrom(global);
+    return { ...config, skillStoragePath: path === config.storagePath ? undefined : path };
+}

package/dist/services/spaces/store-handles.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Store handles that must be reset when the storage folder changes (ADR-041, design D4).
+ *
+ * A long-lived store object (a connection pool, a manager that caches its database path)
+ * registers here once, on the line that creates it. `config.ts` calls `resetStoreHandles()`
+ * when a config reload changes `storagePath`, which happens when the active memory space
+ * changes. This module imports nothing, so config can use it without an import cycle.
+ */
+type ResetResult = void | Promise<unknown>;
+/**
+ * Registers `target` for a reset on a storage change and returns it, so the call can wrap
+ * the line that creates a singleton. `reset` defaults to `target.reset()`.
+ */
+export declare function resettable<T>(name: string, target: T, reset?: (target: T) => ResetResult): T;
+/** The names of the registered store handles. A test uses it to see that none is missing. */
+export declare function registeredStoreResets(): string[];
+/**
+ * Resets every registered handle. The synchronous part of each reset runs before this returns,
+ * so a store call made right after sees a fresh handle. The promise ends when every connection
+ * to the old folder is closed. A new connection waits for the close (see TursoConnectionManager).
+ */
+export declare function resetStoreHandles(): Promise<void>;
+export {};

package/dist/services/spaces/store-handles.js

@@ -0,0 +1,40 @@
+/**
+ * Store handles that must be reset when the storage folder changes (ADR-041, design D4).
+ *
+ * A long-lived store object (a connection pool, a manager that caches its database path)
+ * registers here once, on the line that creates it. `config.ts` calls `resetStoreHandles()`
+ * when a config reload changes `storagePath`, which happens when the active memory space
+ * changes. This module imports nothing, so config can use it without an import cycle.
+ */
+const resets = new Map();
+/**
+ * Registers `target` for a reset on a storage change and returns it, so the call can wrap
+ * the line that creates a singleton. `reset` defaults to `target.reset()`.
+ */
+export function resettable(name, target, reset = (item) => item.reset()) {
+    resets.set(name, () => reset(target));
+    return target;
+}
+/** The names of the registered store handles. A test uses it to see that none is missing. */
+export function registeredStoreResets() {
+    return [...resets.keys()];
+}
+/**
+ * Resets every registered handle. The synchronous part of each reset runs before this returns,
+ * so a store call made right after sees a fresh handle. The promise ends when every connection
+ * to the old folder is closed. A new connection waits for the close (see TursoConnectionManager).
+ */
+export function resetStoreHandles() {
+    const pending = [];
+    for (const reset of resets.values()) {
+        try {
+            const result = reset();
+            if (result)
+                pending.push(result);
+        }
+        catch (error) {
+            pending.push(Promise.reject(error));
+        }
+    }
+    return Promise.allSettled(pending).then(() => undefined);
+}

package/dist/services/tag-prefix-migration.js

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "
 import { basename, dirname, isAbsolute, join, relative } from "node:path";
 import { CONFIG, getExplicitContainerTagPrefix } from "../config.js";
 import { log } from "./logger.js";
+import { writeBackupManifest } from "./spaces/backup.js";
 import { copyFilesWithVerification, timestampSlug, walkTree, } from "./legacy-migration.js";
 import { countOpencodePrefixedRows, enumerateShardTargets, FROM_PREFIX_WITH_SEP, } from "./tag-prefix-scan.js";
 import { withCrossProcessWriteLock } from "./turso/cross-process-write-lock.js";
@@ -35,7 +36,6 @@ const FROM_PREFIX = "opencode";
 const TO_PREFIX = "omms";
 const TO_PREFIX_WITH_SEP = "omms_";
 const METADATA_DB_NAME = "metadata.db";
-const MANIFEST_FILE = "manifest.json";
 const COMPLETION_TABLE = "tag_prefix_migration";
 const SHARD_MARKER_TABLE = "shard_metadata";
 const BACKUPS_DIR_NAME = "backups";
@@ -310,13 +310,13 @@ async function createVerifiedBackup(storePath, targets) {
         manifest.push(...copied);
     }
     manifest.push(...copyFilesWithVerification(storePath, backupRoot, remaining));
-    writeFileSync(join(backupRoot, MANIFEST_FILE), JSON.stringify({
+    writeBackupManifest(backupRoot, {
         createdAt: new Date().toISOString(),
         kind: "tag-prefix-migration",
         source: storePath,
         fileCount: manifest.length,
         files: manifest,
-    }, null, 2), "utf-8");
+    });
     return backupRoot;
 }
 /**

package/dist/services/turso/connection-manager.d.ts

@@ -1,5 +1,7 @@
 import { createClient } from "@libsql/client";
 import { TursoDb } from "./turso-db.js";
+import { resettable } from "../spaces/store-handles.js";
+export { resettable };
 export declare class TursoConnectionManager {
     private readonly clientFactory;
     private readonly connections;

package/dist/services/turso/connection-manager.js

@@ -5,6 +5,8 @@ import { CONFIG } from "../../config.js";
 import { log } from "../logger.js";
 import { collectReleasedSqliteHandles } from "./sqlite-handle-release.js";
 import { TursoDb } from "./turso-db.js";
+import { resettable } from "../spaces/store-handles.js";
+export { resettable };
 function toFileUrl(dbPath) {
     return dbPath.startsWith("file:") ? dbPath : `file:${dbPath}`;
 }
@@ -164,4 +166,4 @@ export class TursoConnectionManager {
         this.pending.clear();
     }
 }
-export const tursoConnectionManager = new TursoConnectionManager();
+export const tursoConnectionManager = resettable("connections", new TursoConnectionManager(), (m) => m.closeAll());

package/dist/services/turso/ready.js

@@ -1,6 +1,7 @@
 import { runLegacyTursoMigration } from "./legacy-migrator.js";
 import { runStartupTagPrefixGate } from "../tag-prefix-migration.js";
 import { tursoShardManager } from "./shard-manager.js";
+import { resettable } from "./connection-manager.js";
 import { log } from "../logger.js";
 let initPromise = null;
 let isReady = false;
@@ -34,3 +35,4 @@ export function resetTursoReady() {
     isReady = false;
     initPromise = null;
 }
+resettable("turso-ready", null, resetTursoReady);

package/dist/services/turso/shard-manager.js

@@ -2,7 +2,7 @@ import { join, basename, resolve, relative } from "node:path";
 import { existsSync, renameSync, unlinkSync } from "node:fs";
 import { CONFIG } from "../../config.js";
 import { assertSafeScopeHash } from "../memory-scope.js";
-import { tursoConnectionManager } from "./connection-manager.js";
+import { resettable, tursoConnectionManager } from "./connection-manager.js";
 import { log } from "../logger.js";
 import { assertNoTursoMigrationInProgress } from "./operation-lock.js";
 import { withCrossProcessWriteLock } from "./cross-process-write-lock.js";
@@ -493,4 +493,4 @@ export class TursoShardManager {
         return this.rowToShardInfo(updated);
     }
 }
-export const tursoShardManager = new TursoShardManager();
+export const tursoShardManager = resettable("shards", new TursoShardManager());

package/dist/services/user-profile/user-profile-manager.js

@@ -1,6 +1,6 @@
 import { join } from "node:path";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { tursoConnectionManager } from "../turso/connection-manager.js";
+import { resettable, tursoConnectionManager } from "../turso/connection-manager.js";
 import { CONFIG } from "../../config.js";
 import { hasEnoughWorkflowSteps } from "../../core/extraction.js";
 import { completeStructured, resolveHostProfileModel } from "./profile-model.js";
@@ -70,24 +70,24 @@ export const USER_PROFILES_DB_NAME = "user-profiles.db";
 const COLD_BUFFER_DEFAULT_KEY = "__unattributed__";
 export class UserProfileManager {
     db = null;
-    dbPath;
+    dbPath = "";
     initPromise = null;
     // Cold-start buffers are keyed by profileId so items observed for one user never
     // drain into another user's merge (cross-user contamination). The unattributed bucket
     // (COLD_BUFFER_DEFAULT_KEY) only holds items from merges that ran without a profileId.
     coldBuffers;
-    coldBufferPath;
+    coldBufferPath = "";
     dedupCheckedCache = new Set();
     constructor() {
-        this.dbPath = join(CONFIG.storagePath || "", USER_PROFILES_DB_NAME);
-        this.coldBufferPath = join(CONFIG.storagePath || "", "cold-buffer.json");
-        this.coldBuffers = this.loadColdBuffers();
+        this.reset();
     }
     reset() {
         this.db = null;
         this.initPromise = null;
+        this.dedupCheckedCache.clear();
         this.dbPath = join(CONFIG.storagePath || "", USER_PROFILES_DB_NAME);
         this.coldBufferPath = join(CONFIG.storagePath || "", "cold-buffer.json");
+        this.coldBuffers = this.loadColdBuffers();
     }
     async initialize() {
         if (this.initPromise) {
@@ -1602,4 +1602,4 @@ Generate a concise, abstract description of the user's general behavioral tenden
         return parsed.description || null;
     }
 }
-export const userProfileManager = new UserProfileManager();
+export const userProfileManager = resettable("user-profiles", new UserProfileManager());

package/dist/services/user-prompt/user-prompt-manager.js

@@ -1,5 +1,5 @@
 import { join } from "node:path";
-import { tursoConnectionManager } from "../turso/connection-manager.js";
+import { resettable, tursoConnectionManager } from "../turso/connection-manager.js";
 import { CONFIG } from "../../config.js";
 import { isTrivialPrompt } from "../../core/trivial-prompt.js";
 const RECENT_LEARNING_WINDOW_MS = 7 * 86_400_000;
@@ -340,4 +340,4 @@ export class UserPromptManager {
         };
     }
 }
-export const userPromptManager = new UserPromptManager();
+export const userPromptManager = resettable("user-prompts", new UserPromptManager());

package/dist/services/web-route-modules.d.ts

@@ -1,5 +1,6 @@
 import { type RouteResult } from "./chat/chat-routes.js";
 import type { SkillRouteContext } from "./skill-routes.js";
+export { spaceStatus } from "./space-routes.js";
 /**
  * Route modules that live outside web-server.ts, which sits at its size
  * ceiling. Each returns undefined for paths it does not own. The request body

package/dist/services/web-route-modules.js

@@ -1,6 +1,8 @@
 import { routeChat } from "./chat/chat-routes.js";
 import { routeMemoryHosts } from "./memory-host-routes.js";
 import { routeProfileCleanup } from "./profile-cleanup-routes.js";
+import { routeSpaces } from "./space-routes.js";
+export { spaceStatus } from "./space-routes.js";
 /**
  * Route modules that live outside web-server.ts, which sits at its size
  * ceiling. Each returns undefined for paths it does not own. The request body
@@ -20,5 +22,8 @@ export async function routeModules(path, method, url, req, ctx) {
         const { routeSkills } = await import("./skill-routes.js");
         return routeSkills(path, method, url, readBody, ctx);
     }
+    const spaces = await routeSpaces(path, method, readBody, ctx.cwd);
+    if (spaces !== undefined)
+        return spaces;
     return routeChat(path, method, readBody, config);
 }

package/dist/services/web-server.js

@@ -15,7 +15,7 @@ import { NODE_HTTP_IDLE_TIMEOUT_MS } from "./request-timeouts.js";
 import { testReranker } from "./reranker-test.js";
 import { setSingleFlightInterval } from "./single-flight.js";
 import { handleListTags, handleListKeywords, handleListMemories, handleAddMemory, handleDeleteMemory, handleBulkDelete, handleUpdateMemory, handleSearch, handleStats, handlePinMemory, handleUnpinMemory, handleRunCleanup, handleRunDeduplication, handleDetectMigration, handleRunMigration, handleDetectTagMigration, handleRunTagMigrationBatch, handleGetTagMigrationProgress, handleDeletePrompt, handleBulkDeletePrompts, handleGetUserProfile, handleGetProfileChangelog, handleGetProfileSnapshot, handleRefreshProfile, handleUpdateProfileItem, } from "./api-handlers.js";
-import { routeModules } from "./web-route-modules.js";
+import { routeModules, spaceStatus } from "./web-route-modules.js";
 const isBun = typeof globalThis.Bun !== "undefined";
 const MIN_FAILED_TAKEOVERS = 3;
 /** A busy owner can answer late. Two seconds was short enough to call a live owner dead. */
@@ -931,6 +931,7 @@ export class WebServer {
                     isLocal: isLoopbackAddress(remoteAddress),
                     instance: PROCESS_INSTANCE,
                     update: this.webUpdate?.status() ?? NO_UPDATE,
+                    activeSpace: spaceStatus(this.config.directory ?? process.cwd()),
                 });
             }
             if ((path === "/api/web/stop" || path === "/api/web/restart") && method === "POST") {

package/dist/v2/adapter.d.ts

@@ -1,5 +1,61 @@
 import type { Context } from "@opencode/plugin/promise/plugin";
 import type { V2MemoryBridge } from "./memory-bridge.js";
+export declare const memoryInput: {
+    readonly type: "object";
+    readonly properties: {
+        readonly mode: {
+            readonly type: "string";
+            readonly enum: readonly ["add", "search", "profile", "list", "forget", "help", "migrate", "list-shards", "export", "import", "space"];
+        };
+        readonly content: {
+            readonly type: "string";
+        };
+        readonly query: {
+            readonly type: "string";
+        };
+        readonly tags: {
+            readonly type: "string";
+        };
+        readonly type: {
+            readonly type: "string";
+        };
+        readonly memoryId: {
+            readonly type: "string";
+        };
+        readonly limit: {
+            readonly type: "number";
+        };
+        readonly scope: {
+            readonly type: "string";
+            readonly enum: readonly ["project", "all-projects"];
+        };
+        readonly fromPath: {
+            readonly type: "string";
+        };
+        readonly fromHash: {
+            readonly type: "string";
+        };
+        readonly outputPath: {
+            readonly type: "string";
+        };
+        readonly inputPath: {
+            readonly type: "string";
+        };
+        readonly dryRun: {
+            readonly type: "boolean";
+        };
+        readonly allowLinkedSource: {
+            readonly type: "boolean";
+        };
+        readonly spaceAction: {
+            readonly type: "string";
+        };
+        readonly spaceName: {
+            readonly type: "string";
+        };
+    };
+    readonly additionalProperties: false;
+};
 /** Per-session state is bounded so long-running servers cannot grow it without limit. */
 export declare const MAX_TRACKED_SESSIONS = 256;
 /** Session ids remembered as already seen by this process, for the first-prompt rule. */

package/dist/v2/adapter.js

@@ -6,7 +6,7 @@ import { utf8ByteLength } from "../utils/context-limit.js";
 import { eventBelongsToLocation, legacyToolResult, toLegacyEvent } from "./legacy-client.js";
 import { createRecallReporter } from "./recall-reporter.js";
 import { createSessionParents } from "./session-parent.js";
-const memoryInput = {
+export const memoryInput = {
     type: "object",
     properties: {
         mode: {
@@ -22,6 +22,7 @@ const memoryInput = {
                 "list-shards",
                 "export",
                 "import",
+                "space",
             ],
         },
         content: { type: "string" },
@@ -37,6 +38,8 @@ const memoryInput = {
         inputPath: { type: "string" },
         dryRun: { type: "boolean" },
         allowLinkedSource: { type: "boolean" },
+        spaceAction: { type: "string" },
+        spaceName: { type: "string" },
     },
     additionalProperties: false,
 };