instar 1.3.675 → 1.3.677

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 (37) hide show
  1. package/dist/commands/server.d.ts.map +1 -1
  2. package/dist/commands/server.js +107 -9
  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 +6 -0
  6. package/dist/config/ConfigDefaults.js.map +1 -1
  7. package/dist/core/MessagingToneGate.d.ts +9 -0
  8. package/dist/core/MessagingToneGate.d.ts.map +1 -1
  9. package/dist/core/MessagingToneGate.js +11 -1
  10. package/dist/core/MessagingToneGate.js.map +1 -1
  11. package/dist/core/SpawnCapIntelligenceProvider.d.ts +23 -0
  12. package/dist/core/SpawnCapIntelligenceProvider.d.ts.map +1 -1
  13. package/dist/core/SpawnCapIntelligenceProvider.js +77 -8
  14. package/dist/core/SpawnCapIntelligenceProvider.js.map +1 -1
  15. package/dist/core/SpawningTopicsRegistry.d.ts +65 -0
  16. package/dist/core/SpawningTopicsRegistry.d.ts.map +1 -0
  17. package/dist/core/SpawningTopicsRegistry.js +75 -0
  18. package/dist/core/SpawningTopicsRegistry.js.map +1 -0
  19. package/dist/core/hostSpawnSemaphore.d.ts +63 -1
  20. package/dist/core/hostSpawnSemaphore.d.ts.map +1 -1
  21. package/dist/core/hostSpawnSemaphore.js +69 -5
  22. package/dist/core/hostSpawnSemaphore.js.map +1 -1
  23. package/dist/core/types.d.ts +23 -0
  24. package/dist/core/types.d.ts.map +1 -1
  25. package/dist/core/types.js.map +1 -1
  26. package/dist/monitoring/TopicReachabilityVerifier.d.ts +92 -0
  27. package/dist/monitoring/TopicReachabilityVerifier.d.ts.map +1 -0
  28. package/dist/monitoring/TopicReachabilityVerifier.js +173 -0
  29. package/dist/monitoring/TopicReachabilityVerifier.js.map +1 -0
  30. package/dist/server/routes.d.ts.map +1 -1
  31. package/dist/server/routes.js +4 -0
  32. package/dist/server/routes.js.map +1 -1
  33. package/package.json +1 -1
  34. package/src/data/builtin-manifest.json +46 -46
  35. package/upgrades/1.3.677.md +78 -0
  36. package/upgrades/side-effects/spawn-cap-interactive-priority.md +76 -0
  37. package/upgrades/side-effects/verify-after-reachability.md +65 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "instar",
3
- "version": "1.3.675",
3
+ "version": "1.3.677",
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-26T10:12:23.627Z",
5
- "instarVersion": "1.3.675",
4
+ "generatedAt": "2026-06-26T13:12:48.410Z",
5
+ "instarVersion": "1.3.677",
6
6
  "entryCount": 202,
7
7
  "entries": {
8
8
  "hook:session-start": {
@@ -418,7 +418,7 @@
418
418
  "type": "route-group",
419
419
  "domain": "monitoring",
420
420
  "sourcePath": "src/server/routes.ts",
421
- "contentHash": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
421
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
429
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
437
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
445
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
453
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
461
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
469
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
477
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
485
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
493
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
501
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
509
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
517
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
525
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
533
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
541
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
549
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
557
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
565
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
573
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
581
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
589
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
597
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
605
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
613
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
621
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
629
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
637
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
645
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
653
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
661
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
669
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
677
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
685
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
693
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
701
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
709
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
717
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
725
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
733
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
741
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
749
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
757
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
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": "ed31d0e557159f264ecfd3d5dea6e1a84b9b585fc34d0577049f093119a19160",
773
+ "contentHash": "547dda376f95e289d9f39a2931a30753cdfe62f2ee9c13479db256dc76ed8d1b",
774
774
  "since": "2025-01-01"
775
775
  },
776
776
  "cli:init": {
@@ -0,0 +1,78 @@
1
+ # Upgrade Guide — vNEXT
2
+
3
+ <!-- assembled-by: assemble-next-md -->
4
+ <!-- bump: patch -->
5
+
6
+ ## What Changed
7
+
8
+ The host spawn cap (the fork-bomb/OOM safety floor that bounds how many LLM
9
+ subprocesses run at once) now reserves a little headroom for the user's reply. Under
10
+ load, the user-facing tone gate used to wait in the same undifferentiated line as
11
+ background sentinels and could time out (a cause of the 2026-06-25 silent-outbound
12
+ incident). The cap now SUBDIVIDES into a small interactive reserve + a small background
13
+ reserve, so a synchronous operator reply always has slots and is never starved by
14
+ background chatter. The total cap is NEVER raised — only *who gets which slot* changes.
15
+ Ships dark on the fleet / live on a development agent (dev-agent gate); byte-identical
16
+ to today when off.
17
+
18
+ Lands postmortem fix F7 (Blast-Radius / Verify-After), dark on the fleet / live on a dev
19
+ agent. Two parts: (1) the live inbound spawn-guard is now a token-tagged
20
+ `SpawningTopicsRegistry` — a hung session start no longer silently wedges a topic forever
21
+ (ABA-safe; the `.finally` stays the sole clearer, no risky auto-clear). (2) a pure-signal
22
+ `TopicReachabilityVerifier`: after a session is killed/reaped, it checks (after a grace
23
+ window) that the conversation can still receive your next message, and if a genuine
24
+ orphan (e.g. a wedged start-up) it surfaces ONE calm NORMAL heads-up. It mutates nothing —
25
+ never kills, spawns, or clears. The probe is conservative + fail-safe (uncertain ⇒
26
+ treated as reachable), so it never cries wolf on a normal idle kill.
27
+
28
+ ## What to Tell Your User
29
+
30
+ When the machine is busy, your reply's safety check now jumps to a reserved slot instead
31
+ of waiting behind background work — fewer slow/held replies under load. The crash
32
+ protection is exactly as strong as before. Most setups see no change (it's off on the
33
+ fleet for now).
34
+
35
+ If I ever shut down a conversation's session and it genuinely can't be reached again
36
+ (e.g. a start-up that hung), you now get one calm "this conversation may be unreachable"
37
+ heads-up instead of your messages silently vanishing. Most of the time you see nothing,
38
+ because most kills self-heal on your next message. It only watches — it never tries to
39
+ auto-fix the stuck state (that proved too risky); the mechanical repair stays a tracked
40
+ follow-up. Off on the fleet for now.
41
+
42
+ ## Summary of New Capabilities
43
+
44
+ - `attribution.lane:'interactive'` requests reserved headroom — honored ONLY for an
45
+ allowlisted, user-blocking seam (the operator-facing tone gate); everything else stays
46
+ background.
47
+ - Symmetric reservation within the existing cap N (`Ri`/`Rb`, default 2/2): interactive
48
+ guaranteed ≥Ri slots, background guaranteed ≥Rb — neither starves the other.
49
+ - `/spawn-limiter` reports per-lane live counts + the reservation config.
50
+ - Off (the fleet default) ⇒ byte-identical to the all-or-nothing cap (no `lane` written).
51
+
52
+ - A hung session start-up can no longer permanently jam a conversation's inbound path
53
+ (token-tagged spawn guard; ABA-safe).
54
+ - After a destructive session/routing op, a dev agent verifies the topic is still
55
+ reachable and surfaces a genuine orphan as ONE NORMAL attention item (deduped,
56
+ flap-backoff-capped, burst-rolled-up, pressure/emergency-stop aware with a re-sweep).
57
+ - Visible in `/guards` (registered). Dark on the fleet (dev-agent gate). Mutates nothing.
58
+
59
+ ## Evidence
60
+
61
+ - `hostSpawnSemaphore-priority.test.ts` (10): symmetric reserve, OOM floor unconditional,
62
+ garbage-lane→background-never-dropped, clamp (N=1/N=2/oversized/0), off=byte-identical.
63
+ - `spawn-cap-provider-lane.test.ts` (7): allowlist downgrade (CoherenceReviewer→background),
64
+ off→background, interactive fast-path, saturated interactive still fails closed,
65
+ membership pinned.
66
+ - 25 existing spawn-cap tests + 160 tone-gate tests pass unchanged (no regression; the
67
+ fork-bomb burst-invariant test still green). `tsc --noEmit` clean.
68
+ - Side-effects: `upgrades/side-effects/spawn-cap-interactive-priority.md`.
69
+ - Spec (converged + approved): `docs/specs/spawn-cap-interactive-priority.md`.
70
+
71
+ - `spawningTopicsRegistry.test.ts` (5): ABA token-guard; `.finally` sole clearer (no
72
+ timeout/sweep); stuck-age seam.
73
+ - `topicReachabilityVerifier.test.ts` (8): grace; reachable-honesty (no false orphan on a
74
+ topic that self-heals); orphan→one NORMAL item; pressure/halt skip + re-sweep; flap
75
+ backoff; burst roll-up; coalescing.
76
+ - `tsc --noEmit` clean.
77
+ - Side-effects: `upgrades/side-effects/verify-after-reachability.md`.
78
+ - Spec (converged + approved): `docs/specs/verify-after-reachability.md`.
@@ -0,0 +1,76 @@
1
+ # Side-Effects Review — Interactive Priority Lane for the Host Spawn Cap (F5 build)
2
+
3
+ **Version / slug:** `spawn-cap-interactive-priority`
4
+ **Date:** `2026-06-26`
5
+ **Author:** `Echo (instar-dev agent)`
6
+ **Tier:** 2 (converged + approved spec: `docs/specs/spawn-cap-interactive-priority.md`)
7
+
8
+ ## Summary
9
+
10
+ Implements the converged F5 design: the host spawn cap (the fork-bomb OOM floor) now
11
+ SUBDIVIDES into reserved interactive/background headroom so the user-facing tone gate
12
+ is not starved by background sentinels under contention. It NEVER raises the total cap.
13
+ Ships dark-on-fleet / live-on-dev via the dev-agent gate; byte-identical when off.
14
+
15
+ Implemented this change:
16
+ - `attribution.lane?: 'interactive'|'background'` (types.ts) — the lane signal.
17
+ - `hostSpawnSemaphore`: `SpawnLane` + optional per-holder `lane`; `clampInteractiveReserves`;
18
+ `acquire(id, lane)` with the symmetric reserve (interactive iff `liveTotal<N AND
19
+ liveInteractive<N−Rb`; background symmetric); `interactivePriorityEnabled()`; per-lane
20
+ `status()` fields. The `liveTotal<N` OOM floor remains the UNCONDITIONAL first predicate.
21
+ - `SpawnCapIntelligenceProvider`: `INTERACTIVE_LANE_ALLOWLIST` (downgrade non-allowlisted
22
+ `interactive` to background); lane-aware ingress (interactive fast-path before the
23
+ waiters cap + a CARVE-OUT of `waitersMax`, never additive); passes the lane to acquire.
24
+ - `MessagingToneGate`: `synchronousReply` context flag → sets `lane:'interactive'` only on
25
+ the operator-facing synchronous reply.
26
+ - Dev-gated flag wiring (server.ts `configureHostSpawnSemaphore`), config type +
27
+ ConfigDefaults (`enabled` OMITTED → dev-gate; `ri:2, rb:2`), `/spawn-limiter` per-lane
28
+ fields.
29
+
30
+ ## The 8 questions
31
+
32
+ 1. **Over-block** — N/A. The reservation gates spawns (existing authority); it adds no new
33
+ rejection. A saturated interactive call still fails closed (typed shed) exactly as today.
34
+ 2. **Under-block** — N/A. The total cap is byte-identical (`liveTotal<N` first, always).
35
+ 3. **Level-of-abstraction fit** — Correct. `ComponentFrameworks`/attribution already carry
36
+ per-call metadata; the reserve lives in the one primitive (`hostSpawnSemaphore`) +
37
+ its wrapper. No routing-engine change.
38
+ 4. **Signal vs authority** — Subdivides EXISTING authority by a lane; no new brittle
39
+ blocking logic (pure integer counting over the holder set, same shape as `liveHolders<cap`).
40
+ The interactive signal is hardened by a code allowlist + a membership-pinning test (not
41
+ convention). Complies with docs/signal-vs-authority.md.
42
+ 5. **Interactions** — Disabled ⇒ byte-identical (no `lane` written, ingress carve-out
43
+ gated on `priorityOn`, lane resolves to background). Confirmed: 25 existing spawn-cap
44
+ tests + 160 tone-gate tests pass unchanged. The wrapper ingress carve-out keeps the
45
+ aggregate poller bound at `waitersMax` (not additive). Garbage/missing lane → background,
46
+ never drops a holder (`isWellFormedHolder` untouched) — the OOM floor cannot be eroded.
47
+ 6. **External surfaces** — `/spawn-limiter` gains per-lane fields (additive). The tone
48
+ gate's LLM call may run on a different framework lane than background — intended, visible.
49
+ 7. **Multi-machine** — Host-local BY DESIGN (the holders file is per-host, never synced).
50
+ Each host reserves its own headroom. The optional `lane` rides inside the host-local
51
+ file; an old reader ignores it, a new reader counts a missing lane as background — total
52
+ cap bounded both directions during a mixed-version window (priority is best-effort until
53
+ all co-resident agents upgrade; moot while dark). No replication.
54
+ 8. **Rollback cost** — Trivial. The dev-gate flag off (or `interactivePriority.enabled:false`)
55
+ restores all-or-nothing. No migration (deepMerge backfills `ri/rb`; no stale `enabled`
56
+ to strip on a new block). No state. Revert the commit otherwise.
57
+
58
+ ## Tracked follow-ups (not orphan deferrals)
59
+
60
+ - A `lint-interactive-lane-allowlist` CI script (Structure>Willpower belt-and-suspenders).
61
+ The wrapper DOWNGRADE + the membership-pinning unit test already guarantee safety; the
62
+ lint is additional defense against a new static assignment site. <!-- tracked: topic-28744 F5-followup interactive-lane-lint -->
63
+ - The §A.1 second tagged seam (operator-inbound `MessageSentinel`) is on the allowlist; its
64
+ synchronousReply-equivalent wiring on the inbound path lands with the inbound work. <!-- tracked: topic-28744 F5-followup messagesentinel-inbound-lane -->
65
+
66
+ ## Second-pass note (spawn-cap = safety floor)
67
+
68
+ This touches the fork-bomb OOM floor (a Phase-5 trigger area). The load-bearing review
69
+ point: the change ONLY subdivides within `N` — `liveTotal<N` is the unconditional first
70
+ predicate of every lane, the reserve never raises the ceiling, a garbage lane never drops
71
+ a holder, and `enabled:false` is byte-identical (verified by the existing burst-invariant
72
+ fork-bomb test passing unchanged). The decision boundary is covered by 17 new unit tests.
73
+
74
+ ## Rollback
75
+
76
+ Dev-gate off / `enabled:false`. No migration, no state.
@@ -0,0 +1,65 @@
1
+ # Side-Effects Review — Verify-After Topic Reachability (F7 — core components)
2
+
3
+ **Version / slug:** `verify-after-reachability`
4
+ **Date:** `2026-06-26`
5
+ **Author:** `Echo (instar-dev agent)`
6
+ **Tier:** 2 (converged + approved spec: `docs/specs/verify-after-reachability.md`)
7
+ **Scope:** the two pure components (first commit) PLUS the server wiring (this commit):
8
+ Piece 1 (`spawningTopics` closure→`SpawningTopicsRegistry` refactor of the live inbound
9
+ path, token-guarded at all 4 callsites) and Piece 2 (the verifier constructed dev-gated,
10
+ triggered by `sessionReaped`, a conservative fail-safe probe, a 15s tick, NORMAL
11
+ attention surfacing, and `guardRegistry` registration). The probe is deliberately
12
+ CONSERVATIVE: a live session ⇒ reachable; a topic stuck-spawning past `stuckSpawnMs` ⇒
13
+ orphan; ANYTHING ELSE ⇒ reachable (the next inbound self-heals) — so it never
14
+ false-orphans an idle kill. The multi-machine released-no-placement + at-capacity orphan
15
+ cases (placement reads) and a dedicated `/topic-reachability` route are a tracked
16
+ follow-up; their absence means LESS coverage, never a false orphan (the probe fails safe
17
+ to reachable). <!-- tracked: topic-28744 F7-followup multimachine-probe-and-route -->
18
+
19
+ ## What this commit adds
20
+
21
+ - `SpawningTopicsRegistry` (src/core) — token-tagged replacement for the closure-local
22
+ `spawningTopics` Set: `add` returns a token, `clear` is token-guarded (the ABA fix so a
23
+ late `.finally` from a superseded spawn cannot delete a newer entry), `stuckSinceMs`
24
+ exposes in-flight age for the verifier. NO timeout, NO sweep — the `.finally` remains
25
+ the sole clearer (round-2 proved any external clear relocates the double-spawn race).
26
+ - `TopicReachabilityVerifier` (src/monitoring) — the PURE-SIGNAL decision core: grace +
27
+ per-topic coalescing, the reachable-honesty guard (a topic that will self-heal on next
28
+ inbound is REACHABLE, not orphaned), NORMAL-priority surfacing with per-topic
29
+ exponential backoff (flap cap), burst roll-up, pressure-skip + emergency-stop-suppress
30
+ WITH a re-sweep on clear (no never-surfaced orphan). It MUTATES NOTHING.
31
+
32
+ Neither component is wired into the running server yet (no runtime surface), so this
33
+ commit is inert at runtime — pure library code under test.
34
+
35
+ ## The 8 questions (for the components as committed)
36
+
37
+ 1. **Over-block** — N/A. The verifier blocks nothing; it surfaces a signal. The registry
38
+ only guards double-spawn (existing behavior), now ABA-safe.
39
+ 2. **Under-block** — N/A.
40
+ 3. **Level-of-abstraction fit** — Correct. Pure decision logic separated from the server
41
+ wiring + live-state probe (the spec's design).
42
+ 4. **Signal vs authority** — The verifier is a pure signal (zero mutation). The registry's
43
+ only authority is the EXISTING token-guarded clear (no new clearer). Complies.
44
+ 5. **Interactions** — None at runtime (unwired). The registry, once wired, replaces the
45
+ closure Set; the token guard makes its clear idempotent/ABA-safe.
46
+ 6. **External surfaces** — None yet (unwired). The future wiring adds a NORMAL attention
47
+ item + a `/topic-reachability` status route + a `/guards` entry.
48
+ 7. **Multi-machine** — The verifier's released-no-placement detection (future probe) is
49
+ machine-local (reads the local placement snapshot, freshness-gated); machine-local BY
50
+ DESIGN. The components themselves hold no cross-machine state.
51
+ 8. **Rollback cost** — Trivial. Delete two new files + their tests; nothing references
52
+ them at runtime yet.
53
+
54
+ ## Tests
55
+
56
+ - `spawningTopicsRegistry.test.ts` (5): the ABA token-guard, `.finally` is the sole
57
+ clearer (no timeout/sweep), `stuckSinceMs`, entries snapshot.
58
+ - `topicReachabilityVerifier.test.ts` (8): grace; reachable-honesty (no false orphan);
59
+ orphan→one NORMAL item; pressure-skip+re-sweep; halt-suppress+re-sweep; flap backoff;
60
+ burst roll-up; coalescing.
61
+ - `tsc --noEmit` clean.
62
+
63
+ ## Rollback
64
+
65
+ Delete the two component files + tests. No runtime reference.