cogpit-memory 0.1.3 → 0.1.5

package/README.md

@@ -40,14 +40,14 @@ cogpit-memory search "authentication"
 cogpit-memory sessions                              # Recent sessions (last 7 days)
 cogpit-memory sessions --cwd /path/to/project       # Filter by project
 cogpit-memory sessions --current --cwd /path/to/project  # Most recent for a project
-cogpit-memory sessions --max-age 30d --limit 50     # Custom window
+cogpit-memory sessions --max-age 90d --limit 50     # Custom window
 ```
 
 | Flag | Default | Description |
 |------|---------|-------------|
 | `--cwd` | all | Filter by working directory |
 | `--limit` | `20` | Max results |
-| `--max-age` | `7d` | Time window (`7d`, `12h`, `30d`) |
+| `--max-age` | `7d` | Time window — any duration (`7d`, `12h`, `90d`, `365d`) |
 | `--current` | — | Most recent session for `--cwd` |
 
 ### `context` — Layered session drill-down
@@ -72,16 +72,20 @@ cogpit-memory search "authentication"                        # Cross-session sea
 cogpit-memory search "auth" --session <sessionId>            # Single session
 cogpit-memory search "bug" --max-age 30d --limit 50          # Custom window
 cogpit-memory search "AuthProvider" --case-sensitive          # Case-sensitive
+cogpit-memory search "auth" --limit 200 --session-limit 50    # 50 unique sessions
+cogpit-memory search "bug" --session-limit 20 --hits-per-session 2  # Compact results
 ```
 
 | Flag | Default | Description |
 |------|---------|-------------|
 | `--session` | all | Scope to single session |
-| `--max-age` | `5d` | Time window |
-| `--limit` | `20` | Max returned hits |
+| `--max-age` | `5d` | Time window — any duration (`5d`, `30d`, `365d`) |
+| `--limit` | `20` | Max total hits returned |
+| `--session-limit` | all | Cap unique sessions in results |
+| `--hits-per-session` | all | Max hits kept per session |
 | `--case-sensitive` | `false` | Case sensitivity |
 
-Each hit includes a `location` string (e.g. `turn/3/assistantMessage`, `agent/a7f3bc2/toolCall/tc1/result`) that maps directly to L2/L3 drill-down commands.
+Each result includes the `cwd` (working directory where the session ran) and an array of hits. Each hit includes a `location` string (e.g. `turn/3/assistantMessage`, `agent/a7f3bc2/toolCall/tc1/result`) that maps directly to L2/L3 drill-down commands.
 
 ### `index` — Manage the FTS5 search index
 
@@ -151,9 +155,11 @@ Browse at [skills.sh](https://skills.sh).
 
 ### Install via cogpit-memory CLI
 
-Installs into a single project's `.claude/skills/`:
-
 ```bash
+# Install globally (all projects)
+npx cogpit-memory install-skill -g
+
+# Install into a single project's .claude/skills/
 npx cogpit-memory install-skill
 
 # Or specify a project directory

package/dist/cli.js

@@ -812,7 +812,7 @@ var SearchIndex = class {
     const caseSensitive = opts?.caseSensitive ?? false;
     const ftsQuery = `"${query.replace(/"/g, '""')}"`;
     let sql = `
-      SELECT sc.session_id, sc.location,
+      SELECT sc.session_id, sc.source_file, sc.location,
              snippet(search_content, 3, '', '', '...', 120) as snippet
       FROM search_content sc
     `;
@@ -835,6 +835,7 @@ var SearchIndex = class {
     const rows = this.db.prepare(sql).all(...params);
     let hits = rows.map((row) => ({
       sessionId: row.session_id,
+      filePath: row.source_file,
       location: row.location,
       snippet: row.snippet,
       matchCount: 1
@@ -1213,20 +1214,21 @@ async function searchSessions(query, opts, searchIndex) {
       });
       const grouped = /* @__PURE__ */ new Map();
       for (const hit of hits) {
-        let sessionHits = grouped.get(hit.sessionId);
-        if (!sessionHits) {
-          sessionHits = [];
-          grouped.set(hit.sessionId, sessionHits);
+        let entry = grouped.get(hit.sessionId);
+        if (!entry) {
+          entry = { filePath: hit.filePath, hits: [] };
+          grouped.set(hit.sessionId, entry);
         }
-        sessionHits.push({
+        entry.hits.push({
           location: hit.location,
           snippet: hit.snippet,
           matchCount: hit.matchCount
         });
       }
       const results = [];
-      for (const [sid, sessionHits] of grouped) {
-        results.push({ sessionId: sid, hits: sessionHits });
+      for (const [sid, entry] of grouped) {
+        const cwd = await cwdFromFilePath(entry.filePath);
+        results.push({ sessionId: sid, cwd, hits: entry.hits });
       }
       let totalHits = hits.length;
       let sessionsSearched = grouped.size;
@@ -1252,6 +1254,37 @@ async function searchSessions(query, opts, searchIndex) {
   }
   return rawScanSearch(query, opts.sessionId ?? null, maxAgeMs, limit, caseSensitive, depth);
 }
+var CWD_READ_BYTES = 4096;
+var cwdCache = /* @__PURE__ */ new Map();
+async function cwdFromFilePath(filePath) {
+  const cached = cwdCache.get(filePath);
+  if (cached !== void 0) return cached;
+  try {
+    const fh = await (0, import_promises2.open)(filePath, "r");
+    try {
+      const buf = Buffer.alloc(CWD_READ_BYTES);
+      const { bytesRead } = await fh.read(buf, 0, CWD_READ_BYTES, 0);
+      const head = buf.subarray(0, bytesRead).toString("utf-8");
+      const lines = head.split("\n", 10);
+      for (const line of lines) {
+        if (!line) continue;
+        try {
+          const obj = JSON.parse(line);
+          if (obj.cwd) {
+            cwdCache.set(filePath, obj.cwd);
+            return obj.cwd;
+          }
+        } catch {
+        }
+      }
+    } finally {
+      await fh.close();
+    }
+  } catch {
+  }
+  cwdCache.set(filePath, "");
+  return "";
+}
 var SNIPPET_WINDOW = 150;
 function generateSnippet(text, matchIdx, queryLen) {
   if (matchIdx === -1) return text.slice(0, SNIPPET_WINDOW);
@@ -1450,6 +1483,7 @@ async function rawScanSearch(query, sessionId, maxAgeMs, limit, caseSensitive, d
       totalHits += allHits.length;
       const sessionResult = {
         sessionId: session.sessionId || (0, import_node_path4.basename)(file.path, ".jsonl"),
+        cwd: session.cwd || "",
         hits: []
       };
       for (const hit of allHits) {
@@ -1469,7 +1503,7 @@ async function rawScanSearch(query, sessionId, maxAgeMs, limit, caseSensitive, d
       sessionsSearched,
       results
     };
-  } catch (err) {
+  } catch {
     return {
       query,
       totalHits: 0,
@@ -2093,9 +2127,9 @@ function findSkillContent() {
   }
   throw new Error("Could not find SKILL.md \u2014 try reinstalling cogpit-memory");
 }
-function installSkill(cwd) {
-  const root = cwd ?? process.cwd();
-  const skillDir = (0, import_node_path8.join)(root, ".claude", "skills", "cogpit-memory");
+function installSkill(cwd, global) {
+  const root = global ? (0, import_node_path8.join)(process.env.HOME ?? process.env.USERPROFILE ?? "~", ".claude") : (0, import_node_path8.join)(cwd ?? process.cwd(), ".claude");
+  const skillDir = (0, import_node_path8.join)(root, "skills", "cogpit-memory");
   (0, import_node_fs4.mkdirSync)(skillDir, { recursive: true });
   const content = findSkillContent();
   const dest = (0, import_node_path8.join)(skillDir, "SKILL.md");
@@ -2121,6 +2155,12 @@ function parseArgs(argv) {
           case "--limit":
             args.limit = parseInt(argv[++i], 10);
             break;
+          case "--session-limit":
+            args.sessionLimit = parseInt(argv[++i], 10);
+            break;
+          case "--hits-per-session":
+            args.hitsPerSession = parseInt(argv[++i], 10);
+            break;
           case "--case-sensitive":
             args.caseSensitive = true;
             break;
@@ -2171,6 +2211,10 @@ function parseArgs(argv) {
           case "--cwd":
             args.cwd = argv[++i];
             break;
+          case "-g":
+          case "--global":
+            args.global = true;
+            break;
         }
       }
       break;
@@ -2198,6 +2242,15 @@ async function main() {
         limit: cmd.args.limit,
         caseSensitive: cmd.args.caseSensitive
       });
+      if (result && !("error" in result) && (cmd.args.sessionLimit || cmd.args.hitsPerSession)) {
+        const sl = cmd.args.sessionLimit ?? result.results.length;
+        const hpp = cmd.args.hitsPerSession ?? Infinity;
+        result.results = result.results.slice(0, sl).map((sr) => ({
+          ...sr,
+          hits: sr.hits.slice(0, hpp)
+        }));
+        result.returnedHits = result.results.reduce((n, sr) => n + sr.hits.length, 0);
+      }
       break;
     case "context":
       if (!cmd.args.sessionId) {
@@ -2233,7 +2286,7 @@ async function main() {
       }
       break;
     case "install-skill":
-      result = installSkill(cmd.args.cwd);
+      result = installSkill(cmd.args.cwd, cmd.args.global);
       break;
     default:
       console.error(JSON.stringify({ error: `Unknown command: ${cmd.command}` }));
@@ -2250,6 +2303,8 @@ Commands:
     --session <id>            Scope to single session
     --max-age <5d>            Time window (default: 5d)
     --limit <20>              Max hits (default: 20)
+    --session-limit <N>       Cap unique sessions returned
+    --hits-per-session <N>    Max hits kept per session
     --case-sensitive          Case sensitive matching
 
   context <sessionId>         Session overview (L1)
@@ -2265,7 +2320,9 @@ Commands:
   index stats                 Show index stats
   index rebuild               Rebuild full index
 
-  install-skill [--cwd path]  Install Claude Code skill to .claude/skills/
+  install-skill [options]      Install Claude Code skill
+    --cwd <path>              Target project directory
+    -g, --global              Install to ~/.claude/skills/ (all projects)
 `);
 }
 var isBunCompiled = false;

package/dist/index.js

@@ -898,7 +898,7 @@ var SearchIndex = class {
     const caseSensitive = opts?.caseSensitive ?? false;
     const ftsQuery = `"${query.replace(/"/g, '""')}"`;
     let sql = `
-      SELECT sc.session_id, sc.location,
+      SELECT sc.session_id, sc.source_file, sc.location,
              snippet(search_content, 3, '', '', '...', 120) as snippet
       FROM search_content sc
     `;
@@ -921,6 +921,7 @@ var SearchIndex = class {
     const rows = this.db.prepare(sql).all(...params);
     let hits = rows.map((row) => ({
       sessionId: row.session_id,
+      filePath: row.source_file,
       location: row.location,
       snippet: row.snippet,
       matchCount: 1
@@ -1304,20 +1305,21 @@ async function searchSessions(query, opts, searchIndex) {
       });
       const grouped = /* @__PURE__ */ new Map();
       for (const hit of hits) {
-        let sessionHits = grouped.get(hit.sessionId);
-        if (!sessionHits) {
-          sessionHits = [];
-          grouped.set(hit.sessionId, sessionHits);
+        let entry = grouped.get(hit.sessionId);
+        if (!entry) {
+          entry = { filePath: hit.filePath, hits: [] };
+          grouped.set(hit.sessionId, entry);
         }
-        sessionHits.push({
+        entry.hits.push({
           location: hit.location,
           snippet: hit.snippet,
           matchCount: hit.matchCount
         });
       }
       const results = [];
-      for (const [sid, sessionHits] of grouped) {
-        results.push({ sessionId: sid, hits: sessionHits });
+      for (const [sid, entry] of grouped) {
+        const cwd = await cwdFromFilePath(entry.filePath);
+        results.push({ sessionId: sid, cwd, hits: entry.hits });
       }
       let totalHits = hits.length;
       let sessionsSearched = grouped.size;
@@ -1343,6 +1345,37 @@ async function searchSessions(query, opts, searchIndex) {
   }
   return rawScanSearch(query, opts.sessionId ?? null, maxAgeMs, limit, caseSensitive, depth);
 }
+var CWD_READ_BYTES = 4096;
+var cwdCache = /* @__PURE__ */ new Map();
+async function cwdFromFilePath(filePath) {
+  const cached = cwdCache.get(filePath);
+  if (cached !== void 0) return cached;
+  try {
+    const fh = await (0, import_promises2.open)(filePath, "r");
+    try {
+      const buf = Buffer.alloc(CWD_READ_BYTES);
+      const { bytesRead } = await fh.read(buf, 0, CWD_READ_BYTES, 0);
+      const head = buf.subarray(0, bytesRead).toString("utf-8");
+      const lines = head.split("\n", 10);
+      for (const line of lines) {
+        if (!line) continue;
+        try {
+          const obj = JSON.parse(line);
+          if (obj.cwd) {
+            cwdCache.set(filePath, obj.cwd);
+            return obj.cwd;
+          }
+        } catch {
+        }
+      }
+    } finally {
+      await fh.close();
+    }
+  } catch {
+  }
+  cwdCache.set(filePath, "");
+  return "";
+}
 var SNIPPET_WINDOW = 150;
 function generateSnippet(text, matchIdx, queryLen) {
   if (matchIdx === -1) return text.slice(0, SNIPPET_WINDOW);
@@ -1541,6 +1574,7 @@ async function rawScanSearch(query, sessionId, maxAgeMs, limit, caseSensitive, d
       totalHits += allHits.length;
       const sessionResult = {
         sessionId: session.sessionId || (0, import_node_path4.basename)(file.path, ".jsonl"),
+        cwd: session.cwd || "",
         hits: []
       };
       for (const hit of allHits) {
@@ -1560,7 +1594,7 @@ async function rawScanSearch(query, sessionId, maxAgeMs, limit, caseSensitive, d
       sessionsSearched,
       results
     };
-  } catch (err) {
+  } catch {
     return {
       query,
       totalHits: 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cogpit-memory",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "CLI tool for Claude Code session introspection — search, browse, and drill into past sessions",
   "main": "./dist/index.js",
   "types": "./src/index.ts",

package/skill/SKILL.md

@@ -248,7 +248,9 @@ bunx cogpit-memory search "AuthProvider" --case-sensitive
 |------|---------|-------------|
 | `--session` | all sessions | Scope to single session |
 | `--max-age` | `5d` | Time window: `5d`, `12h`, `30d` |
-| `--limit` | `20` | Max returned hits |
+| `--limit` | `20` | Max total hits returned |
+| `--session-limit` | all | Cap unique sessions in results |
+| `--hits-per-session` | all | Max hits kept per session |
 | `--case-sensitive` | `false` | Case sensitivity |
 
 ### Response shape
@@ -262,6 +264,7 @@ bunx cogpit-memory search "AuthProvider" --case-sensitive
   "results": [
     {
       "sessionId": "abc-123",
+      "cwd": "/path/to/project",
       "hits": [
         {
           "location": "turn/3/userMessage",