instar 1.3.201 → 1.3.203

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-06-02T07:52:52.700Z",
-  "instarVersion": "1.3.201",
+  "generatedAt": "2026-06-02T14:38:50.327Z",
+  "instarVersion": "1.3.203",
   "entryCount": 194,
   "entries": {
     "hook:session-start": {
@@ -11,7 +11,7 @@
       "domain": "identity",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/session-start.sh",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:dangerous-command-guard": {
@@ -20,7 +20,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/dangerous-command-guard.sh",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:grounding-before-messaging": {
@@ -29,7 +29,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/grounding-before-messaging.sh",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:compaction-recovery": {
@@ -38,7 +38,7 @@
       "domain": "identity",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/compaction-recovery.sh",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:external-operation-gate": {
@@ -47,7 +47,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/external-operation-gate.js",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:deferral-detector": {
@@ -56,7 +56,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/deferral-detector.js",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:post-action-reflection": {
@@ -65,7 +65,7 @@
       "domain": "evolution",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/post-action-reflection.js",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:external-communication-guard": {
@@ -74,7 +74,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/external-communication-guard.js",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:scope-coherence-collector": {
@@ -83,7 +83,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/scope-coherence-collector.js",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:scope-coherence-checkpoint": {
@@ -92,7 +92,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/scope-coherence-checkpoint.js",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:free-text-guard": {
@@ -101,7 +101,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/free-text-guard.sh",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:claim-intercept": {
@@ -110,7 +110,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/claim-intercept.js",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:claim-intercept-response": {
@@ -119,7 +119,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/claim-intercept-response.js",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:stop-gate-router": {
@@ -128,7 +128,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/stop-gate-router.js",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "hook:auto-approve-permissions": {
@@ -137,7 +137,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/auto-approve-permissions.js",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "job:health-check": {
@@ -769,7 +769,7 @@
       "type": "cli-command",
       "domain": "setup",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:setup": {
@@ -777,7 +777,7 @@
       "type": "cli-command",
       "domain": "setup",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:add": {
@@ -785,7 +785,7 @@
       "type": "cli-command",
       "domain": "setup",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:backup": {
@@ -793,7 +793,7 @@
       "type": "cli-command",
       "domain": "operations",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:git": {
@@ -801,7 +801,7 @@
       "type": "cli-command",
       "domain": "coordination",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:memory": {
@@ -809,7 +809,7 @@
       "type": "cli-command",
       "domain": "memory",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:knowledge": {
@@ -817,7 +817,7 @@
       "type": "cli-command",
       "domain": "memory",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:semantic": {
@@ -825,7 +825,7 @@
       "type": "cli-command",
       "domain": "memory",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:intent": {
@@ -833,7 +833,7 @@
       "type": "cli-command",
       "domain": "intent",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:feedback": {
@@ -841,7 +841,7 @@
       "type": "cli-command",
       "domain": "feedback",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:server": {
@@ -849,7 +849,7 @@
       "type": "cli-command",
       "domain": "server",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:status": {
@@ -857,7 +857,7 @@
       "type": "cli-command",
       "domain": "monitoring",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:user": {
@@ -865,7 +865,7 @@
       "type": "cli-command",
       "domain": "users",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:relationship": {
@@ -873,7 +873,7 @@
       "type": "cli-command",
       "domain": "relationships",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:job": {
@@ -881,7 +881,7 @@
       "type": "cli-command",
       "domain": "scheduling",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:lifeline": {
@@ -889,7 +889,7 @@
       "type": "cli-command",
       "domain": "communication",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:list": {
@@ -897,7 +897,7 @@
       "type": "cli-command",
       "domain": "monitoring",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:autostart": {
@@ -905,7 +905,7 @@
       "type": "cli-command",
       "domain": "operations",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:migrate": {
@@ -913,7 +913,7 @@
       "type": "cli-command",
       "domain": "updates",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:machines": {
@@ -921,7 +921,7 @@
       "type": "cli-command",
       "domain": "coordination",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:whoami": {
@@ -929,7 +929,7 @@
       "type": "cli-command",
       "domain": "identity",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:pair": {
@@ -937,7 +937,7 @@
       "type": "cli-command",
       "domain": "coordination",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:join": {
@@ -945,7 +945,7 @@
       "type": "cli-command",
       "domain": "coordination",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:wakeup": {
@@ -953,7 +953,7 @@
       "type": "cli-command",
       "domain": "coordination",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:leave": {
@@ -961,7 +961,7 @@
       "type": "cli-command",
       "domain": "coordination",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:doctor": {
@@ -969,7 +969,7 @@
       "type": "cli-command",
       "domain": "monitoring",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:review": {
@@ -977,7 +977,7 @@
       "type": "cli-command",
       "domain": "monitoring",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:nuke": {
@@ -985,7 +985,7 @@
       "type": "cli-command",
       "domain": "operations",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "cli:playbook": {
@@ -993,7 +993,7 @@
       "type": "cli-command",
       "domain": "context",
       "sourcePath": "src/cli.ts",
-      "contentHash": "61519ff00a42e4d859ad18e6ddade404309a1e047ff33cca31693e06a05bf622",
+      "contentHash": "5c1909925cc2d14b3d8270dd433ec4d6753161553fbe74acc0262608ff368ed4",
       "since": "2025-01-01"
     },
     "template:build-stop-hook.sh": {
@@ -1089,7 +1089,7 @@
       "type": "template",
       "domain": "operations",
       "sourcePath": "src/templates/scripts/convergence-check.sh",
-      "contentHash": "b0475554bde6729d2d9a1f8005dcada6a8e4c767203d8293c09a212f9bf0a196",
+      "contentHash": "21a81a7cf2437724a4b1453eaafb5a0bbcef3ab4cea7326c66c00358dd69535a",
       "since": "2025-01-01"
     },
     "template:emit-session-clock.sh": {
@@ -1497,7 +1497,7 @@
       "type": "subsystem",
       "domain": "updates",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
-      "contentHash": "e8270e118c93a86da1982ba20f6432a566e59f6ae77c3e04c05d81fb3d79b386",
+      "contentHash": "920b1492c5e80f1b63e8f7f685635fda2b722fa11de39ee774ad51aa86dbfdb5",
       "since": "2025-01-01"
     },
     "subsystem:scheduler": {
@@ -1545,7 +1545,7 @@
       "type": "subsystem",
       "domain": "memory",
       "sourcePath": "src/memory/SemanticMemory.ts",
-      "contentHash": "446518e120f33abe7903662340500e9aecd6d2f73793dc0d07c189e1f8f0557c",
+      "contentHash": "9c384e1db6fed559f6425a32d1f20490d98b40660b8f7be62d7cf515cb576df4",
       "since": "2025-01-01"
     },
     "subsystem:multi-machine-coordinator": {
@@ -1553,7 +1553,7 @@
       "type": "subsystem",
       "domain": "coordination",
       "sourcePath": "src/core/MultiMachineCoordinator.ts",
-      "contentHash": "63ce6fcd9564b1e547e2b0ad6153e43293566dac6a6db6f17ffb8cbf28b28894",
+      "contentHash": "9646bb62caff1d39524f0680bd6824bba5866ae283582cd9fd23cf011e083520",
       "since": "2025-01-01"
     },
     "subsystem:backup-manager": {

package/src/templates/scripts/convergence-check.sh

@@ -169,6 +169,55 @@ if [ -n "$SPEC_HANDOFF" ] \
   ISSUE_COUNT=$((ISSUE_COUNT + 1))
 fi
 
+# 9. TIME-AWARENESS NUDGE (Robust Session Time Awareness spec — Component 4,
+# SIGNAL-ONLY). If this outbound message asserts the SESSION/RUN is done/over
+# while a LIVE autonomous record still has >10% of its time-box remaining, emit a
+# one-line SIGNAL to an operator log + stderr. It NEVER blocks or rewrites the
+# message (does NOT touch ISSUE_COUNT / the exit code) and NEVER quotes the
+# agent's phrase — it carries the computed fact (≈NN% remains) only, so the
+# signal can't be re-read as self-confirming evidence the run is finished
+# (P2 Signal vs Authority). Guards the exact wind-down-early incident class.
+if echo "$CONTENT" | grep -qiE "((the )?([a-z0-9 ._-]{0,25} )?(session|run|sprint) (is|was|.s) (now )?(done|over|complete|completed|finished|wrapped[ -]?up)|winding[ -]down( the| this| my)?( session| run)?|wrapping[ -]up the (session|run))"; then
+  TA_DIR="${CLAUDE_PROJECT_DIR:-.}/.instar/autonomous"
+  TA_SIG=""
+  TA_REC=""
+  if [ -d "$TA_DIR" ]; then
+    for ta_rec in "$TA_DIR"/*.local.md; do
+      [ -f "$ta_rec" ] || continue
+      ta_pct=$(python3 - "$ta_rec" <<'PY' 2>/dev/null
+import sys, re, datetime
+try:
+    body = open(sys.argv[1]).read()
+    def g(k):
+        m = re.search(r'^\s*' + k + r'\s*:\s*"?([^"\n]+)"?', body, re.M)
+        return m.group(1).strip() if m else ''
+    if g('active').lower() != 'true':
+        sys.exit(0)
+    end, dur = g('end_at'), g('duration_seconds')
+    if not end or not dur:
+        sys.exit(0)
+    end_dt = datetime.datetime.fromisoformat(end.replace('Z', '+00:00'))
+    now = datetime.datetime.now(datetime.timezone.utc)
+    remain = (end_dt - now).total_seconds()
+    durs = float(dur)
+    if durs > 0 and remain > 0 and (remain / durs) > 0.10:
+        print(int(round(remain / durs * 100)))
+except Exception:
+    sys.exit(0)
+PY
+)
+      if [ -n "$ta_pct" ]; then TA_SIG="$ta_pct"; TA_REC="$(basename "$ta_rec")"; break; fi
+    done
+  fi
+  if [ -n "$TA_SIG" ]; then
+    TA_TS=$(date -u +%Y-%m-%dT%H:%M:%SZ 2>/dev/null)
+    TA_LOG="${CLAUDE_PROJECT_DIR:-.}/logs"
+    mkdir -p "$TA_LOG" 2>/dev/null
+    printf '{"ts":"%s","signal":"premature-completion-assertion","remainingPct":%s,"record":"%s"}\n' "$TA_TS" "$TA_SIG" "$TA_REC" >> "$TA_LOG/time-awareness-signals.jsonl" 2>/dev/null || true
+    echo "[time-awareness] SIGNAL: this message asserts completion while ~${TA_SIG}% of the active autonomous time-box (${TA_REC}) remains — verify before concluding. (signal-only; message NOT blocked)" >&2
+  fi
+fi
+
 # Output results
 if [ "$ISSUE_COUNT" -gt "0" ]; then
   echo "=== CONVERGENCE CHECK: ${ISSUE_COUNT} ISSUE(S) FOUND ==="

package/upgrades/1.3.202.md

@@ -0,0 +1,65 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+Fixed a long-standing silent no-op in `RevertDetector`, the part of the
+failure-learning loop that watches recent git history for `Revert "..."`
+commits and opens a forensic record when it finds one. Its `git log` scan
+included `--regexp-ignore-case=false` — a flag git does not accept in that
+`=value` form. git rejected the whole command (`fatal: unrecognized
+argument`), the call threw on every tick, the error was swallowed by the
+surrounding try/catch, and the scan returned 0. The result: revert
+detection has never actually fired on any install. The fix deletes the
+invalid flag (case-sensitive matching is git's `--grep` default, which is
+the intended behavior) and adds a NOTE comment so it can't be reintroduced.
+Two regression tests pin it: an argv-shape assertion and a real-git
+end-to-end test (real temp repo + real revert) that would have caught the
+original bug.
+
+## What to Tell Your User
+
+Nothing you need to do. After this update, my revert-detection arm actually
+works — if a commit in my recent history is a revert, I now open a forensic
+record for it instead of silently missing it. This was a behind-the-scenes
+observer that was quietly broken; no user-facing behavior or messages
+change.
+
+## Summary of New Capabilities
+
+- RevertDetector's `git log` scan now runs with a valid argv, so revert
+  detection works fleet-wide for the first time (previously a silent no-op).
+- Regression coverage: an argv-shape test rejects any reappearance of a
+  `--(no-)?regexp-ignore-case=` flag, and a real-git end-to-end test proves
+  a genuine `git revert` commit opens exactly one forensic FailureLedger
+  record.
+
+## Evidence
+
+**Reproduction (the broken command, against any git):**
+
+```
+$ git log -n 50 --grep=^Revert --regexp-ignore-case=false --format=%H
+fatal: unrecognized argument
+$ echo $?
+128
+```
+
+git 2.39.5 (Apple Git-154) rejects the `=value` form of the case flag — this
+is not version-specific; git has never accepted it. In `RevertDetector` the
+non-zero exit throws, the try/catch swallows it, and `scanForReverts`
+returns 0.
+
+**Before:** revert detection returns 0 on every tick regardless of history.
+Confirmed in `echo`'s `logs/server-stderr.log` (the throw was seen 4× during
+a learnings harvest). The flag is present on canonical main at
+`src/monitoring/RevertDetector.ts:143`.
+
+**After:** with the flag removed, the new real-git regression test creates a
+temp repo, commits, runs a real `git revert --no-edit HEAD`, and drives
+`RevertDetector` with its default `SafeGitExecutor` runner — `tick()`
+returns 1 and exactly one `source: 'revert'` forensic record is opened. The
+argv-shape test asserts the scan command carries no `--(no-)?regexp-ignore-case=`
+flag. 11/11 unit tests pass; `tsc`, `lint`, and `build` are clean.

package/upgrades/1.3.203.md

@@ -0,0 +1,30 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: minor -->
+
+## What Changed
+
+Instar can now run on a third framework: **Gemini CLI**. This is the apprenticeship Step 2 keystone — the runtime adapter ("the body") for `gemini-cli`, so the existing framework-agnostic agent layer ("the mind") runs on Gemini the same way it already runs on Claude Code and Codex CLI.
+
+`gemini-cli` is now a first-class `IntelligenceFramework`. The live judgment path (`buildIntelligenceProvider`) constructs a new `GeminiCliIntelligenceProvider` that spawns the verified one-shot `gemini -m <model> --approval-mode default -p <prompt>` — a single pinned, canonical argv with the prompt as exactly one element. The body ships the MANDATORY floor only (one-shot transport + SessionId + HardKill), with an honest, minimal capability declaration; the richer primitives (native `gemini hooks`, compaction lifecycle, full session-resume index) are explicitly tracked as ongoing apprenticeship parity work, not shipped half-built.
+
+Critically, this closes the *framework-blind* surfaces that a new framework silently breaks without a compile error: resume (`ThreadResumeMap`/`TopicResumeMap` `jsonlExists`), rate-limit + compaction recovery-verification, process/activity detection, and the transcript resolver all now have a real Gemini branch that resolves the correct `~/.gemini` session file. A new **drift canary** enumerates every framework and fails CI if any future framework lacks a correct resolver — turning a class of silent fleet-wide breakage into a test-forced one.
+
+Security is pinned at the call site: the one-shot never reaches `--yolo`/`--approval-mode yolo`, the child env unconditionally hard-deletes the five Google/Gemini billing vars (`GEMINI_API_KEY`, `GOOGLE_API_KEY`, `GOOGLE_APPLICATION_CREDENTIALS`, `GOOGLE_GENAI_USE_VERTEXAI`, `GOOGLE_CLOUD_PROJECT`) so Gemini stays on its cached-OAuth path and can't be silently billed, and captured output is byte-capped (improving on the codex adapter's unbounded buffer).
+
+## What to Tell Your User
+
+Nothing to do for existing Claude or Codex agents — they are completely unaffected. If you want to run an agent on Gemini CLI, install the Gemini CLI, sign in, and choose Gemini as the framework when you set up an agent (or bind a single topic to Gemini). The full Gemini agent experience — the multi-turn loop driver and the richer monitoring features — is still being built as ongoing apprenticeship work; this step is the foundation that makes Gemini runnable, not full feature parity yet.
+
+## Summary of New Capabilities
+
+- `gemini-cli` is a first-class `IntelligenceFramework`; `buildIntelligenceProvider({ framework: 'gemini-cli' })` returns a circuit-breaker-wrapped `GeminiCliIntelligenceProvider` (the live transport), and the registry adapter `src/providers/adapters/gemini-cli/` exists as the parity-harness surface.
+- `--framework gemini-cli` is accepted by `instar init` / `instar setup` and `instar route`; a topic can be bound to `gemini-cli` (`SUPPORTED_FRAMEWORKS`).
+- The framework-blind resolvers (resume, rate-limit/compaction recovery-verification, process/activity signals, transcript resolution) all handle Gemini's `~/.gemini/tmp/<projectHash>/chats/session-*.json[l]` layout; `PostUpdateMigrator.getEnabledFrameworks` no longer silently drops `gemini-cli`.
+- A drift canary (`tests/unit/framework-resolver-drift.test.ts`) asserts every `IntelligenceFramework` resolves to its CORRECT transcript and fails CI if a future framework lacks a resolver.
+
+## Evidence
+
+- `npx tsc --noEmit` clean. New tests green across all three tiers: `tests/unit/gemini-cli-adapter.test.ts` (canonical argv + yolo-safety + the 5-var key-leak canary + output cap + wiring integrity, 17 tests), `tests/unit/framework-resolver-drift.test.ts` (the semantic drift canary, 6 tests), `tests/integration/gemini-cli-provider.test.ts` (registry resolve + the ALIVE `buildIntelligenceProvider` path, 6 tests), `tests/e2e/gemini-cli-alive-lifecycle.test.ts` (a REAL one-shot through the production provider returned the expected PONG smoke against gemini v0.25.2, 2 tests).
+- Spec: `docs/specs/APPRENTICESHIP-STEP2-GEMINI-RUNTIME-ADAPTER-SPEC.md`. Two tracked `programNeeds` (parity gap `need-gem-001` + native loop driver `need-gem-002`) keep the remaining work open, not dropped.