@llmnesia/mcp 0.1.2 → 0.1.5

package/README.md

@@ -12,22 +12,36 @@ over stdio.
 
 Requires **Node.js ≥ 22.13.0** (for the built-in `node:sqlite` module). The
 installer checks this before changing anything and prints the exact recovery
-steps when the installed version is too old.
+steps when the installed version is too old. If that happens in an interactive
+terminal, it offers the official Node.js installer through an OS-specific
+LLMnesia download link for you.
 
 ## Install
 
+On macOS or Linux:
+
 ```bash
 npx -y @llmnesia/mcp@latest install
 ```
 
-That is the same command in Terminal on macOS/Linux and PowerShell on Windows.
+On Windows PowerShell:
+
+```powershell
+npx.cmd -y @llmnesia/mcp@latest install
+```
+
+Windows uses `npx.cmd` because PowerShell commonly blocks npm's `npx.ps1`
+wrapper even when Node.js installed correctly.
 It requires Node.js 22.13 or newer; there is no global package install and no
 client config to edit by hand in the normal path.
 
-If `npx` is not recognised, Node.js is not installed. Install the current LTS
-release from [nodejs.org](https://nodejs.org/), reopen Terminal/PowerShell, and
-run the command again. `npx` cannot prompt for or install Node.js because it is
-itself part of Node.js.
+If your installed Node.js is too old, LLMnesia offers to open the right official
+installer; install it, reopen Terminal/PowerShell, and run the command again. If
+`npx` is not recognised at all, Node.js is not
+installed yet, so the command cannot start far enough to show that prompt. In
+that case, install the current LTS release from
+[Mac installer](https://www.llmnesia.com/download/node/macos) on macOS, or the
+[Windows installer](https://www.llmnesia.com/download/node/windows) on Windows.
 
 The installer:
 
@@ -37,8 +51,11 @@ The installer:
 3. detects supported MCP clients you have (Claude Code, Claude Desktop,
    Cursor, and Codex), and
 4. registers that copy with each detected client — using the client's own CLI
-   where available, or after a confirm prompt and backup for config files it
-   edits.
+   where available, or with an automatic backup before editing its config file.
+
+The `install` command is the approval to perform those setup steps. It does not
+interrupt setup with a separate prompt for every detected app, and it never
+prints existing client configurations or their credentials.
 
 Then **fully quit and reopen** your MCP client. Clients read their config once
 at startup, so reloading a window is not enough.
@@ -60,9 +77,7 @@ The copy is self-contained (no `node_modules` beside it) and re-running
 
 ### Updating
 
-```bash
-npx -y @llmnesia/mcp@latest install
-```
+Run the same OS-specific install command above again.
 
 Your corpus is untouched; only the server copy is replaced.
 
@@ -85,12 +100,13 @@ If nothing has written to the corpus yet, search results will be empty.
 
 ## Tools
 
-Once registered, your MCP client gains five tools over the corpus:
+Once registered, your MCP client gains six tools over the corpus:
 
 | Tool | Purpose |
 | --- | --- |
 | `search_conversations` | Full-text search across every past conversation. Returns ranked matches with highlighted snippets. Supports `platform`, `title`, `date_from`/`date_to` filters and a `match_mode` (`any` / `all` / `phrase`) for when a wrong hit matters. |
 | `get_conversation` | Fetch the full transcript of one conversation by its id (the `id` field from search results). |
+| `list_conversations` | List conversations by chronology, including oldest-first for questions about the user's earliest chat. |
 | `list_recent` | List the most recently updated conversations with title, summary, and platform. |
 | `corpus_status` | Report when the corpus last received data and how many conversations it holds. Use this when an expected conversation cannot be found, to tell a genuinely missing chat apart from a corpus that has stopped receiving updates. |
 | `save_conversation` | Add or update a conversation in the corpus, so MCP is also an ingestion route. |
@@ -105,7 +121,7 @@ received data — check it before concluding a chat does not exist.
 | Claude Code | Runs `claude mcp add --scope user` with the absolute Node and installed runtime paths, making it available in every project (detects `claude` on PATH). |
 | Claude Desktop | Edits `claude_desktop_config.json` at the standard OS-specific path. |
 | Cursor | Edits `~/.cursor/mcp.json`. |
-| Codex | Runs `codex mcp add` with the absolute runtime paths. It also detects the CLI bundled in the macOS desktop app; prints a TOML fallback only if no Codex CLI is available. |
+| Codex | Runs `codex mcp add` with the absolute runtime paths when available. If Windows does not expose the app's bundled CLI, the installer safely edits `~/.codex/config.toml` itself and backs up existing settings first. Read-only LLMnesia tools are configured to run without repeated approval prompts; writes still ask. |
 | Others (Windsurf, Zed, LM Studio, …) | Prints the generic stdio block for you to paste. |
 
 **Cloud-only clients cannot reach a local stdio server** (web ChatGPT, Lovable,
@@ -114,9 +130,8 @@ close it.
 
 ## Diagnose an install
 
-```bash
-npx -y @llmnesia/mcp@latest doctor
-```
+Use `npx -y @llmnesia/mcp@latest doctor` on macOS/Linux, or
+`npx.cmd -y @llmnesia/mcp@latest doctor` in Windows PowerShell.
 
 Checks whether the native host is installed, the server runtime is present, the
 corpus is receiving data, and each detected client is correctly wired —
@@ -129,9 +144,8 @@ reminder).
 
 ## Uninstall
 
-```bash
-npx -y @llmnesia/mcp@latest uninstall
-```
+Use `npx -y @llmnesia/mcp@latest uninstall` on macOS/Linux, or
+`npx.cmd -y @llmnesia/mcp@latest uninstall` in Windows PowerShell.
 
 Removes native-host manifests and registry keys, the copied server in
 `~/.llmnesia/bin`, and client registrations. The shared config file and your

package/dist/{chunk-7BW63ZTP.js → chunk-3JQ7CGCP.js}

@@ -643,10 +643,15 @@ var SearchIndex = class {
   }
   /** Most-recently-updated conversations (metadata only), newest first. */
   listRecent(n) {
+    return this.listConversations(n, "recent");
+  }
+  /** Conversation metadata in a caller-selected, deterministic chronology. */
+  listConversations(n, sort) {
     const limit = Math.max(1, n);
+    const orderBy = sort === "oldest" ? "createdAt ASC, updatedAt ASC" : sort === "newest" ? "createdAt DESC, updatedAt DESC" : "updatedAt DESC, createdAt DESC";
     const rows = this.db.prepare(
       `SELECT docId, platform, title, url, createdAt, updatedAt, messageCount, preview, pinned
-         FROM conversations ORDER BY updatedAt DESC, createdAt DESC LIMIT ?`
+         FROM conversations ORDER BY ${orderBy} LIMIT ?`
     ).all(limit);
     return rows.map((r) => ({ ...r, pinned: r.pinned === 1 }));
   }

package/dist/{chunk-BQM5Q4XX.js → chunk-YVBAQ5VA.js}

@@ -38,7 +38,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/version.ts
-var VERSION = true ? "0.1.2" : "0.0.0-dev";
+var VERSION = true ? "0.1.5" : "0.0.0-dev";
 
 export {
   __require,