alekspetrov/navigator/nav-upgrade

# Current installed version
grep '"version"' .claude-plugin/plugin.json
 
# Get all releases (including pre-releases)
curl -s https://api.github.com/repos/qf-studio/navigator/releases
 
# Parse:
# - Latest stable (prerelease: false)
# - Latest pre-release (prerelease: true)
# - Compare with current version

{
  "current_version": "4.0.0",
  "latest_stable": "4.2.0",
  "latest_prerelease": null,
  "recommendation": "update_to_stable"
}

{
  "current_version": "4.0.0",
  "latest_stable": "4.0.0",
  "latest_prerelease": "4.3.0",
  "recommendation": "offer_prerelease_option"
}

✅ You're on the latest stable version (v4.0.0)
 
⚡ Experimental version available: v4.3.0
 
New in v4.3.0 (Experimental):
• Knowledge graph with experiential memories
• PM integration with ticket closing
 
Options:
[1] Stay on stable v4.0.0 (recommended)
[2] Try experimental v4.3.0 (early adopter)
 
Your choice [1-2]:

✅ You're on v4.3.0 (latest experimental)
 
Latest stable: v4.0.0
Status: You're ahead of stable (testing experimental features)
 
New features in your version:
- Knowledge graph with experiential memories

⚠️  You're on v4.3.0 (experimental)
Latest stable: v4.6.0
 
Recommendation: Update to stable v4.6.0
Experimental features from v4.3.0 are now stable.

✅ You're on latest stable version (v4.0.0)
 
⚡ Experimental version available: v4.3.0
 
New in v4.3.0 (Experimental):
• Knowledge graph with experiential memories
• PM integration with ticket closing
 
**Question**: Which version would you like?
 
**Options**:
[1] **Stay on stable v4.0.0** (recommended)
    -Production-ready
    -No experimental features
    -Most reliable
 
[2] **Try experimental v4.3.0** (early adopter)
    -Latest features
    -Help test new functionality
 
Your choice?

✓ Staying on v4.0.0 (latest stable)
 
No action needed. Run nav-upgrade again when you're ready to try experimental features.

# Uninstall current version
/plugin uninstall navigator
 
# Add marketplace (if not already added)
/plugin marketplace add qf-studio/navigator
 
# Install specific pre-release version
# Note: /plugin update only fetches stable, must install specific version
git clone https://github.com/qf-studio/navigator.git /tmp/navigator-v4.3.0
cd /tmp/navigator-v4.3.0
git checkout v4.3.0
 
# Install from local checkout
/plugin install /tmp/navigator-v4.3.0

/plugin list | grep navigator
# Should show: navigator (v4.3.0)

Updating navigator...
✅ Navigator updated to v4.2.0

❌ Update failed: [error message]
 
Troubleshooting:
1. Restart Claude Code
2. Try: /plugin uninstall navigator && /plugin install navigator
3. Check internet connection
4. Report issue: https://github.com/qf-studio/navigator/issues

/plugin uninstall navigator
/plugin marketplace add qf-studio/navigator
/plugin install navigator

# Test that visual-regression skill exists
ls ~/.config/claude/plugins/navigator/skills/visual-regression/SKILL.md 2>/dev/null || echo "Skill not found"

✅ Update Verification
 
Version: v3.3.0 ✅
New Skills Registered: visual-regression ✅
Skills Invokable: ✅
 
Update successful!

⚠️ Update completed but verification failed
 
Issue: visual-regression skill not found
Fix: Restart Claude Code to reload skills
 
After restarting, verify:
"Set up visual regression for Button"

⚠️  RESTART REQUIRED
 
Plugin updated successfully to vX.Y.Z.
Claude Code caches skill paths at session start.
 
To use new/updated skills:
1. Close Claude Code
2. Reopen Claude Code
3. Run "nav start" to verify new version
 
Without restart:
- Old skill versions continue running
- New skills won't be available
- May see "skill not found" errors

🔄 Syncing project CLAUDE.md with updated plugin...
 
✓ Using template from GitHub (v4.3.0)
✓ Extracted customizations
✓ Generated updated CLAUDE.md

Review changes and commit:
 
git add CLAUDE.md
git commit -m "chore: update CLAUDE.md to Navigator v4.3.0"

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$(cat "${NAVIGATOR_CONFIG_HOME:-${XDG_CONFIG_HOME:-$HOME/.config}/navigator}/plugin-root" 2>/dev/null)}"
[ -d "$PLUGIN_DIR/skills" ] || PLUGIN_DIR="$HOME/.claude/plugins/marketplaces/navigator-marketplace"
 
python3 "$PLUGIN_DIR/skills/nav-upgrade/functions/migrate_hooks_out_of_settings.py" \
    .claude/settings.json
 
# Output:
#   ✓ Backup written → .claude/settings.json.pre-migrate.<timestamp>
#   ✓ Removed N Navigator hook entries (commands path matched)
#   ✓ Preserved K unrelated user hooks

⚠️  RESTART REQUIRED to activate hooks from the plugin manifest.
   Claude Code caches plugin hook definitions at session start.

# Check for skills with setup requirements
if [ -f "$NAVIGATOR_PATH/skills/product-design/setup.sh" ]; then
  # Check if venv exists
  if [ ! -d "$NAVIGATOR_PATH/skills/product-design/venv" ]; then
    echo "⚠️  product-design skill requires setup"
    NEEDS_SETUP=true
  fi
fi

⚠️  New Feature Requires Setup
 
The product-design skill (v3.4.0+) requires Python dependencies:
 
**One-time setup** (30 seconds):

 
**What this installs**:
- Python MCP SDK for direct Figma connection
- 95% orchestration reduction
- 92% token savings
 
**After setup, use**:
"Review this Figma design: [URL]"

🎉 Navigator v3.3.0 Update Complete!
 
## New Features Available
 
### visual-regression Skill (NEW)
Set up Storybook + Chromatic in 5 minutes instead of 2-3 hours.
 
**Usage**:

 
**What it does**:
✅ Generates Storybook stories with all variants
✅ Configures Chromatic/Percy/BackstopJS
✅ Creates CI workflows (GitHub Actions, GitLab CI)
✅ Adds accessibility tests
 
**Complete Design Pipeline** (v3.2 + v3.3):
1. "Review this design from Figma" (v3.2)
2. Implement components
3. "Set up visual regression" (v3.3 NEW)
4. Automated visual testing in CI
 
### Updated Skills Count
- **17 total skills** (was 16)
- 10 core Navigator skills
- 7 development skills