@alaarab/cortex 1.13.6 → 1.15.0

package/mcp/dist/cli-hooks-session.js

@@ -11,7 +11,12 @@ import { runDoctor } from "./link.js";
 import { getHooksEnabledPreference } from "./init.js";
 import { buildIndex, queryRows, } from "./shared-index.js";
 import { filterBacklogByPriority } from "./cli-hooks-retrieval.js";
-const cortexPath = ensureCortexPath();
+let _cortexPath;
+function getCortexPath() {
+    if (!_cortexPath)
+        _cortexPath = ensureCortexPath();
+    return _cortexPath;
+}
 const profile = process.env.CORTEX_PROFILE || "";
 export function getGitContext(cwd) {
     if (!cwd)
@@ -239,21 +244,21 @@ async function runBestEffortGit(args, cwd) {
 // ── Hook handlers ────────────────────────────────────────────────────────────
 export async function handleHookSessionStart() {
     const startedAt = new Date().toISOString();
-    if (!getHooksEnabledPreference(cortexPath)) {
-        updateRuntimeHealth(cortexPath, { lastSessionStartAt: startedAt });
-        appendAuditLog(cortexPath, "hook_session_start", "status=disabled");
+    if (!getHooksEnabledPreference(getCortexPath())) {
+        updateRuntimeHealth(getCortexPath(), { lastSessionStartAt: startedAt });
+        appendAuditLog(getCortexPath(), "hook_session_start", "status=disabled");
         return;
     }
-    const pull = await runBestEffortGit(["pull", "--rebase", "--quiet"], cortexPath);
-    const doctor = await runDoctor(cortexPath, false);
-    const maintenanceScheduled = scheduleBackgroundMaintenance(cortexPath);
+    const pull = await runBestEffortGit(["pull", "--rebase", "--quiet"], getCortexPath());
+    const doctor = await runDoctor(getCortexPath(), false);
+    const maintenanceScheduled = scheduleBackgroundMaintenance(getCortexPath());
     try {
         const { trackSession } = await import("./telemetry.js");
-        trackSession(cortexPath);
+        trackSession(getCortexPath());
     }
     catch { /* best-effort */ }
-    updateRuntimeHealth(cortexPath, { lastSessionStartAt: startedAt });
-    appendAuditLog(cortexPath, "hook_session_start", `pull=${pull.ok ? "ok" : "fail"} doctor=${doctor.ok ? "ok" : "issues"} maintenance=${maintenanceScheduled ? "scheduled" : "skipped"}`);
+    updateRuntimeHealth(getCortexPath(), { lastSessionStartAt: startedAt });
+    appendAuditLog(getCortexPath(), "hook_session_start", `pull=${pull.ok ? "ok" : "fail"} doctor=${doctor.ok ? "ok" : "issues"} maintenance=${maintenanceScheduled ? "scheduled" : "skipped"}`);
 }
 // ── Q21: Conversation memory capture ─────────────────────────────────────────
 const INSIGHT_KEYWORDS = [
@@ -291,35 +296,35 @@ export function extractConversationInsights(text) {
 }
 export async function handleHookStop() {
     const now = new Date().toISOString();
-    if (!getHooksEnabledPreference(cortexPath)) {
-        updateRuntimeHealth(cortexPath, {
+    if (!getHooksEnabledPreference(getCortexPath())) {
+        updateRuntimeHealth(getCortexPath(), {
             lastStopAt: now,
             lastAutoSave: { at: now, status: "clean", detail: "hooks disabled by preference" },
         });
-        appendAuditLog(cortexPath, "hook_stop", "status=disabled");
+        appendAuditLog(getCortexPath(), "hook_stop", "status=disabled");
         return;
     }
-    const status = await runBestEffortGit(["status", "--porcelain"], cortexPath);
+    const status = await runBestEffortGit(["status", "--porcelain"], getCortexPath());
     if (!status.ok) {
-        updateRuntimeHealth(cortexPath, {
+        updateRuntimeHealth(getCortexPath(), {
             lastStopAt: now,
             lastAutoSave: { at: now, status: "error", detail: status.error || "git status failed" },
         });
-        appendAuditLog(cortexPath, "hook_stop", `status=error detail=${JSON.stringify(status.error || "git status failed")}`);
+        appendAuditLog(getCortexPath(), "hook_stop", `status=error detail=${JSON.stringify(status.error || "git status failed")}`);
         return;
     }
     if (!status.output) {
-        updateRuntimeHealth(cortexPath, {
+        updateRuntimeHealth(getCortexPath(), {
             lastStopAt: now,
             lastAutoSave: { at: now, status: "clean", detail: "no changes" },
         });
-        appendAuditLog(cortexPath, "hook_stop", "status=clean");
+        appendAuditLog(getCortexPath(), "hook_stop", "status=clean");
         return;
     }
-    const add = await runBestEffortGit(["add", "-A"], cortexPath);
-    const commit = add.ok ? await runBestEffortGit(["commit", "-m", "auto-save cortex"], cortexPath) : { ok: false, error: add.error };
+    const add = await runBestEffortGit(["add", "-A"], getCortexPath());
+    const commit = add.ok ? await runBestEffortGit(["commit", "-m", "auto-save cortex"], getCortexPath()) : { ok: false, error: add.error };
     if (!add.ok || !commit.ok) {
-        updateRuntimeHealth(cortexPath, {
+        updateRuntimeHealth(getCortexPath(), {
             lastStopAt: now,
             lastAutoSave: {
                 at: now,
@@ -327,36 +332,36 @@ export async function handleHookStop() {
                 detail: add.error || commit.error || "git add/commit failed",
             },
         });
-        appendAuditLog(cortexPath, "hook_stop", `status=error detail=${JSON.stringify(add.error || commit.error || "git add/commit failed")}`);
+        appendAuditLog(getCortexPath(), "hook_stop", `status=error detail=${JSON.stringify(add.error || commit.error || "git add/commit failed")}`);
         return;
     }
-    const remotes = await runBestEffortGit(["remote"], cortexPath);
+    const remotes = await runBestEffortGit(["remote"], getCortexPath());
     if (!remotes.ok || !remotes.output) {
-        updateRuntimeHealth(cortexPath, {
+        updateRuntimeHealth(getCortexPath(), {
             lastStopAt: now,
             lastAutoSave: { at: now, status: "saved-local", detail: "commit created; no remote configured" },
         });
-        appendAuditLog(cortexPath, "hook_stop", "status=saved-local");
+        appendAuditLog(getCortexPath(), "hook_stop", "status=saved-local");
         return;
     }
-    const push = await runBestEffortGit(["push"], cortexPath);
+    const push = await runBestEffortGit(["push"], getCortexPath());
     if (push.ok) {
-        updateRuntimeHealth(cortexPath, {
+        updateRuntimeHealth(getCortexPath(), {
             lastStopAt: now,
             lastAutoSave: { at: now, status: "saved-pushed", detail: "commit pushed" },
         });
-        appendAuditLog(cortexPath, "hook_stop", "status=saved-pushed");
+        appendAuditLog(getCortexPath(), "hook_stop", "status=saved-pushed");
         // Q21: Auto-capture conversation insights (gated behind CORTEX_FEATURE_AUTO_CAPTURE=1)
         if (isFeatureEnabled("CORTEX_FEATURE_AUTO_CAPTURE", false)) {
             try {
                 const captureInput = process.env.CORTEX_CONVERSATION_CONTEXT || "";
                 if (captureInput) {
                     const cwd = process.cwd();
-                    const activeProject = detectProject(cortexPath, cwd, profile);
+                    const activeProject = detectProject(getCortexPath(), cwd, profile);
                     if (activeProject) {
                         const insights = extractConversationInsights(captureInput);
                         for (const insight of insights) {
-                            addFindingToFile(cortexPath, activeProject, `[pattern] ${insight}`);
+                            addFindingToFile(getCortexPath(), activeProject, `[pattern] ${insight}`);
                             debugLog(`auto-capture: saved insight for ${activeProject}: ${insight.slice(0, 60)}`);
                         }
                     }
@@ -368,7 +373,7 @@ export async function handleHookStop() {
         }
         // Auto governance scheduling: run governance weekly if overdue
         try {
-            const lastGovPath = runtimeFile(cortexPath, "last-governance.txt");
+            const lastGovPath = runtimeFile(getCortexPath(), "last-governance.txt");
             const lastRun = fs.existsSync(lastGovPath) ? parseInt(fs.readFileSync(lastGovPath, "utf8"), 10) : 0;
             const daysSince = (Date.now() - lastRun) / 86_400_000;
             if (daysSince >= 7) {
@@ -386,14 +391,14 @@ export async function handleHookStop() {
         }
         return;
     }
-    updateRuntimeHealth(cortexPath, {
+    updateRuntimeHealth(getCortexPath(), {
         lastStopAt: now,
         lastAutoSave: { at: now, status: "saved-local", detail: push.error || "push failed" },
     });
-    appendAuditLog(cortexPath, "hook_stop", `status=saved-local detail=${JSON.stringify(push.error || "push failed")}`);
+    appendAuditLog(getCortexPath(), "hook_stop", `status=saved-local detail=${JSON.stringify(push.error || "push failed")}`);
 }
 export async function handleHookContext() {
-    if (!getHooksEnabledPreference(cortexPath)) {
+    if (!getHooksEnabledPreference(getCortexPath())) {
         process.exit(0);
     }
     let cwd = process.cwd();
@@ -406,8 +411,8 @@ export async function handleHookContext() {
     catch (err) {
         debugLog(`hook-context: no stdin or invalid JSON, using cwd: ${err instanceof Error ? err.message : String(err)}`);
     }
-    const project = detectProject(cortexPath, cwd, profile);
-    const db = await buildIndex(cortexPath, profile);
+    const project = detectProject(getCortexPath(), cwd, profile);
+    const db = await buildIndex(getCortexPath(), profile);
     const contextLabel = project ? `\u25c6 cortex \u00b7 ${project} \u00b7 context` : `\u25c6 cortex \u00b7 context`;
     const parts = [contextLabel, "<cortex-context>"];
     if (project) {
@@ -456,7 +461,7 @@ export async function handleHookContext() {
 // ── PostToolUse hook ─────────────────────────────────────────────────────────
 const INTERESTING_TOOLS = new Set(["Read", "Write", "Edit", "Bash", "Glob", "Grep"]);
 export async function handleHookTool() {
-    if (!getHooksEnabledPreference(cortexPath)) {
+    if (!getHooksEnabledPreference(getCortexPath())) {
         process.exit(0);
     }
     const start = Date.now();
@@ -513,7 +518,7 @@ export async function handleHookTool() {
         entry.error = responseStr.slice(0, 300);
     }
     try {
-        const logFile = runtimeFile(cortexPath, "tool-log.jsonl");
+        const logFile = runtimeFile(getCortexPath(), "tool-log.jsonl");
         fs.mkdirSync(path.dirname(logFile), { recursive: true });
         fs.appendFileSync(logFile, JSON.stringify(entry) + "\n");
     }
@@ -521,17 +526,17 @@ export async function handleHookTool() {
         // best effort
     }
     const cwd = (data.cwd ?? input.cwd ?? undefined);
-    const activeProject = cwd ? detectProject(cortexPath, cwd, profile) : null;
+    const activeProject = cwd ? detectProject(getCortexPath(), cwd, profile) : null;
     if (activeProject) {
         try {
             const candidates = extractToolFindings(toolName, input, responseStr);
             for (const { text, confidence } of candidates) {
                 if (confidence >= 0.85) {
-                    addFindingToFile(cortexPath, activeProject, text);
+                    addFindingToFile(getCortexPath(), activeProject, text);
                     debugLog(`hook-tool: auto-added learning (conf=${confidence}): ${text.slice(0, 60)}`);
                 }
                 else {
-                    appendReviewQueue(cortexPath, activeProject, "Review", [text]);
+                    appendReviewQueue(getCortexPath(), activeProject, "Review", [text]);
                     debugLog(`hook-tool: queued candidate (conf=${confidence}): ${text.slice(0, 60)}`);
                 }
             }

package/mcp/dist/cli-hooks.js

@@ -30,12 +30,17 @@ import { searchDocuments, applyTrustFilter, rankResults, selectSnippets, detectT
 import { buildHookOutput } from "./cli-hooks-output.js";
 import { getGitContext, trackSessionMetrics, scheduleBackgroundMaintenance, } from "./cli-hooks-session.js";
 import { approximateTokens } from "./cli-hooks-retrieval.js";
-const cortexPath = ensureCortexPath();
+let _cortexPath;
+function getCortexPath() {
+    if (!_cortexPath)
+        _cortexPath = ensureCortexPath();
+    return _cortexPath;
+}
 const profile = process.env.CORTEX_PROFILE || "";
 async function readStdin() {
     return new Promise((resolve, reject) => {
         const chunks = [];
-        process.stdin.on("data", (chunk) => chunks.push(chunk));
+        process.stdin.on("data", (chunk) => chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk));
         process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
         process.stdin.on("error", reject);
     });
@@ -67,24 +72,24 @@ export async function handleHookPrompt() {
     if (!input)
         process.exit(0);
     const { prompt, cwd, sessionId } = input;
-    if (!getHooksEnabledPreference(cortexPath)) {
-        appendAuditLog(cortexPath, "hook_prompt", "status=disabled");
+    if (!getHooksEnabledPreference(getCortexPath())) {
+        appendAuditLog(getCortexPath(), "hook_prompt", "status=disabled");
         process.exit(0);
     }
-    updateRuntimeHealth(cortexPath, { lastPromptAt: new Date().toISOString() });
+    updateRuntimeHealth(getCortexPath(), { lastPromptAt: new Date().toISOString() });
     const keywords = extractKeywords(prompt);
     if (!keywords)
         process.exit(0);
     debugLog(`hook-prompt keywords: "${keywords}"`);
     const tIndex0 = Date.now();
-    const db = await buildIndex(cortexPath, profile);
+    const db = await buildIndex(getCortexPath(), profile);
     stage.indexMs = Date.now() - tIndex0;
     const gitCtx = getGitContext(cwd);
     const intent = detectTaskIntent(prompt);
-    const detectedProject = cwd ? detectProject(cortexPath, cwd, profile) : null;
+    const detectedProject = cwd ? detectProject(getCortexPath(), cwd, profile) : null;
     if (detectedProject)
         debugLog(`Detected project: ${detectedProject}`);
-    const safeQuery = buildRobustFtsQuery(keywords);
+    const safeQuery = buildRobustFtsQuery(keywords, detectedProject);
     if (!safeQuery)
         process.exit(0);
     try {
@@ -94,14 +99,14 @@ export async function handleHookPrompt() {
         if (!rows || !rows.length)
             process.exit(0);
         const tTrust0 = Date.now();
-        const policy = getRetentionPolicy(cortexPath);
+        const policy = getRetentionPolicy(getCortexPath());
         const memoryTtlDays = Number.parseInt(process.env.CORTEX_MEMORY_TTL_DAYS || String(policy.ttlDays), 10);
-        rows = applyTrustFilter(rows, cortexPath, Number.isNaN(memoryTtlDays) ? policy.ttlDays : memoryTtlDays, policy.minInjectConfidence, policy.decay);
+        rows = applyTrustFilter(rows, getCortexPath(), Number.isNaN(memoryTtlDays) ? policy.ttlDays : memoryTtlDays, policy.minInjectConfidence, policy.decay);
         stage.trustMs = Date.now() - tTrust0;
         if (!rows.length)
             process.exit(0);
         if (isFeatureEnabled("CORTEX_FEATURE_AUTO_EXTRACT", true) && sessionId && detectedProject && cwd) {
-            const marker = sessionMarker(cortexPath, `extracted-${sessionId}-${detectedProject}`);
+            const marker = sessionMarker(getCortexPath(), `extracted-${sessionId}-${detectedProject}`);
             if (!fs.existsSync(marker)) {
                 try {
                     await handleExtractMemories(detectedProject, cwd, true);
@@ -113,7 +118,7 @@ export async function handleHookPrompt() {
             }
         }
         const tRank0 = Date.now();
-        rows = rankResults(rows, intent, gitCtx, detectedProject, cortexPath, db, cwd, keywords);
+        rows = rankResults(rows, intent, gitCtx, detectedProject, getCortexPath(), db, cwd, keywords);
         stage.rankMs = Date.now() - tRank0;
         if (!rows.length)
             process.exit(0);
@@ -155,7 +160,7 @@ export async function handleHookPrompt() {
             budgetUsedTokens = runningTokens;
             debugLog(`injection-budget: trimmed ${selected.length} -> ${kept.length} snippets to fit ${maxInjectTokens} token budget`);
         }
-        const parts = buildHookOutput(budgetSelected, budgetUsedTokens, intent, gitCtx, detectedProject, stage, safeTokenBudget, cortexPath, sessionId);
+        const parts = buildHookOutput(budgetSelected, budgetUsedTokens, intent, gitCtx, detectedProject, stage, safeTokenBudget, getCortexPath(), sessionId);
         // Add budget info to trace
         if (parts.length > 0) {
             const traceIdx = parts.findIndex(p => p.includes("trace:"));
@@ -165,17 +170,17 @@ export async function handleHookPrompt() {
         }
         const changedCount = gitCtx?.changedFiles.size ?? 0;
         if (sessionId) {
-            trackSessionMetrics(cortexPath, sessionId, selected, changedCount);
+            trackSessionMetrics(getCortexPath(), sessionId, selected, changedCount);
         }
-        flushEntryScores(cortexPath);
-        scheduleBackgroundMaintenance(cortexPath);
-        const noticeFile = sessionId ? sessionMarker(cortexPath, `noticed-${sessionId}`) : null;
+        flushEntryScores(getCortexPath());
+        scheduleBackgroundMaintenance(getCortexPath());
+        const noticeFile = sessionId ? sessionMarker(getCortexPath(), `noticed-${sessionId}`) : null;
         const alreadyNoticed = noticeFile ? fs.existsSync(noticeFile) : false;
         if (!alreadyNoticed) {
             // Clean up stale session markers (>24h old) from .sessions/ dir
             try {
                 const cutoff = Date.now() - 86400000;
-                const sessDir = sessionsDir(cortexPath);
+                const sessDir = sessionsDir(getCortexPath());
                 if (fs.existsSync(sessDir)) {
                     for (const f of fs.readdirSync(sessDir)) {
                         if (!f.startsWith("noticed-") && !f.startsWith("extracted-"))
@@ -186,10 +191,10 @@ export async function handleHookPrompt() {
                     }
                 }
                 // Also clean legacy markers from root
-                for (const f of fs.readdirSync(cortexPath)) {
+                for (const f of fs.readdirSync(getCortexPath())) {
                     if (!f.startsWith(".noticed-") && !f.startsWith(".extracted-"))
                         continue;
-                    const fp = `${cortexPath}/${f}`;
+                    const fp = `${getCortexPath()}/${f}`;
                     try {
                         fs.unlinkSync(fp);
                     }
@@ -199,7 +204,7 @@ export async function handleHookPrompt() {
             catch (err) {
                 debugLog(`stale notice cleanup failed: ${err instanceof Error ? err.message : String(err)}`);
             }
-            const needed = checkConsolidationNeeded(cortexPath, profile);
+            const needed = checkConsolidationNeeded(getCortexPath(), profile);
             if (needed.length > 0) {
                 const notices = needed.map((n) => {
                     const since = n.lastConsolidated ? ` since ${n.lastConsolidated}` : "";