Troubleshooting

# Run full diagnostics
lv doctor --verbose

# Attempt automatic fixes
lv doctor --fix

# Check specific component
lv doctor --check mcp
lv doctor --check git
lv doctor --check config

# Check if npm global bin is in PATH
npm config get prefix

# Add to PATH (bash/zsh)
export PATH="$(npm config get prefix)/bin:$PATH"

# Or reinstall globally
npm install -g @loaded-vibes/cli

# Verify installation
lv --version

# Check MCP status
lv tools status

# Restart MCP servers
lv tools restart

# Reinstall specific server
lv tools uninstall filesystem
lv tools install filesystem

# Check configuration
cat .vscode/mcp.json

# Check current state
lv devcycle status --verbose

# View logs for the stuck phase
lv logs --cycle scaffold --phase implement --since 1h

# Force advance to next phase (use with caution)
lv devcycle advance --force

# Or reset and restart
lv devcycle reset scaffold
lv devcycle run scaffold

# View checkpoint details
lv devcycle checkpoints show <checkpoint-id>

# Stash local changes first
git stash

# Restore checkpoint
lv devcycle checkpoints restore <checkpoint-id>

# Apply stashed changes if needed
git stash pop

# Validate with detailed output
lv artifact validate --verbose

# Common issues:
# - Missing required frontmatter fields
# - Invalid YAML syntax
# - Incorrect tool references

# Regenerate from template
lv artifact create prompt my-prompt --force

# Check git state
git status

# Stash changes
git stash

# Run operation
lv devcycle run scaffold

# Restore changes
git stash pop

# Or commit first
git add -A
git commit -m "wip: save before devcycle"

# Validate configuration
lv config validate

# Reset to defaults
lv config reset

# View effective configuration
lv config list --resolved

# Edit in VS Code for syntax highlighting
code loaded-vibes.config.json

# Soft reset - clear state, keep artifacts
lv reset --soft

# Hard reset - restore to post-install state
lv reset --hard

# Nuclear option - complete reinstall
rm -rf .loaded-vibes node_modules/.cache/@loaded-vibes
lv init --force

# List available backups
lv restore --list

# Restore most recent backup
lv restore backup

# Restore specific backup
lv restore backup 2024-01-15-pre-upgrade

# Restore only specific files
lv restore backup --files ".github/**"

# Validate state file
lv state validate

# Repair if possible
lv state repair

# Reset state (loses in-progress work)
lv state reset

# Manually inspect
cat .loaded-vibes/state.json | jq

# Enable debug logging
export LV_DEBUG=true

# Enable trace logging (very verbose)
export LV_TRACE=true

# Debug specific components
export LV_DEBUG=mcp,devcycle,git

# Run with debug output
LV_DEBUG=true lv devcycle run scaffold

# View recent errors
lv logs --level error --since 1h

# Search logs for specific text
lv logs --grep "connection failed"

# Export logs for support
lv logs --format json --since 24h > debug-logs.json

# Tail logs in real-time
lv logs --follow

# Get help based on current state
lv hint

# Get help for last error
lv hint error --detailed

# Get suggestions for what to do next
lv hint next

# Search documentation
lv docs --search "checkpoint restore"

# Open docs in browser
lv docs --open

# Open specific topic
lv docs devcycles --open

# Generate diagnostic report
lv doctor --report > diagnostic-report.txt

# Include version info
lv --version >> diagnostic-report.txt

# Include relevant logs
lv logs --since 1h --format json >> diagnostic-report.txt

# Set up health checks
lv config set monitoring.healthCheck.enabled true
lv config set monitoring.healthCheck.interval "1h"

# Enable automatic checkpoint creation
lv config set checkpoints.autoCreate true

# Set backup retention
lv config set upgrades.backupRetention 10