minnimemory 1.3.7 → 1.4.1

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.
@@ -1,2 +1,2 @@
1
1
  /* MinniMemoryMCP (c) 2026 MinniAI. Licensed under the MinniMemoryMCP License, see LICENSE. */
2
- import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q}from"./chunk-B5ETYKWT.js";import"./chunk-CR5T6SUD.js";export{m as BASIC_PROMPTS,d as BASIC_READ_TOOLS,e as BASIC_WRITE_TOOLS,q as CONTENT_CAP_CHARS,i as DATA_CLOSE_LINE,h as DATA_OPEN_LINE,o as DISABLED_MESSAGE,j as MARKER_NOTE,a as SERVE_TOOLS,b as SETUP_TOOLS,c as WRITE_TOOLS,k as asData,p as createDisabledMcpServer,n as createMcpServer,g as dataClose,f as dataOpen,l as unwrapData};
2
+ import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q}from"./chunk-7JYDJPVH.js";import"./chunk-M7V2YVAQ.js";export{m as BASIC_PROMPTS,d as BASIC_READ_TOOLS,e as BASIC_WRITE_TOOLS,q as CONTENT_CAP_CHARS,i as DATA_CLOSE_LINE,h as DATA_OPEN_LINE,o as DISABLED_MESSAGE,j as MARKER_NOTE,a as SERVE_TOOLS,b as SETUP_TOOLS,c as WRITE_TOOLS,k as asData,p as createDisabledMcpServer,n as createMcpServer,g as dataClose,f as dataOpen,l as unwrapData};
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 Ge,$a as de,A as Pe,Aa as rt,B as De,Ba as W,Ca as ot,E as Ae,F as Ee,G as E,H as X,Ha as st,I as Ie,K as Ne,Ka as it,L as D,M as Q,N as Fe,O as Z,P as Le,Q as Be,R as He,S as Ue,Sa as at,Ta as dt,U as H,Ua as se,V as Je,W as _e,X as We,Xa as lt,Za as ie,_a as ae,aa as qe,ab as ut,b as P,ba as ze,bb as ct,ca as Ye,cb as pt,da as Ke,db as ft,ea as ee,eb as mt,fa as Ve,fb as le,g,ga as Xe,gb as ue,j as xe,la as Qe,n as Ce,na as te,o as Se,p as Oe,q as Me,qa as U,r as je,ra as ne,s as K,sa as J,t as V,ta as _,ua as re,v as Te,va as oe,w as Re,wa as Ze,xa as et,ya as tt,za as nt}from"./chunks/chunk-CR5T6SUD.js";import{spawnSync as Zt}from"node:child_process";import S from"node:fs";import en from"node:os";import x from"node:path";import{fileURLToPath as tn}from"node:url";import{parseArgs as nn}from"node:util";import Nt from"node:fs";function Ft(e){return e.split(/\r?\n/).map(n=>n.trim()).filter(n=>n!==""&&!n.startsWith("#"))}function ht(e){let n;try{n=Nt.readFileSync(e,"utf8")}catch{throw new D(`cannot read workload file: ${e}`)}let t=Ft(n);if(t.length===0)throw new D(`workload file has no tasks: ${e}
4
- one task description per line, # for comments`);return t}function G(e){return`${e.onDemandFile}:${e.startLine}`}function Lt(e){return`${e.onDemandFile} > ${e.heading}`}function Bt(e,n){let t=P(e).flatMap(o=>Ce({name:o.name,file:o.file},Ie(n,o.file)));return Se(t,new Map(P(e).map(o=>[o.name,o.triggers])))}function gt(e,n,t={}){let o=t.root?Bt(e,t.root):void 0,r=o?"section":"file",c=new Set,u=new Map,d=new Map,l=new Map;for(let i of P(e))u.set(i.name,i.tokens),d.set(i.name,i.name),l.set(i.name,i.name);if(o)for(let i of o.units)u.set(G(i),i.tokens),d.set(G(i),Lt(i)),l.set(G(i),i.onDemandFile);let y=[],v=0;n.forEach((i,h)=>{let C=o?Me(Oe(o,i)).map(f=>G(f.unit)):je(e,i).filter(f=>f.score>0).map(f=>f.name);C.length===0&&v++;let $=C.filter(f=>!c.has(f));for(let f of $)c.add(f);let b=[...c].reduce((f,z)=>f+(u.get(z)??0),0);y.push({turn:h+1,task:i,opened:$.map(f=>d.get(f)??f),carried:[...c].map(f=>d.get(f)??f),compiledTokens:e.prefix.after+b,baselineTokens:e.prefix.before})});let w=y.reduce((i,h)=>i+h.compiledTokens,0),m=y.reduce((i,h)=>i+h.baselineTokens,0),k=new Set([...c].map(i=>l.get(i)??i)),j=P(e).map(i=>i.name).filter(i=>k.has(i)),R=[...c].reduce((i,h)=>i+(u.get(h)??0),0),A=e.prefix.after+R,s=e.prefix.before-A,a=m-w,p;return a>=0?(p=y.findIndex((i,h)=>y.slice(0,h+1).reduce(($,b)=>$+b.baselineTokens-b.compiledTokens,0)>=0),p=p>=0?p+1:void 0):s>0&&(p=y.length+Math.ceil(-a/s)),{unit:r,turns:y,baselineTotal:m,compiledTotal:w,saving:a,savingPct:m===0?0:a/m*100,onDemandOpened:j,onDemandNeverOpened:P(e).map(i=>i.name).filter(i=>!k.has(i)),unroutedTurns:v,steadyStatePerTurn:A,steadyStateGainPerTurn:s,breakEvenTurn:p}}function Ht(e,n){return n===0?"0.0%":`${(e/n*100).toFixed(1)}%`}function ce(e){return e>=0?`saves ${g(e)}`:`costs ${g(-e)} more`}function pe(e,n){let t=[""];return t.push(` exact, over ${g(e.turns)} turns. No workload, no assumptions.`),t.push(""),t.push(` original memory file ${g(e.baselinePerTurn).padStart(8)} tokens per turn`),t.push(` compiled always-loaded ${g(e.compiledPerTurn).padStart(8)} tokens per turn`),t.push(` OnDemandMemory, all of it ${g(e.totalOnDemandTokens).padStart(8)} tokens, on demand`),t.push(""),t.push(" best case, no OnDemandMemory file ever opened"),t.push(` ${g(e.baselineTotal)} -> ${g(e.bestCaseTotal)} tokens, ${ce(e.bestCaseSaving)} (${Ht(e.bestCaseSaving,e.baselineTotal)})`),t.push(""),t.push(" worst case, every OnDemandMemory file opened on turn 1 and carried"),t.push(` ${g(e.baselineTotal)} -> ${g(e.worstCaseTotal)} tokens, ${ce(e.worstCaseSaving)}`),t.push(""),t.push(` break-even: ${g(e.breakEvenCarriedTokens)} tokens of OnDemandMemory can sit in`),t.push(" context from turn 1 to the end and come out even. Past that the compiled"),t.push(" shape costs more than the file it replaced."),t.push(""),t.push(` tokenizer: ${n}, an offline estimate`),t.push(""),t.join(`
5
- `)}function yt(e,n){let t=[""],o=e.turns.length;if(t.push(` MODEL, not a measurement. ${g(o)} turns from the workload you supplied.`),t.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."),t.push(""),t.push(` memory tokens over the session ${g(e.baselineTotal)} -> ${g(e.compiledTotal)}`),t.push(` ${ce(e.saving)}${e.saving>=0?` (${e.savingPct.toFixed(1)}%)`:""}`),t.push(""),e.onDemandOpened.length>0){t.push(` opened and carried (${e.onDemandOpened.length}):`);for(let r of e.onDemandOpened)t.push(` ${r}`);t.push("")}if(e.onDemandNeverOpened.length>0){t.push(` never opened (${e.onDemandNeverOpened.length}) - this is where the saving comes from:`);for(let r of e.onDemandNeverOpened)t.push(` ${r}`);t.push("")}return t.push(" one more turn, once everything this workload opens is in context:"),t.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`),t.push(""),e.saving<0&&e.steadyStateGainPerTurn<=0?(t.push(" this workload never breaks even. The OnDemandMemory files it opens are large enough that"),t.push(" carrying them costs more every turn than the original file did, so a longer"),t.push(" session loses more, not less. Splitting differently, or not compiling this"),t.push(" file at all, is the honest answer here."),t.push("")):e.saving<0&&e.breakEvenTurn!==void 0?(t.push(` behind by ${g(-e.saving)} at turn ${g(e.turns.length)}, recovering ${g(e.steadyStateGainPerTurn)} per turn:`),t.push(` breaks even around turn ${g(e.breakEvenTurn)} if nothing further opens.`),t.push("")):e.saving>=0&&e.breakEvenTurn!==void 0&&(t.push(` ahead from turn ${g(e.breakEvenTurn)} onward.`),t.push("")),e.unroutedTurns>0&&(t.push(` ${g(e.unroutedTurns)} of ${g(o)} turns matched no OnDemandMemory file at all.`),t.push(" Those turns are cheap here, but a real agent may have needed something and"),t.push(" not been routed to it. Check them before trusting the total."),t.push("")),t.push(" what this number is conditional on:"),t.push(" - your workload being what a real session looks like. It is your file;"),t.push(" the tool cannot tell whether it is representative."),e.unit==="section"?(t.push(" - every section recall() returns being carried for the rest of the session,"),t.push(" up to its token cap per turn. A real agent may widen with outline() or"),t.push(" read the whole file anyway.")):(t.push(" - every OnDemandMemory file whose triggers match being opened in full. A real"),t.push(" agent may read one and stop, or ignore one the list offered.")),t.push(" - memory tokens only. Reasoning, tool results and conversation are excluded"),t.push(" from both sides, so this ratio is not a session bill."),t.push(""),t.push(" For observed usage against a live agent, measure a real multi-turn session with"),t.push(" and without the compile. That is the only path allowed to call a number measured."),t.push(""),t.push(` tokenizer: ${n}, an offline estimate`),t.push(""),t.join(`
6
- `)}function wt(){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 O from"node:fs";import M from"node:path";function I(e){let n=Re(e);return n&&Pe(n)?n:void 0}function bt(e){return De(e)??`"${e.replace(/"/g,'\\"')}"`}function T(e){return e.map(bt).join(" ")}function $t(e){return e.map(bt)}function kt(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 Ut(e){if(e==="cursor")return"~/.cursor/mcp.json";if(e==="windsurf")return"~/.codeium/windsurf/mcp_config.json"}function xt(e,n){let t=[];e.write&&t.push("--profile","full","--allow-write");let o=I(e.cliPath),r=o?["node",o,"mcp",...t]:["npx","-y","minnimemory","mcp",...t],c=["claude","mcp","add","minnimemory","-s",e.scope,"--",...r],u=["claude","mcp","remove","minnimemory","-s",e.scope],d=["claude","mcp","get","minnimemory"],l=["claude","--version"],y=T(c),v=JSON.stringify({mcpServers:{minnimemory:{command:"npx",args:["-y","minnimemory","mcp",...t]}}},null,2),w={scope:e.scope,servedFlags:t,servedArgv:r,...o?{servedDirect:o}:{},addArgv:c,removeArgv:u,getArgv:d,probeArgv:l,manualLine:y,jsonSnippet:v};if(e.host&&e.host!=="json"){let m=Ut(e.host);m&&(w.hostConfigPath=m)}return w}function Ct(e){return e.error!==void 0&&e.error.code==="ENOENT"}var me="npx -y minnimemory drift";function Jt(e){let n=I(e);return n?`node "${n}" drift`:me}var he="npx -y minnimemory hook";function _t(e){let n=I(e);return n?`node "${n}" hook`:he}function Wt(e){return typeof e=="string"&&(e===he||ge(e,"hook"))}function Gt(e,n){let t=u=>u.replace(/\\/g,"/").toLowerCase(),o=/^\s*Command:\s*(.*)$/m.exec(e)?.[1]?.trim(),r=/^\s*Args:\s*(.*)$/m.exec(e)?.[1]?.trim(),c=t(o?`${o} ${r??""}
8
- ${e}`:e);return n.servedDirect?c.includes(t(n.servedDirect)):c.includes("npx -y minnimemory mcp")}function qt(e){let n=/Scope:\s*(User|Project|Local)\b/i.exec(e);return n?n[1].toLowerCase():void 0}function ge(e,n){let t=/^node "([^"]+)" (drift|loaded|hook)$/.exec(e);if(t===null||t[2]!==n)return!1;let o=t[1];return/minnimemory/i.test(o)||zt(o)}function zt(e){if(!M.isAbsolute(e))return!1;let n=M.dirname(e);for(let t=0;t<4;t++)try{return JSON.parse(O.readFileSync(M.join(n,"package.json"),"utf8")).name==="minnimemory"}catch{let o=M.dirname(n);if(o===n)return!1;n=o}return!1}function Yt(e){return typeof e=="string"&&(e===me||ge(e,"drift"))}var ye="npx -y minnimemory loaded";function Kt(e){let n=I(e);return n?`node "${n}" loaded`:ye}function Vt(e){return typeof e=="string"&&(e===ye||ge(e,"loaded"))}function St(e){let n=Jt(e),t=_t(e),o=Kt(e);return[{event:"UserPromptSubmit",command:n,fallback:me,isOurs:r=>r===n||Yt(r)},{event:"UserPromptSubmit",command:t,fallback:he,isOurs:r=>r===t||Wt(r)},{event:"InstructionsLoaded",command:o,fallback:ye,isOurs:r=>r===o||Vt(r)}]}function Ot(e,n){let t=n.cwd??process.cwd();return e==="user"?M.join(n.configDir??M.join(n.home,".claude"),"settings.json"):e==="project"?M.join(t,".claude","settings.json"):M.join(t,".claude","settings.local.json")}function Mt(e,n){let t=[];for(let o of e){if(!o||typeof o!="object")continue;let r=o.hooks;if(Array.isArray(r))for(let c of r){let u=c&&typeof c=="object"?c.command:void 0;n(u)&&t.push(u)}}return t}function jt(e){if(!O.existsSync(e))return{};try{let n=JSON.parse(O.readFileSync(e,"utf8"));return!n||typeof n!="object"||Array.isArray(n)?void 0:n}catch{return}}function Tt(e,n){let t=`${JSON.stringify(n,null,2)}
9
- `,o=`${e}.minnimemory-${process.pid}.tmp`;O.writeFileSync(o,t,"utf8");try{O.renameSync(o,e)}catch{O.rmSync(o,{force:!0}),O.writeFileSync(e,t,"utf8")}}function Rt(e){let n=e.hooks;return n&&typeof n=="object"&&!Array.isArray(n)?n:void 0}function Xt(e,n){let t=Ot(e.scope,n),o=St(e.cliPath);if(e.dryRun)return{exitCode:0,output:o.map(l=>`would add the ${l.event} hook \`${l.command}\` to ${t}`).join(`
10
- `),path:t};let r=jt(t);if(!r)return{exitCode:1,output:`install --hook: ${t} is not valid JSON; not touched.`,path:t};let c=Rt(r)??{},u=[],d=!1;for(let l of o){let y=Array.isArray(c[l.event])?[...c[l.event]]:[],v=Mt(y,l.isOurs);if(v.includes(l.command)){u.push(l.event==="UserPromptSubmit"?`hook: \`${l.fallback.split(" ").pop()}\` already present in ${t}`:`hook: ${l.event} already present in ${t}`);continue}if(v.length>0){for(let w of y){let m=w&&typeof w=="object"?w.hooks:void 0;if(Array.isArray(m))for(let k of m)k&&typeof k=="object"&&l.isOurs(k.command)&&(k.command=l.command)}u.push(`hook: updated \`${v[0]}\` -> \`${l.command}\` in ${t} (${l.event}). Restart Claude Code.`)}else{let w={hooks:[{type:"command",command:l.command}]};y.push(w),u.push(`hook: added \`${l.command}\` to ${t} (${l.event}). Restart Claude Code.`)}c[l.event]=y,d=!0}return d&&(r.hooks=c,O.mkdirSync(M.dirname(t),{recursive:!0}),Tt(t,r)),{exitCode:0,output:u.join(`
11
- `),path:t}}function vt(e,n){let t=Ot(e.scope,n),o=St(e.cliPath);if(e.dryRun)return{exitCode:0,output:o.map(d=>`would remove the ${d.event} hook (\`${d.fallback}\` or its direct node form) from ${t}`).join(`
12
- `),path:t};if(!O.existsSync(t))return{exitCode:0,output:`hook: nothing to remove (${t} does not exist)`,path:t};let r=jt(t);if(!r)return{exitCode:1,output:`install --remove: ${t} is not valid JSON; not touched.`,path:t};let c=Rt(r),u=[];for(let d of o){let l=c&&Array.isArray(c[d.event])?c[d.event]:void 0,y=l?Mt(l,d.isOurs):[];if(!c||!l||y.length===0)continue;let v=l.filter(w=>{if(!w||typeof w!="object")return!0;let m=w.hooks;if(!Array.isArray(m))return!0;let k=m.filter(j=>!(j&&typeof j=="object"&&d.isOurs(j.command)));return k.length===0?!1:(w.hooks=k,!0)});v.length===0?delete c[d.event]:c[d.event]=v,u.push(`hook: removed \`${y[0]}\` from ${t}`)}return u.length===0?{exitCode:0,output:`hook: nothing to remove in ${t}`,path:t}:(c&&Object.keys(c).length===0&&delete r.hooks,Tt(t,r),{exitCode:0,output:u.join(`
13
- `),path:t})}function Pt(e,n,t){let o=xt(e,n),r=[];if(e.dryRun){r.push(`would run: ${T(o.removeArgv)}`);let l=vt({...e,dryRun:!0},n);return r.push(l.output),{exitCode:0,output:`${r.join(`
3
+ import{$ as Ze,A as Fe,Aa as ue,B as Le,Ba as q,C as Be,Ca as z,Da as po,G as Ue,Ga as fo,H as Je,Ha as pe,Ia as fe,Ja as mo,K as Ge,Ka as ho,L as We,La as go,M as L,Ma as yo,N as ie,Na as wo,O as Xe,Oa as Y,Pa as ko,Q as qe,R as I,S as ae,T as ze,U as de,Ua as vo,V as Ye,X as Ke,Xa as bo,Z as Ve,_ as Qe,b as N,ba as W,ca as eo,da as oo,db as xo,ea as to,eb as $o,fb as me,g,gb as Co,hb as So,ia as ro,ib as Oo,j as De,ja as no,jb as jo,ka as so,kb as Mo,la as io,lb as To,ma as ao,mb as Eo,n as Ae,na as le,nb as Do,o as Re,oa as lo,ob as Ao,p as Pe,pa as co,q as Ne,r as Ie,rb as Ro,s as re,t as ne,tb as he,ua as uo,ub as ge,v as He,vb as ye,w as G,wa as ce,wb as we,x as F,y as se,z as _e,za as X}from"./chunks/chunk-M7V2YVAQ.js";import{spawnSync as Ot}from"node:child_process";import C from"node:fs";import Zo from"node:os";import b from"node:path";import{fileURLToPath as jt}from"node:url";import{parseArgs as Mt}from"node:util";import st from"node:fs";function it(e){return e.split(/\r?\n/).map(t=>t.trim()).filter(t=>t!==""&&!t.startsWith("#"))}function Po(e){let t;try{t=st.readFileSync(e,"utf8")}catch{throw new I(`cannot read workload file: ${e}`)}let o=it(t);if(o.length===0)throw new I(`workload file has no tasks: ${e}
4
+ one task description per line, # for comments`);return o}function K(e){return`${e.onDemandFile}:${e.startLine}`}function at(e){return`${e.onDemandFile} > ${e.heading}`}function dt(e,t){let o=N(e).flatMap(r=>Ae({name:r.name,file:r.file},Xe(t,r.file)));return Re(o,new Map(N(e).map(r=>[r.name,r.triggers])))}function No(e,t,o={}){let r=o.root?dt(e,o.root):void 0,n=r?"section":"file",u=new Set,a=new Map,d=new Map,l=new Map;for(let i of N(e))a.set(i.name,i.tokens),d.set(i.name,i.name),l.set(i.name,i.name);if(r)for(let i of r.units)a.set(K(i),i.tokens),d.set(K(i),at(i)),l.set(K(i),i.onDemandFile);let f=[],w=0;t.forEach((i,p)=>{let c=r?Ne(Pe(r,i)).map(m=>K(m.unit)):Ie(e,i).filter(m=>m.score>0).map(m=>m.name);c.length===0&&w++;let v=c.filter(m=>!u.has(m));for(let m of v)u.add(m);let x=[...u].reduce((m,$)=>m+(a.get($)??0),0);f.push({turn:p+1,task:i,opened:v.map(m=>d.get(m)??m),carried:[...u].map(m=>d.get(m)??m),compiledTokens:e.prefix.after+x,baselineTokens:e.prefix.before})});let k=f.reduce((i,p)=>i+p.compiledTokens,0),h=f.reduce((i,p)=>i+p.baselineTokens,0),y=new Set([...u].map(i=>l.get(i)??i)),T=N(e).map(i=>i.name).filter(i=>y.has(i)),D=[...u].reduce((i,p)=>i+(a.get(p)??0),0),j=e.prefix.after+D,R=e.prefix.before-j,A=h-k,s;return A>=0?(s=f.findIndex((i,p)=>f.slice(0,p+1).reduce((v,x)=>v+x.baselineTokens-x.compiledTokens,0)>=0),s=s>=0?s+1:void 0):R>0&&(s=f.length+Math.ceil(-A/R)),{unit:n,turns:f,baselineTotal:h,compiledTotal:k,saving:A,savingPct:h===0?0:A/h*100,onDemandOpened:T,onDemandNeverOpened:N(e).map(i=>i.name).filter(i=>!y.has(i)),unroutedTurns:w,steadyStatePerTurn:j,steadyStateGainPerTurn:R,breakEvenTurn:s}}function lt(e,t){return t===0?"0.0%":`${(e/t*100).toFixed(1)}%`}function ke(e){return e>=0?`saves ${g(e)}`:`costs ${g(-e)} more`}function ve(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, ${ke(e.bestCaseSaving)} (${lt(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, ${ke(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 Io(e,t){let o=[""],r=e.turns.length;if(o.push(` MODEL, not a measurement. ${g(r)} 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(` ${ke(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 n of e.onDemandOpened)o.push(` ${n}`);o.push("")}if(e.onDemandNeverOpened.length>0){o.push(` never opened (${e.onDemandNeverOpened.length}) - this is where the saving comes from:`);for(let n of e.onDemandNeverOpened)o.push(` ${n}`);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(r)} 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 Ho(){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 E from"node:fs";import S from"node:path";function B(e){let t=Be(e);return t&&Ue(t)?t:void 0}function ct(e){return e===void 0||e==="codex"}var V=" --host codex";function Lo(e){return Je(e)??`"${e.replace(/"/g,'\\"')}"`}function O(e){return e.map(Lo).join(" ")}function Bo(e){return e.map(Lo)}function Q(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 ut(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 Uo(e){return e.codexConfigDir??S.join(e.home,".codex")}function pt(e){try{return/^\s*\[mcp_servers\.minnimemory\]\s*$/m.test(E.readFileSync(S.join(Uo(e),"config.toml"),"utf8"))}catch{return!1}}function Jo(e,t){let o=[];e.write&&o.push("--profile","full","--allow-write");let r=e.host==="codex";r&&o.push("--host","codex");let n=B(e.cliPath),u=n?["node",n,"mcp",...o]:["npx","-y","minnimemory","mcp",...o],a=r&&t.codexHome?t.codexHome:void 0,d=a?["--env",`CODEX_HOME=${a}`]:[],l=r?["codex","mcp","add","minnimemory",...d,"--",...u]:["claude","mcp","add","minnimemory","-s",e.scope,"--",...u],f=r?["codex","mcp","remove","minnimemory"]:["claude","mcp","remove","minnimemory","-s",e.scope],w=r?["codex","mcp","get","minnimemory"]:["claude","mcp","get","minnimemory"],k=r?["codex","--version"]:["claude","--version"],h=O(l),y=r?["[mcp_servers.minnimemory]",`command = ${JSON.stringify(u[0])}`,`args = [${u.slice(1).map(j=>JSON.stringify(j)).join(", ")}]`,...a?[`env = { CODEX_HOME = ${JSON.stringify(a)} }`]:[]].join(`
8
+ `):void 0,T=JSON.stringify({mcpServers:{minnimemory:{command:"npx",args:["-y","minnimemory","mcp",...o]}}},null,2),D={scope:e.scope,servedFlags:o,servedArgv:u,...n?{servedDirect:n}:{},addArgv:l,removeArgv:f,getArgv:w,probeArgv:k,manualLine:h,jsonSnippet:T,...y?{tomlSnippet:y}:{}};if(e.host&&e.host!=="json"){let j=ut(e.host);j&&(D.hostConfigPath=j)}return D}function be(e){return e.error!==void 0&&e.error.code==="ENOENT"}var xe="npx -y minnimemory drift";function ft(e,t){let o=B(e);return(o?`node "${o}" drift`:xe)+(t==="codex"?V:"")}var $e="npx -y minnimemory hook";function mt(e,t){let o=B(e);return(o?`node "${o}" hook`:$e)+(t==="codex"?V:"")}function Go(e){return e.endsWith(V)?e.slice(0,-V.length):e}function ht(e){if(typeof e!="string")return!1;let t=Go(e);return t===$e||Ce(t,"hook")}function gt(e,t){let o=a=>a.replace(/\\/g,"/").toLowerCase(),r=/^\s*Command:\s*(.*)$/m.exec(e)?.[1]?.trim(),n=/^\s*Args:\s*(.*)$/m.exec(e)?.[1]?.trim(),u=o(r?`${r} ${n??""}
9
+ ${e}`:e);return t.servedDirect?u.includes(o(t.servedDirect)):u.includes("npx -y minnimemory mcp")}function yt(e){let t=/Scope:\s*(User|Project|Local)\b/i.exec(e);return t?t[1].toLowerCase():void 0}function Ce(e,t){let o=/^node "([^"]+)" (drift|loaded|hook)$/.exec(e);if(o===null||o[2]!==t)return!1;let r=o[1];return/minnimemory/i.test(r)||wt(r)}function wt(e){if(!S.isAbsolute(e))return!1;let t=S.dirname(e);for(let o=0;o<4;o++)try{return JSON.parse(E.readFileSync(S.join(t,"package.json"),"utf8")).name==="minnimemory"}catch{let r=S.dirname(t);if(r===t)return!1;t=r}return!1}function kt(e){if(typeof e!="string")return!1;let t=Go(e);return t===xe||Ce(t,"drift")}var Se="npx -y minnimemory loaded";function vt(e){let t=B(e);return t?`node "${t}" loaded`:Se}function bt(e){return typeof e=="string"&&(e===Se||Ce(e,"loaded"))}function Wo(e,t){let o=ft(e,t),r=mt(e,t),n=vt(e),u=[{event:"UserPromptSubmit",command:o,fallback:xe,isOurs:a=>a===o||kt(a)},{event:"UserPromptSubmit",command:r,fallback:$e,isOurs:a=>a===r||ht(a)}];return t==="codex"?u:[...u,{event:"InstructionsLoaded",command:n,fallback:Se,isOurs:a=>a===n||bt(a)}]}function Xo(e,t,o){let r=t.cwd??process.cwd();return o==="codex"?e==="user"?S.join(Uo(t),"hooks.json"):S.join(r,".codex","hooks.json"):e==="user"?S.join(t.configDir??S.join(t.home,".claude"),"settings.json"):e==="project"?S.join(r,".claude","settings.json"):S.join(r,".claude","settings.local.json")}function _o(e){return e==="codex"?"Restart Codex.":"Restart Claude Code."}var xt="then run /hooks inside Codex once to trust the two minnimemory hooks (Codex skips an untrusted hook)";function qo(e,t){let o=[];for(let r of e){if(!r||typeof r!="object")continue;let n=r.hooks;if(Array.isArray(n))for(let u of n){let a=u&&typeof u=="object"?u.command:void 0;t(a)&&o.push(a)}}return o}function zo(e){if(!E.existsSync(e))return{};try{let t=JSON.parse(E.readFileSync(e,"utf8"));return!t||typeof t!="object"||Array.isArray(t)?void 0:t}catch{return}}function Yo(e,t){let o=`${JSON.stringify(t,null,2)}
10
+ `,r=`${e}.minnimemory-${process.pid}.tmp`;E.writeFileSync(r,o,"utf8");try{E.renameSync(r,e)}catch{E.rmSync(r,{force:!0}),E.writeFileSync(e,o,"utf8")}}function Ko(e){let t=e.hooks;return t&&typeof t=="object"&&!Array.isArray(t)?t:void 0}function $t(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=Xo(e.scope,t,e.host),r=Wo(e.cliPath,e.host);if(e.dryRun)return{exitCode:0,output:r.map(l=>`would add the ${l.event} hook \`${l.command}\` to ${o}`).join(`
11
+ `),path:o};let n=zo(o);if(!n)return{exitCode:1,output:`install --hook: ${o} is not valid JSON; not touched.`,path:o};let u=Ko(n)??{},a=[],d=!1;for(let l of r){let f=Array.isArray(u[l.event])?[...u[l.event]]:[],w=qo(f,l.isOurs);if(w.includes(l.command)){a.push(l.event==="UserPromptSubmit"?`hook: \`${l.fallback.split(" ").pop()}\` already present in ${o}`:`hook: ${l.event} already present in ${o}`);continue}if(w.length>0){for(let k of f){let h=k&&typeof k=="object"?k.hooks:void 0;if(Array.isArray(h))for(let y of h)y&&typeof y=="object"&&l.isOurs(y.command)&&(y.command=l.command)}a.push(`hook: updated \`${w[0]}\` -> \`${l.command}\` in ${o} (${l.event}). ${_o(e.host)}`)}else{let k={hooks:[{type:"command",command:l.command}]};f.push(k),a.push(`hook: added \`${l.command}\` to ${o} (${l.event}). ${_o(e.host)}`)}u[l.event]=f,d=!0}return d&&(n.hooks=u,E.mkdirSync(S.dirname(o),{recursive:!0}),Yo(o,n)),{exitCode:0,output:a.join(`
12
+ `),path:o}}function Fo(e,t){let o=Xo(e.scope,t,e.host),r=Wo(e.cliPath,e.host);if(e.dryRun)return{exitCode:0,output:r.map(d=>`would remove the ${d.event} hook (\`${d.fallback}\` or its direct node form) from ${o}`).join(`
13
+ `),path:o};if(!E.existsSync(o))return{exitCode:0,output:`hook: nothing to remove (${o} does not exist)`,path:o};let n=zo(o);if(!n)return{exitCode:1,output:`install --remove: ${o} is not valid JSON; not touched.`,path:o};let u=Ko(n),a=[];for(let d of r){let l=u&&Array.isArray(u[d.event])?u[d.event]:void 0,f=l?qo(l,d.isOurs):[];if(!u||!l||f.length===0)continue;let w=l.filter(k=>{if(!k||typeof k!="object")return!0;let h=k.hooks;if(!Array.isArray(h))return!0;let y=h.filter(T=>!(T&&typeof T=="object"&&d.isOurs(T.command)));return y.length===0?!1:(k.hooks=y,!0)});w.length===0?delete u[d.event]:u[d.event]=w,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 n.hooks,Yo(o,n),{exitCode:0,output:a.join(`
14
+ `),path:o})}function Vo(e,t,o){let r=Jo(e,t),n=[];if(e.dryRun){n.push(`would run: ${O(r.removeArgv)}`);let l=Fo({...e,dryRun:!0},t);return n.push(l.output),{exitCode:0,output:`${n.join(`
14
15
  `)}
15
- `}}let c=t(o.probeArgv[0],o.probeArgv.slice(1)),u=0;if(Ct(c))r.push("the claude CLI is not on PATH; skipping the MCP registration removal.");else{let l=t(o.removeArgv[0],o.removeArgv.slice(1));r.push(`ran: ${T(o.removeArgv)}`),l.code!==0&&/no mcp server named/i.test(`${l.stdout}
16
- ${l.stderr}`)?r.push(`nothing registered as minnimemory in ${e.scope} scope`):l.code!==0?(r.push(l.stderr.trim()),u=1):l.stdout.trim()&&r.push(l.stdout.trim())}let d=vt(e,n);return r.push(d.output),d.exitCode!==0&&(u=d.exitCode),{exitCode:u,output:`${r.join(`
16
+ `}}let u=o(r.probeArgv[0],r.probeArgv.slice(1)),a=0;if(be(u))n.push(`the ${e.host==="codex"?"codex":"claude"} CLI is not on PATH; skipping the MCP registration removal.`);else{let l=o(r.removeArgv[0],r.removeArgv.slice(1));n.push(`ran: ${O(r.removeArgv)}`),l.code!==0&&/no mcp server named/i.test(`${l.stdout}
17
+ ${l.stderr}`)?n.push(`nothing registered as minnimemory in ${e.scope} scope`):l.code!==0?(n.push(l.stderr.trim()),a=1):l.stdout.trim()&&n.push(l.stdout.trim())}let d=Fo(e,t);return n.push(d.output),d.exitCode!==0&&(a=d.exitCode),{exitCode:a,output:`${n.join(`
17
18
  `)}
18
- `}}function Qt(e){let n=I(e);return`next: restart Claude Code, then ask it to clean up your memory with minnimemory; it starts with init. In a terminal: \`${n?`node "${n}" init`:"npx -y minnimemory init"} <folder> --from-log\` from your project.`}function fe(e,n,t,o){if(e.hook){let r=Xt(e,n);t.push(r.output),r.exitCode!==0&&(o=r.exitCode)}return o===0&&t.push(Qt(e.cliPath)),{exitCode:o,output:`${t.join(`
19
+ `}}function Ct(e,t){let o=B(e),r=o?`node "${o}" init`:"npx -y minnimemory init";return t==="codex"?`next: restart Codex, ${xt}, then ask it to clean up your memory with minnimemory; it starts with init. In a terminal: \`${r} <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: \`${r} <folder> --from-log\` from your project.`}function H(e,t,o,r){if(e.hook){let n=$t(e,t);o.push(n.output),n.exitCode!==0&&(r=n.exitCode)}return r===0&&o.push(Ct(e.cliPath,e.host)),{exitCode:r,output:`${o.join(`
19
20
  `)}
20
- `}}function Dt(e,n,t){let o=xt(e,n),r=[];if(e.hook&&e.host)return{exitCode:2,output:`--hook only applies to Claude Code
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 St(e,t,o,r){let n=[];if(e.dryRun){e.force&&n.push(`would run: ${O(r.removeArgv)}`),n.push(`would run: ${O(r.addArgv)}`);let f=Q(r);return f&&n.push(f),H(e,t,n,0)}let u=o(r.probeArgv[0],r.probeArgv.slice(1));if(be(u))return n.push("the codex CLI is not on PATH. Register minnimemory manually:","",` ${r.manualLine}`,"",`or add this to ${r.hostConfigPath??"~/.codex/config.toml"}:`,"",r.tomlSnippet??""),{exitCode:2,output:`${n.join(`
22
22
  `)}
23
- `};if(e.dryRun){e.force&&r.push(`would run: ${T(o.removeArgv)}`),r.push(`would run: ${T(o.addArgv)}`);let k=kt(o);return k&&r.push(k),fe(e,n,r,0)}let c=t(o.probeArgv[0],o.probeArgv.slice(1));if(Ct(c))return r.push("the claude CLI is not on PATH. Register minnimemory manually:","",` ${o.manualLine}`,"","or add this to another host's MCP config:","",o.jsonSnippet),{exitCode:2,output:`${r.join(`
23
+ `};let a=pt(t);if(a&&!e.force)return n.push("minnimemory is already registered with Codex.",`to change it: ${O(["npx","-y","minnimemory","install","--host","codex","--force",...e.write?["--write"]:[]])}`),H(e,t,n,0);if(a){let f=o(r.removeArgv[0],r.removeArgv.slice(1));if(f.code!==0)return n.push(`ran: ${O(r.removeArgv)}`,f.stderr.trim()),{exitCode:1,output:`${n.join(`
24
24
  `)}
25
- `};let u=t(o.getArgv[0],o.getArgv.slice(1)),d=u.code===0?qt(u.stdout):void 0,l=d!==void 0&&d!==e.scope;l&&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 y=u.code===0&&!l,v=y&&!Gt(u.stdout,o);if(y&&!e.force&&!v)return r.push("minnimemory is already registered.",`to change it: ${T(["npx","-y","minnimemory","install","--force","--scope",e.scope,...e.write?["--write"]:[]])}`),fe(e,n,r,0);if(y){v&&!e.force&&r.push("minnimemory is registered with a different command; repointing it at this copy.");let k=t(o.removeArgv[0],o.removeArgv.slice(1));if(k.code!==0)return r.push(`ran: ${T(o.removeArgv)}`,k.stderr.trim()),{exitCode:1,output:`${r.join(`
25
+ `}}let d=o(r.addArgv[0],r.addArgv.slice(1));if(n.push(`ran: ${O(r.addArgv)}`),d.code!==0)return n.push(d.stderr.trim()),{exitCode:1,output:`${n.join(`
26
26
  `)}
27
- `}}let w=t(o.addArgv[0],o.addArgv.slice(1));if(r.push(`ran: ${T(o.addArgv)}`),w.code!==0)return r.push(w.stderr.trim()),{exitCode:1,output:`${r.join(`
27
+ `};d.stdout.trim()&&n.push(d.stdout.trim());let l=Q(r);return l&&n.push(l),H(e,t,n,0)}function Qo(e,t,o){let r=Jo(e,t),n=[];if(e.hook&&!ct(e.host))return{exitCode:2,output:`--hook only applies to Claude Code and Codex
28
+ `};if(e.host==="codex")return St(e,t,o,r);if(e.host)return n.push(r.jsonSnippet),r.hostConfigPath?n.push("",`config file: ${r.hostConfigPath}`):n.push("",`add this under "mcpServers" in your host's MCP config file.`),{exitCode:0,output:`${n.join(`
28
29
  `)}
29
- `};w.stdout.trim()&&r.push(w.stdout.trim());let m=kt(o);return m&&r.push(m),fe(e,n,r,0)}var rn=!1,q=`
30
- minnimemory ${ue} the agent memory compiler
30
+ `};if(e.dryRun){e.force&&n.push(`would run: ${O(r.removeArgv)}`),n.push(`would run: ${O(r.addArgv)}`);let y=Q(r);return y&&n.push(y),H(e,t,n,0)}let u=o(r.probeArgv[0],r.probeArgv.slice(1));if(be(u))return n.push("the claude CLI is not on PATH. Register minnimemory manually:","",` ${r.manualLine}`,"","or add this to another host's MCP config:","",r.jsonSnippet),{exitCode:2,output:`${n.join(`
31
+ `)}
32
+ `};let a=o(r.getArgv[0],r.getArgv.slice(1)),d=a.code===0?yt(a.stdout):void 0,l=d!==void 0&&d!==e.scope;l&&n.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&&!l,w=f&&!gt(a.stdout,r);if(f&&!e.force&&!w)return n.push("minnimemory is already registered.",`to change it: ${O(["npx","-y","minnimemory","install","--force","--scope",e.scope,...e.write?["--write"]:[]])}`),H(e,t,n,0);if(f){w&&!e.force&&n.push("minnimemory is registered with a different command; repointing it at this copy.");let y=o(r.removeArgv[0],r.removeArgv.slice(1));if(y.code!==0)return n.push(`ran: ${O(r.removeArgv)}`,y.stderr.trim()),{exitCode:1,output:`${n.join(`
33
+ `)}
34
+ `}}let k=o(r.addArgv[0],r.addArgv.slice(1));if(n.push(`ran: ${O(r.addArgv)}`),k.code!==0)return n.push(k.stderr.trim()),{exitCode:1,output:`${n.join(`
35
+ `)}
36
+ `};k.stdout.trim()&&n.push(k.stdout.trim());let h=Q(r);return h&&n.push(h),H(e,t,n,0)}var Tt=!1,Z=`
37
+ minnimemory ${we} 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> cursor, windsurf or json: print the mcpServers snippet (and the
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,174 +228,182 @@ 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 on(){let e=[""," rule set",""];for(let n of Ue)e.push(` ${n.id.padEnd(8)}${n.severity.padEnd(6)}${n.title}`);return e.push(""),e.join(`
197
- `)}function sn(e,n){if(e===void 0)return n;if(e==="low"||e==="med"||e==="high")return e;throw new Error(`--fail-on must be one of low, med, high (got "${e}")`)}function At(e){return e?e.split(",").map(n=>n.trim()).filter(Boolean):[]}function an(e,n){return e.matches.length===0?`
231
+ `;function Et(){let e=[""," rule set",""];for(let t of Ze)e.push(` ${t.id.padEnd(8)}${t.severity.padEnd(6)}${t.title}`);return e.push(""),e.join(`
232
+ `)}function Dt(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 et(e){return e?e.split(",").map(t=>t.trim()).filter(Boolean):[]}function At(e,t){return e.matches.length===0?`
198
233
  no match for "${e.query}"
199
234
 
200
- `:n?`${e.matches.map(t=>`${t.onDemandFile} > ${t.path.join(" > ")} (${t.tokens} tokens)`).join(`
235
+ `:t?`${e.matches.map(o=>`${o.onDemandFile} > ${o.path.join(" > ")} (${o.tokens} tokens)`).join(`
201
236
  `)}
202
- `:`${e.matches.map(t=>`## ${t.onDemandFile} > ${t.path.join(" > ")} (lines ${t.startLine}-${t.endLine}, ${t.tokens} tokens, score ${t.score})
237
+ `:`${e.matches.map(o=>`## ${o.onDemandFile} > ${o.path.join(" > ")} (lines ${o.startLine}-${o.endLine}, ${o.tokens} tokens, score ${o.score})
203
238
 
204
- ${t.content}`).join(`
239
+ ${o.content}`).join(`
205
240
 
206
241
  ---
207
242
 
208
243
  `)}
209
- `}function dn(e){return e.isTTY?"usage":"serve"}function Et(){return(e,n)=>{let t=process.platform==="win32",o=Zt(e,t?$t(n):n,{encoding:"utf8",shell:t});return{code:o.status,stdout:o.stdout??"",stderr:o.stderr??"",error:o.error}}}function ln(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 un(e){if(e!==void 0){if(e==="cursor"||e==="windsurf"||e==="json")return e;throw new Error(`--host must be one of cursor, windsurf, json (got "${e}")`)}}function It(e){if(e===void 0)return;let n=Number(e);if(!Number.isInteger(n)||n<=0||n>K)throw new Error(`--budget must be a whole number of tokens from 1 to ${K.toLocaleString("en-US")} (got "${e}")`);return Math.floor(n)}function cn(e,n){let t;try{if(t=x.resolve(e),!S.existsSync(t)||!S.statSync(t).isDirectory())throw new E(`not a directory: ${t}`)}catch(r){return r instanceof E?(process.stderr.write(`
210
- error: ${r.message}
244
+ `}function Rt(e){return e.isTTY?"usage":"serve"}function ot(){return(e,t)=>{let o=process.platform==="win32",r=Ot(e,o?Bo(t):t,{encoding:"utf8",shell:o});return{code:r.status,stdout:r.stdout??"",stderr:r.stderr??"",error:r.error}}}function Pt(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 Nt(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 tt(e){if(e===void 0)return;let t=Number(e);if(!Number.isInteger(t)||t<=0||t>re)throw new Error(`--budget must be a whole number of tokens from 1 to ${re.toLocaleString("en-US")} (got "${e}")`);return Math.floor(t)}function It(e,t){let o;try{if(o=b.resolve(e),!C.existsSync(o)||!C.statSync(o).isDirectory())throw new L(`not a directory: ${o}`)}catch(n){return n instanceof L?(process.stderr.write(`
245
+ error: ${n.message}
211
246
 
212
247
  `),2):(process.stderr.write(`
213
- unexpected error: ${r.stack??String(r)}
248
+ unexpected error: ${n.stack??String(n)}
214
249
 
215
- `),2)}let o=n.profile??"basic";return o!=="basic"&&o!=="full"?(process.stderr.write(`
216
- error: --profile must be one of basic, full (got "${o}")
250
+ `),2)}let r=t.profile??"basic";return r!=="basic"&&r!=="full"?(process.stderr.write(`
251
+ error: --profile must be one of basic, full (got "${r}")
217
252
 
218
- `),2):((async()=>{let[{StdioServerTransport:r},{createMcpServer:c}]=await Promise.all([import("@modelcontextprotocol/sdk/server/stdio.js"),import("./chunks/mcpServer-2FYD5LS3.js")]);await c(t,{profile:o,allowWrite:n["allow-write"]===!0}).connect(new r)})().catch(r=>{process.stderr.write(`
219
- mcp server failed: ${r.message??String(r)}
220
- `),process.exitCode=1}),0)}function pn(){let e=rt(),n=[];if(e.length>0){n.push("still compiled (they keep working without minnimemory; to put the originals back, undo each one):");for(let t of e)n.push(` ${Ae(t)}`)}return n.push(`kept: ${x.dirname(et())} (init records, the load log, undo backups); delete it yourself once you have checked undo-backups/.`),n.push("restart Claude Code."),n.join(`
221
- `)}var fn=new Set(["init","doctor","apply","undo","bench"]);function mn(e){if(W(process.cwd()))return!0;let n=we(e);return ne(n)==="compiled"||oe(n)!==void 0||Z(n)!==void 0}function we(e){let n=x.resolve(e);return S.existsSync(n)&&S.statSync(n).isFile()?x.dirname(n):n}function hn(e){if(W(process.cwd()))return;let n=we(e);return Z(n)?Fe(n):void 0}function gn(e){let n=`minnimemory ${e} <folder>`;if(process.stdin.isTTY!==!0){process.stderr.write(`
222
- error: name the folder to read: ${n} (type . for the current folder)
253
+ `),2):((async()=>{let[{StdioServerTransport:n},{createMcpServer:u}]=await Promise.all([import("@modelcontextprotocol/sdk/server/stdio.js"),import("./chunks/mcpServer-2JD64MUD.js")]);await u(o,{profile:r,allowWrite:t["allow-write"]===!0,host:F()}).connect(new n)})().catch(n=>{process.stderr.write(`
254
+ mcp server failed: ${n.message??String(n)}
255
+ `),process.exitCode=1}),0)}function Ht(){let e=wo(),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(` ${Ge(o)}`)}return t.push(`kept: ${b.dirname(ho())} (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 _t=new Set(["init","doctor","apply","undo","bench"]);function Ft(e){if(Y(process.cwd()))return!0;let t=Oe(e);return ue(t)==="compiled"||fe(t)!==void 0||de(t)!==void 0}function Oe(e){let t=b.resolve(e);return C.existsSync(t)&&C.statSync(t).isFile()?b.dirname(t):t}function Lt(e){if(Y(process.cwd()))return;let t=Oe(e);return de(t)?ze(t):void 0}function Bt(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 t=yn().trim();if(t===""){process.stderr.write(`
227
- error: no folder given; run ${n}
261
+ folder: `);let o=Ut().trim();if(o===""){process.stderr.write(`
262
+ error: no folder given; run ${t}
228
263
 
229
- `);return}return t}function yn(){let e=Buffer.alloc(1),n="";for(;;){let t;try{t=S.readSync(0,e,0,1,null)}catch{break}if(t===0)break;let o=e.toString("utf8");if(o===`
230
- `)break;o!=="\r"&&(n+=o)}return n}function wn(e){let n;try{n=nn({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 a=s.message,p=/argument is ambiguous/.test(a)?`
264
+ `);return}return o}function Ut(){let e=Buffer.alloc(1),t="";for(;;){let o;try{o=C.readSync(0,e,0,1,null)}catch{break}if(o===0)break;let r=e.toString("utf8");if(r===`
265
+ `)break;r!=="\r"&&(t+=r)}return t}function Jt(e){let t;try{t=Mt({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 i=s.message,p=/argument is ambiguous/.test(i)?`
231
266
  (a value that starts with '-' must be written as --option=value; --budget must be positive anyway)`:"";return process.stderr.write(`
232
- error: ${a}${p}
233
- ${q}`),2}let{values:t,positionals:o}=n;if(t.help)return process.stdout.write(q),0;if(t.version)return process.stdout.write(`${ue}
234
- `),0;if(t.rules)return process.stdout.write(on()),0;let r;if(o[0]===void 0){if(dn({isTTY:process.stdin.isTTY===!0})==="usage")return process.stdout.write(q),0;r="mcp"}else r=o[0];let c=["include-auto-memory","follow-external-imports","auto-memory"].filter(s=>t[s]===!0);c.length>0&&process.stderr.write(` note: ${c.map(s=>`--${s}`).join(", ")} no longer does anything: minnimemory reads only the folder you name
235
- `);let u=o[1]===void 0?void 0:/^~($|[\\/])/.test(o[1])?J(o[1]):o[1];if(u===void 0&&typeof t["memory-dir"]=="string"&&(u=t["memory-dir"]),u===void 0&&["doctor","apply","undo"].includes(r)){let s=W(process.cwd());s&&(u=s.target??s.memoryDir??s.project)}if(u===void 0&&fn.has(r)&&(u=gn(r),u===void 0))return 2;let d=u??".";if(t.policy!==void 0&&r!=="doctor")return process.stderr.write(`
267
+ error: ${i}${p}
268
+ ${Z}`),2}let{values:o,positionals:r}=t;if(o.help)return process.stdout.write(Z),0;if(o.version)return process.stdout.write(`${we}
269
+ `),0;if(o.rules)return process.stdout.write(Et()),0;let n;if(r[0]===void 0){if(Rt({isTTY:process.stdin.isTTY===!0})==="usage")return process.stdout.write(Z),0;n="mcp"}else n=r[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=r[1]===void 0?void 0:/^~($|[\\/])/.test(r[1])?q(r[1]):r[1];if(a===void 0&&typeof o["memory-dir"]=="string"&&(a=o["memory-dir"]),a===void 0&&["doctor","apply","undo"].includes(n)){let s=Y(process.cwd());s&&(a=s.target??s.memoryDir??s.project)}if(a===void 0&&_t.has(n)&&(a=Bt(n),a===void 0))return 2;let d=a??".";if(n!=="install"&&n!=="uninstall")if(o.host!==void 0){if(!He(o.host))return process.stderr.write(`
271
+ error: --host must be claude or codex for ${n} (got "${o.host}")
272
+
273
+ `),2;G(o.host)}else["init","doctor","apply","undo","mcp"].includes(n)?G(Fe({env:process.env,home:Zo.homedir(),cwd:process.cwd()})):G("claude");if(o.policy!==void 0&&n!=="doctor")return process.stderr.write(`
236
274
  error: --policy is a doctor option: \`minnimemory doctor <folder> --policy <file>\`
237
275
 
238
- `),2;if(t.diff!==void 0&&t.diff!=="summary"&&t.diff!=="full")return process.stderr.write(`
239
- error: --diff takes summary or full, not "${t.diff}"
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 l=t.diff,y=[...t.loaded??[],...t["host-file"]??[]].map(s=>J(s));if(t["from-log"]===!0){let s=ut(process.cwd());if(!s)return process.stderr.write(`
279
+ `),2;let l=o.diff,f=[...o.loaded??[],...o["host-file"]??[]].map(s=>q(s));if(o["from-log"]===!0){let s=Co(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 a of Object.keys(s.files))/\.md$/i.test(a)&&S.existsSync(a)&&y.push(x.resolve(a))}let v=typeof t["memory-dir"]=="string"?J(t["memory-dir"]):void 0,m=y.length>0||v!==void 0||t["only-this-folder"]===!0?{files:[...new Set(y)],...v?{memoryDir:v}:{},source:t["from-log"]===!0&&(t.loaded??[]).length===0?"log":"terminal",...t["only-this-folder"]===!0?{onlyThisFolder:!0}:{}}:void 0,k=m||!["doctor","apply"].includes(r)?void 0:hn(d),j=m?void 0:ot(process.cwd())??(k?Le(we(d)):void 0);k&&process.stderr.write(` note: this machine has no init record for this project, so ${r} uses the one in the repo: ${x.relative(process.cwd(),k).split(x.sep).join("/")||k}
245
- `);let R={cwd:process.cwd(),...m?{reported:m}:j?{reported:j}:{}};if(r==="install"||r==="uninstall"){let s;try{s={write:t.write===!0,scope:ln(t.scope),dryRun:t["dry-run"]===!0,force:t.force===!0,host:un(t.host),hook:t.host===void 0&&t["no-hook"]!==!0,cliPath:process.argv[1]?kn(process.argv[1]):void 0}}catch(C){return process.stderr.write(`
246
- error: ${C.message}
282
+ `),2;for(let i of Object.keys(s.files))/\.md$/i.test(i)&&C.existsSync(i)&&f.push(b.resolve(i))}let w=typeof o["memory-dir"]=="string"?q(o["memory-dir"]):void 0;if(w&&F()==="codex"&&Ke(se("codex"),w))return process.stderr.write(`
283
+ error: ${w.split(b.sep).join("/")} is Codex's own memories folder: Codex generates and rewrites it, so minnimemory lists it in the map and never compiles it. Run init on the project; Codex's AGENTS.md files are what it works on.
284
+
285
+ `),2;let h=f.length>0||w!==void 0||o["only-this-folder"]===!0?{files:[...new Set(f)],...w?{memoryDir:w}:{},source:o["from-log"]===!0&&(o.loaded??[]).length===0?"log":"terminal",...o["only-this-folder"]===!0?{onlyThisFolder:!0}:{}}:void 0,y=h||!["doctor","apply"].includes(n)?void 0:Lt(d),T=h?void 0:ko(process.cwd())??(y?Ye(Oe(d)):void 0);y&&process.stderr.write(` note: this machine has no init record for this project, so ${n} uses the one in the repo: ${b.relative(process.cwd(),y).split(b.sep).join("/")||y}
286
+ `);let D={cwd:process.cwd(),...h?{reported:h}:T?{reported:T}:{}},j,R;if(n==="init"){let s=po(d,{reported:h});s&&(j=fo(d,s),R=b.resolve(d),d=s.dir,a=s.dir)}if(n==="install"||n==="uninstall"){let s;try{s={write:o.write===!0,scope:Pt(o.scope),dryRun:o["dry-run"]===!0,force:o.force===!0,host:Nt(o.host),hook:(o.host===void 0||o.host==="codex")&&o["no-hook"]!==!0,cliPath:process.argv[1]?Gt(process.argv[1]):void 0}}catch(x){return process.stderr.write(`
287
+ error: ${x.message}
247
288
 
248
- `),2}let a={home:en.homedir(),platform:process.platform,cwd:process.cwd(),configDir:Te()},p=r==="uninstall"||t.remove===!0,i=p?Pt(s,a,Et()):Dt(s,a,Et()),h=i.exitCode===0?process.stdout:process.stderr;return h.write(`
249
- ${i.output}
250
- `),p&&h.write(`${pn()}
289
+ `),2}let i={home:Zo.homedir(),platform:process.platform,cwd:process.cwd(),configDir:Le(),codexConfigDir:se("codex"),...process.env.CODEX_HOME?{codexHome:process.env.CODEX_HOME}:{}},p=n==="uninstall"||o.remove===!0,c=p?Vo(s,i,ot()):Qo(s,i,ot()),v=c.exitCode===0?process.stdout:process.stderr;return v.write(`
290
+ ${c.output}
291
+ `),p&&v.write(`${Ht()}
251
292
 
252
- `),i.exitCode}if(r==="init"||r==="apply"){if(r==="init"&&(t.write===!0||t.update===!0))return process.stderr.write(`
293
+ `),c.exitCode}if(n==="init"||n==="apply"){if(n==="init"&&(o.write===!0||o.update===!0))return process.stderr.write(`
253
294
  error: init never writes; use apply
254
295
 
255
- `),2;let s=t.profile??"auto";if(s!=="auto"&&!xe(s))return process.stderr.write(`
296
+ `),2;let s=o.profile??"auto";if(s!=="auto"&&!De(s))return process.stderr.write(`
256
297
  error: --profile must be one of auto, none, routing, full (got "${s}")
257
298
 
258
- `),2;let a;try{a=It(t.budget)}catch(b){return process.stderr.write(`
259
- error: ${b.message}
299
+ `),2;let i;try{i=tt(o.budget)}catch($){return process.stderr.write(`
300
+ error: ${$.message}
301
+
302
+ `),2}let p=n==="apply",c=s==="auto"?void 0:s,v=o["episodic-json"]===!0,x=[...F()==="codex"?["--host codex"]:[],...c?[`--profile ${c}`]:[],...v?["--episodic-json"]:[],...o["only-this-folder"]===!0?["--only-this-folder"]:[]],m={budget:i,force:o.force===!0,profileName:c,episodicJson:v,discover:D};try{if(!p){let ee=C.existsSync(d)&&C.statSync(d).isFile()?b.dirname(b.resolve(d)):b.resolve(d),_;try{let J=z(d,D);J.shape==="memory-dir"&&(_=J)}catch{_=void 0}let P=!_&&F()==="codex"?Eo(process.cwd(),{projectRoot:R??ee}):void 0,oe=P?void 0:_?Mo(_):Oo(ee,{machine:!1,projectRoot:ee}),je=P?Do(P):To(oe),nt=()=>P?Ao(P):jo(oe);if(o.map===!0)return process.stdout.write(o.json?`${JSON.stringify(P??oe,null,2)}
303
+ `:je),0;o.json||process.stdout.write(je),j&&!o.json&&process.stdout.write(` ${j}
260
304
 
261
- `),2}let p=r==="apply",i=s==="auto"?void 0:s,h=t["episodic-json"]===!0,C=[...i?[`--profile ${i}`]:[],...h?["--episodic-json"]:[],...t["only-this-folder"]===!0?["--only-this-folder"]:[]],$={budget:a,force:t.force===!0,profileName:i,episodicJson:h,discover:R};try{if(!p){let ke=S.existsSync(d)&&S.statSync(d).isFile()?x.dirname(x.resolve(d)):x.resolve(d),N;try{let B=_(d,R);B.shape==="memory-dir"&&(N=B)}catch{N=void 0}let F=N?mt(N):pt(ke,{machine:!1,projectRoot:ke});if(t.map===!0)return process.stdout.write(t.json?`${JSON.stringify(F,null,2)}
262
- `:le(F)),0;t.json||process.stdout.write(le(F));let L=ie(d,$);if(t.json){let B=JSON.parse(de(L,u,C));process.stdout.write(`${JSON.stringify({map:ft(F),...B},null,2)}
263
- `)}else process.stdout.write(ae(L,{color:!1,ci:t.ci===!0,target:u,flags:C,diff:l}));let Y=L.workspace.folderRoot??x.resolve(d),ve=L.workspace.claudeMemoryFolder?Y:void 0,be=tt(process.cwd(),m?{...m,...m.memoryDir??ve?{memoryDir:m.memoryDir??ve}:{}}:void 0,Y);m&&!t.json&&process.stdout.write(be?` saved what Claude Code loads here for apply, doctor and undo: ${be}
305
+ `);let U=he(d,m);if(o.json){let J=JSON.parse(ye(U,a,x));process.stdout.write(`${JSON.stringify({map:nt(),...J},null,2)}
306
+ `)}else process.stdout.write(ge(U,{color:!1,ci:o.ci===!0,target:a,flags:x,diff:l}));let te=U.workspace.folderRoot??b.resolve(d),Me=U.workspace.claudeMemoryFolder?te:void 0,Te=go(process.cwd(),h?{...h,...h.memoryDir??Me?{memoryDir:h.memoryDir??Me}:{}}:void 0,te);h&&!o.json&&process.stdout.write(Te?` saved what ${_e()} loads here for apply, doctor and undo: ${Te}
264
307
 
265
308
  `:` could not save the locations; pass them again to apply
266
309
 
267
- `);let $e=nt(process.cwd(),Y);return $e&&process.stderr.write(` ${$e}
310
+ `);let Ee=yo(process.cwd(),te);return Ee&&process.stderr.write(` ${Ee}
268
311
 
269
- `),0}let b=_(d,R);if(b.shape==="memory-dir"&&!b.reported)return process.stderr.write(`
312
+ `),0}let $=z(d,D);if($.shape==="memory-dir"&&!$.reported)return process.stderr.write(`
270
313
  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
314
 
272
- `),2;let f=_e(b,{budget:a??b.manifest?.budget,profileName:i,episodicJson:h});if(t.plan!==void 0&&f.plan!==t.plan)return process.stderr.write(`
273
- error: the plan on disk no longer matches --plan ${t.plan} (now ${f.plan}); run doctor again
315
+ `),2;let M=oo($,{budget:i??$.manifest?.budget,profileName:c,episodicJson:v,sortAnyway:o.force===!0});if(o.plan!==void 0&&M.plan!==o.plan)return process.stderr.write(`
316
+ error: the plan on disk no longer matches --plan ${o.plan} (now ${M.plan}); run doctor again
274
317
 
275
- `),2;if(f.verdict==="nothing")return process.stdout.write(te(f,{write:!0})),0;if(f.verdict==="leave"&&t.force!==!0)return process.stderr.write(`
276
- error: ${Qe(f)} (${f.before} -> ${f.after} tokens; break-even ${f.bounds.breakEvenCarriedTokens} tokens of OnDemandMemory open all session)
318
+ `),2;if(M.verdict==="nothing")return process.stdout.write(ce(M,{write:!0})),0;if(M.verdict==="leave"&&o.force!==!0)return process.stderr.write(`
319
+ error: ${uo(M)} (${M.before} -> ${M.after} tokens; break-even ${M.bounds.breakEvenCarriedTokens} tokens of OnDemandMemory open all session)
277
320
  Pass --force to write it anyway.
278
321
 
279
- `),2;let z=te(f,{write:!0,target:u});return We(f,{allowSecrets:t["allow-secrets"]===!0}),process.stdout.write(z),0}catch(b){return b instanceof U||b instanceof H?(process.stderr.write(`
280
- error: ${b.message}
322
+ `),2;let rt=ce(M,{write:!0,target:a});return to(M,{allowSecrets:o["allow-secrets"]===!0}),process.stdout.write(rt),0}catch($){return $ instanceof X||$ instanceof W?(process.stderr.write(`
323
+ error: ${$.message}
281
324
 
282
325
  `),2):(process.stderr.write(`
283
- unexpected error: ${b.stack??String(b)}
326
+ unexpected error: ${$.stack??String($)}
284
327
 
285
- `),2)}}if(r==="undo")try{let s;try{s=_(d).folderRoot}catch($){if(!($ instanceof U))throw $}if(!s)return process.stdout.write(`
328
+ `),2)}}if(n==="undo")try{let s;try{s=z(d).folderRoot}catch(m){if(!(m instanceof X))throw m}if(!s)return process.stdout.write(`
286
329
  nothing to undo
287
330
 
288
- `),0;let a=oe(s),p=a?void 0:Ze(s),i=p?Xe(s,p):!a&&re(s)?Ye(s):ze(s,a);if(i.kind==="none")return!a&&re(s)?(process.stderr.write(`
289
- error: ${Je(s)}
331
+ `),0;let i=fe(s),p=i?void 0:mo(s),c=p?co(s,p):!i&&pe(s)?io(s):so(s,i);if(c.kind==="none")return!i&&pe(s)?(process.stderr.write(`
332
+ error: ${eo(s)}
290
333
 
291
334
  `),2):(process.stdout.write(`
292
335
  nothing to undo
293
336
 
294
- `),0);if(i.kind==="kept-only")return process.stderr.write(`
295
- error: undo has nothing left to restore here: ${Ke(i.kept)}
337
+ `),0);if(c.kind==="kept-only")return process.stderr.write(`
338
+ error: undo has nothing left to restore here: ${ao(c.kept)}
296
339
 
297
- `),2;if(i.kind==="missing-original")return process.stderr.write(`
298
- error: no original copy under ${V}/original/ for: ${i.files.join(", ")}.
340
+ `),2;if(c.kind==="missing-original")return process.stderr.write(`
341
+ error: no original copy under ${ne}/original/ for: ${c.files.join(", ")}.
299
342
  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
343
 
301
- `),2;let h=Ge(i.plan);if(h&&t.force!==!0)return process.stderr.write(`
302
- error: ${h}
344
+ `),2;let v=ro(c.plan);if(v&&o.force!==!0)return process.stderr.write(`
345
+ error: ${v}
303
346
 
304
- `),2;let C=h?qe(i.plan):void 0;return Ve(i.plan),process.stdout.write(`
305
- restored ${i.plan.operations.filter($=>$.op==="write"||$.op==="move").length} file(s) in ${s}
306
- deleted: ${i.plan.operations.filter($=>$.op==="delete").length} path(s), ${V}/ ${i.plan.keptBackups?.length?"kept":"included"}
307
- `+(ee(i.plan)?` ${ee(i.plan)}
308
- `:"")+(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(x.sep).join("/")}
347
+ `),2;let x=v?no(c.plan):void 0;return lo(c.plan),process.stdout.write(`
348
+ restored ${c.plan.operations.filter(m=>m.op==="write"||m.op==="move").length} file(s) in ${s}
349
+ deleted: ${c.plan.operations.filter(m=>m.op==="delete").length} path(s), ${ne}/ ${c.plan.keptBackups?.length?"kept":"included"}
350
+ `+(le(c.plan)?` ${le(c.plan)}
351
+ `:"")+(c.plan.left?.length?` left in place: ${c.plan.left.join(", ")} (without manifest.json undo cannot tell which files there it wrote)
352
+ `:"")+(x?` the files as they were before this undo are copied to ${x.split(b.sep).join("/")}
310
353
  `:"")+`
311
- `),0}catch(s){return s instanceof H?(process.stderr.write(`
354
+ `),0}catch(s){return s instanceof W?(process.stderr.write(`
312
355
  error: ${s.message}
313
356
 
314
357
  `),2):(process.stderr.write(`
315
358
  unexpected error: ${s.stack??String(s)}
316
359
 
317
- `),2)}if(r==="mcp")return rn?((async()=>{let[{StdioServerTransport:s},{createDisabledMcpServer:a,DISABLED_MESSAGE:p}]=await Promise.all([import("@modelcontextprotocol/sdk/server/stdio.js"),import("./chunks/mcpServer-2FYD5LS3.js")]);process.stderr.write(`
360
+ `),2)}if(n==="mcp")return Tt?((async()=>{let[{StdioServerTransport:s},{createDisabledMcpServer:i,DISABLED_MESSAGE:p}]=await Promise.all([import("@modelcontextprotocol/sdk/server/stdio.js"),import("./chunks/mcpServer-2JD64MUD.js")]);process.stderr.write(`
318
361
  mcp: ${p}
319
362
 
320
- `),await a().connect(new s)})().catch(s=>{process.stderr.write(`
363
+ `),await i().connect(new s)})().catch(s=>{process.stderr.write(`
321
364
  mcp server failed: ${s.message??String(s)}
322
- `),process.exitCode=1}),0):cn(d,t);if(r==="recall"){let s=o.slice(2).join(" ").trim();if(!s)return process.stderr.write(`
365
+ `),process.exitCode=1}),0):It(d,o);if(n==="recall"){let s=r.slice(2).join(" ").trim();if(!s)return process.stderr.write(`
323
366
  error: recall needs a query: minnimemory recall <path> <query...>
324
367
 
325
- `),2;let a;if(t["max-tokens"]!==void 0){let i=Number(t["max-tokens"]);if(!Number.isFinite(i)||i<=0)return process.stderr.write(`
326
- error: --max-tokens must be a positive number (got "${t["max-tokens"]}")
368
+ `),2;let i;if(o["max-tokens"]!==void 0){let c=Number(o["max-tokens"]);if(!Number.isFinite(c)||c<=0)return process.stderr.write(`
369
+ error: --max-tokens must be a positive number (got "${o["max-tokens"]}")
327
370
 
328
- `),2;a=Math.floor(i)}let p=x.resolve(d);try{let i=ne(p),h;if(i==="compiled")h=Ne(p,X(p),s,{maxTokens:a});else if(i==="memory-dir")h=it(p,s,{maxTokens:a});else return process.stderr.write(`
371
+ `),2;i=Math.floor(c)}let p=b.resolve(d);try{let c=ue(p),v;if(c==="compiled")v=qe(p,ie(p),s,{maxTokens:i});else if(c==="memory-dir")v=bo(p,s,{maxTokens:i});else return process.stderr.write(`
329
372
  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
373
 
331
- `),2;return process.stdout.write(an(h,t.headings===!0)),0}catch(i){return i instanceof E||i instanceof st?(process.stderr.write(`
332
- error: ${i.message}
374
+ `),2;return process.stdout.write(At(v,o.headings===!0)),0}catch(c){return c instanceof L||c instanceof vo?(process.stderr.write(`
375
+ error: ${c.message}
333
376
 
334
377
  `),2):(process.stderr.write(`
335
- unexpected error: ${i.stack??String(i)}
378
+ unexpected error: ${c.stack??String(c)}
336
379
 
337
- `),2)}}if(r==="hook"){let s="";try{s=S.readFileSync(0,"utf8")}catch{s=""}let a;if(t["max-tokens"]!==void 0){let p=Number(t["max-tokens"]);Number.isFinite(p)&&p>0&&(a=Math.floor(p))}try{let p=se(s),i=at(p,{headings:t.headings===!0,maxTokens:a,dir:t.dir});i&&process.stdout.write(`${i}
380
+ `),2)}}if(n==="hook"){let s="";try{s=C.readFileSync(0,"utf8")}catch{s=""}let i;if(o["max-tokens"]!==void 0){let p=Number(o["max-tokens"]);Number.isFinite(p)&&p>0&&(i=Math.floor(p))}try{let p=me(s),c=xo(p,{headings:o.headings===!0,maxTokens:i,dir:o.dir});c&&process.stdout.write(`${c}
338
381
  `)}catch(p){process.stderr.write(`
339
382
  hook: ${p.message??String(p)}
340
- `)}return 0}if(r==="loaded"){let s="";try{s=S.readFileSync(0,"utf8")}catch{s=""}try{ct(JSON.parse(s))}catch{}return 0}if(r==="drift"){let s="";try{s=S.readFileSync(0,"utf8")}catch{s=""}try{let a=se(s),p=dt(a);p&&process.stdout.write(`${p}
341
- `)}catch(a){process.stderr.write(`
342
- drift: ${a.message??String(a)}
343
- `)}return 0}if(r==="bench")try{let s=x.resolve(d),a=X(s),p=t.turns===void 0?50:Number(t.turns);if(!Number.isFinite(p))throw new D(`--turns must be a positive whole number (got "${t.turns}")`);let i=Q(a,p);if(t.workload===void 0)return t.json===!0?(process.stdout.write(`${JSON.stringify({bounds:i,tokenizer:a.tokenizer},null,2)}
344
- `),0):(process.stdout.write(pe(i,a.tokenizer)),process.stdout.write(wt()),0);let h=ht(t.workload),C=gt(a,h,t["whole-files"]===!0?{}:{root:s});return t.json===!0?(process.stdout.write(`${JSON.stringify({bounds:i,model:C,tokenizer:a.tokenizer},null,2)}
345
- `),0):(process.stdout.write(pe(i,a.tokenizer)),process.stdout.write(yt(C,a.tokenizer)),0)}catch(s){return s instanceof D||s instanceof E?(process.stderr.write(`
383
+ `)}return 0}if(n==="loaded"){let s="";try{s=C.readFileSync(0,"utf8")}catch{s=""}try{So(JSON.parse(s))}catch{}return 0}if(n==="drift"){let s="";try{s=C.readFileSync(0,"utf8")}catch{s=""}try{let i=me(s),p=$o(i);p&&process.stdout.write(`${p}
384
+ `)}catch(i){process.stderr.write(`
385
+ drift: ${i.message??String(i)}
386
+ `)}return 0}if(n==="bench")try{let s=b.resolve(d),i=ie(s),p=o.turns===void 0?50:Number(o.turns);if(!Number.isFinite(p))throw new I(`--turns must be a positive whole number (got "${o.turns}")`);let c=ae(i,p);if(o.workload===void 0)return o.json===!0?(process.stdout.write(`${JSON.stringify({bounds:c,tokenizer:i.tokenizer},null,2)}
387
+ `),0):(process.stdout.write(ve(c,i.tokenizer)),process.stdout.write(Ho()),0);let v=Po(o.workload),x=No(i,v,o["whole-files"]===!0?{}:{root:s});return o.json===!0?(process.stdout.write(`${JSON.stringify({bounds:c,model:x,tokenizer:i.tokenizer},null,2)}
388
+ `),0):(process.stdout.write(ve(c,i.tokenizer)),process.stdout.write(Io(x,i.tokenizer)),0)}catch(s){return s instanceof I||s instanceof L?(process.stderr.write(`
346
389
  error: ${s.message}
347
390
 
348
391
  `),2):(process.stderr.write(`
349
392
  unexpected error: ${s.stack??String(s)}
350
393
 
351
- `),2)}if(r!=="doctor")return process.stderr.write(`
352
- error: unknown command "${r}"
353
- ${q}`),2;if(!mn(d))return process.stderr.write(`
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 \`${Ee(d)}\`.
394
+ `),2)}if(n!=="doctor")return process.stderr.write(`
395
+ error: unknown command "${n}"
396
+ ${Z}`),2;if(!Ft(d))return process.stderr.write(`
397
+ 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 \`${We(d)}\`.
355
398
 
356
- `),2;let A;try{let s;if(t.policy!==void 0)try{s=He(t.policy)}catch(a){throw a instanceof Be?new Error(`--policy: ${a.message}`):a}A={discover:R,budget:It(t.budget)??s?.budgets.always_on_tokens,budgetFromPolicy:t.budget===void 0&&s?.budgets.always_on_tokens!==void 0,policy:s,failOn:sn(t["fail-on"],"high"),only:At(t.only),ignore:At(t.ignore),force:t.force===!0}}catch(s){return process.stderr.write(`
399
+ `),2;let A;try{let s;if(o.policy!==void 0)try{s=Qe(o.policy)}catch(i){throw i instanceof Ve?new Error(`--policy: ${i.message}`):i}A={discover:D,budget:tt(o.budget)??s?.budgets.always_on_tokens,budgetFromPolicy:o.budget===void 0&&s?.budgets.always_on_tokens!==void 0,policy:s,failOn:Dt(o["fail-on"],"high"),only:et(o.only),ignore:et(o.ignore),force:o.force===!0}}catch(s){return process.stderr.write(`
357
400
  error: ${s.message}
358
401
 
359
- `),2}try{let s=ie(d,A);if(t.json)process.stdout.write(`${de(s,u)}
360
- `);else{let a=!t.ci&&!process.env.NO_COLOR&&process.stdout.isTTY===!0;process.stdout.write(ae(s,{color:a,ci:t.ci===!0,target:u,diff:l}))}return lt(s.audit.findings,s.config.failOn)}catch(s){return s instanceof U||s instanceof H?(process.stderr.write(`
402
+ `),2}try{let s=he(d,A);if(o.json)process.stdout.write(`${ye(s,a)}
403
+ `);else{let i=!o.ci&&!process.env.NO_COLOR&&process.stdout.isTTY===!0;process.stdout.write(ge(s,{color:i,ci:o.ci===!0,target:a,diff:l}))}return Ro(s.audit.findings,s.config.failOn)}catch(s){return s instanceof X||s instanceof W?(process.stderr.write(`
361
404
  error: ${s.message}
362
405
 
363
406
  `),2):(process.stderr.write(`
364
407
  unexpected error: ${s.stack??String(s)}
365
408
 
366
- `),2)}}function kn(e){try{return S.realpathSync(e)}catch{return x.resolve(e)}}function vn(){let e=process.argv[1];if(!e)return!1;try{return S.realpathSync(tn(import.meta.url))===S.realpathSync(e)}catch{return!1}}vn()&&(process.exitCode=wn(process.argv.slice(2)));export{rn as MCP_STASHED,dn as defaultCommand,wn as main};
409
+ `),2)}}function Gt(e){try{return C.realpathSync(e)}catch{return b.resolve(e)}}function Wt(){let e=process.argv[1];if(!e)return!1;try{return C.realpathSync(jt(import.meta.url))===C.realpathSync(e)}catch{return!1}}Wt()&&(process.exitCode=Jt(process.argv.slice(2)));export{Tt as MCP_STASHED,Rt as defaultCommand,Jt as main};