@hasna/mementos 0.10.1 → 0.10.3

package/dist/cli/index.js

@@ -6,39 +6,60 @@ var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
-var __moduleCache = /* @__PURE__ */ new WeakMap;
 var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
   if (entry)
     return entry;
   entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
   __moduleCache.set(from, entry);
   return entry;
 };
+var __moduleCache;
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -2543,6 +2564,26 @@ CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_agent ON session_memory_jobs(
 CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_project ON session_memory_jobs(project_id);
 CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_session ON session_memory_jobs(session_id);
 INSERT OR IGNORE INTO _migrations (id) VALUES (13);
+`,
+    `
+ALTER TABLE resource_locks RENAME TO resource_locks_old;
+CREATE TABLE resource_locks (
+  id TEXT PRIMARY KEY,
+  resource_type TEXT NOT NULL CHECK(resource_type IN ('project', 'memory', 'entity', 'agent', 'connector', 'file')),
+  resource_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+  lock_type TEXT NOT NULL DEFAULT 'exclusive' CHECK(lock_type IN ('advisory', 'exclusive')),
+  locked_at TEXT NOT NULL DEFAULT (datetime('now')),
+  expires_at TEXT NOT NULL
+);
+INSERT INTO resource_locks SELECT * FROM resource_locks_old;
+DROP TABLE resource_locks_old;
+CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
+  ON resource_locks(resource_type, resource_id)
+  WHERE lock_type = 'exclusive';
+CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id);
+CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at);
+INSERT OR IGNORE INTO _migrations (id) VALUES (14);
 `
   ];
 });

package/dist/db/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmCtC,wBAAgB,SAAS,IAAI,MAAM,CAkBlC;AAsYD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAerD;AA+BD,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAef"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmCtC,wBAAgB,SAAS,IAAI,MAAM,CAkBlC;AA6ZD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAerD;AA+BD,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAef"}

package/dist/db/locks.d.ts

@@ -1,5 +1,5 @@
 import { Database } from "bun:sqlite";
-export type ResourceType = "project" | "memory" | "entity" | "agent" | "connector";
+export type ResourceType = "project" | "memory" | "entity" | "agent" | "connector" | "file";
 export type LockType = "advisory" | "exclusive";
 export interface ResourceLock {
     id: string;

package/dist/db/locks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../src/db/locks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;AACnF,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,QAAsB,EAChC,UAAU,SAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAuDrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAOnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAI3E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,EAAE,CAgBhB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAcrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,YAAY,EAAE,CAS7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAIvD"}
+{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../src/db/locks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAC5F,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,QAAsB,EAChC,UAAU,SAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAuDrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAOnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAI3E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,EAAE,CAgBhB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAcrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,YAAY,EAAE,CAS7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAIvD"}

package/dist/index.js

@@ -457,6 +457,26 @@ CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_agent ON session_memory_jobs(
 CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_project ON session_memory_jobs(project_id);
 CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_session ON session_memory_jobs(session_id);
 INSERT OR IGNORE INTO _migrations (id) VALUES (13);
+`,
+  `
+ALTER TABLE resource_locks RENAME TO resource_locks_old;
+CREATE TABLE resource_locks (
+  id TEXT PRIMARY KEY,
+  resource_type TEXT NOT NULL CHECK(resource_type IN ('project', 'memory', 'entity', 'agent', 'connector', 'file')),
+  resource_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+  lock_type TEXT NOT NULL DEFAULT 'exclusive' CHECK(lock_type IN ('advisory', 'exclusive')),
+  locked_at TEXT NOT NULL DEFAULT (datetime('now')),
+  expires_at TEXT NOT NULL
+);
+INSERT INTO resource_locks SELECT * FROM resource_locks_old;
+DROP TABLE resource_locks_old;
+CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
+  ON resource_locks(resource_type, resource_id)
+  WHERE lock_type = 'exclusive';
+CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id);
+CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at);
+INSERT OR IGNORE INTO _migrations (id) VALUES (14);
 `
 ];
 var _db = null;

package/dist/lib/file-deps.d.ts

@@ -0,0 +1,27 @@
+/**
+ * File dependency graph builder for open-mementos.
+ * Scans a codebase, creates 'file' entities for each source file, and
+ * creates 'depends_on' relations between files based on import/require statements.
+ *
+ * Supports: TypeScript, JavaScript, Python, Go (basic), Rust (basic).
+ */
+import type { Database } from "bun:sqlite";
+export interface FileDepsOptions {
+    root_dir: string;
+    project_id?: string;
+    extensions?: string[];
+    exclude_patterns?: string[];
+    incremental?: boolean;
+}
+export interface FileDepsResult {
+    files_scanned: number;
+    entities_created: number;
+    entities_updated: number;
+    relations_created: number;
+    errors: string[];
+}
+/**
+ * Scan a codebase, create file entities and import-based depends_on relations.
+ */
+export declare function buildFileDependencyGraph(opts: FileDepsOptions, db?: Database): Promise<FileDepsResult>;
+//# sourceMappingURL=file-deps.d.ts.map

package/dist/lib/file-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-deps.d.ts","sourceRoot":"","sources":["../../src/lib/file-deps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAK3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAgFD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,eAAe,EACrB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,cAAc,CAAC,CAwFzB"}

package/dist/mcp/index.js

@@ -1,13 +1,17 @@
 #!/usr/bin/env bun
 // @bun
 var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -514,6 +518,26 @@ CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_agent ON session_memory_jobs(
 CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_project ON session_memory_jobs(project_id);
 CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_session ON session_memory_jobs(session_id);
 INSERT OR IGNORE INTO _migrations (id) VALUES (13);
+`,
+    `
+ALTER TABLE resource_locks RENAME TO resource_locks_old;
+CREATE TABLE resource_locks (
+  id TEXT PRIMARY KEY,
+  resource_type TEXT NOT NULL CHECK(resource_type IN ('project', 'memory', 'entity', 'agent', 'connector', 'file')),
+  resource_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+  lock_type TEXT NOT NULL DEFAULT 'exclusive' CHECK(lock_type IN ('advisory', 'exclusive')),
+  locked_at TEXT NOT NULL DEFAULT (datetime('now')),
+  expires_at TEXT NOT NULL
+);
+INSERT INTO resource_locks SELECT * FROM resource_locks_old;
+DROP TABLE resource_locks_old;
+CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
+  ON resource_locks(resource_type, resource_id)
+  WHERE lock_type = 'exclusive';
+CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id);
+CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at);
+INSERT OR IGNORE INTO _migrations (id) VALUES (14);
 `
   ];
 });
@@ -7627,6 +7651,163 @@ var FORMAT_UNITS = [
 
 // src/mcp/index.ts
 init_hooks();
+
+// src/lib/file-deps.ts
+init_database();
+init_entities();
+init_relations();
+import { readdirSync, readFileSync, statSync, existsSync as existsSync3 } from "fs";
+import { join as join3, resolve as resolve3, relative, dirname as dirname3, extname, basename as basename2 } from "path";
+var DEFAULT_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".py", ".go", ".rs"];
+var DEFAULT_EXCLUDES = ["node_modules", ".git", "dist", "build", ".next", "__pycache__", "target", "vendor"];
+function parseImports(_filePath, content) {
+  const imports = [];
+  const tsImports = [
+    /import\s+(?:.*?\s+from\s+)?['"]([^'"]+)['"]/g,
+    /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
+    /import\s*\(\s*['"]([^'"]+)['"]\s*\)/g
+  ];
+  for (const re of tsImports) {
+    let m2;
+    re.lastIndex = 0;
+    while ((m2 = re.exec(content)) !== null) {
+      const imp = m2[1];
+      if (imp.startsWith("."))
+        imports.push(imp);
+    }
+  }
+  const pyImports = /^(?:from\s+(\.+[\w.]*)|import\s+([\w.]+))/gm;
+  let m;
+  while ((m = pyImports.exec(content)) !== null) {
+    const imp = m[1] || m[2];
+    if (imp && imp.startsWith("."))
+      imports.push(imp);
+  }
+  return [...new Set(imports)];
+}
+function resolveImport(fromFile, importPath, allFiles) {
+  const dir = dirname3(fromFile);
+  const base = resolve3(dir, importPath);
+  if (allFiles.has(base))
+    return base;
+  for (const ext of [".ts", ".tsx", ".js", ".jsx", ".mjs"]) {
+    const withExt = base + ext;
+    if (allFiles.has(withExt))
+      return withExt;
+    const index = join3(base, `index${ext}`);
+    if (allFiles.has(index))
+      return index;
+  }
+  return null;
+}
+function collectFiles(dir, extensions, excludes) {
+  const files = [];
+  function walk(current) {
+    let entries;
+    try {
+      entries = readdirSync(current);
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (excludes.some((e) => entry === e || current.includes(`/${e}/`)))
+        continue;
+      const full = join3(current, entry);
+      let stat;
+      try {
+        stat = statSync(full);
+      } catch {
+        continue;
+      }
+      if (stat.isDirectory()) {
+        walk(full);
+      } else if (extensions.includes(extname(entry))) {
+        files.push(full);
+      }
+    }
+  }
+  walk(resolve3(dir));
+  return files;
+}
+async function buildFileDependencyGraph(opts, db) {
+  const d = db || getDatabase();
+  const result = { files_scanned: 0, entities_created: 0, entities_updated: 0, relations_created: 0, errors: [] };
+  const extensions = opts.extensions ?? DEFAULT_EXTENSIONS;
+  const excludes = opts.exclude_patterns ?? DEFAULT_EXCLUDES;
+  const rootDir = resolve3(opts.root_dir);
+  if (!existsSync3(rootDir)) {
+    result.errors.push(`Directory not found: ${rootDir}`);
+    return result;
+  }
+  const files = collectFiles(rootDir, extensions, excludes);
+  const fileSet = new Set(files);
+  result.files_scanned = files.length;
+  const entityMap = new Map;
+  const existingEntities = listEntities({ type: "file", project_id: opts.project_id, limit: 1e4 }, d);
+  for (const e of existingEntities) {
+    if (e.metadata?.["file_path"]) {
+      entityMap.set(e.metadata["file_path"], e.id);
+    }
+  }
+  for (const filePath of files) {
+    const relPath = relative(rootDir, filePath);
+    const name = basename2(filePath);
+    if (entityMap.has(filePath)) {
+      result.entities_updated++;
+      continue;
+    }
+    try {
+      const entity = createEntity({
+        type: "file",
+        name,
+        description: relPath,
+        project_id: opts.project_id,
+        metadata: { file_path: filePath, rel_path: relPath, ext: extname(filePath), root_dir: rootDir }
+      }, d);
+      entityMap.set(filePath, entity.id);
+      result.entities_created++;
+    } catch (e) {
+      result.errors.push(`Entity creation failed for ${relPath}: ${String(e)}`);
+    }
+  }
+  for (const filePath of files) {
+    const fromId = entityMap.get(filePath);
+    if (!fromId)
+      continue;
+    let content;
+    try {
+      content = readFileSync(filePath, "utf-8");
+    } catch {
+      continue;
+    }
+    const imports = parseImports(filePath, content);
+    for (const imp of imports) {
+      const resolvedPath = resolveImport(filePath, imp, fileSet);
+      if (!resolvedPath)
+        continue;
+      const toId = entityMap.get(resolvedPath);
+      if (!toId || toId === fromId)
+        continue;
+      try {
+        const existing = listRelations({ entity_id: fromId, relation_type: "depends_on", direction: "outgoing" }, d);
+        if (existing.some((r) => r.target_entity_id === toId))
+          continue;
+        createRelation({
+          source_entity_id: fromId,
+          target_entity_id: toId,
+          relation_type: "depends_on",
+          metadata: { import_path: imp, project_id: opts.project_id }
+        }, d);
+        result.relations_created++;
+      } catch (e) {
+        result.errors.push(`Relation failed ${relative(rootDir, filePath)} \u2192 ${relative(rootDir, resolvedPath)}: ${String(e)}`);
+      }
+    }
+  }
+  return result;
+}
+
+// src/mcp/index.ts
 init_built_in_hooks();
 init_webhook_hooks();
 
@@ -10299,6 +10480,26 @@ server.tool("graph_stats", "Get entity and relation counts by type.", {}, async
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("build_file_dep_graph", "Scan a codebase directory and build a file dependency graph: creates 'file' entities and 'depends_on' relations based on import/require statements. Use graph_query to find blast radius of a file change.", {
+  root_dir: exports_external.string().describe("Root directory to scan"),
+  project_id: exports_external.string().optional().describe("Project to associate file entities with"),
+  extensions: exports_external.array(exports_external.string()).optional().describe("File extensions to scan (default: .ts .tsx .js .jsx .py .go .rs)"),
+  exclude_patterns: exports_external.array(exports_external.string()).optional().describe("Directory/file patterns to skip (default: node_modules, dist, .git, etc.)"),
+  incremental: exports_external.boolean().optional().describe("Skip files that already have entities (default: true)")
+}, async (args) => {
+  try {
+    const result = await buildFileDependencyGraph({
+      root_dir: args.root_dir,
+      project_id: args.project_id ? resolvePartialId(getDatabase(), "projects", args.project_id) ?? args.project_id : undefined,
+      extensions: args.extensions,
+      exclude_patterns: args.exclude_patterns,
+      incremental: args.incremental ?? true
+    });
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 var FULL_SCHEMAS = {
   memory_save: {
     description: "Save/upsert a memory. Creates new or merges with existing key.",
@@ -10902,7 +11103,7 @@ server.tool("memory_check_lock", "Check if a memory key is currently write-locke
 });
 server.tool("resource_lock", "Acquire a lock on any resource (project, memory, entity, agent, connector).", {
   agent_id: exports_external.string(),
-  resource_type: exports_external.enum(["project", "memory", "entity", "agent", "connector"]),
+  resource_type: exports_external.enum(["project", "memory", "entity", "agent", "connector", "file"]),
   resource_id: exports_external.string(),
   lock_type: exports_external.enum(["advisory", "exclusive"]).optional().default("exclusive"),
   ttl_seconds: exports_external.number().optional().default(300)
@@ -10928,7 +11129,7 @@ server.tool("resource_unlock", "Release a resource lock.", {
   };
 });
 server.tool("resource_check_lock", "Check active locks on a resource.", {
-  resource_type: exports_external.enum(["project", "memory", "entity", "agent", "connector"]),
+  resource_type: exports_external.enum(["project", "memory", "entity", "agent", "connector", "file"]),
   resource_id: exports_external.string(),
   lock_type: exports_external.enum(["advisory", "exclusive"]).optional()
 }, async (args) => {

package/dist/server/index.js

@@ -1,13 +1,17 @@
 #!/usr/bin/env bun
 // @bun
 var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -509,6 +513,26 @@ CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_agent ON session_memory_jobs(
 CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_project ON session_memory_jobs(project_id);
 CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_session ON session_memory_jobs(session_id);
 INSERT OR IGNORE INTO _migrations (id) VALUES (13);
+`,
+    `
+ALTER TABLE resource_locks RENAME TO resource_locks_old;
+CREATE TABLE resource_locks (
+  id TEXT PRIMARY KEY,
+  resource_type TEXT NOT NULL CHECK(resource_type IN ('project', 'memory', 'entity', 'agent', 'connector', 'file')),
+  resource_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+  lock_type TEXT NOT NULL DEFAULT 'exclusive' CHECK(lock_type IN ('advisory', 'exclusive')),
+  locked_at TEXT NOT NULL DEFAULT (datetime('now')),
+  expires_at TEXT NOT NULL
+);
+INSERT INTO resource_locks SELECT * FROM resource_locks_old;
+DROP TABLE resource_locks_old;
+CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
+  ON resource_locks(resource_type, resource_id)
+  WHERE lock_type = 'exclusive';
+CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id);
+CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at);
+INSERT OR IGNORE INTO _migrations (id) VALUES (14);
 `
   ];
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",