# Changelog

All notable changes to the Leo Claude Marketplace will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).

## [Unreleased]

### Added

#### Sprint 1: viz-platform Plugin ✅ Completed
- **viz-platform** v1.0.0 - Visualization tools with Dash Mantine Components validation and theming
  - **DMC Tools** (3 tools): `list_components`, `get_component_props`, `validate_component`
    - Version-locked component registry prevents Claude from hallucinating invalid props
    - Static JSON registry approach for fast, deterministic validation
  - **Chart Tools** (2 tools): `chart_create`, `chart_configure_interaction`
    - Plotly-based visualization with theme token support
  - **Layout Tools** (5 tools): `layout_create`, `layout_add_filter`, `layout_set_grid`, `layout_get`, `layout_add_section`
    - Dashboard composition with responsive grid system
  - **Theme Tools** (6 tools): `theme_create`, `theme_extend`, `theme_validate`, `theme_export_css`, `theme_list`, `theme_activate`
    - Design token-based theming system
    - Dual storage: user-level (`~/.config/claude/themes/`) and project-level
  - **Page Tools** (5 tools): `page_create`, `page_add_navbar`, `page_set_auth`, `page_list`, `page_get_app_config`
    - Multi-page Dash app structure generation
  - **Commands**: `/chart`, `/dashboard`, `/theme`, `/theme-new`, `/theme-css`, `/component`, `/initial-setup`
  - **Agents**: `theme-setup`, `layout-builder`, `component-check`
  - **SessionStart Hook**: DMC version check (non-blocking)
  - **Tests**: 94 tests passing
    - config.py: 82% coverage
    - component_registry.py: 92% coverage
    - dmc_tools.py: 88% coverage
    - chart_tools.py: 68% coverage
    - theme_tools.py: 99% coverage

**Sprint Completed:**
- Milestone: Sprint 1 - viz-platform Plugin (closed 2026-01-26)
- Issues: #170-#182 (13/13 closed)
- Wiki: [Sprint-1-viz-platform-Implementation-Plan](https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/wiki/Sprint-1-viz-platform-Implementation-Plan)
- Lessons: [sprint-1---viz-platform-plugin-implementation](https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/wiki/lessons/sprints/sprint-1---viz-platform-plugin-implementation)
- Reference: `docs/changes/CHANGE_V04_0_0_PROPOSAL_ORIGINAL.md` (Phases 4-5)

---

## [4.1.0] - 2026-01-26

### Added
- **projman:** Wiki-based planning workflow enhancement (V04.1.0)
  - Flexible input source detection in `/sprint-plan` (file, wiki, or conversation)
  - Wiki proposal and implementation page creation during sprint planning
  - Wiki reference linking in created issues
  - Wiki status updates in `/sprint-close` (Implemented/Partial/Failed)
  - Metadata section in lessons learned with implementation link for traceability
  - New `/proposal-status` command for viewing proposal/implementation tree
- **projman:** `/suggest-version` command - Analyzes CHANGELOG and recommends semantic version bump
- **projman:** SessionStart hook now suggests sprint planning when open issues exist without milestone
- **projman:** SessionStart hook now warns about unreleased CHANGELOG entries

### Changed
- **doc-guardian:** Hook now tracks documentation dependencies and queues specific files needing updates
  - Outputs which specific docs need updating (e.g., "commands changed → update needed: docs/COMMANDS-CHEATSHEET.md README.md")
  - Maintains queue file (`.doc-guardian-queue`) for batch processing
- **docs:** COMMANDS-CHEATSHEET.md updated with data-platform plugin (7 commands + hook)

### Fixed
- Documentation drift: COMMANDS-CHEATSHEET.md was missing data-platform plugin added in v4.0.0
- Proactive sprint planning: projman now suggests `/sprint-plan` at session start when unplanned issues exist

### Known Issues
- **MCP Bug #160:** `update_wiki_page` tool renames pages to "unnamed" when page_name contains URL-encoded characters (`:` → `%3A`). Workaround: use `create_wiki_page` to overwrite instead.

---

## [4.0.0] - 2026-01-25

### Added

#### New Plugin: data-platform v1.0.0
- **pandas MCP Tools** (14 tools): DataFrame operations with Arrow IPC data_ref persistence
  - `read_csv`, `read_parquet`, `read_json` - Load data with chunking support
  - `to_csv`, `to_parquet` - Export to various formats
  - `describe`, `head`, `tail` - Data exploration
  - `filter`, `select`, `groupby`, `join` - Data transformation
  - `list_data`, `drop_data` - Memory management

- **PostgreSQL MCP Tools** (10 tools): Database operations with asyncpg connection pooling
  - `pg_connect`, `pg_query`, `pg_execute` - Core database operations
  - `pg_tables`, `pg_columns`, `pg_schemas` - Schema exploration
  - `st_tables`, `st_geometry_type`, `st_srid`, `st_extent` - PostGIS spatial support

- **dbt MCP Tools** (8 tools): Build tool wrapper with pre-execution validation
  - `dbt_parse` - Pre-flight validation (catches dbt 1.9+ deprecations)
  - `dbt_run`, `dbt_test`, `dbt_build` - Execution with auto-validation
  - `dbt_compile`, `dbt_ls`, `dbt_docs_generate`, `dbt_lineage` - Analysis tools

- **Commands**: `/ingest`, `/profile`, `/schema`, `/explain`, `/lineage`, `/run`
- **Agents**: `data-ingestion` (loading/transformation), `data-analysis` (exploration/profiling)
- **SessionStart Hook**: Graceful PostgreSQL connection check (non-blocking warning)

- **Key Features**:
  - data_ref system for DataFrame persistence across tool calls
  - 100k row limit with chunking support for large datasets
  - Hybrid configuration (system: `~/.config/claude/postgres.env`, project: `.env`)
  - Auto-detection of dbt projects
  - Arrow IPC format for efficient memory management

---

## [3.2.0] - 2026-01-24

### Added
- **git-flow:** `/commit` now detects protected branches before committing
  - Warns when on protected branch (main, master, development, staging, production)
  - Offers to create feature branch automatically instead of committing directly
  - Configurable via `GIT_PROTECTED_BRANCHES` environment variable
- **netbox:** Platform and primary_ip parameters added to device update tools
- **claude-config-maintainer:** Auto-enforce mandatory behavior rules via SessionStart hook
- **scripts:** `release.sh` - Versioning workflow script for consistent releases
- **scripts:** `verify-hooks.sh` - Verify all hooks are command type

### Changed
- **doc-guardian:** Hook switched from `prompt` type to `command` type
  - Prompt hooks unreliable - Claude ignores explicit instructions
  - New `notify.sh` bash script guarantees exact output behavior
  - Only notifies for config file changes (commands/, agents/, skills/, hooks/)
  - Silent exit for all other files - no blocking possible
- **All hooks:** Converted to command type with stricter plugin prefix enforcement
  - All hooks now mandate `[plugin-name]` prefix with "NO EXCEPTIONS" rule
  - Simplified output formats with word limits
  - Consistent structure across projman, pr-review, code-sentinel, doc-guardian
- **CLAUDE.md:** Replaced destructive "ALWAYS CLEAR CACHE" rule with "VERIFY AND RESTART"
  - Cache clearing mid-session breaks MCP tools
  - Added guidance for proper plugin development workflow

### Fixed
- **cmdb-assistant:** Complete MCP tool schemas for update operations (#138)
- **netbox:** Shorten tool names to meet 64-char API limit (#134)
- **cmdb-assistant:** Correct NetBox API URL format in setup wizard (#132)
- **gitea/projman:** Type safety for `create_label_smart`, curl-based debug-report (#124)
- **netbox:** Add diagnostic logging for JSON parse errors (#121)
- **labels:** Add duplicate check before creating labels (#116)
- **hooks:** Convert ALL hooks to command type with proper prefixes (#114)
- Protected branch workflow: Claude no longer commits directly to protected branches (fixes #109)
- doc-guardian hook no longer blocks workflow (fixes #110)

---

## [3.1.1] - 2026-01-22

### Added
- **git-flow:** `/commit-sync` now prunes stale remote-tracking branches with `git fetch --prune`
- **git-flow:** `/commit-sync` detects and reports local branches with deleted upstreams
- **git-flow:** `/branch-cleanup` now handles stale branches (upstream gone) separately from merged branches
- **git-flow:** New `GIT_CLEANUP_STALE` environment variable for stale branch cleanup control

### Changed
- **All hooks:** Added `[plugin-name]` prefix to all hook messages for better identification
  - `[projman]`, `[pr-review]`, `[code-sentinel]`, `[doc-guardian]` prefixes
- **doc-guardian:** Hook now notification-only (no file reads or blocking operations)
  - Suggests running `/doc-sync` instead of performing inline checks
  - Significantly reduces workflow interruption

### Fixed
- doc-guardian hook no longer stalls workflow with deep file analysis

---

## [3.1.0] - 2026-01-21

### Added

#### Debug Workflow Commands (projman)
- **`/debug-report`** - Run diagnostics in test projects, create structured issues in marketplace
  - Runs 5 diagnostic MCP tool tests with explicit repo parameter
  - Captures full project context (git remote, cwd, branch)
  - Generates structured issue with hypothesis and investigation steps
  - Creates issue in configured marketplace repository automatically

- **`/debug-review`** - Investigate diagnostic issues with human approval gates
  - Lists open diagnostic issues for triage
  - Maps errors to relevant code files using error-to-file mapping
  - MANDATORY: Reads relevant files before proposing any fix
  - Three approval gates: investigation summary, fix approach, PR creation
  - Creates feature branch, commits, and PR with proper linking

#### MCP Server Improvements
- Dynamic label format detection in `suggest_labels`
  - Supports slash format (`Type/Bug`) and colon-space format (`Type: Bug`)
  - Fetches actual labels from repo and matches suggestions to real format
  - Handles Effort/Efforts singular/plural normalization

### Changed
- **`/labels-sync`** completely rewritten with explicit execution steps
  - Step 1 now explicitly requires running `git remote get-url origin` via Bash
  - All MCP tool calls show required `repo` parameter
  - Added "DO NOT" section preventing common mistakes
  - Removed confusing "Label Reference" section that caused file creation prompts

### Fixed
- MCP tools no longer fail with "Use 'owner/repo' format" error
  - Root cause: MCP server is sandboxed and cannot auto-detect project directory
  - Solution: Command documentation now instructs Claude to detect repo via Bash first

---

## [3.0.1] - 2026-01-21

### Added
- `/project-init` command for quick project setup when system is already configured
- `/project-sync` command to sync .env with git remote after repository move/rename
- SessionStart hooks for automatic mismatch detection between git remote and .env
- Interactive setup wizard (`/initial-setup`) redesigned to use Claude tools instead of bash script

### Changed
- `GITEA_ORG` moved from system-level to project-level configuration (different projects may belong to different organizations)
- Environment variables renamed to match MCP server expectations:
  - `GITEA_URL` → `GITEA_API_URL` (must include `/api/v1`)
  - `GITEA_TOKEN` → `GITEA_API_TOKEN`
  - `NETBOX_URL` → `NETBOX_API_URL` (must include `/api`)
  - `NETBOX_TOKEN` → `NETBOX_API_TOKEN`
- Setup commands now validate repository via Gitea API before saving configuration
- README.md simplified to show only wizard setup path (manual setup moved to CONFIGURATION.md)

### Fixed
- API URL paths in curl commands (removed redundant `/api/v1` since it's now in the URL variable)
- Documentation now correctly references environment variable names

---

## [3.0.0] - 2026-01-20

### Added

#### New Plugins
- **clarity-assist** v1.0.0 - Prompt optimization with ND accommodations
  - `/clarify` command for full 4-D methodology optimization
  - `/quick-clarify` command for rapid single-pass clarification
  - clarity-coach agent with ND-friendly questioning patterns
  - prompt-patterns skill with optimization rules

- **git-flow** v1.0.0 - Git workflow automation
  - `/commit` command with smart conventional commit messages
  - `/commit-push`, `/commit-merge`, `/commit-sync` workflow commands
  - `/branch-start`, `/branch-cleanup` branch management commands
  - `/git-status` enhanced status with recommendations
  - `/git-config` interactive configuration
  - git-assistant agent for complex operations
  - workflow-patterns skill with branching strategies

- **pr-review** v1.0.0 - Multi-agent pull request review
  - `/pr-review` command for comprehensive multi-agent review
  - `/pr-summary` command for quick PR overview
  - `/pr-findings` command for filtering review findings
  - coordinator agent for orchestrating reviews
  - security-reviewer, performance-analyst, maintainability-auditor, test-validator agents
  - review-patterns skill with confidence scoring rules

#### Gitea MCP Server Enhancements
- 6 new Pull Request tools:
  - `list_pull_requests` - List PRs with filters
  - `get_pull_request` - Get PR details
  - `get_pr_diff` - Get PR diff
  - `get_pr_comments` - Get PR comments
  - `create_pr_review` - Create review (approve, request changes, comment)
  - `add_pr_comment` - Add comment to PR

#### Documentation
- `docs/CONFIGURATION.md` - Centralized configuration guide for all plugins

### Changed
- **BREAKING:** Marketplace renamed from `claude-code-marketplace` to `leo-claude-mktplace`
- **BREAKING:** MCP servers moved from plugin directories to shared `mcp-servers/` at repository root
- All plugins now have `category`, `tags`, and `license` fields in marketplace.json
- Plugin MCP dependencies now use symlinks to shared servers
- projman version bumped to 3.0.0 (includes PR tools integration)
- projman CONFIGURATION.md slimmed down, links to central docs

### Removed
- Standalone MCP server directories inside plugins (replaced with symlinks)

---

## [2.3.0] - 2026-01-20

### Added

#### New Plugins
- **doc-guardian** v1.0.0 - Documentation lifecycle management
  - `/doc-audit` command for full project documentation drift analysis
  - `/doc-sync` command to batch apply pending documentation updates
  - PostToolUse hook for automatic drift detection
  - Stop hook reminder for pending updates
  - doc-analyzer agent for cross-reference analysis
  - doc-patterns skill for documentation structure knowledge

- **code-sentinel** v1.0.0 - Security scanning and refactoring
  - `/security-scan` command for comprehensive security audit
  - `/refactor` command to apply refactoring patterns
  - `/refactor-dry` command to preview refactoring opportunities
  - PreToolUse hook for real-time security scanning
  - security-reviewer agent for vulnerability analysis
  - refactor-advisor agent for code structure improvements
  - security-patterns skill for vulnerability detection rules

#### projman Enhancements
- `/test-gen` command - Generate unit, integration, and e2e tests for specified code

### Changed
- Marketplace version bumped to 2.3.0
- projman version bumped to 2.3.0

## [2.2.0] - 2026-01-20

### Added
- `/review` command for pre-sprint-close code quality checks (projman)
- `/test-check` command for test verification before sprint close (projman)
- `code-reviewer` agent for structured code review workflow (projman)
- Validation script (`scripts/validate-marketplace.sh`) for marketplace compliance
- `homepage` and `repository` fields to all plugin entries in marketplace.json
- `metadata` wrapper for description/version in marketplace.json
- Keywords to all plugin manifests for better discoverability
- `commands` and `agents` directory references to plugin manifests
- Versioning rule: version displayed only in main README.md title

### Changed
- Updated marketplace.json with required fields per Claude Code spec
- Fixed installation documentation to use official Claude Code methods
- Prioritized public HTTPS URL over Tailscale SSH URL in documentation
- Updated all plugin manifests with author, homepage, repository, license fields
- Consolidated version display to main README.md title only
- Removed version numbers from plugin documentation titles

### Fixed
- Plugin manifests now include all required fields per Claude Code spec
- Installation section uses `extraKnownMarketplaces` instead of undocumented `pluginMarketplace`

### Removed
- `docs/references/` directory (obsolete planning documents)
- Version numbers from individual plugin README titles
- Version section from plugins/projman/README.md

## [2.1.0] - 2026-01-15

### Added
- `docs/CANONICAL-PATHS.md` - Single source of truth for all file paths
- Path verification rules in CLAUDE.md (mandatory pre-flight check)
- Recovery protocol for path issues
- Installation script (`scripts/setup.sh`) for new users
- Post-update script (`scripts/post-update.sh`) for updates
- Update documentation (`docs/UPDATING.md`)
- `/initial-setup` slash command
- File creation governance rules in CLAUDE.md
- `.scratch/` directory for transient work
- `scripts/` directory for setup automation

### Changed
- Replaced `docs/CORRECT-ARCHITECTURE.md` reference with `docs/CANONICAL-PATHS.md`
- Added mandatory path verification section to CLAUDE.md
- Updated CLAUDE.md with file creation governance

### Fixed
- Removed dead reference to non-existent `docs/CORRECT-ARCHITECTURE.md`

### Removed
- Organization/workspace GID variable (no longer needed)
- Development output files (test scripts, status reports)
- IDE-specific workspace files
- Stray files from project root

## [2.0.0] - 2026-01-06

### Added
- Full Gitea integration with wiki, milestones, dependencies
- Parallel execution batching via dependency graph
- Wiki tools for lessons learned (`create_lesson`, `search_lessons`)
- Milestone tools (`list_milestones`, `create_milestone`, `update_milestone`)
- Dependency tools (`list_issue_dependencies`, `create_issue_dependency`, `get_execution_order`)
- Validation tools (`validate_repo_org`, `get_branch_protection`)
- MCP servers bundled inside plugins (not shared at root)

### Changed
- MCP server architecture: bundled in plugins instead of shared at root
- Configuration uses `${CLAUDE_PLUGIN_ROOT}/mcp-servers/` paths

## [1.0.0] - 2025-12-15

### Added
- projman plugin with basic sprint commands
- `/sprint-plan`, `/sprint-start`, `/sprint-status`, `/sprint-close` commands
- `/labels-sync` command for label taxonomy synchronization
- Three-agent model (planner, orchestrator, executor)
- Gitea MCP server with issue and label tools
- 43-label taxonomy system
- Hybrid configuration system (system + project level)
- Branch-aware security model

## [0.1.0] - 2025-12-01

### Added
- Initial repository structure
- projman plugin structure (planned)
- projman-pmo plugin structure (planned)
- project-hygiene plugin for cleanup automation
- claude-config-maintainer plugin structure
- cmdb-assistant plugin structure
- Basic marketplace manifest