Skip to content

Require the 3063 asset event as proof of a Zapstore publish - #93

Closed
rossigee wants to merge 1 commit into
masterfrom
docs/checklist-require-3063
Closed

rossigee wants to merge 1 commit into
masterfrom
docs/checklist-require-3063

Conversation

@rossigee

@rossigee rossigee commented Oct 6, 2026

Copy link
Copy Markdown
Owner

The gap this closes

Step 7 of the release checklist says to confirm the Zapstore publish by looking for:

published kind 32267 ...

That is the wrong line. 32267 is the release description, published first and
independently of the asset event — so it succeeds in exactly the runs that leave the
listing broken. The event carrying the APK is 3063.

Two releases have now failed with 32267 present in the log:

Release What happened Symptom
v2.1.2 Relay rejected 3063 for a missing version_code tag; the action awaited an array of promises rather than the promises, so the rejection surfaced as noise. Run exited 0. Release event pointing at an asset the relay never stored. Install greyed out.
v2.2.0 Relay stopped responding after the screenshot uploads; the action gave up after ~4s with publish timed out. No 3063. Same broken listing. Transient — completed on the first re-run.

A checklist that tells you to look for the line that is most likely to be there when
something is broken
is worse than no check, because it manufactures false confidence.

What it says now

All four kinds, in the order they appear, with an explicit instruction not to accept
32267 as proof. It also documents the remedy and why it is safe: re-run the failed job
with gh run rerun <id> --failed. The step is idempotent — it republishes the release
description and re-uploads the same content-addressed assets.

Documentation only.

The checklist step told me to look for "published kind 32267". That is
the release description, and it is published first and independently of
the asset event, so it succeeds in exactly the runs that leave the
listing broken.

The line that carries the APK is 3063. Two releases have now failed
with 32267 present in the log:

- v2.1.2: the relay rejected the 3063 event for a missing version_code
  tag and the action swallowed the rejection, so the run exited 0. The
  listing had a release event pointing at an asset the relay did not
  have, leaving Install greyed out.
- v2.2.0: the relay stopped responding after the screenshot uploads and
  the action gave up after about four seconds with "publish timed out".
  No 3063. Same broken listing. The re-run completed on the first
  attempt, so it was transient.

The step now lists all four kinds in the order they appear and says
plainly not to accept 32267 as proof. It also documents the re-run
remedy, which is idempotent: the release description is republished and
the same content-addressed assets are re-uploaded.
@github-actions

github-actions Bot commented Oct 6, 2026

Copy link
Copy Markdown

🤖 Automated Code Review

@rossigee

rossigee commented Oct 6, 2026

Copy link
Copy Markdown
Owner Author

Agreed, this belongs in zapstore-publish, not here.

Documenting event kinds (32267/3063/30063) and the relay's version_code requirement in this repo's checklist leaks the action's internals into the wrong repository. It will also rot the moment the action changes how it reports.

Closing and replacing with a thin version that only asserts what this repo owns: that the publish step passed, that zapstore.yaml's own invariants hold, and that anything deeper is a zapstore-publish issue.

@rossigee rossigee closed this Oct 6, 2026
@rossigee
rossigee deleted the docs/checklist-require-3063 branch October 6, 2026 06:31
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