Release And Versioning

Wavemap currently uses traceability-first release hygiene rather than semantic product releases.

Current Rule

For deployed dev:

deploymentVersion = imageTag = sha-<full-git-sha>

Short SHAs are display-only. GitHub workflow runs identify execution. Package and app versions remain metadata.

Identity Layers

Layer	Answers	Current Shape
Source and build	What code produced this?	Selected ref, full Git SHA, short display SHA, workflow run metadata.
Artifact	What deployable artifact was built?	Backend and frontend images tagged with sha-<full-git-sha>.
Deployment	What did the environment attempt to run?	Deployment version, image pair, runtime release receipt.
Product release	What human release is this?	Deferred until beta, staging, production, public docs, or package publication.

Deferred

• Git tags for routine develop merges.
• GitHub Deployment Records.
• Semantic app release versions.
• Generated release notes.
• Formal changelogs.
• Docs release-note publishing.