instar 1.3.71 → 1.3.73

package/dist/server/usherRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usherRoutes.d.ts","sourceRoot":"","sources":["../../src/server/usherRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAIpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,GAAG,MAAM,CA2BxF"}
+{"version":3,"file":"usherRoutes.d.ts","sourceRoot":"","sources":["../../src/server/usherRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAIpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,GAAG,MAAM,CAiCxF"}

package/dist/server/usherRoutes.js

@@ -32,8 +32,14 @@ export function createUsherRoutes(deps) {
         const m = store.getMetrics(parsed.data);
         // Precision = acted / fired (the read that gates rung 5; paired externally
         // with the human-as-detector miss-map for the "what it missed" half).
+        // acted_by_use / acted_by_miss split the numerator by which correlation path
+        // confirmed usefulness (agent used it vs user had to correct on it); defaulted
+        // so legacy topic files (pre-split) report 0 rather than undefined.
         const precision = m.fired > 0 ? m.acted / m.fired : null;
-        res.json({ topicId: parsed.data, metrics: { ...m, precision } });
+        res.json({
+            topicId: parsed.data,
+            metrics: { ...m, acted_by_use: m.acted_by_use ?? 0, acted_by_miss: m.acted_by_miss ?? 0, precision },
+        });
     });
     return router;
 }

package/dist/server/usherRoutes.js.map

@@ -1 +1 @@
-{"version":3,"file":"usherRoutes.js","sourceRoot":"","sources":["../../src/server/usherRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAAC,IAA8C;IAC9E,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;IAE/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;QACvF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;QAC5F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;QAC5F,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,2EAA2E;QAC3E,sEAAsE;QACtE,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACzD,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"usherRoutes.js","sourceRoot":"","sources":["../../src/server/usherRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAAC,IAA8C;IAC9E,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;IAE/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;QACvF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;QAC5F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;QAC5F,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,2EAA2E;QAC3E,sEAAsE;QACtE,6EAA6E;QAC7E,+EAA+E;QAC/E,oEAAoE;QACpE,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACzD,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,MAAM,CAAC,IAAI;YACpB,OAAO,EAAE,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,EAAE,SAAS,EAAE;SACrG,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.71",
+  "version": "1.3.73",
   "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/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-05-28T23:21:16.520Z",
-  "instarVersion": "1.3.71",
+  "generatedAt": "2026-05-29T01:32:22.569Z",
+  "instarVersion": "1.3.73",
   "entryCount": 193,
   "entries": {
     "hook:session-start": {
@@ -11,7 +11,7 @@
       "domain": "identity",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/session-start.sh",
-      "contentHash": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "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": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "since": "2025-01-01"
     },
     "job:health-check": {
@@ -409,7 +409,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:agents": {
@@ -417,7 +417,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:backups": {
@@ -425,7 +425,7 @@
       "type": "route-group",
       "domain": "operations",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:git": {
@@ -433,7 +433,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:memory": {
@@ -441,7 +441,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:semantic": {
@@ -449,7 +449,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:status": {
@@ -457,7 +457,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:capabilities": {
@@ -465,7 +465,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:project-map": {
@@ -473,7 +473,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:coherence": {
@@ -481,7 +481,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:topic-bindings": {
@@ -489,7 +489,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:context": {
@@ -497,7 +497,7 @@
       "type": "route-group",
       "domain": "context",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:scope-coherence": {
@@ -505,7 +505,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:canonical-state": {
@@ -513,7 +513,7 @@
       "type": "route-group",
       "domain": "state",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:ci": {
@@ -521,7 +521,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:sessions": {
@@ -529,7 +529,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:jobs": {
@@ -537,7 +537,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:skip-ledger": {
@@ -545,7 +545,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:telegram": {
@@ -553,7 +553,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:attention": {
@@ -561,7 +561,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:relationships": {
@@ -569,7 +569,7 @@
       "type": "route-group",
       "domain": "relationships",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:feedback": {
@@ -577,7 +577,7 @@
       "type": "route-group",
       "domain": "feedback",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:updates": {
@@ -585,7 +585,7 @@
       "type": "route-group",
       "domain": "updates",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:dispatches": {
@@ -593,7 +593,7 @@
       "type": "route-group",
       "domain": "dispatches",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:quota": {
@@ -601,7 +601,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:publishing": {
@@ -609,7 +609,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:private-views": {
@@ -617,7 +617,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:tunnel": {
@@ -625,7 +625,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:events": {
@@ -633,7 +633,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:evolution": {
@@ -641,7 +641,7 @@
       "type": "route-group",
       "domain": "evolution",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:watchdog": {
@@ -649,7 +649,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:topic-memory": {
@@ -657,7 +657,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:state-sync": {
@@ -665,7 +665,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:intent": {
@@ -673,7 +673,7 @@
       "type": "route-group",
       "domain": "intent",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:triage": {
@@ -681,7 +681,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:operations": {
@@ -689,7 +689,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:sentinel": {
@@ -697,7 +697,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:trust": {
@@ -705,7 +705,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:monitoring": {
@@ -713,7 +713,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:commitments": {
@@ -721,7 +721,7 @@
       "type": "route-group",
       "domain": "commitments",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:episodes": {
@@ -729,7 +729,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:messages": {
@@ -737,7 +737,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:system-reviews": {
@@ -745,7 +745,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "route-group:machine-mesh": {
@@ -761,7 +761,7 @@
       "type": "route-group",
       "domain": "security",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "e639885e32fe2f7e34d4969bf4e1fd0e8945cda76ed398baa69e1b900b67a7f9",
+      "contentHash": "5c238f63374ee42f2cfcae05b9642af8a23b50a7fd19d13a5043a2818ba97419",
       "since": "2025-01-01"
     },
     "cli:init": {
@@ -1457,7 +1457,7 @@
       "type": "subsystem",
       "domain": "server",
       "sourcePath": "src/server/AgentServer.ts",
-      "contentHash": "88cfc6c3397a04f59444a78fe95cd23a3d1805a64476f175123fbb59373c1a07",
+      "contentHash": "5e5b05a51602b7e5e5d863fffc3071af5eb5eaf1c8cc5ba5efa8d8e0a22458b1",
       "since": "2025-01-01"
     },
     "subsystem:session-manager": {
@@ -1489,7 +1489,7 @@
       "type": "subsystem",
       "domain": "updates",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
-      "contentHash": "c410faa704330138b3bb15f71c78506ee86da3b1a7838328dea59888cd7f451a",
+      "contentHash": "cf0c9bfcfa78083bb0a5f6cd2e0f1f175b16204178f373c95cca674e33eae52a",
       "since": "2025-01-01"
     },
     "subsystem:scheduler": {

package/upgrades/1.3.72.md

@@ -0,0 +1,65 @@
+# Upgrade Guide — vNEXT
+
+<!-- bump: patch -->
+
+## What Changed
+
+**Topic-spam, locked down structurally.** A second Telegram topic-flood (after
+the 2026-05-22 sentinel flood) hit a live agent: a housekeeping feature raised one
+attention item per failed peer-resolution every sweep, and because
+`createAttentionItem` spawns a brand-new forum topic per item, that became a wall
+of topics. PR #495 already fixed *that feature* (a per-peer escalation cooldown).
+This change adds the **structural backstop** so the *class* of bug can't recur no
+matter which feature misbehaves next.
+
+**`AttentionTopicGuard` — a per-source + global circuit breaker** at the one
+chokepoint, `TelegramAdapter.createAttentionItem`. If a single attention
+`sourceContext` exceeds its topic budget within a rolling window (default 3 / 10
+min) — or, via a **global ceiling**, all sources collectively exceed it — further
+**non-critical** items are COALESCED into ONE reused "notices coalesced" topic and
+recorded in `state/attention-suppressed.jsonl` — never a wall. Invariants:
+HIGH/URGENT/CRITICAL items are **never** coalesced (critical messages always get
+their own topic), and **no item is dropped** — only its per-item topic is withheld;
+the item is still in the attention store. The global ceiling makes the protection
+hold even when a feature varies its `sourceContext` per item to dodge a per-source
+budget. Ships **enabled by default in code**, so every fleet agent is protected on
+the dist update with zero config.
+
+## What to Tell Your User
+
+- The "wall of topics popping up out of nowhere" problem is now fixed at its root.
+  If any background feature ever tries to flood the chat again, it's capped
+  automatically: a few topics at most, then everything folds into one quiet
+  "notices coalesced" topic, with the detail kept in the logs. Genuinely critical
+  alerts (HIGH/URGENT) are never affected — they always come through on their own.
+- No action or config needed; it's on by default.
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| Attention topic-flood circuit breaker | Automatic, on by default. Tune via `messaging[].config.attentionTopicGuard` = `{ "enabled": true, "windowMs": 600000, "maxTopicsPerSource": 3, "maxTopicsGlobal": 8 }`. |
+| Suppressed-notice audit trail | When a source is coalesced, each item is logged to `state/attention-suppressed.jsonl` (size-capped). Read it to answer "why are my notices grouped / where did topic X go?" |
+
+## Migration Notes
+
+Pure `src/` logic, **default-ON in code** (`AttentionTopicGuard` +
+`TelegramAdapter`) — no agent-installed file changed, so every agent receives the
+protection through the normal dist update with nothing to patch. A
+`migrateClaudeMd()` entry backfills the **Topic-Flood Guard** awareness section
+into existing agents' CLAUDE.md (idempotent). The redrive-specific offender fix
+shipped separately in PR #495.
+
+## Evidence
+
+- Unit: `tests/unit/AttentionTopicGuard.test.ts` (11) — budget / global-cap /
+  critical-bypass (case-insensitive) / per-source isolation / sustained-flood
+  single episode / post-silence reset / config-validation / key-eviction;
+  `tests/unit/PostUpdateMigrator-topicFloodGuard.test.ts` (2) — migrator backfill
+  + idempotency.
+- Integration: `tests/integration/attention-topic-flood-guard.test.ts` (4) — REAL
+  `TelegramAdapter`: a flooding source is capped at budget+1 topics, HIGH
+  bypasses, concurrent coalesced items create ONE topic, a different source is
+  unaffected, no item dropped, audit log populated.
+- E2E: `tests/e2e/attention-topic-flood-guard-lifecycle.test.ts` (1) — fleet
+  default (NO config) still caps a flood exactly (migration-parity guarantee).