instar 1.2.59 → 1.2.61

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "instar",
3
- "version": "1.2.59",
3
+ "version": "1.2.61",
4
4
  "description": "Persistent autonomy infrastructure for AI agents",
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-05-24T20:16:57.281Z",
5
- "instarVersion": "1.2.59",
4
+ "generatedAt": "2026-05-24T21:29:04.458Z",
5
+ "instarVersion": "1.2.61",
6
6
  "entryCount": 191,
7
7
  "entries": {
8
8
  "hook:session-start": {
@@ -392,7 +392,7 @@
392
392
  "type": "route-group",
393
393
  "domain": "monitoring",
394
394
  "sourcePath": "src/server/routes.ts",
395
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
395
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
396
396
  "since": "2025-01-01"
397
397
  },
398
398
  "route-group:agents": {
@@ -400,7 +400,7 @@
400
400
  "type": "route-group",
401
401
  "domain": "sessions",
402
402
  "sourcePath": "src/server/routes.ts",
403
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
403
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
404
404
  "since": "2025-01-01"
405
405
  },
406
406
  "route-group:backups": {
@@ -408,7 +408,7 @@
408
408
  "type": "route-group",
409
409
  "domain": "operations",
410
410
  "sourcePath": "src/server/routes.ts",
411
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
411
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
412
412
  "since": "2025-01-01"
413
413
  },
414
414
  "route-group:git": {
@@ -416,7 +416,7 @@
416
416
  "type": "route-group",
417
417
  "domain": "coordination",
418
418
  "sourcePath": "src/server/routes.ts",
419
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
419
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
420
420
  "since": "2025-01-01"
421
421
  },
422
422
  "route-group:memory": {
@@ -424,7 +424,7 @@
424
424
  "type": "route-group",
425
425
  "domain": "memory",
426
426
  "sourcePath": "src/server/routes.ts",
427
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
427
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
428
428
  "since": "2025-01-01"
429
429
  },
430
430
  "route-group:semantic": {
@@ -432,7 +432,7 @@
432
432
  "type": "route-group",
433
433
  "domain": "memory",
434
434
  "sourcePath": "src/server/routes.ts",
435
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
435
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
436
436
  "since": "2025-01-01"
437
437
  },
438
438
  "route-group:status": {
@@ -440,7 +440,7 @@
440
440
  "type": "route-group",
441
441
  "domain": "monitoring",
442
442
  "sourcePath": "src/server/routes.ts",
443
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
443
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
444
444
  "since": "2025-01-01"
445
445
  },
446
446
  "route-group:capabilities": {
@@ -448,7 +448,7 @@
448
448
  "type": "route-group",
449
449
  "domain": "mapping",
450
450
  "sourcePath": "src/server/routes.ts",
451
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
451
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
452
452
  "since": "2025-01-01"
453
453
  },
454
454
  "route-group:project-map": {
@@ -456,7 +456,7 @@
456
456
  "type": "route-group",
457
457
  "domain": "mapping",
458
458
  "sourcePath": "src/server/routes.ts",
459
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
459
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
460
460
  "since": "2025-01-01"
461
461
  },
462
462
  "route-group:coherence": {
@@ -464,7 +464,7 @@
464
464
  "type": "route-group",
465
465
  "domain": "coherence",
466
466
  "sourcePath": "src/server/routes.ts",
467
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
467
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
468
468
  "since": "2025-01-01"
469
469
  },
470
470
  "route-group:topic-bindings": {
@@ -472,7 +472,7 @@
472
472
  "type": "route-group",
473
473
  "domain": "sessions",
474
474
  "sourcePath": "src/server/routes.ts",
475
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
475
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
476
476
  "since": "2025-01-01"
477
477
  },
478
478
  "route-group:context": {
@@ -480,7 +480,7 @@
480
480
  "type": "route-group",
481
481
  "domain": "context",
482
482
  "sourcePath": "src/server/routes.ts",
483
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
483
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
484
484
  "since": "2025-01-01"
485
485
  },
486
486
  "route-group:scope-coherence": {
@@ -488,7 +488,7 @@
488
488
  "type": "route-group",
489
489
  "domain": "coherence",
490
490
  "sourcePath": "src/server/routes.ts",
491
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
491
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
492
492
  "since": "2025-01-01"
493
493
  },
494
494
  "route-group:canonical-state": {
@@ -496,7 +496,7 @@
496
496
  "type": "route-group",
497
497
  "domain": "state",
498
498
  "sourcePath": "src/server/routes.ts",
499
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
499
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
500
500
  "since": "2025-01-01"
501
501
  },
502
502
  "route-group:ci": {
@@ -504,7 +504,7 @@
504
504
  "type": "route-group",
505
505
  "domain": "monitoring",
506
506
  "sourcePath": "src/server/routes.ts",
507
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
507
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
508
508
  "since": "2025-01-01"
509
509
  },
510
510
  "route-group:sessions": {
@@ -512,7 +512,7 @@
512
512
  "type": "route-group",
513
513
  "domain": "sessions",
514
514
  "sourcePath": "src/server/routes.ts",
515
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
515
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
516
516
  "since": "2025-01-01"
517
517
  },
518
518
  "route-group:jobs": {
@@ -520,7 +520,7 @@
520
520
  "type": "route-group",
521
521
  "domain": "scheduling",
522
522
  "sourcePath": "src/server/routes.ts",
523
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
523
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
524
524
  "since": "2025-01-01"
525
525
  },
526
526
  "route-group:skip-ledger": {
@@ -528,7 +528,7 @@
528
528
  "type": "route-group",
529
529
  "domain": "scheduling",
530
530
  "sourcePath": "src/server/routes.ts",
531
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
531
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
532
532
  "since": "2025-01-01"
533
533
  },
534
534
  "route-group:telegram": {
@@ -536,7 +536,7 @@
536
536
  "type": "route-group",
537
537
  "domain": "communication",
538
538
  "sourcePath": "src/server/routes.ts",
539
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
539
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
540
540
  "since": "2025-01-01"
541
541
  },
542
542
  "route-group:attention": {
@@ -544,7 +544,7 @@
544
544
  "type": "route-group",
545
545
  "domain": "communication",
546
546
  "sourcePath": "src/server/routes.ts",
547
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
547
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
548
548
  "since": "2025-01-01"
549
549
  },
550
550
  "route-group:relationships": {
@@ -552,7 +552,7 @@
552
552
  "type": "route-group",
553
553
  "domain": "relationships",
554
554
  "sourcePath": "src/server/routes.ts",
555
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
555
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
556
556
  "since": "2025-01-01"
557
557
  },
558
558
  "route-group:feedback": {
@@ -560,7 +560,7 @@
560
560
  "type": "route-group",
561
561
  "domain": "feedback",
562
562
  "sourcePath": "src/server/routes.ts",
563
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
563
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
564
564
  "since": "2025-01-01"
565
565
  },
566
566
  "route-group:updates": {
@@ -568,7 +568,7 @@
568
568
  "type": "route-group",
569
569
  "domain": "updates",
570
570
  "sourcePath": "src/server/routes.ts",
571
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
571
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
572
572
  "since": "2025-01-01"
573
573
  },
574
574
  "route-group:dispatches": {
@@ -576,7 +576,7 @@
576
576
  "type": "route-group",
577
577
  "domain": "dispatches",
578
578
  "sourcePath": "src/server/routes.ts",
579
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
579
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
580
580
  "since": "2025-01-01"
581
581
  },
582
582
  "route-group:quota": {
@@ -584,7 +584,7 @@
584
584
  "type": "route-group",
585
585
  "domain": "monitoring",
586
586
  "sourcePath": "src/server/routes.ts",
587
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
587
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
588
588
  "since": "2025-01-01"
589
589
  },
590
590
  "route-group:publishing": {
@@ -592,7 +592,7 @@
592
592
  "type": "route-group",
593
593
  "domain": "publishing",
594
594
  "sourcePath": "src/server/routes.ts",
595
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
595
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
596
596
  "since": "2025-01-01"
597
597
  },
598
598
  "route-group:private-views": {
@@ -600,7 +600,7 @@
600
600
  "type": "route-group",
601
601
  "domain": "publishing",
602
602
  "sourcePath": "src/server/routes.ts",
603
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
603
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
604
604
  "since": "2025-01-01"
605
605
  },
606
606
  "route-group:tunnel": {
@@ -608,7 +608,7 @@
608
608
  "type": "route-group",
609
609
  "domain": "networking",
610
610
  "sourcePath": "src/server/routes.ts",
611
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
611
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
612
612
  "since": "2025-01-01"
613
613
  },
614
614
  "route-group:events": {
@@ -616,7 +616,7 @@
616
616
  "type": "route-group",
617
617
  "domain": "networking",
618
618
  "sourcePath": "src/server/routes.ts",
619
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
619
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
620
620
  "since": "2025-01-01"
621
621
  },
622
622
  "route-group:evolution": {
@@ -624,7 +624,7 @@
624
624
  "type": "route-group",
625
625
  "domain": "evolution",
626
626
  "sourcePath": "src/server/routes.ts",
627
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
627
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
628
628
  "since": "2025-01-01"
629
629
  },
630
630
  "route-group:watchdog": {
@@ -632,7 +632,7 @@
632
632
  "type": "route-group",
633
633
  "domain": "monitoring",
634
634
  "sourcePath": "src/server/routes.ts",
635
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
635
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
636
636
  "since": "2025-01-01"
637
637
  },
638
638
  "route-group:topic-memory": {
@@ -640,7 +640,7 @@
640
640
  "type": "route-group",
641
641
  "domain": "memory",
642
642
  "sourcePath": "src/server/routes.ts",
643
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
643
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
644
644
  "since": "2025-01-01"
645
645
  },
646
646
  "route-group:state-sync": {
@@ -648,7 +648,7 @@
648
648
  "type": "route-group",
649
649
  "domain": "coordination",
650
650
  "sourcePath": "src/server/routes.ts",
651
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
651
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
652
652
  "since": "2025-01-01"
653
653
  },
654
654
  "route-group:intent": {
@@ -656,7 +656,7 @@
656
656
  "type": "route-group",
657
657
  "domain": "intent",
658
658
  "sourcePath": "src/server/routes.ts",
659
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
659
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
660
660
  "since": "2025-01-01"
661
661
  },
662
662
  "route-group:triage": {
@@ -664,7 +664,7 @@
664
664
  "type": "route-group",
665
665
  "domain": "safety",
666
666
  "sourcePath": "src/server/routes.ts",
667
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
667
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
668
668
  "since": "2025-01-01"
669
669
  },
670
670
  "route-group:operations": {
@@ -672,7 +672,7 @@
672
672
  "type": "route-group",
673
673
  "domain": "safety",
674
674
  "sourcePath": "src/server/routes.ts",
675
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
675
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
676
676
  "since": "2025-01-01"
677
677
  },
678
678
  "route-group:sentinel": {
@@ -680,7 +680,7 @@
680
680
  "type": "route-group",
681
681
  "domain": "safety",
682
682
  "sourcePath": "src/server/routes.ts",
683
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
683
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
684
684
  "since": "2025-01-01"
685
685
  },
686
686
  "route-group:trust": {
@@ -688,7 +688,7 @@
688
688
  "type": "route-group",
689
689
  "domain": "safety",
690
690
  "sourcePath": "src/server/routes.ts",
691
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
691
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
692
692
  "since": "2025-01-01"
693
693
  },
694
694
  "route-group:monitoring": {
@@ -696,7 +696,7 @@
696
696
  "type": "route-group",
697
697
  "domain": "monitoring",
698
698
  "sourcePath": "src/server/routes.ts",
699
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
699
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
700
700
  "since": "2025-01-01"
701
701
  },
702
702
  "route-group:commitments": {
@@ -704,7 +704,7 @@
704
704
  "type": "route-group",
705
705
  "domain": "commitments",
706
706
  "sourcePath": "src/server/routes.ts",
707
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
707
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
708
708
  "since": "2025-01-01"
709
709
  },
710
710
  "route-group:episodes": {
@@ -712,7 +712,7 @@
712
712
  "type": "route-group",
713
713
  "domain": "memory",
714
714
  "sourcePath": "src/server/routes.ts",
715
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
715
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
716
716
  "since": "2025-01-01"
717
717
  },
718
718
  "route-group:messages": {
@@ -720,7 +720,7 @@
720
720
  "type": "route-group",
721
721
  "domain": "coordination",
722
722
  "sourcePath": "src/server/routes.ts",
723
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
723
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
724
724
  "since": "2025-01-01"
725
725
  },
726
726
  "route-group:system-reviews": {
@@ -728,7 +728,7 @@
728
728
  "type": "route-group",
729
729
  "domain": "monitoring",
730
730
  "sourcePath": "src/server/routes.ts",
731
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
731
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
732
732
  "since": "2025-01-01"
733
733
  },
734
734
  "route-group:machine-mesh": {
@@ -744,7 +744,7 @@
744
744
  "type": "route-group",
745
745
  "domain": "security",
746
746
  "sourcePath": "src/server/routes.ts",
747
- "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
747
+ "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
748
748
  "since": "2025-01-01"
749
749
  },
750
750
  "cli:init": {
@@ -0,0 +1,57 @@
1
+ # Upgrade Guide — NEXT (human-as-detector)
2
+
3
+ <!-- bump: minor -->
4
+ <!-- minor = new capability, backward compatible -->
5
+
6
+ ## What Changed
7
+
8
+ **New: instar now treats a human-caught coherence break as a first-class diagnostic signal.**
9
+
10
+ When the user has to point something out — "that's wrong", "you already said the opposite",
11
+ "that's out of date", "why didn't you catch this" — that correction is no longer just an
12
+ input to fix quietly. It is evidence that some automated guardian (CoherenceGate,
13
+ CoherenceMonitor, a freshness check) *should* have caught it and didn't. The new
14
+ `HumanAsDetectorLog` (`src/monitoring/HumanAsDetectorLog.ts`) observes inbound human
15
+ messages, classifies corrections with a conservative, precision-biased regex set (no LLM,
16
+ no network), and records each as a signal mapped to the guardian layer that plausibly
17
+ failed. Over time this builds a heat map of "where the human is doing the system's job",
18
+ exposed read-only at `GET /human-as-detector/summary`.
19
+
20
+ This is the user-feedback half of the Continuous Working Awareness north star: never let a
21
+ user correction go to waste. It mirrors `DegradationReporter`: a singleton configured at
22
+ startup, append-only JSONL persistence at `.instar/metrics/human-as-detector.jsonl`,
23
+ best-effort, and it never throws into message handling. The observe hook is chained onto the
24
+ inbound Telegram message callback (preserving prior callbacks; only inbound human messages
25
+ are observed).
26
+
27
+ ## What to Tell Your User
28
+
29
+ When you point out something I got wrong or stale, I now treat that as a sign one of my own
30
+ safety checks missed it — not just a one-off to fix and forget. I quietly keep score of which
31
+ checks keep letting things slip past, so we can see where my automated guardrails are weak and
32
+ strengthen them over time. Nothing for you to set up; existing agents get it on their next
33
+ update. You can ask me to show the heat map of where you've had to catch my mistakes.
34
+
35
+ ## Summary of New Capabilities
36
+
37
+ - New `HumanAsDetectorLog` monitor: classifies inbound human corrections into categories
38
+ (factual-correction, staleness, contradiction, source-of-truth-drift, repeat-ask,
39
+ meta-failure), each mapped to the guardian layer that should have caught it.
40
+ - New read-only endpoint `GET /human-as-detector/summary` — the heat map grouped by suspected
41
+ failed layer, plus recent signals.
42
+ - Append-only audit trail at `.instar/metrics/human-as-detector.jsonl`.
43
+ - Always-on, no config, no LLM, no network; best-effort and never throws into message handling.
44
+
45
+ ## Evidence
46
+
47
+ - Tier 1 (unit): 19 tests — 15 on the classifier/observe/heat-map core, 4 on the
48
+ inbound-human gating helper (`observeInboundMessage`). All pass.
49
+ - Tier 2 (integration): 3 tests against the real `createRoutes` pipeline — empty map,
50
+ recorded correction surfaces, non-correction ignored. All pass.
51
+ - Tier 3 (e2e): 2 tests booting the real route tree on a live HTTP server — endpoint alive
52
+ (200), and an observed correction flows to the live endpoint AND to the JSONL on disk.
53
+ All pass.
54
+ - `npx tsc --noEmit` clean.
55
+ - Ported from Dawn's reference implementation (the-portal handoff); built fresh on current
56
+ `origin/main`, not from the stale local checkout (avoids reverting SafeFsExecutor /
57
+ iMessage-attachment features per the handoff's critical warnings).
@@ -0,0 +1,37 @@
1
+ # Upgrade Guide — NEXT (A Wall Is a Hypothesis: new constitution standard + B16 guard)
2
+
3
+ <!-- bump: patch -->
4
+ <!-- patch = new guard rule within the existing outbound authority + docs; backward compatible -->
5
+
6
+ ## What Changed
7
+
8
+ **New constitution standard "A Wall Is a Hypothesis", with real structural enforcement.**
9
+
10
+ Added to the Standards Registry (The Substrate family, beside "The Right to Stand Ground"): before an agent declares a path infeasible / blocked / impossible because some interface or API is missing, it must first inventory the capabilities it already has. A limitation is a hypothesis to test against your own toolkit, not a verdict to accept. A real wall, named honestly after that inventory, is fine — the failure is surrendering without it.
11
+
12
+ Enforcement is a new always-evaluated rule, **B16_UNVERIFIED_WALL**, in `MessagingToneGate` (the same outbound-message authority that hosts B15's self-stop guard). It blocks an outbound message that declares infeasibility from a missing interface/API/mechanism when the message shows no evidence the agent checked its own tools first. Severity favors false-negatives: genuinely-external limits ("I can't read your email until you connect it"), walls reported after a visible inventory, real either/or questions, and messages discussing the rule all pass.
13
+
14
+ The standard is also registered in `docs/INSTAR-DESIGN-PRINCIPLES-AND-LESSONS.md` (P11), the catalog the `/spec-converge` reviewer loads, so specs that accept an untested wall are flagged at review time.
15
+
16
+ The registry's own "how a new standard joins" step was corrected for accuracy: the registry-wide conformance gate and the Usher that would read the registry directly are described as actively-being-built North Star surfaces, not as already live — the registry does not yet enforce itself.
17
+
18
+ ## What to Tell Your User
19
+
20
+ I added a new rule to my own constitution and wired it so it actually bites. Before I tell you something is impossible or can't be done, I now have to check the tools I already have that might get past it. The reason is a recent miss where I called a feature impossible because it had no official hookup for other programs — while forgetting that typing into a live session is one of my core abilities. A checker now reads my outgoing messages and stops me if I claim something is blocked without first showing I looked. The balance matters: this is not me never giving up. Real dead-ends, named after I've actually checked, go through fine, and so do normal limits like needing you to connect an account first. You should just notice fewer "that's impossible" answers that fall apart the moment you push back.
21
+
22
+ ## Summary of New Capabilities
23
+
24
+ - New constitution standard "A Wall Is a Hypothesis" in the Standards Registry (The Substrate family).
25
+ - New outbound-gate rule B16_UNVERIFIED_WALL blocks unverified infeasibility claims; biased toward false-negatives so ordinary messages pass.
26
+ - Standard registered as principle P11 in the design-principles catalog the spec-review reviewer reads.
27
+ - Registry governance step corrected to distinguish enforcement that is live today from the conformance gate and Usher being built.
28
+
29
+ ## Migration Notes
30
+
31
+ No action required. `MessagingToneGate` runs server-side, so the rule ships with the server on update — no per-agent migration. The changes to the Standards Registry and the design-principles catalog are repository documentation.
32
+
33
+ ## Evidence
34
+
35
+ - **Unit** (`tests/unit/messaging-tone-gate-b16.test.ts`, 9 tests): the B16 rule + its infeasibility markers + carve-outs render in the prompt; the gate accepts B16 as a valid rule id without fail-open on the /goal-style wall; both sides of the boundary pass correctly (wall-after-inventory, genuinely-external limit, rule-discussion); drift detection preserved (an invented rule id still fails open).
36
+ - **Integration** (`tests/integration/telegram-reply-b16-wall.test.ts`, 2 tests): through the real POST /telegram/reply route, a B16 block returns 422 with rule B16_UNVERIFIED_WALL and the message is not sent; a passing reply still delivers 200.
37
+ - tsc clean.
@@ -0,0 +1,43 @@
1
+ # Side-Effects Review — HumanAsDetectorLog
2
+
3
+ **Change**: Ports Dawn's human-as-detector pattern into Instar. Treats every human-caught
4
+ coherence break as a first-class signal about which automated layer failed to catch it.
5
+
6
+ ## Files
7
+ - `src/monitoring/HumanAsDetectorLog.ts` (new) — singleton, deterministic no-LLM classifier,
8
+ append-only `.instar/metrics/human-as-detector.jsonl`, `summarizeByLayer()` heat map, plus
9
+ the `observeInboundMessage()` gating helper (inbound-human-only).
10
+ - `tests/unit/HumanAsDetectorLog.test.ts` (new) — 19 unit tests (classifier/observe/heat-map +
11
+ gating-helper wiring integrity).
12
+ - `tests/integration/human-as-detector-routes.test.ts` (new) — 3 tests via real `createRoutes`.
13
+ - `tests/e2e/human-as-detector-lifecycle.test.ts` (new) — 2 tests, live HTTP boot + disk.
14
+ - `src/server/routes.ts` — adds read-only `GET /human-as-detector/summary` (singleton-backed).
15
+ - `src/commands/server.ts` — configure() at startup; `observeInboundMessage()` chained onto
16
+ `telegram.onMessageLogged` (chains prior callbacks; only inbound human messages).
17
+
18
+ ## Side effects
19
+ - **New disk write**: appends to `.instar/metrics/human-as-detector.jsonl` only when an
20
+ inbound human message matches a correction signal. Best-effort; wrapped in try/catch; never
21
+ throws into message handling.
22
+ - **Console**: one `[HUMAN-AS-DETECTOR]` warn line per detected signal (mirrors
23
+ DegradationReporter's loud-not-silent convention).
24
+ - **No network, no LLM, no external calls.** Classifier is pure regex over a conservative set.
25
+ - **No behavior change to message handling**: the hook only observes; prior `onMessageLogged`
26
+ callbacks (TopicMemory dual-write, PresenceProxy, keep-watching) are preserved via chaining.
27
+ - **New endpoint** is read-only and singleton-backed (always available; no 503 path).
28
+
29
+ ## Risk
30
+ - Low. Additive, isolated module. Worst case on a logic bug: a spurious JSONL line or a missed
31
+ signal — neither affects message delivery (observe never throws into the caller).
32
+ - False-positive risk on the classifier is bounded by the `totalWeight >= 2` threshold (lone
33
+ weak signals like "actually," are ignored).
34
+ - Rollback cost: trivial — drop the module, the endpoint, and the ~6 wiring lines; no schema,
35
+ no migration, no config default.
36
+
37
+ ## Signal vs authority
38
+ - Pure signal. The log only *records* and *summarizes*; it has no blocking authority and gates
39
+ nothing. Consumers (a human reading the heat map, or future evolution tooling) decide.
40
+
41
+ ## Verification
42
+ - `npx tsc --noEmit` — clean (no new errors).
43
+ - `npx vitest run` on the three new test files — 24/24 pass across unit + integration + e2e.
@@ -0,0 +1,49 @@
1
+ # Side-Effects Review — A Wall Is a Hypothesis (B16_UNVERIFIED_WALL)
2
+
3
+ **Slug:** `wall-is-a-hypothesis-standard`
4
+ **Date:** 2026-05-24
5
+ **Author:** echo
6
+ **Second-pass reviewer:** internal conformance pass
7
+
8
+ ## Summary of the change
9
+
10
+ Adds the constitution standard "A Wall Is a Hypothesis" to `docs/STANDARDS-REGISTRY.md` and its structural enforcement: a new always-evaluated rule **B16_UNVERIFIED_WALL** in `MessagingToneGate` (the existing outbound-message authority that hosts B15). B16 blocks an outbound message that declares a path impossible/blocked/infeasible because an interface/API/mechanism is missing, when the message shows no evidence the agent inventoried its own capabilities first. Also registers the standard in `docs/INSTAR-DESIGN-PRINCIPLES-AND-LESSONS.md` (the catalog the `/spec-converge` reviewer loads).
11
+
12
+ ## Decision-point inventory
13
+
14
+ - `VALID_RULES` set — **add** `'B16_UNVERIFIED_WALL'`. Without this the gate's drift-detection fails-open on a legitimate B16 citation.
15
+ - `buildPrompt()` rule section — **add** the B16 definition after B15 (always-evaluated, no precondition).
16
+ - Response-format enumeration + two stale doc comments — **modify** to include B16 (the comments already lagged at B14).
17
+ - No route changes: `checkOutboundMessage` → 422 is rule-agnostic; B16 rides the existing outbound paths.
18
+
19
+ ## 1. Over-block
20
+
21
+ The principal over-block risk: blocking ordinary "I can't do X" messages. Mitigated in the rule text — severity explicitly favors false-negatives; genuinely-external limits ("can't read your email until you connect it"), walls reported after a visible inventory, real either/or questions, real runtime errors, and messages discussing the rule all pass. The rule targets only the precise pattern: an internal feasibility verdict resting on a missing interface with no inventory shown.
22
+
23
+ ## 2. Under-block (a real wall-surrender slipping through)
24
+
25
+ Possible if the LLM judge misses a borderline case — acceptable by design (favor false-negatives), matching the gate's stated philosophy (high signal, not adversarial correctness). The standard + the `/spec-converge` registration provide the softer review-time catch as backup.
26
+
27
+ ## 3. Level-of-abstraction fit
28
+
29
+ Correct: the guard lives inside the single outbound authority (where B15 lives), not as a new detector with independent block power. Signal-vs-authority compliant.
30
+
31
+ ## 4. Blocking authority
32
+
33
+ No new brittle authority. B16 is one more rule the existing authority may cite; the 422 plumbing is unchanged. Fail-open behavior (LLM error/timeout/invalid-rule) is inherited unchanged.
34
+
35
+ ## 5. Interactions
36
+
37
+ B16 is always evaluated alongside B15 and the signal/health rules in one LLM call — no extra calls, marginally longer prompt. No interaction with the health-alert (B12-B14) or style (B11) rules, which remain gated by their preconditions. The drift-detection branch is unaffected (an invented rule id still fails open — covered by a regression test).
38
+
39
+ ## 6. External surfaces
40
+
41
+ None. No new endpoints, credentials, or network calls. The standard's enforcement claim was verified against code before authoring (the registry is not parsed at runtime; the conformance gate and Usher are unbuilt North Star designs) — so the "Applied through" line states only what exists.
42
+
43
+ ## 7. Rollback cost
44
+
45
+ Low. Reverting removes the rule from the set + prompt and the doc entries; no state, no migration, no schema. An older server simply lacks the rule.
46
+
47
+ ## 8. Test evidence
48
+
49
+ Unit (`messaging-tone-gate-b16.test.ts`, 9 tests) + integration (`telegram-reply-b16-wall.test.ts`, 2 tests) green; tsc clean. Both sides of the decision boundary covered with realistic inputs; the /goal-style wall blocks through the real route (422, message suppressed) and the happy path still delivers (200).