From bcb24ae64111f6989c81de506f045ec328a357bf Mon Sep 17 00:00:00 2001 From: lmiranda Date: Tue, 27 Jan 2026 15:12:11 -0500 Subject: [PATCH] docs: sync documentation with code changes for v5.1.0 Changes applied: - Updated version references from 5.0.0 to 5.1.0 (CLAUDE.md, CANONICAL-PATHS.md, setup.sh) - Added missing projman commands to README.md (/suggest-version, /proposal-status) - Added missing cmdb-assistant commands to README.md (/cmdb-audit, /cmdb-register, /cmdb-sync) - Added /proposal-status to projman section in COMMANDS-CHEATSHEET.md - Added 3 cmdb-assistant commands to COMMANDS-CHEATSHEET.md - Added /suggest-version documentation to plugins/projman/README.md - Added 4 missing scripts to CANONICAL-PATHS.md (verify-hooks.sh, setup-venvs.sh, venv-repair.sh, release.sh) Fixes 14 documentation drift issues identified by /doc-guardian:doc-audit. Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 2 +- README.md | 4 ++-- docs/CANONICAL-PATHS.md | 8 ++++++-- docs/COMMANDS-CHEATSHEET.md | 4 ++++ plugins/projman/README.md | 11 +++++++++++ scripts/setup.sh | 2 +- 6 files changed, 25 insertions(+), 6 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index a73688d..a26da75 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -50,7 +50,7 @@ See `docs/DEBUGGING-CHECKLIST.md` for details on cache timing. ## Project Overview **Repository:** leo-claude-mktplace -**Version:** 5.0.0 +**Version:** 5.1.0 **Status:** Production Ready A plugin marketplace for Claude Code containing: diff --git a/README.md b/README.md index 5142d10..739554d 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,7 @@ AI-guided sprint planning with full Gitea integration. Transforms a proven 15-sp - Branch-aware security (development/staging/production) - Pre-sprint-close code quality review and test verification -**Commands:** `/sprint-plan`, `/sprint-start`, `/sprint-status`, `/sprint-close`, `/labels-sync`, `/initial-setup`, `/project-init`, `/project-sync`, `/review`, `/test-check`, `/test-gen`, `/debug-report`, `/debug-review` +**Commands:** `/sprint-plan`, `/sprint-start`, `/sprint-status`, `/sprint-close`, `/labels-sync`, `/initial-setup`, `/project-init`, `/project-sync`, `/review`, `/test-check`, `/test-gen`, `/debug-report`, `/debug-review`, `/suggest-version`, `/proposal-status` #### [git-flow](./plugins/git-flow/README.md) *NEW in v3.0.0* **Git Workflow Automation** @@ -107,7 +107,7 @@ Security vulnerability detection and code refactoring tools. Full CRUD operations for network infrastructure management directly from Claude Code. -**Commands:** `/initial-setup`, `/cmdb-search`, `/cmdb-device`, `/cmdb-ip`, `/cmdb-site` +**Commands:** `/initial-setup`, `/cmdb-search`, `/cmdb-device`, `/cmdb-ip`, `/cmdb-site`, `/cmdb-audit`, `/cmdb-register`, `/cmdb-sync` ### Data Engineering diff --git a/docs/CANONICAL-PATHS.md b/docs/CANONICAL-PATHS.md index 000c88d..97bfb2c 100644 --- a/docs/CANONICAL-PATHS.md +++ b/docs/CANONICAL-PATHS.md @@ -2,7 +2,7 @@ **This file defines ALL valid paths in this repository. No exceptions. No inference. No assumptions.** -Last Updated: 2026-01-26 (v5.0.0) +Last Updated: 2026-01-27 (v5.1.0) --- @@ -165,7 +165,11 @@ leo-claude-mktplace/ │ ├── setup.sh # Initial setup (create venvs, config templates) │ ├── post-update.sh # Post-update (rebuild venvs, verify symlinks) │ ├── check-venv.sh # Check if venvs exist (for hooks) -│ └── validate-marketplace.sh # Marketplace compliance validation +│ ├── validate-marketplace.sh # Marketplace compliance validation +│ ├── verify-hooks.sh # Verify all hooks use correct event types +│ ├── setup-venvs.sh # Setup/repair MCP server venvs +│ ├── venv-repair.sh # Repair broken venv symlinks +│ └── release.sh # Release automation with version bumping ├── CLAUDE.md ├── README.md ├── LICENSE diff --git a/docs/COMMANDS-CHEATSHEET.md b/docs/COMMANDS-CHEATSHEET.md index 04207fd..b9fa497 100644 --- a/docs/COMMANDS-CHEATSHEET.md +++ b/docs/COMMANDS-CHEATSHEET.md @@ -23,6 +23,7 @@ Quick reference for all commands in the Leo Claude Marketplace. | **projman** | `/debug-report` | | X | Run diagnostics and create structured issue in marketplace | | **projman** | `/debug-review` | | X | Investigate diagnostic issues and propose fixes with approval gates | | **projman** | `/suggest-version` | | X | Analyze CHANGELOG and recommend semantic version bump | +| **projman** | `/proposal-status` | | X | View proposal and implementation hierarchy with status | | **git-flow** | `/commit` | | X | Create commit with auto-generated conventional message | | **git-flow** | `/commit-push` | | X | Commit and push to remote in one operation | | **git-flow** | `/commit-merge` | | X | Commit current changes, then merge into target branch | @@ -55,6 +56,9 @@ Quick reference for all commands in the Leo Claude Marketplace. | **cmdb-assistant** | `/cmdb-device` | | X | Manage network devices (create, view, update, delete) | | **cmdb-assistant** | `/cmdb-ip` | | X | Manage IP addresses and prefixes | | **cmdb-assistant** | `/cmdb-site` | | X | Manage sites, locations, racks, and regions | +| **cmdb-assistant** | `/cmdb-audit` | | X | Data quality analysis (VMs, devices, naming, roles) | +| **cmdb-assistant** | `/cmdb-register` | | X | Register current machine into NetBox with running apps | +| **cmdb-assistant** | `/cmdb-sync` | | X | Sync machine state with NetBox (detect drift, update) | | **project-hygiene** | *PostToolUse hook* | X | | Removes temp files, warns about unexpected root files | | **data-platform** | `/ingest` | | X | Load data from CSV, Parquet, JSON into DataFrame | | **data-platform** | `/profile` | | X | Generate data profiling report with statistics | diff --git a/plugins/projman/README.md b/plugins/projman/README.md index f8e3db1..122ed67 100644 --- a/plugins/projman/README.md +++ b/plugins/projman/README.md @@ -278,6 +278,17 @@ Investigate diagnostic issues and propose fixes with human approval. **When to use:** In the marketplace repo, to investigate and fix issues reported by `/debug-report`. +### `/suggest-version` +Analyze CHANGELOG and recommend semantic version bump. + +**What it does:** +- Reads CHANGELOG.md `[Unreleased]` section +- Analyzes changes to determine bump type (major/minor/patch) +- Applies SemVer rules: breaking changes → major, features → minor, fixes → patch +- Returns recommended version with rationale + +**When to use:** Before creating a release to determine the appropriate version number. + ## Code Quality Commands The `/review` and `/test-check` commands complement the Executor agent by catching issues before work is marked complete. Run both commands before `/sprint-close` for a complete quality check. diff --git a/scripts/setup.sh b/scripts/setup.sh index 0328011..c83e2ed 100755 --- a/scripts/setup.sh +++ b/scripts/setup.sh @@ -324,7 +324,7 @@ print_report() { # --- Main --- main() { echo "==============================================" - echo " Leo Claude Marketplace Setup (v5.0.0)" + echo " Leo Claude Marketplace Setup (v5.1.0)" echo "==============================================" echo "" -- 2.49.1