chore: tightening and bump v21.3.0

Signed-off-by: rezky_nightky <130107241+oxyzenQ@users.noreply.github.com>

── bmi/main · cb3e763f6ef2 · 7 file · +51/-26 · 2026-06-03T11:18:26Z

Author: oxyzenQ

.github/RELEASE.md

@@ -50,7 +50,7 @@ bun run verify
 
 ### 2. Update Version Strings
 
-Use the canonical update script to synchronize the version across `package.json`, `README.md`, and `LICENSE.md`:
+Use the canonical update script to synchronize the version across `package.json`, `README.md`, and `DORMANT.md`:
 
 ```bash
 # Preview changes before applying

.github/workflows/release.yml

@@ -194,7 +194,7 @@ jobs:
 
           # Copy documentation
           cp README.md "$STAGE/" 2>/dev/null || true
-          cp LICENSE.md "$STAGE/" 2>/dev/null || true
+          cp LICENSE "$STAGE/"
           cp SECURITY.md "$STAGE/" 2>/dev/null || true
 
           # Create source zip
@@ -222,7 +222,7 @@ jobs:
           cp package.json "$STAGE/"
           cp README.md "$STAGE/" 2>/dev/null || true
           cp -r docs "$STAGE/" 2>/dev/null || true
-          cp LICENSE.md "$STAGE/" 2>/dev/null || true
+          cp LICENSE "$STAGE/"
 
           # Create build zip
           cd "$STAGE"
@@ -301,7 +301,7 @@ jobs:
             echo ""
             echo "## 📄 License"
             echo ""
-            echo "This project is licensed under the GPL v3 License. See the [LICENSE.md](LICENSE.md) file for details."
+            echo "This project is licensed under the GPL v3 License. See the [LICENSE](LICENSE) file for details."
             echo ""
             echo "## 🙏 Acknowledgments"
             echo ""

DORMANT.md

@@ -5,7 +5,7 @@ This guide is the wake-up checklist for BMI Stellar after a quiet period of 1-5
 ## Current Capsule
 
 - App: BMI Stellar
-- Version: `21.2.0`
+- Version: `21.3.0`
 - Runtime: Bun `1.3.11` from `package.json#packageManager`
 - Node range: `>=22 <25`
 - Framework: SvelteKit 2, Svelte 5, TypeScript

README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <img src="static/assets/new_bmi_logo_2026.webp" alt="BMI Stellar logo" width="240">
 
-  <h1>BMI Stellar v21.2</h1>
+  <h1>BMI Stellar v21.3</h1>
 
   <p>
     <strong>Privacy-first BMI, TDEE, body-fat, and progress tracking.</strong>
@@ -15,8 +15,8 @@
     <a href="https://bmi-stellar.vercel.app">
       <img src="https://img.shields.io/badge/live-demo-7C3AED?style=flat-square&logo=vercel&logoColor=white&labelColor=111827" alt="Live demo">
     </a>
-    <img src="https://img.shields.io/badge/version-v21.2-7C3AED?style=flat-square&labelColor=111827" alt="Version v21.2">
-    <a href="LICENSE.md">
+    <img src="https://img.shields.io/badge/version-v21.3-7C3AED?style=flat-square&labelColor=111827" alt="Version v21.3">
+    <a href="LICENSE">
       <img src="https://img.shields.io/badge/license-GPL--3.0-6D28D9?style=flat-square&labelColor=111827" alt="GPL-3.0 license">
     </a>
     <a href="https://github.com/sveltejs/svelte">
@@ -157,7 +157,7 @@ docs/                        # Long-form documentation (furthermore.md)
 The canonical version lives in `package.json` and is synchronized into display documents via `scripts/bmi-update-version.ts`.
 
 > [!IMPORTANT]
-> Always use `bun run bmi-update-version <version>` to update the version. This keeps `package.json`, `README.md`, and `LICENSE.md` synchronized. Never edit release version strings manually.
+> Always use `bun run bmi-update-version <version>` to update the version. This keeps `package.json`, `README.md`, and the dormant maintenance capsule synchronized. Never edit release version strings manually.
 
 Release tags follow the format `Stellar-v<major>.<minor>` (for example, `Stellar-v21.0`). The tag's major/minor pair must match `package.json` (for example, `21.0.0` -> `Stellar-v21.0`).
 
@@ -194,4 +194,4 @@ _Support is completely optional, and the project will forever remain open-source
 
 ## License
 
-Distributed under the GPL-3.0 License. See [LICENSE.md](LICENSE.md) for more information.
+Distributed under the GPL-3.0 License. See [LICENSE](LICENSE) for more information.

docs/furthermore.md

@@ -309,7 +309,7 @@ GitHub workflows are located in `.github/workflows/`.
 # Preview changes before applying
 bun run bmi-update-version --dry-run <version>
 
-# Apply version update (syncs package.json, README.md, and LICENSE.md)
+# Apply version update (syncs package.json, README.md, and DORMANT.md)
 bun run bmi-update-version <version>
 
 # Verify integrity before tagging

package.json

@@ -1,7 +1,7 @@
 {
 	"name": "bmi-stellar",
 	"private": true,
-	"version": "21.2.0",
+	"version": "21.3.0",
 	"type": "module",
 	"scripts": {
 		"dev": "vite dev --host",

scripts/bmi-update-version.ts

@@ -14,11 +14,11 @@
  *
  * Canonical version sources after dynamic-version refactor:
  *   - package.json                    (version)
- *   - README.md                       (display title)
- *   - LICENSE.md                      (display title)
+ *   - README.md                       (display title + badge)
+ *   - DORMANT.md                      (maintenance capsule version)
  */
 
-import { readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -58,6 +58,10 @@ function read(relPath: string): string {
 	}
 }
 
+function exists(relPath: string): boolean {
+	return existsSync(resolve(ROOT, relPath));
+}
+
 function write(relPath: string, content: string): void {
 	writeFileSync(resolve(ROOT, relPath), content, 'utf-8');
 }
@@ -69,6 +73,11 @@ function replaceOrWarn(
 	label: string,
 	dryRun: boolean
 ): void {
+	if (!exists(relPath)) {
+		console.log(`    \x1b[33m⚠ ${relPath} not found — skipped\x1b[0m`);
+		return;
+	}
+
 	const original = read(relPath);
 	if (!pattern.test(original)) {
 		console.log(`    \x1b[33m⚠ ${label} not found in ${relPath} — skipped\x1b[0m`);
@@ -93,9 +102,12 @@ function getCurrentVersion(): string {
 
 function updatePackageJson(newVersion: string, dryRun: boolean): void {
 	const raw = read('package.json');
-	const pkg = JSON.parse(raw) as Record<string, unknown>;
-	pkg.version = newVersion;
-	if (!dryRun) write('package.json', `${JSON.stringify(pkg, null, 2)}\n`);
+	const updated = raw.replace(/("version"\s*:\s*")\d+\.\d+\.\d+(")/, `$1${newVersion}$2`);
+	if (updated === raw) {
+		console.log('    \x1b[36m•\x1b[0m package.json version already current');
+		return;
+	}
+	if (!dryRun) write('package.json', updated);
 	console.log('    \x1b[32m✓\x1b[0m package.json version updated');
 }
 
@@ -134,9 +146,8 @@ function main(): void {
 	console.log('');
 
 	if (currentVersion === nextVersion) {
-		console.log('\x1b[33m  No changes: package.json already at target version.\x1b[0m');
+		console.log('\x1b[33m  package.json already at target version; syncing display files.\x1b[0m');
 		console.log('');
-		return;
 	}
 
 	console.log('  \x1b[33m→\x1b[0m package.json');
@@ -150,13 +161,27 @@ function main(): void {
 		'README display version',
 		dryRun
 	);
+	replaceOrWarn(
+		'README.md',
+		/badge\/version-v\d+\.\d+(?:\.\d+)?-/g,
+		`badge/version-v${nextShort}-`,
+		'README version badge',
+		dryRun
+	);
+	replaceOrWarn(
+		'README.md',
+		/alt="Version v\d+\.\d+(?:\.\d+)?"/g,
+		`alt="Version v${nextShort}"`,
+		'README version badge alt text',
+		dryRun
+	);
 
-	console.log('  \x1b[33m→\x1b[0m LICENSE.md');
+	console.log('  \x1b[33m→\x1b[0m DORMANT.md');
 	replaceOrWarn(
-		'LICENSE.md',
-		/BMI Stellar\s*[–-]\s*v\d+\.\d+(?:\.\d+)?/g,
-		`BMI Stellar – v${nextShort}`,
-		'LICENSE display version',
+		'DORMANT.md',
+		/Version: `\d+\.\d+\.\d+`/g,
+		`Version: \`${nextVersion}\``,
+		'DORMANT capsule version',
 		dryRun
 	);