minnimemory 1.3.4 → 1.3.6

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/CHANGELOG.md CHANGED
@@ -3,6 +3,47 @@
3
3
  All notable changes to the `minnimemory` package. Dates are publish dates; an entry that has not
4
4
  been published yet says `unreleased` and gets its date on the day it goes out.
5
5
 
6
+ ## 1.3.6 - unreleased
7
+
8
+ - Changed: `@modelcontextprotocol/sdk` 1.30.0 -> 1.32.1 (the directory policy asks local servers to keep dependencies current). No behavior change; the full suite, the MCP client probe and the plugin e2e pass on the new SDK.
9
+ - Plugin: the generated README now defines what "memory" means (your files on disk, never chat history), names the surfaces (Claude Code and Cowork; ignored in claude.ai chat), discloses the bundle's unused `install`/`uninstall` commands and the `--profile full` tools, and gains "Try it on a sample first" and "Security reports" sections; `examples/CLAUDE.md` ships in the plugin tree; `plugin.json` carries `privacyPolicyUrl`, `termsOfServiceUrl` and `author.email`. The stale "measured offline, not yet in a live session" line is gone (gate (c) was live).
10
+
11
+ ## 1.3.5 - 2026-10-17
12
+
13
+ - Fix: run from the Claude Code plugin (`server/cli.mjs`), every printed command (`apply`,
14
+ `undo`, the drift notice's remedy, the CLI's own next step) named `npx -y minnimemory ...`,
15
+ which fetches npm's `latest` at run time, from a plugin whose README says it fetches nothing,
16
+ and could apply a plan hash with a different version than computed it. The tool now recognises
17
+ its `cli.mjs` as its own copy and prints `node "<plugin root>/server/cli.mjs" ...`, the same
18
+ direct form an installed `cli.js` already got. Found by the 2026-10-17 plugin audit.
19
+ - Fix: the prompt hook placed a memory unit holding a credential-shaped line (an AWS secret, a
20
+ Stripe key) into the turn when the prompt asked for it; `init` flagged the line (MM008) and
21
+ `apply` refused it, but the hook had no screen. The hook now runs the MM008 detector over the
22
+ unit it is about to place and prints one redacted notice instead, once per session.
23
+ - Changed: the prompt hook's per-session record of placed units moved from the shared OS temp
24
+ folder (`<tmp>/minnimemory-hook/`, default permissions, predictable name) to
25
+ `<config>/minnimemory/hook-sessions/`, beside the load log.
26
+ - Fix: `init` and `doctor` were quadratic in the number of memory files: the orphan rule
27
+ (MM004) rebuilt a regex of every file name for every source file. On one-topic folders of
28
+ 1,000 and 2,000 files, `init` took 42 s and 221 s; it now takes about 1 s and 3 s. One index
29
+ per audit, built once. `tests/audit-scale.test.ts` holds a ceiling.
30
+ - Plugin: the generated tree carries `logo.png` (the directory's listing icon) and
31
+ `documentationUrl`/`supportUrl` in its manifest; the plugin's code is readable (not
32
+ minified) by default, as the directory's checklist asks; `scripts/build-plugin.mjs --minified`
33
+ restores the small build. The plugin README lists every file the plugin
34
+ writes, the exact command `apply` hands back, and a troubleshooting section.
35
+ - Changed: the LICENSE names the distribution channels (npm, Claude Code plugin marketplaces and
36
+ their caches, Anthropic's directory) and allows them to store, copy, scan and deliver unmodified
37
+ copies, which the old clause 2(a) forbade; the text the tool writes into your memory files is
38
+ licensed to you without restriction as part of your files (the old clause 4 forbade publishing
39
+ it, which every committed `CLAUDE.md` did); reading the now-readable plugin source is allowed;
40
+ the bundled open-source components keep their own licenses (`THIRD_PARTY_NOTICES.md`); the
41
+ warranty clause no longer names `--allow-write`. The grant itself is unchanged: free,
42
+ unmodified, your own use, commercial use included.
43
+ - Changed: every MCP tool carries `readOnlyHint` and `destructiveHint` annotations (Anthropic's
44
+ directory policy 5.E); `init` says it writes its discovery record, the other basic tools say
45
+ they write nothing. The basic profile's tools/list grows from 1,183 to 1,251 tokens (approx-v2).
46
+
6
47
  ## 1.3.4 - 2026-10-14
7
48
 
8
49
  - Feature: the basic profile registers its four verbs as MCP prompts, so Claude Code lists them
package/LICENSE CHANGED
@@ -1,45 +1,61 @@
1
- MinniMemoryMCP License
2
-
3
- Copyright (c) 2026 MinniAI. All rights reserved.
4
-
5
- 1. Grant. MinniAI gives you a free, non-exclusive, non-transferable, revocable
6
- license to install and run this software package (the "Software"),
7
- unmodified, for your own use. Use inside your own company or for your own
8
- commercial projects is allowed.
9
-
10
- 2. Restrictions. You may not:
11
- (a) copy, redistribute, sublicense, sell, rent or host the Software for
12
- others;
13
- (b) modify, translate or create derivative works of the Software;
14
- (c) reverse engineer, decompile or disassemble the Software, except where
15
- applicable law forbids this restriction;
16
- (d) remove or alter any copyright or license notice in the Software.
17
-
18
- 3. Your files. The files the Software reads or writes on your machine (memory
19
- files such as CLAUDE.md, the .minnimemory folder, backups) are yours.
20
- MinniAI claims no rights in them. The Software makes no network calls and
21
- sends nothing off your machine.
22
-
23
- 4. Generated instructions. The instruction text, rule text and structure
24
- that the Software writes into your memory files (the "Generated
25
- Instructions") are MinniAI's copyrighted work. You may keep and use them
26
- in memory files on machines you control, for your own or your company's
27
- AI agents. You may not extract, republish, redistribute or sell the
28
- Generated Instructions, include them in another product or service, or
29
- use them, in whole or in part, as training or evaluation data for a
30
- machine learning model.
31
-
32
- 5. No warranty. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
33
- KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
34
- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
35
- Back up your files before using write features such as --allow-write.
36
-
37
- 6. Limitation of liability. IN NO EVENT SHALL MINNIAI BE LIABLE FOR ANY
38
- CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
39
- OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
40
- THE USE OF OR OTHER DEALINGS IN THE SOFTWARE.
41
-
42
- 7. Termination. This license ends automatically if you break any of its
43
- terms. When it ends, stop using the Software and delete your copies.
44
-
45
- 8. Contact. https://minniai.com
1
+ MinniMemoryMCP License
2
+
3
+ Copyright (c) 2026 MinniAI. All rights reserved.
4
+
5
+ 1. Grant. MinniAI gives you a free, non-exclusive, non-transferable, revocable
6
+ license to install and run this software package (the "Software"),
7
+ unmodified, for your own use. Use inside your own company or for your own
8
+ commercial projects is allowed.
9
+
10
+ 2. Distribution channels. MinniAI distributes the Software through the npm
11
+ registry, through Claude Code plugin marketplaces, and through software
12
+ directories run by Anthropic or by MinniAI. Those services, and the tools
13
+ that install from them (including a plugin manager that copies the Software
14
+ into a local cache and keeps earlier versions until it cleans them up), may
15
+ store, copy, scan, display and deliver unmodified copies of the Software for
16
+ that purpose. Receiving the Software through one of them is covered by
17
+ clause 1.
18
+
19
+ 3. Restrictions. Except as clause 2 allows, you may not:
20
+ (a) copy, redistribute, sublicense, sell, rent or host the Software for
21
+ others;
22
+ (b) modify, translate or create derivative works of the Software;
23
+ (c) remove or alter any copyright or license notice in the Software.
24
+ Reading the Software's source is allowed. Reverse engineering, decompiling
25
+ or disassembling it for the purpose of building a competing product is not,
26
+ except where applicable law forbids this restriction.
27
+
28
+ 4. Your files. The files the Software reads or writes on your machine (memory
29
+ files such as CLAUDE.md, the .minnimemory folder, backups, logs and records
30
+ under your Claude configuration folder) are yours. MinniAI claims no rights
31
+ in them. The Software makes no network calls and sends nothing off your
32
+ machine.
33
+
34
+ 5. Generated text. The Software writes short instruction lines and structure
35
+ into your memory files (the "Generated Text"). MinniAI holds the copyright
36
+ in the templates that produce it. The Generated Text itself is licensed to
37
+ you without restriction as part of your files: you may keep it, edit it,
38
+ commit it, publish it with your repository and share it with anyone, for
39
+ any purpose. The only thing you may not do is extract the Generated Text
40
+ from your files to build or sell a product that reproduces the Software's
41
+ function.
42
+
43
+ 6. Third-party components. The Software bundles open-source components
44
+ listed, with their licenses, in THIRD_PARTY_NOTICES.md. Those components
45
+ remain under their own licenses, which this license does not narrow.
46
+
47
+ 7. No warranty. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
48
+ KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
49
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
50
+ The Software backs your files up before it changes them; keep your own
51
+ backups too.
52
+
53
+ 8. Limitation of liability. IN NO EVENT SHALL MINNIAI BE LIABLE FOR ANY
54
+ CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
55
+ OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
56
+ THE USE OF OR OTHER DEALINGS IN THE SOFTWARE.
57
+
58
+ 9. Termination. This license ends automatically if you break any of its
59
+ terms. When it ends, stop using the Software and delete your copies.
60
+
61
+ 10. Contact. https://minniai.com
package/README.md CHANGED
@@ -105,7 +105,23 @@ The registration points at the copy `install` ran from. Under `npx` that is the
105
105
  `npm cache clean` or a newer version can remove, and `install` says so when it applies. For a
106
106
  durable install run `npm i -g minnimemory` once, then `minnimemory install --force`.
107
107
 
108
- Useful variants:
108
+ ### Or as a Claude Code plugin
109
+
110
+ ```
111
+ /plugin install minnimemory --marketplace MinniAI-com/minnimemory-plugin
112
+ ```
113
+
114
+ The same release, the same server and the same hooks, installed and removed through `/plugin`,
115
+ with nothing written to your `settings.json` by hand. Needs Claude Code 2.1.275 or later for the
116
+ one-line form (older: `claude plugin marketplace add MinniAI-com/minnimemory-plugin`, then
117
+ `claude plugin install minnimemory@minniai`) and Node 18.3 or later on your PATH. Pick one
118
+ route: if `npx -y minnimemory install` ran on this machine, run `npx -y minnimemory uninstall`
119
+ first, or you get two servers and every hook twice. Updates come with
120
+ `claude plugin update minnimemory@minniai`, or turn on auto-update for the `minniai` marketplace
121
+ in `/plugin`; `claude plugin uninstall minnimemory@minniai` removes it. The plugin repo holds
122
+ generated files only, built from the release tag (`docs/DESIGN.md` 7.1).
123
+
124
+ Useful variants of `install`:
109
125
 
110
126
  | you want | run |
111
127
  |---|---|
@@ -491,7 +507,8 @@ off stdin, ranks the prompt against the compiled memory, and prints one fenced m
491
507
  stdout, or nothing. It prints nothing when the always-loaded memory holds the best match, prints
492
508
  only the single best section and only under 400 tokens, only when that section shares at least
493
509
  two words with the prompt and at least half of them, and never the same section twice in one
494
- session (it reads Claude Code's `session_id` and keeps a small record under the OS temp folder).
510
+ session (it reads Claude Code's `session_id` and keeps a small record under
511
+ `<config>/minnimemory/hook-sessions/`).
495
512
  Measured live on 2026-10-11: a third lower session cost on a continuous 27-task session, answers
496
513
  graded as good (Minni-AI run `2026-10-11-211152`).
497
514
 
@@ -532,8 +549,8 @@ The MCP server's own always-loaded cost, measured (not assumed), approx-v2 token
532
549
 
533
550
  | | tokens |
534
551
  |---|---|
535
- | basic profile tool schemas (`init`, `doctor`, `apply`, `undo`), read-only | 1,183 |
536
- | basic profile tool schemas, `--allow-write` (no effect on basic) | 1,183 |
552
+ | basic profile tool schemas (`init`, `doctor`, `apply`, `undo`), read-only | 1,251 |
553
+ | basic profile tool schemas, `--allow-write` (no effect on basic) | 1,251 |
537
554
  | server instructions text | 50 |
538
555
 
539
556
  Measured against a real registered server over an in-memory MCP transport, not assumed. Claude
@@ -548,7 +565,8 @@ kept under about 60 tokens for that reason.
548
565
  - `apply`/`undo` refuse a symlinked source and refuse to write or delete through a symlink, so a
549
566
  cloned repo cannot point a memory file, or a routed piece, at a file outside the workspace.
550
567
  - `apply` refuses to write when the source holds a credential-shaped string, unless you pass
551
- `--allow-secrets`. `.minnimemory/.gitignore` keeps the verbatim backups (`original/`,
568
+ `--allow-secrets`, and the prompt hook never places a memory section that holds one (it prints
569
+ one redacted notice instead, once per session). `.minnimemory/.gitignore` keeps the verbatim backups (`original/`,
552
570
  `previous/`) and the drift stamp local; `manifest.json` and `graph.json` are meant to be
553
571
  committed, so a teammate's `doctor` sees the same drift.
554
572
  - `apply` refuses a source that is not valid UTF-8 rather than rewriting it with replacement
@@ -594,8 +612,10 @@ supported host; nothing else has been exercised end to end.
594
612
  ## License
595
613
 
596
614
  Proprietary, free to use. Copyright MinniAI. You may install and run the package, unmodified,
597
- for your own use, including at work. You may not redistribute, modify or reverse engineer it.
598
- The files it reads and writes on your machine stay yours, and it sends nothing off your machine.
599
- The instruction text the Software writes into your memory files is MinniAI's copyrighted work,
600
- licensed for your own use in files you control, not for extraction, resale or reuse elsewhere.
601
- Full terms in the `LICENSE` file shipped with the package.
615
+ for your own use, including at work, from npm, a Claude Code plugin marketplace or Anthropic's
616
+ directory. You may not redistribute or modify it yourself, or take it apart to build a competing
617
+ product; reading its source is fine. The files it reads and writes on your machine stay yours,
618
+ and it sends nothing off your machine. The short instruction lines it writes into your memory
619
+ files are yours to keep, edit, commit and publish with your repository. The bundled open-source
620
+ components keep their own licences (`THIRD_PARTY_NOTICES.md` in the plugin). Full terms in the
621
+ `LICENSE` file shipped with the package.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "minnimemory",
3
- "version": "1.3.4",
3
+ "version": "1.3.6",
4
4
  "description": "MinniMemoryMCP: an MCP server that gives an AI coding agent curated memory. Tools audit the agent's memory file, compile it into a small AlwaysOnMemory body plus OnDemandMemory files, serve it back on demand and keep it maintained. Deterministic, lossless, offline. Built by MinniAI.",
5
5
  "type": "module",
6
6
  "mcpName": "io.github.MinniAI-com/minnimemory",
@@ -53,7 +53,7 @@
53
53
  "vitest": "^5.0.0"
54
54
  },
55
55
  "dependencies": {
56
- "@modelcontextprotocol/sdk": "^1.30.0",
56
+ "@modelcontextprotocol/sdk": "^1.32.1",
57
57
  "zod": "^3.25.0"
58
58
  }
59
59
  }