Matrix Plugin v2.4.1

Fixed

• Indexer spams terminal during session start - Removed per-file progress output that flooded the terminal with [Matrix] Indexing: ... lines for every file. Now prints only a single summary line when indexing completes.

Matrix Plugin v2.4.0

Leaner, sharper. Claude Code grew up, so we dropped what it handles natively and doubled down on what only Matrix can do.

Removed

• Dreamer (Scheduled Tasks) - Removed the entire cron/scheduler system (src/dreamer/, croner, cronstrue packages). Claude Code now has native scheduling via CronCreate/RemoteTrigger.
• Background Jobs - Removed async job system (src/jobs/). Reindex now runs synchronously. matrix_job_status, matrix_job_cancel, matrix_job_list tools removed.
• Prompt Tool (matrix_prompt) - Removed prompt analysis tool. High token cost, marginal value.
• PromptAnalysis Hook - Removed memory injection into prompts. Token overhead outweighed benefit.
• SubagentStart Hook - Removed hint injection into subagents.
• PostToolUse:Bash Hook - Removed bash output logging. Claude sees output directly.
• TaskCompleted Hook - Removed task completion logging.
• Clone Repo Skill (/matrix:clone-repo) - git clone works fine natively.
• RunMD Skill (/matrix:runmd) - Bash tool covers this.
• @anthropic-ai/sdk dependency - Was unused (never imported).

Changed

• DB Migrations Flattened - Replaced 8 incremental migrations + 100 LOC version detection with a single idempotent legacy upgrade. SCHEMA_VERSION bumped to 9. Existing DBs at any version (1-8) upgrade cleanly.
• Dependencies Updated
  • @modelcontextprotocol/sdk 1.25.0 → 1.29.0
  • @sinclair/typebox 0.34.45 → 0.34.49
  • web-tree-sitter 0.26.3 → 0.26.8
  • @types/bun 1.3.4 → 1.3.11
  • oxlint 1.35.0 → 1.58.0

Improved

• Scanner: .gitignore support - File scanner now parses .gitignore and respects all patterns. No more indexing build output or generated files.
• Scanner: symlink cycle detection - Detects and skips symlink cycles and broken symlinks via lstat().
• Incremental indexing: content hash - Uses SHA-256 content hashing (stored in DB) instead of mtime-only detection. Catches refactors where timestamp is unreliable, skips touch-without-edit.
• Parser: per-file timeout - 10s timeout per file prevents hangs on malformed/huge files.
• Python parser: decorator extraction - Captures @property, @staticmethod, @classmethod, @dataclass and custom decorators. Properties correctly classified. Dataclass fields auto-extracted.
• TypeScript parser: re-export tracking - export { X } from './bar', export * from './bar' now create import edges. Fixes caller detection through barrel exports.
• Symbol search: fuzzy ranking - searchSymbols now ranks exact > prefix > substring, with optional kind filter and higher default limit (30).
• Import resolution: tsconfig path aliases - Loads tsconfig.json/jsconfig.json compilerOptions.paths for accurate import graph resolution (e.g., @/utils/foo → src/utils/foo).

Matrix Plugin v2.2.3

What's New in v2.2.3

Added

• Dreamer Skill (/matrix:dreamer) - Slash command access to the scheduled task system (add, list, run, remove, status, logs, history). Includes one-time vs recurring clarification requirement.

Fixed

• Silent catch blocks - Added console.error logging to embedding decode errors in recall.ts, failure.ts, and client.ts. Previously all errors were swallowed, making debugging impossible.
• Unsafe JSON.parse - Wrapped 12 unprotected JSON.parse calls with safeJsonParse helper across recall, dreamer types, job manager, and worker entry. One corrupted DB row no longer crashes the entire operation.
• Warn upsert race condition - Replaced INSERT/catch-UNIQUE/UPDATE pattern with check-first approach, eliminating the race window and the catch (err: any) antipattern.
• Embedding retry - Model loading now retries up to 3 times before permanently disabling embeddings. A single network hiccup no longer kills semantic search for the session.

---

Matrix Plugin v2.2.2

What's New in v2.2.2

Added

• Nuke Skill (/matrix:nuke) - Comprehensive codebase hygiene analysis across 11 categories:
  • Structural detection (via new MCP tools): dead exports, orphaned files, circular dependencies
  • Generative detection (AI judgment): unnecessary comments, commented-out code, console.log leftovers, overengineered deps, copy-paste duplication, stale TODOs
  • 4 modes: scan (report only, default), this (single file), safe (high confidence only), aggressive (medium+)
  • Confidence-tiered output: HIGH (>90%), MEDIUM (70-90%), LOW (<70%) with safety rules to prevent false positives
  • 4-agent architecture: Structural, Dependency, Generative, Triage
• matrix_find_dead_code MCP tool - Finds exported symbols with zero callers and orphaned files with no importers. Queries the code index DB directly.
• matrix_find_circular_deps MCP tool - Builds import graph from the index and runs DFS cycle detection. Returns all circular dependency chains.
• TaskCompleted hook - Detects significant completed tasks and suggests storing the solution via matrix_store.
• Clone Repo skill (/matrix:clone-repo) - Shallow clone external repos to temp/ for exploration.

Changed

• Review Skill - Detection Agent now includes full hygiene (nuke) scan on changed files. Distinguishes between issues introduced by the change vs pre-existing in touched files. Introduced console.logs → Tier 1, introduced unused imports/dead exports → Tier 2, pre-existing TODOs/comments → Tier 3.
• Dynamic version - MCP server version now synced from package.json instead of hardcoded.
• Memory safety - Regex pattern cache capped at 200 entries to prevent unbounded growth.

Removed

• Session Modes - Removed the entire session mode system (ultrathink/quick/docs/debug/classic). Simplicity wins.
• UserPromptSubmit hook - Removed per-prompt overhead. Claude Code already provides git context and CLAUDE.md natively.
• PreCompact hook - Was a dead hook (couldn't output anything). Removed.
• Stop hook - Replaced by the lighter TaskCompleted hook.
• PostToolUse:Matrix hook - Removed nanny suggestions after matrix tool calls.
• SubagentStop hook - Removed (no-op).
• Auto-install file suggestion - No longer silently modifies ~/.claude/settings.json on session start.
• minimal verbosity level - Two levels (full/compact) is enough.
• Repomix tool - Replaced by /matrix:clone-repo skill (just clones to temp/, no dependency needed).
• Skill Factory tools - Removed matrix_skill, matrix_skill_candidates, matrix_link_skill and all related code.
• Export skill - Merged into /matrix:list (say "export" or "backup" to save JSON).

---

---

Previous Release

[2.2.1] - 2025-01-29

Added

• Swift & SwiftUI Skill (/swift-swiftui) - iOS/macOS dev patterns, @observable, MVVM/TCA, SwiftData
• Effect-TS Skill (/effect-ts) - Typed errors, layers, concurrency, Schema, fp-ts migration

---

Matrix Plugin v2.2.1

What's New in v2.2.1

Added

• Swift & SwiftUI Skill (/swift-swiftui) - iOS/macOS dev patterns, @ Observable, MVVM/TCA, SwiftData
• Effect-TS Skill (/effect-ts) - Typed errors, layers, concurrency, Schema, fp-ts migration

---

Matrix Plugin v2.2.0

What's New in v2.2.0

Added

Token Optimization

• Compact Recall Mode - matrix_recall({ compact: true }) returns minimal data
  • Returns: {id, problem, similarity, score, successRate}
  • Fetch full details with new matrix_get_solution(id) tool
• Optional Hints - includeHints: false on recall/store/failure skips _hints field

New Tools

• matrix_get_solution - Fetch full solution details by ID after compact recall
• matrix_skill - Unified skill management with actions: candidates, link
  • Replaces matrix_skill_candidates + matrix_link_skill (kept as aliases)

Changed

Internal Refactors

• Parser Architecture - Template method pattern for 15 language parsers
• Doctor Modularization - Split into focused check modules
• Shared Utilities - FileIO abstraction and file-suggestion extraction

---

Matrix Plugin v2.1.9

Introducing Session Modes

• Mode Selection on Start - Interactive prompt asks user to select session mode

• 5 Modes Available:

  • Ultrathink - Full planning, thorough review, deep research
  • Quick - Minimal overhead, skip extras, fast execution
  • Docs - Documentation focus, clean context, no injections
  • Debug - Investigation focus, past failures + blast radius
  • Classic - Uses your config defaults (backward compatible)

• Mode-aware Behavior - Memory injection, complexity analysis, review suggestions adapt to mode

• Mid-session Switching - Type mode name or number to switch (e.g., "quick", "2")

• Session Persistence - Mode stored in ~/.claude/matrix/sessions/ with 24h TTL

Changed

Review Skill

• New Verification Agent - Automatically runs build, typecheck, test, lint after review
• Project Auto-Detection - Supports package.json, Cargo.toml, go.mod, pyproject.toml, and more
• Continue on Failure - Reports all command results, doesn't stop on first error
• Output Summary - Table format showing pass/fail status and duration per command

Matrix Plugin v2.1.7

What's New in v2.1.7

Fixed

Resource Leak Prevention (new Claude Code Patterns)

• setTimeout Orphan Fix - Job timeouts tracked and cleared on terminal states/shutdown
• Dreamer Process Cleanup - Switched from exec to spawn with proper stream destruction
• Git Command Streams - Added runGitCommand() helper with finally cleanup
• HTTP Request Timeouts - Moved clearTimeout to finally blocks (OSV, Bundlephobia, npm)

Memory Bounds (new Claude Code Patterns)

• Embedding Search - Batch processing (1000 rows) prevents loading entire DB
• Dreamer Output - 1MB cap on stdout/stderr prevents memory exhaustion
• Indexer Errors - Capped at 100 errors to prevent unbounded growth
• Parser Cache - LRU eviction (max 10 parsers) limits memory usage

Performance

• Scanner Regex - Pre-compile exclude patterns (avoid per-file regex creation)

Changed

Dreamer Clarification Required

• One-time vs Recurring - MCP instructions now require confirming user intent before scheduling
• Tool Description - Updated matrix_dreamer to warn that "at 1am" becomes daily cron
• Startup Cleanup - Orphaned jobs from previous sessions marked as failed

---

---

Previous Release

[2.1.5] - 2025-01-19

Changed

Dreamer

• Default branch prefix: claude-task/ → matrix-dreamer/
• New config section dreamer.worktree and dreamer.execution for defaults

Review Skill (/matrix:review)

• 4-agent architecture: Detection → Impact → Triage → Remediation
• Tiered output (critical/important/noise) with confidence scores

---

Matrix Plugin v2.1.5

What's New in v2.1.5

Changed

Dreamer

• Default branch prefix: claude-task/ → matrix-dreamer/
• New config section dreamer.worktree and dreamer.execution for defaults

Review Skill (/matrix:review)

• 4-agent architecture: Detection → Impact → Triage → Remediation
• Tiered output (critical/important/noise) with confidence scores

---

---

Previous Release

[2.1.4] - 2025-01-18

Fixed

Database Initialization

• Missing plugin_meta Table - Fixed session start crash when inserting plugin metadata
  • session-start.ts attempted to INSERT into plugin_meta table that didn't exist
  • Added plugin_meta table to schema.ts for fresh installs
  • Added v6 migration in migrate.ts for existing databases
  • Added v6 version detection in migration logic

Database Schema

• v6 Migration - Added plugin metadata table
  • plugin_meta: Key-value store for plugin version, install source, etc.

---

Matrix Plugin v2.1.4

What's New in v2.1.4

Fixed

Database Initialization

• Missing plugin_meta Table - Fixed session start crash when inserting plugin metadata
  • session-start.ts attempted to INSERT into plugin_meta table that didn't exist
  • Added plugin_meta table to schema.ts for fresh installs
  • Added v6 migration in migrate.ts for existing databases
  • Added v6 version detection in migration logic

Database Schema

• v6 Migration - Added plugin metadata table
  • plugin_meta: Key-value store for plugin version, install source, etc.

---

---

Previous Release

[2.1.3] - 2025-01-18

Changed

Doctor - Comprehensive Diagnostics

• Expanded Health Checks - Added diagnostics for all v2.0+ features
  • Background Jobs: Table existence, orphaned job cleanup
  • Hook Executions: Session tracking table validation
  • Skills Directory: Existence check and skill count
  • Subagent Hooks: toolSearch config validation
  • Model Delegation: delegation config section check
  • Dreamer Scheduler: Tables and platform registration (launchd/crontab)
  • File Suggestion: Script installation and settings.json config
• Auto-fix Capabilities - Most issues can be automatically resolved
• Enhanced Issue Template - Categorized checks for better bug reporting

---