Skip to content

docs(ops): add Home delivery contract - #90

Merged
compaii merged 1 commit into
mainfrom
ops/ops-f-home-delivery-contract
Sep 10, 2026
Merged

compaii merged 1 commit into
mainfrom
ops/ops-f-home-delivery-contract

Conversation

@compaii

@compaii compaii commented Sep 10, 2026

Copy link
Copy Markdown
Collaborator

Outcome

Add a versioned operating, delivery, and recovery contract for the Beacon Home surface without changing rendered product behavior.

This is the Home adapter for AlterMundi/harmonic-beacon-webapp#537. It references that roadmap card but does not close it; Account, Listen, analytics, Authority/PMP, staging recovery, and cross-surface acceptance remain separate work.

Changes

  • Add one stable non-visible delivery marker to the root index.html.
  • Document the current legacy main:/ GitHub Pages source and CI/build contract.
  • Define source/deployment fingerprints and public HTTP/marker verification.
  • Define rollback through a revert PR and Pages republish.
  • State explicitly that staging and alert-recipient proof do not currently exist.
  • State the future repository-admin action required to migrate Pages to a dedicated deployment workflow.
  • Link the contract from README and supersede the remembered one-line deploy procedure.
  • Add executable contract tests that prevent claims that CI dist is currently deployed, prevent invented staging, preserve existing tests/build/manifest checks, and prove marker uniqueness/non-visibility.

Verification

  • Focused Home delivery-contract tests: 4/4 passed.
  • Full test suite: 112/112 passed.
  • Production build: passed.
  • Built dist/index.html contains the exact marker once and preserves it as a non-visible HTML comment.
  • Independent exact-commit review: APPROVE.
  • git diff --check: passed.

Exact candidate

  • Head: 7a20e6439ca1b002b975724e97070c9d6217db6e
  • Tree: 3660085877643a1ab11672d4982004d7760aa88f
  • Base: 2e73d62a8fdd45030e4019a55b614e234a5202a3
  • Binary/full-index delta SHA-256: 44dfc822b6a2bcb1e5c067d011b0be6468a38b5118624d6bc8b6cc082078bd58

Non-goals

No Pages setting, deployment workflow, DNS, analytics, registration/payment behavior, dependency, generated media, or visible product copy is changed.

Refs AlterMundi/harmonic-beacon-webapp#537

@compaii
compaii merged commit b6b6b09 into main Sep 10, 2026
1 check passed
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