cogpit-memory 0.1.4 → 0.1.5

package/README.md

@@ -72,13 +72,17 @@ 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 — any duration (`5d`, `30d`, `365d`) |
-| `--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 |
 
 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.

package/dist/cli.js

@@ -1503,7 +1503,7 @@ async function rawScanSearch(query, sessionId, maxAgeMs, limit, caseSensitive, d
       sessionsSearched,
       results
     };
-  } catch (err) {
+  } catch {
     return {
       query,
       totalHits: 0,
@@ -2155,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;
@@ -2236,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) {
@@ -2288,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)

package/dist/index.js

@@ -1594,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.4",
+  "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