claude-mem/Auto Run Docs/Wizard-2026-02-07-4/2026-02-07-Tissues-For-Issues/TISSUES-FOR-ISSUES-01.md

Phase 01: Comprehensive Issue & PR Categorization Report

This phase produces the complete categorized report of all open issues and PRs in the claude-mem repository. It fetches live data from GitHub, categorizes every item into priority tiers, maps PRs to the issues they address, and generates a single structured report with keep/discard/defer recommendations. This report is the primary deliverable that enables the project owner to make informed decisions about what to act on, what to close, and what to defer.

Tasks

• Fetch all open issues and PRs from GitHub and save raw data to the Working folder for subsequent tasks to consume:

  • Completed: 67 issues and 30 PRs fetched, valid JSON verified, saved to Working/
  • Run gh issue list --repo thedotmack/claude-mem --state open --limit 200 --json number,title,labels,createdAt,author,body,comments and save to Working/raw-issues.json
  • Run gh pr list --repo thedotmack/claude-mem --state open --limit 100 --json number,title,labels,createdAt,author,headRefName,isDraft,reviews,body and save to Working/raw-prs.json
  • Verify both files are valid JSON and contain expected record counts (~65-70 issues, ~29 PRs)
  • Note: "Working" folder is at /Users/alexnewman/Scripts/claude-mem//Auto Run Docs/Wizard-2026-02-07-4/Working/

• Read Working/raw-issues.json and categorize ALL open issues into a structured report covering Critical, High-Priority, and Security tiers. Write the output to Working/issues-critical-high.md:

  • Completed: 17 issues categorized (3 Critical/Security in Tier 1, 14 High-Priority in Tier 2). All 17 recommended KEEP. Cross-referenced 6 issues to active PRs. Report written to Working/issues-critical-high.md with YAML front matter and wiki-link cross-references.
  • Tier 1: Critical Security & Stability — Issues labeled priority:critical or security that threaten data integrity, enable exploits, or cause system-wide failures. Expected: #982 (path traversal CWE-22), #1010 (orphaned subprocess spawning), #793 (CLAUDE.md file pollution in subdirectories)
  • Tier 2: High-Priority Bug Fixes — Issues labeled priority:high that break core functionality. Expected: #998 (500 errors on PostToolUse), #987 (infinite session loop), #979 (migration fails to create tables), #966 (SDK generator abort loop), #942 (setting documented but not implemented), #855 (Gemini corruption), #843 (Windows bun:sqlite), #807 (Windows ProcessTransport), #785 (Windows WMIC removed), #730 (1TB vector-db growth), #729 (worker blocks startup), #718 (zombie session ID), #646 (stdin fstat crash), #997 (Windows command prompt spam), #990 (security report with 8 findings), #707 (SQLite-only mode - labeled enhancement but high priority)
  • For each issue, write: issue number, title, one-line summary of the problem, current labels, and a Recommendation of KEEP (fix it), DISCARD (close as won't-fix), or DEFER (deprioritize)
  • Use structured markdown with YAML front matter: type: report, title: Critical & High-Priority Issues, tags: [triage, critical, high-priority, security]
  • Apply these recommendation criteria: KEEP items that affect security, data integrity, or block normal usage; DISCARD items that are already fixed, duplicated, or obsolete; DEFER items that affect edge cases or have workarounds

• Read Working/raw-issues.json and categorize ALL remaining open issues into Medium-Priority, Windows, Features, Integration, and Low-Priority tiers. Write the output to Working/issues-medium-low.md:

  • Completed: 48 issues categorized across Tiers 3–7 (5 Windows + 4 cross-refs in Tier 3, 18 Medium-Priority in Tier 4, 7 Features in Tier 5, 5 Integration in Tier 6, 13 Low-Priority in Tier 7). 33 recommended KEEP, 15 recommended DEFER, 0 DISCARD. Also included 2 newly filed unlabeled issues (#1015, #1014). Report written to Working/issues-medium-low.md with YAML front matter and wiki-link cross-references.
  • Tier 3: Windows Platform Bugs — Issues tagged platform:windows. Expected: #997, #843, #807, #785, #918, #723, #791, #675. Note some may overlap with Tier 2 (that's fine, list them in both with a cross-reference)
  • Tier 4: Medium-Priority Bugs — Issues labeled priority:medium that affect specific scenarios or have workarounds. Expected: #984, #978, #975, #957, #927, #923, #918, #916, #897, #895, #838, #784, #781, #744, #740, #728, #714, #696, #692, #658, #598, #683, #659, #936, #943, #600, #927
  • Tier 5: High-Impact Features — Enhancement requests with significant user value. Expected: #707 (SQLite-only mode), #659 (delete memories), #683 (project-scoped storage), #936 (orphan message processing), #943 (custom API endpoint), #668 (generalize anti-pattern-czar)
  • Tier 6: Integration & Compatibility — Issues affecting third-party tool integration. Expected: #838 (Cursor), #744 (Codex), #690 (LiteLLM), #762 (Cursor install)
  • Tier 7: Low-Priority / Code Quality — Issues labeled priority:low or affecting cosmetics/logging. Expected: #1011, #1005, #965, #816, #725, #716, #709, #695, #675, #649, #648, #642, #575, #762, #690, #753
  • For each issue, write: issue number, title, one-line summary, current labels, and Recommendation (KEEP/DISCARD/DEFER)
  • Use structured markdown with YAML front matter: type: report, title: Medium & Low-Priority Issues, tags: [triage, medium-priority, low-priority, features, windows]

• Read Working/raw-prs.json and Working/raw-issues.json, then categorize ALL open PRs into a structured PR triage report. Write the output to Working/pr-triage.md:

  • Completed: 27 PRs categorized across 9 groups. 19 recommended REVIEW, 5 CLOSE, 5 DEFER, 0 immediate MERGE. Mapped PRs to linked issues with cross-references. Identified key coordination clusters: security (#1002 vs #986), subprocess management (#1008/#995/#992), session IDs (#996/#989/#518/#516). Report written to Working/pr-triage.md with YAML front matter and wiki-link cross-references. Note: Task listed #1021 but actual PR number is #1022 (username spaces fix); #834 was not in the open PR set.
  • Map each PR to the issue(s) it addresses (check PR body for "Fixes #", "Closes #", or issue references)
  • Categorize each PR as one of:
    • MERGE — PR addresses a critical/high issue, code looks reasonable, author is active
    • REVIEW — PR addresses a real issue but needs code review or testing before merge
    • CLOSE — PR is stale (>30 days with no activity), addresses a closed issue, or is low quality
    • DEFER — PR addresses a low-priority issue or is a nice-to-have
  • Group PRs by category:
    • Owner PRs (by thedotmack): #1012 (OpenClaw plugin), #518 (SDK V2 migration), #516 (orphaned observer sessions)
    • Security Fixes: #1002 (path traversal fix), #986 (CWE-22 + CWE-1321)
    • Critical Bug Fixes: #1008 (unbounded subprocess spawning), #977 (Linux stdin crash), #996 (synthetic session IDs)
    • Windows Fixes: #1021 (username spaces), #1006 (Chroma + WMIC), #474 (libuv assertion)
    • Features: #1019 (env vars), #995 (subprocess pool), #994 (stale session recovery), #993 (Chroma timeout), #992 (MCP heartbeat), #991 (Chroma disable setting), #434 (project exclusion)
    • Infrastructure: #1009 (MCP rename), #792 (Chroma HTTP server), #877/#876 (GitHub Actions upgrades)
    • Documentation: #999, #1013, #983 (CLAUDE.md restructures)
    • Other: #1000 (bug report diagnostics), #989 (FK constraint), #647 (9 bug fixes mega-PR), #498 (opencode plugin), #464 (Sleep Agent)
  • For each PR, write: PR number, title, author, linked issue(s), age, and Recommendation (MERGE/REVIEW/CLOSE/DEFER)
  • Use structured markdown with YAML front matter: type: report, title: PR Triage Report, tags: [triage, pull-requests, code-review]

• Read all three report files from Working/ (issues-critical-high.md, issues-medium-low.md, pr-triage.md) and compile them into a single master report. Write to Working/MASTER-REPORT.md:

  • Executive Summary at the top with:
    • Total counts: X open issues, Y open PRs
    • Priority distribution: X critical, X high, X medium, X low
    • Key findings: top 3 most impactful issues, top 3 most mergeable PRs
    • Overall health assessment of the repository
  • Quick Decision Matrix — A single table with ALL issues and PRs, each row showing: Number, Title (truncated), Category, Priority, Recommendation (KEEP/DISCARD/DEFER or MERGE/REVIEW/CLOSE/DEFER), and a 1-line rationale
  • Then include all the detailed tier sections from the three input files, organized as:
    1. Critical Security & Stability
    2. High-Priority Bug Fixes
    3. Windows Platform Bugs
    4. Medium-Priority Bugs
    5. High-Impact Features
    6. Integration & Compatibility
    7. Low-Priority / Code Quality
    8. PR Triage
  • Action Plan at the bottom with:
    • "Immediate Actions" — Critical items to fix NOW (security + stability)
    • "Next Sprint" — High-priority items that should be scheduled soon
    • "Community Contributions" — PRs that can be merged with minimal effort
    • "Close Candidates" — Issues and PRs recommended for closure with reasons
  • Use YAML front matter: type: report, title: Claude-Mem Issue & PR Triage Report, created: 2026-02-07, tags: [triage, master-report, prioritization]
  • Use [[Issues-Critical-High]], [[Issues-Medium-Low]], [[PR-Triage]] wiki-links to reference the component reports