# Dsr > Doodlestein Self-Releaser - fallback release infrastructure for when GitHub Actions is throttled. Local builds, cross-platform releases, supply chain security. Use when: GH Actions slow, local release, build hosts, dsr command. - Skill: `lev-os/dsr` (Agent Skill) - Install (CLI): `npx skillmds@latest add lev-os/dsr` - Raw SKILL.md: https://api.skillmd.com/api/skills/lev-os/dsr/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Security - Author: lev-os (https://skillmd.com/u/lev-os) - Updated: 2026-09-10 - Page: https://skillmd.com/skills/lev-os/dsr --- # 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 ```