@llmnesia/mcp 0.2.3 → 0.2.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +35 -0
- package/dist/{chunk-6H2TI5IW.js → chunk-BDR4JVMF.js} +1 -1
- package/dist/{chunk-G42RV536.js → chunk-MTPXE734.js} +793 -68
- package/dist/{cli-77JECNWA.js → cli-OXKBAUBE.js} +81 -6
- package/dist/cli.js +2 -2
- package/dist/llmnesia.mcpb +0 -0
- package/dist/mcp.js +95 -4
- package/package.json +1 -1
- package/server.json +2 -2
package/README.md
CHANGED
|
@@ -140,6 +140,39 @@ the [Chrome Web Store](https://chromewebstore.google.com/detail/llmnesia/leekfgb
|
|
|
140
140
|
|
|
141
141
|
If nothing has written to the corpus yet, search results will be empty.
|
|
142
142
|
|
|
143
|
+
### Local storage and compaction
|
|
144
|
+
|
|
145
|
+
Conversation files are stored as losslessly compressed JSON. Search uses a
|
|
146
|
+
contentless FTS5 token index: the canonical text is not duplicated inside the
|
|
147
|
+
database, and result snippets are loaded from the canonical conversation only
|
|
148
|
+
after SQLite has ranked the matches. No conversation or searchable token is
|
|
149
|
+
dropped to save space.
|
|
150
|
+
|
|
151
|
+
Current builds discard a clean browser-to-corpus transport payload after both
|
|
152
|
+
the canonical conversation and active index have accepted it. Malformed input
|
|
153
|
+
is kept under `inbox/quarantine/` for inspection. Older releases archived every
|
|
154
|
+
successful payload and may also have left versioned indexes behind.
|
|
155
|
+
|
|
156
|
+
No maintenance command is required. After an upgrade, the MCP service waits
|
|
157
|
+
through a three-day compatibility window, then reclaims the historical files
|
|
158
|
+
automatically while the service is ready and idle. Work is single-process,
|
|
159
|
+
resumable, yields between small batches, and retries later without interrupting
|
|
160
|
+
search if any verification or filesystem step fails. Quarantine is never
|
|
161
|
+
removed. Set `LLMNESIA_NO_AUTO_MAINTENANCE=1` only if you need to opt out.
|
|
162
|
+
|
|
163
|
+
For support or an immediate attended cleanup, preview the exact recoverable
|
|
164
|
+
space without writing anything:
|
|
165
|
+
|
|
166
|
+
```bash
|
|
167
|
+
npx -y @llmnesia/mcp@latest compact --dry-run
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
To apply it immediately, fully quit connected desktop AI/MCP clients, then run
|
|
171
|
+
`compact` without `--dry-run`. It asks for confirmation, verifies every compressed
|
|
172
|
+
conversation by reading it back before removing the legacy JSON, builds the
|
|
173
|
+
current index before deleting older derived versions, and never removes
|
|
174
|
+
quarantined input.
|
|
175
|
+
|
|
143
176
|
## Tools
|
|
144
177
|
|
|
145
178
|
Once registered, your MCP client gains seven tools over the corpus:
|
|
@@ -217,6 +250,8 @@ llmnesia-mcp ingest <…> # ingest an NDJSON backup file
|
|
|
217
250
|
llmnesia-mcp drain # ingest everything in <corpus>/inbox
|
|
218
251
|
llmnesia-mcp watch # ingest new inbox deltas live (Ctrl+C to stop)
|
|
219
252
|
llmnesia-mcp stats # corpus summary
|
|
253
|
+
llmnesia-mcp compact --dry-run # exact read-only storage/savings report
|
|
254
|
+
llmnesia-mcp compact # confirmed lossless migration + redundant cleanup
|
|
220
255
|
llmnesia-mcp reindex # drop + rebuild the search index from the corpus
|
|
221
256
|
llmnesia-mcp search <q> # one-shot search from the terminal
|
|
222
257
|
llmnesia-mcp --version # print the installed version
|