instar 1.3.486 → 1.3.488

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/dist/commands/reflect.d.ts.map +1 -1
  2. package/dist/commands/reflect.js +4 -0
  3. package/dist/commands/reflect.js.map +1 -1
  4. package/dist/commands/route.d.ts.map +1 -1
  5. package/dist/commands/route.js +3 -0
  6. package/dist/commands/route.js.map +1 -1
  7. package/dist/commands/server.d.ts.map +1 -1
  8. package/dist/commands/server.js +14 -0
  9. package/dist/commands/server.js.map +1 -1
  10. package/dist/core/CircuitBreakingIntelligenceProvider.d.ts +7 -0
  11. package/dist/core/CircuitBreakingIntelligenceProvider.d.ts.map +1 -1
  12. package/dist/core/CircuitBreakingIntelligenceProvider.js +50 -0
  13. package/dist/core/CircuitBreakingIntelligenceProvider.js.map +1 -1
  14. package/dist/core/ClaudeCliIntelligenceProvider.d.ts +5 -0
  15. package/dist/core/ClaudeCliIntelligenceProvider.d.ts.map +1 -1
  16. package/dist/core/ClaudeCliIntelligenceProvider.js +6 -1
  17. package/dist/core/ClaudeCliIntelligenceProvider.js.map +1 -1
  18. package/dist/core/CodexCliIntelligenceProvider.d.ts +58 -0
  19. package/dist/core/CodexCliIntelligenceProvider.d.ts.map +1 -1
  20. package/dist/core/CodexCliIntelligenceProvider.js +293 -27
  21. package/dist/core/CodexCliIntelligenceProvider.js.map +1 -1
  22. package/dist/core/GeminiCliIntelligenceProvider.d.ts +8 -0
  23. package/dist/core/GeminiCliIntelligenceProvider.d.ts.map +1 -1
  24. package/dist/core/GeminiCliIntelligenceProvider.js +8 -0
  25. package/dist/core/GeminiCliIntelligenceProvider.js.map +1 -1
  26. package/dist/core/PostUpdateMigrator.d.ts.map +1 -1
  27. package/dist/core/PostUpdateMigrator.js +40 -0
  28. package/dist/core/PostUpdateMigrator.js.map +1 -1
  29. package/dist/core/SafeGitExecutor.d.ts.map +1 -1
  30. package/dist/core/SafeGitExecutor.js +79 -1
  31. package/dist/core/SafeGitExecutor.js.map +1 -1
  32. package/dist/core/StateManager.d.ts +8 -0
  33. package/dist/core/StateManager.d.ts.map +1 -1
  34. package/dist/core/StateManager.js +37 -0
  35. package/dist/core/StateManager.js.map +1 -1
  36. package/dist/core/componentCategories.d.ts.map +1 -1
  37. package/dist/core/componentCategories.js +10 -0
  38. package/dist/core/componentCategories.js.map +1 -1
  39. package/dist/core/intelligenceProviderFactory.d.ts +8 -0
  40. package/dist/core/intelligenceProviderFactory.d.ts.map +1 -1
  41. package/dist/core/intelligenceProviderFactory.js +1 -0
  42. package/dist/core/intelligenceProviderFactory.js.map +1 -1
  43. package/dist/core/types.d.ts +25 -9
  44. package/dist/core/types.d.ts.map +1 -1
  45. package/dist/core/types.js.map +1 -1
  46. package/dist/messaging/slack/SlackAdapter.d.ts +3 -0
  47. package/dist/messaging/slack/SlackAdapter.d.ts.map +1 -1
  48. package/dist/messaging/slack/SlackAdapter.js +8 -1
  49. package/dist/messaging/slack/SlackAdapter.js.map +1 -1
  50. package/dist/monitoring/FeatureMetricsLedger.d.ts +123 -1
  51. package/dist/monitoring/FeatureMetricsLedger.d.ts.map +1 -1
  52. package/dist/monitoring/FeatureMetricsLedger.js +211 -25
  53. package/dist/monitoring/FeatureMetricsLedger.js.map +1 -1
  54. package/dist/providers/adapters/anthropic-interactive-pool/index.d.ts.map +1 -1
  55. package/dist/providers/adapters/anthropic-interactive-pool/index.js +1 -0
  56. package/dist/providers/adapters/anthropic-interactive-pool/index.js.map +1 -1
  57. package/dist/providers/adapters/openai-codex/transport/codexSpawn.d.ts +93 -0
  58. package/dist/providers/adapters/openai-codex/transport/codexSpawn.d.ts.map +1 -1
  59. package/dist/providers/adapters/openai-codex/transport/codexSpawn.js +339 -0
  60. package/dist/providers/adapters/openai-codex/transport/codexSpawn.js.map +1 -1
  61. package/dist/providers/adapters/openai-codex/transport/codexUsageParser.d.ts +84 -0
  62. package/dist/providers/adapters/openai-codex/transport/codexUsageParser.d.ts.map +1 -0
  63. package/dist/providers/adapters/openai-codex/transport/codexUsageParser.js +208 -0
  64. package/dist/providers/adapters/openai-codex/transport/codexUsageParser.js.map +1 -0
  65. package/dist/providers/uxConfirm/OverrideDetector.d.ts.map +1 -1
  66. package/dist/providers/uxConfirm/OverrideDetector.js +1 -0
  67. package/dist/providers/uxConfirm/OverrideDetector.js.map +1 -1
  68. package/dist/providers/uxConfirm/TaskClassifier.d.ts.map +1 -1
  69. package/dist/providers/uxConfirm/TaskClassifier.js +1 -0
  70. package/dist/providers/uxConfirm/TaskClassifier.js.map +1 -1
  71. package/dist/scaffold/templates.d.ts.map +1 -1
  72. package/dist/scaffold/templates.js +3 -2
  73. package/dist/scaffold/templates.js.map +1 -1
  74. package/dist/security/LLMSanitizer.d.ts.map +1 -1
  75. package/dist/security/LLMSanitizer.js +7 -1
  76. package/dist/security/LLMSanitizer.js.map +1 -1
  77. package/dist/server/CapabilityIndex.js +1 -1
  78. package/dist/server/CapabilityIndex.js.map +1 -1
  79. package/dist/server/routes.d.ts.map +1 -1
  80. package/dist/server/routes.js +10 -1
  81. package/dist/server/routes.js.map +1 -1
  82. package/dist/threadline/PipeSessionSpawner.d.ts.map +1 -1
  83. package/dist/threadline/PipeSessionSpawner.js +2 -0
  84. package/dist/threadline/PipeSessionSpawner.js.map +1 -1
  85. package/dist/threadline/WarrantsReplyGate.d.ts.map +1 -1
  86. package/dist/threadline/WarrantsReplyGate.js +5 -1
  87. package/dist/threadline/WarrantsReplyGate.js.map +1 -1
  88. package/package.json +4 -2
  89. package/scripts/lint-llm-attribution.js +418 -0
  90. package/scripts/lint-no-direct-destructive.js +4 -0
  91. package/scripts/pre-push-gate.js +24 -0
  92. package/src/data/builtin-manifest.json +63 -63
  93. package/src/scaffold/templates.ts +3 -2
  94. package/upgrades/1.3.487.md +39 -0
  95. package/upgrades/1.3.488.md +27 -0
  96. package/upgrades/side-effects/session-ghost-records.md +79 -0
  97. package/upgrades/side-effects/token-audit-completeness.md +84 -0
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "./builtin-manifest.schema.json",
3
3
  "schemaVersion": 1,
4
- "generatedAt": "2026-06-11T22:43:05.837Z",
5
- "instarVersion": "1.3.486",
4
+ "generatedAt": "2026-06-12T04:35:58.435Z",
5
+ "instarVersion": "1.3.488",
6
6
  "entryCount": 201,
7
7
  "entries": {
8
8
  "hook:session-start": {
@@ -11,7 +11,7 @@
11
11
  "domain": "identity",
12
12
  "sourcePath": "src/core/PostUpdateMigrator.ts",
13
13
  "installedPath": ".instar/hooks/instar/session-start.sh",
14
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
14
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
15
15
  "since": "2025-01-01"
16
16
  },
17
17
  "hook:dangerous-command-guard": {
@@ -20,7 +20,7 @@
20
20
  "domain": "safety",
21
21
  "sourcePath": "src/core/PostUpdateMigrator.ts",
22
22
  "installedPath": ".instar/hooks/instar/dangerous-command-guard.sh",
23
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
23
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
24
24
  "since": "2025-01-01"
25
25
  },
26
26
  "hook:grounding-before-messaging": {
@@ -29,7 +29,7 @@
29
29
  "domain": "safety",
30
30
  "sourcePath": "src/core/PostUpdateMigrator.ts",
31
31
  "installedPath": ".instar/hooks/instar/grounding-before-messaging.sh",
32
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
32
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
33
33
  "since": "2025-01-01"
34
34
  },
35
35
  "hook:compaction-recovery": {
@@ -38,7 +38,7 @@
38
38
  "domain": "identity",
39
39
  "sourcePath": "src/core/PostUpdateMigrator.ts",
40
40
  "installedPath": ".instar/hooks/instar/compaction-recovery.sh",
41
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
41
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
42
42
  "since": "2025-01-01"
43
43
  },
44
44
  "hook:external-operation-gate": {
@@ -47,7 +47,7 @@
47
47
  "domain": "safety",
48
48
  "sourcePath": "src/core/PostUpdateMigrator.ts",
49
49
  "installedPath": ".instar/hooks/instar/external-operation-gate.js",
50
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
50
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
51
51
  "since": "2025-01-01"
52
52
  },
53
53
  "hook:deferral-detector": {
@@ -56,7 +56,7 @@
56
56
  "domain": "safety",
57
57
  "sourcePath": "src/core/PostUpdateMigrator.ts",
58
58
  "installedPath": ".instar/hooks/instar/deferral-detector.js",
59
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
59
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
60
60
  "since": "2025-01-01"
61
61
  },
62
62
  "hook:self-stop-guard": {
@@ -65,7 +65,7 @@
65
65
  "domain": "coherence",
66
66
  "sourcePath": "src/core/PostUpdateMigrator.ts",
67
67
  "installedPath": ".instar/hooks/instar/self-stop-guard.js",
68
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
68
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
69
69
  "since": "2025-01-01"
70
70
  },
71
71
  "hook:post-action-reflection": {
@@ -74,7 +74,7 @@
74
74
  "domain": "evolution",
75
75
  "sourcePath": "src/core/PostUpdateMigrator.ts",
76
76
  "installedPath": ".instar/hooks/instar/post-action-reflection.js",
77
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
77
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
78
78
  "since": "2025-01-01"
79
79
  },
80
80
  "hook:external-communication-guard": {
@@ -83,7 +83,7 @@
83
83
  "domain": "safety",
84
84
  "sourcePath": "src/core/PostUpdateMigrator.ts",
85
85
  "installedPath": ".instar/hooks/instar/external-communication-guard.js",
86
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
86
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
87
87
  "since": "2025-01-01"
88
88
  },
89
89
  "hook:scope-coherence-collector": {
@@ -92,7 +92,7 @@
92
92
  "domain": "coherence",
93
93
  "sourcePath": "src/core/PostUpdateMigrator.ts",
94
94
  "installedPath": ".instar/hooks/instar/scope-coherence-collector.js",
95
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
95
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
96
96
  "since": "2025-01-01"
97
97
  },
98
98
  "hook:scope-coherence-checkpoint": {
@@ -101,7 +101,7 @@
101
101
  "domain": "coherence",
102
102
  "sourcePath": "src/core/PostUpdateMigrator.ts",
103
103
  "installedPath": ".instar/hooks/instar/scope-coherence-checkpoint.js",
104
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
104
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
105
105
  "since": "2025-01-01"
106
106
  },
107
107
  "hook:free-text-guard": {
@@ -110,7 +110,7 @@
110
110
  "domain": "safety",
111
111
  "sourcePath": "src/core/PostUpdateMigrator.ts",
112
112
  "installedPath": ".instar/hooks/instar/free-text-guard.sh",
113
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
113
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
114
114
  "since": "2025-01-01"
115
115
  },
116
116
  "hook:claim-intercept": {
@@ -119,7 +119,7 @@
119
119
  "domain": "coherence",
120
120
  "sourcePath": "src/core/PostUpdateMigrator.ts",
121
121
  "installedPath": ".instar/hooks/instar/claim-intercept.js",
122
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
122
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
123
123
  "since": "2025-01-01"
124
124
  },
125
125
  "hook:claim-intercept-response": {
@@ -128,7 +128,7 @@
128
128
  "domain": "coherence",
129
129
  "sourcePath": "src/core/PostUpdateMigrator.ts",
130
130
  "installedPath": ".instar/hooks/instar/claim-intercept-response.js",
131
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
131
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
132
132
  "since": "2025-01-01"
133
133
  },
134
134
  "hook:stop-gate-router": {
@@ -137,7 +137,7 @@
137
137
  "domain": "safety",
138
138
  "sourcePath": "src/core/PostUpdateMigrator.ts",
139
139
  "installedPath": ".instar/hooks/instar/stop-gate-router.js",
140
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
140
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
141
141
  "since": "2025-01-01"
142
142
  },
143
143
  "hook:auto-approve-permissions": {
@@ -146,7 +146,7 @@
146
146
  "domain": "safety",
147
147
  "sourcePath": "src/core/PostUpdateMigrator.ts",
148
148
  "installedPath": ".instar/hooks/instar/auto-approve-permissions.js",
149
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
149
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
150
150
  "since": "2025-01-01"
151
151
  },
152
152
  "job:health-check": {
@@ -418,7 +418,7 @@
418
418
  "type": "route-group",
419
419
  "domain": "monitoring",
420
420
  "sourcePath": "src/server/routes.ts",
421
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
421
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
422
422
  "since": "2025-01-01"
423
423
  },
424
424
  "route-group:agents": {
@@ -426,7 +426,7 @@
426
426
  "type": "route-group",
427
427
  "domain": "sessions",
428
428
  "sourcePath": "src/server/routes.ts",
429
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
429
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
430
430
  "since": "2025-01-01"
431
431
  },
432
432
  "route-group:backups": {
@@ -434,7 +434,7 @@
434
434
  "type": "route-group",
435
435
  "domain": "operations",
436
436
  "sourcePath": "src/server/routes.ts",
437
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
437
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
438
438
  "since": "2025-01-01"
439
439
  },
440
440
  "route-group:git": {
@@ -442,7 +442,7 @@
442
442
  "type": "route-group",
443
443
  "domain": "coordination",
444
444
  "sourcePath": "src/server/routes.ts",
445
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
445
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
446
446
  "since": "2025-01-01"
447
447
  },
448
448
  "route-group:memory": {
@@ -450,7 +450,7 @@
450
450
  "type": "route-group",
451
451
  "domain": "memory",
452
452
  "sourcePath": "src/server/routes.ts",
453
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
453
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
454
454
  "since": "2025-01-01"
455
455
  },
456
456
  "route-group:semantic": {
@@ -458,7 +458,7 @@
458
458
  "type": "route-group",
459
459
  "domain": "memory",
460
460
  "sourcePath": "src/server/routes.ts",
461
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
461
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
462
462
  "since": "2025-01-01"
463
463
  },
464
464
  "route-group:status": {
@@ -466,7 +466,7 @@
466
466
  "type": "route-group",
467
467
  "domain": "monitoring",
468
468
  "sourcePath": "src/server/routes.ts",
469
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
469
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
470
470
  "since": "2025-01-01"
471
471
  },
472
472
  "route-group:capabilities": {
@@ -474,7 +474,7 @@
474
474
  "type": "route-group",
475
475
  "domain": "mapping",
476
476
  "sourcePath": "src/server/routes.ts",
477
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
477
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
478
478
  "since": "2025-01-01"
479
479
  },
480
480
  "route-group:project-map": {
@@ -482,7 +482,7 @@
482
482
  "type": "route-group",
483
483
  "domain": "mapping",
484
484
  "sourcePath": "src/server/routes.ts",
485
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
485
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
486
486
  "since": "2025-01-01"
487
487
  },
488
488
  "route-group:coherence": {
@@ -490,7 +490,7 @@
490
490
  "type": "route-group",
491
491
  "domain": "coherence",
492
492
  "sourcePath": "src/server/routes.ts",
493
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
493
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
494
494
  "since": "2025-01-01"
495
495
  },
496
496
  "route-group:topic-bindings": {
@@ -498,7 +498,7 @@
498
498
  "type": "route-group",
499
499
  "domain": "sessions",
500
500
  "sourcePath": "src/server/routes.ts",
501
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
501
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
502
502
  "since": "2025-01-01"
503
503
  },
504
504
  "route-group:context": {
@@ -506,7 +506,7 @@
506
506
  "type": "route-group",
507
507
  "domain": "context",
508
508
  "sourcePath": "src/server/routes.ts",
509
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
509
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
510
510
  "since": "2025-01-01"
511
511
  },
512
512
  "route-group:scope-coherence": {
@@ -514,7 +514,7 @@
514
514
  "type": "route-group",
515
515
  "domain": "coherence",
516
516
  "sourcePath": "src/server/routes.ts",
517
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
517
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
518
518
  "since": "2025-01-01"
519
519
  },
520
520
  "route-group:canonical-state": {
@@ -522,7 +522,7 @@
522
522
  "type": "route-group",
523
523
  "domain": "state",
524
524
  "sourcePath": "src/server/routes.ts",
525
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
525
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
526
526
  "since": "2025-01-01"
527
527
  },
528
528
  "route-group:ci": {
@@ -530,7 +530,7 @@
530
530
  "type": "route-group",
531
531
  "domain": "monitoring",
532
532
  "sourcePath": "src/server/routes.ts",
533
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
533
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
534
534
  "since": "2025-01-01"
535
535
  },
536
536
  "route-group:sessions": {
@@ -538,7 +538,7 @@
538
538
  "type": "route-group",
539
539
  "domain": "sessions",
540
540
  "sourcePath": "src/server/routes.ts",
541
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
541
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
542
542
  "since": "2025-01-01"
543
543
  },
544
544
  "route-group:jobs": {
@@ -546,7 +546,7 @@
546
546
  "type": "route-group",
547
547
  "domain": "scheduling",
548
548
  "sourcePath": "src/server/routes.ts",
549
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
549
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
550
550
  "since": "2025-01-01"
551
551
  },
552
552
  "route-group:skip-ledger": {
@@ -554,7 +554,7 @@
554
554
  "type": "route-group",
555
555
  "domain": "scheduling",
556
556
  "sourcePath": "src/server/routes.ts",
557
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
557
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
558
558
  "since": "2025-01-01"
559
559
  },
560
560
  "route-group:telegram": {
@@ -562,7 +562,7 @@
562
562
  "type": "route-group",
563
563
  "domain": "communication",
564
564
  "sourcePath": "src/server/routes.ts",
565
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
565
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
566
566
  "since": "2025-01-01"
567
567
  },
568
568
  "route-group:attention": {
@@ -570,7 +570,7 @@
570
570
  "type": "route-group",
571
571
  "domain": "communication",
572
572
  "sourcePath": "src/server/routes.ts",
573
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
573
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
574
574
  "since": "2025-01-01"
575
575
  },
576
576
  "route-group:relationships": {
@@ -578,7 +578,7 @@
578
578
  "type": "route-group",
579
579
  "domain": "relationships",
580
580
  "sourcePath": "src/server/routes.ts",
581
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
581
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
582
582
  "since": "2025-01-01"
583
583
  },
584
584
  "route-group:feedback": {
@@ -586,7 +586,7 @@
586
586
  "type": "route-group",
587
587
  "domain": "feedback",
588
588
  "sourcePath": "src/server/routes.ts",
589
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
589
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
590
590
  "since": "2025-01-01"
591
591
  },
592
592
  "route-group:updates": {
@@ -594,7 +594,7 @@
594
594
  "type": "route-group",
595
595
  "domain": "updates",
596
596
  "sourcePath": "src/server/routes.ts",
597
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
597
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
598
598
  "since": "2025-01-01"
599
599
  },
600
600
  "route-group:dispatches": {
@@ -602,7 +602,7 @@
602
602
  "type": "route-group",
603
603
  "domain": "dispatches",
604
604
  "sourcePath": "src/server/routes.ts",
605
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
605
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
606
606
  "since": "2025-01-01"
607
607
  },
608
608
  "route-group:quota": {
@@ -610,7 +610,7 @@
610
610
  "type": "route-group",
611
611
  "domain": "monitoring",
612
612
  "sourcePath": "src/server/routes.ts",
613
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
613
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
614
614
  "since": "2025-01-01"
615
615
  },
616
616
  "route-group:publishing": {
@@ -618,7 +618,7 @@
618
618
  "type": "route-group",
619
619
  "domain": "publishing",
620
620
  "sourcePath": "src/server/routes.ts",
621
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
621
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
622
622
  "since": "2025-01-01"
623
623
  },
624
624
  "route-group:private-views": {
@@ -626,7 +626,7 @@
626
626
  "type": "route-group",
627
627
  "domain": "publishing",
628
628
  "sourcePath": "src/server/routes.ts",
629
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
629
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
630
630
  "since": "2025-01-01"
631
631
  },
632
632
  "route-group:tunnel": {
@@ -634,7 +634,7 @@
634
634
  "type": "route-group",
635
635
  "domain": "networking",
636
636
  "sourcePath": "src/server/routes.ts",
637
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
637
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
638
638
  "since": "2025-01-01"
639
639
  },
640
640
  "route-group:events": {
@@ -642,7 +642,7 @@
642
642
  "type": "route-group",
643
643
  "domain": "networking",
644
644
  "sourcePath": "src/server/routes.ts",
645
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
645
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
646
646
  "since": "2025-01-01"
647
647
  },
648
648
  "route-group:evolution": {
@@ -650,7 +650,7 @@
650
650
  "type": "route-group",
651
651
  "domain": "evolution",
652
652
  "sourcePath": "src/server/routes.ts",
653
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
653
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
654
654
  "since": "2025-01-01"
655
655
  },
656
656
  "route-group:watchdog": {
@@ -658,7 +658,7 @@
658
658
  "type": "route-group",
659
659
  "domain": "monitoring",
660
660
  "sourcePath": "src/server/routes.ts",
661
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
661
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
662
662
  "since": "2025-01-01"
663
663
  },
664
664
  "route-group:topic-memory": {
@@ -666,7 +666,7 @@
666
666
  "type": "route-group",
667
667
  "domain": "memory",
668
668
  "sourcePath": "src/server/routes.ts",
669
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
669
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
670
670
  "since": "2025-01-01"
671
671
  },
672
672
  "route-group:state-sync": {
@@ -674,7 +674,7 @@
674
674
  "type": "route-group",
675
675
  "domain": "coordination",
676
676
  "sourcePath": "src/server/routes.ts",
677
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
677
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
678
678
  "since": "2025-01-01"
679
679
  },
680
680
  "route-group:intent": {
@@ -682,7 +682,7 @@
682
682
  "type": "route-group",
683
683
  "domain": "intent",
684
684
  "sourcePath": "src/server/routes.ts",
685
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
685
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
686
686
  "since": "2025-01-01"
687
687
  },
688
688
  "route-group:triage": {
@@ -690,7 +690,7 @@
690
690
  "type": "route-group",
691
691
  "domain": "safety",
692
692
  "sourcePath": "src/server/routes.ts",
693
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
693
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
694
694
  "since": "2025-01-01"
695
695
  },
696
696
  "route-group:operations": {
@@ -698,7 +698,7 @@
698
698
  "type": "route-group",
699
699
  "domain": "safety",
700
700
  "sourcePath": "src/server/routes.ts",
701
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
701
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
702
702
  "since": "2025-01-01"
703
703
  },
704
704
  "route-group:sentinel": {
@@ -706,7 +706,7 @@
706
706
  "type": "route-group",
707
707
  "domain": "safety",
708
708
  "sourcePath": "src/server/routes.ts",
709
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
709
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
710
710
  "since": "2025-01-01"
711
711
  },
712
712
  "route-group:trust": {
@@ -714,7 +714,7 @@
714
714
  "type": "route-group",
715
715
  "domain": "safety",
716
716
  "sourcePath": "src/server/routes.ts",
717
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
717
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
718
718
  "since": "2025-01-01"
719
719
  },
720
720
  "route-group:monitoring": {
@@ -722,7 +722,7 @@
722
722
  "type": "route-group",
723
723
  "domain": "monitoring",
724
724
  "sourcePath": "src/server/routes.ts",
725
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
725
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
726
726
  "since": "2025-01-01"
727
727
  },
728
728
  "route-group:commitments": {
@@ -730,7 +730,7 @@
730
730
  "type": "route-group",
731
731
  "domain": "commitments",
732
732
  "sourcePath": "src/server/routes.ts",
733
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
733
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
734
734
  "since": "2025-01-01"
735
735
  },
736
736
  "route-group:episodes": {
@@ -738,7 +738,7 @@
738
738
  "type": "route-group",
739
739
  "domain": "memory",
740
740
  "sourcePath": "src/server/routes.ts",
741
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
741
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
742
742
  "since": "2025-01-01"
743
743
  },
744
744
  "route-group:messages": {
@@ -746,7 +746,7 @@
746
746
  "type": "route-group",
747
747
  "domain": "coordination",
748
748
  "sourcePath": "src/server/routes.ts",
749
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
749
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
750
750
  "since": "2025-01-01"
751
751
  },
752
752
  "route-group:system-reviews": {
@@ -754,7 +754,7 @@
754
754
  "type": "route-group",
755
755
  "domain": "monitoring",
756
756
  "sourcePath": "src/server/routes.ts",
757
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
757
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
758
758
  "since": "2025-01-01"
759
759
  },
760
760
  "route-group:machine-mesh": {
@@ -770,7 +770,7 @@
770
770
  "type": "route-group",
771
771
  "domain": "security",
772
772
  "sourcePath": "src/server/routes.ts",
773
- "contentHash": "3aa1f43fd6aec2dba257b59301b3b6b7e5dc214d7a1bb14f30ff9560f1644c63",
773
+ "contentHash": "5ec77634db273a40d1d6df1e48f050205570f7adf07100e39ce0ccdb087cc73e",
774
774
  "since": "2025-01-01"
775
775
  },
776
776
  "cli:init": {
@@ -1554,7 +1554,7 @@
1554
1554
  "type": "subsystem",
1555
1555
  "domain": "updates",
1556
1556
  "sourcePath": "src/core/PostUpdateMigrator.ts",
1557
- "contentHash": "170d09fc2df979e6ce495f6e3ff092e5bfbd5e54623ef16d421446d534416b4c",
1557
+ "contentHash": "af0b83a1a094d4b9bdad1786490626f9d0c7d8152e2dced208bb6b6562c0a9c1",
1558
1558
  "since": "2025-01-01"
1559
1559
  },
1560
1560
  "subsystem:scheduler": {
@@ -727,9 +727,10 @@ This routes feedback to the Instar maintainers automatically. Valid types: \`bug
727
727
 
728
728
  **Per-Feature LLM Metrics & LLM Activity (Observable Intelligence)** — Audit what each of your LLM-driven gates/sentinels actually does: WHICH provider + model ran it, how often it ACTED (fired) vs found nothing (noop), how often it was skipped to save rate limits (shed), cost, and latency. This is the *Observable Intelligence* standard — no autonomous AI action the system takes is allowed to be invisible. Read-only observability — it never gates anything.
729
729
  - Check: \`curl -H "Authorization: Bearer $AUTH" "http://localhost:${port}/metrics/features?sinceHours=24"\`
730
- - Returns \`{ totals, features: [{ feature, frameworks, models, calls, realCalls, tokensIn, tokensOut, fired, noop, shed, fireRate, p50LatencyMs, p95LatencyMs, ... }] }\` — one row per system (e.g. MessagingToneGate, MessageSentinel). \`frameworks\`/\`models\` = which provider(s) actually served the call; \`fireRate\` = how often it acts; \`shed\` = skipped by the rate-limit guard. Filter with \`?feature=<name>\`.
730
+ - Returns \`{ totals, features: [{ feature, frameworks, models, byModel, calls, realCalls, tokensIn, tokensOut, tokensCached, fired, noop, shed, fireRate, p50LatencyMs, p95LatencyMs, ... }] }\` — one row per system (e.g. MessagingToneGate, MessageSentinel). \`frameworks\`/\`models\` = which provider(s) actually served the call; \`fireRate\` = how often it acts; \`shed\` = skipped by the rate-limit guard. Filter with \`?feature=<name>\`.
731
+ - **Per-model token breakdown (Token-Audit Completeness):** each feature row carries \`byModel\` (feature×model×framework token split incl. \`tokensCached\`, the cache-read subset of \`tokensIn\`); \`totals.byModel\` is the cross-feature aggregate. \`totals.usageCoverage\` reports, per framework, the share of successful calls that recorded REAL token usage — 0 coverage on a non-exempt framework is the drift alarm, not noise (codex reports per-call tokens via exec --json; gemini-cli is the documented exemption). \`totals.unlabeledTokenShare\` + \`totals.unlabeledCallShare\` track unattributed spend (baseline zero, lint-ratcheted).
731
732
  - **Dashboard:** the **LLM Activity** tab renders all of this in plain language over a 24h / 7d / 30d window — point the user there rather than pasting curl output.
732
- - **When to use** (PROACTIVE): "which provider is this sentinel running on?" / "are the sentinels actually doing real work or just being skipped?" / "which checks cost the most or fire the least?" / before tuning a sentinel or gate → read the numbers (\`frameworks\`/\`models\` for provider, \`fireRate\` for effectiveness, \`shed\` for skip rate) instead of guessing. Bounded retention (~30 days; tune \`monitoring.featureMetrics.retentionDays\`). (Specs: \`docs/specs/observable-intelligence.md\`, \`docs/specs/llm-feature-metrics-spec.md\`.)
733
+ - **When to use** (PROACTIVE): "which provider is this sentinel running on?" / "how many tokens did feature X spend, on which model?" / "are we audit-blind anywhere?" / "are the sentinels actually doing real work or just being skipped?" / before tuning a sentinel or gate → read the numbers (\`byModel\` for cost-per-model, \`usageCoverage\` for audit-blindness, \`fireRate\` for effectiveness, \`shed\` for skip rate) instead of guessing. Bounded retention (~30 days; tune \`monitoring.featureMetrics.retentionDays\`). (Specs: \`docs/specs/observable-intelligence.md\`, \`docs/specs/llm-feature-metrics-spec.md\`, \`docs/specs/token-audit-completeness.md\`.)
733
734
 
734
735
  **Resource Usage (CPU + memory + rate-limit events)** — Durable per-agent record of what you actually consume, mirroring the TokenLedger. Read-only observability — it never gates. Two parts:
735
736
  - **CPU + memory** (Phase B): your server process and every running session are sampled continuously for CPU% and memory (RSS). Check current + windowed (avg/peak) usage, broken down per source plus an aggregate: \`curl -H "Authorization: Bearer $AUTH" "http://localhost:${port}/resources/summary?sinceHours=1"\` → \`{ sampleCount, sources: [{ source, currentCpuPercent, currentRssBytes, avgCpuPercent, peakCpuPercent, peakRssBytes, ... }] }\` (\`source\` is \`agent-server\`, \`session:<id>\`, or \`aggregate\`). Recent raw samples: \`GET /resources/samples?sinceHours=1&source=aggregate&limit=20\`. The dashboard "Resource Usage" tab renders all of this in plain language.
@@ -0,0 +1,39 @@
1
+ # Upgrade Guide — vNEXT
2
+
3
+ <!-- assembled-by: assemble-next-md -->
4
+ <!-- bump: minor -->
5
+
6
+ ## What Changed
7
+
8
+ Implements `docs/specs/token-audit-completeness.md` (converged r6, operator-ratified: *"full token auditability — per feature AND per model — is a requirement for any feature"*). Closes the four holes in the existing `/metrics/features` funnel:
9
+
10
+ - **Codex calls report real tokens.** `CodexCliIntelligenceProvider` now runs `codex exec --json` through a new streaming spawn helper (`spawnCodexExecJson` in `codexSpawn.ts`): per-call `tokensIn/tokensOut/tokensCached` are parsed line-wise from the event stream (top-level `JSON.parse` + shape validation — model content can never inject counts), while the ANSWER comes only from the `--output-last-message` file (events are signal, the file is authority). The prompt moves off argv to stdin (not `ps`-visible; no ARG_MAX ceiling). Kill-switch: `intelligence.codexExecJson: false` (30s TTL, no restart) or `INSTAR_CODEX_EXEC_JSON=0` restores the previous invocation byte-for-byte. (Note: the legacy path it restores passes the prompt on argv and embeds it in execFile error messages — a pre-existing disclosure channel the json path closes; flipping the switch re-opens it along with token-blindness.)
11
+ - **Failed calls keep their burned cost.** The funnel's error path now records whatever usage the provider parsed before failing — including a timeout-killed call's final post-SIGTERM token count (settlement ordering pinned by tests). Flaky features can no longer look cheap.
12
+ - **Per-model breakdown.** `/metrics/features` gains `byModel` per feature + `totals.byModel` (feature×model×framework, incl. `tokensCached` — the cache-read subset of `tokensIn`), `totals.usageCoverage` (per-framework share of successful calls with real usage; success-only denominator; gemini documented-exempt, interactive-pool excluded, pi/codex NOT exempt), and `totals.unlabeledTokenShare` + `totals.unlabeledCallShare` — all from ONE composite GROUP BY (net-zero extra window scans).
13
+ - **Attribution is structure, not willpower.** All 8 previously-untagged funnel callsites are tagged + registered in `componentCategories.ts`; new lint `scripts/lint-llm-attribution.js` (in the `npm run lint` chain) fails CI on any untagged LLM callsite, with an EMPTY violations allowlist pinned by a ratchet test (3 lists pinned: allowlist, FUNNEL_FILES, wiring exclusions). Runtime backstop: a once-per-process `unlabeled-llm-call` degradation event.
14
+ - **Drift tripwires.** A successful codex `--json` call recording zero usage emits `codex-usage-parse-drift` (fixed constant, once per process); a live integration canary runs ONE real codex call and FAILS on success-with-zero-usage (named-skip on environmental trouble only). `usageCoverage` is the durable surface.
15
+ - **Audit-log rotation.** Per-call SafeFs deletions make `destructive-ops.jsonl` hot-path; `appendAuditEntry` now rotates at 16 MB (rename → `.1`, re-stat-before-rename race guard, rotation-marker first entry so a shrunken log is never mysterious).
16
+ - **Constitution:** new Shipping standard *"Token-Audit Completeness — An Unmetered LLM Call Is an Unaccountable One"* (`docs/STANDARDS-REGISTRY.md`), ratified by operator directive (topic 22726, 2026-06-10). The cartographer freshness sweep's enablement precondition now exists; the sweep itself stays OFF (unchanged posture).
17
+
18
+ ## What to Tell Your User
19
+
20
+ - "You can now see exactly how many tokens every one of my internal AI features spends — broken down by feature AND by model, including my codex-routed calls, which used to report zero. Ask me 'how much did X spend?' or check the LLM Activity tab."
21
+ - "If token counting ever silently breaks (say a codex update changes its output), I'll know — there's a coverage number that drops and a tripwire that fires, instead of quiet blindness."
22
+ - "Failed calls now count their cost too, so a flaky feature can't hide what it burns."
23
+
24
+ ## Summary of New Capabilities
25
+
26
+ | Capability | How to Use |
27
+ |-----------|-----------|
28
+ | Per-call codex token usage | Automatic on every codex-routed internal call (`codex exec --json`) |
29
+ | Feature×model token breakdown | `GET /metrics/features` → `features[].byModel`, `totals.byModel` |
30
+ | Usage-coverage drift surface | `GET /metrics/features` → `totals.usageCoverage` (per framework) |
31
+ | Unlabeled-spend shares | `totals.unlabeledTokenShare` / `totals.unlabeledCallShare` (baseline 0) |
32
+ | Attribution lint + ratchet | Automatic in `npm run lint` / pre-commit; empty-baseline allowlist |
33
+ | Codex exec-json kill-switch | `intelligence.codexExecJson: false` or `INSTAR_CODEX_EXEC_JSON=0` |
34
+
35
+ ## Evidence
36
+
37
+ - 92 new unit tests across 8 files (parser, spawn mechanics incl. real-child EPIPE/stderr-drain/held-fd fixtures, out-dir lifecycle + sweep brakes, kill-switch resolution, funnel error rows end-to-end, byFeatureModel/coverage/shares, audit rotation, lint self-test + 3-list ratchet, provider usage-contract, drift once-per-process) — all green; full unit + integration + e2e suites green; `tsc` + full lint chain clean.
38
+ - **Live canary validated against the real codex CLI on the dev machine:** one real `codex exec --json` call completed and recorded usage end-to-end through the new path.
39
+ - Independent second-pass review of the side-effects artifact (`upgrades/side-effects/token-audit-completeness.md`) + security and spec-conformance review agents.
@@ -0,0 +1,27 @@
1
+ # Upgrade Guide — vNEXT
2
+
3
+ <!-- assembled-by: assemble-next-md -->
4
+ <!-- bump: patch -->
5
+
6
+ ## What Changed
7
+
8
+ Fixes the registry leak that made the dashboard show N "duplicate sessions" that were really one terminal plus N−1 stale bookkeeping records (2026-06-11 Mac Mini: 5 `running` records all pointing at the single tmux session `echo-resource-limitation-mitigation`, leaked one-per-respawn during the June crisis).
9
+
10
+ `StateManager.saveSession` — the single funnel every spawn/update callsite passes through — now enforces *one live record per tmux session name*: a record registering as `running`/`starting` supersedes any OTHER record still marked live for the same `tmuxSession` (closed as `completed` with `endedReason: 'superseded'` + new additive `Session.supersededBy` field naming the replacement). Ghosts close through `saveSession` itself, so the coherence journal records each transition. Best-effort + fail-open: hygiene can never block the live registration. Per-machine registries only — a tmux name legitimately reused on another machine collides with nothing. Existing on-disk ghosts self-heal on each name's next respawn.
11
+
12
+ ## What to Tell Your User
13
+
14
+ - "The dashboard no longer shows duplicate copies of one session — each real terminal appears exactly once. Leftover duplicates from old restarts clean themselves up the next time that session restarts."
15
+
16
+ ## Summary of New Capabilities
17
+
18
+ | Capability | How to Use |
19
+ |-----------|-----------|
20
+ | One dashboard entry per real terminal | Automatic — no settings, no migration |
21
+ | Ghost forensics | A superseded record carries `supersededBy` (the replacing record's id) + `endedReason: 'superseded'` |
22
+
23
+ ## Evidence
24
+
25
+ - 6 new unit tests (3 behavior — proven failing on the unfixed code first, including the exact 5-ghost Mac Mini shape — + 3 no-op guards: same-id re-saves, distinct names, terminal saves). One existing fixture updated (it unknowingly relied on two running records sharing one tmux name — the bug shape itself).
26
+ - StateManager test family (7 files, 96 tests) green; full unit suite green; `pnpm build` clean.
27
+ - Independent second-pass review (session-lifecycle adjacency) appended to the side-effects artifact.