instar 1.3.976 → 1.3.977

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.976",
+  "version": "1.3.977",
   "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-07-26T02:45:59.451Z",
-  "instarVersion": "1.3.976",
+  "generatedAt": "2026-07-26T02:56:24.966Z",
+  "instarVersion": "1.3.977",
   "entryCount": 202,
   "entries": {
     "hook:session-start": {
@@ -418,7 +418,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:agents": {
@@ -426,7 +426,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:backups": {
@@ -434,7 +434,7 @@
       "type": "route-group",
       "domain": "operations",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:git": {
@@ -442,7 +442,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:memory": {
@@ -450,7 +450,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:semantic": {
@@ -458,7 +458,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:status": {
@@ -466,7 +466,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:capabilities": {
@@ -474,7 +474,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:project-map": {
@@ -482,7 +482,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:coherence": {
@@ -490,7 +490,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:topic-bindings": {
@@ -498,7 +498,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:context": {
@@ -506,7 +506,7 @@
       "type": "route-group",
       "domain": "context",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:scope-coherence": {
@@ -514,7 +514,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:canonical-state": {
@@ -522,7 +522,7 @@
       "type": "route-group",
       "domain": "state",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:ci": {
@@ -530,7 +530,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:sessions": {
@@ -538,7 +538,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:jobs": {
@@ -546,7 +546,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:skip-ledger": {
@@ -554,7 +554,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:telegram": {
@@ -562,7 +562,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:attention": {
@@ -570,7 +570,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:relationships": {
@@ -578,7 +578,7 @@
       "type": "route-group",
       "domain": "relationships",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:feedback": {
@@ -586,7 +586,7 @@
       "type": "route-group",
       "domain": "feedback",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:updates": {
@@ -594,7 +594,7 @@
       "type": "route-group",
       "domain": "updates",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:dispatches": {
@@ -602,7 +602,7 @@
       "type": "route-group",
       "domain": "dispatches",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:quota": {
@@ -610,7 +610,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:publishing": {
@@ -618,7 +618,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:private-views": {
@@ -626,7 +626,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:tunnel": {
@@ -634,7 +634,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:events": {
@@ -642,7 +642,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:evolution": {
@@ -650,7 +650,7 @@
       "type": "route-group",
       "domain": "evolution",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:watchdog": {
@@ -658,7 +658,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:topic-memory": {
@@ -666,7 +666,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:state-sync": {
@@ -674,7 +674,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:intent": {
@@ -682,7 +682,7 @@
       "type": "route-group",
       "domain": "intent",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:triage": {
@@ -690,7 +690,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:operations": {
@@ -698,7 +698,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:sentinel": {
@@ -706,7 +706,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:trust": {
@@ -714,7 +714,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:monitoring": {
@@ -722,7 +722,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:commitments": {
@@ -730,7 +730,7 @@
       "type": "route-group",
       "domain": "commitments",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:episodes": {
@@ -738,7 +738,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:messages": {
@@ -746,7 +746,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:system-reviews": {
@@ -754,7 +754,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "route-group:machine-mesh": {
@@ -770,7 +770,7 @@
       "type": "route-group",
       "domain": "security",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "c55d95e9a2af479f5ae1cbb258308581b4f272b7b7722c5e876f636089d5acce",
+      "contentHash": "7cdcbcf5111f5aa3ee5ec3f24500072e7eb5a5a88efb1363a597935949b74a14",
       "since": "2025-01-01"
     },
     "cli:init": {

package/upgrades/1.3.977.md

@@ -0,0 +1,53 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+**`GET /metrics/learning-velocity` now counts work that FINISHED, not work that was filed.**
+
+The metric answering "are we actually learning and adapting?" counted every evolution action at its
+`createdAt`. Verified 2026-07-25: 739 of 771 "learning events" (96%) were items merely FILED, and on
+the real queue 494 of those carry the abandonment sweep's own resolution text. So the metric had
+inverted — **the faster work was abandoned, the higher the adaptability score climbed.** It read
+88/100 "accelerating" on the morning the operator halted all work because the opposite was visibly
+true.
+
+An action now contributes a learning event only when `status === 'completed'`, stamped at
+`completedAt` (falling back to `updatedAt`). Pending, in-progress, cancelled and auto-abandoned
+actions contribute nothing.
+
+Measured before/after on a real queue, 30-day window, rule change only: **784 events → 18** (of
+1,288 considered: 743 pending, 494 auto-abandoned, 29 cancelled, 2 in progress).
+
+Two doors deliberately shut: a `completed` action with no completion timestamp is EXCLUDED rather
+than back-dated to `createdAt` (which would re-import the filing bias), and the window still
+excludes old completions.
+
+`computeLearningVelocity` itself is untouched — only the route's event gathering changed.
+
+## What to Tell Your User
+
+Your adaptability score will drop, in most cases sharply, and the new number is the honest one. The
+old one was largely a count of how fast items were being filed. The response now states the counting
+rule and itemises what was excluded and why, so a low score reads as "little has finished recently"
+rather than "we have stopped learning" — those call for opposite responses.
+
+## Summary of New Capabilities
+
+- `counting` — the rule in one line, travelling with the number.
+- `evolutionActions` — `{ considered, counted, excluded }` by reason, with `auto-abandoned` named
+  specifically (the largest bucket, and the one the old metric scored as learning).
+
+## Evidence
+
+- `tests/integration/learning-velocity-routes.test.ts` — 7 tests. Three existing cases rewritten
+  (they asserted filed items count as learning — a specification of the inversion), three added:
+  the real queue in miniature (5 filed-or-abandoned + 1 completion → exactly 1 event); a completion
+  with no timestamp excluded rather than back-dated; a completion outside the window excluded by
+  date while still visible in `counted`.
+- `tests/e2e/learning-velocity-lifecycle.test.ts` — the counting rule and accounting survive the
+  production initialization path.
+- `tests/unit/LearningVelocityScorer.test.ts` — unchanged and passing: the pure scorer's contract
+  did not move.

package/upgrades/side-effects/learning-velocity-counts-finishing.md

@@ -0,0 +1,102 @@
+# Side-Effects Review — learning velocity counts finishing, not filing (ACT-1244)
+
+## Summary of the change
+
+`GET /metrics/learning-velocity` counted EVERY evolution action at its `createdAt`, so the metric
+answering "are we learning?" was almost purely a measure of FILING RATE. Verified 2026-07-25: 739 of
+771 events (96%) were filed items; on the real queue 494 of those carry the sweep's resolution
+"Abandoned without active tracking since creation date". The metric read 88/100 "accelerating" on
+the morning the operator halted work because the opposite was visibly true — **the faster work was
+abandoned, the higher the score climbed.**
+
+An action now contributes a learning event ONLY when `status === 'completed'`, stamped at
+`completedAt` (falling back to `updatedAt`). Everything else is excluded and ACCOUNTED FOR by
+reason. The response gains `counting` (the rule, in one line) and `evolutionActions`
+(`considered` / `counted` / `excluded` by reason, with `auto-abandoned` named specifically).
+
+Measured before/after on this agent's live queue, 30-day window, rule change only:
+**784 events → 18.** Considered 1,288; excluded 743 `not-completed:pending`, 494 `auto-abandoned`,
+29 `not-completed:cancelled`, 2 `not-completed:in_progress`.
+
+## Decision-point inventory
+
+- `GET /metrics/learning-velocity` — a READ-ONLY observability route. It gates nothing, blocks
+  nothing, and no code path branches on its output. The change alters what it REPORTS, never what
+  anything DOES.
+- `computeLearningVelocity` (`src/core/LearningVelocityScorer.ts`) — **untouched.** It remains a
+  pure function over an event list; only the route's event GATHERING changed. Its 6 unit tests pass
+  unmodified, which is the evidence that the scorer's contract is unchanged.
+- No gate, hook, reaper, sentinel, scheduler, migration or config surface is touched.
+
+## 1. Over-block
+
+Not applicable — nothing here blocks. The adjacent risk is over-EXCLUSION: an action that genuinely
+represents learning but is not marked `completed` no longer counts. That is the intended semantics
+(the whole finding is that filing ≠ learning), and it is not silent: every exclusion is itemised by
+reason in the response, so a reader can see exactly what was set aside and disagree with the rule if
+they wish.
+
+Two exclusions were chosen deliberately and could be argued:
+
+- **`completed` with no `completedAt`/`updatedAt` → excluded, not back-dated to `createdAt`.**
+  Back-dating would re-import the entire filing bias through the one remaining gap. On the live
+  queue this bucket is EMPTY (all 20 completions carry `completedAt`), so the strict choice costs
+  nothing today and closes the door for later.
+- **`cancelled` for a considered reason → still excluded.** A deliberate cancellation may well
+  embody a lesson, but it is not a completion, and admitting it would reopen the "closing a row
+  counts as learning" path that produced the inversion.
+
+## 2. Under-block
+
+The score can now READ LOWER than reality if completions are recorded without status/timestamp
+hygiene. That is a reporting risk, not a safety one, and it is bounded by the accounting block: a
+low score with `counted: 1, excluded: {not-completed:pending: 743}` is legible as "almost nothing
+has finished", which is the true statement. The previous behaviour had the opposite failure — a high
+score that was structurally unfalsifiable — and an honest low number is strictly better than a
+flattering unfalsifiable one.
+
+`byType.learning` (registered learnings) and `byType.correction` (the correction ledger) are
+unchanged: both are genuine learning artifacts rather than filings, so neither was touched.
+
+## 3. Blast radius
+
+One route handler in `src/server/routes.ts`. Consumers checked:
+
+- `grep -rn "learning-velocity"` across `src/`, `scripts/`, `tests/` — the route is read by the
+  CLAUDE.md template docs and the dashboard's plain-language surface; no code branches on
+  `adaptabilityScore` or `byType.evolution`.
+- The response is ADDITIVE (`counting`, `evolutionActions`); no existing field was renamed or
+  removed, so a consumer reading `totalEvents`/`byType`/`adaptabilityScore` still parses.
+- `tests/unit/LearningVelocityScorer.test.ts` — 6 tests, unmodified, pass. The scorer is untouched.
+
+## 4. Rollback plan
+
+Single-commit revert. No state, no config key, no migration, no persisted artifact; the metric is
+recomputed from disk on every request. Reverting restores the old counting immediately.
+
+## 5. Test coverage (all three tiers)
+
+- **Unit** — `LearningVelocityScorer.test.ts` unchanged and passing (proves the pure scorer's
+  contract did not move).
+- **Integration** — `tests/integration/learning-velocity-routes.test.ts`, 7 tests. Three existing
+  cases UPDATED (see §6) and three added: the real queue in miniature (5 filed-or-abandoned + 1
+  completion → exactly 1 event, `auto-abandoned` counted as 2 and named); a `completed` action with
+  no timestamp excluded rather than back-dated; and a completion outside the window excluded by
+  DATE while still appearing in `counted`, so "counts completions" cannot become "counts every
+  completion ever".
+- **E2E** — `tests/e2e/learning-velocity-lifecycle.test.ts`: the `counting` rule and the
+  `evolutionActions` accounting must survive the PRODUCTION initialization path, because the live
+  endpoint is where a reader actually reads the number.
+
+## 6. Three existing tests were encoding the defect
+
+`learning-velocity-routes.test.ts` used action fixtures carrying only `createdAt` and asserted they
+counted as learning events. Those assertions were a specification of the inversion: they would have
+failed any correct implementation. Rewritten to use completions, with the filed-but-unfinished case
+retained and asserted as an EXCLUSION rather than deleted.
+
+This is the **third** time in one day a passing test was found protecting the defect beside it (the
+others: the standards parser's five-family allowlist, and a fixture whose meaning changed with the
+wall clock). Recorded rather than tidied away, because three instances in a day is a pattern about
+how our tests get written — they pin current behaviour, and current behaviour is what the audit
+found wanting. The class is worth a standard; it is not fixed here.