Skip to content

docs(auth): define BUZZ-516 upgrade acceptance - #8983

Draft
bradseiler wants to merge 16 commits into
mainfrom
seiler/BUZZ-516/upgrade-acceptance
Draft

bradseiler wants to merge 16 commits into
mainfrom
seiler/BUZZ-516/upgrade-acceptance

Conversation

@bradseiler

@bradseiler bradseiler commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Community NIP-FI upgrades need evidence that identity is preserved, unrelated communities retain their expected access, and active status follows actual target drain. This adds the BUZZ-516 acceptance procedure, failure matrix and evidence requirements.

The mode matrix follows the owner’s revised contract: Off performs no FI enforcement, including for stored-required communities; Shadow enforces stored requirements; Enforce requires FI everywhere. Off retains durable policy and receipts but cannot report active FI enforcement. The procedure covers missing dependencies, transitions back to Shadow, recovery after the default-off upgrade-admission gate closes, and the merged operator contract. Mode and upgrade-switch scenarios require a dedicated staging deployment with an explicit allowlist, transitions and incarnation obligations. Shared staging remains protected.

Every live matrix row remains blocked on the BUZZ-511 correction to the operator contract. deny_protected is a separate repair mode.

The harness receipt contract is pinned to an immutable source revision. Actual candidate artifacts, admitted routing/security policies, platform-config provenance, startup receipts and per-incarnation drain evidence remain required before live acceptance.

Incomplete draft: this PR contains the procedure only. Executable cross-component acceptance tests, current prerequisite validation, Postgres execution and live/render evidence remain outstanding. Component tests will be reused from their owning BUZZ-510–515 changes. This PR does not complete BUZZ-516.

Related issue

BUZZ-516. BUZZ-510 #8985 is merged. Admission/discovery #8988, activation #8991, and the remaining module, staging and harness prerequisites retain their own review and validation gates.

Testing

Documentation content, local links/anchors, cited source paths and diff checks were verified after rebase onto main af54258f19ac32667c027f889652bdeb479c8e13, which contains merged #8985. All 11 inherited patches replayed unchanged. This changes no runtime code; no application, package, PostgreSQL or staging tests were run for this revision. Skipped test jobs are unexecuted.

Historical local validation did not establish a full pass: the initial just ci stopped at mobile setup, the retry has no captured completion, and the PostgreSQL lane exited before discovery because its admin URL was unset. Those attempts are not evidence for the rebased revision.

No deployment, Job execution or live mutation is included. Human acceptance and independently reviewed prerequisite implementations remain required.

Generated with Codex

@bradseiler
bradseiler force-pushed the seiler/BUZZ-516/upgrade-acceptance branch 2 times, most recently from c5697d5 to a21e147 Compare November 4, 2026 16:27
bradseiler and others added 12 commits November 4, 2026 18:28
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Clarify that every acceptance row needs staging evidence.

Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
@bradseiler
bradseiler force-pushed the seiler/BUZZ-516/upgrade-acceptance branch from a21e147 to 8a0a788 Compare November 4, 2026 23:31
@bradseiler bradseiler changed the title docs(auth): draft BUZZ-516 upgrade acceptance procedure docs(auth): define BUZZ-516 upgrade acceptance Nov 4, 2026
bradseiler and others added 4 commits November 4, 2026 18:36
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>
Signed-off-by: Brad Seiler <seiler@squareup.com>

This branch has not been deployed

No deployments
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