instar 1.3.970 → 1.3.972

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.970",
+  "version": "1.3.972",
   "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
   "type": "module",
   "main": "dist/index.js",

package/scripts/cartographer-freshness.mjs

@@ -123,7 +123,7 @@ function compute() {
       stateAuthored: false,
       nodeCount: 0, authorableCount: 0, freshCount: 0, staleCount: 0,
       neverAuthoredCount: 0, neverAuthoredWithinGrace: 0, neverAuthoredPastGrace: 0,
-      authorFailedCount: 0, freshRatio: 1,
+      authorFailedCount: 0, freshRatio: null,
     };
   }
 
@@ -163,7 +163,10 @@ function compute() {
     authorFailedCount: authorFailed,
     // Denominator EXCLUDES never-authored-within-grace (grace period before a new
     // node counts as debt): fresh + stale + never-authored-past-grace.
-    freshRatio: (fresh + stale + neverPast) === 0 ? 1 : Number((fresh / (fresh + stale + neverPast)).toFixed(4)),
+    // null (NOT 1) when there is nothing to divide by: an empty index has not
+    // earned a perfect score. Reporting 1 here made this ratchet structurally
+    // unable to fail on an empty map — the exact case it exists to catch.
+    freshRatio: (fresh + stale + neverPast) === 0 ? null : Number((fresh / (fresh + stale + neverPast)).toFixed(4)),
   };
 }
 
@@ -188,7 +191,19 @@ function main() {
 
   if (CHECK) {
     const failures = [];
-    if (report.freshRatio < FLOORS.freshRatio) {
+    if (report.freshRatio === null && report.stateAuthored && report.nodeCount === 0) {
+      // An index EXISTS and yielded nothing authorable. That is the dangerous
+      // empty: the ratchet was asked to assess and could not, which must never
+      // read as a pass (reporting 1 here is what made this check structurally
+      // unable to fail on an empty map — the exact case it exists to catch).
+      failures.push('fresh ratio UNKNOWN — an authored index exists but contains ZERO nodes, so freshness could NOT be assessed (this is not a pass)');
+    } else if (report.freshRatio === null) {
+      // Either no authored state at all (the documented CI case) or an index whose
+      // nodes are all still within grace — legitimately too early to assess. NOT a
+      // failure, but it is NOT a pass either: say so out loud rather than
+      // letting a vacuous check read as a green one.
+      if (!QUIET) console.error('[cartographer-freshness] NOT ASSESSED — no authored cartographer state; this check gated on nothing.');
+    } else if (report.freshRatio < FLOORS.freshRatio) {
       failures.push(`fresh ratio ${report.freshRatio} < floor ${FLOORS.freshRatio}`);
     }
     if (report.neverAuthoredPastGrace > FLOORS.neverAuthoredPastGraceCeiling) {

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-07-25T21:42:13.777Z",
-  "instarVersion": "1.3.970",
+  "generatedAt": "2026-07-25T22:53:55.454Z",
+  "instarVersion": "1.3.972",
   "entryCount": 202,
   "entries": {
     "hook:session-start": {
@@ -11,7 +11,7 @@
       "domain": "identity",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/session-start.sh",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "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": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "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": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "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": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "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": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "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": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "hook:self-stop-guard": {
@@ -65,7 +65,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/self-stop-guard.js",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "hook:post-action-reflection": {
@@ -74,7 +74,7 @@
       "domain": "evolution",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/post-action-reflection.js",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "hook:external-communication-guard": {
@@ -83,7 +83,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/external-communication-guard.js",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "hook:scope-coherence-collector": {
@@ -92,7 +92,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/scope-coherence-collector.js",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "hook:scope-coherence-checkpoint": {
@@ -101,7 +101,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/scope-coherence-checkpoint.js",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "hook:free-text-guard": {
@@ -110,7 +110,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/free-text-guard.sh",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "hook:claim-intercept": {
@@ -119,7 +119,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/claim-intercept.js",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "hook:claim-intercept-response": {
@@ -128,7 +128,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/claim-intercept-response.js",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "hook:stop-gate-router": {
@@ -137,7 +137,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/stop-gate-router.js",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "hook:auto-approve-permissions": {
@@ -146,7 +146,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/auto-approve-permissions.js",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "job:health-check": {
@@ -418,7 +418,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:agents": {
@@ -426,7 +426,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:backups": {
@@ -434,7 +434,7 @@
       "type": "route-group",
       "domain": "operations",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:git": {
@@ -442,7 +442,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:memory": {
@@ -450,7 +450,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:semantic": {
@@ -458,7 +458,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:status": {
@@ -466,7 +466,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:capabilities": {
@@ -474,7 +474,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:project-map": {
@@ -482,7 +482,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:coherence": {
@@ -490,7 +490,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:topic-bindings": {
@@ -498,7 +498,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:context": {
@@ -506,7 +506,7 @@
       "type": "route-group",
       "domain": "context",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:scope-coherence": {
@@ -514,7 +514,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:canonical-state": {
@@ -522,7 +522,7 @@
       "type": "route-group",
       "domain": "state",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:ci": {
@@ -530,7 +530,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:sessions": {
@@ -538,7 +538,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:jobs": {
@@ -546,7 +546,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:skip-ledger": {
@@ -554,7 +554,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:telegram": {
@@ -562,7 +562,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:attention": {
@@ -570,7 +570,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:relationships": {
@@ -578,7 +578,7 @@
       "type": "route-group",
       "domain": "relationships",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:feedback": {
@@ -586,7 +586,7 @@
       "type": "route-group",
       "domain": "feedback",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:updates": {
@@ -594,7 +594,7 @@
       "type": "route-group",
       "domain": "updates",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:dispatches": {
@@ -602,7 +602,7 @@
       "type": "route-group",
       "domain": "dispatches",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:quota": {
@@ -610,7 +610,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:publishing": {
@@ -618,7 +618,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:private-views": {
@@ -626,7 +626,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:tunnel": {
@@ -634,7 +634,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:events": {
@@ -642,7 +642,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:evolution": {
@@ -650,7 +650,7 @@
       "type": "route-group",
       "domain": "evolution",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:watchdog": {
@@ -658,7 +658,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:topic-memory": {
@@ -666,7 +666,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:state-sync": {
@@ -674,7 +674,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:intent": {
@@ -682,7 +682,7 @@
       "type": "route-group",
       "domain": "intent",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:triage": {
@@ -690,7 +690,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:operations": {
@@ -698,7 +698,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:sentinel": {
@@ -706,7 +706,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:trust": {
@@ -714,7 +714,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:monitoring": {
@@ -722,7 +722,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:commitments": {
@@ -730,7 +730,7 @@
       "type": "route-group",
       "domain": "commitments",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:episodes": {
@@ -738,7 +738,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:messages": {
@@ -746,7 +746,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:system-reviews": {
@@ -754,7 +754,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "route-group:machine-mesh": {
@@ -770,7 +770,7 @@
       "type": "route-group",
       "domain": "security",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "4fc659422651c32e9c1666c14a5f96fc071915314cf4da792b542127729242b5",
+      "contentHash": "c424f56d50da1f0b007be59271759c6276ac6e622cadd27d003e8fe9b6738071",
       "since": "2025-01-01"
     },
     "cli:init": {
@@ -1562,7 +1562,7 @@
       "type": "subsystem",
       "domain": "updates",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
-      "contentHash": "cee3cbfe66d9e7bf93bbe331d793698fb870d2b669821ecbb56440a1677217e3",
+      "contentHash": "0c703f879feac72668890b6db759ed3da3ecd33035f1d2896ccbf7e1ac59c7b5",
       "since": "2025-01-01"
     },
     "subsystem:scheduler": {

package/upgrades/1.3.971.md

@@ -0,0 +1,57 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+Two of our own checks were announcing results they had not earned. Both are now honest.
+
+**The commit gate was not blocking anything.** `.husky/pre-commit` ran its checks as a plain
+sequence with no `set -e`, so the hook's exit status was whatever the *last* command returned.
+`scripts/instar-dev-precommit.js` would correctly refuse a commit — printing its full
+`commit BLOCKED` banner and exiting 1 — and then three further checks ran after it, each exiting
+0, so git saw 0 and accepted the commit anyway. Every blocking check in that hook except the final
+one was effectively advisory. Fixed with `set -e`, with the reasoning recorded inline so it is not
+re-introduced.
+
+**A freshness score of 100% for having measured nothing.** `freshRatio` returned `1` when there
+was no denominator — an explicit choice in code (`ratioDenom === 0 ? 1`), not an oversight. Since
+the CI ratchet gates on `freshRatio < FLOOR`, a perfect 1 passed every possible floor, leaving the
+guard structurally unable to fail on an empty map — precisely the case it exists to catch. All
+five producers now return `null` when there is nothing to divide by, and the ratchet distinguishes
+*no authored state at all* (the legitimate case — still passes, but now prints
+`NOT ASSESSED — this check gated on nothing` instead of reporting success) from *an authored index
+containing zero nodes* (a hard failure). A freshly-scaffolded index whose nodes are still within
+their grace period remains a pass.
+
+## What to Tell Your User
+
+Nothing changes in how you work with your agent, and no action is needed.
+
+One small visible difference if you look at the documentation-map health figure: where it
+previously showed 100% freshness for a map with nothing in it, it now shows no figure at all,
+because "we have not measured anything" and "everything is fresh" are different answers and should
+not look identical.
+
+## Summary of New Capabilities
+
+No new capabilities. Both changes make existing machinery do what it already claimed to do —
+one restores a verdict that was being computed correctly and then discarded, the other stops a
+health figure from manufacturing a passing grade out of an absence of evidence.
+
+## Evidence
+
+- The defect was proved rather than inferred: a commit was deliberately landed through a printed
+  `commit BLOCKED` banner (`b2efded2f`, since reverted). After the fix, the identical commit is
+  refused with `husky - pre-commit script failed (code 1)`.
+- Every command in the pre-commit sequence was measured independently on a clean tree with real
+  dependencies: all exit 0, so making the hook honest does not turn a green repo red.
+- Freshness: pointing the ratchet at an index that exists and is empty now fails with
+  `could NOT be assessed (this is not a pass)`; with no authored state it still exits 0 but says
+  so out loud.
+- Three new regression tests cover both sides of the boundary, including one asserting that an
+  empty authored index cannot satisfy even a floor of 0. 103 cartographer tests pass; lint clean.
+- One pre-existing E2E assertion required `freshRatio` to be a *number* on an empty tree — it was
+  protecting the old behaviour and would have failed anyone fixing this honestly. It now asserts
+  the honest contract, with the reason recorded inline.