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 +41 -0
- package/LICENSE +61 -45
- package/README.md +30 -10
- package/package.json +2 -2
- package/pkg/chunks/{chunk-AQ6QWAHT.js → chunk-LUEIBOGU.js} +98 -97
- package/pkg/chunks/chunk-XOD4IZ2R.js +52 -0
- package/pkg/chunks/{mcpServer-5J4HOZCC.js → mcpServer-FRGKYD56.js} +1 -1
- package/pkg/cli.js +3 -3
- package/pkg/index.js +1 -1
- package/pkg/chunks/chunk-6KBBT7IM.js +0 -52
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.
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
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
|
-
|
|
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
|
|
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,
|
|
536
|
-
| basic profile tool schemas, `--allow-write` (no effect on basic) | 1,
|
|
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
|
|
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
|
|
598
|
-
|
|
599
|
-
The
|
|
600
|
-
|
|
601
|
-
|
|
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.
|
|
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.
|
|
56
|
+
"@modelcontextprotocol/sdk": "^1.32.1",
|
|
57
57
|
"zod": "^3.25.0"
|
|
58
58
|
}
|
|
59
59
|
}
|