feat(changelog): add release ledger data

manifest.llm.json

@@ -13,7 +13,7 @@
     },
     "universe": "Bone Lord Bob (BLB) - Mathison Projects Inc.",
     "status": "early-development",
-    "summary": "Menu shell with persisted route navigation, settings, policies, credits, background music, browser/Electron rendering, and a browser-only socket-gated Toolkit for volatile gameplay/content systems."
+    "summary": "Menu shell with persisted route navigation, settings, policies, changelog, credits, gameplay phase scaffolding, local saves, build metadata display, background music, browser/Electron rendering, and a browser-only socket-gated Toolkit for volatile gameplay/content systems."
   },
   "principles": [
     "Start with llm.txt for human-readable orientation.",
@@ -84,6 +84,11 @@
       "path": "socket/README.md",
       "type": "toolkit-socket-notes",
       "purpose": "Socket folder notes."
+    },
+    {
+      "path": "src/data/AGENTS.md",
+      "type": "data-instructions",
+      "purpose": "Rules for editable JSON content and Toolkit placeholder resources."
     }
   ],
   "targets": [
@@ -149,7 +154,7 @@
     "Sass ^1.101.0",
     "Jest",
     "ESLint + Prettier",
-    "Husky pre-commit validation",
+    "Husky pre-commit build version bump and validation",
     "Node >= 22.12.0"
   ],
   "scripts": {
@@ -166,7 +171,8 @@
     "electron:package": "npm run electron:build && electron-builder",
     "lint": "eslint .",
     "test": "jest",
-    "validate:commit": "npm run lint && npm run test -- --runInBand && npm run electron:build"
+    "validate:commit": "npm run lint && npm run test -- --runInBand && npm run electron:build",
+    "version:bump-build": "node tools/bump-build-version.mjs"
   },
   "architecture": {
     "rootComponent": "App.tsx",
@@ -195,6 +201,16 @@
           "persistKey": "blb-game-settings",
           "purpose": "Resolution, autosave, mute, and audio volume settings."
         },
+        {
+          "file": "src/state/gameplayStore.ts",
+          "persistKey": "blb-gameplay",
+          "purpose": "Active gameplay run, day counter, phase state, and phase navigation."
+        },
+        {
+          "file": "src/state/saveGameStore.ts",
+          "persistKey": "blb-save-games",
+          "purpose": "Local save slots for gameplay runs."
+        },
         {
           "file": "src/state/toolkitSocketStore.ts",
           "purpose": "Toolkit socket connection status."
@@ -229,6 +245,9 @@
     },
     "screens": [
       "src/screens/HomeScreen.tsx",
+      "src/screens/GameplayScreen.tsx",
+      "src/screens/SavesScreen.tsx",
+      "src/screens/ChangelogScreen.tsx",
       "src/screens/SettingsScreen.tsx",
       "src/screens/PoliciesScreen.tsx",
       "src/screens/ToolkitScreen.tsx",
@@ -248,12 +267,37 @@
       "favicon": "src/assets/images/favicon.svg"
     },
     "data": {
+      "changelog": {
+        "json": "src/data/changelog.json",
+        "typedExport": "src/data/changelog.ts",
+        "sortOrder": "newest-created-first"
+      },
       "credits": {
         "json": "src/data/credits.json",
         "typedExport": "src/data/credits.ts"
       },
       "legal": {
         "json": "src/data/legal.json"
+      },
+      "toolkitPlaceholders": {
+        "directory": "src/data/toolkit/",
+        "shape": "empty arrays until schemas stabilize",
+        "files": [
+          "audio.json",
+          "credits.json",
+          "endings.json",
+          "factions.json",
+          "flags.json",
+          "lore.json",
+          "map.json",
+          "opening.json",
+          "petitioners.json",
+          "references.json",
+          "resources.json",
+          "rulings.json",
+          "seed.json",
+          "story.json"
+        ]
       }
     },
     "audio": {
@@ -399,6 +443,7 @@
       "read": [
         "llm.txt",
         "manifest.llm.json",
+        "src/data/AGENTS.md",
         "src/data/",
         "socket/contentStore.cjs"
       ],
@@ -555,12 +600,17 @@
     {
       "command": "npm run validate:commit",
       "purpose": "Pre-commit safety check: lint, Jest, and Electron build."
+    },
+    {
+      "command": "npm run version:bump-build",
+      "purpose": "Increment the package patch version, update public .env build metadata, and stage package/env metadata before a commit."
     }
   ],
   "knownGaps": [
-    "docs/ and wiki/ are placeholder README stubs.",
+    "docs/ is still a placeholder README stub.",
     "No JSON Schema validator exists yet for manifest.llm.json.",
     "Toolkit content panels are read-only scaffolds except for socket/store save plumbing.",
+    "Toolkit placeholder JSON files are intentionally empty arrays until content schemas are requested.",
     "Native android/ and ios/ folders are not currently present in this checkout.",
     "No database exists yet; editable content is intentionally JSON-backed until schemas stabilize."
   ],