Skip to content

Stage 3.1.17 custom-build support after the real tag - #290

Merged
ODevStudio merged 2 commits into
mainfrom
odev/custom-support-3.1.17
Nov 20, 2026
Merged

ODevStudio merged 2 commits into
mainfrom
odev/custom-support-3.1.17

Conversation

@ODevStudio

@ODevStudio ODevStudio commented Nov 20, 2026 •

Copy link
Copy Markdown
Collaborator

Hold: Real Tag Required

This is an intentionally held rollout draft, not another original PR to merge during pre-tag preparation. Do not merge/deploy it until the separately authorized real v3.1.17 tag points to approved candidate 1efca39865dea78c7da0b15c845da6ab30228e8f, then regenerate/reverify catalogs against that real tag.

Pre-tag preparation is merged in #289. No real/shared/GitHub v3.1.17 tag or release has been created by this work.

Summary

  • Add backend v3.1.17 support to the existing registry, three plugin manifests, Worker allowlist and both generated catalogs.
  • Preserve every existing stable/preview source and patch. Public selector/default stays v3.1.16; direct browser selection of v3.1.17 remains rejected until separate activation.
  • Freeze plugins/pressensor/patches/v3.1.17.patch separately, byte-identical to approved main's moving patch: SHA-256 a820251bc97b93cfacf58c42b3ea6c3a9699b5a8cf545cd5493e72908460c16c. Existing v3.1.16.patch remains 9544f92b459288f332038e43cd061e4984575e32aa14ce2c436b603b4ebb80b6.
  • Permit the already-supported combined Pressensor/Grind-by-weight capability for the new source without weakening older-source conflicts.
  • Preserve 3.1.17-main-custom versus 3.1.17-custom, source/builder provenance, signing generation, permissions, BUILDER_REF=main, trusted dispatch and publication fences.
  • Extend only the established disposable-CI prospective-tag fixtures, never the trusted dispatch build's tag behavior.

Prospective Validation

A standalone clone with its own Git database, no remotes, no alternates/commondir and no Git-directory overrides was used. Its synthetic v3.1.17 points exactly to approved main 1efca39865dea78c7da0b15c845da6ab30228e8f. Both catalogs were generated there through the existing APIs; only reviewed outputs returned to this branch. The shared repository tag remained absent.

Passed locally in that fixture:

  • Catalog and plugin-CI contracts, including main and every historical/new Pressensor patch mapping.
  • Full custom execution/version-source identity matrix and cache transport contracts.
  • All 86 Worker/browser tests and AI documentation contract.
  • Complete raw-diff/whitespace checks, catalog-copy hashes, frozen-patch identity and independent review.

The Bash argument contract passed under host Git Bash; automatic Linux draft CI also passed actual old/new plugin/profile compilation. No local ESP-IDF rebuild was run.

Remaining Gates

Real-tag regeneration and patch/profile verification, production scoped-App lookups, hosted main/tagged version/source/builder identity, binary/ZIP hashes, production signatures and saved-build provenance remain required. No production job, assignment, deployment, secret change, flash, signing or publication was performed.

Public-default activation is a separate dependent draft after this support stage; it additionally requires release publication and service readiness. Existing signed recovery/history assets remain immutable.

Combined-Integration CI Coverage

The existing verifier compiles Pressensor alone, so this draft also runs the normal custom builder with both Pressensor and Grind-by-weight for main and prospective v3.1.17. These two matrix entries use disposable job-local signing keys, explicit candidate builder pins, candidate main-source pins, and an explicitly resolved tagged source SHA. No production upload, dispatch or publication path is added.

The extended argument contract passed all ten plugin/ref cases under host Git Bash, including distinct candidate/tag SHAs, older single-verifier cases and a non-Pressensor case. Actual combined compilation is an automatic exact-head CI gate, not a result inferred from selection-only unit tests.

Final Exact-Head CI Evidence

Head 6bdde226d15eb49842e0af6a37ee54a66333ef3f passed all relevant checks:

  • 44743101087: stock/grinder/LittleFS, Energy, native, Python and release-ready.
  • 44743101224: custom minimal and all five historical/new Pressensor source profiles.
  • 44743101051: OTA and cross-platform public-key checks.
  • 44743101157: configurator checks.

Actual combined Pressensor/Grind-by-weight builds succeeded for main (job 136311638669) and prospective v3.1.17 (job 136311638850); disposable-key generation and firmware compilation both passed. This is compilation evidence, not production signing or hardware acceptance.

The draft remains intentionally unmerged. No real v3.1.17 tag or release exists; the public default remains v3.1.16. The real-tag and production-readiness gates above are unchanged. Public-default activation remains separately held in #291.

@ODevStudio
ODevStudio marked this pull request as ready for review November 20, 2026 14:58
@ODevStudio
ODevStudio merged commit 0321d6b into main Nov 20, 2026
18 checks 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