instar 1.3.51 → 1.3.52

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.
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "./builtin-manifest.schema.json",
3
3
  "schemaVersion": 1,
4
- "generatedAt": "2026-05-28T06:36:08.823Z",
5
- "instarVersion": "1.3.51",
4
+ "generatedAt": "2026-05-28T06:51:41.833Z",
5
+ "instarVersion": "1.3.52",
6
6
  "entryCount": 193,
7
7
  "entries": {
8
8
  "hook:session-start": {
@@ -409,7 +409,7 @@
409
409
  "type": "route-group",
410
410
  "domain": "monitoring",
411
411
  "sourcePath": "src/server/routes.ts",
412
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
412
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
413
413
  "since": "2025-01-01"
414
414
  },
415
415
  "route-group:agents": {
@@ -417,7 +417,7 @@
417
417
  "type": "route-group",
418
418
  "domain": "sessions",
419
419
  "sourcePath": "src/server/routes.ts",
420
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
420
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
421
421
  "since": "2025-01-01"
422
422
  },
423
423
  "route-group:backups": {
@@ -425,7 +425,7 @@
425
425
  "type": "route-group",
426
426
  "domain": "operations",
427
427
  "sourcePath": "src/server/routes.ts",
428
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
428
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
429
429
  "since": "2025-01-01"
430
430
  },
431
431
  "route-group:git": {
@@ -433,7 +433,7 @@
433
433
  "type": "route-group",
434
434
  "domain": "coordination",
435
435
  "sourcePath": "src/server/routes.ts",
436
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
436
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
437
437
  "since": "2025-01-01"
438
438
  },
439
439
  "route-group:memory": {
@@ -441,7 +441,7 @@
441
441
  "type": "route-group",
442
442
  "domain": "memory",
443
443
  "sourcePath": "src/server/routes.ts",
444
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
444
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
445
445
  "since": "2025-01-01"
446
446
  },
447
447
  "route-group:semantic": {
@@ -449,7 +449,7 @@
449
449
  "type": "route-group",
450
450
  "domain": "memory",
451
451
  "sourcePath": "src/server/routes.ts",
452
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
452
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
453
453
  "since": "2025-01-01"
454
454
  },
455
455
  "route-group:status": {
@@ -457,7 +457,7 @@
457
457
  "type": "route-group",
458
458
  "domain": "monitoring",
459
459
  "sourcePath": "src/server/routes.ts",
460
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
460
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
461
461
  "since": "2025-01-01"
462
462
  },
463
463
  "route-group:capabilities": {
@@ -465,7 +465,7 @@
465
465
  "type": "route-group",
466
466
  "domain": "mapping",
467
467
  "sourcePath": "src/server/routes.ts",
468
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
468
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
469
469
  "since": "2025-01-01"
470
470
  },
471
471
  "route-group:project-map": {
@@ -473,7 +473,7 @@
473
473
  "type": "route-group",
474
474
  "domain": "mapping",
475
475
  "sourcePath": "src/server/routes.ts",
476
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
476
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
477
477
  "since": "2025-01-01"
478
478
  },
479
479
  "route-group:coherence": {
@@ -481,7 +481,7 @@
481
481
  "type": "route-group",
482
482
  "domain": "coherence",
483
483
  "sourcePath": "src/server/routes.ts",
484
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
484
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
485
485
  "since": "2025-01-01"
486
486
  },
487
487
  "route-group:topic-bindings": {
@@ -489,7 +489,7 @@
489
489
  "type": "route-group",
490
490
  "domain": "sessions",
491
491
  "sourcePath": "src/server/routes.ts",
492
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
492
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
493
493
  "since": "2025-01-01"
494
494
  },
495
495
  "route-group:context": {
@@ -497,7 +497,7 @@
497
497
  "type": "route-group",
498
498
  "domain": "context",
499
499
  "sourcePath": "src/server/routes.ts",
500
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
500
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
501
501
  "since": "2025-01-01"
502
502
  },
503
503
  "route-group:scope-coherence": {
@@ -505,7 +505,7 @@
505
505
  "type": "route-group",
506
506
  "domain": "coherence",
507
507
  "sourcePath": "src/server/routes.ts",
508
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
508
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
509
509
  "since": "2025-01-01"
510
510
  },
511
511
  "route-group:canonical-state": {
@@ -513,7 +513,7 @@
513
513
  "type": "route-group",
514
514
  "domain": "state",
515
515
  "sourcePath": "src/server/routes.ts",
516
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
516
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
517
517
  "since": "2025-01-01"
518
518
  },
519
519
  "route-group:ci": {
@@ -521,7 +521,7 @@
521
521
  "type": "route-group",
522
522
  "domain": "monitoring",
523
523
  "sourcePath": "src/server/routes.ts",
524
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
524
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
525
525
  "since": "2025-01-01"
526
526
  },
527
527
  "route-group:sessions": {
@@ -529,7 +529,7 @@
529
529
  "type": "route-group",
530
530
  "domain": "sessions",
531
531
  "sourcePath": "src/server/routes.ts",
532
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
532
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
533
533
  "since": "2025-01-01"
534
534
  },
535
535
  "route-group:jobs": {
@@ -537,7 +537,7 @@
537
537
  "type": "route-group",
538
538
  "domain": "scheduling",
539
539
  "sourcePath": "src/server/routes.ts",
540
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
540
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
541
541
  "since": "2025-01-01"
542
542
  },
543
543
  "route-group:skip-ledger": {
@@ -545,7 +545,7 @@
545
545
  "type": "route-group",
546
546
  "domain": "scheduling",
547
547
  "sourcePath": "src/server/routes.ts",
548
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
548
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
549
549
  "since": "2025-01-01"
550
550
  },
551
551
  "route-group:telegram": {
@@ -553,7 +553,7 @@
553
553
  "type": "route-group",
554
554
  "domain": "communication",
555
555
  "sourcePath": "src/server/routes.ts",
556
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
556
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
557
557
  "since": "2025-01-01"
558
558
  },
559
559
  "route-group:attention": {
@@ -561,7 +561,7 @@
561
561
  "type": "route-group",
562
562
  "domain": "communication",
563
563
  "sourcePath": "src/server/routes.ts",
564
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
564
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
565
565
  "since": "2025-01-01"
566
566
  },
567
567
  "route-group:relationships": {
@@ -569,7 +569,7 @@
569
569
  "type": "route-group",
570
570
  "domain": "relationships",
571
571
  "sourcePath": "src/server/routes.ts",
572
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
572
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
573
573
  "since": "2025-01-01"
574
574
  },
575
575
  "route-group:feedback": {
@@ -577,7 +577,7 @@
577
577
  "type": "route-group",
578
578
  "domain": "feedback",
579
579
  "sourcePath": "src/server/routes.ts",
580
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
580
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
581
581
  "since": "2025-01-01"
582
582
  },
583
583
  "route-group:updates": {
@@ -585,7 +585,7 @@
585
585
  "type": "route-group",
586
586
  "domain": "updates",
587
587
  "sourcePath": "src/server/routes.ts",
588
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
588
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
589
589
  "since": "2025-01-01"
590
590
  },
591
591
  "route-group:dispatches": {
@@ -593,7 +593,7 @@
593
593
  "type": "route-group",
594
594
  "domain": "dispatches",
595
595
  "sourcePath": "src/server/routes.ts",
596
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
596
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
597
597
  "since": "2025-01-01"
598
598
  },
599
599
  "route-group:quota": {
@@ -601,7 +601,7 @@
601
601
  "type": "route-group",
602
602
  "domain": "monitoring",
603
603
  "sourcePath": "src/server/routes.ts",
604
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
604
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
605
605
  "since": "2025-01-01"
606
606
  },
607
607
  "route-group:publishing": {
@@ -609,7 +609,7 @@
609
609
  "type": "route-group",
610
610
  "domain": "publishing",
611
611
  "sourcePath": "src/server/routes.ts",
612
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
612
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
613
613
  "since": "2025-01-01"
614
614
  },
615
615
  "route-group:private-views": {
@@ -617,7 +617,7 @@
617
617
  "type": "route-group",
618
618
  "domain": "publishing",
619
619
  "sourcePath": "src/server/routes.ts",
620
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
620
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
621
621
  "since": "2025-01-01"
622
622
  },
623
623
  "route-group:tunnel": {
@@ -625,7 +625,7 @@
625
625
  "type": "route-group",
626
626
  "domain": "networking",
627
627
  "sourcePath": "src/server/routes.ts",
628
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
628
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
629
629
  "since": "2025-01-01"
630
630
  },
631
631
  "route-group:events": {
@@ -633,7 +633,7 @@
633
633
  "type": "route-group",
634
634
  "domain": "networking",
635
635
  "sourcePath": "src/server/routes.ts",
636
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
636
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
637
637
  "since": "2025-01-01"
638
638
  },
639
639
  "route-group:evolution": {
@@ -641,7 +641,7 @@
641
641
  "type": "route-group",
642
642
  "domain": "evolution",
643
643
  "sourcePath": "src/server/routes.ts",
644
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
644
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
645
645
  "since": "2025-01-01"
646
646
  },
647
647
  "route-group:watchdog": {
@@ -649,7 +649,7 @@
649
649
  "type": "route-group",
650
650
  "domain": "monitoring",
651
651
  "sourcePath": "src/server/routes.ts",
652
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
652
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
653
653
  "since": "2025-01-01"
654
654
  },
655
655
  "route-group:topic-memory": {
@@ -657,7 +657,7 @@
657
657
  "type": "route-group",
658
658
  "domain": "memory",
659
659
  "sourcePath": "src/server/routes.ts",
660
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
660
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
661
661
  "since": "2025-01-01"
662
662
  },
663
663
  "route-group:state-sync": {
@@ -665,7 +665,7 @@
665
665
  "type": "route-group",
666
666
  "domain": "coordination",
667
667
  "sourcePath": "src/server/routes.ts",
668
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
668
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
669
669
  "since": "2025-01-01"
670
670
  },
671
671
  "route-group:intent": {
@@ -673,7 +673,7 @@
673
673
  "type": "route-group",
674
674
  "domain": "intent",
675
675
  "sourcePath": "src/server/routes.ts",
676
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
676
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
677
677
  "since": "2025-01-01"
678
678
  },
679
679
  "route-group:triage": {
@@ -681,7 +681,7 @@
681
681
  "type": "route-group",
682
682
  "domain": "safety",
683
683
  "sourcePath": "src/server/routes.ts",
684
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
684
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
685
685
  "since": "2025-01-01"
686
686
  },
687
687
  "route-group:operations": {
@@ -689,7 +689,7 @@
689
689
  "type": "route-group",
690
690
  "domain": "safety",
691
691
  "sourcePath": "src/server/routes.ts",
692
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
692
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
693
693
  "since": "2025-01-01"
694
694
  },
695
695
  "route-group:sentinel": {
@@ -697,7 +697,7 @@
697
697
  "type": "route-group",
698
698
  "domain": "safety",
699
699
  "sourcePath": "src/server/routes.ts",
700
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
700
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
701
701
  "since": "2025-01-01"
702
702
  },
703
703
  "route-group:trust": {
@@ -705,7 +705,7 @@
705
705
  "type": "route-group",
706
706
  "domain": "safety",
707
707
  "sourcePath": "src/server/routes.ts",
708
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
708
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
709
709
  "since": "2025-01-01"
710
710
  },
711
711
  "route-group:monitoring": {
@@ -713,7 +713,7 @@
713
713
  "type": "route-group",
714
714
  "domain": "monitoring",
715
715
  "sourcePath": "src/server/routes.ts",
716
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
716
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
717
717
  "since": "2025-01-01"
718
718
  },
719
719
  "route-group:commitments": {
@@ -721,7 +721,7 @@
721
721
  "type": "route-group",
722
722
  "domain": "commitments",
723
723
  "sourcePath": "src/server/routes.ts",
724
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
724
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
725
725
  "since": "2025-01-01"
726
726
  },
727
727
  "route-group:episodes": {
@@ -729,7 +729,7 @@
729
729
  "type": "route-group",
730
730
  "domain": "memory",
731
731
  "sourcePath": "src/server/routes.ts",
732
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
732
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
733
733
  "since": "2025-01-01"
734
734
  },
735
735
  "route-group:messages": {
@@ -737,7 +737,7 @@
737
737
  "type": "route-group",
738
738
  "domain": "coordination",
739
739
  "sourcePath": "src/server/routes.ts",
740
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
740
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
741
741
  "since": "2025-01-01"
742
742
  },
743
743
  "route-group:system-reviews": {
@@ -745,7 +745,7 @@
745
745
  "type": "route-group",
746
746
  "domain": "monitoring",
747
747
  "sourcePath": "src/server/routes.ts",
748
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
748
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
749
749
  "since": "2025-01-01"
750
750
  },
751
751
  "route-group:machine-mesh": {
@@ -761,7 +761,7 @@
761
761
  "type": "route-group",
762
762
  "domain": "security",
763
763
  "sourcePath": "src/server/routes.ts",
764
- "contentHash": "b00038a2fd922de8407c786d29ff86296ab470d491e9edc66a42beaae80039a1",
764
+ "contentHash": "02158bbab251ccad90f9db38cdfc4836f3d5560fa553f32abba30732b11f4f05",
765
765
  "since": "2025-01-01"
766
766
  },
767
767
  "cli:init": {
@@ -1457,7 +1457,7 @@
1457
1457
  "type": "subsystem",
1458
1458
  "domain": "server",
1459
1459
  "sourcePath": "src/server/AgentServer.ts",
1460
- "contentHash": "ba49a34f5358b90fe392c012295ad80d1a052736a2ddc9ecb2baffe80977f770",
1460
+ "contentHash": "1b85f747d68975a430434c51a1958c48dca6652021fcc2ce877bf7ccff172c9a",
1461
1461
  "since": "2025-01-01"
1462
1462
  },
1463
1463
  "subsystem:session-manager": {
@@ -0,0 +1,39 @@
1
+ # Instar Upgrade Guide — NEXT
2
+
3
+ <!-- bump: patch -->
4
+
5
+ ## What Changed
6
+
7
+ **"Open this" topics now arrive named + summarized.** When you promote a Threadline
8
+ conversation into its own topic ("open this" in the Threadline hub), the new topic used to
9
+ get a crude name (the first ~5 words of the cold message) and a single generic "tied to this
10
+ topic" marker — an unlabelled, empty room. Now an LLM names the topic from what the
11
+ conversation is actually about and writes a short orientation summary as the first message
12
+ (who the other agent is, what it's about, where it stands), so you walk in oriented.
13
+
14
+ This is strictly additive on top of the deterministic "open this" intercept. It NEVER fails
15
+ the bind: if the LLM can't run (timeout, daily spend cap, rate-limit, scrubbed output, or
16
+ the deps aren't wired in your build), "open this" degrades to a deterministic templated brief
17
+ (peer · message count · last activity · latest line) — and only falls back to the bare marker
18
+ when there's literally no conversation behind the entry yet. The LLM is a generator, never a
19
+ gate. The naming/summary call runs on the shared interactive LLM lane (you're waiting on it)
20
+ with a 3.5s ceiling, ~1 cent per call, governed by the existing daily spend cap.
21
+
22
+ Credential scrubbing uses value-pattern detection (actual `sk-…`/`xoxb-…`/`ghp_…`/key blocks),
23
+ not bare english words — so a legitimate technical topic ("token refresh triage", "API key
24
+ rotation") is named normally, while a pasted secret never lands in your chat-list title or the
25
+ first message.
26
+
27
+ ## What to Tell Your User
28
+
29
+ Nothing to do — it's automatic. Next time you "open this" in the Threadline topic, the new
30
+ topic shows up with a real name and a short summary of the conversation inside it, instead of
31
+ an empty room. "Tie this to <existing topic>" is unchanged. (The topic takes a few seconds to
32
+ appear while the summary is generated; if the model is slow you still get an instant plain brief.)
33
+
34
+ ## Summary of New Capabilities
35
+
36
+ | Capability | How to Use |
37
+ |-----------|-----------|
38
+ | "Open this" topics are LLM-named + summarized | In the Threadline hub topic, say "open this" — the new topic gets an LLM-generated name and a summary of the conversation as its first message. Automatic; no command or flag. |
39
+ | Always-contextful fallback | If the LLM can't run (timeout / daily cap / unwired), the new topic still gets a deterministic templated brief (peer · message count · last activity · latest line) instead of the old empty marker. The bind never fails on LLM trouble. |
@@ -0,0 +1,72 @@
1
+ # Side-Effects Review — Threadline "open this" LLM topic-name + summary (CMT-567)
2
+
3
+ **Version / slug:** `threadline-open-this-llm-naming`
4
+ **Date:** `2026-05-27`
5
+ **Author:** `echo`
6
+ **Spec:** `docs/specs/THREADLINE-OPEN-THIS-LLM-NAMING-SPEC.md` (converged 2-round / 4-reviewer, approved)
7
+ **Second-pass reviewer:** `not required` (UX continuation of #399, no new external surface; standard 2-round convergence applied)
8
+
9
+ ## Summary of the change
10
+
11
+ When the deterministic "open this" intercept (CMT-529 / PR #399) promotes a Threadline
12
+ conversation into its own topic, the new topic is now named by an LLM (from the conversation
13
+ gist) and its first message is an LLM-written orientation summary. A three-tier degrade
14
+ guarantees the bind never fails on LLM trouble:
15
+
16
+ - **Tier A — LLM.** Real conversation (≥2 messages) → Haiku call using the proven PURPOSE-line
17
+ convention (reuses `parsePurposeFromResponse` from `TopicSummarizer`, NOT JSON). PURPOSE →
18
+ topic name; body → summary. Runs on the shared `interactive` LlmQueue lane (operator is
19
+ waiting), `costCents=2`, 3.5s race (timeout + queue-abort, since `intelligence.evaluate`
20
+ honors `timeoutMs` but not an AbortSignal).
21
+ - **Tier B — deterministic template.** LLM skipped/failed → `💬 Conversation with <peer> · N
22
+ messages · last activity <when>. Latest: "<scrubbed inbound>"`. Zero cost/latency.
23
+ - **Tier C — slug + legacy marker.** No backing conversation (hub-notice-only entry) → existing
24
+ slug name + the legacy "tied to this topic" marker. No LLM call attempted.
25
+
26
+ Files touched:
27
+ - `src/threadline/openConversationBrief.ts` (**add**) — the 3-tier generator. Pure compute; never throws; never returns empty.
28
+ - `src/threadline/hubCommands.ts` (modify) — `HubBindDeps.brief?: BriefDeps` (optional); `open` branch calls `generateConversationBrief`, posts `brief.summary` as the first message, adds the `[hub/bind] open …` observability log line. `tie` branch unchanged (still posts the tie-marker; brief NOT invoked).
29
+ - `src/commands/server.ts` (modify) — build ONE `briefDeps` after `collaborationSurfacer`; thread to both `getHubDeps` closures + the `AgentServer` ctor.
30
+ - `src/server/AgentServer.ts` (modify) — `briefDeps?` on options interface; `briefDeps: options.briefDeps ?? null` into routeCtx.
31
+ - `src/server/routes.ts` (modify) — `briefDeps` on `RouteContext`; `POST /threadline/hub/bind` passes `brief: ctx.briefDeps ?? undefined`.
32
+ - `tests/unit/threadline/openConversationBrief.test.ts` (**add**) — 19 cases.
33
+ - `tests/unit/hubCommands.test.ts` (modify) — +4 brief-path cases (LLM / template / Tier-C / tie-not-invoked).
34
+ - `tests/integration/threadline/hub-bind-routes.test.ts` (modify) — +3 cases (LLM happy path; LLM-throws → bind still 200 + template; intelligence:null → bind still 200).
35
+ - `upgrades/NEXT.md` (modify) — release note.
36
+
37
+ ## Decision-point inventory
38
+
39
+ - `generateConversationBrief()` — **add** — three tiers; per-FIELD scrub-degrade (a credential in the PURPOSE degrades only the name, a credential in the body degrades only the summary). Never throws.
40
+ - Credential detection — **new, intentionally different from hubCommands.CREDENTIAL_RE.** `SECRET_VALUE_RE` (vendor-prefixed tokens / key blocks / JWT-ish) is applied to LLM output; `SECRET_ASSIGN_RE` (`password|secret|token|api_key… : value`) additionally guards the RAW inbound snippet. The bare-english-word regex used by the existing slug path would false-positive on normal technical prose ("token refresh", "API key rotation") and degrade most real summaries — so it is deliberately NOT reused for the prose summary. The existing slug-path `CREDENTIAL_RE` in `hubCommands.ts` is untouched.
41
+ - LlmQueue lane = `interactive` — operator is actively waiting; `background` would let a PresenceProxy arrival abort the in-flight brief (LlmQueue preempts only background victims).
42
+ - `HubBindDeps.brief` is OPTIONAL — when absent (existing callers / tests that don't wire it), the `open` path degrades to slug + legacy marker (exact pre-CMT-567 behavior). No back-compat break.
43
+ - `BriefDeps.topicNameFallback` is OPTIONAL — server-built `briefDeps` omits it (topicNameFor is private to hubCommands); `bindHubConversation` injects the real `topicNameFor` so the brief's slug matches the legacy path. A built-in `defaultSlug` guards direct callers.
44
+ - Single shared `briefDeps` (built once in server.ts) — closes the round-2 finding that the `POST /threadline/hub/bind` route had no scope path to `sharedLlmQueue`. One construction, three consumers (2 closures + ctx).
45
+ - Observability — one structured `console.log` per open: `nameSource / summarySource / latencyMs / reason`. Makes silent fallback diagnosable from `logs/server.log`.
46
+
47
+ ## Blast radius / reversibility
48
+
49
+ - **Additive only.** `tie` path, the deterministic intercept itself, the parent-topic reply surfacing, and all other Threadline routing are untouched.
50
+ - **No state files, no migrations.** Pure compute module; no persisted artifacts; `PostUpdateMigrator` needs no entry (verified — no agent-installed file changes).
51
+ - **No new agent API.** The agent doesn't call this; it fires inside the operator-invoked "open this". No CLAUDE.md template change needed (Agent Awareness Standard N/A).
52
+ - **Rollback:** single revert of the commit restores slug-name + legacy-marker verbatim.
53
+
54
+ ## Tests
55
+
56
+ - Unit (new module): 19 cases — all three tiers, every fallback cause, per-field credential scrub, technical-vocab-not-scrubbed, input truncation, never-empty invariant (incl. empty/whitespace threadId).
57
+ - Unit (hubCommands): +4 — LLM summary posted (not marker), LLM-throws → template, Tier-C marker, tie does not invoke brief.
58
+ - Integration (hub/bind route): +3 — LLM happy path names+summarizes; LLM-throws → 200 + template (regression guard: LLM failure NEVER fails the bind); intelligence:null → 200.
59
+ - Full threadline suite: 1580 passing, zero regressions. Production build clean (`tsc --noEmit` + `pnpm build`).
60
+
61
+ ## Test-as-self (live, real LLM — completed 2026-05-27)
62
+
63
+ Two-stage, real-dependency validation (no mocks):
64
+
65
+ 1. **Real-LLM harness (Echo's Claude provider, real threadline data).** Ran the BUILT `generateConversationBrief` against two real Echo threads with a real `ClaudeCliIntelligenceProvider`, real `LlmQueue`, real `ThreadlineObservability`. Produced clean LLM names + summaries (`reason: ok`). **This caught a production-breaking bug the mocks hid:** a real CLI call took ~8-10s, over the original 3.5s timeout — so the happy path would have silently fallen to the template in production. Fixed: default timeout 3.5s → 15s (+ word-boundary cap on the name so a long title doesn't read "…path resol"). Re-ran with the production default: `nameSource=llm`, ~9.7s, clean name "Arm the full response-review stack".
66
+
67
+ 2. **Live deploy on a real peer agent (instar-codey, Codex/gpt-5.2).** Backed up Codey's shadow-install dist + hub state, deployed this build, restarted via launchd, drove a real `POST /threadline/hub/bind action:open` against a 4-message unbound hub conversation. Result: topic 680 created, `topicName="Mentor ledger dedup strategy"` (LLM, not slug), server log `[hub/bind] open threadId=f3d471e9 topic=680 nameSource=llm summarySource=llm` — proving briefDeps booted non-null and the real Codex LLM produced both fields through the live server. Cleaned up: deleted test topic 680 (Bot API), restored dist + hub state, restarted Codey onto the released build, verified f3d471e9 reverted to unbound.
68
+
69
+ ## Post-test-as-self deviations (folded into this commit)
70
+
71
+ - Default `timeoutMs` 3.5s → **15s** (spec §3a updated with the measured rationale). The LLM tier is now the common outcome; template covers overruns.
72
+ - `scrubName` caps on a **word boundary** (no mid-word truncation in the chat-list title).