instar 1.3.343 → 1.3.345

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 (147) hide show
  1. package/dist/commands/init.d.ts +4 -4
  2. package/dist/commands/init.d.ts.map +1 -1
  3. package/dist/commands/init.js.map +1 -1
  4. package/dist/commands/reflect.d.ts.map +1 -1
  5. package/dist/commands/reflect.js +7 -0
  6. package/dist/commands/reflect.js.map +1 -1
  7. package/dist/commands/server.d.ts.map +1 -1
  8. package/dist/commands/server.js +126 -8
  9. package/dist/commands/server.js.map +1 -1
  10. package/dist/commands/setup.d.ts +1 -1
  11. package/dist/commands/setup.d.ts.map +1 -1
  12. package/dist/commands/setup.js.map +1 -1
  13. package/dist/core/Config.d.ts +12 -3
  14. package/dist/core/Config.d.ts.map +1 -1
  15. package/dist/core/Config.js +40 -6
  16. package/dist/core/Config.js.map +1 -1
  17. package/dist/core/FrameworkSessionStore.d.ts +1 -1
  18. package/dist/core/FrameworkSessionStore.d.ts.map +1 -1
  19. package/dist/core/PiCliIntelligenceProvider.d.ts +52 -0
  20. package/dist/core/PiCliIntelligenceProvider.d.ts.map +1 -0
  21. package/dist/core/PiCliIntelligenceProvider.js +71 -0
  22. package/dist/core/PiCliIntelligenceProvider.js.map +1 -0
  23. package/dist/core/PostUpdateMigrator.d.ts.map +1 -1
  24. package/dist/core/PostUpdateMigrator.js +57 -0
  25. package/dist/core/PostUpdateMigrator.js.map +1 -1
  26. package/dist/core/PreCompactionFlush.d.ts +1 -1
  27. package/dist/core/PreCompactionFlush.d.ts.map +1 -1
  28. package/dist/core/ResumeValidator.d.ts +1 -1
  29. package/dist/core/ResumeValidator.d.ts.map +1 -1
  30. package/dist/core/SessionManager.d.ts +130 -0
  31. package/dist/core/SessionManager.d.ts.map +1 -1
  32. package/dist/core/SessionManager.js +545 -10
  33. package/dist/core/SessionManager.js.map +1 -1
  34. package/dist/core/TopicFrameworksStore.d.ts.map +1 -1
  35. package/dist/core/TopicFrameworksStore.js +3 -0
  36. package/dist/core/TopicFrameworksStore.js.map +1 -1
  37. package/dist/core/frameworkInjectionProcesses.d.ts.map +1 -1
  38. package/dist/core/frameworkInjectionProcesses.js +4 -0
  39. package/dist/core/frameworkInjectionProcesses.js.map +1 -1
  40. package/dist/core/frameworkSessionLaunch.d.ts +8 -0
  41. package/dist/core/frameworkSessionLaunch.d.ts.map +1 -1
  42. package/dist/core/frameworkSessionLaunch.js +73 -0
  43. package/dist/core/frameworkSessionLaunch.js.map +1 -1
  44. package/dist/core/intelligenceProviderFactory.d.ts +15 -1
  45. package/dist/core/intelligenceProviderFactory.d.ts.map +1 -1
  46. package/dist/core/intelligenceProviderFactory.js +39 -1
  47. package/dist/core/intelligenceProviderFactory.js.map +1 -1
  48. package/dist/core/types.d.ts +88 -8
  49. package/dist/core/types.d.ts.map +1 -1
  50. package/dist/core/types.js.map +1 -1
  51. package/dist/messaging/SpawnRequestManager.d.ts +14 -0
  52. package/dist/messaging/SpawnRequestManager.d.ts.map +1 -1
  53. package/dist/messaging/SpawnRequestManager.js +17 -0
  54. package/dist/messaging/SpawnRequestManager.js.map +1 -1
  55. package/dist/messaging/shared/telegramRelayPrompt.d.ts +1 -1
  56. package/dist/messaging/shared/telegramRelayPrompt.d.ts.map +1 -1
  57. package/dist/monitoring/ApprenticeshipCycleStore.d.ts +59 -1
  58. package/dist/monitoring/ApprenticeshipCycleStore.d.ts.map +1 -1
  59. package/dist/monitoring/ApprenticeshipCycleStore.js +77 -2
  60. package/dist/monitoring/ApprenticeshipCycleStore.js.map +1 -1
  61. package/dist/monitoring/ReapLog.d.ts +6 -0
  62. package/dist/monitoring/ReapLog.d.ts.map +1 -1
  63. package/dist/monitoring/ReapLog.js +1 -0
  64. package/dist/monitoring/ReapLog.js.map +1 -1
  65. package/dist/monitoring/SessionReaper.d.ts +1 -1
  66. package/dist/monitoring/SessionReaper.d.ts.map +1 -1
  67. package/dist/monitoring/SessionReaper.js.map +1 -1
  68. package/dist/monitoring/frameworkActivitySignals.d.ts.map +1 -1
  69. package/dist/monitoring/frameworkActivitySignals.js +21 -0
  70. package/dist/monitoring/frameworkActivitySignals.js.map +1 -1
  71. package/dist/monitoring/frameworkProcessSignals.d.ts.map +1 -1
  72. package/dist/monitoring/frameworkProcessSignals.js +22 -0
  73. package/dist/monitoring/frameworkProcessSignals.js.map +1 -1
  74. package/dist/providers/adapters/pi-cli/capabilities.d.ts +31 -0
  75. package/dist/providers/adapters/pi-cli/capabilities.d.ts.map +1 -0
  76. package/dist/providers/adapters/pi-cli/capabilities.js +40 -0
  77. package/dist/providers/adapters/pi-cli/capabilities.js.map +1 -0
  78. package/dist/providers/adapters/pi-cli/config.d.ts +65 -0
  79. package/dist/providers/adapters/pi-cli/config.d.ts.map +1 -0
  80. package/dist/providers/adapters/pi-cli/config.js +43 -0
  81. package/dist/providers/adapters/pi-cli/config.js.map +1 -0
  82. package/dist/providers/adapters/pi-cli/control/piHardKill.d.ts +19 -0
  83. package/dist/providers/adapters/pi-cli/control/piHardKill.d.ts.map +1 -0
  84. package/dist/providers/adapters/pi-cli/control/piHardKill.js +67 -0
  85. package/dist/providers/adapters/pi-cli/control/piHardKill.js.map +1 -0
  86. package/dist/providers/adapters/pi-cli/errors.d.ts +43 -0
  87. package/dist/providers/adapters/pi-cli/errors.d.ts.map +1 -0
  88. package/dist/providers/adapters/pi-cli/errors.js +71 -0
  89. package/dist/providers/adapters/pi-cli/errors.js.map +1 -0
  90. package/dist/providers/adapters/pi-cli/index.d.ts +39 -0
  91. package/dist/providers/adapters/pi-cli/index.d.ts.map +1 -0
  92. package/dist/providers/adapters/pi-cli/index.js +69 -0
  93. package/dist/providers/adapters/pi-cli/index.js.map +1 -0
  94. package/dist/providers/adapters/pi-cli/observability/sessionId.d.ts +27 -0
  95. package/dist/providers/adapters/pi-cli/observability/sessionId.d.ts.map +1 -0
  96. package/dist/providers/adapters/pi-cli/observability/sessionId.js +53 -0
  97. package/dist/providers/adapters/pi-cli/observability/sessionId.js.map +1 -0
  98. package/dist/providers/adapters/pi-cli/policy.d.ts +44 -0
  99. package/dist/providers/adapters/pi-cli/policy.d.ts.map +1 -0
  100. package/dist/providers/adapters/pi-cli/policy.js +74 -0
  101. package/dist/providers/adapters/pi-cli/policy.js.map +1 -0
  102. package/dist/providers/adapters/pi-cli/transport/agenticSessionRpc.d.ts +34 -0
  103. package/dist/providers/adapters/pi-cli/transport/agenticSessionRpc.d.ts.map +1 -0
  104. package/dist/providers/adapters/pi-cli/transport/agenticSessionRpc.js +194 -0
  105. package/dist/providers/adapters/pi-cli/transport/agenticSessionRpc.js.map +1 -0
  106. package/dist/providers/adapters/pi-cli/transport/oneShotCompletion.d.ts +33 -0
  107. package/dist/providers/adapters/pi-cli/transport/oneShotCompletion.d.ts.map +1 -0
  108. package/dist/providers/adapters/pi-cli/transport/oneShotCompletion.js +166 -0
  109. package/dist/providers/adapters/pi-cli/transport/oneShotCompletion.js.map +1 -0
  110. package/dist/providers/adapters/pi-cli/transport/piSpawn.d.ts +87 -0
  111. package/dist/providers/adapters/pi-cli/transport/piSpawn.d.ts.map +1 -0
  112. package/dist/providers/adapters/pi-cli/transport/piSpawn.js +242 -0
  113. package/dist/providers/adapters/pi-cli/transport/piSpawn.js.map +1 -0
  114. package/dist/providers/adapters/pi-cli/transport/rpcClient.d.ts +103 -0
  115. package/dist/providers/adapters/pi-cli/transport/rpcClient.d.ts.map +1 -0
  116. package/dist/providers/adapters/pi-cli/transport/rpcClient.js +238 -0
  117. package/dist/providers/adapters/pi-cli/transport/rpcClient.js.map +1 -0
  118. package/dist/providers/bootRegistration.d.ts +38 -0
  119. package/dist/providers/bootRegistration.d.ts.map +1 -1
  120. package/dist/providers/bootRegistration.js +52 -0
  121. package/dist/providers/bootRegistration.js.map +1 -1
  122. package/dist/providers/parity/rules/skillParityRule.d.ts.map +1 -1
  123. package/dist/providers/parity/rules/skillParityRule.js +6 -0
  124. package/dist/providers/parity/rules/skillParityRule.js.map +1 -1
  125. package/dist/scaffold/templates.d.ts.map +1 -1
  126. package/dist/scaffold/templates.js +3 -2
  127. package/dist/scaffold/templates.js.map +1 -1
  128. package/dist/scheduler/JobScheduler.d.ts.map +1 -1
  129. package/dist/scheduler/JobScheduler.js +22 -0
  130. package/dist/scheduler/JobScheduler.js.map +1 -1
  131. package/dist/server/routes.d.ts.map +1 -1
  132. package/dist/server/routes.js +10 -3
  133. package/dist/server/routes.js.map +1 -1
  134. package/dist/threadline/PipeSessionSpawner.d.ts +23 -0
  135. package/dist/threadline/PipeSessionSpawner.d.ts.map +1 -1
  136. package/dist/threadline/PipeSessionSpawner.js +27 -0
  137. package/dist/threadline/PipeSessionSpawner.js.map +1 -1
  138. package/package.json +2 -2
  139. package/scripts/lint-no-direct-destructive.js +3 -0
  140. package/scripts/lint-no-unfunneled-headless-launch.js +128 -0
  141. package/src/data/builtin-manifest.json +65 -65
  142. package/src/scaffold/templates.ts +3 -2
  143. package/upgrades/1.3.344.md +46 -0
  144. package/upgrades/1.3.345.md +154 -0
  145. package/upgrades/side-effects/apprenticeship-layer-balance.md +50 -0
  146. package/upgrades/side-effects/june15-headless-spawn-reroute.md +105 -0
  147. package/upgrades/side-effects/pi-harness-integration.md +82 -0
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "./builtin-manifest.schema.json",
3
3
  "schemaVersion": 1,
4
- "generatedAt": "2026-06-06T05:21:01.567Z",
5
- "instarVersion": "1.3.343",
4
+ "generatedAt": "2026-06-06T05:35:52.668Z",
5
+ "instarVersion": "1.3.345",
6
6
  "entryCount": 199,
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
14
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
23
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
32
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
41
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
50
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
59
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
68
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
77
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
86
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
95
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
104
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
113
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
122
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
131
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
140
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
149
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
421
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
429
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
437
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
445
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
453
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
461
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
469
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
477
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
485
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
493
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
501
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
509
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
517
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
525
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
533
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
541
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
549
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
557
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
565
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
573
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
581
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
589
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
597
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
605
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
613
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
621
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
629
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
637
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
645
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
653
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
661
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
669
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
677
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
685
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
693
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
701
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
709
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
717
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
725
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
733
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
741
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
749
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
757
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
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": "b11ae6bb0dcb2aa8c720ca90f03f228089916f89feeb25dff7856351d9056197",
773
+ "contentHash": "014d019d06282359a2d00546243006a86f1fd450663b9f33cdd8235d9d7e0719",
774
774
  "since": "2025-01-01"
775
775
  },
776
776
  "cli:init": {
@@ -1514,7 +1514,7 @@
1514
1514
  "type": "subsystem",
1515
1515
  "domain": "sessions",
1516
1516
  "sourcePath": "src/core/SessionManager.ts",
1517
- "contentHash": "f1ad95fc998ebb7bb8bf0c447939791e6c3791de704880f30ed0b0df270fa538",
1517
+ "contentHash": "a7d126e3eae782ae7b6eb2f3146b326cf2e14eae89376d91720526736d90fda9",
1518
1518
  "since": "2025-01-01"
1519
1519
  },
1520
1520
  "subsystem:auto-updater": {
@@ -1538,7 +1538,7 @@
1538
1538
  "type": "subsystem",
1539
1539
  "domain": "updates",
1540
1540
  "sourcePath": "src/core/PostUpdateMigrator.ts",
1541
- "contentHash": "67606a9d2c94d2b88f5ec21a08965b25afbbb43e1291de2ebdd0cc77dfed949c",
1541
+ "contentHash": "6449c8a2aaab14962a8e871a700feea312280a30e08d40f35d6c4af7b19a6e90",
1542
1542
  "since": "2025-01-01"
1543
1543
  },
1544
1544
  "subsystem:scheduler": {
@@ -1546,7 +1546,7 @@
1546
1546
  "type": "subsystem",
1547
1547
  "domain": "scheduling",
1548
1548
  "sourcePath": "src/scheduler/JobScheduler.ts",
1549
- "contentHash": "8928d7c0d671f0b68e4b1616cc34fe9f377fe42d59d17c1da6285581ef2de7b3",
1549
+ "contentHash": "b786cda09924038b18f8c8f51eab3ee3bdd26fdba5e010000af324b79173643a",
1550
1550
  "since": "2025-01-01"
1551
1551
  },
1552
1552
  "subsystem:project-mapper": {
@@ -535,6 +535,7 @@ This routes feedback to the Instar maintainers automatically. Valid types: \`bug
535
535
  - Preview a gate without mutating: \`POST /apprenticeship/instances/:id/can-start\` · \`.../can-complete\`.
536
536
  - Record a manual cycle: \`POST /apprenticeship/cycles\` with \`instanceId\`, positive \`cycleNumber\`, \`task\`, \`menteeOutput\`, optional \`mentorFlagged\` / \`overseerDifferential\` / \`coaching\` / \`infraItems\`, \`kind\` (\`mentor-mentee-differential\`, \`overseer-apprentice-devreview\`, \`overseer-mentee-direct\`), and \`channel\` (\`telegram-playwright\`, \`threadline-backup\`, \`direct-shortcut\`, \`unknown\`). A \`telegram-playwright\` cycle additionally REQUIRES a \`transcriptAudit\` block — \`{ topicIds, window: {start,end}, summary, findingDedupKeys, generatedAt, ledger: 'local'|'remote'|'dry-run'|'failed' }\` — built from \`instar dev:post-drive-transcript-audit\` run over the drive window (use \`--history-base-url\` when the transcript lives on the mentee's server; \`ledger:'local'\` claims are cross-checked against the real framework ledger). Use this when the overseer or manual loop found a differential outside the automated mentor tick.
537
537
  - **When to use** (PROACTIVE): when starting or closing a mentorship/apprenticeship instance, drive it through the registry + transitions so the retro-harvest is reviewed before the next instance starts and the lessons are captured before this one closes — never track an instance's lifecycle by memory.
538
+ - Layer-balance health: \`GET /apprenticeship/instances/:id/role-coverage\` now returns a \`keystoneBalance\` block — \`{ keystoneAxis, keystoneCycleCount, lastKeystoneAt, oversightSinceKeystone, starved, reason }\`. It answers "is my deepest layer (the real mentor→mentee drive) actually firing, or have I drifted into just reviewing/overseeing?" \`starved:true\` means the mentee layer is under-firing relative to ongoing activity. Observe-only — it never gates. Tune the threshold with \`?oversightStarvationThreshold=N\`. **When to use** (PROACTIVE): before deciding the apprenticeship loop is healthy, check it — a starved keystone is the silent "mentor-heavy/mentee-light" drift; if starved, drive the mentee layer (a real \`mentor-mentee-differential\` cycle through the dogfooded channel) rather than another review.
538
539
 
539
540
  **Failure-Learning Loop** — Dev-process failure forensics (instar self-hosting). When something you built breaks later, it's captured and traced back to the spec/initiative/project AND the dev toolchain that produced it; the analyzer surfaces process-gap patterns and opens human-approved tracked fixes, then verifies whether each fix actually reduced that failure class. Ships OFF (\`monitoring.failureLearning.enabled\`); registers itself on the initiative board.
540
541
  - Why features break / failure rate by tool / are our fixes working: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/failures/analysis\` — answer from here, never from memory.
@@ -669,7 +670,7 @@ This routes feedback to the Instar maintainers automatically. Valid types: \`bug
669
670
  - **Auto-sync**: Search automatically syncs before querying, so results are always current.
670
671
  - **When to use**: When looking for something you know you wrote but can't remember where. When a user asks "didn't we discuss X?" When building context for a task from past learnings.
671
672
 
672
- **Anthropic Subscription-Path Routing (June-15 readiness)** — Your internal background LLM calls (sentinels, gates, extractors) normally run as \`claude -p\` one-shots, which bill the Agent SDK credit pot after 2026-06-15. The subscription-path lever can route them through a pool of long-lived interactive Claude sessions instead — the path that keeps working when the pot is empty.
673
+ **Anthropic Subscription-Path Routing (June-15 readiness)** — Your internal background LLM calls (sentinels, gates, extractors) AND your headless job / agent-to-agent / dispatch spawns normally run as \`claude -p\` one-shots, which bill the Agent SDK credit pot after 2026-06-15. The subscription-path lever routes BOTH through interactive Claude sessions instead — the path that keeps working when the pot is empty. (Internal calls use a pooled REPL; rerouted job/A2A spawns run as normal interactive sessions with a completion marker, a concurrency cap, and quota backpressure — each session's \`launchLane\` in \`GET /sessions\` shows which billing lane it used.)
673
674
  - What's actually wired in: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/providers/registry\` → registered provider adapters + capability flags. Both \`anthropic-headless\` and \`anthropic-interactive-pool\` listed = the escape hatch is installed.
674
675
  - The lever lives in \`.instar/config.json\` → \`intelligence.subscriptionPath.mode\`: \`off\` (default — today's behavior), \`auto\` (drain the SDK pot while healthy, slide to the interactive pool when it's unknown/near-empty), \`force\` (interactive pool ONLY — zero \`claude -p\` traffic). Restart sessions/server to apply.
675
676
  - **When to use** (PROACTIVE): user asks "are we ready for the June 15 change?" / "what happens when the SDK credits run out?" → read \`GET /providers/registry\` and report the mode from config. User hit SDK-pot exhaustion → offer the \`force\`/\`auto\` flip instead of letting background checks fail. (Spec: \`docs/specs/provider-substrate-live-wiring.md\`.)
@@ -695,7 +696,7 @@ This routes feedback to the Instar maintainers automatically. Valid types: \`bug
695
696
 
696
697
  **Per-Component Framework Routing** — Run different INTERNAL components on different agentic frameworks to spread LLM load off a single account's rate limit. For example: you run on Claude Code, but ALL your sentinels/gates run on Codex — so that background chatter stops spending your Claude quota. Model "size" is preserved automatically (a \`fast\` check becomes Haiku on Claude or a small GPT model on Codex). Routing is opt-in; with no config, everything stays on your default framework.
697
698
  - See current routing: \`curl -H "Authorization: Bearer $AUTH" "http://localhost:${port}/intelligence/routing"\` → \`{ defaultFramework, components: [{ component, category, framework, available }], coverage }\`.
698
- - Turn it on in \`.instar/config.json\` → \`sessions.componentFrameworks\`, e.g. \`{ "categories": { "sentinel": "codex-cli", "gate": "codex-cli" }, "overrides": { "CoherenceReviewer": "claude-code" }, "fallback": "default" }\`. Categories: \`sentinel | gate | job | reflector | other\`. Resolution: \`overrides[name] → categories[category] → default\`.
699
+ - Turn it on in \`.instar/config.json\` → \`sessions.componentFrameworks\`, e.g. \`{ "categories": { "sentinel": "codex-cli", "gate": "codex-cli" }, "overrides": { "CoherenceReviewer": "claude-code" }, "fallback": "default" }\`. Categories: \`sentinel | gate | job | reflector | other\`. Resolution: \`overrides[name] → categories[category] → default\`. Frameworks: \`claude-code | codex-cli | gemini-cli | pi-cli\` (pi-cli is the pi agent harness — additive, requires the \`pi\` binary + \`enabledFrameworks\` opt-in; its component-routing provider lands in PI-HARNESS-INTEGRATION-SPEC Phase B/C).
699
700
  - Each framework gets its own circuit breaker (a Claude trip can't pause Codex). If a routed framework's CLI is missing it degrades to the default and reports it; if it's just rate-limited the component falls back to its heuristic (no herd onto the default). Routes INTERNAL component calls only — spawned interactive sessions stay governed by \`topicFrameworks\`.
700
701
  - **When to use** (PROACTIVE): when the user is hitting rate limits and asks how to spread load, or says "run my sentinels on Codex" / "move the background checks off Claude" → point them at \`sessions.componentFrameworks\` and \`GET /intelligence/routing\`. Restart sessions to apply (config is read into the router at the call path, but a file edit needs the server to pick it up). (Spec: \`docs/specs/per-component-framework-routing.md\`.)
701
702
 
@@ -0,0 +1,46 @@
1
+ # Upgrade Guide — vNEXT
2
+
3
+ <!-- assembled-by: assemble-next-md -->
4
+ <!-- bump: minor -->
5
+
6
+ ## What Changed
7
+
8
+ instar gained a fourth agentic framework: **pi-cli** (the pi coding agent,
9
+ `@earendil-works/pi-coding-agent` — the minimal harness powering OpenClaw).
10
+ Ships completely DARK: nothing registers and no behavior changes unless an
11
+ agent's config explicitly lists `'pi-cli'` in `enabledFrameworks` AND the
12
+ `pi` binary is installed. Opting in gets: (1) pi topic sessions in tmux with
13
+ IDENTICAL dashboard streaming/typing (TUI-in-tmux v1; launch builders +
14
+ stuck-input detection pinned against real captured panes); (2) a
15
+ provider-substrate adapter with pi's NATIVE structured RPC channel (prompt /
16
+ mid-stream steer / abort, strict-LF JSONL, canonical event normalization)
17
+ plus one-shot completions reporting tokens AND cost; (3)
18
+ `sessions.componentFrameworks` can route internal components (sentinels,
19
+ gates) to `'pi-cli'` — e.g. background chatter onto a Codex/Copilot
20
+ subscription via pi; (4) a STRUCTURAL subscription guard: Anthropic/Claude-
21
+ routed pi model patterns are DENIED by default at every call-construction
22
+ path (Claude-via-pi bills as per-token extra usage, not plan limits — so it
23
+ can never be selected silently; file-config-only override, audit-logged).
24
+ Verified hands-on against the real binary (pi 0.78.1) with a hermetic mock
25
+ provider — zero credentials, all three test tiers.
26
+
27
+ ## What to Tell Your User
28
+
29
+ Nothing proactively — this ships dark and changes nothing by default. If your
30
+ user asks about pi/OpenClaw support, or about spreading background LLM load
31
+ onto other subscriptions: instar can now drive the pi coding agent as an
32
+ additional framework (experimental, opt-in), with a built-in guard that
33
+ prevents accidental Anthropic extra-usage billing.
34
+
35
+ ## Summary of New Capabilities
36
+
37
+ - **pi-cli framework** (⚗️ experimental, opt-in via `enabledFrameworks`) — drive
38
+ the pi coding agent as a fourth framework alongside claude-code / codex-cli /
39
+ gemini-cli. Sessions run in tmux (dashboard streaming unchanged).
40
+ - **pi provider adapter** — `GET /providers/registry` lists `pi-cli` (one-shot
41
+ completion + native RPC session + session-id + hard-kill) when enabled.
42
+ - **pi component routing** — `sessions.componentFrameworks` accepts `pi-cli`,
43
+ so sentinels/gates can run on pi (onto a non-Claude subscription).
44
+ - **Subscription guard** — `piCli.allowAnthropicProviders` (default false):
45
+ routing pi at an Anthropic/Claude model is denied unless explicitly opted in,
46
+ and the opt-in is audit-logged with a cost warning.