@alaarab/cortex 1.13.6 → 1.15.0

package/mcp/dist/shared-index.js

@@ -107,32 +107,43 @@ function touchSentinel(cortexPath) {
     }
     catch { /* best-effort */ }
 }
-function computeCortexHash(cortexPath, profile) {
-    const projectDirs = getProjectDirs(cortexPath, profile);
+function computeCortexHash(cortexPath, profile, preGlobbed) {
     const policy = getIndexPolicy(cortexPath);
-    const files = [];
-    for (const dir of projectDirs) {
-        try {
-            const matched = new Set();
-            for (const pattern of policy.includeGlobs) {
-                const dot = policy.includeHidden || pattern.startsWith(".") || pattern.includes("/.");
-                const mdFiles = globSync(pattern, { cwd: dir, nodir: true, dot, ignore: policy.excludeGlobs });
-                for (const f of mdFiles)
-                    matched.add(f);
+    const hash = crypto.createHash("sha1");
+    if (preGlobbed) {
+        for (const f of preGlobbed) {
+            try {
+                const stat = fs.statSync(f);
+                hash.update(`${f}:${stat.mtimeMs}:${stat.size}`);
             }
-            for (const f of matched)
-                files.push(path.join(dir, f));
+            catch { /* skip */ }
         }
-        catch { /* skip unreadable dirs */ }
     }
-    files.sort();
-    const hash = crypto.createHash("sha1");
-    for (const f of files) {
-        try {
-            const stat = fs.statSync(f);
-            hash.update(`${f}:${stat.mtimeMs}:${stat.size}`);
+    else {
+        const projectDirs = getProjectDirs(cortexPath, profile);
+        const files = [];
+        for (const dir of projectDirs) {
+            try {
+                const matched = new Set();
+                for (const pattern of policy.includeGlobs) {
+                    const dot = policy.includeHidden || pattern.startsWith(".") || pattern.includes("/.");
+                    const mdFiles = globSync(pattern, { cwd: dir, nodir: true, dot, ignore: policy.excludeGlobs });
+                    for (const f of mdFiles)
+                        matched.add(f);
+                }
+                for (const f of matched)
+                    files.push(path.join(dir, f));
+            }
+            catch { /* skip unreadable dirs */ }
+        }
+        files.sort();
+        for (const f of files) {
+            try {
+                const stat = fs.statSync(f);
+                hash.update(`${f}:${stat.mtimeMs}:${stat.size}`);
+            }
+            catch { /* skip */ }
         }
-        catch { /* skip */ }
     }
     for (const mem of collectNativeMemoryFiles()) {
         try {
@@ -227,10 +238,11 @@ function getEntrySourceDocKey(entry, cortexPath) {
     }
     return buildSourceDocKey(entry.project, entry.fullPath, cortexPath, entry.filename);
 }
-function collectAllFiles(cortexPath, profile) {
+function globAllFiles(cortexPath, profile) {
     const projectDirs = getProjectDirs(cortexPath, profile);
     const indexPolicy = getIndexPolicy(cortexPath);
     const entries = [];
+    const allAbsolutePaths = [];
     for (const dir of projectDirs) {
         const projectName = path.basename(dir);
         const mdFilesSet = new Set();
@@ -255,12 +267,18 @@ function collectAllFiles(cortexPath, profile) {
             const fullPath = path.join(dir, relFile);
             const type = classifyFile(filename, relFile);
             entries.push({ fullPath, project: projectName, filename, type, relFile });
+            allAbsolutePaths.push(fullPath);
         }
     }
     for (const mem of collectNativeMemoryFiles()) {
         entries.push({ fullPath: mem.fullPath, project: mem.project, filename: mem.file, type: "findings" });
+        allAbsolutePaths.push(mem.fullPath);
     }
-    return entries;
+    allAbsolutePaths.sort();
+    return { filePaths: allAbsolutePaths, entries };
+}
+function collectAllFiles(cortexPath, profile) {
+    return globAllFiles(cortexPath, profile).entries;
 }
 function insertFileIntoIndex(db, entry, cortexPath) {
     try {
@@ -341,7 +359,8 @@ async function buildIndexImpl(cortexPath, profile) {
         userSuffix = crypto.createHash("sha1").update(os.homedir()).digest("hex").slice(0, 12);
     }
     const cacheDir = path.join(os.tmpdir(), `cortex-fts-${userSuffix}`);
-    const hash = computeCortexHash(cortexPath, profile);
+    const globResult = globAllFiles(cortexPath, profile);
+    const hash = computeCortexHash(cortexPath, profile, globResult.filePaths);
     const cacheFile = path.join(cacheDir, `${hash}.db`);
     const wasmBinary = findWasmBinary();
     const SQL = await initSqlJs(wasmBinary ? { wasmBinary } : {});
@@ -358,7 +377,7 @@ async function buildIndexImpl(cortexPath, profile) {
             try {
                 db = new SQL.Database(cached);
                 // Compute current file hashes and determine what changed
-                const allFiles = collectAllFiles(cortexPath, profile);
+                const allFiles = globResult.entries;
                 const currentHashes = {};
                 const changedFiles = [];
                 const newFiles = [];
@@ -487,7 +506,7 @@ async function buildIndexImpl(cortexPath, profile) {
     db.run(`CREATE TABLE IF NOT EXISTS entity_links (source_id INTEGER REFERENCES entities(id), target_id INTEGER REFERENCES entities(id), rel_type TEXT NOT NULL, source_doc TEXT, PRIMARY KEY (source_id, target_id, rel_type))`);
     // Q20: Cross-project entity index
     ensureGlobalEntitiesTable(db);
-    const allFiles = collectAllFiles(cortexPath, profile);
+    const allFiles = globResult.entries;
     const newHashes = {};
     let fileCount = 0;
     // Try loading cached entity graph

package/mcp/dist/shared.js

@@ -209,6 +209,12 @@ export function collectNativeMemoryFiles() {
     }
     return results;
 }
+/** Canonical finding type tags */
+export const FINDING_TYPES = ["decision", "pitfall", "pattern"];
+/** All searchable finding tags (canonical + legacy aliases) */
+export const FINDING_TAGS = ["decision", "pitfall", "pattern", "tradeoff", "architecture", "bug"];
+/** Document types in the FTS index */
+export const DOC_TYPES = ["claude", "findings", "reference", "skills", "summary", "backlog", "changelog", "canonical", "memory-queue", "skill", "other"];
 export function appendAuditLog(cortexPath, event, details) {
     // Migrate: check old location, use new .runtime/ path
     const legacyPath = path.join(cortexPath, ".cortex-audit.log");

package/mcp/dist/utils.js

@@ -1,5 +1,8 @@
+import * as fs from "fs";
 import * as path from "path";
 import { execFileSync } from "child_process";
+import * as yaml from "js-yaml";
+import { findCortexPath } from "./shared.js";
 // ── Shared Git helper ────────────────────────────────────────────────────────
 export function runGit(cwd, args, timeoutMs, debugLogFn) {
     try {
@@ -266,17 +269,59 @@ export function sanitizeFts5Query(raw) {
     q = q.replace(/\s+/g, " ");
     return q.trim();
 }
+function parseSynonymsYaml(filePath) {
+    if (!fs.existsSync(filePath))
+        return {};
+    try {
+        const parsed = yaml.load(fs.readFileSync(filePath, "utf8"), { schema: yaml.CORE_SCHEMA });
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return {};
+        const loaded = {};
+        for (const [rawKey, value] of Object.entries(parsed)) {
+            const key = String(rawKey).trim().toLowerCase();
+            if (!key || !Array.isArray(value))
+                continue;
+            const synonyms = value
+                .filter((item) => typeof item === "string")
+                .map((item) => item.replace(/"/g, "").trim())
+                .filter((item) => item.length > 1);
+            if (synonyms.length > 0)
+                loaded[key] = synonyms;
+        }
+        return loaded;
+    }
+    catch {
+        return {};
+    }
+}
+function loadUserSynonyms(project) {
+    const cortexPath = findCortexPath();
+    if (!cortexPath)
+        return {};
+    const globalSynonyms = parseSynonymsYaml(path.join(cortexPath, "global", "synonyms.yaml"));
+    if (!project || !isValidProjectName(project))
+        return globalSynonyms;
+    const projectSynonyms = parseSynonymsYaml(path.join(cortexPath, project, "synonyms.yaml"));
+    return {
+        ...globalSynonyms,
+        ...projectSynonyms,
+    };
+}
 // Build a defensive FTS5 MATCH query:
 // - sanitizes user input
 // - extracts bigrams and treats them as quoted phrases
 // - expands known synonyms (capped at 10 total terms)
 // - applies AND between core terms, with synonyms as OR alternatives
-export function buildRobustFtsQuery(raw) {
+export function buildRobustFtsQuery(raw, project) {
     const MAX_TOTAL_TERMS = 10;
     const MAX_SYNONYM_GROUPS = 3;
     const safe = sanitizeFts5Query(raw);
     if (!safe)
         return "";
+    const synonymsMap = {
+        ...SYNONYMS,
+        ...loadUserSynonyms(project),
+    };
     const baseWords = safe.split(/\s+/).filter((t) => t.length > 1);
     if (baseWords.length === 0)
         return "";
@@ -286,12 +331,11 @@ export function buildRobustFtsQuery(raw) {
         bigrams.push(`${baseWords[i]} ${baseWords[i + 1]}`);
     }
     // Determine which words are consumed by bigrams that match synonym keys
-    const lowered = safe.toLowerCase();
     const consumedIndices = new Set();
     const matchedBigrams = [];
     for (let i = 0; i < bigrams.length; i++) {
         const bg = bigrams[i].toLowerCase();
-        if (SYNONYMS[bg]) {
+        if (synonymsMap[bg]) {
             consumedIndices.add(i);
             consumedIndices.add(i + 1);
             matchedBigrams.push(bigrams[i]);
@@ -326,8 +370,8 @@ export function buildRobustFtsQuery(raw) {
     for (const coreTerm of coreTerms) {
         const termText = coreTerm.slice(1, -1).toLowerCase(); // strip quotes
         const synonyms = [];
-        if (groupsExpanded < MAX_SYNONYM_GROUPS && SYNONYMS[termText]) {
-            for (const syn of SYNONYMS[termText]) {
+        if (groupsExpanded < MAX_SYNONYM_GROUPS && synonymsMap[termText]) {
+            for (const syn of synonymsMap[termText]) {
                 if (totalTermCount >= MAX_TOTAL_TERMS)
                     break;
                 const cleanSyn = syn.replace(/"/g, "").trim();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alaarab/cortex",
-  "version": "1.13.6",
-  "description": "Long-term memory for AI agents — stored as markdown in a git repo you own.",
+  "version": "1.15.0",
+  "description": "Long-term memory for AI agents. Stored as markdown in a git repo you own.",
   "type": "module",
   "bin": {
     "cortex": "mcp/dist/index.js"
@@ -12,21 +12,21 @@
     "skills"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "@xenova/transformers": "^2.17.2",
-    "glob": "^12.0.0",
-    "js-yaml": "^4.1.0",
+    "glob": "^13.0.6",
+    "js-yaml": "^4.1.1",
     "sql.js-fts5": "^1.4.0",
-    "zod": "^4.0.0"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@types/js-yaml": "^4.0.0",
-    "@types/node": "^22.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.3.5",
     "@typescript-eslint/eslint-plugin": "^8.56.1",
     "@typescript-eslint/parser": "^8.56.1",
-    "eslint": "^10.0.2",
-    "tsx": "^4.0.0",
-    "typescript": "^5.7.0",
+    "eslint": "^10.0.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },
   "scripts": {

package/starter/README.md

@@ -1,6 +1,6 @@
 # My Cortex
 
-Your personal project store for [cortex](https://github.com/alaarab/cortex) 1.11.1, which gives Claude Code persistent context across sessions and machines.
+Your personal project store for [cortex](https://github.com/alaarab/cortex), which gives Claude Code persistent context across sessions and machines.
 
 ## Structure
 
@@ -67,7 +67,7 @@ work-desktop: work
 home-laptop: personal
 ```
 
-Each profile in `profiles/` lists which projects that machine should see. After cloning on a new machine, run `/cortex:sync` to pull everything in.
+Each profile in `profiles/` lists which projects that machine should see. After cloning on a new machine, run `/cortex-sync` to pull everything in.
 
 ## Troubleshooting