codex-dev-mcp-suite 3.1.1 → 3.2.0

package/CHANGELOG.md

@@ -1,37 +1,13 @@
-## 1.8.0 - 2026-07-22
-
-### Added
-- **Zero-Dependency Local Offline Vector Embedding Engine**:
-  - Pure JS 384-dimensional term-frequency hashing vector engine with sublinear $1 + \log(tf)$ scaling and L2 normalization (`project-memory/local-embed.js`).
-  - Activated via `MCP_LOCAL_EMBED=true` / `LOCAL_EMBED=true` env flag when no remote embedding API key is available.
-  - Sub-millisecond execution, zero network calls, zero external npm dependencies.
-  - Full compatibility with existing `cosine(a, b)` and graph ranking in `project-memory`.
-- **Universal Multi-Client Guides**:
-  - Hermes Agent setup guide (`docs/clients/hermes.md`).
-  - Google Antigravity CLI (AGY CLI) setup guide (`docs/clients/antigravity.md`).
-  - Claude Code & Generic MCP setup guides (`docs/clients/claude-code.md`, `docs/clients/generic-mcp.md`).
-- **Test Suite**: 100/100 unit tests passing (100% green across 8 test suites).
+# Changelog
 
-## 1.7.0 - 2026-07-22
+## 3.2.0 - 2026-07-27 — Session Conversation Watchdog & Transcript Digesting 🧠
 
 ### Added
-- **Obsidian Vault Parity & MOC Tools**:
-  - `memory_moc` Map of Content generator & `.obsidian` vault structure integration.
-  - `memory_graph` knowledge graph visualization & backlinks.
-- **Codebase Security Audit Tool (`pack_audit`)**:
-  - Detect missing `.gitignore`, exposed secrets/keys (`.env`, `.pem`, `id_rsa`), and overly large files.
-
-## 1.5.0
-
-- add `memory_link` with wiki-link resolution for `[[id]]`, `[[title]]`, `[[project:id]]`, and `[[project:title]]`, plus backlink inspection
-- add `memory_global_recall` with same-project bias and graceful keyword/semantic fallback across project vaults
-- add `memory_dedup` with non-destructive duplicate suggestions for project or global scope
-- add hybrid lazy graph backfill so link metadata is derived on first graph-aware use and remains rebuildable from canonical notes
-- add graph-aware soft boost in recall paths without making embeddings mandatory
-- 36 project-memory tests pass after graph/global/dedup coverage expansion
-
-# Changelog
-
+- **Session Conversation Watchdog & Transcript Digesting (`project-memory`)**:
+  - Added `scanSessionLogs()` helper in `auto-indexer.js` to autonomously scan recent `.jsonl`, `.json`, or `.log` session transcript files across `.codex/`, `.gemini/`, `.agents/logs/`, and custom session directories.
+  - Heuristic keyword analysis automatically detects architectural decisions, migration plans, and strategy discussions (e.g., V1 vs V2 trading bots).
+  - Upgraded `memory_auto_index` tool schema (`server.js`) with `scanSessions` and `sessionDir` parameters.
+  - Auto-derived decisions are now persisted directly into the Obsidian knowledge vault as individual notes (`notesCreated`), ensuring key chat discussions are permanently indexed and searchable via `memory_recall`.
 ## 3.1.1 - 2026-07-22 — CI/CD Hardening & Complete Wizard Tracking 🛡️
 
 ### Fixed
@@ -80,6 +56,39 @@
   - Notifies users via `stderr` when a new version of `codex-dev-mcp-suite` is published to upstream npm.
   - Safe for stdio MCP JSON-RPC protocol transport; sub-millisecond execution, zero startup latency.
 
+## 1.8.0 - 2026-07-22
+
+### Added
+- **Zero-Dependency Local Offline Vector Embedding Engine**:
+  - Pure JS 384-dimensional term-frequency hashing vector engine with sublinear $1 + \log(tf)$ scaling and L2 normalization (`project-memory/local-embed.js`).
+  - Activated via `MCP_LOCAL_EMBED=true` / `LOCAL_EMBED=true` env flag when no remote embedding API key is available.
+  - Sub-millisecond execution, zero network calls, zero external npm dependencies.
+  - Full compatibility with existing `cosine(a, b)` and graph ranking in `project-memory`.
+- **Universal Multi-Client Guides**:
+  - Hermes Agent setup guide (`docs/clients/hermes.md`).
+  - Google Antigravity CLI (AGY CLI) setup guide (`docs/clients/antigravity.md`).
+  - Claude Code & Generic MCP setup guides (`docs/clients/claude-code.md`, `docs/clients/generic-mcp.md`).
+- **Test Suite**: 100/100 unit tests passing (100% green across 8 test suites).
+
+## 1.7.0 - 2026-07-22
+
+### Added
+- **Obsidian Vault Parity & MOC Tools**:
+  - `memory_moc` Map of Content generator & `.obsidian` vault structure integration.
+  - `memory_graph` knowledge graph visualization & backlinks.
+- **Codebase Security Audit Tool (`pack_audit`)**:
+  - Detect missing `.gitignore`, exposed secrets/keys (`.env`, `.pem`, `id_rsa`), and overly large files.
+
+## 1.5.0
+
+- add `memory_link` with wiki-link resolution for `[[id]]`, `[[title]]`, `[[project:id]]`, and `[[project:title]]`, plus backlink inspection
+- add `memory_global_recall` with same-project bias and graceful keyword/semantic fallback across project vaults
+- add `memory_dedup` with non-destructive duplicate suggestions for project or global scope
+- add hybrid lazy graph backfill so link metadata is derived on first graph-aware use and remains rebuildable from canonical notes
+- add graph-aware soft boost in recall paths without making embeddings mandatory
+- 36 project-memory tests pass after graph/global/dedup coverage expansion
+
+
 ## 1.4.0 - 2026-06-17
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-dev-mcp-suite",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "description": "Four local, file-based MCP servers for solo devs/vibecoders: persistent project memory, session handoff/resume, git-independent file checkpoints, and token-efficient project briefings. Works with any MCP client.",
   "type": "module",
   "license": "MIT",

package/project-memory/auto-indexer.js

@@ -1,14 +1,97 @@
 /**
- * Autonomous Background Git & Mtime Observer for project-memory.
- * Inspects recent git commits and modified file mtimes to auto-derive
- * project notes and update the Obsidian knowledge vault without manual prompts.
+ * Autonomous Background Git, Mtime & Session Watchdog Observer for project-memory.
+ * Inspects recent git commits, modified file mtimes, and chat session transcripts
+ * to auto-derive project notes, extract architectural decisions, and update the
+ * Obsidian knowledge vault without manual prompts.
  */
 
 import fs from "fs/promises";
 import path from "path";
 import { execSync } from "child_process";
 
-export async function runAutoIndexer(projectDir, { dryRun = false } = {}) {
+async function scanSessionLogs(root, customSessionDir) {
+  const decisions = [];
+  const candidateDirs = customSessionDir
+    ? [path.resolve(root, customSessionDir)]
+    : [
+        path.join(root, ".codex", "sessions"),
+        path.join(root, ".codex"),
+        path.join(root, ".gemini", "logs"),
+        path.join(root, ".gemini"),
+        path.join(root, ".agents", "logs"),
+        path.join(root, "logs"),
+      ];
+
+  const filesToScan = [];
+  for (const d of candidateDirs) {
+    try {
+      const stat = await fs.stat(d);
+      if (stat.isFile() && (d.endsWith(".jsonl") || d.endsWith(".log") || d.endsWith(".json"))) {
+        filesToScan.push(d);
+        continue;
+      }
+      if (stat.isDirectory()) {
+        const entries = await fs.readdir(d, { withFileTypes: true });
+        for (const e of entries) {
+          if (e.isFile() && (e.name.endsWith(".jsonl") || e.name.endsWith(".log") || e.name.endsWith(".json") || e.name.includes("history"))) {
+            filesToScan.push(path.join(d, e.name));
+          }
+        }
+      }
+    } catch {}
+  }
+
+  const fileStats = [];
+  for (const f of filesToScan) {
+    try {
+      const s = await fs.stat(f);
+      fileStats.push({ file: f, mtime: s.mtimeMs });
+    } catch {}
+  }
+  fileStats.sort((a, b) => b.mtime - a.mtime);
+  const topFiles = fileStats.slice(0, 5).map((x) => x.file);
+
+  const keywordRegex = /\b(v1|v2|v3|vs|versus|architecture|arsitektur|migration|migrasi|decision|keputusan|strategy|strategi|refactor|database|schema|tradeoff|perbedaan|kesimpulan|monolith|microservice)\b/i;
+
+  for (const file of topFiles) {
+    try {
+      const raw = await fs.readFile(file, "utf8");
+      const lines = raw.split("\n").filter((l) => l.trim());
+      for (const line of lines) {
+        let text = "";
+        let role = "unknown";
+        try {
+          const parsed = JSON.parse(line);
+          text = typeof parsed === "string" ? parsed : parsed.content || parsed.text || parsed.message || JSON.stringify(parsed);
+          role = parsed.type || parsed.role || parsed.source || "log";
+        } catch {
+          text = line;
+        }
+
+        if (typeof text !== "string" || text.length < 20) continue;
+
+        const match = text.match(keywordRegex);
+        if (match) {
+          const keyword = match[0].toLowerCase();
+          const cleanText = text.replace(/\s+/g, " ").trim();
+          const snippet = cleanText.length > 300 ? cleanText.substring(0, 300) + "..." : cleanText;
+          decisions.push({
+            keyword,
+            role: String(role),
+            snippet,
+            file: path.relative(root, file) || path.basename(file),
+          });
+          if (decisions.length >= 10) break;
+        }
+      }
+    } catch {}
+    if (decisions.length >= 10) break;
+  }
+
+  return decisions;
+}
+
+export async function runAutoIndexer(projectDir, { dryRun = false, scanSessions = true, sessionDir = null } = {}) {
   const root = path.resolve(projectDir || process.cwd());
   const notesCreated = [];
 
@@ -25,19 +108,44 @@ export async function runAutoIndexer(projectDir, { dryRun = false } = {}) {
     branch = execSync("git branch --show-current", { cwd: root, encoding: "utf8" }).trim();
   } catch {}
 
-  const summary = [
+  // 3. Inspect recent session transcripts / chat logs if enabled
+  let sessionDecisions = [];
+  if (scanSessions) {
+    sessionDecisions = await scanSessionLogs(root, sessionDir);
+  }
+
+  const summaryLines = [
     `# Auto-Derived Knowledge Snapshot: ${path.basename(root)}`,
     `Active Branch: \`${branch}\``,
     `Inspected At: ${new Date().toISOString()}`,
     ``,
     `## 📜 Recent Git Activity`,
     ...(gitLogs.length ? gitLogs.map((l) => `- \`${l}\``) : ["- No git history found"]),
-  ].join("\n");
+  ];
+
+  if (sessionDecisions.length > 0) {
+    summaryLines.push(``, `## 💬 Session Conversation Digest (Watchdog)`);
+    const seenKeywords = new Set();
+    for (const d of sessionDecisions) {
+      summaryLines.push(`- **[${d.keyword.toUpperCase()}]** (${d.file}): ${d.snippet}`);
+      if (!seenKeywords.has(d.keyword)) {
+        seenKeywords.add(d.keyword);
+        notesCreated.push({
+          title: `Session Digest: ${d.keyword.toUpperCase()} Discussion (${new Date().toISOString().substring(0, 10)})`,
+          content: `# Session Digest: ${d.keyword.toUpperCase()} Discussion\n\nExtracted from conversation watchdog on branch \`${branch}\` (Source: \`${d.file}\`).\n\n## Discussion Context\n\n- **Role (${d.role})**: ${d.snippet}\n`,
+          tags: ["session-digest", "watchdog", d.keyword.toLowerCase()],
+        });
+      }
+    }
+  }
+
+  const summary = summaryLines.join("\n");
 
   return {
     projectDir: root,
     branch,
     recentCommits: gitLogs,
+    sessionDecisions,
     summaryText: summary,
     notesCreated,
   };

package/project-memory/server.js

@@ -437,12 +437,14 @@ class ProjectMemoryServer {
         },
         {
           name: "memory_auto_index",
-          description: "Run autonomous background observer to inspect git commits, branch switches, and file modifications to auto-derive project notes.",
+          description: "Run autonomous background observer to inspect git commits, branch switches, file modifications, and chat session transcripts to auto-derive project notes and architectural decisions.",
           inputSchema: {
             type: "object",
             properties: {
               dir: { type: "string", description: "Project directory (defaults to CWD)" },
               dryRun: { type: "boolean", description: "Preview derived knowledge without saving", default: false },
+              scanSessions: { type: "boolean", description: "Scan recent chat session logs/transcripts to auto-extract architectural decisions and key discussions", default: true },
+              sessionDir: { type: "string", description: "Optional custom directory containing session JSONL logs" },
             },
           },
         },
@@ -876,17 +878,26 @@ class ProjectMemoryServer {
     return { content: [{ type: "text", text: lines.join("\n") }] };
   }
 
-  async autoIndex({ dir, dryRun = false } = {}) {
+  async autoIndex({ dir, dryRun = false, scanSessions = true, sessionDir = null } = {}) {
     const p = this.paths(dir);
-    const res = await runAutoIndexer(dir, { dryRun });
+    const res = await runAutoIndexer(dir, { dryRun, scanSessions, sessionDir });
     if (!dryRun && res.summaryText) {
       await this.save({
         title: `Auto-Index ${new Date().toISOString().substring(0, 10)} (${res.branch})`,
         content: res.summaryText,
         dir,
-        tags: ["auto-index", "git"],
+        tags: ["auto-index", "git", "session-digest"],
         kind: "auto-derived"
       });
+      for (const note of (res.notesCreated || [])) {
+        await this.save({
+          title: note.title,
+          content: note.content,
+          dir,
+          tags: note.tags || ["session-digest", "auto-derived"],
+          kind: "session-digest"
+        });
+      }
     }
     return { content: [{ type: "text", text: res.summaryText + (dryRun ? "\n\n(Dry Run — note not saved)" : "\n\n(Saved to project memory vault)") }] };
   }