Skip to content

docs(release-runbook): SignPath timeout recovery — reject stale, approve newest early (MCP-2906)#719

Merged
Dumbris merged 1 commit into
mainfrom
docs/mcp-2906-signpath-timeout-runbook
Jun 19, 2026
Merged

docs(release-runbook): SignPath timeout recovery — reject stale, approve newest early (MCP-2906)#719
Dumbris merged 1 commit into
mainfrom
docs/mcp-2906-signpath-timeout-runbook

Conversation

@Dumbris

@Dumbris Dumbris commented Jun 19, 2026

Copy link
Copy Markdown
Member

Summary

Adds operational guidance to SPOF 2 in docs/release-runbook.md so operators don't repeat the v0.41.2 signing failures (3 of 4 attempts timed out at exactly 01:01:14).

What changed

Before: Recovery section said "use the Retry Sign & Release workflow" — which is currently broken (see MCP-2905).

After: 4-step protocol grounded in what actually worked during v0.41.2:

  1. gh run rerun <run-id> --failed — not the retry workflow
  2. Reject all stale WaitingForApproval SignPath requests first — each rerun creates a new one; approving a stale request does nothing
  3. Approve the newest request within ~5–10 minutes — the action's poll backoff (few sec → 1m → 3m → 5m → 11m → 20m → 20m) makes late approvals unreliable
  4. Confirm in the job log — look for transition from WaitingForApproval to "Prepare signed installer"

Also:

  • Replaces inaccurate Option B description (claimed the retry workflow assembled a "complete" asset set) with a clear warning cross-referencing MCP-2905
  • Adds SLSA provenance note for the rerun --failed path

Acceptance criteria from MCP-2906

  • SPOF 2 documents timeout-recovery steps (reject stale + approve newest + approve early + use rerun --failed)
  • Cross-references the retry-sign-release.yml incompleteness issue (MCP-2905)

Testing

Doc-only change. No code path affected.

… (MCP-2906)

- Replace misleading 'use Retry Sign & Release' guidance with gh run rerun --failed
- Add 4-step approval protocol: rerun → reject stale requests → approve newest early → confirm in log
- Document SignPath poll backoff schedule (~few sec → 1m → 3m → 5m → 11m → 20m repeating)
- Warn operators to approve within first 5-10 minutes while polls are frequent
- Cross-reference MCP-2905 with warning that retry-sign-release.yml is broken (ships ~6 assets vs ~27)
- Add SLSA provenance note for gh run rerun path
- Observed failure pattern: v0.41.2 hit this 3 times at exactly 01:01:14

Co-Authored-By: Paperclip <noreply@paperclip.ing>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying mcpproxy-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 0dd7831
Status: ✅  Deploy successful!
Preview URL: https://d0e03e31.mcpproxy-docs.pages.dev
Branch Preview URL: https://docs-mcp-2906-signpath-timeo.mcpproxy-docs.pages.dev

View logs

@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@github-actions

Copy link
Copy Markdown

📦 Build Artifacts

Workflow Run: View Run
Branch: docs/mcp-2906-signpath-timeout-runbook

Available Artifacts

  • archive-darwin-amd64 (28 MB)
  • archive-darwin-arm64 (25 MB)
  • archive-linux-amd64 (16 MB)
  • archive-linux-arm64 (14 MB)
  • archive-windows-amd64 (28 MB)
  • archive-windows-arm64 (25 MB)
  • frontend-dist-pr (0 MB)
  • installer-dmg-darwin-amd64 (21 MB)
  • installer-dmg-darwin-arm64 (19 MB)

How to Download

Option 1: GitHub Web UI (easiest)

  1. Go to the workflow run page linked above
  2. Scroll to the bottom "Artifacts" section
  3. Click on the artifact you want to download

Option 2: GitHub CLI

gh run download 27803557365 --repo smart-mcp-proxy/mcpproxy-go

Note: Artifacts expire in 14 days.

@Dumbris Dumbris merged commit c0e569a into main Jun 19, 2026
37 checks passed
@Dumbris Dumbris deleted the docs/mcp-2906-signpath-timeout-runbook branch June 19, 2026 06:42
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.

2 participants