instar 1.3.435 → 1.3.436

package/package.json

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

package/upgrades/1.3.436.md

@@ -0,0 +1,19 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: minor -->
+
+## What Changed
+
+Adds a new read-only endpoint `GET /subscription-pool/in-use` and a Subscriptions-dashboard indicator that shows which pool account the agent is **currently running on** — distinct from the per-account `status: active`, which only means "healthy/usable." New `InUseAccountResolver` answers this authoritatively by probing `claude auth status` (the active-account surface the client itself uses) and matching its email to a pool account; the result is cached (60s TTL) with concurrent-probe coalescing and degrades to "unknown" rather than throwing. The dashboard fetches `/in-use` best-effort (its failure cannot blank the accounts list) and renders an "● In use now" badge plus a highlighted card on the active account. Wired as a single shared resolver instance through the server so the cache is honored. Read-only and additive: no change to session launch, account selection, or any mutation path; a zero-account pool answers `{ enabled:false }`.
+
+## What to Tell Your User
+
+Your Subscriptions dashboard now shows, at a glance, which of your accounts the agent is actually using right now — marked with a green "In use now" badge and outline. Before, every account just said "Active," which only meant it was healthy, not that it was the one in use. Now you can tell them apart. This is read-only — it just reports which account is live; it doesn't change anything about how the agent picks accounts.
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| See which account the agent is running on | Subscriptions dashboard tab — "● In use now" badge |
+| Query the active account | GET /subscription-pool/in-use |

package/upgrades/side-effects/subscription-inuse-account.md

@@ -0,0 +1,26 @@
+# Side-effects review — subscription-pool "in-use account" dashboard surface
+
+## What changed
+- New `src/core/InUseAccountResolver.ts`: resolves which pool account the agent is CURRENTLY running on, by probing `claude auth status` (the authoritative active-account surface) and matching its email to a pool account. Read-only; probe + clock injected; result cached (TTL 60s) with concurrent-probe coalescing.
+- `src/server/routes.ts`: new `GET /subscription-pool/in-use` → `{ enabled, activeAccountId, activeEmail }`. Registered before `/subscription-pool/:id` (literal beats param). Lazy-constructs a resolver if none on ctx; never 500s/503s.
+- `src/server/AgentServer.ts` + `src/commands/server.ts`: wire a single shared resolver instance through the ctor → RouteContext (so the cache is honored).
+- `dashboard/subscriptions.js`: controller fetches `/in-use` (best-effort, its failure can't blank the accounts list) and badges the in-use account card. `renderAccounts` gained an OPTIONAL trailing `inUseAccountId` param (backward compatible — existing callers/tests unaffected).
+- `dashboard/index.html`: CSS for the in-use badge + card highlight.
+
+## Blast radius
+- Purely ADDITIVE + READ-ONLY. No change to session launch, account selection, swapping, or any mutation path. A pool of zero accounts → route answers `{ enabled:false }`; single-account agents unaffected.
+- The only new side effect is spawning `claude auth status` (read-only, 15s timeout, maxBuffer bounded) at most once per 60s when the dashboard `/in-use` route is hit. If `claude` is missing or errors, the resolver degrades to `activeAccountId:null` (no badge) — never throws, never blocks.
+
+## Framework generality
+- Does NOT touch the session launch/inject abstraction (frameworkSessionLaunch / MessageDelivery). The resolver is claude-code-specific by design (it answers "which Claude account"), and `matchAccountByEmail` filters to anthropic/claude-code accounts, so a codex/gemini account can never be mis-reported as the active Claude login.
+
+## Honest scope note
+- This is the DISPLAY half of the request ("show which account is in use"). It reflects reality: normal sessions run on the default config, which this resolves authoritatively. The DETERMINISM half (pinning sessions to an explicit pool account so the default is never ambiguous) touches the critical session-launch path and is intentionally a separate, carefully-reviewed change — not bundled here. <!-- tracked: CMT-1185 -->
+
+## Migration parity
+- No agent-installed files change (no settings.json, config defaults, CLAUDE.md template, hooks, or skills). New route + dashboard asset ship with the package; existing agents get them on update. No `PostUpdateMigrator` entry needed.
+
+## Tests
+- Unit: `in-use-account-resolver.test.ts` (matcher both sides, resolve, cache TTL, coalescing, failure-degradation); `subscriptions-render.test.ts` (in-use badge present/absent).
+- Integration: `subscription-inuse-route.test.ts` (HTTP route: match / no-match / dark / does-not-shadow-`:id`).
+- E2E: `subscription-inuse-lifecycle.test.ts` (feature-alive: 200 in dark + live).