Files
claude-mem/plugin/scripts/summary-hook.js
Alex Newman 5ce656037e Refactor worker commands from npm scripts to claude-mem CLI
- Updated all instances of `npm run worker:restart` to `claude-mem restart` in documentation and code comments for consistency.
- Modified error messages and logging to reflect the new command structure.
- Adjusted worker management commands in various troubleshooting documents.
- Changed the worker status check message to guide users towards the new command.
2025-12-20 17:16:20 -05:00

33 lines
18 KiB
JavaScript
Executable File

#!/usr/bin/env bun
import{stdin as tt}from"process";function nt(n,t,e){return n==="SessionStart"?t&&e.context?{continue:!0,suppressOutput:!0,hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:e.context}}:{continue:!0,suppressOutput:!0}:n==="UserPromptSubmit"||n==="PostToolUse"?{continue:!0,suppressOutput:!0}:n==="Stop"?{continue:!0,suppressOutput:!0}:{continue:t,suppressOutput:!0,...e.reason&&!t?{stopReason:e.reason}:{}}}function x(n,t,e={}){let r=nt(n,t,e);return JSON.stringify(r)}import{readFileSync as it,writeFileSync as at,existsSync as ct}from"fs";import{join as ut}from"path";import{homedir as pt}from"os";var st=["bugfix","feature","refactor","discovery","decision","change"],ot=["how-it-works","why-it-exists","what-changed","problem-solution","gotcha","pattern","trade-off"];var $=st.join(","),H=ot.join(",");var l=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_DATA_DIR:ut(pt(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:$,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:H,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let e=this.get(t);return parseInt(e,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){if(!ct(t))return this.getAllDefaults();let e=it(t,"utf-8"),r=JSON.parse(e),s=r;if(r.env&&typeof r.env=="object"){s=r.env;try{at(t,JSON.stringify(s,null,2),"utf-8"),c.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(i){c.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},i)}}let o={...this.DEFAULTS};for(let i of Object.keys(this.DEFAULTS))s[i]!==void 0&&(o[i]=s[i]);return o}};var y=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(y||{}),D=class{level=null;useColor;constructor(){this.useColor=process.stdout.isTTY??!1}getLevel(){if(this.level===null){let t=l.get("CLAUDE_MEM_LOG_LEVEL").toUpperCase();this.level=y[t]??1}return this.level}correlationId(t,e){return`obs-${t}-${e}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let e=Object.keys(t);return e.length===0?"{}":e.length<=3?JSON.stringify(t):`{${e.length} keys: ${e.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,e){if(!e)return t;try{let r=typeof e=="string"?JSON.parse(e):e;if(t==="Bash"&&r.command){let s=r.command.length>50?r.command.substring(0,50)+"...":r.command;return`${t}(${s})`}if(t==="Read"&&r.file_path){let s=r.file_path.split("/").pop()||r.file_path;return`${t}(${s})`}if(t==="Edit"&&r.file_path){let s=r.file_path.split("/").pop()||r.file_path;return`${t}(${s})`}if(t==="Write"&&r.file_path){let s=r.file_path.split("/").pop()||r.file_path;return`${t}(${s})`}return t}catch{return t}}formatTimestamp(t){let e=t.getFullYear(),r=String(t.getMonth()+1).padStart(2,"0"),s=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),i=String(t.getMinutes()).padStart(2,"0"),a=String(t.getSeconds()).padStart(2,"0"),u=String(t.getMilliseconds()).padStart(3,"0");return`${e}-${r}-${s} ${o}:${i}:${a}.${u}`}log(t,e,r,s,o){if(t<this.getLevel())return;let i=this.formatTimestamp(new Date),a=y[t].padEnd(5),u=e.padEnd(6),p="";s?.correlationId?p=`[${s.correlationId}] `:s?.sessionId&&(p=`[session-${s.sessionId}] `);let f="";o!=null&&(this.getLevel()===0&&typeof o=="object"?f=`
`+JSON.stringify(o,null,2):f=" "+this.formatData(o));let S="";if(s){let{sessionId:M,sdkSessionId:Ht,correlationId:Ft,...N}=s;Object.keys(N).length>0&&(S=` {${Object.entries(N).map(([et,rt])=>`${et}=${rt}`).join(", ")}}`)}let _=`[${i}] [${a}] [${u}] ${p}${r}${S}${f}`;t===3?console.error(_):console.log(_)}debug(t,e,r,s){this.log(0,t,e,r,s)}info(t,e,r,s){this.log(1,t,e,r,s)}warn(t,e,r,s){this.log(2,t,e,r,s)}error(t,e,r,s){this.log(3,t,e,r,s)}dataIn(t,e,r,s){this.info(t,`\u2192 ${e}`,r,s)}dataOut(t,e,r,s){this.info(t,`\u2190 ${e}`,r,s)}success(t,e,r,s){this.info(t,`\u2713 ${e}`,r,s)}failure(t,e,r,s){this.error(t,`\u2717 ${e}`,r,s)}timing(t,e,r,s){this.info(t,`\u23F1 ${e}`,s,{duration:`${r}ms`})}happyPathError(t,e,r,s,o=""){let p=((new Error().stack||"").split(`
`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),f=p?`${p[1].split("/").pop()}:${p[2]}`:"unknown",S={...r,location:f};return this.warn(t,`[HAPPY-PATH] ${e}`,S,s),o}},c=new D;import w from"path";import{homedir as Rt}from"os";import{spawnSync as Pt}from"child_process";import{existsSync as Lt,writeFileSync as Y,readFileSync as bt,mkdirSync as kt}from"fs";var h={DEFAULT:5e3,HEALTH_CHECK:1e3,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:15,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5};function R(n){return process.platform==="win32"?Math.round(n*h.WINDOWS_MULTIPLIER):n}import{existsSync as b,readFileSync as St,writeFileSync as _t,unlinkSync as ht,mkdirSync as V}from"fs";import{createWriteStream as Tt}from"fs";import{join as T}from"path";import{spawn as Ot,spawnSync as At}from"child_process";import{homedir as Ct}from"os";import{join as g,dirname as lt,basename as te}from"path";import{homedir as mt}from"os";import{fileURLToPath as gt}from"url";function ft(){return typeof __dirname<"u"?__dirname:lt(gt(import.meta.url))}var oe=ft(),m=l.get("CLAUDE_MEM_DATA_DIR"),P=process.env.CLAUDE_CONFIG_DIR||g(mt(),".claude"),ie=g(m,"archives"),ae=g(m,"logs"),ce=g(m,"trash"),ue=g(m,"backups"),pe=g(m,"settings.json"),le=g(m,"claude-mem.db"),me=g(m,"vector-db"),ge=g(P,"settings.json"),fe=g(P,"commands"),de=g(P,"CLAUDE.md");import{spawnSync as dt}from"child_process";import{existsSync as Et}from"fs";import{join as F}from"path";import{homedir as W}from"os";function L(){let n=process.platform==="win32";try{if(dt("bun",["--version"],{encoding:"utf-8",stdio:["pipe","pipe","pipe"],shell:!1}).status===0)return"bun"}catch{}let t=n?[F(W(),".bun","bin","bun.exe")]:[F(W(),".bun","bin","bun"),"/usr/local/bin/bun","/opt/homebrew/bin/bun","/home/linuxbrew/.linuxbrew/bin/bun"];for(let e of t)if(Et(e))return e;return null}function K(){return L()!==null}var A=T(m,"worker.pid"),j=T(m,"logs"),k=T(Ct(),".claude","plugins","marketplaces","thedotmack"),B=5e3,Mt=1e4,wt=200,yt=1e3,G=100,Dt=2e3,C=class{static async start(t){if(isNaN(t)||t<1024||t>65535)return{success:!1,error:`Invalid port ${t}. Must be between 1024 and 65535`};if(await this.isRunning())return{success:!0,pid:this.getPidInfo()?.pid};V(j,{recursive:!0});let e=process.platform==="win32"?"worker-wrapper.cjs":"worker-service.cjs",r=T(k,"plugin","scripts",e);if(!b(r))return{success:!1,error:`Worker script not found at ${r}`};let s=this.getLogFilePath();return this.startWithBun(r,s,t)}static isBunAvailable(){return K()}static escapePowerShellString(t){return t.replace(/'/g,"''")}static async startWithBun(t,e,r){let s=L();if(!s)return{success:!1,error:"Bun is required but not found in PATH or common installation paths. Install from https://bun.sh"};try{if(process.platform==="win32"){let i=this.escapePowerShellString(s),a=this.escapePowerShellString(t),u=this.escapePowerShellString(k),p=this.escapePowerShellString(e),S=`${`$env:CLAUDE_MEM_WORKER_PORT='${r}'`}; Start-Process -FilePath '${i}' -ArgumentList '${a}' -WorkingDirectory '${u}' -WindowStyle Hidden -RedirectStandardOutput '${p}' -RedirectStandardError '${p}.err' -PassThru | Select-Object -ExpandProperty Id`,_=At("powershell",["-Command",S],{stdio:"pipe",timeout:1e4,windowsHide:!0});if(_.status!==0)return{success:!1,error:`PowerShell spawn failed: ${_.stderr?.toString()||"unknown error"}`};let M=parseInt(_.stdout.toString().trim(),10);return isNaN(M)?{success:!1,error:"Failed to get PID from PowerShell"}:(this.writePidFile({pid:M,port:r,startedAt:new Date().toISOString(),version:process.env.npm_package_version||"unknown"}),this.waitForHealth(M,r))}else{let i=Ot(s,[t],{detached:!0,stdio:["ignore","pipe","pipe"],env:{...process.env,CLAUDE_MEM_WORKER_PORT:String(r)},cwd:k}),a=Tt(e,{flags:"a"});return i.stdout?.pipe(a),i.stderr?.pipe(a),i.unref(),i.pid?(this.writePidFile({pid:i.pid,port:r,startedAt:new Date().toISOString(),version:process.env.npm_package_version||"unknown"}),this.waitForHealth(i.pid,r)):{success:!1,error:"Failed to get PID from spawned process"}}}catch(o){return{success:!1,error:o instanceof Error?o.message:String(o)}}}static async stop(t=B){let e=this.getPidInfo();if(process.platform==="win32"){let r=e?.port??this.getPortFromSettings();if(await this.tryHttpShutdown(r))return this.removePidFile(),!0;if(!e)return!0;let{execSync:o}=await import("child_process");try{o(`taskkill /PID ${e.pid} /T /F`,{timeout:1e4,stdio:"ignore"})}catch{}try{await this.waitForExit(e.pid,t)}catch{}return this.isProcessAlive(e.pid)||this.removePidFile(),!0}else{if(!e)return!0;try{process.kill(e.pid,"SIGTERM"),await this.waitForExit(e.pid,t)}catch{try{process.kill(e.pid,"SIGKILL")}catch{}}return this.removePidFile(),!0}}static async restart(t){return await this.stop(),this.start(t)}static async status(){let t=this.getPidInfo();if(!t)return{running:!1};let e=this.isProcessAlive(t.pid);return{running:e,pid:e?t.pid:void 0,port:e?t.port:void 0,uptime:e?this.formatUptime(t.startedAt):void 0}}static async isRunning(){let t=this.getPidInfo();if(!t)return!1;let e=this.isProcessAlive(t.pid);return e||this.removePidFile(),e}static getPortFromSettings(){try{let t=T(m,"settings.json"),e=l.loadFromFile(t);return parseInt(e.CLAUDE_MEM_WORKER_PORT,10)}catch{return parseInt(l.get("CLAUDE_MEM_WORKER_PORT"),10)}}static async tryHttpShutdown(t){try{return(await fetch(`http://127.0.0.1:${t}/api/admin/shutdown`,{method:"POST",signal:AbortSignal.timeout(Dt)})).ok?await this.waitForWorkerDown(t,B):!1}catch{return!1}}static async waitForWorkerDown(t,e){let r=Date.now();for(;Date.now()-r<e;)try{await fetch(`http://127.0.0.1:${t}/api/health`,{signal:AbortSignal.timeout(500)}),await new Promise(s=>setTimeout(s,G))}catch{return!0}return!1}static getPidInfo(){try{if(!b(A))return null;let t=St(A,"utf-8"),e=JSON.parse(t);return typeof e.pid!="number"||typeof e.port!="number"?null:e}catch{return null}}static writePidFile(t){V(m,{recursive:!0}),_t(A,JSON.stringify(t,null,2))}static removePidFile(){try{b(A)&&ht(A)}catch{}}static isProcessAlive(t){try{return process.kill(t,0),!0}catch{return!1}}static async waitForHealth(t,e,r=Mt){let s=Date.now(),o=process.platform==="win32",i=o?r*2:r;for(;Date.now()-s<i;){if(!this.isProcessAlive(t))return{success:!1,error:o?`Process died during startup
Troubleshooting:
1. Check Task Manager for zombie 'bun.exe' or 'node.exe' processes
2. Verify port ${e} is not in use: netstat -ano | findstr ${e}
3. Check worker logs in ~/.claude-mem/logs/
4. See GitHub issues: #363, #367, #371, #373
5. Docs: https://docs.claude-mem.ai/troubleshooting/windows-issues`:"Process died during startup"};try{if((await fetch(`http://127.0.0.1:${e}/api/readiness`,{signal:AbortSignal.timeout(yt)})).ok)return{success:!0,pid:t}}catch{}await new Promise(u=>setTimeout(u,wt))}return{success:!1,error:o?`Worker failed to start on Windows (readiness check timed out after ${i}ms)
Troubleshooting:
1. Check Task Manager for zombie 'bun.exe' or 'node.exe' processes
2. Verify port ${e} is not in use: netstat -ano | findstr ${e}
3. Check worker logs in ~/.claude-mem/logs/
4. See GitHub issues: #363, #367, #371, #373
5. Docs: https://docs.claude-mem.ai/troubleshooting/windows-issues`:`Readiness check timed out after ${i}ms`}}static async waitForExit(t,e){let r=Date.now();for(;Date.now()-r<e;){if(!this.isProcessAlive(t))return;await new Promise(s=>setTimeout(s,G))}throw new Error("Process did not exit within timeout")}static getLogFilePath(){let t=new Date().toISOString().slice(0,10);return T(j,`worker-${t}.log`)}static formatUptime(t){let e=new Date(t).getTime(),s=Date.now()-e,o=Math.floor(s/1e3),i=Math.floor(o/60),a=Math.floor(i/60),u=Math.floor(a/24);return u>0?`${u}d ${a%24}h`:a>0?`${a}h ${i%60}m`:i>0?`${i}m ${o%60}s`:`${o}s`}};function E(n={}){let{port:t,includeSkillFallback:e=!1,customPrefix:r,actualError:s}=n,o=r||"Worker service connection failed.",i=t?` (port ${t})`:"",a=`${o}${i}
`;return a+=`To restart the worker:
`,a+=`1. Exit Claude Code completely
`,a+=`2. Run: claude-mem restart
`,a+="3. Restart Claude Code",e&&(a+=`
If that doesn't work, try: /troubleshoot`),s&&(a=`Worker Error: ${s}
${a}`),a}var J=w.join(Rt(),".claude","plugins","marketplaces","thedotmack"),q=R(h.HEALTH_CHECK),O=null;function d(){if(O!==null)return O;try{let n=w.join(l.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=l.loadFromFile(n);return O=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),O}catch(n){return c.debug("SYSTEM","Failed to load port from settings, using default",{error:n}),O=parseInt(l.get("CLAUDE_MEM_WORKER_PORT"),10),O}}async function I(){try{let n=d();return(await fetch(`http://127.0.0.1:${n}/api/readiness`,{signal:AbortSignal.timeout(q)})).ok}catch(n){return c.debug("SYSTEM","Worker readiness check failed",{error:n instanceof Error?n.message:String(n),errorType:n?.constructor?.name}),!1}}function It(){try{let n=w.join(J,"package.json");return JSON.parse(bt(n,"utf-8")).version}catch(n){return c.debug("SYSTEM","Failed to read plugin version",{error:n instanceof Error?n.message:String(n)}),null}}async function vt(){try{let n=d(),t=await fetch(`http://127.0.0.1:${n}/api/version`,{signal:AbortSignal.timeout(q)});return t.ok?(await t.json()).version:null}catch(n){return c.debug("SYSTEM","Failed to get worker version",{error:n instanceof Error?n.message:String(n)}),null}}async function X(){let n=It(),t=await vt();!n||!t||n!==t&&(c.info("SYSTEM","Worker version mismatch detected - restarting worker",{pluginVersion:n,workerVersion:t}),await new Promise(e=>setTimeout(e,R(h.PRE_RESTART_SETTLE_DELAY))),await C.restart(d()),await new Promise(e=>setTimeout(e,1e3)),await I()||c.error("SYSTEM","Worker failed to restart after version mismatch",{expectedVersion:n,runningVersion:t,port:d()}))}async function Ut(){let n=l.get("CLAUDE_MEM_DATA_DIR"),t=w.join(n,".pm2-migrated");if(kt(n,{recursive:!0}),!Lt(t))try{Pt("pm2",["delete","claude-mem-worker"],{stdio:"ignore"}),Y(t,new Date().toISOString(),"utf-8"),c.debug("SYSTEM","PM2 cleanup completed and marked")}catch{Y(t,new Date().toISOString(),"utf-8")}let e=d(),r=await C.start(e);return r.success||c.error("SYSTEM","Failed to start worker",{platform:process.platform,port:e,error:r.error,marketplaceRoot:J}),r.success}async function z(){if(await I()){await X();return}if(!await Ut()){let e=d();throw new Error(E({port:e,customPrefix:`Worker service failed to start on port ${e}.`}))}for(let e=0;e<5;e++)if(await new Promise(r=>setTimeout(r,500)),await I()){await X();return}let t=d();throw c.error("SYSTEM","Worker started but not responding to health checks"),new Error(E({port:t,customPrefix:`Worker service started but is not responding on port ${t}.`}))}function Q(n){throw n.cause?.code==="ECONNREFUSED"||n.code==="ConnectionRefused"||n.name==="TimeoutError"||n.message?.includes("fetch failed")||n.message?.includes("Unable to connect")?new Error(E()):n}function Z(n,t,e){c.error("HOOK",`${e.operation} failed`,{status:n.status,...e},t);let r=e.toolName?`Failed ${e.operation} for ${e.toolName}: ${E()}`:`${e.operation} failed: ${E()}`;throw new Error(r)}import{readFileSync as Nt,existsSync as xt}from"fs";function v(n,t,e=!1){if(!n||!xt(n))return c.happyPathError("PARSER","Transcript path missing or file does not exist",void 0,{transcriptPath:n,role:t},""),"";try{let r=Nt(n,"utf-8").trim();if(!r)return c.happyPathError("PARSER","Transcript file exists but is empty",void 0,{transcriptPath:n,role:t},""),"";let s=r.split(`
`),o=!1;for(let i=s.length-1;i>=0;i--)try{let a=JSON.parse(s[i]);if(a.type===t&&(o=!0,a.message?.content)){let u="",p=a.message.content;return typeof p=="string"?u=p:Array.isArray(p)&&(u=p.filter(f=>f.type==="text").map(f=>f.text).join(`
`)),e&&(u=u.replace(/<system-reminder>[\s\S]*?<\/system-reminder>/g,""),u=u.replace(/\n{3,}/g,`
`).trim()),(!u||u.trim()==="")&&c.happyPathError("PARSER","Found message but content is empty after processing",void 0,{role:t,transcriptPath:n,msgContentType:typeof p,stripSystemReminders:e},""),u}}catch{continue}o||c.happyPathError("PARSER","No message found for role in transcript",void 0,{role:t,transcriptPath:n,totalLines:s.length},"")}catch(r){c.error("HOOK","Failed to read transcript",{transcriptPath:n},r)}return""}async function $t(n){if(await z(),!n)throw new Error("summaryHook requires input");let{session_id:t}=n,e=d(),r=n.transcript_path||c.happyPathError("HOOK","Missing transcript_path in Stop hook input",void 0,{session_id:t},""),s=v(r,"user"),o=v(r,"assistant",!0);c.dataIn("HOOK","Stop: Requesting summary",{workerPort:e,hasLastUserMessage:!!s,hasLastAssistantMessage:!!o});try{let i=await fetch(`http://127.0.0.1:${e}/api/sessions/summarize`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({claudeSessionId:t,last_user_message:s,last_assistant_message:o}),signal:AbortSignal.timeout(h.DEFAULT)});if(!i.ok){let a=await i.text();Z(i,a,{hookName:"summary",operation:"Summary generation",sessionId:t,port:e})}c.debug("HOOK","Summary request sent successfully")}catch(i){Q(i)}finally{try{let i=await fetch(`http://127.0.0.1:${e}/api/processing`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({isProcessing:!1}),signal:AbortSignal.timeout(2e3)});i.ok||c.warn("HOOK","Failed to stop spinner",{status:i.status})}catch(i){c.warn("HOOK","Could not stop spinner",{error:i.message})}}console.log(x("Stop",!0))}var U="";tt.on("data",n=>U+=n);tt.on("end",async()=>{let n=U?JSON.parse(U):void 0;await $t(n)});