lens-engine 0.1.13 → 0.1.14

package/README.md

@@ -46,14 +46,18 @@ Context pack: 12 files, 3.2KB
 
 Your code never leaves your machine. No cloud dependency for local usage.
 
-## Daemon
+## Daemon & Dashboard
 
-Runs on port 4111. Serves the REST API, MCP stdio, and local dashboard.
+The daemon runs on port 4111 — serves the REST API, MCP stdio, and a full local dashboard. Manage repos, watch indexing jobs, build context packs, and browse indexed data from the browser.
 
 ```sh
 lens daemon start
-lens dashboard
+lens dashboard          # opens http://localhost:4111/dashboard/
+```
+
+Dashboard pages: **Overview** (system stats, repo cards), **Context** (interactive query builder), **Repositories** (status table), **Jobs** (indexing progress), **Requests** (live log), **Data Browser**, **Usage**, **Billing**.
 
+```sh
 # REST API
 curl http://localhost:4111/context \
   -H "Content-Type: application/json" \
@@ -62,7 +66,7 @@ curl http://localhost:4111/context \
 
 ## MCP Integration
 
-Add `.mcp.json` to your project root. Claude Code, Cursor, and any MCP-compatible agent auto-discovers LENS:
+`lens repo register` writes `.mcp.json` automatically. Claude Code, Cursor, and any MCP-compatible agent auto-discovers LENS. To re-create it manually: `lens repo mcp`.
 
 ```json
 {
@@ -77,14 +81,33 @@ Add `.mcp.json` to your project root. Claude Code, Cursor, and any MCP-compatibl
 
 ## Pro
 
-Authenticate to unlock Voyage semantic embeddings, purpose summaries, and vocab clusters. Adds ~100-300ms for semantic vector search on top of the base retrieval.
+LENS is free for local use — TF-IDF, import graph, co-change, and caching all work without an account. Pro unlocks two additional pipeline stages that improve retrieval accuracy for larger or more complex codebases.
+
+### Semantic Embeddings
+
+Every file chunk is embedded for semantic search. LENS runs cosine similarity against all vectors to find files that are semantically relevant — even when they share zero keywords with your prompt.
+
+> **Example:** Query `"handle expired sessions"` surfaces `tokenRefresh.ts` and `authMiddleware.ts`. Neither contains the word "session".
+
+### Vocab Clusters
+
+Export names across your repo are embedded and clustered by cosine similarity (threshold >0.75). When a query matches one term in a cluster, all related terms are pulled in — automatic query expansion tuned to your codebase.
+
+> **Example:** Query `"auth"` expands to `verifyToken`, `sessionMiddleware`, `loginHandler`, `requireAuth`.
+
+Together they add ~100-300ms per query. After logging in, run `lens index --force` to embed everything immediately, or leave it — LENS embeds new and changed files on each incremental index, so coverage grows automatically as you work.
 
 ```sh
-lens login
+lens login --github
+# Authenticated as user@example.com
+
 lens status
 # Pro: active
 # Embeddings: 847/847 files
 # Vocab clusters: 42 clusters
+
+# Optional: force full re-index to embed everything now
+lens index --force
 ```
 
 ## CLI Reference
@@ -102,6 +125,7 @@ All commands support `--json` for machine-readable output.
 | `lens repo watch` | Start file watcher for current repo |
 | `lens repo unwatch` | Stop file watcher for current repo |
 | `lens repo watch-status` | Show watcher status |
+| `lens repo mcp` | Write .mcp.json for agent integration |
 | `lens index` | Index the current repo |
 | `lens context "<goal>"` | Build a context pack for a goal |
 | `lens status` | Show repo index/embedding status |

package/cli.js

@@ -4045,6 +4045,17 @@ async function watchStatusCommand(opts) {
   }
 }
 
+// packages/cli/src/commands/mcp.ts
+async function mcpCommand() {
+  const { root_path } = await detectRepo();
+  const result = injectMcp(root_path);
+  if (result === "exists") {
+    output("LENS MCP entry already present in .mcp.json", false);
+  } else {
+    output("Wrote .mcp.json \u2014 agents will auto-discover LENS", false);
+  }
+}
+
 // packages/cli/src/commands/config.ts
 async function configGetCommand(key) {
   try {
@@ -4368,7 +4379,7 @@ async function logoutCommand() {
 }
 
 // packages/cli/src/index.ts
-var program2 = new Command().name("lens").description("LENS \u2014 Local-first repo context engine").version("0.1.13");
+var program2 = new Command().name("lens").description("LENS \u2014 Local-first repo context engine").version("0.1.14");
 function trackCommand(name) {
   if (!isTelemetryEnabled()) return;
   const BASE_URL2 = process.env.LENS_HOST ?? "http://127.0.0.1:4111";
@@ -4387,6 +4398,7 @@ repo.command("remove").description("Remove current repo and all its data").optio
 repo.command("watch").description("Start file watcher for current repo").option("--json", "Output as JSON", false).action((opts) => run(() => watchCommand(opts)));
 repo.command("unwatch").description("Stop file watcher for current repo").option("--json", "Output as JSON", false).action((opts) => run(() => unwatchCommand(opts)));
 repo.command("watch-status").description("Show file watcher status for current repo").option("--json", "Output as JSON", false).action((opts) => run(() => watchStatusCommand(opts)));
+repo.command("mcp").description("Write .mcp.json for MCP agent integration").action(() => run(() => mcpCommand()));
 program2.command("context <goal>").description("Build an intelligent context pack for a goal").option("--json", "Output as JSON", false).action((goal, opts) => run(() => contextCommand(goal, opts), "context"));
 program2.command("index").description("Index the current repo").option("--json", "Output as JSON", false).option("--force", "Full re-scan (default: diff scan, changed files only)", false).option("--status", "Show index status", false).action((opts) => run(() => indexCommand(opts), "index"));
 program2.command("status").description("Show repo index/embedding status").option("--json", "Output as JSON", false).action((opts) => run(() => statusCommand(opts), "status"));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "lens-engine",
-	"version": "0.1.13",
+	"version": "0.1.14",
 	"description": "LENS — Local-first repo context engine for AI agents",
 	"type": "module",
 	"bin": {
@@ -15,5 +15,5 @@
 		"node": ">=20"
 	},
 	"license": "MIT",
-	"homepage": "https://getlens.dev"
+	"homepage": "https://lens-engine.com"
 }