minnimemory 1.3.7 → 1.4.0
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 +45 -0
- package/README.md +51 -5
- package/package.json +2 -2
- package/pkg/chunks/chunk-K7XLQMXJ.js +166 -0
- package/pkg/chunks/chunk-SELGA237.js +54 -0
- package/pkg/chunks/{mcpServer-2FYD5LS3.js → mcpServer-6J4GLXHP.js} +1 -1
- package/pkg/cli.js +132 -94
- package/pkg/index.js +1 -1
- package/pkg/chunks/chunk-B5ETYKWT.js +0 -54
- package/pkg/chunks/chunk-CR5T6SUD.js +0 -162
package/pkg/cli.js
CHANGED
|
@@ -1,33 +1,40 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
/* MinniMemoryMCP (c) 2026 MinniAI. Licensed under the MinniMemoryMCP License, see LICENSE. */
|
|
3
|
-
import{$ as
|
|
4
|
-
one task description per line, # for comments`);return
|
|
5
|
-
`)}function
|
|
6
|
-
`)}function
|
|
7
|
-
`)}import
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
`),path:
|
|
12
|
-
`),path:
|
|
13
|
-
`),path:
|
|
3
|
+
import{$ as Qe,$a as vo,A as _e,Aa as ce,B as Fe,Ba as ue,C as Le,Ca as co,Da as uo,Ea as po,Fa as fo,G as Be,Ga as mo,H as Je,Ha as q,Ia as ho,K as Ue,L as Ge,M as H,N as re,Na as go,O as We,Q as Xe,Qa as yo,R as P,S as se,T as qe,U as ie,V as ze,W as Ye,X as Ke,Y as Ve,Ya as wo,Za as ko,_ as U,_a as pe,aa as Ze,ab as bo,b as R,ba as eo,bb as xo,cb as $o,db as Co,eb as So,fa as oo,fb as Oo,g,ga as to,gb as jo,ha as no,hb as Mo,ia as ro,j as Ee,ja as so,ka as ae,kb as Eo,la as io,ma as ao,mb as fe,n as Te,nb as me,o as De,ob as he,p as Ae,pb as ge,q as Re,r as Pe,ra as lo,s as te,t as ne,ta as de,v as Ie,w as B,wa as G,x as J,xa as le,y as Ne,ya as W,z as He,za as X}from"./chunks/chunk-K7XLQMXJ.js";import{spawnSync as bt}from"node:child_process";import S from"node:fs";import Yo from"node:os";import $ from"node:path";import{fileURLToPath as xt}from"node:url";import{parseArgs as $t}from"node:util";import et from"node:fs";function ot(e){return e.split(/\r?\n/).map(t=>t.trim()).filter(t=>t!==""&&!t.startsWith("#"))}function To(e){let t;try{t=et.readFileSync(e,"utf8")}catch{throw new P(`cannot read workload file: ${e}`)}let o=ot(t);if(o.length===0)throw new P(`workload file has no tasks: ${e}
|
|
4
|
+
one task description per line, # for comments`);return o}function z(e){return`${e.onDemandFile}:${e.startLine}`}function tt(e){return`${e.onDemandFile} > ${e.heading}`}function nt(e,t){let o=R(e).flatMap(n=>Te({name:n.name,file:n.file},We(t,n.file)));return De(o,new Map(R(e).map(n=>[n.name,n.triggers])))}function Do(e,t,o={}){let n=o.root?nt(e,o.root):void 0,r=n?"section":"file",u=new Set,a=new Map,d=new Map,c=new Map;for(let i of R(e))a.set(i.name,i.tokens),d.set(i.name,i.name),c.set(i.name,i.name);if(n)for(let i of n.units)a.set(z(i),i.tokens),d.set(z(i),tt(i)),c.set(z(i),i.onDemandFile);let f=[],v=0;t.forEach((i,h)=>{let C=n?Re(Ae(n,i)).map(m=>z(m.unit)):Pe(e,i).filter(m=>m.score>0).map(m=>m.name);C.length===0&&v++;let x=C.filter(m=>!u.has(m));for(let m of x)u.add(m);let b=[...u].reduce((m,Q)=>m+(a.get(Q)??0),0);f.push({turn:h+1,task:i,opened:x.map(m=>d.get(m)??m),carried:[...u].map(m=>d.get(m)??m),compiledTokens:e.prefix.after+b,baselineTokens:e.prefix.before})});let k=f.reduce((i,h)=>i+h.compiledTokens,0),y=f.reduce((i,h)=>i+h.baselineTokens,0),w=new Set([...u].map(i=>c.get(i)??i)),M=R(e).map(i=>i.name).filter(i=>w.has(i)),D=[...u].reduce((i,h)=>i+(a.get(h)??0),0),E=e.prefix.after+D,s=e.prefix.before-E,l=y-k,p;return l>=0?(p=f.findIndex((i,h)=>f.slice(0,h+1).reduce((x,b)=>x+b.baselineTokens-b.compiledTokens,0)>=0),p=p>=0?p+1:void 0):s>0&&(p=f.length+Math.ceil(-l/s)),{unit:r,turns:f,baselineTotal:y,compiledTotal:k,saving:l,savingPct:y===0?0:l/y*100,onDemandOpened:M,onDemandNeverOpened:R(e).map(i=>i.name).filter(i=>!w.has(i)),unroutedTurns:v,steadyStatePerTurn:E,steadyStateGainPerTurn:s,breakEvenTurn:p}}function rt(e,t){return t===0?"0.0%":`${(e/t*100).toFixed(1)}%`}function ye(e){return e>=0?`saves ${g(e)}`:`costs ${g(-e)} more`}function we(e,t){let o=[""];return o.push(` exact, over ${g(e.turns)} turns. No workload, no assumptions.`),o.push(""),o.push(` original memory file ${g(e.baselinePerTurn).padStart(8)} tokens per turn`),o.push(` compiled always-loaded ${g(e.compiledPerTurn).padStart(8)} tokens per turn`),o.push(` OnDemandMemory, all of it ${g(e.totalOnDemandTokens).padStart(8)} tokens, on demand`),o.push(""),o.push(" best case, no OnDemandMemory file ever opened"),o.push(` ${g(e.baselineTotal)} -> ${g(e.bestCaseTotal)} tokens, ${ye(e.bestCaseSaving)} (${rt(e.bestCaseSaving,e.baselineTotal)})`),o.push(""),o.push(" worst case, every OnDemandMemory file opened on turn 1 and carried"),o.push(` ${g(e.baselineTotal)} -> ${g(e.worstCaseTotal)} tokens, ${ye(e.worstCaseSaving)}`),o.push(""),o.push(` break-even: ${g(e.breakEvenCarriedTokens)} tokens of OnDemandMemory can sit in`),o.push(" context from turn 1 to the end and come out even. Past that the compiled"),o.push(" shape costs more than the file it replaced."),o.push(""),o.push(` tokenizer: ${t}, an offline estimate`),o.push(""),o.join(`
|
|
5
|
+
`)}function Ao(e,t){let o=[""],n=e.turns.length;if(o.push(` MODEL, not a measurement. ${g(n)} turns from the workload you supplied.`),o.push(e.unit==="section"?" routed at section level, as recall() does: a hit carries the section, not the file.":" routed at file level, as an agent reading a whole file the OnDemandMemory list named would."),o.push(""),o.push(` memory tokens over the session ${g(e.baselineTotal)} -> ${g(e.compiledTotal)}`),o.push(` ${ye(e.saving)}${e.saving>=0?` (${e.savingPct.toFixed(1)}%)`:""}`),o.push(""),e.onDemandOpened.length>0){o.push(` opened and carried (${e.onDemandOpened.length}):`);for(let r of e.onDemandOpened)o.push(` ${r}`);o.push("")}if(e.onDemandNeverOpened.length>0){o.push(` never opened (${e.onDemandNeverOpened.length}) - this is where the saving comes from:`);for(let r of e.onDemandNeverOpened)o.push(` ${r}`);o.push("")}return o.push(" one more turn, once everything this workload opens is in context:"),o.push(` ${g(e.steadyStatePerTurn)} vs ${g(e.turns[0]?.baselineTokens??0)} baseline, ${e.steadyStateGainPerTurn>=0?`saves ${g(e.steadyStateGainPerTurn)}`:`costs ${g(-e.steadyStateGainPerTurn)} more`} per turn`),o.push(""),e.saving<0&&e.steadyStateGainPerTurn<=0?(o.push(" this workload never breaks even. The OnDemandMemory files it opens are large enough that"),o.push(" carrying them costs more every turn than the original file did, so a longer"),o.push(" session loses more, not less. Splitting differently, or not compiling this"),o.push(" file at all, is the honest answer here."),o.push("")):e.saving<0&&e.breakEvenTurn!==void 0?(o.push(` behind by ${g(-e.saving)} at turn ${g(e.turns.length)}, recovering ${g(e.steadyStateGainPerTurn)} per turn:`),o.push(` breaks even around turn ${g(e.breakEvenTurn)} if nothing further opens.`),o.push("")):e.saving>=0&&e.breakEvenTurn!==void 0&&(o.push(` ahead from turn ${g(e.breakEvenTurn)} onward.`),o.push("")),e.unroutedTurns>0&&(o.push(` ${g(e.unroutedTurns)} of ${g(n)} turns matched no OnDemandMemory file at all.`),o.push(" Those turns are cheap here, but a real agent may have needed something and"),o.push(" not been routed to it. Check them before trusting the total."),o.push("")),o.push(" what this number is conditional on:"),o.push(" - your workload being what a real session looks like. It is your file;"),o.push(" the tool cannot tell whether it is representative."),e.unit==="section"?(o.push(" - every section recall() returns being carried for the rest of the session,"),o.push(" up to its token cap per turn. A real agent may widen with outline() or"),o.push(" read the whole file anyway.")):(o.push(" - every OnDemandMemory file whose triggers match being opened in full. A real"),o.push(" agent may read one and stop, or ignore one the list offered.")),o.push(" - memory tokens only. Reasoning, tool results and conversation are excluded"),o.push(" from both sides, so this ratio is not a session bill."),o.push(""),o.push(" For observed usage against a live agent, measure a real multi-turn session with"),o.push(" and without the compile. That is the only path allowed to call a number measured."),o.push(""),o.push(` tokenizer: ${t}, an offline estimate`),o.push(""),o.join(`
|
|
6
|
+
`)}function Ro(){return[""," No workload given, so only the exact bounds above are available.",""," A session number needs a workload: a file with one task description per line,"," describing what you actually do in this repo.",""," minnimemory bench --workload tasks.txt",""," minnimemory ships no default task list on purpose. A number produced from tasks"," the tool invented for itself would say more about the tool than about your repo.",""].join(`
|
|
7
|
+
`)}import T from"node:fs";import O from"node:path";function _(e){let t=Le(e);return t&&Be(t)?t:void 0}function st(e){return e===void 0||e==="codex"}var Y=" --host codex";function No(e){return Je(e)??`"${e.replace(/"/g,'\\"')}"`}function j(e){return e.map(No).join(" ")}function Ho(e){return e.map(No)}function K(e){if(!(!e.servedDirect||!/\/_npx\//.test(e.servedDirect)))return"note: this copy lives in the npx cache, which `npm cache clean` or a newer version can remove; the registration and the hook would then stop starting. For a durable install: npm i -g minnimemory, then minnimemory install --force"}function it(e){if(e==="cursor")return"~/.cursor/mcp.json";if(e==="windsurf")return"~/.codeium/windsurf/mcp_config.json";if(e==="codex")return"~/.codex/config.toml"}function _o(e){return e.codexConfigDir??O.join(e.home,".codex")}function at(e){try{return/^\s*\[mcp_servers\.minnimemory\]\s*$/m.test(T.readFileSync(O.join(_o(e),"config.toml"),"utf8"))}catch{return!1}}function Fo(e,t){let o=[];e.write&&o.push("--profile","full","--allow-write");let n=e.host==="codex";n&&o.push("--host","codex");let r=_(e.cliPath),u=r?["node",r,"mcp",...o]:["npx","-y","minnimemory","mcp",...o],a=n&&t.codexHome?t.codexHome:void 0,d=a?["--env",`CODEX_HOME=${a}`]:[],c=n?["codex","mcp","add","minnimemory",...d,"--",...u]:["claude","mcp","add","minnimemory","-s",e.scope,"--",...u],f=n?["codex","mcp","remove","minnimemory"]:["claude","mcp","remove","minnimemory","-s",e.scope],v=n?["codex","mcp","get","minnimemory"]:["claude","mcp","get","minnimemory"],k=n?["codex","--version"]:["claude","--version"],y=j(c),w=n?["[mcp_servers.minnimemory]",`command = ${JSON.stringify(u[0])}`,`args = [${u.slice(1).map(E=>JSON.stringify(E)).join(", ")}]`,...a?[`env = { CODEX_HOME = ${JSON.stringify(a)} }`]:[]].join(`
|
|
8
|
+
`):void 0,M=JSON.stringify({mcpServers:{minnimemory:{command:"npx",args:["-y","minnimemory","mcp",...o]}}},null,2),D={scope:e.scope,servedFlags:o,servedArgv:u,...r?{servedDirect:r}:{},addArgv:c,removeArgv:f,getArgv:v,probeArgv:k,manualLine:y,jsonSnippet:M,...w?{tomlSnippet:w}:{}};if(e.host&&e.host!=="json"){let E=it(e.host);E&&(D.hostConfigPath=E)}return D}function ke(e){return e.error!==void 0&&e.error.code==="ENOENT"}var ve="npx -y minnimemory drift";function dt(e,t){let o=_(e);return(o?`node "${o}" drift`:ve)+(t==="codex"?Y:"")}var be="npx -y minnimemory hook";function lt(e,t){let o=_(e);return(o?`node "${o}" hook`:be)+(t==="codex"?Y:"")}function Lo(e){return e.endsWith(Y)?e.slice(0,-Y.length):e}function ct(e){if(typeof e!="string")return!1;let t=Lo(e);return t===be||xe(t,"hook")}function ut(e,t){let o=a=>a.replace(/\\/g,"/").toLowerCase(),n=/^\s*Command:\s*(.*)$/m.exec(e)?.[1]?.trim(),r=/^\s*Args:\s*(.*)$/m.exec(e)?.[1]?.trim(),u=o(n?`${n} ${r??""}
|
|
9
|
+
${e}`:e);return t.servedDirect?u.includes(o(t.servedDirect)):u.includes("npx -y minnimemory mcp")}function pt(e){let t=/Scope:\s*(User|Project|Local)\b/i.exec(e);return t?t[1].toLowerCase():void 0}function xe(e,t){let o=/^node "([^"]+)" (drift|loaded|hook)$/.exec(e);if(o===null||o[2]!==t)return!1;let n=o[1];return/minnimemory/i.test(n)||ft(n)}function ft(e){if(!O.isAbsolute(e))return!1;let t=O.dirname(e);for(let o=0;o<4;o++)try{return JSON.parse(T.readFileSync(O.join(t,"package.json"),"utf8")).name==="minnimemory"}catch{let n=O.dirname(t);if(n===t)return!1;t=n}return!1}function mt(e){if(typeof e!="string")return!1;let t=Lo(e);return t===ve||xe(t,"drift")}var $e="npx -y minnimemory loaded";function ht(e){let t=_(e);return t?`node "${t}" loaded`:$e}function gt(e){return typeof e=="string"&&(e===$e||xe(e,"loaded"))}function Bo(e,t){let o=dt(e,t),n=lt(e,t),r=ht(e),u=[{event:"UserPromptSubmit",command:o,fallback:ve,isOurs:a=>a===o||mt(a)},{event:"UserPromptSubmit",command:n,fallback:be,isOurs:a=>a===n||ct(a)}];return t==="codex"?u:[...u,{event:"InstructionsLoaded",command:r,fallback:$e,isOurs:a=>a===r||gt(a)}]}function Jo(e,t,o){let n=t.cwd??process.cwd();return o==="codex"?e==="user"?O.join(_o(t),"hooks.json"):O.join(n,".codex","hooks.json"):e==="user"?O.join(t.configDir??O.join(t.home,".claude"),"settings.json"):e==="project"?O.join(n,".claude","settings.json"):O.join(n,".claude","settings.local.json")}function Po(e){return e==="codex"?"Restart Codex.":"Restart Claude Code."}var yt="then run /hooks inside Codex once to trust the two minnimemory hooks (Codex skips an untrusted hook)";function Uo(e,t){let o=[];for(let n of e){if(!n||typeof n!="object")continue;let r=n.hooks;if(Array.isArray(r))for(let u of r){let a=u&&typeof u=="object"?u.command:void 0;t(a)&&o.push(a)}}return o}function Go(e){if(!T.existsSync(e))return{};try{let t=JSON.parse(T.readFileSync(e,"utf8"));return!t||typeof t!="object"||Array.isArray(t)?void 0:t}catch{return}}function Wo(e,t){let o=`${JSON.stringify(t,null,2)}
|
|
10
|
+
`,n=`${e}.minnimemory-${process.pid}.tmp`;T.writeFileSync(n,o,"utf8");try{T.renameSync(n,e)}catch{T.rmSync(n,{force:!0}),T.writeFileSync(e,o,"utf8")}}function Xo(e){let t=e.hooks;return t&&typeof t=="object"&&!Array.isArray(t)?t:void 0}function wt(e,t){if(e.host==="codex"&&e.scope==="local")return{exitCode:2,output:"install --hook: Codex has no local scope; use --scope user or --scope project.",path:""};let o=Jo(e.scope,t,e.host),n=Bo(e.cliPath,e.host);if(e.dryRun)return{exitCode:0,output:n.map(c=>`would add the ${c.event} hook \`${c.command}\` to ${o}`).join(`
|
|
11
|
+
`),path:o};let r=Go(o);if(!r)return{exitCode:1,output:`install --hook: ${o} is not valid JSON; not touched.`,path:o};let u=Xo(r)??{},a=[],d=!1;for(let c of n){let f=Array.isArray(u[c.event])?[...u[c.event]]:[],v=Uo(f,c.isOurs);if(v.includes(c.command)){a.push(c.event==="UserPromptSubmit"?`hook: \`${c.fallback.split(" ").pop()}\` already present in ${o}`:`hook: ${c.event} already present in ${o}`);continue}if(v.length>0){for(let k of f){let y=k&&typeof k=="object"?k.hooks:void 0;if(Array.isArray(y))for(let w of y)w&&typeof w=="object"&&c.isOurs(w.command)&&(w.command=c.command)}a.push(`hook: updated \`${v[0]}\` -> \`${c.command}\` in ${o} (${c.event}). ${Po(e.host)}`)}else{let k={hooks:[{type:"command",command:c.command}]};f.push(k),a.push(`hook: added \`${c.command}\` to ${o} (${c.event}). ${Po(e.host)}`)}u[c.event]=f,d=!0}return d&&(r.hooks=u,T.mkdirSync(O.dirname(o),{recursive:!0}),Wo(o,r)),{exitCode:0,output:a.join(`
|
|
12
|
+
`),path:o}}function Io(e,t){let o=Jo(e.scope,t,e.host),n=Bo(e.cliPath,e.host);if(e.dryRun)return{exitCode:0,output:n.map(d=>`would remove the ${d.event} hook (\`${d.fallback}\` or its direct node form) from ${o}`).join(`
|
|
13
|
+
`),path:o};if(!T.existsSync(o))return{exitCode:0,output:`hook: nothing to remove (${o} does not exist)`,path:o};let r=Go(o);if(!r)return{exitCode:1,output:`install --remove: ${o} is not valid JSON; not touched.`,path:o};let u=Xo(r),a=[];for(let d of n){let c=u&&Array.isArray(u[d.event])?u[d.event]:void 0,f=c?Uo(c,d.isOurs):[];if(!u||!c||f.length===0)continue;let v=c.filter(k=>{if(!k||typeof k!="object")return!0;let y=k.hooks;if(!Array.isArray(y))return!0;let w=y.filter(M=>!(M&&typeof M=="object"&&d.isOurs(M.command)));return w.length===0?!1:(k.hooks=w,!0)});v.length===0?delete u[d.event]:u[d.event]=v,a.push(`hook: removed \`${f[0]}\` from ${o}`)}return a.length===0?{exitCode:0,output:`hook: nothing to remove in ${o}`,path:o}:(u&&Object.keys(u).length===0&&delete r.hooks,Wo(o,r),{exitCode:0,output:a.join(`
|
|
14
|
+
`),path:o})}function qo(e,t,o){let n=Fo(e,t),r=[];if(e.dryRun){r.push(`would run: ${j(n.removeArgv)}`);let c=Io({...e,dryRun:!0},t);return r.push(c.output),{exitCode:0,output:`${r.join(`
|
|
14
15
|
`)}
|
|
15
|
-
`}}let
|
|
16
|
-
${
|
|
16
|
+
`}}let u=o(n.probeArgv[0],n.probeArgv.slice(1)),a=0;if(ke(u))r.push(`the ${e.host==="codex"?"codex":"claude"} CLI is not on PATH; skipping the MCP registration removal.`);else{let c=o(n.removeArgv[0],n.removeArgv.slice(1));r.push(`ran: ${j(n.removeArgv)}`),c.code!==0&&/no mcp server named/i.test(`${c.stdout}
|
|
17
|
+
${c.stderr}`)?r.push(`nothing registered as minnimemory in ${e.scope} scope`):c.code!==0?(r.push(c.stderr.trim()),a=1):c.stdout.trim()&&r.push(c.stdout.trim())}let d=Io(e,t);return r.push(d.output),d.exitCode!==0&&(a=d.exitCode),{exitCode:a,output:`${r.join(`
|
|
17
18
|
`)}
|
|
18
|
-
`}}function
|
|
19
|
+
`}}function kt(e,t){let o=_(e),n=o?`node "${o}" init`:"npx -y minnimemory init";return t==="codex"?`next: restart Codex, ${yt}, then ask it to clean up your memory with minnimemory; it starts with init. In a terminal: \`${n} <folder> --host codex\` from your project (Codex's load set needs no --from-log).`:`next: restart Claude Code, then ask it to clean up your memory with minnimemory; it starts with init. In a terminal: \`${n} <folder> --from-log\` from your project.`}function I(e,t,o,n){if(e.hook){let r=wt(e,t);o.push(r.output),r.exitCode!==0&&(n=r.exitCode)}return n===0&&o.push(kt(e.cliPath,e.host)),{exitCode:n,output:`${o.join(`
|
|
19
20
|
`)}
|
|
20
|
-
`}}function
|
|
21
|
-
`};if(e.host)return r.push(o.jsonSnippet),o.hostConfigPath?r.push("",`config file: ${o.hostConfigPath}`):r.push("",`add this under "mcpServers" in your host's MCP config file.`),{exitCode:0,output:`${r.join(`
|
|
21
|
+
`}}function vt(e,t,o,n){let r=[];if(e.dryRun){e.force&&r.push(`would run: ${j(n.removeArgv)}`),r.push(`would run: ${j(n.addArgv)}`);let f=K(n);return f&&r.push(f),I(e,t,r,0)}let u=o(n.probeArgv[0],n.probeArgv.slice(1));if(ke(u))return r.push("the codex CLI is not on PATH. Register minnimemory manually:","",` ${n.manualLine}`,"",`or add this to ${n.hostConfigPath??"~/.codex/config.toml"}:`,"",n.tomlSnippet??""),{exitCode:2,output:`${r.join(`
|
|
22
22
|
`)}
|
|
23
|
-
`};if(e.
|
|
23
|
+
`};let a=at(t);if(a&&!e.force)return r.push("minnimemory is already registered with Codex.",`to change it: ${j(["npx","-y","minnimemory","install","--host","codex","--force",...e.write?["--write"]:[]])}`),I(e,t,r,0);if(a){let f=o(n.removeArgv[0],n.removeArgv.slice(1));if(f.code!==0)return r.push(`ran: ${j(n.removeArgv)}`,f.stderr.trim()),{exitCode:1,output:`${r.join(`
|
|
24
24
|
`)}
|
|
25
|
-
`}
|
|
25
|
+
`}}let d=o(n.addArgv[0],n.addArgv.slice(1));if(r.push(`ran: ${j(n.addArgv)}`),d.code!==0)return r.push(d.stderr.trim()),{exitCode:1,output:`${r.join(`
|
|
26
26
|
`)}
|
|
27
|
-
`}
|
|
27
|
+
`};d.stdout.trim()&&r.push(d.stdout.trim());let c=K(n);return c&&r.push(c),I(e,t,r,0)}function zo(e,t,o){let n=Fo(e,t),r=[];if(e.hook&&!st(e.host))return{exitCode:2,output:`--hook only applies to Claude Code and Codex
|
|
28
|
+
`};if(e.host==="codex")return vt(e,t,o,n);if(e.host)return r.push(n.jsonSnippet),n.hostConfigPath?r.push("",`config file: ${n.hostConfigPath}`):r.push("",`add this under "mcpServers" in your host's MCP config file.`),{exitCode:0,output:`${r.join(`
|
|
28
29
|
`)}
|
|
29
|
-
`};
|
|
30
|
-
|
|
30
|
+
`};if(e.dryRun){e.force&&r.push(`would run: ${j(n.removeArgv)}`),r.push(`would run: ${j(n.addArgv)}`);let w=K(n);return w&&r.push(w),I(e,t,r,0)}let u=o(n.probeArgv[0],n.probeArgv.slice(1));if(ke(u))return r.push("the claude CLI is not on PATH. Register minnimemory manually:","",` ${n.manualLine}`,"","or add this to another host's MCP config:","",n.jsonSnippet),{exitCode:2,output:`${r.join(`
|
|
31
|
+
`)}
|
|
32
|
+
`};let a=o(n.getArgv[0],n.getArgv.slice(1)),d=a.code===0?pt(a.stdout):void 0,c=d!==void 0&&d!==e.scope;c&&r.push(`minnimemory is also registered at ${d} scope; that registration is left as it is (Claude Code uses local, then project, then user).`);let f=a.code===0&&!c,v=f&&!ut(a.stdout,n);if(f&&!e.force&&!v)return r.push("minnimemory is already registered.",`to change it: ${j(["npx","-y","minnimemory","install","--force","--scope",e.scope,...e.write?["--write"]:[]])}`),I(e,t,r,0);if(f){v&&!e.force&&r.push("minnimemory is registered with a different command; repointing it at this copy.");let w=o(n.removeArgv[0],n.removeArgv.slice(1));if(w.code!==0)return r.push(`ran: ${j(n.removeArgv)}`,w.stderr.trim()),{exitCode:1,output:`${r.join(`
|
|
33
|
+
`)}
|
|
34
|
+
`}}let k=o(n.addArgv[0],n.addArgv.slice(1));if(r.push(`ran: ${j(n.addArgv)}`),k.code!==0)return r.push(k.stderr.trim()),{exitCode:1,output:`${r.join(`
|
|
35
|
+
`)}
|
|
36
|
+
`};k.stdout.trim()&&r.push(k.stdout.trim());let y=K(n);return y&&r.push(y),I(e,t,r,0)}var Ct=!1,V=`
|
|
37
|
+
minnimemory ${ge} the agent memory compiler
|
|
31
38
|
|
|
32
39
|
usage: the four lifecycle verbs, the CLI and the MCP basic profile share.
|
|
33
40
|
The only difference is who writes: the CLI writes to disk itself, the MCP tools return the
|
|
@@ -75,7 +82,11 @@ install options
|
|
|
75
82
|
--force remove an existing registration first, then re-add
|
|
76
83
|
--no-hook skip the three hooks (memory, drift notice, load log); on by default
|
|
77
84
|
--remove remove the MCP registration and the hooks install added (= uninstall)
|
|
78
|
-
--host <name>
|
|
85
|
+
--host <name> codex: register with Codex (codex mcp add) and write the two
|
|
86
|
+
UserPromptSubmit hooks to ~/.codex/hooks.json (--scope user) or
|
|
87
|
+
<repo>/.codex/hooks.json (--scope project; no local scope), then
|
|
88
|
+
run /hooks inside Codex once to trust them
|
|
89
|
+
cursor, windsurf or json: print the mcpServers snippet (and the
|
|
79
90
|
config file for cursor/windsurf) to paste, instead of registering
|
|
80
91
|
with Claude Code; no hook
|
|
81
92
|
without the claude CLI on PATH: print the manual claude mcp add line and the JSON snippet,
|
|
@@ -109,6 +120,14 @@ init and doctor options
|
|
|
109
120
|
--memory-dir <path> the auto memory folder Claude Code names; also the folder to use
|
|
110
121
|
--from-log take the loaded files from Claude Code's own load log for this folder
|
|
111
122
|
--only-this-folder apply to a memory folder with nothing reported, when nothing outside loads it
|
|
123
|
+
--host <name> claude or codex: whose load rules apply (default: detected; codex when
|
|
124
|
+
CODEX_HOME is set or a Codex config.toml registers minnimemory). Codex
|
|
125
|
+
loads one AGENTS.md chain under project_doc_max_bytes, so --loaded and
|
|
126
|
+
--from-log are not needed there
|
|
127
|
+
--host <name> claude or codex: whose load rules apply (default: detected; codex when
|
|
128
|
+
CODEX_HOME is set or a Codex config.toml registers minnimemory). Codex
|
|
129
|
+
loads one AGENTS.md chain under project_doc_max_bytes, so --loaded and
|
|
130
|
+
--from-log are not needed there
|
|
112
131
|
--diff <mode> summary: the plan and the operation list, no file diffs; full: every
|
|
113
132
|
diff too (default full)
|
|
114
133
|
--budget <n> always-loaded token budget AlwaysOnMemory must fit (default: 60% of the file, at least 2000)
|
|
@@ -131,6 +150,14 @@ apply options
|
|
|
131
150
|
--memory-dir <path> the auto memory folder Claude Code names; also the folder to use
|
|
132
151
|
--from-log take the loaded files from Claude Code's own load log for this folder
|
|
133
152
|
--only-this-folder apply to a memory folder with nothing reported, when nothing outside loads it
|
|
153
|
+
--host <name> claude or codex: whose load rules apply (default: detected; codex when
|
|
154
|
+
CODEX_HOME is set or a Codex config.toml registers minnimemory). Codex
|
|
155
|
+
loads one AGENTS.md chain under project_doc_max_bytes, so --loaded and
|
|
156
|
+
--from-log are not needed there
|
|
157
|
+
--host <name> claude or codex: whose load rules apply (default: detected; codex when
|
|
158
|
+
CODEX_HOME is set or a Codex config.toml registers minnimemory). Codex
|
|
159
|
+
loads one AGENTS.md chain under project_doc_max_bytes, so --loaded and
|
|
160
|
+
--from-log are not needed there
|
|
134
161
|
--budget <n> always-loaded token budget AlwaysOnMemory must fit (default: 60% of the file, at least 2000)
|
|
135
162
|
--profile <name> how much token-discipline guidance to embed (default auto)
|
|
136
163
|
auto same as none today, for every source
|
|
@@ -184,6 +211,14 @@ doctor options
|
|
|
184
211
|
--memory-dir <path> the auto memory folder Claude Code names; also the folder to use
|
|
185
212
|
--from-log take the loaded files from Claude Code's own load log for this folder
|
|
186
213
|
--only-this-folder apply to a memory folder with nothing reported, when nothing outside loads it
|
|
214
|
+
--host <name> claude or codex: whose load rules apply (default: detected; codex when
|
|
215
|
+
CODEX_HOME is set or a Codex config.toml registers minnimemory). Codex
|
|
216
|
+
loads one AGENTS.md chain under project_doc_max_bytes, so --loaded and
|
|
217
|
+
--from-log are not needed there
|
|
218
|
+
--host <name> claude or codex: whose load rules apply (default: detected; codex when
|
|
219
|
+
CODEX_HOME is set or a Codex config.toml registers minnimemory). Codex
|
|
220
|
+
loads one AGENTS.md chain under project_doc_max_bytes, so --loaded and
|
|
221
|
+
--from-log are not needed there
|
|
187
222
|
--only <ids> run only these rules, comma separated
|
|
188
223
|
--ignore <ids> skip these rules, comma separated
|
|
189
224
|
--rules list the rule set and exit
|
|
@@ -193,156 +228,159 @@ doctor options
|
|
|
193
228
|
<folder> is required: a repo, a memory directory, or a single file. With none, minnimemory asks
|
|
194
229
|
for it (in a terminal) or stops and says so. Type . for the current folder. An @import that
|
|
195
230
|
points outside the folder is not read; the report names it.
|
|
196
|
-
`;function
|
|
197
|
-
`)}function
|
|
231
|
+
`;function St(){let e=[""," rule set",""];for(let t of Ve)e.push(` ${t.id.padEnd(8)}${t.severity.padEnd(6)}${t.title}`);return e.push(""),e.join(`
|
|
232
|
+
`)}function Ot(e,t){if(e===void 0)return t;if(e==="low"||e==="med"||e==="high")return e;throw new Error(`--fail-on must be one of low, med, high (got "${e}")`)}function Ko(e){return e?e.split(",").map(t=>t.trim()).filter(Boolean):[]}function jt(e,t){return e.matches.length===0?`
|
|
198
233
|
no match for "${e.query}"
|
|
199
234
|
|
|
200
|
-
`:
|
|
235
|
+
`:t?`${e.matches.map(o=>`${o.onDemandFile} > ${o.path.join(" > ")} (${o.tokens} tokens)`).join(`
|
|
201
236
|
`)}
|
|
202
|
-
`:`${e.matches.map(
|
|
237
|
+
`:`${e.matches.map(o=>`## ${o.onDemandFile} > ${o.path.join(" > ")} (lines ${o.startLine}-${o.endLine}, ${o.tokens} tokens, score ${o.score})
|
|
203
238
|
|
|
204
|
-
${
|
|
239
|
+
${o.content}`).join(`
|
|
205
240
|
|
|
206
241
|
---
|
|
207
242
|
|
|
208
243
|
`)}
|
|
209
|
-
`}function
|
|
244
|
+
`}function Mt(e){return e.isTTY?"usage":"serve"}function Vo(){return(e,t)=>{let o=process.platform==="win32",n=bt(e,o?Ho(t):t,{encoding:"utf8",shell:o});return{code:n.status,stdout:n.stdout??"",stderr:n.stderr??"",error:n.error}}}function Et(e){if(e===void 0||e==="user")return"user";if(e==="project"||e==="local")return e;throw new Error(`--scope must be one of user, project, local (got "${e}")`)}function Tt(e){if(e!==void 0){if(e==="cursor"||e==="windsurf"||e==="json"||e==="codex")return e;throw new Error(`--host must be one of codex, cursor, windsurf, json (got "${e}")`)}}function Qo(e){if(e===void 0)return;let t=Number(e);if(!Number.isInteger(t)||t<=0||t>te)throw new Error(`--budget must be a whole number of tokens from 1 to ${te.toLocaleString("en-US")} (got "${e}")`);return Math.floor(t)}function Dt(e,t){let o;try{if(o=$.resolve(e),!S.existsSync(o)||!S.statSync(o).isDirectory())throw new H(`not a directory: ${o}`)}catch(r){return r instanceof H?(process.stderr.write(`
|
|
210
245
|
error: ${r.message}
|
|
211
246
|
|
|
212
247
|
`),2):(process.stderr.write(`
|
|
213
248
|
unexpected error: ${r.stack??String(r)}
|
|
214
249
|
|
|
215
|
-
`),2)}let
|
|
216
|
-
error: --profile must be one of basic, full (got "${
|
|
250
|
+
`),2)}let n=t.profile??"basic";return n!=="basic"&&n!=="full"?(process.stderr.write(`
|
|
251
|
+
error: --profile must be one of basic, full (got "${n}")
|
|
217
252
|
|
|
218
|
-
`),2):((async()=>{let[{StdioServerTransport:r},{createMcpServer:
|
|
253
|
+
`),2):((async()=>{let[{StdioServerTransport:r},{createMcpServer:u}]=await Promise.all([import("@modelcontextprotocol/sdk/server/stdio.js"),import("./chunks/mcpServer-6J4GLXHP.js")]);await u(o,{profile:n,allowWrite:t["allow-write"]===!0,host:J()}).connect(new r)})().catch(r=>{process.stderr.write(`
|
|
219
254
|
mcp server failed: ${r.message??String(r)}
|
|
220
|
-
`),process.exitCode=1}),0)}function
|
|
221
|
-
`)}var
|
|
222
|
-
error: name the folder to read: ${
|
|
255
|
+
`),process.exitCode=1}),0)}function At(){let e=mo(),t=[];if(e.length>0){t.push("still compiled (they keep working without minnimemory; to put the originals back, undo each one):");for(let o of e)t.push(` ${Ue(o)}`)}return t.push(`kept: ${$.dirname(uo())} (init records, the load log, undo backups); delete it yourself once you have checked undo-backups/.`),t.push("restart Claude Code."),t.join(`
|
|
256
|
+
`)}var Rt=new Set(["init","doctor","apply","undo","bench"]);function Pt(e){if(q(process.cwd()))return!0;let t=Ce(e);return le(t)==="compiled"||ue(t)!==void 0||ie(t)!==void 0}function Ce(e){let t=$.resolve(e);return S.existsSync(t)&&S.statSync(t).isFile()?$.dirname(t):t}function It(e){if(q(process.cwd()))return;let t=Ce(e);return ie(t)?qe(t):void 0}function Nt(e){let t=`minnimemory ${e} <folder>`;if(process.stdin.isTTY!==!0){process.stderr.write(`
|
|
257
|
+
error: name the folder to read: ${t} (type . for the current folder)
|
|
223
258
|
|
|
224
259
|
`);return}process.stdout.write(`
|
|
225
260
|
Which folder should minnimemory ${e} read? Only that folder and the folders below it are read.
|
|
226
|
-
folder: `);let
|
|
227
|
-
error: no folder given; run ${
|
|
261
|
+
folder: `);let o=Ht().trim();if(o===""){process.stderr.write(`
|
|
262
|
+
error: no folder given; run ${t}
|
|
228
263
|
|
|
229
|
-
`);return}return
|
|
230
|
-
`)break;
|
|
264
|
+
`);return}return o}function Ht(){let e=Buffer.alloc(1),t="";for(;;){let o;try{o=S.readSync(0,e,0,1,null)}catch{break}if(o===0)break;let n=e.toString("utf8");if(n===`
|
|
265
|
+
`)break;n!=="\r"&&(t+=n)}return t}function _t(e){let t;try{t=$t({args:e,allowPositionals:!0,strict:!0,options:{json:{type:"boolean",default:!1},write:{type:"boolean",default:!1},force:{type:"boolean",default:!1},update:{type:"boolean",default:!1},"allow-secrets":{type:"boolean",default:!1},"episodic-json":{type:"boolean",default:!1},"allow-write":{type:"boolean",default:!1},"follow-external-imports":{type:"boolean",default:!1},"include-auto-memory":{type:"boolean",default:!1},scope:{type:"string"},"dry-run":{type:"boolean",default:!1},"auto-memory":{type:"boolean",default:!1},hook:{type:"boolean",default:!1},"no-hook":{type:"boolean",default:!1},remove:{type:"boolean",default:!1},host:{type:"string"},"host-file":{type:"string",multiple:!0},loaded:{type:"string",multiple:!0},"memory-dir":{type:"string"},"from-log":{type:"boolean",default:!1},"only-this-folder":{type:"boolean",default:!1},turns:{type:"string"},workload:{type:"string"},"whole-files":{type:"boolean",default:!1},"max-tokens":{type:"string"},headings:{type:"boolean",default:!1},dir:{type:"string"},profile:{type:"string"},plan:{type:"string"},ci:{type:"boolean",default:!1},rules:{type:"boolean",default:!1},map:{type:"boolean",default:!1},diff:{type:"string"},"fail-on":{type:"string"},budget:{type:"string"},policy:{type:"string"},only:{type:"string"},ignore:{type:"string"},help:{type:"boolean",short:"h",default:!1},version:{type:"boolean",short:"v",default:!1}}})}catch(s){let l=s.message,p=/argument is ambiguous/.test(l)?`
|
|
231
266
|
(a value that starts with '-' must be written as --option=value; --budget must be positive anyway)`:"";return process.stderr.write(`
|
|
232
|
-
error: ${
|
|
233
|
-
${
|
|
234
|
-
`),0;if(
|
|
235
|
-
`);let
|
|
267
|
+
error: ${l}${p}
|
|
268
|
+
${V}`),2}let{values:o,positionals:n}=t;if(o.help)return process.stdout.write(V),0;if(o.version)return process.stdout.write(`${ge}
|
|
269
|
+
`),0;if(o.rules)return process.stdout.write(St()),0;let r;if(n[0]===void 0){if(Mt({isTTY:process.stdin.isTTY===!0})==="usage")return process.stdout.write(V),0;r="mcp"}else r=n[0];let u=["include-auto-memory","follow-external-imports","auto-memory"].filter(s=>o[s]===!0);u.length>0&&process.stderr.write(` note: ${u.map(s=>`--${s}`).join(", ")} no longer does anything: minnimemory reads only the folder you name
|
|
270
|
+
`);let a=n[1]===void 0?void 0:/^~($|[\\/])/.test(n[1])?W(n[1]):n[1];if(a===void 0&&typeof o["memory-dir"]=="string"&&(a=o["memory-dir"]),a===void 0&&["doctor","apply","undo"].includes(r)){let s=q(process.cwd());s&&(a=s.target??s.memoryDir??s.project)}if(a===void 0&&Rt.has(r)&&(a=Nt(r),a===void 0))return 2;let d=a??".";if(r!=="install"&&r!=="uninstall")if(o.host!==void 0){if(!Ie(o.host))return process.stderr.write(`
|
|
271
|
+
error: --host must be claude or codex for ${r} (got "${o.host}")
|
|
272
|
+
|
|
273
|
+
`),2;B(o.host)}else["init","doctor","apply","undo","mcp"].includes(r)?B(_e({env:process.env,home:Yo.homedir(),cwd:process.cwd()})):B("claude");if(o.policy!==void 0&&r!=="doctor")return process.stderr.write(`
|
|
236
274
|
error: --policy is a doctor option: \`minnimemory doctor <folder> --policy <file>\`
|
|
237
275
|
|
|
238
|
-
`),2;if(
|
|
239
|
-
error: --diff takes summary or full, not "${
|
|
276
|
+
`),2;if(o.diff!==void 0&&o.diff!=="summary"&&o.diff!=="full")return process.stderr.write(`
|
|
277
|
+
error: --diff takes summary or full, not "${o.diff}"
|
|
240
278
|
|
|
241
|
-
`),2;let
|
|
279
|
+
`),2;let c=o.diff,f=[...o.loaded??[],...o["host-file"]??[]].map(s=>W(s));if(o["from-log"]===!0){let s=vo(process.cwd());if(!s)return process.stderr.write(`
|
|
242
280
|
error: no load log for ${process.cwd()}: open Claude Code in this folder once (install adds the hook that writes it), then run this again
|
|
243
281
|
|
|
244
|
-
`),2;for(let
|
|
245
|
-
`);let
|
|
282
|
+
`),2;for(let l of Object.keys(s.files))/\.md$/i.test(l)&&S.existsSync(l)&&f.push($.resolve(l))}let v=typeof o["memory-dir"]=="string"?W(o["memory-dir"]):void 0,y=f.length>0||v!==void 0||o["only-this-folder"]===!0?{files:[...new Set(f)],...v?{memoryDir:v}:{},source:o["from-log"]===!0&&(o.loaded??[]).length===0?"log":"terminal",...o["only-this-folder"]===!0?{onlyThisFolder:!0}:{}}:void 0,w=y||!["doctor","apply"].includes(r)?void 0:It(d),M=y?void 0:ho(process.cwd())??(w?ze(Ce(d)):void 0);w&&process.stderr.write(` note: this machine has no init record for this project, so ${r} uses the one in the repo: ${$.relative(process.cwd(),w).split($.sep).join("/")||w}
|
|
283
|
+
`);let D={cwd:process.cwd(),...y?{reported:y}:M?{reported:M}:{}};if(r==="install"||r==="uninstall"){let s;try{s={write:o.write===!0,scope:Et(o.scope),dryRun:o["dry-run"]===!0,force:o.force===!0,host:Tt(o.host),hook:(o.host===void 0||o.host==="codex")&&o["no-hook"]!==!0,cliPath:process.argv[1]?Ft(process.argv[1]):void 0}}catch(C){return process.stderr.write(`
|
|
246
284
|
error: ${C.message}
|
|
247
285
|
|
|
248
|
-
`),2}let
|
|
286
|
+
`),2}let l={home:Yo.homedir(),platform:process.platform,cwd:process.cwd(),configDir:Fe(),codexConfigDir:Ne("codex"),...process.env.CODEX_HOME?{codexHome:process.env.CODEX_HOME}:{}},p=r==="uninstall"||o.remove===!0,i=p?qo(s,l,Vo()):zo(s,l,Vo()),h=i.exitCode===0?process.stdout:process.stderr;return h.write(`
|
|
249
287
|
${i.output}
|
|
250
|
-
`),p&&h.write(`${
|
|
288
|
+
`),p&&h.write(`${At()}
|
|
251
289
|
|
|
252
|
-
`),i.exitCode}if(r==="init"||r==="apply"){if(r==="init"&&(
|
|
290
|
+
`),i.exitCode}if(r==="init"||r==="apply"){if(r==="init"&&(o.write===!0||o.update===!0))return process.stderr.write(`
|
|
253
291
|
error: init never writes; use apply
|
|
254
292
|
|
|
255
|
-
`),2;let s=
|
|
293
|
+
`),2;let s=o.profile??"auto";if(s!=="auto"&&!Ee(s))return process.stderr.write(`
|
|
256
294
|
error: --profile must be one of auto, none, routing, full (got "${s}")
|
|
257
295
|
|
|
258
|
-
`),2;let
|
|
296
|
+
`),2;let l;try{l=Qo(o.budget)}catch(b){return process.stderr.write(`
|
|
259
297
|
error: ${b.message}
|
|
260
298
|
|
|
261
|
-
`),2}let p=r==="apply",i=s==="auto"?void 0:s,h=
|
|
262
|
-
`:
|
|
263
|
-
`)}else process.stdout.write(
|
|
299
|
+
`),2}let p=r==="apply",i=s==="auto"?void 0:s,h=o["episodic-json"]===!0,C=[...J()==="codex"?["--host codex"]:[],...i?[`--profile ${i}`]:[],...h?["--episodic-json"]:[],...o["only-this-folder"]===!0?["--only-this-folder"]:[]],x={budget:l,force:o.force===!0,profileName:i,episodicJson:h,discover:D};try{if(!p){let Z=S.existsSync(d)&&S.statSync(d).isFile()?$.dirname($.resolve(d)):$.resolve(d),N;try{let L=X(d,D);L.shape==="memory-dir"&&(N=L)}catch{N=void 0}let A=!N&&J()==="codex"?Oo(process.cwd(),{projectRoot:Z}):void 0,ee=A?void 0:N?Co(N):xo(Z,{machine:!1,projectRoot:Z}),Se=A?jo(A):So(ee),Zo=()=>A?Mo(A):$o(ee);if(o.map===!0)return process.stdout.write(o.json?`${JSON.stringify(A??ee,null,2)}
|
|
300
|
+
`:Se),0;o.json||process.stdout.write(Se);let F=fe(d,x);if(o.json){let L=JSON.parse(he(F,a,C));process.stdout.write(`${JSON.stringify({map:Zo(),...L},null,2)}
|
|
301
|
+
`)}else process.stdout.write(me(F,{color:!1,ci:o.ci===!0,target:a,flags:C,diff:c}));let oe=F.workspace.folderRoot??$.resolve(d),Oe=F.workspace.claudeMemoryFolder?oe:void 0,je=po(process.cwd(),y?{...y,...y.memoryDir??Oe?{memoryDir:y.memoryDir??Oe}:{}}:void 0,oe);y&&!o.json&&process.stdout.write(je?` saved what ${He()} loads here for apply, doctor and undo: ${je}
|
|
264
302
|
|
|
265
303
|
`:` could not save the locations; pass them again to apply
|
|
266
304
|
|
|
267
|
-
`);let
|
|
305
|
+
`);let Me=fo(process.cwd(),oe);return Me&&process.stderr.write(` ${Me}
|
|
268
306
|
|
|
269
|
-
`),0}let b=
|
|
307
|
+
`),0}let b=X(d,D);if(b.shape==="memory-dir"&&!b.reported)return process.stderr.write(`
|
|
270
308
|
error: apply refused: nothing reported the files Claude Code loads, so an import of this folder's files from outside it could break. Run from Claude Code (the agent passes them), or add --from-log (Claude Code's own load log for this folder), or --loaded <path> for each file. If nothing outside this folder loads it, pass --only-this-folder. Nothing was changed.
|
|
271
309
|
|
|
272
|
-
`),2;let
|
|
273
|
-
error: the plan on disk no longer matches --plan ${
|
|
310
|
+
`),2;let m=Ze(b,{budget:l??b.manifest?.budget,profileName:i,episodicJson:h,sortAnyway:o.force===!0});if(o.plan!==void 0&&m.plan!==o.plan)return process.stderr.write(`
|
|
311
|
+
error: the plan on disk no longer matches --plan ${o.plan} (now ${m.plan}); run doctor again
|
|
274
312
|
|
|
275
|
-
`),2;if(
|
|
276
|
-
error: ${
|
|
313
|
+
`),2;if(m.verdict==="nothing")return process.stdout.write(de(m,{write:!0})),0;if(m.verdict==="leave"&&o.force!==!0)return process.stderr.write(`
|
|
314
|
+
error: ${lo(m)} (${m.before} -> ${m.after} tokens; break-even ${m.bounds.breakEvenCarriedTokens} tokens of OnDemandMemory open all session)
|
|
277
315
|
Pass --force to write it anyway.
|
|
278
316
|
|
|
279
|
-
`),2;let
|
|
317
|
+
`),2;let Q=de(m,{write:!0,target:a});return eo(m,{allowSecrets:o["allow-secrets"]===!0}),process.stdout.write(Q),0}catch(b){return b instanceof G||b instanceof U?(process.stderr.write(`
|
|
280
318
|
error: ${b.message}
|
|
281
319
|
|
|
282
320
|
`),2):(process.stderr.write(`
|
|
283
321
|
unexpected error: ${b.stack??String(b)}
|
|
284
322
|
|
|
285
|
-
`),2)}}if(r==="undo")try{let s;try{s=
|
|
323
|
+
`),2)}}if(r==="undo")try{let s;try{s=X(d).folderRoot}catch(x){if(!(x instanceof G))throw x}if(!s)return process.stdout.write(`
|
|
286
324
|
nothing to undo
|
|
287
325
|
|
|
288
|
-
`),0;let
|
|
289
|
-
error: ${
|
|
326
|
+
`),0;let l=ue(s),p=l?void 0:co(s),i=p?ao(s,p):!l&&ce(s)?ro(s):no(s,l);if(i.kind==="none")return!l&&ce(s)?(process.stderr.write(`
|
|
327
|
+
error: ${Qe(s)}
|
|
290
328
|
|
|
291
329
|
`),2):(process.stdout.write(`
|
|
292
330
|
nothing to undo
|
|
293
331
|
|
|
294
332
|
`),0);if(i.kind==="kept-only")return process.stderr.write(`
|
|
295
|
-
error: undo has nothing left to restore here: ${
|
|
333
|
+
error: undo has nothing left to restore here: ${so(i.kept)}
|
|
296
334
|
|
|
297
335
|
`),2;if(i.kind==="missing-original")return process.stderr.write(`
|
|
298
|
-
error: no original copy under ${
|
|
336
|
+
error: no original copy under ${ne}/original/ for: ${i.files.join(", ")}.
|
|
299
337
|
Backups stay on the machine that ran apply (they are gitignored), and a clone that re-applied backs up the compiled file, not the original; on a clone, the way back is git history.
|
|
300
338
|
|
|
301
|
-
`),2;let h=
|
|
339
|
+
`),2;let h=oo(i.plan);if(h&&o.force!==!0)return process.stderr.write(`
|
|
302
340
|
error: ${h}
|
|
303
341
|
|
|
304
|
-
`),2;let C=h?
|
|
305
|
-
restored ${i.plan.operations.filter(
|
|
306
|
-
deleted: ${i.plan.operations.filter(
|
|
307
|
-
`+(
|
|
342
|
+
`),2;let C=h?to(i.plan):void 0;return io(i.plan),process.stdout.write(`
|
|
343
|
+
restored ${i.plan.operations.filter(x=>x.op==="write"||x.op==="move").length} file(s) in ${s}
|
|
344
|
+
deleted: ${i.plan.operations.filter(x=>x.op==="delete").length} path(s), ${ne}/ ${i.plan.keptBackups?.length?"kept":"included"}
|
|
345
|
+
`+(ae(i.plan)?` ${ae(i.plan)}
|
|
308
346
|
`:"")+(i.plan.left?.length?` left in place: ${i.plan.left.join(", ")} (without manifest.json undo cannot tell which files there it wrote)
|
|
309
|
-
`:"")+(C?` the files as they were before this undo are copied to ${C.split(
|
|
347
|
+
`:"")+(C?` the files as they were before this undo are copied to ${C.split($.sep).join("/")}
|
|
310
348
|
`:"")+`
|
|
311
|
-
`),0}catch(s){return s instanceof
|
|
349
|
+
`),0}catch(s){return s instanceof U?(process.stderr.write(`
|
|
312
350
|
error: ${s.message}
|
|
313
351
|
|
|
314
352
|
`),2):(process.stderr.write(`
|
|
315
353
|
unexpected error: ${s.stack??String(s)}
|
|
316
354
|
|
|
317
|
-
`),2)}if(r==="mcp")return
|
|
355
|
+
`),2)}if(r==="mcp")return Ct?((async()=>{let[{StdioServerTransport:s},{createDisabledMcpServer:l,DISABLED_MESSAGE:p}]=await Promise.all([import("@modelcontextprotocol/sdk/server/stdio.js"),import("./chunks/mcpServer-6J4GLXHP.js")]);process.stderr.write(`
|
|
318
356
|
mcp: ${p}
|
|
319
357
|
|
|
320
|
-
`),await
|
|
358
|
+
`),await l().connect(new s)})().catch(s=>{process.stderr.write(`
|
|
321
359
|
mcp server failed: ${s.message??String(s)}
|
|
322
|
-
`),process.exitCode=1}),0):
|
|
360
|
+
`),process.exitCode=1}),0):Dt(d,o);if(r==="recall"){let s=n.slice(2).join(" ").trim();if(!s)return process.stderr.write(`
|
|
323
361
|
error: recall needs a query: minnimemory recall <path> <query...>
|
|
324
362
|
|
|
325
|
-
`),2;let
|
|
326
|
-
error: --max-tokens must be a positive number (got "${
|
|
363
|
+
`),2;let l;if(o["max-tokens"]!==void 0){let i=Number(o["max-tokens"]);if(!Number.isFinite(i)||i<=0)return process.stderr.write(`
|
|
364
|
+
error: --max-tokens must be a positive number (got "${o["max-tokens"]}")
|
|
327
365
|
|
|
328
|
-
`),2;
|
|
366
|
+
`),2;l=Math.floor(i)}let p=$.resolve(d);try{let i=le(p),h;if(i==="compiled")h=Xe(p,re(p),s,{maxTokens:l});else if(i==="memory-dir")h=yo(p,s,{maxTokens:l});else return process.stderr.write(`
|
|
329
367
|
error: ${p} is neither a compiled workspace (.minnimemory/manifest.json) nor a manifest-less memory directory (an index file plus topic files) - nothing for recall to query
|
|
330
368
|
|
|
331
|
-
`),2;return process.stdout.write(
|
|
369
|
+
`),2;return process.stdout.write(jt(h,o.headings===!0)),0}catch(i){return i instanceof H||i instanceof go?(process.stderr.write(`
|
|
332
370
|
error: ${i.message}
|
|
333
371
|
|
|
334
372
|
`),2):(process.stderr.write(`
|
|
335
373
|
unexpected error: ${i.stack??String(i)}
|
|
336
374
|
|
|
337
|
-
`),2)}}if(r==="hook"){let s="";try{s=S.readFileSync(0,"utf8")}catch{s=""}let
|
|
375
|
+
`),2)}}if(r==="hook"){let s="";try{s=S.readFileSync(0,"utf8")}catch{s=""}let l;if(o["max-tokens"]!==void 0){let p=Number(o["max-tokens"]);Number.isFinite(p)&&p>0&&(l=Math.floor(p))}try{let p=pe(s),i=wo(p,{headings:o.headings===!0,maxTokens:l,dir:o.dir});i&&process.stdout.write(`${i}
|
|
338
376
|
`)}catch(p){process.stderr.write(`
|
|
339
377
|
hook: ${p.message??String(p)}
|
|
340
|
-
`)}return 0}if(r==="loaded"){let s="";try{s=S.readFileSync(0,"utf8")}catch{s=""}try{
|
|
341
|
-
`)}catch(
|
|
342
|
-
drift: ${
|
|
343
|
-
`)}return 0}if(r==="bench")try{let s
|
|
344
|
-
`),0):(process.stdout.write(
|
|
345
|
-
`),0):(process.stdout.write(
|
|
378
|
+
`)}return 0}if(r==="loaded"){let s="";try{s=S.readFileSync(0,"utf8")}catch{s=""}try{bo(JSON.parse(s))}catch{}return 0}if(r==="drift"){let s="";try{s=S.readFileSync(0,"utf8")}catch{s=""}try{let l=pe(s),p=ko(l);p&&process.stdout.write(`${p}
|
|
379
|
+
`)}catch(l){process.stderr.write(`
|
|
380
|
+
drift: ${l.message??String(l)}
|
|
381
|
+
`)}return 0}if(r==="bench")try{let s=$.resolve(d),l=re(s),p=o.turns===void 0?50:Number(o.turns);if(!Number.isFinite(p))throw new P(`--turns must be a positive whole number (got "${o.turns}")`);let i=se(l,p);if(o.workload===void 0)return o.json===!0?(process.stdout.write(`${JSON.stringify({bounds:i,tokenizer:l.tokenizer},null,2)}
|
|
382
|
+
`),0):(process.stdout.write(we(i,l.tokenizer)),process.stdout.write(Ro()),0);let h=To(o.workload),C=Do(l,h,o["whole-files"]===!0?{}:{root:s});return o.json===!0?(process.stdout.write(`${JSON.stringify({bounds:i,model:C,tokenizer:l.tokenizer},null,2)}
|
|
383
|
+
`),0):(process.stdout.write(we(i,l.tokenizer)),process.stdout.write(Ao(C,l.tokenizer)),0)}catch(s){return s instanceof P||s instanceof H?(process.stderr.write(`
|
|
346
384
|
error: ${s.message}
|
|
347
385
|
|
|
348
386
|
`),2):(process.stderr.write(`
|
|
@@ -350,17 +388,17 @@ ${i.output}
|
|
|
350
388
|
|
|
351
389
|
`),2)}if(r!=="doctor")return process.stderr.write(`
|
|
352
390
|
error: unknown command "${r}"
|
|
353
|
-
${
|
|
354
|
-
error: run init first: doctor checks memory init has already looked at, and init has no record for this project and ${d} has not been compiled. Run \`${
|
|
391
|
+
${V}`),2;if(!Pt(d))return process.stderr.write(`
|
|
392
|
+
error: run init first: doctor checks memory init has already looked at, and init has no record for this project and ${d} has not been compiled. Run \`${Ge(d)}\`.
|
|
355
393
|
|
|
356
|
-
`),2;let
|
|
394
|
+
`),2;let E;try{let s;if(o.policy!==void 0)try{s=Ke(o.policy)}catch(l){throw l instanceof Ye?new Error(`--policy: ${l.message}`):l}E={discover:D,budget:Qo(o.budget)??s?.budgets.always_on_tokens,budgetFromPolicy:o.budget===void 0&&s?.budgets.always_on_tokens!==void 0,policy:s,failOn:Ot(o["fail-on"],"high"),only:Ko(o.only),ignore:Ko(o.ignore),force:o.force===!0}}catch(s){return process.stderr.write(`
|
|
357
395
|
error: ${s.message}
|
|
358
396
|
|
|
359
|
-
`),2}try{let s=
|
|
360
|
-
`);else{let
|
|
397
|
+
`),2}try{let s=fe(d,E);if(o.json)process.stdout.write(`${he(s,a)}
|
|
398
|
+
`);else{let l=!o.ci&&!process.env.NO_COLOR&&process.stdout.isTTY===!0;process.stdout.write(me(s,{color:l,ci:o.ci===!0,target:a,diff:c}))}return Eo(s.audit.findings,s.config.failOn)}catch(s){return s instanceof G||s instanceof U?(process.stderr.write(`
|
|
361
399
|
error: ${s.message}
|
|
362
400
|
|
|
363
401
|
`),2):(process.stderr.write(`
|
|
364
402
|
unexpected error: ${s.stack??String(s)}
|
|
365
403
|
|
|
366
|
-
`),2)}}function
|
|
404
|
+
`),2)}}function Ft(e){try{return S.realpathSync(e)}catch{return $.resolve(e)}}function Lt(){let e=process.argv[1];if(!e)return!1;try{return S.realpathSync(xt(import.meta.url))===S.realpathSync(e)}catch{return!1}}Lt()&&(process.exitCode=_t(process.argv.slice(2)));export{Ct as MCP_STASHED,Mt as defaultCommand,_t as main};
|
package/pkg/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
/* MinniMemoryMCP (c) 2026 MinniAI. Licensed under the MinniMemoryMCP License, see LICENSE. */
|
|
2
|
-
import{a as q,b as z,c as Q,d as X,e as $,n as ee,o as re,p as oe}from"./chunks/chunk-
|
|
2
|
+
import{a as q,b as z,c as Q,d as X,e as $,n as ee,o as re,p as oe}from"./chunks/chunk-SELGA237.js";import{Ba as M,Ka as N,La as H,M as E,Ma as v,N as O,Na as A,Oa as U,Pa as W,Q as S,Qa as g,Ra as h,Sa as B,Ta as K,Ua as w,Va as G,Wa as V,Y as f,Ya as b,Z as c,_ as m,_a as J,a as e,aa as I,ba as F,c as r,ca as T,d as o,e as t,f as p,g as l,h as n,ha as _,i as a,ib as Y,j as i,jb as Z,k as d,kb as j,l as y,la as D,oa as x,ta as R,u as s,ua as L,va as k,wa as u,xa as C,za as P}from"./chunks/chunk-K7XLQMXJ.js";export{X as BASIC_READ_TOOLS,$ as BASIC_WRITE_TOOLS,r as DEFAULT_CONFIG,re as DISABLED_MESSAGE,u as DiscoveryError,m as FolderError,G as HOOK_CLOSE_LINE,w as HOOK_OPEN_LINE,L as HOST_FILES,n as INSTRUCTIONS,k as LIST_FILE_NAMES,E as McpTargetError,f as RULES,A as RecallDirError,q as SERVE_TOOLS,z as SETUP_TOOLS,e as SEVERITY_ORDER,t as TOKENIZER_ID,Q as WRITE_TOOLS,o as alwaysLoaded,F as applyFolderPlan,D as applyFolderUndo,H as auditWorkspace,s as compile,oe as createDisabledMcpServer,ee as createMcpServer,d as defaultProfile,C as detectPhase,P as discover,v as doctor,p as estimateTokens,j as exitCodeFor,h as fenceCode,x as folderPlanSummary,l as formatTokens,U as getDirIndex,K as hookClose,B as hookOpen,i as isProfileName,W as listDirFiles,O as loadManifest,J as parseHookInput,I as planFolder,_ as planFolderUndo,a as profile,M as readFolderManifest,S as recall,g as recallDir,T as renderFolderFiles,R as renderFolderPlan,b as renderHook,Y as renderHuman,y as renderInstructions,Z as renderJson,N as resolveConfig,c as ruleById,V as unwrapHook};
|