dsr - Doodlestein Self-Releaser

Fallback release infrastructure for when GitHub Actions is throttled (>10 min queue time).

When to Use

Use dsr when:

• GitHub Actions queue time exceeds 10 minutes
• You need to build/release a tool locally
• CI is down or unreliable
• You want to test builds across platforms before pushing

Commands Reference

Core Pipeline

dsr check <repo>              # Check if GH Actions is throttled
dsr check --all               # Check all configured repos
dsr build <tool>              # Build locally for all targets
dsr release <tool> <version>  # Upload artifacts to GitHub
dsr fallback <tool> <version> # Full pipeline: check -> build -> release

System Management

dsr doctor                    # Check dependencies and auth
dsr doctor --fix              # Suggest fixes for issues
dsr health all                # Check all build hosts
dsr health check mmini        # Check specific host
dsr status                    # System + last run summary
dsr prune                     # Clean old artifacts/logs safely

Configuration

dsr config init               # Initialize configuration
dsr config show               # Show current configuration
dsr config get <key>          # Get specific setting
dsr config set <key> <val>    # Update setting
dsr repos list                # List all registered repos
dsr repos add <repo>          # Add a repository
dsr repos info <tool>         # Show repo details
dsr repos validate            # Validate all configs

Supply Chain Security

dsr signing init              # Generate minisign keypair
dsr signing sign <file>       # Sign a file
dsr signing verify <file>     # Verify signature
dsr sbom <project>            # Generate SBOM (SPDX/CycloneDX)
dsr slsa generate <artifact>  # Generate SLSA provenance
dsr slsa verify <artifact>    # Verify provenance
dsr quality <tool>            # Run pre-release quality checks

Testing & Verification

dsr canary run <tool>         # Test installer in Docker
dsr canary run --all          # Test all installers
dsr verify upgrade <tool>     # Verify upgrade command works
dsr release verify <tool> <v> # Verify release assets

Build Hosts

Host	Platform	Connection	Purpose
trj	Linux x64	local	Primary build host, act runner
mmini	macOS arm64	SSH via Tailscale	Native macOS builds
wlap	Windows x64	SSH via Tailscale	Native Windows builds

Common Workflows

Release When GH Actions is Throttled

# 1. Check throttling status
dsr check --all

# 2. Build locally if throttled
dsr build ntm --version 1.5.2

# 3. Upload to GitHub
dsr release ntm 1.5.2

# Or use fallback for full pipeline:
dsr fallback ntm 1.5.2

Health Check Before Building

# Check system dependencies
dsr doctor

# Check all build hosts are reachable
dsr health all

# Check specific host
dsr health check mmini

Configure a New Tool

# Add repository
dsr repos add dicklesworthstone/my-tool --local-path /data/projects/my-tool

# Validate configuration
dsr repos validate

# Test build
dsr build my-tool --dry-run

Clean Up Old Artifacts

# See what would be cleaned
dsr prune --dry-run

# Clean artifacts older than 30 days
dsr prune --age 30d

# Clean specific tool's artifacts
dsr prune --tool ntm

Exit Codes

Code	Name	Meaning
0	SUCCESS	Operation completed
1	PARTIAL_FAILURE	Some targets/repos failed
2	CONFLICT	Blocked by lock
3	DEPENDENCY_ERROR	Missing gh auth, docker, ssh
4	INVALID_ARGS	Bad options or config
5	INTERRUPTED	User abort or timeout
6	BUILD_FAILED	Compilation error
7	RELEASE_FAILED	Upload/signing failed
8	NETWORK_ERROR	Connectivity issue

JSON Output

All commands support --json for machine-readable output:

dsr check ntm --json | jq '.status'
dsr health all --json | jq '.hosts[] | select(.status == "unhealthy")'
dsr status --json | jq '.last_run'

Troubleshooting

SSH Connection Fails

# Check Tailscale status
tailscale status

# Test SSH manually
ssh -o ConnectTimeout=5 mmini "echo ok"

# Clear health cache and retry
dsr health clear-cache
dsr health check mmini

Build Fails

# Check toolchain versions
dsr doctor --fix

# Check host-specific toolchain
dsr health check trj --json | jq '.toolchains'

# Try building with verbose output
dsr build ntm --verbose

Release Upload Fails

# Check gh authentication
gh auth status

# Verify release doesn't already exist
gh release view v1.5.2 --repo Dicklesworthstone/ntm

# Resume interrupted upload
dsr release ntm 1.5.2 --resume

Docker/Act Issues

# Check Docker is running
docker info

# Check act installation
act --version

# On macOS, ensure Colima is running
colima status

Configuration Files

~/.config/dsr/
├── config.yaml           # Main configuration
└── repos.d/
    └── *.yaml            # Per-repo build configs

~/.local/state/dsr/
├── logs/                 # Run logs
├── artifacts/            # Build artifacts
└── manifests/            # Build manifests

~/.cache/dsr/
├── act/                  # Act Docker layer cache
└── builds/               # Cached build artifacts

Integration with Beads

When working on dsr-related beads:

# Check for ready dsr tasks
br ready | grep dsr

# Update status
br update bd-1jt.x.y --status in_progress