go-release-tag-stale

Answer

Root cause. v0.1.0 was tagged 53 commits behind HEAD and its handlers shipped bodies that violated the OpenAPI contract (POST /cancel → {"status":"ok"}; DELETE /sessions/{id} → 204 No Content). Since go get @latest resolves the highest semver tag from the proxy/VCS tags — not HEAD — consumers kept pulling the stale, non-compliant build. The fix is two-layered: (1) make the wire bodies compliant at HEAD, (2) re-release a higher tag at HEAD so @latest resolves the fixed code.

1. Fix the wire bodies (api.go)

Before (shipped in v0.1.0):

// BUG: contract says {"cancelled","cancelled_decision_id"}; 404 when unknown
type cancelReply struct{ Status string `json:"status"` }

func (s *server) handleCancel(w http.ResponseWriter, r *http.Request) {
    ...
    writeJSON(w, http.StatusOK, cancelReply{Status: "ok"})   // always "ok"
}

// BUG: contract says 200 {"terminated","session_id"}
func (s *server) handleTerminate(w http.ResponseWriter, r *http.Request) {
    w.WriteHeader(http.StatusNoContent)                       // 204, empty body
}

After (the fix, tagged v0.1.1):

// CancelResponse: {"cancelled": true, "cancelled_decision_id": "..."}
type CancelResponse struct {
    Cancelled           bool   `json:"cancelled"`
    CancelledDecisionID string `json:"cancelled_decision_id"`
}
type TerminateResponse struct {
    Terminated bool   `json:"terminated"`
    SessionID  string `json:"session_id"`
}

func (s *server) handleCancel(w http.ResponseWriter, r *http.Request) {
    // ...decode req...
    if !s.knownDecision(req.DecisionID) {
        writeJSON(w, http.StatusNotFound, errorResponse{Error: "decision not found"})
        return
    }
    writeJSON(w, http.StatusOK, CancelResponse{Cancelled: true, CancelledDecisionID: req.DecisionID})
}

func (s *server) handleTerminate(w http.ResponseWriter, r *http.Request) {
    id := r.PathValue("id")
    writeJSON(w, http.StatusOK, TerminateResponse{Terminated: true, SessionID: id}) // 200, idempotent
}

Regression tests (api_test.go) assert: cancel body has cancelled+cancelled_decision_id and no status field, cancel-unknown → 404, delete → 200 with terminated+session_id.

2. CHANGELOG (CHANGELOG.md)

Rename the mislabeled header ## [1.0.0] → ## [0.1.0] (matches the actual tag), and prepend:

```markdown