diff --git a/GEMINI.md b/GEMINI.md
new file mode 100644
index 0000000..0d8b084
--- /dev/null
+++ b/GEMINI.md
@@ -0,0 +1,12 @@
+# Agent Mandates
+
+## Versioning and Release Workflow
+Before every `git push` that includes code changes, you MUST perform the following steps:
+
+1. **Bump Version:** Increment the version in `package.json` (both `version` and `aviaVersion`).
+2. **Update Branding:** If a version string is hardcoded in UI plugins (like `avia_core/headliner.js`), update it to match the new version.
+3. **Migration Logic:** Update any migration logic in plugins to ensure users on the previous version are automatically updated to the new default.
+4. **Tagging:** Create or move the git tag corresponding to the new version (e.g., `git tag -f 1.0.x`).
+5. **Push:** Push both the branch and the tags to the remote repository (`git push origin main --force --tags`).
+
+This ensures the internal app state matches the release tag and prevents auto-updater loops.
diff --git a/avia_core/headliner.js b/avia_core/headliner.js
index 6cd2f17..2ca89f5 100644
--- a/avia_core/headliner.js
+++ b/avia_core/headliner.js
@@ -9,7 +9,7 @@
   const STYLE_ID    = "headliner-style";
 
   const defaults = {
-    content:    "Sanctum V 1.0.1",
+    content:    "Sanctum V 1.0.2",
     left:       "32",
     top:        "56",
     fontSize:   "15",
@@ -19,7 +19,7 @@
   function loadSettings() {
     try {
       let s = JSON.parse(localStorage.getItem("headlinerSettings"));
-      if (s && (s.content === "Stoat V 1.0.0 - Sanctum" || s.content === "Sanctum V 1.0.0")) {
+      if (s && (s.content === "Stoat V 1.0.0 - Sanctum" || s.content === "Sanctum V 1.0.0" || s.content === "Sanctum V 1.0.1")) {
         s.content = defaults.content;
         saveSettings(s);
       }
diff --git a/package.json b/package.json
index 248283c..300ce0e 100644
--- a/package.json
+++ b/package.json
@@ -1,8 +1,8 @@
 {
   "name": "sanctum",
   "productName": "Sanctum",
-  "version": "1.0.1",
-  "aviaVersion": "1.0.1",
+  "version": "1.0.2",
+  "aviaVersion": "1.0.2",
   "main": ".vite/build/main.js",
   "repository": "https://git.mithraic.cloud/ad3laid3/sanctum",
   "scripts": {