Release Workflow

task-plus automates the release process for Go projects. The workflow runs through five phases: Precheck, Gather, Ask, Check, and Execute.

Flowchart

flowchart TD
    A[Start] --> B[Precheck]
    B --> C

    subgraph Gather [Phase 2: Gather]
        C[Read git status, tags, fork info]
    end

    C --> D

    subgraph Ask [Phase 3: Ask]
        D{Git Dirty?} -->|Yes| E[Prompt: Add + Commit]
        D -->|No| F[Ask Version]
        E --> F
        F --> F2[Confirm push, goreleaser, install, deploy]
    end

    F2 --> G

    subgraph Check [Phase 4: Check]
        G[Run fmt, vet, test]
    end

    G --> H

    subgraph Execute [Phase 5: Execute]
        H[Update CHANGELOG + commit] --> I[Git Tag]
        I --> J{WASM?}
        J -->|Yes| K[Build WASM + Re-tag]
        J -->|No| L[Git Push]
        K --> L
        L --> M{Binary?}
        M -->|Yes| N[Goreleaser]
        M -->|No| O[Cleanup]
        N --> O
        O --> P{Fork?}
        P -->|Yes| Q[Skip Install]
        P -->|No| R[Install]
        Q --> T{Deploy Docs?}
        R --> T
        T -->|Yes| U[Build + Deploy Docs]
        T -->|No| S[Done]
        U --> S
    end

Phases

1. Precheck

Runs any configured precheck commands (e.g. task precheck). Fails fast before user interaction.

2. Gather

Read-only state probing:

• Git status (dirty/clean)
• Existing tags and retracted versions
• Suggested next version (auto-incremented, skipping retracted)
• Fork detection (go.mod vs git remote)
• Goreleaser config detection
• Forge detection (GitHub/GitLab/Forgejo) and release cleanup candidates

3. Ask

Interactive prompts:

• Git add/commit if dirty
• Version confirmation (suggested or custom)
• Release comment
• Push, goreleaser, cleanup, install, deploy confirmations

4. Check

Runs configured check commands (default: task check which runs fmt, vet, test).

5. Execute

All mutations in order:

1. Git add + commit (if dirty)
2. Tag existence check
3. Version update task (if configured)
4. CHANGELOG update + auto-commit
5. Git tag
6. WASM build + re-tag (if configured)
7. Git push
8. Goreleaser (binary projects)
9. Release cleanup (old releases)
10. Local install (go install)
11. Documentation deployment (configured targets: GitHub Pages, statichost.eu, etc.)