Back to Claude Mem

Issues Triage Report — 2026-03-29

.maestro/playbooks/2026-03-29-Issues-Triage-3-29-2026/Working/triage-report.md

13.15.314.0 KB
Original Source

Issues Triage Report — 2026-03-29

Repository: thedotmack/claude-mem Triage Date: 2026-03-29 Triaged By: issues-triage-3-29-2026 (Maestro agent)

Summary

MetricCount
Total issues before triage112
Issues closed during triage18
Remaining open issues94

Closed Issues

Duplicate Issues (8 closed)

#TitleDuplicate Of
#1419Worker service fails on non-developer machines due to hardcoded __dirname in CJS bundle#1410
#1428Hardcoded __dirname in worker-service.cjs breaks mode file loading on non-dev machines#1410
#1433Hardcoded __dirname in worker-service.cjs prevents DB initialization#1410
#1434worker-service.cjs: __dirname hardcoded to developer's local path, breaks database initialization#1410
#1437v10.6.1: Worker daemon fails to start - esbuild inlines __dirname with developer's local path#1410
#1438Bundled worker-service.cjs hardcodes developer paths, breaking daemon spawn and mode loading#1410
#1396[10.6.0] Setup hook references setup.sh that doesn't exist in package#1340
#1521Security issue: possible command injection in GitHub Actions workflow#1285

Vague / Non-Actionable Issues (7 closed)

#TitleReason
#1492Bug ReportGeneric title, no repro steps or details
#1436bugNo description, no steps to reproduce
#1362(Chinese, no repro)No reproduction steps or error details
#1385mem still not saveInsufficient details to diagnose
#1488Consumed 25% of my tokensUsage concern, not a bug
#1459Featured in awesome-claude-code-workflowsCommunity celebration, not actionable
#1378Test failure: test run failedNo test output or version info

Stale / Superseded Issues (3 closed)

#TitleReason
#1268(regression)Fixed in 10.6.x+ releases
#1137(plan mode pending messages)Superseded by #1262
#1219version bump to 10.4.1Version long since superseded

Remaining Open Issues by Root Cause

root:worker-lifecycle (23 issues)

#TitlePriority
#1410bug: hardcoded __dirname in worker-service.cjs prevents initialization on end-user machinesP0
#1435Binary embeds stale worker version (10.3.1) mismatching plugin version (10.6.1), causes infinite restart loopP0
#1490Worker daemon repeatedly killed by version mismatch shutdown, startup fratricide, and session SIGTERMP0
#1505SessionStart hooks fail on cold start: worker-start exits 137, context hook races workerP0
#1469Linux/WSL2: UserPromptSubmit fires before worker is ready - all observations silently droppedP0
#1420worker-service.cjs exits immediately on WSL (code 0, no output)P0
#1522/compact command causes worker crash requiring system rebootP1
#1477Hot session monopolizes SDK pool slots via infinite restart loopP1
#1447Worker startup race condition causes 2 SessionStart hook errors on every first sessionP1
#1446Stale worker PIDs in supervisor.json cause SessionStart:resume hook 500 errorsP1
#1430Worker not available {}P1
#1426aggressiveStartupCleanup SIGKILLs hook process on cold startP1
#1423Worker daemon cold start exceeds POST_SPAWN_WAIT timeout (5s) on macOS ARM64P1
#1412Error: Error calling Worker API: fetch failed (Mac Book)P1
#1399Windows worker service hangs with CLOSE_WAIT zombie socketsP1
#1397SessionStart context hook gets empty data on cold start (race condition)P1
#1392Windows: zombie socket holds port 37777 after worker crash, blocking restartP1
#1389SDK agent pool deadlock: idle processes block pool slotsP1
#1323Race condition: Database not initialized error on session-init hookP1
#1289Worker silently fails init when 'node' not in PATHP1
#1266Loss of connection to MCPs even though localhost:37777 was activeP1
#1245worker-service.cjs start subcommand causes SIGKILL under systemdP1
#1509Feature request: Support Node.js runtime via better-sqlite3 to avoid Bun memory leaksP2

root:windows (14 issues)

#TitlePriority
#1420worker-service.cjs exits immediately on WSL (code 0, no output)P0
#1366Windows: claude-mem 10.5.5 causes Claude Code hooks to hang, CLI becomes unresponsiveP0
#1482claude-mem plugin breaks claude --print (pipe mode) on WindowsP1
#1476Windows: aggressiveStartupCleanup WQL filter fails due to single-quote nesting in PowerShellP1
#1452Windows: bun-runner.js spawn ENOENT when bun is installed via npm shimP1
#1489Windows: chroma-mcp spawn fails with EINVAL when using uvx.cmdP1
#1399Windows worker service hangs with CLOSE_WAIT zombie socketsP1
#1395SessionEnd hook 'session-complete' fails with 'Hook cancelled' on WindowsP1
#1392Windows: zombie socket holds port 37777 after worker crashP1
#1342mcp-server.cjs has CRLF line endings - shebang fails on macOS/LinuxP1
#1281Windows: Stop hooks fail with MODULE_NOT_FOUND due to backslash path corruptionP1
#1225Windows: chroma-mcp "Received request before initialization was complete"P1
#1503DEP0190 warning in bun-runner.js on Windows (Node 22+)P2
#1247smart-explore fails silently on Windows - tree-sitter CLI requires C compilerP2

root:chromadb (9 issues)

#TitlePriority
#1248chroma-mcp spins at 250-360% CPU indefinitely on macOS (v10.5.2)P0
#1369chroma-mcp subprocess leak: callTool and onclose null transportP1
#1361chroma-mcp processes leak after session exit, repeatedly downloading ONNX model (~15GB wasted)P1
#1297macOS: chroma-mcp crashes when CWD contains .env.localP1
#1261MCP Search fails with "Collection setup failed" error on cacheDir initializationP1
#1489Windows: chroma-mcp spawn fails with EINVAL when using uvx.cmdP1
#1225Windows: chroma-mcp "Received request before initialization was complete"P1
#1470ChromaDB search fails on WSL/Linux with SOCKS proxy - missing socksioP2
#1424chroma-mcp subprocess fails when ALL_PROXY uses socks:// schemeP2

root:session-integrity (12 issues)

#TitlePriority
#1262pending_messages queue grows unbounded, causes 100%+ CPU on startupP0
#1269CPU 100% caused by saved_hook_context in Claude Code session filesP0
#1519Session completion can finalize too early when summarize is still in flightP1
#1514regenerate-claude-md.ts finds 0 observations despite data existing in databaseP1
#1511Session context not persisting between sessions despite previous workP1
#1360parseSummary creates empty SESSION SUMMARY records from observation responsesP1
#1335Observer sessions trigger ECC's observe.sh hook - double Haiku loopP1
#1274Stop hook crashes with 'Transcript path missing' after context compactionP1
#1260Duplicate observations still occurring - concurrent hooks bypass content-hash dedupP1
#1234Stop hook crashes in git worktrees: transcript path not foundP1
#1218feat: Add runtime self-healing for stuck processing messages and orphaned pending queuesP2
#1359Viewer crashes: files_modified stored as bare path instead of JSON arrayP2

root:security (5 issues)

#TitlePriority
#1204watch.context.path in settings can write AGENTS.md content to arbitrary file pathsP0
#1255Worker port collision causes cross-account data leakage on multi-user macOS systemsP0
#1285[Security Issue] possible command injection in GitHub Actions workflowP0
#1493Sub-agents bypass user permission settings (permissionMode: 'default' hardcoded)P0
#1251Security Audit: Comprehensive Code Review of claude-memP1

root:project-scoping (6 issues)

#TitlePriority
#1256basename(cwd) project detection causes data fragmentation in monoreposP0
#1458Projects with same folder name share memories due to basename-only scopingP0
#1473Codex and Claude sessions can bleed into the same context and viewer dataP1
#1478Project resolver doesn't expand ~ to home directory pathP2
#1318Feature Request: Workspace-Based Memory IsolationP2
#1320feat: per-project disable/exclude functionalityP2

root:installer (8 issues)

#TitlePriority
#1471MCP server not registered - marketplace root .mcp.json is emptyP1
#1497Update now fails: Marketplace directory not foundP1
#1456OpenClaw installer fails when plugins.allow contains claude-memP1
#1371Installer fails in a loop when plugins.allow is validated before plugin is installedP1
#1367OpenClaw plugin returns 401 when calling worker APIP1
#1340Setup hook references missing scripts/setup.sh in v10.5.5P1
#1242PR #1229 fallback path points to marketplace source, not installed cacheP1
#1156np (npm publish tool) should be a devDependency, not a runtime dependencyP2

root:mcp-schema (8 issues)

#TitlePriority
#1413search tool inputSchema missing query parameterP1
#1384MCP search/timeline tools have empty inputSchema properties, 3s API timeoutP1
#1342mcp-server.cjs has CRLF line endings - shebang fails on macOS/LinuxP1
#1331SSE new_prompt broadcast stops after /reload-pluginsP1
#1266Loss of connection to MCPs even though localhost:37777 was activeP1
#1263search (MCP) Worker API error (500)P1
#1471MCP server not registered - .mcp.json is emptyP1
#1339Web UI #ID numbers don't match MCP get_observations IDsP2

root:aws-bedrock (2 issues)

#TitlePriority
#1496AWS Bedrock auth not supported in SDK pipeline (10.6.0+)P1
#1373AWS Bedrock env vars not passed to CLI subprocess - observations fail silentlyP1

Unlabeled / Standalone (15 issues)

#TitlePriority
#1390Default model CLAUDE_MEM_MODEL still set to claude-sonnet-4-5 instead of claude-sonnet-4-6P2
#1484Feature request: CLAUDE_MEM_DISABLED env var for headless/agent sessionsP2
#1464Feature: option to disable claude-mem context injection for spawned subagentsP2
#1462Feature: Promote worktree observations to parent project after PR mergeP2
#1431timeline-report script ignores custom port in settings.jsonP2
#1364Missing mode file for zh-TW (Traditional Chinese)P2
#1322Restore manual save_memory MCP tool for explicit memory creationP2
#1299mock.module() leak in context-reinjection-guard test pollutes parallel workersP2
#1284Integration idea: claude-brain for cross-machine memory sync?P2
#1273Feature Request: UUID observation IDs to enable multi-machine sync/mergeP2
#1272Feature Request: Add option to disable subdirectory CLAUDE.md generationP2
#1265Feature Request: Display model name on observation/summary cards in web UIP2
#1259Gemini Flash Lite produces hallucinated observations; Gemini 2.5 Flash fixes itP2
#1252Feature request: Embedded/in-process mode for OpenClaw pluginP2
#943Feature Request: Support custom API endpoint / LiteLLM proxyP2

Priority Distribution

Priority criteria:

  • P0 = Blocks all users or is a security vulnerability
  • P1 = Affects a large user segment
  • P2 = Nice-to-have or single-user report
PriorityCountDescription
P015Blocks all users or security vulnerability
P154Affects large user segment
P225Nice-to-have or single-user report

Multi-Label Issues

8 issues span multiple root-cause categories:

#Labels
#1420root:worker-lifecycle, root:windows
#1399root:worker-lifecycle, root:windows
#1392root:worker-lifecycle, root:windows
#1489root:windows, root:chromadb
#1225root:windows, root:chromadb
#1342root:windows, root:mcp-schema
#1266root:worker-lifecycle, root:mcp-schema
#1471root:installer, root:mcp-schema
#1269root:worker-lifecycle, root:session-integrity
#1234root:worker-lifecycle, root:session-integrity
#1339root:session-integrity, root:mcp-schema

Next Steps

Six code-fix phases follow this triage:

  1. Phase 02: Fix __dirname and Worker Startup - Replace hardcoded __dirname in esbuild bundle output, add retry loop for cold-start worker initialization, implement atomic restart lockfile to prevent startup stampede, and add structured failure diagnostics.

  2. Phase 03: Windows Platform Hardening - Fix hook timeout/hang issues, zombie port timing, PowerShell escaping utility, CRLF .gitattributes, WQL process enumeration edge cases, and isProcessAlive() utility.

  3. Phase 04: ChromaDB Subprocess Lifecycle - Add 60s health monitoring, CPU spin detection, process-group kill, chromaPid in worker.pid, chromaAvailable flag, and graceful SQLite fallback.

  4. Phase 05: Project Scoping and Session Integrity - Consolidate project identity to parent/basename, implement migrateProjectNames() with legacy/ prefix, add early-finalization guard, session-scoped dedup unique index, and queue size limits.

  5. Phase 06: Security Fixes - Fix GitHub Actions env block injection, add isPathSafe() allowlist utility, port collision project-identity warning, and hook input validation audit.

  6. Phase 07: Installer, MCP, and Remaining Fixes - Reconcile setup.sh/smart-install.js, add MCP tool explicit property schemas, AWS Bedrock env passthrough, installer idempotency, SSE heartbeat/cleanup, and issue comment updates with commit refs.