Merge pull request 'development' (#398) from development into main

Reviewed-on: #398

.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Project management plugins with Gitea and NetBox integrations",
-    "version": "5.9.0"
+    "version": "5.8.0"
   },
   "plugins": [
     {

CHANGELOG.md

@@ -6,10 +6,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## [Unreleased]
 
----
-
-## [5.9.0] - 2026-02-03
-
 ### Added
 
 #### Plugin Installation Scripts

CLAUDE.md

@@ -146,7 +146,7 @@ When user says "fix the sprint-plan command", edit the SOURCE code.
 ## Project Overview
 
 **Repository:** leo-claude-mktplace
-**Version:** 5.9.0
+**Version:** 5.8.0
 **Status:** Production Ready
 
 A plugin marketplace for Claude Code containing:

README.md

@@ -1,4 +1,4 @@
-# Leo Claude Marketplace - v5.9.0
+# Leo Claude Marketplace - v5.8.0
 
 A collection of Claude Code plugins for project management, infrastructure automation, and development workflows.
 

docs/CANONICAL-PATHS.md

@@ -182,42 +182,10 @@ MCP servers are **shared at repository root** and configured in `.mcp.json`.
 | MCP configuration | `.mcp.json` | `.mcp.json` (at repo root) |
 | Shared MCP server | `mcp-servers/{server}/` | `mcp-servers/gitea/` |
 | MCP server code | `mcp-servers/{server}/mcp_server/` | `mcp-servers/gitea/mcp_server/` |
-| MCP venv (local) | `mcp-servers/{server}/.venv/` | `mcp-servers/gitea/.venv/` |
+| MCP venv | `mcp-servers/{server}/.venv/` | `mcp-servers/gitea/.venv/` |
 
 **Note:** Plugins do NOT have their own `mcp-servers/` directories. All MCP servers are shared at root and configured via `.mcp.json`.
 
-### MCP Venv Paths - CRITICAL
-
-**Venvs live in a CACHE directory that SURVIVES marketplace updates.**
-
-When checking for venvs, ALWAYS check in this order:
-
-| Priority | Path | Survives Updates? |
-|----------|------|-------------------|
-| 1 (CHECK FIRST) | `~/.cache/claude-mcp-venvs/leo-claude-mktplace/{server}/.venv/` | YES |
-| 2 (fallback) | `{marketplace}/mcp-servers/{server}/.venv/` | NO |
-
-**Why cache first?**
-- Marketplace directory gets WIPED on every update/reinstall
-- Cache directory SURVIVES updates
-- False "venv missing" errors waste hours of debugging
-
-**Pattern for hooks checking venvs:**
-```bash
-CACHE_VENV="$HOME/.cache/claude-mcp-venvs/leo-claude-mktplace/{server}/.venv/bin/python"
-LOCAL_VENV="$MARKETPLACE_ROOT/mcp-servers/{server}/.venv/bin/python"
-
-if [[ -f "$CACHE_VENV" ]]; then
-    VENV_PATH="$CACHE_VENV"
-elif [[ -f "$LOCAL_VENV" ]]; then
-    VENV_PATH="$LOCAL_VENV"
-else
-    echo "venv missing"
-fi
-```
-
-**See lesson learned:** [Startup Hooks Must Check Venv Cache Path First](https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/wiki/lessons/patterns/startup-hooks-must-check-venv-cache-path-first)
-
 ### Documentation Paths
 
 | Type | Location |

plugins/clarity-assist/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "clarity-assist",
-  "version": "1.2.0",
+  "version": "1.0.0",
   "description": "Prompt optimization and requirement clarification with ND-friendly accommodations",
   "author": {
     "name": "Leo Miranda",

plugins/cmdb-assistant/.claude-plugin/plugin.json

@@ -19,5 +19,6 @@
     "data-quality",
     "validation"
   ],
+  "mcp_servers": ["netbox"],
   "commands": ["./commands/"]
 }

plugins/contract-validator/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "contract-validator",
-  "version": "1.2.0",
+  "version": "1.1.0",
   "description": "Cross-plugin compatibility validation and Claude.md agent verification",
   "author": {
     "name": "Leo Miranda",
@@ -17,5 +17,6 @@
     "interfaces",
     "cross-plugin"
   ],
+  "mcp_servers": ["contract-validator"],
   "commands": ["./commands/"]
 }

plugins/data-platform/.claude-plugin/plugin.json

@@ -18,5 +18,6 @@
     "etl",
     "dataframe"
   ],
+  "mcp_servers": ["data-platform"],
   "commands": ["./commands/"]
 }

plugins/data-platform/hooks/startup-check.sh

@@ -5,26 +5,11 @@
 
 PREFIX="[data-platform]"
 
-# Check if MCP venv exists - check cache first, then local
-CACHE_VENV="$HOME/.cache/claude-mcp-venvs/leo-claude-mktplace/data-platform/.venv/bin/python"
+# Check if MCP venv exists
 PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "$(realpath "$0")")")}"
-MARKETPLACE_ROOT="$(dirname "$(dirname "$PLUGIN_ROOT")")"
-LOCAL_VENV="$MARKETPLACE_ROOT/mcp-servers/data-platform/.venv/bin/python"
+VENV_PATH="$PLUGIN_ROOT/mcp-servers/data-platform/.venv/bin/python"
 
-# Check cache first (preferred), then local symlink
-CACHE_VENV_DIR="$HOME/.cache/claude-mcp-venvs/leo-claude-mktplace/data-platform/.venv"
-LOCAL_VENV_DIR="$MARKETPLACE_ROOT/mcp-servers/data-platform/.venv"
-
-if [[ -f "$CACHE_VENV" ]]; then
-    VENV_PATH="$CACHE_VENV"
-    # Auto-create symlink in installed marketplace if missing
-    if [[ ! -e "$LOCAL_VENV_DIR" && -d "$CACHE_VENV_DIR" ]]; then
-        mkdir -p "$(dirname "$LOCAL_VENV_DIR")" 2>/dev/null
-        ln -sf "$CACHE_VENV_DIR" "$LOCAL_VENV_DIR" 2>/dev/null
-    fi
-elif [[ -f "$LOCAL_VENV" ]]; then
-    VENV_PATH="$LOCAL_VENV"
-else
+if [[ ! -f "$VENV_PATH" ]]; then
     echo "$PREFIX MCP venv missing - run /initial-setup or setup.sh"
     exit 0
 fi

plugins/doc-guardian/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "doc-guardian",
   "description": "Automatic documentation drift detection and synchronization",
-  "version": "1.1.0",
+  "version": "1.0.0",
   "author": {
     "name": "Leo Miranda",
     "email": "leobmiranda@gmail.com"

plugins/git-flow/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "git-flow",
-  "version": "1.2.0",
+  "version": "1.0.0",
   "description": "Git workflow automation with intelligent commit messages and branch management",
   "author": {
     "name": "Leo Miranda",

plugins/pr-review/.claude-plugin/plugin.json

@@ -16,5 +16,6 @@
     "performance",
     "multi-agent"
   ],
+  "mcp_servers": ["gitea"],
   "commands": ["./commands/"]
 }

plugins/pr-review/hooks/startup-check.sh

@@ -5,18 +5,11 @@
 
 PREFIX="[pr-review]"
 
-# Check if MCP venv exists - check cache first, then local
-CACHE_VENV="$HOME/.cache/claude-mcp-venvs/leo-claude-mktplace/gitea/.venv/bin/python"
+# Check if MCP venv exists
 PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "$(realpath "$0")")")}"
-MARKETPLACE_ROOT="$(dirname "$(dirname "$PLUGIN_ROOT")")"
-LOCAL_VENV="$MARKETPLACE_ROOT/mcp-servers/gitea/.venv/bin/python"
+VENV_PATH="$PLUGIN_ROOT/mcp-servers/gitea/.venv/bin/python"
 
-# Check cache first (preferred), then local
-if [[ -f "$CACHE_VENV" ]]; then
-    VENV_PATH="$CACHE_VENV"
-elif [[ -f "$LOCAL_VENV" ]]; then
-    VENV_PATH="$LOCAL_VENV"
-else
+if [[ ! -f "$VENV_PATH" ]]; then
     echo "$PREFIX MCP venvs missing - run setup.sh from installed marketplace"
     exit 0
 fi

plugins/projman/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "projman",
-  "version": "3.4.0",
+  "version": "3.3.0",
   "description": "Sprint planning and project management with Gitea integration",
   "author": {
     "name": "Leo Miranda",
@@ -16,5 +16,6 @@
     "agile",
     "lessons-learned"
   ],
+  "mcp_servers": ["gitea"],
   "commands": ["./commands/"]
 }

plugins/projman/hooks/startup-check.sh

@@ -29,19 +29,17 @@ if [[ -f ".env" ]]; then
 
     if [[ -n "$GITEA_API_URL" && -n "$GITEA_API_TOKEN" && -n "$GITEA_REPO" ]]; then
         # Quick check for open issues without milestone (unplanned work)
-        # Note: grep -c returns 0 on no match but exits non-zero, causing || to also fire
-        # Use subshell to ensure single value
         OPEN_ISSUES=$(curl -s -m 5 \
             -H "Authorization: token $GITEA_API_TOKEN" \
             "${GITEA_API_URL}/repos/${GITEA_REPO}/issues?state=open&milestone=none&limit=1" 2>/dev/null | \
-            grep -c '"number"' 2>/dev/null) || OPEN_ISSUES=0
+            grep -c '"number"' || echo "0")
 
         if [[ "$OPEN_ISSUES" -gt 0 ]]; then
             # Count total unplanned issues
             TOTAL_UNPLANNED=$(curl -s -m 5 \
                 -H "Authorization: token $GITEA_API_TOKEN" \
                 "${GITEA_API_URL}/repos/${GITEA_REPO}/issues?state=open&milestone=none" 2>/dev/null | \
-                grep -c '"number"' 2>/dev/null) || TOTAL_UNPLANNED="?"
+                grep -c '"number"' || echo "?")
             echo "$PREFIX ${TOTAL_UNPLANNED} open issues without milestone - consider /sprint-plan"
         fi
     fi

plugins/viz-platform/.claude-plugin/plugin.json

@@ -19,5 +19,6 @@
     "visualization",
     "dmc"
   ],
+  "mcp_servers": ["viz-platform"],
   "commands": ["./commands/"]
 }