--- name: dsr description: "Doodlestein Self-Releaser - Fallback release infrastructure for building and releasing tools locally when GitHub Actions is throttled. Cross-platform builds via SSH, supply chain security (SLSA\/SBOM\/signing), quality gates, and offline capability." --- # 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 ```bash dsr check # Check if GH Actions is throttled dsr check --all # Check all configured repos dsr build # Build locally for all targets dsr release # Upload artifacts to GitHub dsr fallback # Full pipeline: check -> build -> release ``` ### System Management ```bash 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 ```bash dsr config init # Initialize configuration dsr config show # Show current configuration dsr config get # Get specific setting dsr config set # Update setting dsr repos list # List all registered repos dsr repos add # Add a repository dsr repos info # Show repo details dsr repos validate # Validate all configs ``` ### Supply Chain Security ```bash dsr signing init # Generate minisign keypair dsr signing sign # Sign a file dsr signing verify # Verify signature dsr sbom # Generate SBOM (SPDX\/CycloneDX) dsr slsa generate # Generate SLSA provenance dsr slsa verify # Verify provenance dsr quality # Run pre-release quality checks ``` ### Testing & Verification ```bash dsr canary run # Test installer in Docker dsr canary run --all # Test all installers dsr verify upgrade # Verify upgrade command works dsr release verify # 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 ```bash # 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 ```bash # 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 ```bash # 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 ```bash # 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: ```bash 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 ```bash # 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 ```bash # 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 ```bash # 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 ```bash # 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: ```bash # Check for ready dsr tasks br ready | grep dsr # Update status br update bd-1jt.x.y --status in_progress ```