# Release Workflow

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

## Flowchart

```mermaid
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.)