From 7b180e6d275581cc2266085d8e9f4a3193df8e00 Mon Sep 17 00:00:00 2001
From: Jage9 <jj@bestmidi.com>
Date: Sun, 8 Mar 2026 22:14:19 -0400
Subject: [PATCH] Show public release version and GitHub link

---
 AGENTS.md                |  2 +-
 client/index.html        |  3 +++
 client/public/version.js |  7 ++++---
 client/src/main.ts       |  9 ++++++++-
 client/src/styles.css    | 13 +++++++++++++
 5 files changed, 29 insertions(+), 5 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index ed4ab34..07a85a9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -38,7 +38,7 @@
 - Runtime/protocol behavior changes: update `docs/runtime-flow.md` and/or `docs/protocol-notes.md`.
 
 ## Versioning & Configuration
-- Bump `client/public/version.js` on every user-visible change using `YYYY.MM.DD Rn`.
+- Bump `client/public/version.js` on every user-visible change using release version + revision metadata (`CHGRID_RELEASE_VERSION`, `CHGRID_BUILD_REVISION`, and derived `CHGRID_WEB_VERSION`, for example `0.1.0` + `R340`).
 - Commit each completed logical change; include the version bump in that same commit when client behavior changes.
 - Docs-only changes do not require a version bump unless explicitly requested.
 - Do not duplicate version constants elsewhere in client code.
diff --git a/client/index.html b/client/index.html
index f652c7e..6d19974 100644
--- a/client/index.html
+++ b/client/index.html
@@ -70,6 +70,9 @@
 
       <footer id="appFooter">
         <small id="appVersion">Another AI experiment with Jage. Version</small>
+        <small id="appGithubLinkWrap">
+          <a id="appGithubLink" href="https://www.github.com/jage9/chat_grid">Chat Grid on Github</a>
+        </small>
         <section id="updatesSection" class="updates-section">
           <h2>Latest Updates</h2>
           <button id="updatesToggle" type="button" aria-expanded="false" aria-controls="updatesPanel">
diff --git a/client/public/version.js b/client/public/version.js
index 19394f3..69d46b3 100644
--- a/client/public/version.js
+++ b/client/public/version.js
@@ -1,5 +1,6 @@
-// Maintainer-controlled web client version.
-// Format: YYYY.MM.DD Rn (example: 2026.02.20 R2)
-window.CHGRID_WEB_VERSION = "2026.03.08 R339";
+// Maintainer-controlled web client version metadata.
+window.CHGRID_RELEASE_VERSION = "0.1.0";
+window.CHGRID_BUILD_REVISION = "R340";
+window.CHGRID_WEB_VERSION = `${window.CHGRID_RELEASE_VERSION} ${window.CHGRID_BUILD_REVISION}`;
 // Optional display timezone for timestamps. Falls back to America/Detroit if unset/invalid.
 window.CHGRID_TIME_ZONE = "America/Detroit";
diff --git a/client/src/main.ts b/client/src/main.ts
index fc60e04..a4acd0a 100644
--- a/client/src/main.ts
+++ b/client/src/main.ts
@@ -91,6 +91,8 @@ const AUTH_POLICY_STORAGE_KEY = 'chgridAuthPolicy';
 
 declare global {
   interface Window {
+    CHGRID_RELEASE_VERSION?: string;
+    CHGRID_BUILD_REVISION?: string;
     CHGRID_WEB_VERSION?: string;
   }
 }
@@ -210,7 +212,12 @@ function announceMenuEntry(title: string, firstOption: string): void {
   audio.sfxUiBlip();
 }
 
-const APP_VERSION = String(window.CHGRID_WEB_VERSION ?? '').trim();
+const APP_RELEASE_VERSION = String(window.CHGRID_RELEASE_VERSION ?? '').trim();
+const APP_BUILD_REVISION = String(window.CHGRID_BUILD_REVISION ?? '').trim();
+const APP_VERSION = String(
+  window.CHGRID_WEB_VERSION ??
+    [APP_RELEASE_VERSION, APP_BUILD_REVISION].filter((value) => value.length > 0).join(' ')
+).trim();
 dom.appVersion.textContent = APP_VERSION
   ? `Another AI experiment with Jage. Version ${APP_VERSION}`
   : 'Another AI experiment with Jage. Version unknown';
diff --git a/client/src/styles.css b/client/src/styles.css
index 56437a7..f25d6e2 100644
--- a/client/src/styles.css
+++ b/client/src/styles.css
@@ -27,9 +27,22 @@ body {
 #appVersion {
   display: block;
   color: #94a3b8;
+  margin-bottom: 0.2rem;
+}
+
+#appGithubLinkWrap {
+  display: block;
   margin-bottom: 0.5rem;
 }
 
+#appGithubLink {
+  color: #93c5fd;
+}
+
+#appGithubLink:visited {
+  color: #bfdbfe;
+}
+
 #appFooter {
   margin-top: 0.5rem;
 }