cogpit-memory 0.1.9 → 0.1.10

package/README.md

@@ -1,9 +1,16 @@
 # cogpit-memory
 
-CLI tool that gives any AI assistant memory of past [Claude Code](https://docs.anthropic.com/en/docs/claude-code) sessions. Retrieve conversation history, tool usage, thinking blocks, sub-agent activity, and full-text search across all sessions.
+CLI tool that gives any AI assistant memory of past Claude Code and Codex
+sessions. Browse either provider's conversation history, tool usage, thinking
+blocks, and sub-agent activity. Cross-session FTS search currently indexes
+Claude Code history.
 
 All output is JSON to stdout — designed for programmatic consumption by AI agents.
 
+Session compatibility is validated against Claude Code 2.1.217 and Codex CLI
+0.145.0. The parser also retains backward compatibility with older rollout
+formats covered by the test suite.
+
 ## Install
 
 ```bash
@@ -120,16 +127,27 @@ FTS5 trigram search is sublinear — doubling the index size does not double que
 
 ## How It Works
 
-cogpit-memory reads Claude Code's JSONL session files from `~/.claude/projects/`. It parses the conversation structure (turns, tool calls, thinking blocks, sub-agents) and provides a layered drill-down interface.
+Session discovery and context commands read Claude Code JSONL history from
+`~/.claude/projects/` and Codex JSONL history from `~/.codex/sessions/`. The
+shared parser normalizes each provider into the same conversation structure
+(turns, tool calls, thinking blocks, and sub-agents) for layered drill-down.
 
-For search, it maintains an FTS5 trigram index at `~/.claude/cogpit-memory/search-index.db`. The trigram tokenizer enables substring matching (not just whole-word) — searching for `"auth"` matches `"authentication"`, `"OAuth"`, and `"AuthProvider"`.
+Cross-session search currently builds its FTS5 trigram index from the Claude
+project tree and stores it at `~/.claude/cogpit-memory/search-index.db`. The
+trigram tokenizer enables substring matching (not just whole-word) — searching
+for `"auth"` matches `"authentication"`, `"OAuth"`, and `"AuthProvider"`.
 
 ## Development
 
-Requires [Bun](https://bun.sh) for development (source uses `bun:sqlite`). The npm build uses `better-sqlite3` for Node.js compatibility via an esbuild alias.
+The npm package requires Node.js 20 or newer. Development requires [Bun](https://bun.sh) because the source uses `bun:sqlite`; the npm build substitutes `better-sqlite3` through an esbuild alias.
+
+The session parser under `src/lib/` is generated from Cogpit's canonical
+`shared/session/` implementation. Edit the shared copy, then run
+`bun run sync-cogpit-memory` from the Cogpit repository root. CI runs
+`bun run check:cogpit-memory-sync` and rejects drift.
 
 ```bash
-# Run tests (82 tests)
+# Run tests
 bun test
 
 # Build compiled binary (Bun, uses bun:sqlite)
@@ -137,6 +155,9 @@ bun run build
 
 # Build for npm (Node.js, uses better-sqlite3)
 bun run build:npm
+
+# Verify built CommonJS, declarations, public exports, CLI, and npm tarball
+bun run test:contracts
 ```
 
 ## Agent Skill

package/dist/cli.d.ts

@@ -0,0 +1,30 @@
+/**
+ * cogpit-memory CLI — query Claude Code session history.
+ *
+ * Usage:
+ *   cogpit-memory search <query> [options]
+ *   cogpit-memory context <sessionId> [--turn N] [--agent ID]
+ *   cogpit-memory sessions [--cwd path] [--current] [--limit N] [--max-age 7d]
+ *   cogpit-memory index stats|rebuild
+ */
+export interface CLICommand {
+    command: string;
+    args: CLIArguments;
+}
+export interface CLIArguments {
+    query?: string;
+    session?: string;
+    maxAge?: string;
+    limit?: number;
+    sessionLimit?: number;
+    hitsPerSession?: number;
+    caseSensitive?: boolean;
+    sessionId?: string;
+    turnIndex?: number;
+    agentId?: string;
+    cwd?: string;
+    current?: boolean;
+    subcommand?: string;
+    global?: boolean;
+}
+export declare function parseArgs(argv: string[]): CLICommand;