cc-dejavu 0.2.0 → 0.3.0

package/README.md

@@ -36,19 +36,19 @@ Every bash command Claude Code runs is logged in session files. `deja` indexes t
 
 ## Features
 
-- **Frecency-based sorting** - Commands are ranked by a combination of frequency and recency, so your most useful commands appear first
+- **Smart ranking** - Combines BM25 relevance with frecency (frequency + recency) so the most useful commands appear first
+- **Full-text search** - Uses SQLite FTS5 for fast, typo-tolerant searching
 - **Match highlighting** - Search patterns are highlighted in yellow in the output
 - **Automatic sync** - History is automatically synced before each search
 
 ## Install
 
+Requires [Bun](https://bun.sh).
+
 ```bash
-# With Bun (recommended)
+# Install globally
 bun add -g cc-dejavu
 
-# With npm
-npm install -g cc-dejavu
-
 # Or build from source
 git clone https://github.com/Michaelliv/cc-dejavu
 cd cc-dejavu
@@ -146,16 +146,20 @@ Index new commands from Claude Code sessions.
 |------|-------------|
 | `--force`, `-f` | Re-index all sessions from scratch |
 
-## Frecency Algorithm
+## Ranking Algorithm
+
+Results are ranked by combining **BM25 relevance** with **frecency** (frequency + recency):
 
-Results are sorted by "frecency" - a combination of frequency and recency:
+```
+score = frecency × (0.5 + normalized_bm25)
+```
 
-- **Recency weights**: Commands run in the last 4 hours score highest, with decreasing weights for last day, week, month, and older
-- **Frequency**: Uses logarithmic scaling to prevent very frequent commands from dominating
+- **BM25**: Search terms that are more prominent in a command score higher. "build" in `bun run build` ranks higher than "build" buried in a long command.
+- **Frecency**: Commands you run often and recently score higher. Uses logarithmic scaling for frequency and time-decay weights for recency.
 
-This means recently-used commands you run often appear at the top, while one-off commands from months ago sink to the bottom.
+This means a command that closely matches your search AND you use frequently will appear at the top.
 
-Use `--sort time` to revert to simple timestamp ordering.
+Use `--sort time` to revert to simple timestamp ordering (ignores BM25 and frecency).
 
 ## How It Works
 

package/package.json

@@ -1,13 +1,21 @@
 {
   "name": "cc-dejavu",
-  "version": "0.2.0",
-  "description": "CLI tool to search and browse Claude Code bash command history",
-  "license": "MIT",
-  "type": "module",
+  "version": "0.3.0",
+  "author": "Michaelliv",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Michaelliv/cc-dejavu.git"
   },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "bin": {
+    "deja": "./dist/index.js"
+  },
+  "description": "CLI tool to search and browse Claude Code bash command history",
+  "files": [
+    "dist"
+  ],
   "keywords": [
     "claude",
     "claude-code",
@@ -17,25 +25,12 @@
     "search",
     "dejavu"
   ],
-  "author": "Michaelliv",
-  "bin": {
-    "deja": "./dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
+  "license": "MIT",
   "scripts": {
     "dev": "bun run src/index.ts",
     "build": "bun build --compile --outfile=deja ./src/index.ts",
-    "build:npm": "bun build ./src/index.ts --outdir ./dist --target node",
     "test": "bun test",
-    "prepublishOnly": "bun run build:npm",
     "postinstall": "echo '\n  Run \"deja onboard\" to add deja to ~/.claude/CLAUDE.md\n'"
   },
-  "dependencies": {
-    "sql.js": "^1.13.0"
-  },
-  "devDependencies": {
-    "@types/bun": "latest"
-  }
+  "type": "module"
 }