Skip to content

docs(changelog): M90_002 — terminal gate writes, strand recovery, loss-proof webhooks#85

Merged
indykish merged 3 commits into
mainfrom
chore/m90-002-event-lifecycle-changelog
Jun 11, 2026
Merged

docs(changelog): M90_002 — terminal gate writes, strand recovery, loss-proof webhooks#85
indykish merged 3 commits into
mainfrom
chore/m90-002-event-lifecycle-changelog

Conversation

@indykish

@indykish indykish commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Changelog entry for M90_002 (usezombie PR #394). Jun 11, 2026.

Leads with the user-facing change: events refused by a lease gate now end in a visible gate_blocked row with a named failure_label instead of stranding silently; stranded deliveries recover; webhook enqueue failures stay deliverable on retry. API: steering a paused zombie returns 409 UZ-ZMB-012 with current_state; paused webhooks return 200 {"ignored":"zombie_paused"} (UZ-WH-003 retired).

Voice: one headline, no marketing words, **Bold lead-noun** bullets, error codes + endpoints kept verbatim. History append-only (new entry above the Jun 11 egress entry, same date).

🤖 Generated with Claude Code

Greptile Summary

Adds the M90_002 changelog entry documenting terminal gate writes, strand recovery, and loss-proof webhooks. The new <Update> block is placed correctly above the other Jun 11 entries; terminology ("agent", "activity stream") and section order (What's new → API reference → Bug fixes) are all correct after the prior-round fixes.

  • Missing \"What's new\" tag — the tags array reads [\"Bug fixes\", \"API\"] but the block opens with a ## What's new section; every comparable entry includes \"What's new\" in its tags.
  • Content is accurate — error codes, endpoint paths, field names (gate_blocked, failure_label, zombie_paused, UZ-ZMB-012, UZ-WH-003), and prose all match the PR description without introducing forbidden terminology.

Confidence Score: 4/5

Safe to merge after adding "What's new" to the tags array — the content itself is correct and well-formed.

The only defect is the tags array on the new <Update> block omitting "What's new" while the block itself opens with a ## What's new section. This causes the entry to be invisible to readers filtering the changelog by that tag. One-word fix; nothing else is wrong with the entry.

changelog.mdx — the tags attribute on the new Update block at line 25.

Important Files Changed

Filename Overview
changelog.mdx New M90_002 Update block added above the Jun 11 egress entry; terminology and section order are correct, but the tags array omits "What's new" despite the block containing a ## What's new section.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Webhook event received] --> B{Idempotency check}
    B -- Genuine duplicate --> C[Deduped — no action]
    B -- New event --> D{Enqueue to runner queue}
    D -- Transient failure --> E[Slot NOT consumed\nSender retry delivers normally]
    D -- Success --> F{Lease gate evaluation}
    F -- Credential missing --> G[terminal: gate_blocked\nfailure_label: secret_missing]
    F -- Approval denied/expired --> H[terminal: gate_blocked\nfailure_label: approval_denied / approval_expired]
    F -- Balance exhausted --> I[terminal: gate_blocked\nfailure_label: balance_exhausted]
    F -- Gate passed --> J{Runner alive?}
    J -- Runner retired/crashed --> K[Reclaim & re-lease\nStranded delivery recovers]
    K --> F
    J -- Runner healthy --> L[Run executes normally]

    M[POST /zombies/id/messages\nto paused agent] --> N[409 UZ-ZMB-012\nwith current_state + resume hint]
    O[Webhook to paused agent] --> P[200 ignored: zombie_paused\nIdempotency slot preserved]
Loading

Reviews (3): Last reviewed commit: "Merge remote-tracking branch 'origin/mai..." | Re-trigger Greptile

Context used:

  • Context used - AGENTS.md (source)

…s-proof webhooks

Jun 11, 2026 entry: events refused by a lease gate now end in a visible
gate_blocked row with a named failure_label instead of stranding; stranded
deliveries recover; webhook enqueue failures stay deliverable on retry;
steering a paused zombie returns 409 UZ-ZMB-012 with current_state; paused
webhooks return 200 ignored zombie_paused (UZ-WH-003 retired).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jun 11, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
megam 🟢 Ready View Preview Jun 11, 2026, 6:00 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Comment thread changelog.mdx Outdated
Comment thread changelog.mdx Outdated
Sections back to the fixed order (What's new -> API reference -> Bug
fixes); prose "zombie" -> "agent" in three bullets (wire tokens like
zombie_paused and route paths stay); "events history" -> the canonical
"activity stream" for the append-only event record.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@indykish indykish merged commit 2558d27 into main Jun 11, 2026
4 checks passed
@indykish indykish deleted the chore/m90-002-event-lifecycle-changelog branch June 11, 2026 18:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant