✨ feat: Introduce "VERSIONING.md" for aligning on versioning the OS

[jpmcb]

• ✨ adds ability to read git rev version for builds
• 📚 adds VERSIONING.md to align on versioning the OS.

TLDR: uses CalVer and specific mixtape channels in the OCI registry.

---

Continue Tasks: ✅ 1 no changes — View all

[jpmcb]

• ✨ feat: Introduce "VERSIONING.md" for aligning on versioning the OS #22 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[jpmcb]

cc @bdougie - worth a quick read: this will have some very long term impacts as we roll and support versions for the lifecycle of stereOS.

[bdougie]

I did some reading up on CalVer and caught up on the approach. LGTM from here.

[jpmcb]

Validated:

[admin@coder:~]$ cat /etc/os-release
NAME="stereOS"
ID=stereos
ID_LIKE=nixos
VERSION="dev-1e4ffc9"
VERSION_ID="dev-1e4ffc9"
VERSION_CODENAME="coder"
PRETTY_NAME="stereOS dev-1e4ffc9 (coder)"
HOME_URL="https://github.com/papercomputeco/stereOS"
NIXOS_VERSION="25.11.20260225.1267bb4"

[admin@coder:~]$ opencode --version
1.2.13

[admin@coder:~]$ systemctl --version
systemd 258 (258.3)

Confirmed this is pulling in the unstable opencode but stable systemd

[continue]

No docs update needed. The documentation repository (stereos.ai) does not exist in the papercomputeco organization. This PR introduces:

• VERSIONING.md — internal documentation for CalVer versioning scheme already included in the repo itself
• Version identity changes — stereosVersion and gitRevision are now exposed in /etc/os-release, MOTD, and nixos-version
• nixpkgs split — stable nixos-25.11 for core system, nixpkgs-unstable for coding agents

All user-facing information is documented in the new VERSIONING.md file within this repository.

PR #22 was merged: ✨ feat: Introduce "VERSIONING.md" for aligning on versioning the OS
PR URL: #22
Merged by: jpmcb