instar 1.3.72 → 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.72",
+  "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-29T01:04:44.834Z",
-  "instarVersion": "1.3.72",
+  "generatedAt": "2026-05-29T01:32:22.569Z",
+  "instarVersion": "1.3.73",
   "entryCount": 193,
   "entries": {
     "hook:session-start": {
@@ -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": {

package/upgrades/1.3.73.md

@@ -0,0 +1,73 @@
+# Instar Upgrade Guide — NEXT
+
+<!-- bump: patch -->
+
+## What Changed
+
+**The Usher's precision loop is now wired — `acted` can finally move off zero.**
+
+The Usher (rung 4 of continuous-working-awareness) fires "re-surface" signals
+when a faded context becomes relevant again, and exposes a precision read
+(`acted / fired`) that is the hard precondition for ever letting it interrupt
+mid-task (rung 5). But `UsherSignalStore.markActed` — the precision *numerator* —
+had **no caller anywhere**. So `acted` stayed 0 on every topic and precision was
+structurally pinned at 0: the gate could never be satisfied by data. The Usher's
+accuracy half had shipped asleep — the exact "shipped but asleep" trap the rest
+of this project exists to kill, hiding inside our own accuracy meter.
+
+This closes the loop with two correlation paths, both reducing to "does some
+probe text COVER a fired signal's proposition?":
+
+1. **Auto-use (path a).** When the agent's genuine reply goes out on a topic and
+   it actually *uses* a re-surfaced context the Usher flagged, that signal is
+   marked acted (`via: 'use'`). Wired on the outbound `/telegram/reply` path.
+2. **Miss-map (path b).** When the user has to *correct* the agent (a
+   HumanAsDetector signal) on a context a recent nudge had already flagged, that
+   nudge was a genuine catch the agent ignored — still a true positive. It's
+   marked acted (`via: 'miss'`). Wired right after the inbound human-detector
+   observe seam.
+
+Matching is deliberately precision-over-recall (≥2 shared salient terms AND ≥50%
+coverage, within a recency window): a falsely-*high* precision is the dangerous
+direction since it gates interruption, so under-crediting a fast reply is
+acceptable, inflating the gate is not. Everything is best-effort and never throws
+into the message/delivery path.
+
+`GET /usher/metrics` now also reports `acted_by_use` and `acted_by_miss` so the
+precision numerator is visible split by which path confirmed usefulness.
+
+## What to Tell Your User
+
+The Usher now measures whether its mid-task reminders were actually useful — on
+its own, two ways: when my next reply uses a reminder, and when you later have to
+correct me on something a reminder had already flagged. That useful rate is the
+number that has to look good before the Usher ever earns the right to interrupt me
+(the final rung), so instead of sitting stuck at zero it can now gather real
+numbers as we work. Nothing for you to set up — it just runs, and I can show you
+the per-conversation numbers whenever you want them.
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| Usher precision numerator wired | Automatic — `markActed` is now called from the outbound-reply path (agent used the nudge) and the inbound human-detector seam (user corrected on it). |
+| `acted_by_use` / `acted_by_miss` split | `GET /usher/metrics?topicId=N` returns the precision numerator broken down by which correlation path confirmed usefulness. |
+| `UsherActedCorrelator` | Pure, exported coverage matcher (`salientTerms`, `contextCoveredBy`, `findCoveredSignalIds`, `markActedByCoverage`) + two thin wiring wrappers (`creditUsherOnOutbound`, `creditUsherOnMiss`). Unit-tested both-sides-of-the-boundary. |
+
+## Evidence
+
+- Unit: `tests/unit/UsherActedCorrelator.test.ts` — 20 cases covering salient-term
+  extraction, coverage thresholds (covers vs single-coincidental-word vs
+  low-coverage vs empty), recency-window filtering, the via-split + backward-compat
+  on `markActed`, and the two wrappers' guards.
+- Integration: `tests/integration/usher-routes.test.ts` — `GET /usher/metrics`
+  exposes the `acted_by_use`/`acted_by_miss` split + precision; legacy topics
+  report the split as 0; source-guards prove `routes.ts` calls
+  `creditUsherOnOutbound` and `server.ts` calls `creditUsherOnMiss` after the
+  human-detector observe (anti-shipped-but-asleep).
+- E2E: `tests/e2e/usher-precision-lifecycle.test.ts` — boots the real route tree
+  on a live HTTP server, proves the pre-fix state (precision pinned at 0 with a
+  fired-but-unacted nudge), then drives BOTH paths: a reply that uses the context
+  flips precision 0 → 1.0 (`acted_by_use`), an off-topic reply does not, and an
+  inbound correction credits a prior ignored nudge (`acted_by_miss`) — all visible
+  over real HTTP at `GET /usher/metrics`.

package/upgrades/side-effects/usher-precision-loop.md

@@ -0,0 +1,131 @@
+# Side-Effects Review — Usher precision numerator wiring (rung 4)
+
+**Version / slug:** `usher-precision-loop`
+**Date:** `2026-05-28`
+**Author:** `echo`
+**Second-pass reviewer:** `not required` (signal-only observability change, no blocking surface)
+**Spec:** `docs/specs/cwa-usher.md` (approved:true by justin; review-note explicitly names "the usher_acted precision definition that gates rung 5" as the in-scope follow-up this change implements)
+
+## Summary of the change
+
+The Usher fires re-surface signals (`UsherSignalStore.recordSignal`) and exposes a
+precision read (`acted / fired`) that the spec designates as the hard precondition
+for rung 5 (mid-task injection). But `UsherSignalStore.markActed` — the precision
+*numerator* — had no caller anywhere, so `acted` was pinned at 0 on every topic
+and precision could never move. This wires the numerator via two correlation paths
+in a new pure helper `src/core/UsherActedCorrelator.ts`: (a) **auto-use** — when the
+agent's outbound reply on a topic uses a re-surfaced context, mark that signal
+`acted(via:'use')`, called from the `POST /telegram/reply` handler in
+`src/server/routes.ts` after a genuine (non-proxy, non-system) reply sends; (b)
+**miss-map** — when the user has to correct the agent (a `HumanAsDetector` signal)
+on a context a recent nudge flagged, mark it `acted(via:'miss')`, called right after
+the inbound `observeInboundMessage` seam in `src/commands/server.ts`. `markActed` now
+also stamps `actedVia`/`actedAt`, and `GET /usher/metrics` reports
+`acted_by_use`/`acted_by_miss`. Files: `UsherSignalStore.ts`, `UsherActedCorrelator.ts`
+(new), `usherRoutes.ts`, `routes.ts` (+`RouteContext.usherSignalStore`),
+`AgentServer.ts` (route ctx wiring), `server.ts` (path-b seam).
+
+## Decision-point inventory
+
+The only "decision" this change makes is whether to increment an observability
+counter (`acted`). It gates nothing — no message is blocked, delayed, or altered.
+
+- `UsherActedCorrelator.contextCoveredBy` — **add** — pure text-coverage match deciding whether a probe references a fired signal's proposition. Output feeds `markActed` only; no authority over delivery.
+- `routes.ts POST /telegram/reply` (path a) — **pass-through** — the existing send decision is untouched; crediting runs *after* the reply has already gone out.
+- `server.ts` inbound human-detector seam (path b) — **pass-through** — crediting runs after `observeInboundMessage`, which itself is signal-only.
+
+---
+
+## 1. Over-block
+
+**What legitimate inputs does this change reject that it shouldn't?**
+
+No block/allow surface — over-block not applicable. `markActed` only increments a
+metric; it cannot reject, delay, or modify any inbound or outbound message. Both
+call sites run strictly *after* the message has been processed/sent, and both are
+wrapped best-effort (never throw into the message path).
+
+## 2. Under-block
+
+**What failure modes does this still miss?**
+
+By design (precision-over-recall — a falsely-HIGH precision is the dangerous
+direction since precision gates rung 5), the correlator deliberately UNDER-credits:
+
+- **Path (a) timing race:** the Usher's signal is recorded by an async, LLM-backed
+  fire-and-forget loop (~8–10s). A very fast agent reply can land before the signal
+  is persisted, so that use goes uncredited. Acceptable: the full reply (after the
+  agent's work) usually lands well after the signal persists, and under-crediting
+  never inflates the gate.
+- **Short contexts:** a context with fewer than 2 salient terms can never reach the
+  `MIN_SHARED=2` threshold, so single-word propositions are never auto-credited.
+- **Recency window:** uses/corrections outside `USE_WINDOW_MS` (6h) / `MISS_WINDOW_MS`
+  (24h) are not credited.
+
+These are recall gaps, not correctness bugs — the precision number will be a *floor*
+on true usefulness, which is the conservative posture the rung-5 gate wants.
+
+## 3. Level-of-abstraction fit
+
+**Is this at the right layer?**
+
+Yes. `markActed` already existed on `UsherSignalStore` (the spec's numerator); this
+change only supplies its missing callers. The matching logic lives in a pure,
+unit-tested helper (`UsherActedCorrelator`) rather than inline at the call sites,
+and the two call sites are the two existing seams where the relevant text is already
+in hand (outbound reply text; inbound correction text + its `HumanAsDetector`
+verdict). No higher layer owns "was this nudge used" — this is the layer that has
+both the fired signals and the probe text. No smarter gate exists that should own
+it instead.
+
+## 4. Signal vs authority compliance
+
+**Does this hold blocking authority with brittle logic, or produce a signal?**
+
+Compliant (`docs/signal-vs-authority.md`). The coverage matcher is intentionally
+brittle (keyword overlap, no LLM) — and that is acceptable *precisely because it has
+zero authority*. It produces a signal (the precision numerator) and nothing else. It
+never blocks, never gates delivery, and feeds only the operator-facing
+`GET /usher/metrics`. A brittle detector with no blocking power is the correct
+pattern; the anti-pattern (brittle check WITH blocking authority) is not present.
+
+## 5. Interactions
+
+**Does it shadow another check, get shadowed, double-fire, or race?**
+
+- **Idempotency:** `markActed` guards `if (sig.acted) return false`, so paths (a) and
+  (b) marking the same signal, or repeated calls, increment `acted` at most once per
+  signal. The split counters (`acted_by_use`/`acted_by_miss`) only increment on the
+  successful (first) mark.
+- **Ordering on the inbound seam:** path (b) runs in the human-detector callback,
+  which is chained *before* the Usher loop callback on the same `onMessageLogged`.
+  It correlates the correction against signals fired on PRIOR turns (already
+  persisted) — it does not race the current turn's not-yet-fired signal.
+- **No shadowing:** the outbound tone-gate / dedup / ArcCheck path is unchanged;
+  crediting runs after the gate passed and the send succeeded, so it cannot affect
+  any block/allow outcome.
+
+## 6. External surfaces
+
+**Does it change anything visible to other agents, users, or systems?**
+
+- `GET /usher/metrics` gains two additive fields (`acted_by_use`, `acted_by_miss`)
+  and `acted`/`precision` now actually move. This endpoint is operator-only
+  (`INTERNAL_PREFIXES`), not surfaced to end users or other agents.
+- The per-topic `usher/<topicId>.json` store files gain optional `actedVia`/`actedAt`
+  on signals — additive; `load()` already tolerates unknown/missing fields and old
+  readers ignore them.
+- No change to any message content, no new outbound traffic, nothing visible to
+  peer agents. Behavior depends on conversation/topic state but is fully best-effort.
+
+## 7. Rollback cost
+
+**If this turns out wrong in production, what's the back-out?**
+
+Cheap and clean: revert the commit (a normal patch release). No data migration — the
+new optional fields are tolerated by existing `load()` and ignored by older binaries;
+a topic file written by the new code is readable by the old code and vice-versa.
+Worst case after revert: `precision` returns to its prior pinned-at-0 state (the bug
+this fixes). No agent-state repair, no hot-data fix. Because the change is
+observability-only, a wrong precision number cannot itself cause an outage — at most
+it would mislead the rung-5 decision, which is human-gated and not part of this change.