@graphmemory/server 1.3.0 → 1.3.2

package/dist/cli/indexer.js

@@ -13,6 +13,7 @@ const docs_2 = require("../graphs/docs");
 const code_1 = require("../lib/parsers/code");
 const code_2 = require("../graphs/code");
 const watcher_1 = require("../lib/watcher");
+const defaults_1 = require("../lib/defaults");
 const knowledge_1 = require("../graphs/knowledge");
 const task_1 = require("../graphs/task");
 const skill_1 = require("../graphs/skill");
@@ -103,7 +104,7 @@ function createProjectIndexer(docGraph, codeGraph, config, knowledgeGraph, fileI
         const rootChunk = chunks.find(c => c.level === 1);
         const embedText = rootChunk?.title
             ? `${fileId} ${rootChunk.title}`
-            : `${fileId} ${rootChunk?.content.slice(0, 200) ?? ''}`;
+            : `${fileId} ${rootChunk?.content.slice(0, defaults_1.INDEXER_PREVIEW_LEN) ?? ''}`;
         batchInputs.push({ title: embedText, content: '' });
         const embeddings = await (0, embedder_1.embedBatch)(batchInputs, config.docsModelName);
         for (let i = 0; i < chunks.length; i++) {
@@ -207,7 +208,9 @@ function createProjectIndexer(docGraph, codeGraph, config, knowledgeGraph, fileI
     }
     function dispatchAdd(absolutePath) {
         const rel = path_1.default.relative(config.projectDir, absolutePath);
-        if (config.docsInclude && !isExcluded(rel, docsExclude) && micromatch_1.default.isMatch(rel, config.docsInclude)) {
+        if (docGraph && config.docsInclude && !isExcluded(rel, docsExclude) && micromatch_1.default.isMatch(rel, config.docsInclude)) {
+            if (rel.endsWith('.md'))
+                (0, docs_1.clearWikiIndexCache)(config.projectDir);
             enqueueDoc(() => indexDocFile(absolutePath));
         }
         if (codeGraph && config.codeInclude && !isExcluded(rel, codeExclude) && micromatch_1.default.isMatch(rel, config.codeInclude)) {
@@ -220,33 +223,43 @@ function createProjectIndexer(docGraph, codeGraph, config, knowledgeGraph, fileI
     function dispatchRemove(absolutePath) {
         const rel = path_1.default.relative(config.projectDir, absolutePath);
         if (docGraph && config.docsInclude && !isExcluded(rel, docsExclude) && micromatch_1.default.isMatch(rel, config.docsInclude)) {
-            (0, docs_2.removeFile)(docGraph, rel);
-            if (knowledgeGraph)
-                (0, knowledge_1.cleanupProxies)(knowledgeGraph, 'docs', docGraph, config.projectId);
-            if (taskGraph)
-                (0, task_1.cleanupProxies)(taskGraph, 'docs', docGraph, config.projectId);
-            if (skillGraph)
-                (0, skill_1.cleanupProxies)(skillGraph, 'docs', docGraph, config.projectId);
-            process.stderr.write(`[indexer] removed doc  ${rel}\n`);
+            if (rel.endsWith('.md'))
+                (0, docs_1.clearWikiIndexCache)(config.projectDir);
+            // Enqueue removal to avoid racing with in-flight indexDocFile tasks
+            enqueueDoc(async () => {
+                (0, docs_2.removeFile)(docGraph, rel);
+                if (knowledgeGraph)
+                    (0, knowledge_1.cleanupProxies)(knowledgeGraph, 'docs', docGraph, config.projectId);
+                if (taskGraph)
+                    (0, task_1.cleanupProxies)(taskGraph, 'docs', docGraph, config.projectId);
+                if (skillGraph)
+                    (0, skill_1.cleanupProxies)(skillGraph, 'docs', docGraph, config.projectId);
+                process.stderr.write(`[indexer] removed doc  ${rel}\n`);
+            });
         }
         if (codeGraph && config.codeInclude && !isExcluded(rel, codeExclude) && micromatch_1.default.isMatch(rel, config.codeInclude)) {
-            (0, code_2.removeCodeFile)(codeGraph, rel);
-            if (knowledgeGraph)
-                (0, knowledge_1.cleanupProxies)(knowledgeGraph, 'code', codeGraph, config.projectId);
-            if (taskGraph)
-                (0, task_1.cleanupProxies)(taskGraph, 'code', codeGraph, config.projectId);
-            if (skillGraph)
-                (0, skill_1.cleanupProxies)(skillGraph, 'code', codeGraph, config.projectId);
-            process.stderr.write(`[indexer] removed code ${rel}\n`);
+            enqueueCode(async () => {
+                (0, code_2.removeCodeFile)(codeGraph, rel);
+                if (knowledgeGraph)
+                    (0, knowledge_1.cleanupProxies)(knowledgeGraph, 'code', codeGraph, config.projectId);
+                if (taskGraph)
+                    (0, task_1.cleanupProxies)(taskGraph, 'code', codeGraph, config.projectId);
+                if (skillGraph)
+                    (0, skill_1.cleanupProxies)(skillGraph, 'code', codeGraph, config.projectId);
+                process.stderr.write(`[indexer] removed code ${rel}\n`);
+            });
         }
         if (fileIndexGraph && !isExcluded(rel, filesExclude)) {
-            (0, file_index_1.removeFileEntry)(fileIndexGraph, rel);
-            if (knowledgeGraph)
-                (0, knowledge_1.cleanupProxies)(knowledgeGraph, 'files', fileIndexGraph, config.projectId);
-            if (taskGraph)
-                (0, task_1.cleanupProxies)(taskGraph, 'files', fileIndexGraph, config.projectId);
-            if (skillGraph)
-                (0, skill_1.cleanupProxies)(skillGraph, 'files', fileIndexGraph, config.projectId);
+            enqueueFile(async () => {
+                (0, file_index_1.removeFileEntry)(fileIndexGraph, rel);
+                if (knowledgeGraph)
+                    (0, knowledge_1.cleanupProxies)(knowledgeGraph, 'files', fileIndexGraph, config.projectId);
+                if (taskGraph)
+                    (0, task_1.cleanupProxies)(taskGraph, 'files', fileIndexGraph, config.projectId);
+                if (skillGraph)
+                    (0, skill_1.cleanupProxies)(skillGraph, 'files', fileIndexGraph, config.projectId);
+                process.stderr.write(`[indexer] removed file ${rel}\n`);
+            });
         }
     }
     // ---------------------------------------------------------------------------

package/dist/graphs/attachment-types.js

@@ -36,10 +36,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_ATTACHMENTS_PER_ENTITY = exports.MAX_ATTACHMENT_SIZE = void 0;
 exports.scanAttachments = scanAttachments;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const mime_1 = __importDefault(require("mime"));
+/** Maximum size of a single attachment in bytes (10 MB). */
+exports.MAX_ATTACHMENT_SIZE = 10 * 1024 * 1024;
+/** Maximum number of attachments per entity (note/task/skill). */
+exports.MAX_ATTACHMENTS_PER_ENTITY = 20;
 /**
  * Scan the attachments/ subdirectory of an entity directory.
  * Returns metadata for each file found.

package/dist/graphs/code.js

@@ -22,6 +22,8 @@ const code_1 = require("../lib/search/code");
 const files_1 = require("../lib/search/files");
 const bm25_1 = require("../lib/search/bm25");
 const embedding_codec_1 = require("../lib/embedding-codec");
+const graph_persistence_1 = require("../lib/graph-persistence");
+const defaults_1 = require("../lib/defaults");
 // ---------------------------------------------------------------------------
 // CRUD
 // ---------------------------------------------------------------------------
@@ -87,10 +89,10 @@ function resolvePendingImports(graph) {
 }
 /**
  * Resolve pending extends/implements edges after all files have been indexed.
- * Searches the entire graph for nodes matching toName (by symbol name).
+ * When multiple candidates share the same name, prefers the one whose file
+ * is imported by the source file (falls back to first match).
  */
 function resolvePendingEdges(graph) {
-    // Build name → nodeId index for fast lookup
     const nameIndex = new Map();
     graph.forEachNode((id, attrs) => {
         if (attrs.kind === 'class' || attrs.kind === 'interface') {
@@ -99,6 +101,18 @@ function resolvePendingEdges(graph) {
             nameIndex.set(attrs.name, list);
         }
     });
+    // Build file → imported file IDs index for disambiguation
+    const fileImports = new Map();
+    graph.forEachNode((id, attrs) => {
+        if (attrs.kind === 'file') {
+            const imported = new Set();
+            graph.forEachOutEdge(id, (_edge, edgeAttrs, _src, target) => {
+                if (edgeAttrs.kind === 'imports')
+                    imported.add(target);
+            });
+            fileImports.set(id, imported);
+        }
+    });
     let created = 0;
     graph.forEachNode((id, attrs) => {
         if (!attrs.pendingEdges || attrs.pendingEdges.length === 0)
@@ -107,8 +121,20 @@ function resolvePendingEdges(graph) {
         for (const edge of attrs.pendingEdges) {
             const candidates = nameIndex.get(edge.toName);
             if (candidates && candidates.length > 0 && graph.hasNode(edge.from)) {
-                // Use first match (ambiguity is rare in practice)
-                const toId = candidates[0];
+                let toId;
+                if (candidates.length === 1) {
+                    toId = candidates[0];
+                }
+                else {
+                    // Disambiguate: prefer candidate whose file is imported by edge.from's file
+                    const fromFileId = edge.from.split('::')[0];
+                    const imports = fileImports.get(fromFileId);
+                    const match = imports && candidates.find(c => {
+                        const cFileId = c.split('::')[0];
+                        return imports.has(cFileId);
+                    });
+                    toId = match ?? candidates[0];
+                }
                 if (toId !== edge.from && !graph.hasEdge(edge.from, toId)) {
                     graph.addEdgeWithKey(`${edge.from}→${toId}`, edge.from, toId, { kind: edge.kind });
                     created++;
@@ -142,7 +168,7 @@ function getCodeFileMtime(graph, fileId) {
     return graph.getNodeAttribute(nodes[0], 'mtime');
 }
 /** List all indexed files with symbol counts. */
-function listCodeFiles(graph, filter, limit = 20) {
+function listCodeFiles(graph, filter, limit = defaults_1.LIST_LIMIT_SMALL) {
     const files = new Map();
     const lowerFilter = filter?.toLowerCase();
     graph.forEachNode((_, attrs) => {
@@ -182,10 +208,10 @@ function loadCodeGraph(graphMemory, fresh = false, embeddingFingerprint) {
     if (fresh)
         return graph;
     const file = path_1.default.join(graphMemory, 'code.json');
-    if (!fs_1.default.existsSync(file))
+    const data = (0, graph_persistence_1.readJsonWithTmpFallback)(file);
+    if (!data)
         return graph;
     try {
-        const data = JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
         const stored = data.embeddingModel;
         if (embeddingFingerprint && stored !== embeddingFingerprint) {
             process.stderr.write(`[code-graph] Embedding config changed, re-indexing code graph\n`);
@@ -207,7 +233,7 @@ class CodeGraphManager {
     _graph;
     embedFns;
     ext;
-    _bm25Index = new bm25_1.BM25Index((attrs) => `${attrs.name} ${attrs.signature} ${attrs.docComment} ${attrs.body}`);
+    _bm25Index = new bm25_1.BM25Index((attrs) => `${attrs.name} ${attrs.signature} ${attrs.docComment} ${attrs.body.slice(0, defaults_1.BM25_BODY_MAX_CHARS)}`);
     constructor(_graph, embedFns, ext = {}) {
         this._graph = _graph;
         this.embedFns = embedFns;

package/dist/graphs/docs.js

@@ -21,6 +21,8 @@ const docs_1 = require("../lib/search/docs");
 const files_1 = require("../lib/search/files");
 const bm25_1 = require("../lib/search/bm25");
 const embedding_codec_1 = require("../lib/embedding-codec");
+const graph_persistence_1 = require("../lib/graph-persistence");
+const defaults_1 = require("../lib/defaults");
 function createGraph() {
     return new graphology_1.DirectedGraph({ multi: false, allowSelfLoops: false });
 }
@@ -108,7 +110,7 @@ function getFileMtime(graph, fileId) {
         return 0;
     return graph.getNodeAttribute(nodes[0], 'mtime');
 }
-function listFiles(graph, filter, limit = 20) {
+function listFiles(graph, filter, limit = defaults_1.LIST_LIMIT_SMALL) {
     const files = new Map();
     const lowerFilter = filter?.toLowerCase();
     graph.forEachNode((_, attrs) => {
@@ -153,10 +155,10 @@ function loadGraph(graphMemory, fresh = false, embeddingFingerprint) {
     if (fresh)
         return graph;
     const file = path_1.default.join(graphMemory, 'docs.json');
-    if (!fs_1.default.existsSync(file))
+    const data = (0, graph_persistence_1.readJsonWithTmpFallback)(file);
+    if (!data)
         return graph;
     try {
-        const data = JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
         const stored = data.embeddingModel;
         if (embeddingFingerprint && stored !== embeddingFingerprint) {
             process.stderr.write(`[graph] Embedding config changed, re-indexing docs graph\n`);

package/dist/graphs/file-index.js

@@ -20,6 +20,8 @@ const file_lang_1 = require("../graphs/file-lang");
 const manager_types_1 = require("../graphs/manager-types");
 const file_index_1 = require("../lib/search/file-index");
 const embedding_codec_1 = require("../lib/embedding-codec");
+const graph_persistence_1 = require("../lib/graph-persistence");
+const defaults_1 = require("../lib/defaults");
 // ---------------------------------------------------------------------------
 // CRUD
 // ---------------------------------------------------------------------------
@@ -148,7 +150,7 @@ function getFileEntryMtime(graph, filePath) {
  * Otherwise returns all file nodes matching the filters.
  */
 function listAllFiles(graph, options = {}) {
-    const { directory, extension, language, filter, limit = 50 } = options;
+    const { directory, extension, language, filter, limit = defaults_1.LIST_LIMIT_LARGE } = options;
     const lowerFilter = filter?.toLowerCase();
     const results = [];
     if (directory !== undefined) {
@@ -261,10 +263,10 @@ function loadFileIndexGraph(graphMemory, fresh = false, embeddingFingerprint) {
     if (fresh)
         return graph;
     const file = path_1.default.join(graphMemory, 'file-index.json');
-    if (!fs_1.default.existsSync(file))
+    const data = (0, graph_persistence_1.readJsonWithTmpFallback)(file);
+    if (!data)
         return graph;
     try {
-        const data = JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
         const stored = data.embeddingModel;
         if (embeddingFingerprint && stored !== embeddingFingerprint) {
             process.stderr.write(`[file-index] Embedding config changed, re-indexing file index\n`);

package/dist/graphs/knowledge.js

@@ -29,6 +29,8 @@ const knowledge_1 = require("../lib/search/knowledge");
 const bm25_1 = require("../lib/search/bm25");
 const file_mirror_1 = require("../lib/file-mirror");
 const embedding_codec_1 = require("../lib/embedding-codec");
+const graph_persistence_1 = require("../lib/graph-persistence");
+const defaults_1 = require("../lib/defaults");
 const attachment_types_1 = require("../graphs/attachment-types");
 const file_import_1 = require("../lib/file-import");
 // ---------------------------------------------------------------------------
@@ -162,7 +164,7 @@ function getNote(graph, noteId) {
     return { id: noteId, ...graph.getNodeAttributes(noteId) };
 }
 /** List notes with optional filter (substring in title/id) and tag filter. Excludes proxy nodes. */
-function listNotes(graph, filter, tag, limit = 20) {
+function listNotes(graph, filter, tag, limit = defaults_1.LIST_LIMIT_SMALL) {
     const lowerFilter = filter?.toLowerCase();
     const lowerTag = tag?.toLowerCase();
     const results = [];
@@ -179,7 +181,7 @@ function listNotes(graph, filter, tag, limit = 20) {
             if (!attrs.tags.some(t => t.toLowerCase() === lowerTag))
                 return;
         }
-        results.push({ id, title: attrs.title, content: attrs.content.slice(0, 500), tags: attrs.tags, updatedAt: attrs.updatedAt });
+        results.push({ id, title: attrs.title, content: attrs.content.slice(0, defaults_1.CONTENT_PREVIEW_LEN), tags: attrs.tags, updatedAt: attrs.updatedAt });
     });
     return results
         .sort((a, b) => b.updatedAt - a.updatedAt)
@@ -349,10 +351,10 @@ function loadKnowledgeGraph(graphMemory, fresh = false, embeddingFingerprint) {
     if (fresh)
         return graph;
     const file = path_1.default.join(graphMemory, 'knowledge.json');
-    if (!fs_1.default.existsSync(file))
+    const data = (0, graph_persistence_1.readJsonWithTmpFallback)(file);
+    if (!data)
         return graph;
     try {
-        const data = JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
         const stored = data.embeddingModel;
         if (embeddingFingerprint && stored !== embeddingFingerprint) {
             process.stderr.write(`[knowledge-graph] Embedding config changed, re-indexing knowledge graph\n`);
@@ -601,6 +603,11 @@ class KnowledgeGraphManager {
             return null;
         if (!this._graph.hasNode(noteId) || isProxy(this._graph, noteId))
             return null;
+        if (data.length > attachment_types_1.MAX_ATTACHMENT_SIZE)
+            return null;
+        const existing = (0, attachment_types_1.scanAttachments)(path_1.default.join(dir, noteId));
+        if (existing.length >= attachment_types_1.MAX_ATTACHMENTS_PER_ENTITY)
+            return null;
         const safe = (0, file_mirror_1.sanitizeFilename)(filename);
         if (!safe)
             return null;

package/dist/graphs/skill.js

@@ -31,6 +31,8 @@ const skills_1 = require("../lib/search/skills");
 const bm25_1 = require("../lib/search/bm25");
 const file_mirror_1 = require("../lib/file-mirror");
 const embedding_codec_1 = require("../lib/embedding-codec");
+const graph_persistence_1 = require("../lib/graph-persistence");
+const defaults_1 = require("../lib/defaults");
 const attachment_types_1 = require("../graphs/attachment-types");
 const file_import_1 = require("../lib/file-import");
 // ---------------------------------------------------------------------------
@@ -290,7 +292,7 @@ function getSkill(graph, skillId) {
 }
 /** List skills with optional filters. Excludes proxy nodes. */
 function listSkills(graph, opts = {}) {
-    const { source, tag, filter, limit = 50 } = opts;
+    const { source, tag, filter, limit = defaults_1.LIST_LIMIT_LARGE } = opts;
     const lowerFilter = filter?.toLowerCase();
     const lowerTag = tag?.toLowerCase();
     const results = [];
@@ -310,7 +312,7 @@ function listSkills(graph, opts = {}) {
         results.push({
             id,
             title: attrs.title,
-            description: attrs.description?.slice(0, 500),
+            description: attrs.description?.slice(0, defaults_1.CONTENT_PREVIEW_LEN),
             steps: attrs.steps,
             triggers: attrs.triggers,
             inputHints: attrs.inputHints,
@@ -493,10 +495,10 @@ function loadSkillGraph(graphMemory, fresh = false, embeddingFingerprint) {
     if (fresh)
         return graph;
     const file = path_1.default.join(graphMemory, 'skills.json');
-    if (!fs_1.default.existsSync(file))
+    const data = (0, graph_persistence_1.readJsonWithTmpFallback)(file);
+    if (!data)
         return graph;
     try {
-        const data = JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
         const stored = data.embeddingModel;
         if (embeddingFingerprint && stored !== embeddingFingerprint) {
             process.stderr.write(`[skill-graph] Embedding config changed, re-indexing skill graph\n`);
@@ -829,10 +831,15 @@ class SkillGraphManager {
             return null;
         if (!this._graph.hasNode(skillId) || isProxy(this._graph, skillId))
             return null;
+        if (data.length > attachment_types_1.MAX_ATTACHMENT_SIZE)
+            return null;
+        const entityDir = path_1.default.join(dir, skillId);
+        const existing = (0, attachment_types_1.scanAttachments)(entityDir);
+        if (existing.length >= attachment_types_1.MAX_ATTACHMENTS_PER_ENTITY)
+            return null;
         const safe = (0, file_mirror_1.sanitizeFilename)(filename);
         if (!safe)
             return null;
-        const entityDir = path_1.default.join(dir, skillId);
         (0, file_mirror_1.writeAttachment)(dir, skillId, safe, data);
         this.mirrorTracker?.recordWrite(path_1.default.join(entityDir, 'attachments', safe));
         (0, file_mirror_1.mirrorAttachmentEvent)(entityDir, 'add', safe);

package/dist/graphs/task.js

@@ -31,6 +31,8 @@ const tasks_1 = require("../lib/search/tasks");
 const bm25_1 = require("../lib/search/bm25");
 const file_mirror_1 = require("../lib/file-mirror");
 const embedding_codec_1 = require("../lib/embedding-codec");
+const graph_persistence_1 = require("../lib/graph-persistence");
+const defaults_1 = require("../lib/defaults");
 const attachment_types_1 = require("../graphs/attachment-types");
 const file_import_1 = require("../lib/file-import");
 // ---------------------------------------------------------------------------
@@ -301,7 +303,7 @@ function getTask(graph, taskId) {
 }
 /** List tasks with optional filters. Excludes proxy nodes. */
 function listTasks(graph, opts = {}) {
-    const { status, priority, tag, filter, assignee, limit = 50 } = opts;
+    const { status, priority, tag, filter, assignee, limit = defaults_1.LIST_LIMIT_LARGE } = opts;
     const lowerFilter = filter?.toLowerCase();
     const lowerTag = tag?.toLowerCase();
     const results = [];
@@ -325,7 +327,7 @@ function listTasks(graph, opts = {}) {
         results.push({
             id,
             title: attrs.title,
-            description: attrs.description?.slice(0, 500),
+            description: attrs.description?.slice(0, defaults_1.CONTENT_PREVIEW_LEN),
             status: attrs.status,
             priority: attrs.priority,
             tags: attrs.tags,
@@ -514,10 +516,10 @@ function loadTaskGraph(graphMemory, fresh = false, embeddingFingerprint) {
     if (fresh)
         return graph;
     const file = path_1.default.join(graphMemory, 'tasks.json');
-    if (!fs_1.default.existsSync(file))
+    const data = (0, graph_persistence_1.readJsonWithTmpFallback)(file);
+    if (!data)
         return graph;
     try {
-        const data = JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
         const stored = data.embeddingModel;
         if (embeddingFingerprint && stored !== embeddingFingerprint) {
             process.stderr.write(`[task-graph] Embedding config changed, re-indexing task graph\n`);
@@ -800,10 +802,15 @@ class TaskGraphManager {
             return null;
         if (!this._graph.hasNode(taskId) || isProxy(this._graph, taskId))
             return null;
+        if (data.length > attachment_types_1.MAX_ATTACHMENT_SIZE)
+            return null;
+        const entityDir = path_1.default.join(dir, taskId);
+        const existing = (0, attachment_types_1.scanAttachments)(entityDir);
+        if (existing.length >= attachment_types_1.MAX_ATTACHMENTS_PER_ENTITY)
+            return null;
         const safe = (0, file_mirror_1.sanitizeFilename)(filename);
         if (!safe)
             return null;
-        const entityDir = path_1.default.join(dir, taskId);
         (0, file_mirror_1.writeAttachment)(dir, taskId, safe, data);
         this.mirrorTracker?.recordWrite(path_1.default.join(entityDir, 'attachments', safe));
         (0, file_mirror_1.mirrorAttachmentEvent)(entityDir, 'add', safe);

package/dist/lib/defaults.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Central named constants for all tunable values.
+ * Import from here instead of hardcoding magic numbers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WIKI_MAX_DEPTH = exports.DEFAULT_EMBEDDING_CACHE_SIZE = exports.MIRROR_MTIME_TOLERANCE_MS = exports.MIRROR_MAX_ENTRIES = exports.MIRROR_STALE_MS = exports.ERROR_BODY_LIMIT = exports.GRACEFUL_SHUTDOWN_TIMEOUT_MS = exports.SESSION_SWEEP_INTERVAL_MS = exports.RATE_LIMIT_WINDOW_MS = exports.REMOTE_BASE_DELAY_MS = exports.REMOTE_MAX_RETRIES = exports.WS_DEBOUNCE_MS = exports.AUTO_SAVE_INTERVAL_MS = exports.MAX_PASSWORD_LEN = exports.MAX_ATTACHMENT_FILENAME_LEN = exports.MAX_PROJECT_ID_LEN = exports.MAX_LINK_KIND_LEN = exports.MAX_TARGET_NODE_ID_LEN = exports.MAX_SKILL_TRIGGERS_COUNT = exports.MAX_SKILL_TRIGGER_LEN = exports.MAX_SKILL_STEPS_COUNT = exports.MAX_SKILL_STEP_LEN = exports.MAX_ASSIGNEE_LEN = exports.MAX_DESCRIPTION_LEN = exports.MAX_SEARCH_TOP_K = exports.MAX_SEARCH_QUERY_LEN = exports.MAX_TAGS_COUNT = exports.MAX_TAG_LEN = exports.MAX_NOTE_CONTENT_LEN = exports.MAX_TITLE_LEN = exports.INDEXER_PREVIEW_LEN = exports.CONTENT_PREVIEW_LEN = exports.LIST_LIMIT_LARGE = exports.LIST_LIMIT_SMALL = exports.SIGNATURE_MAX_LEN = exports.MAX_UPLOAD_SIZE = exports.MAX_BODY_SIZE = exports.BM25_BODY_MAX_CHARS = exports.FILE_SEARCH_TOP_K = exports.SEARCH_MIN_SCORE_FILES = exports.SEARCH_MIN_SCORE_CODE = exports.SEARCH_MIN_SCORE = exports.SEARCH_BFS_DECAY = exports.SEARCH_MAX_RESULTS = exports.SEARCH_BFS_DEPTH = exports.SEARCH_TOP_K = exports.RRF_K = exports.BM25_IDF_OFFSET = exports.BM25_B = exports.BM25_K1 = void 0;
+// ---------------------------------------------------------------------------
+// Search — BM25, RRF, BFS
+// ---------------------------------------------------------------------------
+exports.BM25_K1 = 1.2;
+exports.BM25_B = 0.75;
+exports.BM25_IDF_OFFSET = 0.5;
+exports.RRF_K = 60;
+exports.SEARCH_TOP_K = 5;
+exports.SEARCH_BFS_DEPTH = 1;
+exports.SEARCH_MAX_RESULTS = 20;
+exports.SEARCH_BFS_DECAY = 0.8;
+exports.SEARCH_MIN_SCORE = 0.5;
+exports.SEARCH_MIN_SCORE_CODE = 0.3;
+exports.SEARCH_MIN_SCORE_FILES = 0.3;
+exports.FILE_SEARCH_TOP_K = 10;
+exports.BM25_BODY_MAX_CHARS = 2000;
+// ---------------------------------------------------------------------------
+// Limits — sizes, counts, truncation
+// ---------------------------------------------------------------------------
+exports.MAX_BODY_SIZE = 10 * 1024 * 1024; // 10 MB
+exports.MAX_UPLOAD_SIZE = 50 * 1024 * 1024; // 50 MB (multer)
+exports.SIGNATURE_MAX_LEN = 300;
+exports.LIST_LIMIT_SMALL = 20;
+exports.LIST_LIMIT_LARGE = 50;
+exports.CONTENT_PREVIEW_LEN = 500;
+exports.INDEXER_PREVIEW_LEN = 200;
+// ---------------------------------------------------------------------------
+// Validation — REST API schema limits
+// ---------------------------------------------------------------------------
+exports.MAX_TITLE_LEN = 500;
+exports.MAX_NOTE_CONTENT_LEN = 1_000_000;
+exports.MAX_TAG_LEN = 100;
+exports.MAX_TAGS_COUNT = 100;
+exports.MAX_SEARCH_QUERY_LEN = 2000;
+exports.MAX_SEARCH_TOP_K = 500;
+exports.MAX_DESCRIPTION_LEN = 500_000;
+exports.MAX_ASSIGNEE_LEN = 100;
+exports.MAX_SKILL_STEP_LEN = 10_000;
+exports.MAX_SKILL_STEPS_COUNT = 100;
+exports.MAX_SKILL_TRIGGER_LEN = 500;
+exports.MAX_SKILL_TRIGGERS_COUNT = 50;
+exports.MAX_TARGET_NODE_ID_LEN = 500;
+exports.MAX_LINK_KIND_LEN = 100;
+exports.MAX_PROJECT_ID_LEN = 200;
+exports.MAX_ATTACHMENT_FILENAME_LEN = 255;
+exports.MAX_PASSWORD_LEN = 256;
+// ---------------------------------------------------------------------------
+// Timing — intervals, retries, timeouts
+// ---------------------------------------------------------------------------
+exports.AUTO_SAVE_INTERVAL_MS = 30_000;
+exports.WS_DEBOUNCE_MS = 1000;
+exports.REMOTE_MAX_RETRIES = 3;
+exports.REMOTE_BASE_DELAY_MS = 200;
+exports.RATE_LIMIT_WINDOW_MS = 60_000;
+exports.SESSION_SWEEP_INTERVAL_MS = 60_000;
+exports.GRACEFUL_SHUTDOWN_TIMEOUT_MS = 5000;
+exports.ERROR_BODY_LIMIT = 500;
+// ---------------------------------------------------------------------------
+// Mirror
+// ---------------------------------------------------------------------------
+exports.MIRROR_STALE_MS = 10_000;
+exports.MIRROR_MAX_ENTRIES = 10_000;
+exports.MIRROR_MTIME_TOLERANCE_MS = 100;
+// ---------------------------------------------------------------------------
+// Embedder
+// ---------------------------------------------------------------------------
+exports.DEFAULT_EMBEDDING_CACHE_SIZE = 10_000;
+// ---------------------------------------------------------------------------
+// Parser
+// ---------------------------------------------------------------------------
+exports.WIKI_MAX_DEPTH = 10;

package/dist/lib/embedder.js

@@ -12,10 +12,11 @@ exports.cosineSimilarity = cosineSimilarity;
 const transformers_1 = require("@huggingface/transformers");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const defaults_1 = require("../lib/defaults");
 // ---------------------------------------------------------------------------
 // LRU cache for embedding vectors (avoids re-computing identical texts)
 // ---------------------------------------------------------------------------
-const DEFAULT_CACHE_SIZE = 10_000;
+const DEFAULT_CACHE_SIZE = defaults_1.DEFAULT_EMBEDDING_CACHE_SIZE;
 class LruCache {
     maxSize;
     map = new Map();
@@ -97,26 +98,24 @@ async function loadModel(model, embedding, modelsDir, name = 'default') {
 // ---------------------------------------------------------------------------
 // Remote embedding HTTP client
 // ---------------------------------------------------------------------------
-const REMOTE_MAX_RETRIES = 3;
-const REMOTE_BASE_DELAY_MS = 200;
 async function remoteEmbed(url, texts, apiKey) {
     const headers = { 'Content-Type': 'application/json' };
     if (apiKey)
         headers['Authorization'] = `Bearer ${apiKey}`;
     const body = JSON.stringify({ texts });
-    for (let attempt = 0; attempt < REMOTE_MAX_RETRIES; attempt++) {
+    for (let attempt = 0; attempt < defaults_1.REMOTE_MAX_RETRIES; attempt++) {
         let resp;
         try {
             resp = await fetch(url, { method: 'POST', headers, body });
         }
         catch (err) {
             // Network error — retry
-            if (attempt < REMOTE_MAX_RETRIES - 1) {
-                const delay = REMOTE_BASE_DELAY_MS * 2 ** attempt;
+            if (attempt < defaults_1.REMOTE_MAX_RETRIES - 1) {
+                const delay = defaults_1.REMOTE_BASE_DELAY_MS * 2 ** attempt;
                 await new Promise(r => setTimeout(r, delay));
                 continue;
             }
-            throw new Error(`Remote embed network error after ${REMOTE_MAX_RETRIES} attempts: ${err}`);
+            throw new Error(`Remote embed network error after ${defaults_1.REMOTE_MAX_RETRIES} attempts: ${err}`);
         }
         if (resp.ok) {
             const data = await resp.json();
@@ -124,17 +123,17 @@ async function remoteEmbed(url, texts, apiKey) {
         }
         // Client errors (4xx) — don't retry
         if (resp.status < 500) {
-            const respBody = (await resp.text()).slice(0, 500);
+            const respBody = (await resp.text()).slice(0, defaults_1.ERROR_BODY_LIMIT);
             throw new Error(`Remote embed failed (${resp.status}): ${respBody}`);
         }
         // Server errors (5xx) — retry
-        if (attempt < REMOTE_MAX_RETRIES - 1) {
-            const delay = REMOTE_BASE_DELAY_MS * 2 ** attempt;
+        if (attempt < defaults_1.REMOTE_MAX_RETRIES - 1) {
+            const delay = defaults_1.REMOTE_BASE_DELAY_MS * 2 ** attempt;
             await new Promise(r => setTimeout(r, delay));
             continue;
         }
-        const respBody = (await resp.text()).slice(0, 500);
-        throw new Error(`Remote embed failed after ${REMOTE_MAX_RETRIES} attempts (${resp.status}): ${respBody}`);
+        const respBody = (await resp.text()).slice(0, defaults_1.ERROR_BODY_LIMIT);
+        throw new Error(`Remote embed failed after ${defaults_1.REMOTE_MAX_RETRIES} attempts (${resp.status}): ${respBody}`);
     }
     throw new Error('Remote embed: unreachable');
 }

package/dist/lib/embedding-codec.js

@@ -5,17 +5,15 @@
  * Backwards compatible: detects old format (number[]) on load.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.float32ToBase64 = float32ToBase64;
+exports.base64ToFloat32 = base64ToFloat32;
 exports.compressEmbeddings = compressEmbeddings;
 exports.decompressEmbeddings = decompressEmbeddings;
 const EMBEDDING_FIELDS = ['embedding', 'fileEmbedding'];
 /** Convert a number[] to a Base64-encoded Float32Array. */
 function float32ToBase64(arr) {
     const f32 = new Float32Array(arr);
-    const bytes = new Uint8Array(f32.buffer);
-    let binary = '';
-    for (let i = 0; i < bytes.length; i++)
-        binary += String.fromCharCode(bytes[i]);
-    return Buffer.from(binary, 'binary').toString('base64');
+    return Buffer.from(f32.buffer).toString('base64');
 }
 /** Convert a Base64-encoded Float32Array back to number[]. */
 function base64ToFloat32(b64) {