instar 1.3.552 → 1.3.554

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 (50) hide show
  1. package/dist/commands/server.d.ts.map +1 -1
  2. package/dist/commands/server.js +71 -2
  3. package/dist/commands/server.js.map +1 -1
  4. package/dist/config/ConfigDefaults.d.ts.map +1 -1
  5. package/dist/config/ConfigDefaults.js +35 -0
  6. package/dist/config/ConfigDefaults.js.map +1 -1
  7. package/dist/core/PostUpdateMigrator.d.ts +10 -0
  8. package/dist/core/PostUpdateMigrator.d.ts.map +1 -1
  9. package/dist/core/PostUpdateMigrator.js +60 -0
  10. package/dist/core/PostUpdateMigrator.js.map +1 -1
  11. package/dist/core/devGatedFeatures.d.ts.map +1 -1
  12. package/dist/core/devGatedFeatures.js +6 -0
  13. package/dist/core/devGatedFeatures.js.map +1 -1
  14. package/dist/core/types.d.ts +50 -0
  15. package/dist/core/types.d.ts.map +1 -1
  16. package/dist/core/types.js.map +1 -1
  17. package/dist/scaffold/templates.d.ts.map +1 -1
  18. package/dist/scaffold/templates.js +4 -0
  19. package/dist/scaffold/templates.js.map +1 -1
  20. package/dist/scheduler/JobLeaseClaimStore.d.ts +105 -0
  21. package/dist/scheduler/JobLeaseClaimStore.d.ts.map +1 -0
  22. package/dist/scheduler/JobLeaseClaimStore.js +165 -0
  23. package/dist/scheduler/JobLeaseClaimStore.js.map +1 -0
  24. package/dist/scheduler/JobLeaseCutoverGate.d.ts +73 -0
  25. package/dist/scheduler/JobLeaseCutoverGate.d.ts.map +1 -0
  26. package/dist/scheduler/JobLeaseCutoverGate.js +66 -0
  27. package/dist/scheduler/JobLeaseCutoverGate.js.map +1 -0
  28. package/dist/scheduler/JobScheduler.d.ts +53 -0
  29. package/dist/scheduler/JobScheduler.d.ts.map +1 -1
  30. package/dist/scheduler/JobScheduler.js +136 -20
  31. package/dist/scheduler/JobScheduler.js.map +1 -1
  32. package/dist/server/AgentServer.d.ts +3 -0
  33. package/dist/server/AgentServer.d.ts.map +1 -1
  34. package/dist/server/AgentServer.js +3 -0
  35. package/dist/server/AgentServer.js.map +1 -1
  36. package/dist/server/PoolPollCache.d.ts +136 -0
  37. package/dist/server/PoolPollCache.d.ts.map +1 -0
  38. package/dist/server/PoolPollCache.js +163 -0
  39. package/dist/server/PoolPollCache.js.map +1 -0
  40. package/dist/server/routes.d.ts +9 -0
  41. package/dist/server/routes.d.ts.map +1 -1
  42. package/dist/server/routes.js +51 -8
  43. package/dist/server/routes.js.map +1 -1
  44. package/package.json +1 -1
  45. package/src/data/builtin-manifest.json +65 -65
  46. package/src/scaffold/templates.ts +4 -0
  47. package/upgrades/1.3.553.md +63 -0
  48. package/upgrades/1.3.554.md +79 -0
  49. package/upgrades/side-effects/multi-machine-seamlessness-ws44-pool-cache.md +115 -0
  50. package/upgrades/side-effects/ws43-journal-lease-cutover.md +132 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "instar",
3
- "version": "1.3.552",
3
+ "version": "1.3.554",
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-14T01:35:53.621Z",
5
- "instarVersion": "1.3.552",
4
+ "generatedAt": "2026-06-14T03:32:24.762Z",
5
+ "instarVersion": "1.3.554",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
14
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
23
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
32
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
41
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
50
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
59
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
68
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
77
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
86
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
95
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
104
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
113
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
122
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
131
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
140
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
149
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
421
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
429
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
437
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
445
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
453
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
461
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
469
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
477
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
485
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
493
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
501
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
509
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
517
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
525
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
533
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
541
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
549
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
557
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
565
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
573
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
581
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
589
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
597
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
605
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
613
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
621
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
629
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
637
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
645
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
653
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
661
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
669
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
677
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
685
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
693
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
701
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
709
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
717
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
725
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
733
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
741
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
749
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
757
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
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": "480784a0332fc847888c2e3a2e0cac9170d49546ea1429814bfbdbc0c0c3e707",
773
+ "contentHash": "69bb0784d501b766f4544d28d6ec1c0e1b49fa2d3af8ab9b2317a140ac32dc55",
774
774
  "since": "2025-01-01"
775
775
  },
776
776
  "cli:init": {
@@ -1522,7 +1522,7 @@
1522
1522
  "type": "subsystem",
1523
1523
  "domain": "server",
1524
1524
  "sourcePath": "src/server/AgentServer.ts",
1525
- "contentHash": "fa740ec4394006cb803f7a80c2294867cae0b79da304a681b577f3a81e19153f",
1525
+ "contentHash": "64475d96f14550d09cd6ca6ab20ee43838f64b30c963e099e75f9328bb2409d3",
1526
1526
  "since": "2025-01-01"
1527
1527
  },
1528
1528
  "subsystem:session-manager": {
@@ -1554,7 +1554,7 @@
1554
1554
  "type": "subsystem",
1555
1555
  "domain": "updates",
1556
1556
  "sourcePath": "src/core/PostUpdateMigrator.ts",
1557
- "contentHash": "ac0572fdc98b54df9781356a5c925099b7d7a08d4b8cffdc71d8b011df1e5204",
1557
+ "contentHash": "aea52d2d03e36b78910cc81d66f6d388fe7ca182f9fefa0c2fe987a10a9acc62",
1558
1558
  "since": "2025-01-01"
1559
1559
  },
1560
1560
  "subsystem:scheduler": {
@@ -1562,7 +1562,7 @@
1562
1562
  "type": "subsystem",
1563
1563
  "domain": "scheduling",
1564
1564
  "sourcePath": "src/scheduler/JobScheduler.ts",
1565
- "contentHash": "dfc4dc4cc5616c07122ba179c38b5ce9e76a133e3969bb44483257cbc8d2a7a8",
1565
+ "contentHash": "8f526a365e7292029224135303525e89920435ced45b292cc4c50e47dc297ea4",
1566
1566
  "since": "2025-01-01"
1567
1567
  },
1568
1568
  "subsystem:project-mapper": {
@@ -493,6 +493,10 @@ Every guard (monitoring sentinels, reapers, the scheduler, …) is graded by wha
493
493
  - If the holder machine is OFFLINE, the link shows an honest "content temporarily unavailable — its machine is offline", never stale content or a bare 404.
494
494
  - **Proactive trigger:** user asks "will this link still work from my other machine / phone while the laptop is asleep?" → yes IF the holder machine is online (the content lives there); if that machine is offline the link honestly says so. Spec: \`docs/specs/MULTI-MACHINE-SEAMLESSNESS-SPEC.md\` §WS4.4.
495
495
 
496
+ **Shared pool-cache (WS4.4(f) — one fan-out feeds every pool-scope view)** — When I run on more than one machine and a dashboard polls several pool-scope tabs at once (sessions / jobs / attention / guards, each \`?scope=pool\`), I no longer hit every peer once PER tab PER poll. All those surfaces share ONE per-peer poll cache, so each peer is queried once per interval and the result feeds every view — far less wasted egress + peer CPU. When the fronting machine is over a CPU load-shed threshold, a pool view serves its last-cached peer data tagged \`stale: true\` instead of re-fanning (honest load-shedding, never silent staleness). Ships DARK behind \`multiMachine.seamlessness.ws44PoolCache\` (dev-agent gated); a single-machine agent is a no-op (no peers).
497
+ - **See the cache:** \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/pool/poll-cache\` → \`{ ttlMs, loadShedPerCore, loadPerCore, loadShedding, cachedKeys, inflight, stats: { fetches, cacheHits, loadSheds, coalesced, errors } }\` (503 when the flag is dark on this agent).
498
+ - **Proactive trigger:** user asks "why does this pool view say stale?" → I'm load-shedding under CPU pressure and serving last-cached peer data (read \`/pool/poll-cache\` → \`loadShedding\`); "why is the dashboard hammering my other machines?" → with this on, it doesn't — each peer is polled once per interval and shared. Spec: \`docs/specs/MULTI-MACHINE-SEAMLESSNESS-SPEC.md\` §WS4.4 clause (f).
499
+
496
500
  **Multi-Machine Session Pool (active-active — spread conversations across machines)** — The longer arc beyond one-awake-machine: with the pool enabled I run conversations across ALL my machines at once and can MOVE a conversation between them. Ships DARK behind \`multiMachine.sessionPool.stage\` (default 'dark'); a single-machine agent is a no-op.
497
501
  - **See the pool:** the **Machines tab** in the dashboard, or \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/pool\` → which machine is the router ("dispatcher") + every machine's nickname, hardware, online status, load, and clock-skew status.
498
502
  - **Every session, every machine:** the dashboard sessions list shows ALL sessions across the pool, each tagged with the machine it runs on. API: \`curl -H "Authorization: Bearer $AUTH" "http://localhost:${port}/sessions?scope=pool"\` → \`{ sessions: [...each with machineId/machineNickname...], pool: { peersOk, failed } }\`. An unreachable peer degrades to a \`failed\` entry — local sessions always answer.
@@ -0,0 +1,63 @@
1
+ # Upgrade Guide — vNEXT
2
+
3
+ <!-- assembled-by: assemble-next-md -->
4
+ <!-- bump: patch -->
5
+
6
+ ## What Changed
7
+
8
+ - **Every pool-scope dashboard view now shares ONE per-peer poll cache.** Before,
9
+ `/sessions?scope=pool`, `/jobs?scope=pool`, `/attention?scope=pool` and
10
+ `/guards?scope=pool` each fanned out to every peer machine independently — once per
11
+ tab, per client, per poll interval. With a dashboard polling several tabs at once,
12
+ the same peer got hit N times an interval. Now one fan-out per interval feeds every
13
+ pool-scope surface, cutting wasted egress + peer CPU that scaled with open tabs.
14
+ - **Single-flight coalescing:** a burst of tab-loads asking the same peer in the same
15
+ window collapses to ONE in-flight request, not one per caller.
16
+ - **Honest CPU load-shed:** when the fronting machine is over a load-per-core threshold,
17
+ a pool view serves its last-cached peer data tagged `stale: true` (and the merge
18
+ carries `pool.stale: true`) instead of re-fanning — load-shed that is always labeled,
19
+ never silent staleness. A first-ever read (empty cache) always fetches.
20
+ - **A failed peer fetch is NEVER cached** — a transient peer error can't stick for the
21
+ whole TTL; the next read re-fetches.
22
+ - **New read-only `GET /pool/poll-cache`** reports whether the cache is wired, its TTL +
23
+ load-shed threshold, the live load-per-core, whether it's currently load-shedding, and
24
+ the cumulative counters (fan-outs avoided via cache hits + load-sheds, single-flight
25
+ coalesces). 503 while the flag is dark — the ships-dark contract.
26
+ - Ships **dark** behind `multiMachine.seamlessness.ws44PoolCache` (dev-gated);
27
+ flag-off behavior is byte-for-byte today's direct per-peer fetch. Single-machine
28
+ installs are a strict no-op (no peers). CLAUDE.md awareness + idempotent
29
+ config/migration/shadow-marker parity included.
30
+
31
+ This completes the WS4.4 work begun with pool-stable links. <!-- tracked: CMT-1416 -->
32
+
33
+ ## What to Tell Your User
34
+
35
+ On a multi-machine setup, your dashboard no longer hammers your other machines. When you
36
+ have several pool-scope tabs open (sessions, jobs, attention, guards), each of your other
37
+ machines is now polled once per interval and that single result feeds every tab, instead
38
+ of every tab polling every machine on its own. If your fronting machine gets busy, a pool
39
+ view will briefly show its last-known data clearly marked as stale rather than piling on
40
+ more cross-machine traffic. Single-machine setups see no change at all.
41
+
42
+ ## Summary of New Capabilities
43
+
44
+ - Shared per-peer poll cache for all pool-scope surfaces: one fan-out per interval feeds
45
+ every view, single-flight coalescing, and honest CPU load-shed with an explicit
46
+ staleness tag. Read it at GET /pool/poll-cache. Ships dark behind
47
+ multiMachine.seamlessness.ws44PoolCache.
48
+
49
+ ## Evidence
50
+
51
+ - `tests/unit/pool-poll-cache.test.ts` (9): within-TTL hit vs expired re-fetch;
52
+ single-flight coalescing; load-shed over/under threshold; load-shed with an empty
53
+ cache still fetches; failed fetch never cached; per-(peer, route) keying; snapshot
54
+ wiring + threshold boundary on both sides.
55
+ - `tests/integration/ws44-pool-cache-route.test.ts` (4): real second-server peer that
56
+ COUNTS its hits — the fan-out goes THROUGH the shared cache (proven via the cache's
57
+ OWN stats counters, not the maskable per-route "1 hit"); a later poll is served from
58
+ the shared cache without re-hitting the peer; merged body byte-identical wired vs
59
+ unwired; the route 503s dark / 200s wired.
60
+ - `tests/e2e/pool-poll-cache-alive.test.ts` (3): the feature is alive (200, not 503) on
61
+ the production AgentServer path; behind auth; the dark default 503s.
62
+ - `tsc --noEmit` clean; docs-coverage, no-silent-fallbacks, feature-delivery, and the
63
+ dev-agent dark-gate line-map all green.