diff --git a/docs-site/.gitignore b/docs-site/.gitignore
index 564b1c2..18005ee 100644
--- a/docs-site/.gitignore
+++ b/docs-site/.gitignore
@@ -12,7 +12,6 @@ node_modules/
 public/previews/
 history.md
 latest/
-v0.1/
-v0.2/
-v0.3/
-v0.4/
+# all reconstructed version snapshots (v0.1 … v0.6 …) — globbed so this list
+# never drifts when a new version is added
+v[0-9]*/
diff --git a/docs-site/index.md b/docs-site/index.md
index 65e7e69..6ffb9ad 100644
--- a/docs-site/index.md
+++ b/docs-site/index.md
@@ -32,6 +32,6 @@ features:
   - icon: 🕑
     title: Every version, browsable
     details: >-
-      v0.1 through v0.4 reconstructed from git and switchable via the Versions menu —
+      v0.1 through v0.6 reconstructed from git and switchable via the Versions menu —
       with a who-added-what-when authorship page that can never drift.
 ---
diff --git a/docs-site/scripts/generate.mjs b/docs-site/scripts/generate.mjs
index b801a34..ed703b9 100644
--- a/docs-site/scripts/generate.mjs
+++ b/docs-site/scripts/generate.mjs
@@ -28,8 +28,14 @@ const BASE = process.env.DOCS_BASE ?? '/omadia-ui/';
 
 // Newest first. `commit: null` means "current working tree" (the live latest).
 // Commit→version mapping verified against `git log --follow -- docs/visual-spec.md`.
+// NOTE: hand-maintained — append a new entry on every visual-spec version bump
+// and pin the previous "latest" to its last commit at that version.
 const VERSIONS = [
-  { id: 'v0.4', dir: 'latest', alias: 'v0.4', label: 'v0.4 (latest)', commit: null,
+  { id: 'v0.6', dir: 'latest', alias: 'v0.6', label: 'v0.6 (latest)', commit: null,
+    title: 'Iconography — three-source model' },
+  { id: 'v0.5', dir: 'v0.5', label: 'v0.5', commit: '2c1f83e',
+    title: 'Lumens & scene visual treatment' },
+  { id: 'v0.4', dir: 'v0.4', label: 'v0.4', commit: '50985f5',
     title: 'Surface-nesting ladder & chrome budget' },
   { id: 'v0.3', dir: 'v0.3', label: 'v0.3', commit: '78a904b',
     title: 'Three-register typography' },