Skip to content

Commit 6260680

Browse files
committed
Bump to v0.8.0 and codify iteration/versioning rules
1 parent 01acaed commit 6260680

5 files changed

Lines changed: 28 additions & 3 deletions

File tree

AGENTS.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,3 +16,4 @@
1616
- Do not start user-added backlog items without explicit user confirmation in the current thread.
1717
- After every live deploy, monitor Cloudflare Pages deployment status (`wrangler pages deployment list --project-name linksim`) and explicitly notify the user when deployment is complete.
1818
- Follow and maintain `docs/release-flow.md` as the source of truth for release promotion steps.
19+
- Follow `docs/release-flow.md` versioning policy (SemVer + explicit bump rules) for all releases.

docs/release-flow.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,3 +20,27 @@
2020
- No direct production hotfixes unless explicitly requested by the user.
2121
- Always report deployed commit SHA for staging and production.
2222
- Keep clear non-production indicators enabled for local/staging environments.
23+
24+
## Versioning Policy
25+
- SemVer is mandatory (`MAJOR.MINOR.PATCH`).
26+
- Current baseline: `0.8.0` (feature-rich beta, stabilization phase).
27+
- Bump rules:
28+
- `PATCH` (`0.8.x`): bug fixes, polish, non-breaking UX updates, test/docs-only improvements.
29+
- `MINOR` (`0.x.0`): new user-facing capabilities or meaningful workflow additions.
30+
- `MAJOR` (`1.0.0+`): stable production contract changes or first declared stable release.
31+
- Version bump timing:
32+
- Bump before staging promotion for the release candidate.
33+
- Promote the exact same version/commit from staging to production.
34+
- Every release note in commit/PR should state:
35+
- version,
36+
- commit SHA,
37+
- environment promoted (`staging` or `production`).
38+
39+
## Iteration Rules
40+
- Default loop for every task:
41+
1. Implement in local test.
42+
2. Verify (`npm test`, `npm run build`, manual QA).
43+
3. Commit and push.
44+
4. Deploy to staging and verify.
45+
5. Promote to production only with explicit approval.
46+
- No hidden scope changes during promotion; if code changes after staging verification, restart the loop.

functions/_lib/buildInfo.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
export const APP_VERSION = "0.0.0";
2-
export const APP_COMMIT = "df26fad2";
2+
export const APP_COMMIT = "01acaed9";
33
export const APP_BUILD_LABEL = `v${APP_VERSION}+${APP_COMMIT}`;

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "linksim",
33
"private": true,
4-
"version": "0.0.0",
4+
"version": "0.8.0",
55
"license": "GPL-3.0-only",
66
"type": "module",
77
"scripts": {

src/lib/buildInfo.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
export const APP_VERSION = "0.0.0";
2-
export const APP_COMMIT = "df26fad2";
2+
export const APP_COMMIT = "01acaed9";
33
export const APP_BUILD_LABEL = `v${APP_VERSION}+${APP_COMMIT}`;

0 commit comments

Comments
 (0)