Troubleshooting Guide

Solutions to common issues. If you don't find your issue here, check GitHub Issues or open a new one.

Quick Diagnostics

bash

# Validate version file and configuration
sley doctor

# Discover modules and version sources
sley discover

# Check sley version
sley --version

Category	Common Issues
.version File Issues	File not found, invalid format, permission denied, empty file
Plugin Errors	Plugin not found, release gate validation, changelog generation, dependency check
Git & Tag Issues	Tag already exists, tag create --all failures, push failures, GPG signing, partial failures
CI/CD Issues	Interactive prompts, permission denied, detached HEAD, changes not committed
Monorepo Issues	No modules found, wrong tag prefix, tag create --all bugs, mismatch warnings, workspace init
Configuration Issues	Invalid YAML, {module_path} without workspace, invalid versioning value
Advanced Topics	Debugging workflows, version rollback, performance optimization, migration

If you can't resolve your issue:

bash

sley --version
sley doctor
sley discover
git --version
cat .sley.yaml
env | grep SLEY