@hasna/mementos 0.14.86 → 0.14.88

package/dist/project-registration.js

@@ -152,11 +152,119 @@ var init_retired_storage_mode = __esm(() => {
   ];
 });
 
-// src/storage.ts
-import { Database } from "bun:sqlite";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+// ../../node_modules/.bun/@hasna+paths@0.1.0/node_modules/@hasna/paths/dist/index.js
 import { homedir } from "os";
 import { join } from "path";
+function assertApp(app) {
+  if (typeof app !== "string" || app.length === 0) {
+    throw new TypeError("paths: app must be a non-empty string");
+  }
+  if (!APP_SLUG_RE.test(app)) {
+    throw new TypeError(`paths: invalid app slug "${app}" \u2014 expected lowercase kebab-case ([a-z0-9]+(-[a-z0-9]+)*)`);
+  }
+}
+function envOf(options) {
+  return options.env ?? process.env;
+}
+function envValue(options, kind) {
+  const value = envOf(options)[KIND_ENV[kind]];
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function isMacOS(platform) {
+  return platform === "darwin";
+}
+function baseDir(kind, options) {
+  const override = envValue(options, kind);
+  if (override)
+    return override;
+  const home = options.home ?? homedir();
+  const platform = options.platform ?? process.platform;
+  if (isMacOS(platform)) {
+    switch (kind) {
+      case "config":
+      case "data":
+        return join(home, "Library", "Application Support", "Hasna");
+      case "cache":
+        return join(home, "Library", "Caches", "Hasna");
+      case "state":
+        return join(home, "Library", "Logs", "Hasna");
+    }
+  }
+  switch (kind) {
+    case "config":
+      return join(home, ".config", "hasna");
+    case "data":
+      return join(home, ".local", "share", "hasna");
+    case "state":
+      return join(home, ".local", "state", "hasna");
+    case "cache":
+      return join(home, ".cache", "hasna");
+  }
+}
+function resolvePath(kind, options) {
+  assertApp(options.app);
+  const appSegment = options.internal === true ? join("internal", options.app) : options.app;
+  return join(baseDir(kind, options), appSegment);
+}
+function dataDir(options) {
+  return resolvePath("data", options);
+}
+var KIND_ENV, APP_SLUG_RE;
+var init_dist = __esm(() => {
+  KIND_ENV = {
+    config: "HASNA_CONFIG_HOME",
+    data: "HASNA_DATA_HOME",
+    state: "HASNA_STATE_HOME",
+    cache: "HASNA_CACHE_HOME"
+  };
+  APP_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+});
+
+// src/lib/paths.ts
+import { existsSync } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join2, resolve } from "path";
+function effectiveHome() {
+  return process.env["HOME"] || process.env["USERPROFILE"] || homedir2() || "/tmp";
+}
+function legacyDataRoot() {
+  return join2(effectiveHome(), ".hasna", "mementos");
+}
+function resolverDataRoot() {
+  return dataDir({
+    app: "mementos",
+    home: process.env["HOME"] || process.env["USERPROFILE"] || undefined
+  });
+}
+function adoptResolverDataRoot(resolved, env = process.env) {
+  const dataOverride = env.HASNA_DATA_HOME;
+  if (typeof dataOverride === "string" && dataOverride.trim().length > 0)
+    return true;
+  return existsSync(join2(resolved, "mementos.db"));
+}
+function exactDataRoot() {
+  for (const key of ["HASNA_MEMENTOS_HOME", "MEMENTOS_HOME"]) {
+    const dir = process.env[key]?.trim();
+    if (dir)
+      return resolve(dir);
+  }
+  return;
+}
+function getDataRoot() {
+  const exact = exactDataRoot();
+  if (exact)
+    return exact;
+  const resolved = resolverDataRoot();
+  return adoptResolverDataRoot(resolved) ? resolve(resolved) : resolve(legacyDataRoot());
+}
+var init_paths = __esm(() => {
+  init_dist();
+});
+
+// src/storage.ts
+import { Database } from "bun:sqlite";
+import { existsSync as existsSync2, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join as join3 } from "path";
 import { fileURLToPath } from "url";
 import { Worker } from "worker_threads";
 import pg from "pg";
@@ -415,7 +523,7 @@ function readEnv(name) {
   return value ? value : null;
 }
 function readConfigFile() {
-  if (!existsSync(STORAGE_CONFIG_PATH)) {
+  if (!existsSync2(STORAGE_CONFIG_PATH)) {
     return {};
   }
   try {
@@ -677,11 +785,7 @@ function saveStorageConfig(config) {
 function getConfiguredConnectionString() {
   return getStorageDatabaseUrl() ?? undefined;
 }
-function getStorageConnectionString(dbName = "mementos") {
-  assertNoLegacyStorageMode2();
-  if (!isServerContext()) {
-    throw new Error("Refusing to construct an RDS Postgres DSN outside the mementos-serve server. " + "The raw database DSN is NEVER distributed to client machines. " + "Clients must use the HTTP API: set HASNA_MEMENTOS_API_URL and " + "HASNA_MEMENTOS_API_KEY (and unset HASNA_MEMENTOS_DATABASE_URL).");
-  }
+function resolveConfiguredConnectionString(dbName) {
   const envConnectionString = getConfiguredConnectionString();
   if (envConnectionString) {
     const validation = validatePostgresConnectionString(envConnectionString);
@@ -700,7 +804,7 @@ function getStorageConnectionString(dbName = "mementos") {
     missing.push("storage.rds.username");
   }
   if (missing.length > 0) {
-    throw new Error(`Remote storage database is not configured. Missing ${missing.join(", ")}. Set HASNA_MEMENTOS_DATABASE_URL or configure ~/.hasna/mementos/storage/config.json.`);
+    throw new Error(`Remote storage database is not configured. Missing ${missing.join(", ")}. Set HASNA_MEMENTOS_DATABASE_URL or configure ${STORAGE_CONFIG_PATH}.`);
   }
   const password = process.env[password_env];
   if (!password) {
@@ -709,6 +813,17 @@ function getStorageConnectionString(dbName = "mementos") {
   const sslParam = ssl ? "?sslmode=require" : "";
   return `postgres://${username}:${encodeURIComponent(password)}@${host}:${port}/${dbName}${sslParam}`;
 }
+function getStorageConnectionString(dbName = "mementos") {
+  assertNoLegacyStorageMode2();
+  if (!isServerContext()) {
+    throw new Error("Refusing to construct an RDS Postgres DSN outside the mementos-serve server. " + "The raw database DSN is NEVER distributed to client machines. " + "Clients must use the HTTP API: set HASNA_MEMENTOS_API_URL and " + "HASNA_MEMENTOS_API_KEY (and unset HASNA_MEMENTOS_DATABASE_URL).");
+  }
+  return resolveConfiguredConnectionString(dbName);
+}
+function getStorageConnectionStringForOperator(dbName = "mementos") {
+  assertNoLegacyStorageMode2();
+  return resolveConfiguredConnectionString(dbName);
+}
 function isSyncExcludedTable(table) {
   return SYNC_EXCLUDED_TABLE_PATTERNS.some((pattern) => pattern.test(table));
 }
@@ -878,6 +993,7 @@ CREATE TABLE IF NOT EXISTS _sync_meta (
 var init_storage = __esm(() => {
   init_backend();
   init_retired_storage_mode();
+  init_paths();
   PgSyncPool = class PgSyncPool {
     worker;
     status;
@@ -895,12 +1011,12 @@ var init_storage = __esm(() => {
       const ext = import.meta.url.endsWith(".ts") ? ".ts" : ".js";
       const here = fileURLToPath(new URL(".", import.meta.url));
       const candidates = [
-        join(here, `pg-sync-worker${ext}`),
-        join(here, "..", `pg-sync-worker${ext}`),
-        join(here, "..", "..", `pg-sync-worker${ext}`)
+        join3(here, `pg-sync-worker${ext}`),
+        join3(here, "..", `pg-sync-worker${ext}`),
+        join3(here, "..", "..", `pg-sync-worker${ext}`)
       ];
       for (const candidate of candidates) {
-        if (existsSync(candidate))
+        if (existsSync2(candidate))
           return candidate;
       }
       return candidates[0];
@@ -988,7 +1104,7 @@ var init_storage = __esm(() => {
   MEMENTOS_STORAGE_FALLBACK_ENV = {
     databaseUrl: "MEMENTOS_DATABASE_URL"
   };
-  LOCAL_DATA_DIR = join(homedir(), ".hasna", "mementos");
+  LOCAL_DATA_DIR = getDataRoot();
   DEFAULT_STORAGE_CONFIG = {
     rds: {
       host: "",
@@ -1003,8 +1119,8 @@ var init_storage = __esm(() => {
       schedule_minutes: 0
     }
   };
-  STORAGE_CONFIG_DIR = join(LOCAL_DATA_DIR, "storage");
-  STORAGE_CONFIG_PATH = join(STORAGE_CONFIG_DIR, "config.json");
+  STORAGE_CONFIG_DIR = join3(LOCAL_DATA_DIR, "storage");
+  STORAGE_CONFIG_PATH = join3(STORAGE_CONFIG_DIR, "config.json");
   DATABASE_ENV_NAMES = [
     { name: MEMENTOS_STORAGE_ENV.databaseUrl, deprecated: false },
     { name: MEMENTOS_STORAGE_FALLBACK_ENV.databaseUrl, deprecated: false }
@@ -1030,7 +1146,7 @@ var init_storage = __esm(() => {
 
 // src/db/api-mode.ts
 import { tmpdir } from "os";
-import { join as join2 } from "path";
+import { join as join4 } from "path";
 import { writeFileSync as writeFileSync2, unlinkSync } from "fs";
 import { randomUUID } from "crypto";
 function firstEnv2(keys) {
@@ -1140,7 +1256,7 @@ x-api-key: ${cfg.apiKey}
   ];
   let bodyFile;
   if (hasBody) {
-    bodyFile = join2(tmpdir(), `mem-req-${process.pid}-${randomUUID()}.json`);
+    bodyFile = join4(tmpdir(), `mem-req-${process.pid}-${randomUUID()}.json`);
     writeFileSync2(bodyFile, JSON.stringify(body), { mode: 384 });
     args.push("--data-binary", `@${bodyFile}`);
   }
@@ -2660,18 +2776,18 @@ __export(exports_database, {
   escapeLikePrefix: () => escapeLikePrefix,
   closeDatabase: () => closeDatabase
 });
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, cpSync } from "fs";
-import { dirname, join as join3, resolve } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, cpSync } from "fs";
+import { dirname, join as join5, resolve as resolve2 } from "path";
 function isInMemoryDb(path) {
   return path === ":memory:" || path.startsWith("file::memory:");
 }
 function findNearestMementosDb(startDir) {
-  let dir = resolve(startDir);
+  let dir = resolve2(startDir);
   const home = process.env["HOME"] || process.env["USERPROFILE"] || "~";
-  const legacyHomeDb = resolve(home, ".mementos", "mementos.db");
+  const legacyHomeDb = resolve2(home, ".mementos", "mementos.db");
   while (true) {
-    const candidate = join3(dir, ".mementos", "mementos.db");
-    if (existsSync2(candidate) && resolve(candidate) !== legacyHomeDb)
+    const candidate = join5(dir, ".mementos", "mementos.db");
+    if (existsSync3(candidate) && resolve2(candidate) !== legacyHomeDb)
       return candidate;
     const parent = dirname(dir);
     if (parent === dir)
@@ -2681,9 +2797,9 @@ function findNearestMementosDb(startDir) {
   return null;
 }
 function findGitRoot(startDir) {
-  let dir = resolve(startDir);
+  let dir = resolve2(startDir);
   while (true) {
-    if (existsSync2(join3(dir, ".git")))
+    if (existsSync3(join5(dir, ".git")))
       return dir;
     const parent = dirname(dir);
     if (parent === dir)
@@ -2694,10 +2810,10 @@ function findGitRoot(startDir) {
 }
 function migrateGlobalDir() {
   const home = process.env["HOME"] || process.env["USERPROFILE"] || "~";
-  const newDir = join3(home, ".hasna", "mementos");
-  const oldDir = join3(home, ".mementos");
-  if (!existsSync2(newDir) && existsSync2(oldDir)) {
-    mkdirSync2(join3(home, ".hasna"), { recursive: true });
+  const newDir = getDataRoot();
+  const oldDir = join5(home, ".mementos");
+  if (!existsSync3(newDir) && existsSync3(oldDir)) {
+    mkdirSync2(dirname(newDir), { recursive: true });
     cpSync(oldDir, newDir, { recursive: true });
   }
 }
@@ -2714,18 +2830,17 @@ function getDbPath() {
   if (process.env["MEMENTOS_DB_SCOPE"] === "project") {
     const gitRoot = findGitRoot(cwd);
     if (gitRoot) {
-      return join3(gitRoot, ".mementos", "mementos.db");
+      return join5(gitRoot, ".mementos", "mementos.db");
     }
   }
   migrateGlobalDir();
-  const home = process.env["HOME"] || process.env["USERPROFILE"] || "~";
-  return join3(home, ".hasna", "mementos", "mementos.db");
+  return join5(getDataRoot(), "mementos.db");
 }
 function ensureDir(filePath) {
   if (isInMemoryDb(filePath))
     return;
-  const dir = dirname(resolve(filePath));
-  if (!existsSync2(dir)) {
+  const dir = dirname(resolve2(filePath));
+  if (!existsSync3(dir)) {
     mkdirSync2(dir, { recursive: true });
   }
 }
@@ -2863,6 +2978,7 @@ var init_database = __esm(() => {
   init_storage();
   init_api_mode();
   init_migrations();
+  init_paths();
   ALLOWED_TABLES = new Set([
     "memories",
     "agents",
@@ -2882,7 +2998,7 @@ var init_database = __esm(() => {
 
 // src/project-registration/authority.ts
 import { createHash as createHash2 } from "crypto";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve3 } from "path";
 
 // src/db/projects.ts
 init_database();
@@ -2891,13 +3007,13 @@ import { createHash } from "crypto";
 
 // src/lib/package-version.ts
 import { readFileSync as readFileSync2 } from "fs";
-import { dirname as dirname2, join as join4 } from "path";
+import { dirname as dirname2, join as join6 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function getMementosPackageVersion() {
   const here = dirname2(fileURLToPath2(import.meta.url));
   for (const candidate of [
-    join4(here, "..", "..", "package.json"),
-    join4(here, "..", "package.json")
+    join6(here, "..", "..", "package.json"),
+    join6(here, "..", "package.json")
   ]) {
     try {
       const parsed = JSON.parse(readFileSync2(candidate, "utf8"));
@@ -3750,7 +3866,7 @@ function ownedPath(target) {
   }
   const path = target.withOwnedPath((value) => value);
   requireString(path, "target path", { max: 4096 });
-  if (path !== resolve2(path)) {
+  if (path !== resolve3(path)) {
     throw new MementosProjectRegistrationError("MEMENTOS_PROJECT_REGISTRATION_INVALID_INPUT", "target path must already be canonical and absolute");
   }
   return path;
@@ -5443,12 +5559,22 @@ function createMemory(input, dedupeMode = "merge", db) {
   const effectiveMode = dedupeMode === "overwrite" ? "merge" : dedupeMode === "version-fork" ? "create" : dedupeMode;
   if (effectiveMode === "error") {
     const existing = d.query(`SELECT id, agent_id, updated_at FROM memories
-       WHERE key = ? AND scope = ? AND COALESCE(project_id, '') = ? AND status = 'active'
+       WHERE key = ? AND scope = ? AND COALESCE(project_id, '') = ?
        LIMIT 1`).get(input.key, input.scope || "private", input.project_id || "");
     if (existing) {
       throw new MemoryConflictError(input.key, existing);
     }
   }
+  if (effectiveMode === "create") {
+    const existing = d.query(`SELECT id, agent_id, updated_at FROM memories
+       WHERE key = ? AND scope = ?
+         AND COALESCE(agent_id, '') = ?
+         AND COALESCE(project_id, '') = ?
+         AND COALESCE(session_id, '') = ?`).get(input.key, input.scope || "private", input.agent_id || "", input.project_id || "", input.session_id || "");
+    if (existing) {
+      throw new MemoryConflictError(input.key, existing);
+    }
+  }
   if (effectiveMode === "merge") {
     const existing = d.query(`SELECT id, version FROM memories
          WHERE key = ? AND scope = ?
@@ -5876,6 +6002,17 @@ function updateMemory(id, input, db) {
   if (existing.version !== input.version) {
     throw new VersionConflictError(id, input.version, existing.version);
   }
+  if (input.scope !== undefined && input.scope !== existing.scope) {
+    const conflict = d.query(`SELECT id, agent_id, updated_at FROM memories
+         WHERE key = ? AND scope = ?
+           AND COALESCE(agent_id, '') = ?
+           AND COALESCE(project_id, '') = ?
+           AND COALESCE(session_id, '') = ?
+           AND id != ?`).get(existing.key, input.scope, existing.agent_id || "", existing.project_id || "", existing.session_id || "", memoryId);
+    if (conflict) {
+      throw new MemoryConflictError(existing.key, conflict);
+    }
+  }
   const sets = ["version = version + 1", "updated_at = ?"];
   const params = [now()];
   if (input.value !== undefined) {