@alaarab/cortex 1.13.6 → 1.14.0

package/mcp/dist/mcp-search.js

@@ -4,7 +4,7 @@ import * as fs from "fs";
 import { isValidProjectName, buildRobustFtsQuery } from "./utils.js";
 import { keywordFallbackSearch } from "./core-search.js";
 import { readFindings } from "./data-access.js";
-import { debugLog, runtimeFile, } from "./shared.js";
+import { debugLog, runtimeFile, DOC_TYPES, FINDING_TAGS, } from "./shared.js";
 import { queryRows, cosineFallback, queryEntityLinks, extractSnippet, queryDocBySourceKey, } from "./shared-index.js";
 import { runCustomHooks } from "./hooks.js";
 import { entryScoreKey, getQualityMultiplier } from "./shared-governance.js";
@@ -72,10 +72,10 @@ export function register(server, ctx) {
             query: z.string().describe("Search query (supports FTS5 syntax: AND, OR, NOT, phrase matching with quotes)"),
             limit: z.number().min(1).max(20).optional().describe("Max results to return (1-20, default 5)"),
             project: z.string().optional().describe("Filter by project name."),
-            type: z.enum(["claude", "findings", "reference", "skills", "summary", "backlog", "changelog", "canonical", "memory-queue", "skill", "other"])
+            type: z.enum(DOC_TYPES)
                 .optional()
                 .describe("Filter by document type: claude, findings, reference, summary, backlog, skill"),
-            tag: z.enum(["decision", "pitfall", "pattern", "tradeoff", "architecture", "bug"])
+            tag: z.enum(FINDING_TAGS)
                 .optional()
                 .describe("Filter findings by type tag (decision, pitfall, pattern are canonical; tradeoff, architecture, bug are legacy aliases)."),
             since: z.string().optional().describe('Filter findings by creation date. Formats: "7d" (last 7 days), "30d" (last 30 days), "YYYY-MM" (since start of month), "YYYY-MM-DD" (since date).'),
@@ -277,8 +277,8 @@ export function register(server, ctx) {
                         boost = 1.2;
                 }
                 catch { /* file may not exist on disk */ }
+                const scoreKey = entryScoreKey(rowProject, filename, content);
                 const snippet = extractSnippet(content, query);
-                const scoreKey = entryScoreKey(rowProject, filename, snippet);
                 boost *= getQualityMultiplier(cortexPath, scoreKey);
                 return { row, rank: (rows.length - idx) * boost };
             });

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/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.14.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"

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