Skip to content

docs: version distributable artifacts - #61

Merged
DerekCorniello merged 3 commits into
mainfrom
docs/artifact-versioning
Aug 31, 2026
Merged

docs: version distributable artifacts#61
DerekCorniello merged 3 commits into
mainfrom
docs/artifact-versioning

Conversation

@DerekCorniello

Copy link
Copy Markdown
Contributor

Summary

  • adopt artifact-based SemVer instead of versioning every repository
  • define immutable commit and image-digest identity for rolling repos and deployments
  • add the release-manifest policy and supersede the old independent-versioning decision

Verification

  • python3 scripts/ci/check-docs.py
  • python3 -m unittest discover -s scripts/tests -p 'test_*.py'\n\nThis is documentation and governance only. No release, tag, deployment, or product code change.

@greptile-apps

greptile-apps Bot commented Aug 31, 2026

Copy link
Copy Markdown

Greptile Summary

The PR replaces repository-wide independent versioning with artifact-based versioning and defines immutable identities for rolling deployments.

  • Adds ADR 0007 and supersedes the prior independent-versioning policy.
  • Defines the GitHub Release body as the compiler release manifest.
  • Splits manifest recording into build-time and post-deployment phases.
  • Aligns the release guide, glossary, ADR index, README, and agent index with the new policy.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
docs/decisions/0007-artifact-versioning.md Establishes artifact-based SemVer and immutable identities for source-only repositories and deployments.
docs/release-process.md Updates release procedures and resolves both prior manifest concerns by defining phased recording and a canonical GitHub Release destination.
docs/decisions/0002-independent-versioning.md Marks independent repository versioning as superseded while retaining the compiler’s canonical version role.
docs/decisions/0004-runtime-resolved-from-source.md Aligns runtime source pinning terminology with artifact-based versioning.
docs/glossary.md Updates runtime identity terminology from an independent version to the exact locked commit.
README.md Updates the release-process description to reflect distributable artifact versioning.
docs/decisions/README.md Indexes ADR 0007 and records ADR 0002 as historical.
llms.txt Keeps the agent-facing release-process index synchronized with the new terminology.

Reviews (3): Last reviewed commit: "docs: store manifests with compiler rele..." | Re-trigger Greptile

Comment thread docs/release-process.md
Comment thread docs/release-process.md
@sonarqubecloud

Copy link
Copy Markdown

@DerekCorniello
DerekCorniello merged commit a470d64 into main Aug 31, 2026
4 checks passed
@DerekCorniello
DerekCorniello deleted the docs/artifact-versioning branch August 31, 2026 14:38
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