Skip to content

Commit 13ba346

Browse files
committed
docs: record immutable release policy
1 parent eb9efdd commit 13ba346

3 files changed

Lines changed: 4 additions & 3 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -247,7 +247,7 @@ Code version: **v0.1.1**
247247

248248
Latest GitHub release: **[v0.1.1](https://github.com/mohsinht/zaati-os/releases/tag/v0.1.1)**, published August 25, 2026.
249249

250-
This foundation release establishes the portable data contract, atomic bundle ingestion, adaptive renderer, guided onboarding, provider-neutral prompts, optional encrypted storage, theme studio, privacy boundaries, Cloudflare recipe, and CI quality gates. Hosted LLM workflows remain contract-compatible rather than provider-certified until their recorded end-to-end gates pass. Private validators should pin the reviewed v0.1.1 release commit `0ef31dc8e973e5f1f557b1df9c7f79a012dd7d2a`; future signed and protected release tags may be used as immutable references. See [CHANGELOG.md](CHANGELOG.md).
250+
This foundation release establishes the portable data contract, atomic bundle ingestion, adaptive renderer, guided onboarding, provider-neutral prompts, optional encrypted storage, theme studio, privacy boundaries, Cloudflare recipe, and CI quality gates. Hosted LLM workflows remain contract-compatible rather than provider-certified until their recorded end-to-end gates pass. Private validators should pin the reviewed v0.1.1 release commit `0ef31dc8e973e5f1f557b1df9c7f79a012dd7d2a`; future signed, protected, and immutable releases may be used as stable references. See [CHANGELOG.md](CHANGELOG.md).
251251

252252
Before storing real data, read [Data lifecycle and key recovery](docs/data-lifecycle.md). Fork maintainers can follow [Upgrade and fork sync](docs/upgrading.md).
253253

docs/maintainer-setup.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ In repository Settings, Security and analysis:
1111
3. Enable secret scanning and push protection when available.
1212
4. Enable private vulnerability reporting.
1313
5. Add repository variable `DEPENDENCY_REVIEW_ENABLED=true`.
14+
6. Enable release immutability. GitHub applies it only to releases published after the setting is enabled.
1415

1516
The dependency review workflow remains safely skipped until that variable is set. This avoids a false failing check on new repositories where the dependency graph API is not yet active.
1617

@@ -26,7 +27,7 @@ After the first successful runs, protect `main`:
2627
- block force pushes and branch deletion
2728
- apply the rules to administrators unless an emergency procedure says otherwise
2829

29-
Create a second active ruleset targeting `refs/tags/v*`. Block tag updates and deletion, and create each release tag as a signed tag. A published release tag is an immutable validator reference only when both controls are in place.
30+
Create a second active ruleset targeting `refs/tags/v*`. Block tag updates and deletion, and create each release tag as a signed tag. Together with repository release immutability, these controls protect the tag, release metadata, and assets from later changes.
3031

3132
For every private data repository, add a second ruleset for `.github/**` and `zaati.data.json`. Require trusted-owner review and block the producer identity from bypassing it. The producer needs Contents and Pull requests write access only. It must have no Actions, Workflows, Administration, secrets, variables, environments, or repository-settings write access.
3233

docs/release-process.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,6 @@
77
5. Confirm GitHub Actions remain pinned to reviewed full commit SHAs.
88
6. Merge through the protected `Quality gate` and CodeQL checks.
99
7. Create and push a signed tag matching `vX.Y.Z`; the protected `v*` tag ruleset prevents later updates or deletion. Do not publish the GitHub release manually. The tag workflow reruns all checks before creating it.
10-
8. Verify the release notes, tag, assets, demo, and fork-upgrade instructions.
10+
8. Verify the release notes, signed and protected tag, immutable-release status, assets, demo, and fork-upgrade instructions.
1111

1212
Do not create a release when the complete-source, privacy, or independent-publication gates are failing. A shiny tag is not a security control, although it does look fetching.

0 commit comments

Comments
 (0)