Files
claude-mem/plugin/scripts/summary-hook.js
T
Alex Newman bb0508d639 Refactor error handling to use platform-specific worker restart instructions
- Updated multiple hooks (context-hook, new-hook, save-hook, summary-hook, user-message-hook) to throw errors using `getWorkerRestartInstructions` for improved user guidance on worker connection issues.
- Enhanced `handleWorkerError` function to utilize the new error message generator for consistent error reporting.
- Modified `ensureWorkerRunning` function to provide detailed instructions based on the worker's state, including port information.
- Introduced `getWorkerRestartInstructions` utility in `error-messages.ts` to generate platform-aware error messages for worker failures.
2025-12-13 17:06:45 -05:00

19 lines
14 KiB
JavaScript
Executable File

#!/usr/bin/env bun
import{stdin as X}from"process";function q(r,t,e){return r==="SessionStart"?t&&e.context?{continue:!0,suppressOutput:!0,hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:e.context}}:{continue:!0,suppressOutput:!0}:r==="UserPromptSubmit"||r==="PostToolUse"?{continue:!0,suppressOutput:!0}:r==="Stop"?{continue:!0,suppressOutput:!0}:{continue:t,suppressOutput:!0,...e.reason&&!t?{stopReason:e.reason}:{}}}function b(r,t,e={}){let n=q(r,t,e);return JSON.stringify(n)}import{readFileSync as Z,writeFileSync as tt,existsSync as et}from"fs";import{join as rt}from"path";import{homedir as nt}from"os";var z=["bugfix","feature","refactor","discovery","decision","change"],Q=["how-it-works","why-it-exists","what-changed","problem-solution","gotcha","pattern","trade-off"];var U=z.join(","),v=Q.join(",");var l=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-haiku-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:rt(nt(),".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:U,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:v,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(!et(t))return this.getAllDefaults();let e=Z(t,"utf-8"),n=JSON.parse(e),o=n;if(n.env&&typeof n.env=="object"){o=n.env;try{tt(t,JSON.stringify(o,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 s={...this.DEFAULTS};for(let i of Object.keys(this.DEFAULTS))o[i]!==void 0&&(s[i]=o[i]);return s}};var C=(s=>(s[s.DEBUG=0]="DEBUG",s[s.INFO=1]="INFO",s[s.WARN=2]="WARN",s[s.ERROR=3]="ERROR",s[s.SILENT=4]="SILENT",s))(C||{}),M=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=C[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 n=typeof e=="string"?JSON.parse(e):e;if(t==="Bash"&&n.command){let o=n.command.length>50?n.command.substring(0,50)+"...":n.command;return`${t}(${o})`}if(t==="Read"&&n.file_path){let o=n.file_path.split("/").pop()||n.file_path;return`${t}(${o})`}if(t==="Edit"&&n.file_path){let o=n.file_path.split("/").pop()||n.file_path;return`${t}(${o})`}if(t==="Write"&&n.file_path){let o=n.file_path.split("/").pop()||n.file_path;return`${t}(${o})`}return t}catch{return t}}log(t,e,n,o,s){if(t<this.getLevel())return;let i=new Date().toISOString().replace("T"," ").substring(0,23),a=C[t].padEnd(5),p=e.padEnd(6),u="";o?.correlationId?u=`[${o.correlationId}] `:o?.sessionId&&(u=`[session-${o.sessionId}] `);let E="";s!=null&&(this.getLevel()===0&&typeof s=="object"?E=`
`+JSON.stringify(s,null,2):E=" "+this.formatData(s));let k="";if(o){let{sessionId:Ut,sdkSessionId:vt,correlationId:Nt,...P}=o;Object.keys(P).length>0&&(k=` {${Object.entries(P).map(([Y,J])=>`${Y}=${J}`).join(", ")}}`)}let w=`[${i}] [${a}] [${p}] ${u}${n}${k}${E}`;t===3?console.error(w):console.log(w)}debug(t,e,n,o){this.log(0,t,e,n,o)}info(t,e,n,o){this.log(1,t,e,n,o)}warn(t,e,n,o){this.log(2,t,e,n,o)}error(t,e,n,o){this.log(3,t,e,n,o)}dataIn(t,e,n,o){this.info(t,`\u2192 ${e}`,n,o)}dataOut(t,e,n,o){this.info(t,`\u2190 ${e}`,n,o)}success(t,e,n,o){this.info(t,`\u2713 ${e}`,n,o)}failure(t,e,n,o){this.error(t,`\u2717 ${e}`,n,o)}timing(t,e,n,o){this.info(t,`\u23F1 ${e}`,o,{duration:`${n}ms`})}},c=new M;import A from"path";import{homedir as Tt}from"os";import{spawnSync as ht}from"child_process";import{existsSync as At,writeFileSync as $,readFileSync as Ct}from"fs";var d={DEFAULT:5e3,HEALTH_CHECK:1e3,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:15,WINDOWS_MULTIPLIER:1.5};function N(r){return process.platform==="win32"?Math.round(r*d.WINDOWS_MULTIPLIER):r}import{existsSync as D,readFileSync as ct,writeFileSync as ut,unlinkSync as pt,mkdirSync as x}from"fs";import{createWriteStream as lt}from"fs";import{join as T}from"path";import{spawn as ft,spawnSync as gt}from"child_process";import{homedir as mt}from"os";import{join as f,dirname as ot,basename as qt}from"path";import{homedir as st}from"os";import{fileURLToPath as it}from"url";function at(){return typeof __dirname<"u"?__dirname:ot(it(import.meta.url))}var ee=at(),g=l.get("CLAUDE_MEM_DATA_DIR"),L=process.env.CLAUDE_CONFIG_DIR||f(st(),".claude"),re=f(g,"archives"),ne=f(g,"logs"),oe=f(g,"trash"),se=f(g,"backups"),ie=f(g,"settings.json"),ae=f(g,"claude-mem.db"),ce=f(g,"vector-db"),ue=f(L,"settings.json"),pe=f(L,"commands"),le=f(L,"CLAUDE.md");var O=T(g,"worker.pid"),H=T(g,"logs"),F=T(mt(),".claude","plugins","marketplaces","thedotmack"),Et=5e3,_t=1e4,St=200,dt=1e3,Ot=100,h=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};x(H,{recursive:!0});let e=T(F,"plugin","scripts","worker-service.cjs");if(!D(e))return{success:!1,error:`Worker script not found at ${e}`};let n=this.getLogFilePath();return this.startWithBun(e,n,t)}static isBunAvailable(){try{return gt("bun",["--version"],{stdio:"pipe",timeout:5e3}).status===0}catch{return!1}}static async startWithBun(t,e,n){if(!this.isBunAvailable())return{success:!1,error:"Bun is required but not found in PATH. Install from https://bun.sh"};try{let o=process.platform==="win32",s=ft("bun",[t],{detached:!0,stdio:["ignore","pipe","pipe"],env:{...process.env,CLAUDE_MEM_WORKER_PORT:String(n)},cwd:F,...o&&{windowsHide:!0}}),i=lt(e,{flags:"a"});return s.stdout?.pipe(i),s.stderr?.pipe(i),s.unref(),s.pid?(this.writePidFile({pid:s.pid,port:n,startedAt:new Date().toISOString(),version:process.env.npm_package_version||"unknown"}),this.waitForHealth(s.pid,n)):{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=Et){let e=this.getPidInfo();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 getPidInfo(){try{if(!D(O))return null;let t=ct(O,"utf-8"),e=JSON.parse(t);return typeof e.pid!="number"||typeof e.port!="number"?null:e}catch{return null}}static writePidFile(t){x(g,{recursive:!0}),ut(O,JSON.stringify(t,null,2))}static removePidFile(){try{D(O)&&pt(O)}catch{}}static isProcessAlive(t){try{return process.kill(t,0),!0}catch{return!1}}static async waitForHealth(t,e,n=_t){let o=Date.now();for(;Date.now()-o<n;){if(!this.isProcessAlive(t))return{success:!1,error:"Process died during startup"};try{if((await fetch(`http://127.0.0.1:${e}/health`,{signal:AbortSignal.timeout(dt)})).ok)return{success:!0,pid:t}}catch{}await new Promise(s=>setTimeout(s,St))}return{success:!1,error:"Health check timed out"}}static async waitForExit(t,e){let n=Date.now();for(;Date.now()-n<e;){if(!this.isProcessAlive(t))return;await new Promise(o=>setTimeout(o,Ot))}throw new Error("Process did not exit within timeout")}static getLogFilePath(){let t=new Date().toISOString().slice(0,10);return T(H,`worker-${t}.log`)}static formatUptime(t){let e=new Date(t).getTime(),o=Date.now()-e,s=Math.floor(o/1e3),i=Math.floor(s/60),a=Math.floor(i/60),p=Math.floor(a/24);return p>0?`${p}d ${a%24}h`:a>0?`${a}h ${i%60}m`:i>0?`${i}m ${s%60}s`:`${s}s`}};function _(r={}){let{port:t,includeSkillFallback:e=!1,customPrefix:n}=r,o=process.platform==="win32",s=o?"%USERPROFILE%\\.claude\\plugins\\marketplaces\\thedotmack":"~/.claude/plugins/marketplaces/thedotmack",i=o?"Command Prompt or PowerShell":"Terminal",a=n||"Worker service connection failed.",p=t?` (port ${t})`:"",u=`${a}${p}
`;return u+=`To restart the worker:
`,u+=`1. Exit Claude Code completely
`,u+=`2. Open ${i}
`,u+=`3. Navigate to: ${s}
`,u+="4. Run: npm run worker:restart",e&&(u+=`
If that doesn't work, try: /troubleshoot`),u}var K=A.join(Tt(),".claude","plugins","marketplaces","thedotmack"),j=N(d.HEALTH_CHECK),S=null;function m(){if(S!==null)return S;try{let r=A.join(l.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=l.loadFromFile(r);return S=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),S}catch(r){return c.debug("SYSTEM","Failed to load port from settings, using default",{error:r}),S=parseInt(l.get("CLAUDE_MEM_WORKER_PORT"),10),S}}async function y(){try{let r=m();return(await fetch(`http://127.0.0.1:${r}/health`,{signal:AbortSignal.timeout(j)})).ok}catch(r){return c.debug("SYSTEM","Worker health check failed",{error:r instanceof Error?r.message:String(r),errorType:r?.constructor?.name}),!1}}function Mt(){try{let r=A.join(K,"package.json");return JSON.parse(Ct(r,"utf-8")).version}catch(r){return c.debug("SYSTEM","Failed to read plugin version",{error:r instanceof Error?r.message:String(r)}),null}}async function Lt(){try{let r=m(),t=await fetch(`http://127.0.0.1:${r}/api/version`,{signal:AbortSignal.timeout(j)});return t.ok?(await t.json()).version:null}catch(r){return c.debug("SYSTEM","Failed to get worker version",{error:r instanceof Error?r.message:String(r)}),null}}async function W(){let r=Mt(),t=await Lt();!r||!t||r!==t&&(c.info("SYSTEM","Worker version mismatch detected - restarting worker",{pluginVersion:r,workerVersion:t}),await h.restart(m()),await new Promise(e=>setTimeout(e,1e3)),await y()||c.error("SYSTEM","Worker failed to restart after version mismatch"))}async function Dt(){let r=A.join(l.get("CLAUDE_MEM_DATA_DIR"),".pm2-migrated");if(!At(r))try{ht("pm2",["delete","claude-mem-worker"],{stdio:"ignore"}),$(r,new Date().toISOString(),"utf-8"),c.debug("SYSTEM","PM2 cleanup completed and marked")}catch{$(r,new Date().toISOString(),"utf-8")}let t=m(),e=await h.start(t);return e.success||c.error("SYSTEM","Failed to start worker",{platform:process.platform,port:t,error:e.error,marketplaceRoot:K}),e.success}async function V(){if(await y()){await W();return}if(!await Dt()){let e=m();throw new Error(_({port:e,customPrefix:`Worker service failed to start on port ${e}.`}))}for(let e=0;e<5;e++)if(await new Promise(n=>setTimeout(n,500)),await y()){await W();return}let t=m();throw c.error("SYSTEM","Worker started but not responding to health checks"),new Error(_({port:t,customPrefix:`Worker service started but is not responding on port ${t}.`}))}import{appendFileSync as yt}from"fs";import{homedir as Rt}from"os";import{join as It}from"path";var kt=It(Rt(),".claude-mem","silent.log");function B(r,t,e=""){let n=new Date().toISOString(),a=((new Error().stack||"").split(`
`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),p=a?`${a[1].split("/").pop()}:${a[2]}`:"unknown",u=`[${n}] [HAPPY-PATH-ERROR] [${p}] ${r}`;if(t!==void 0)try{u+=` ${JSON.stringify(t)}`}catch(E){u+=` [stringify error: ${E}]`}u+=`
`;try{yt(kt,u)}catch(E){console.error("[silent-debug] Failed to write to log:",E)}return e}function G(r){throw r.cause?.code==="ECONNREFUSED"||r.code==="ConnectionRefused"||r.name==="TimeoutError"||r.message?.includes("fetch failed")||r.message?.includes("Unable to connect")?new Error(_()):r}import{readFileSync as wt,existsSync as Pt}from"fs";function R(r,t,e=!1){if(!r||!Pt(r))return"";try{let n=wt(r,"utf-8").trim();if(!n)return"";let o=n.split(`
`);for(let s=o.length-1;s>=0;s--)try{let i=JSON.parse(o[s]);if(i.type===t&&i.message?.content){let a="",p=i.message.content;return typeof p=="string"?a=p:Array.isArray(p)&&(a=p.filter(u=>u.type==="text").map(u=>u.text).join(`
`)),e&&(a=a.replace(/<system-reminder>[\s\S]*?<\/system-reminder>/g,""),a=a.replace(/\n{3,}/g,`
`).trim()),a}}catch{continue}}catch(n){c.error("HOOK","Failed to read transcript",{transcriptPath:r},n)}return""}async function bt(r){if(await V(),!r)throw new Error("summaryHook requires input");let{session_id:t}=r,e=m(),n=B("Missing transcript_path in Stop hook input",{session_id:t},r.transcript_path||""),o=R(n,"user"),s=R(n,"assistant",!0);c.dataIn("HOOK","Stop: Requesting summary",{workerPort:e,hasLastUserMessage:!!o,hasLastAssistantMessage:!!s});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:o,last_assistant_message:s}),signal:AbortSignal.timeout(d.DEFAULT)});if(!i.ok){let a=await i.text();throw c.failure("HOOK","Failed to generate summary",{status:i.status},a),new Error(_({includeSkillFallback:!0}))}c.debug("HOOK","Summary request sent successfully")}catch(i){G(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(b("Stop",!0))}var I="";X.on("data",r=>I+=r);X.on("end",async()=>{let r=I?JSON.parse(I):void 0;await bt(r)});