instar 1.3.236 → 1.3.237

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 (43) hide show
  1. package/dist/core/ParallelActivityIndex.d.ts +62 -0
  2. package/dist/core/ParallelActivityIndex.d.ts.map +1 -0
  3. package/dist/core/ParallelActivityIndex.js +129 -0
  4. package/dist/core/ParallelActivityIndex.js.map +1 -0
  5. package/dist/core/PostUpdateMigrator.d.ts.map +1 -1
  6. package/dist/core/PostUpdateMigrator.js +16 -0
  7. package/dist/core/PostUpdateMigrator.js.map +1 -1
  8. package/dist/monitoring/GeminiLoopDriver.d.ts +112 -0
  9. package/dist/monitoring/GeminiLoopDriver.d.ts.map +1 -0
  10. package/dist/monitoring/GeminiLoopDriver.js +111 -0
  11. package/dist/monitoring/GeminiLoopDriver.js.map +1 -0
  12. package/dist/monitoring/ParallelWorkOverlap.d.ts +59 -0
  13. package/dist/monitoring/ParallelWorkOverlap.d.ts.map +1 -0
  14. package/dist/monitoring/ParallelWorkOverlap.js +86 -0
  15. package/dist/monitoring/ParallelWorkOverlap.js.map +1 -0
  16. package/dist/monitoring/ParallelWorkSentinel.d.ts +59 -0
  17. package/dist/monitoring/ParallelWorkSentinel.d.ts.map +1 -0
  18. package/dist/monitoring/ParallelWorkSentinel.js +79 -0
  19. package/dist/monitoring/ParallelWorkSentinel.js.map +1 -0
  20. package/dist/providers/adapters/gemini-cli/transport/geminiSpawn.d.ts +14 -0
  21. package/dist/providers/adapters/gemini-cli/transport/geminiSpawn.d.ts.map +1 -1
  22. package/dist/providers/adapters/gemini-cli/transport/geminiSpawn.js +16 -0
  23. package/dist/providers/adapters/gemini-cli/transport/geminiSpawn.js.map +1 -1
  24. package/dist/scaffold/templates.d.ts.map +1 -1
  25. package/dist/scaffold/templates.js +4 -0
  26. package/dist/scaffold/templates.js.map +1 -1
  27. package/dist/server/AgentServer.d.ts +1 -0
  28. package/dist/server/AgentServer.d.ts.map +1 -1
  29. package/dist/server/AgentServer.js +30 -0
  30. package/dist/server/AgentServer.js.map +1 -1
  31. package/dist/server/CapabilityIndex.d.ts.map +1 -1
  32. package/dist/server/CapabilityIndex.js +9 -0
  33. package/dist/server/CapabilityIndex.js.map +1 -1
  34. package/dist/server/routes.d.ts +2 -0
  35. package/dist/server/routes.d.ts.map +1 -1
  36. package/dist/server/routes.js +17 -0
  37. package/dist/server/routes.js.map +1 -1
  38. package/package.json +1 -1
  39. package/src/data/builtin-manifest.json +64 -64
  40. package/src/scaffold/templates.ts +4 -0
  41. package/upgrades/1.3.237.md +82 -0
  42. package/upgrades/side-effects/gemini-multi-turn-loop-driver.md +56 -0
  43. package/upgrades/side-effects/parallel-activity-coherence.md +85 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "instar",
3
- "version": "1.3.236",
3
+ "version": "1.3.237",
4
4
  "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "./builtin-manifest.schema.json",
3
3
  "schemaVersion": 1,
4
- "generatedAt": "2026-06-04T02:59:25.901Z",
5
- "instarVersion": "1.3.236",
4
+ "generatedAt": "2026-06-04T03:45:40.313Z",
5
+ "instarVersion": "1.3.237",
6
6
  "entryCount": 198,
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
14
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
23
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
32
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
41
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
50
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
59
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
68
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
77
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
86
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
95
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
104
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
113
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
122
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
131
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
140
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
149
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
421
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
429
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
437
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
445
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
453
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
461
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
469
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
477
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
485
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
493
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
501
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
509
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
517
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
525
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
533
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
541
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
549
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
557
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
565
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
573
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
581
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
589
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
597
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
605
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
613
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
621
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
629
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
637
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
645
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
653
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
661
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
669
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
677
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
685
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
693
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
701
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
709
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
717
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
725
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
733
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
741
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
749
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
757
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
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": "786d6360036924a6d960315b779de14bda8304e9f4073c2d87abf8f60e30a995",
773
+ "contentHash": "c4e13cbb2d40c5989e9ab6fd8f3eb215eb178d59704e2485784a0ae67527c522",
774
774
  "since": "2025-01-01"
775
775
  },
776
776
  "cli:init": {
@@ -1498,7 +1498,7 @@
1498
1498
  "type": "subsystem",
1499
1499
  "domain": "server",
1500
1500
  "sourcePath": "src/server/AgentServer.ts",
1501
- "contentHash": "cf96ea49a4b25290f87c30e84fdb0eac7b88b77771c07bd42e6e627cb135ba0e",
1501
+ "contentHash": "4b914b879d2956a2491aa2afdf44c1ca8a6acc09a67dd4a92fc7cb4db90316c6",
1502
1502
  "since": "2025-01-01"
1503
1503
  },
1504
1504
  "subsystem:session-manager": {
@@ -1530,7 +1530,7 @@
1530
1530
  "type": "subsystem",
1531
1531
  "domain": "updates",
1532
1532
  "sourcePath": "src/core/PostUpdateMigrator.ts",
1533
- "contentHash": "b6b5d0229c5e6aed1b0720187187619c2207ab56eb180ece9096941713803ed1",
1533
+ "contentHash": "6657527454fb6f7265e33b21cc39974fe4135cb0e1f1160ee65645e3ba9742f7",
1534
1534
  "since": "2025-01-01"
1535
1535
  },
1536
1536
  "subsystem:scheduler": {
@@ -656,6 +656,10 @@ This routes feedback to the Instar maintainers automatically. Valid types: \`bug
656
656
  - **Rate-limit events** (Phase A): every circuit-breaker trip (the account got throttled) and session-sentinel detection is written down so it survives restarts: \`curl -H "Authorization: Bearer $AUTH" "http://localhost:${port}/resources/rate-limits?sinceHours=24"\` → \`{ summary: { circuitOpenCount, tripsPerHour, ... }, byKind, events }\`.
657
657
  - **When to use** (PROACTIVE): when the user asks "how much CPU / memory am I using right now?", "what's eating resources?", "is this agent heavy?" → \`GET /resources/summary\` (or point them at the Resource Usage dashboard tab). When asked "how many times were we throttled today?" / "is the rate-limit pressure getting worse?" → \`GET /resources/rate-limits\`. Read the durable numbers instead of guessing. (Spec: \`docs/specs/per-agent-resource-ledger.md\`.)
658
658
 
659
+ **Parallel-Work Awareness** — See what ALL your hands are doing across topics/sessions at once (like a king with a council). A cross-topic read index over your existing per-topic intent: every topic, its current focus, high-specificity tags, and whether a session is live on it. This is the antidote to self-blindness — duplicating work another of your topics already did.
660
+ - Check: \`curl -H "Authorization: Bearer $AUTH" "http://localhost:${port}/parallel-work/activities"\` → \`{ count, runningCount, activities: [{ topicId, focus, tags, running, updatedAt }] }\`.
661
+ - **When to use** (PROACTIVE): before starting substantial new work in a topic, glance here to see if another topic is already on it; when the user asks "what am I working on across topics?" / "is another session already doing this?". (The proactive overlap councilor — ParallelWorkSentinel — is Phase B, ships dark.) Read-only; never gates. Spec: \`docs/specs/parallel-activity-coherence.md\`.
662
+
659
663
  **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.
660
664
  - See current routing: \`curl -H "Authorization: Bearer $AUTH" "http://localhost:${port}/intelligence/routing"\` → \`{ defaultFramework, components: [{ component, category, framework, available }], coverage }\`.
661
665
  - 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\`.
@@ -0,0 +1,82 @@
1
+ # Upgrade Guide — vNEXT
2
+
3
+ <!-- assembled-by: assemble-next-md -->
4
+ <!-- bump: minor -->
5
+
6
+ ## What Changed
7
+
8
+ First increment (the pure engine) of the **Gemini multi-turn loop-driver**
9
+ (`need-gem-002`) — the mechanism that will let a Gemini mentee sustain a
10
+ multi-turn task instead of being bounded to one-shots (the #1 program-need from
11
+ the codey-to-gemini apprenticeship retro).
12
+
13
+ A new `GeminiLoopDriver` (`src/monitoring/GeminiLoopDriver.ts`) drives a goal
14
+ across turns. Unlike Claude/codex — which run as persistent hook-capable sessions
15
+ and re-prompt via the autonomous Stop hook — gemini runs as one-shots, so the loop
16
+ is driven EXTERNALLY: turn 1 is a one-shot that establishes a session, and each
17
+ later turn re-spawns gemini with the proven native resume path. Because gemini
18
+ restores the session's context itself, the driver re-prompts with only the next
19
+ instruction — never the accumulated transcript — which is the quota-efficient
20
+ design that respects the subscription-auth / no-overspend rule.
21
+
22
+ The engine is fully dependency-injected (the gemini spawn, an optional budget
23
+ gate, the session-handle capture, sleep, clock), so its loop logic is exercised
24
+ by 14 unit tests with zero real gemini calls and zero quota. It terminates on a
25
+ done-sentinel, a turn cap, a budget-gate halt, a spawn failure, or a
26
+ handle-capture failure (it ABORTS rather than resuming a foreign session). A
27
+ companion transport helper `buildGeminiResumeArgv` adds the `-r <handle>` resume
28
+ argv (keeping the explicit `-m` that bypasses gemini-cli's flaky pre-turn
29
+ model-router classifier).
30
+
31
+ This increment is **dark and unwired**: nothing invokes the engine yet. Lifecycle
32
+ invocation (a budget-gated route + the apprenticeship machinery calling it, the
33
+ real `--list-sessions` handle parser, and a config flag) is the next increment,
34
+ which is where the §6 budget-guardrail defaults are finalized. Spec:
35
+ `docs/specs/gemini-multi-turn-loop-driver.md`.
36
+
37
+ **Your agent can now see what all its hands are doing across topics at once.** A new
38
+ cross-topic Activity Index reads your existing per-topic intent and presents one view:
39
+ every topic, its current focus, high-specificity tags, and whether a session is live on
40
+ it. This is the antidote to self-blindness — starting work in one topic that another topic
41
+ already finished (the exact thing that happened in the resource-tracking workstream, where
42
+ one topic re-specced CPU work another had already shipped).
43
+
44
+ Crucially, this does NOT add a new store. The design review found that the per-topic focus
45
+ data already exists (the Topic-Intent layer, updated structurally on every turn), so this is
46
+ a thin read-aggregator over it — no duplication, no new write path to remember.
47
+
48
+ This is Phase A (the read surface). The proactive overlap councilor — a sentinel that
49
+ notices "two of your topics are working on the same thing" and tells you — is Phase B and
50
+ ships separately (and dark, because a false-positive nudge is worse than silence).
51
+
52
+ ## What to Tell Your User
53
+
54
+ Nothing is live to announce yet. This is internal groundwork — a tested engine
55
+ that, once wired up in a following change, will let the Gemini agent work through
56
+ a multi-step task on its own (on subscription login, never an API key) instead of
57
+ stopping after one reply. It ships turned off and disconnected, so it changes
58
+ nothing about how I work today. I will only surface it as a real capability once
59
+ it is wired, budget-guarded, and verified.
60
+
61
+ Your agent is now less likely to duplicate work across different conversations. It can list
62
+ what each of its topics is working on in one place, so before it starts something big it can
63
+ notice another topic already has it covered. Nothing to configure; it reads data the agent
64
+ already keeps.
65
+
66
+ ## Summary of New Capabilities
67
+
68
+ - `GET /parallel-work/activities` — read-only cross-topic index: per topic, its current focus,
69
+ high-specificity tags, freshness, and whether a session is live on it.
70
+ - A specificity-aware tag extractor that ignores generic boilerplate (so two topics that both
71
+ say "fix the test" don't look like the same work) and keeps genuine shared entities.
72
+
73
+ ## Evidence
74
+
75
+ - Converged spec (2-reviewer adversarial + integration pass that RESHAPED the design — from a
76
+ new store to a thin index over the existing Topic-Intent layer, with a distinct
77
+ /parallel-work prefix to avoid the existing Coherence-Gate naming collision):
78
+ docs/specs/parallel-activity-coherence.md.
79
+ - All three test tiers green: 7 unit (extractTags specificity boundary incl. cpu vs
80
+ cpu-sampling; focus derivation goal>decision>purpose; empty-dir ⇒ []), 2 integration
81
+ (200/503), 3 e2e (feature-alive on the real AgentServer init path + Bearer-auth + read-only).
82
+ tsc clean.