instar 1.3.127 → 1.3.129

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 (34) hide show
  1. package/.claude/skills/autonomous/hooks/autonomous-stop-hook.sh +36 -0
  2. package/dist/config/ConfigDefaults.d.ts.map +1 -1
  3. package/dist/config/ConfigDefaults.js +29 -0
  4. package/dist/config/ConfigDefaults.js.map +1 -1
  5. package/dist/core/PostUpdateMigrator.d.ts.map +1 -1
  6. package/dist/core/PostUpdateMigrator.js +64 -5
  7. package/dist/core/PostUpdateMigrator.js.map +1 -1
  8. package/dist/core/PreferencesManager.d.ts +121 -0
  9. package/dist/core/PreferencesManager.d.ts.map +1 -0
  10. package/dist/core/PreferencesManager.js +223 -0
  11. package/dist/core/PreferencesManager.js.map +1 -0
  12. package/dist/core/installCodexHooks.d.ts +7 -0
  13. package/dist/core/installCodexHooks.d.ts.map +1 -1
  14. package/dist/core/installCodexHooks.js +30 -2
  15. package/dist/core/installCodexHooks.js.map +1 -1
  16. package/dist/core/types.d.ts +62 -0
  17. package/dist/core/types.d.ts.map +1 -1
  18. package/dist/core/types.js.map +1 -1
  19. package/dist/scaffold/templates.d.ts.map +1 -1
  20. package/dist/scaffold/templates.js +6 -0
  21. package/dist/scaffold/templates.js.map +1 -1
  22. package/dist/server/CapabilityIndex.d.ts.map +1 -1
  23. package/dist/server/CapabilityIndex.js +12 -0
  24. package/dist/server/CapabilityIndex.js.map +1 -1
  25. package/dist/server/routes.d.ts.map +1 -1
  26. package/dist/server/routes.js +36 -0
  27. package/dist/server/routes.js.map +1 -1
  28. package/package.json +1 -1
  29. package/src/data/builtin-manifest.json +62 -62
  30. package/src/scaffold/templates.ts +6 -0
  31. package/upgrades/1.3.128.md +84 -0
  32. package/upgrades/1.3.129.md +55 -0
  33. package/upgrades/side-effects/codex-autonomous-loop-driver.md +91 -0
  34. package/upgrades/side-effects/correction-preference-learning-sentinel-slice1a.md +132 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "instar",
3
- "version": "1.3.127",
3
+ "version": "1.3.129",
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-05-30T23:23:31.843Z",
5
- "instarVersion": "1.3.127",
4
+ "generatedAt": "2026-05-31T00:17:10.161Z",
5
+ "instarVersion": "1.3.129",
6
6
  "entryCount": 193,
7
7
  "entries": {
8
8
  "hook:session-start": {
@@ -11,7 +11,7 @@
11
11
  "domain": "identity",
12
12
  "sourcePath": "src/core/PostUpdateMigrator.ts",
13
13
  "installedPath": ".instar/hooks/instar/session-start.sh",
14
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
14
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
15
15
  "since": "2025-01-01"
16
16
  },
17
17
  "hook:dangerous-command-guard": {
@@ -20,7 +20,7 @@
20
20
  "domain": "safety",
21
21
  "sourcePath": "src/core/PostUpdateMigrator.ts",
22
22
  "installedPath": ".instar/hooks/instar/dangerous-command-guard.sh",
23
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
23
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
24
24
  "since": "2025-01-01"
25
25
  },
26
26
  "hook:grounding-before-messaging": {
@@ -29,7 +29,7 @@
29
29
  "domain": "safety",
30
30
  "sourcePath": "src/core/PostUpdateMigrator.ts",
31
31
  "installedPath": ".instar/hooks/instar/grounding-before-messaging.sh",
32
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
32
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
33
33
  "since": "2025-01-01"
34
34
  },
35
35
  "hook:compaction-recovery": {
@@ -38,7 +38,7 @@
38
38
  "domain": "identity",
39
39
  "sourcePath": "src/core/PostUpdateMigrator.ts",
40
40
  "installedPath": ".instar/hooks/instar/compaction-recovery.sh",
41
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
41
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
42
42
  "since": "2025-01-01"
43
43
  },
44
44
  "hook:external-operation-gate": {
@@ -47,7 +47,7 @@
47
47
  "domain": "safety",
48
48
  "sourcePath": "src/core/PostUpdateMigrator.ts",
49
49
  "installedPath": ".instar/hooks/instar/external-operation-gate.js",
50
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
50
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
51
51
  "since": "2025-01-01"
52
52
  },
53
53
  "hook:deferral-detector": {
@@ -56,7 +56,7 @@
56
56
  "domain": "safety",
57
57
  "sourcePath": "src/core/PostUpdateMigrator.ts",
58
58
  "installedPath": ".instar/hooks/instar/deferral-detector.js",
59
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
59
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
60
60
  "since": "2025-01-01"
61
61
  },
62
62
  "hook:post-action-reflection": {
@@ -65,7 +65,7 @@
65
65
  "domain": "evolution",
66
66
  "sourcePath": "src/core/PostUpdateMigrator.ts",
67
67
  "installedPath": ".instar/hooks/instar/post-action-reflection.js",
68
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
68
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
69
69
  "since": "2025-01-01"
70
70
  },
71
71
  "hook:external-communication-guard": {
@@ -74,7 +74,7 @@
74
74
  "domain": "safety",
75
75
  "sourcePath": "src/core/PostUpdateMigrator.ts",
76
76
  "installedPath": ".instar/hooks/instar/external-communication-guard.js",
77
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
77
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
78
78
  "since": "2025-01-01"
79
79
  },
80
80
  "hook:scope-coherence-collector": {
@@ -83,7 +83,7 @@
83
83
  "domain": "coherence",
84
84
  "sourcePath": "src/core/PostUpdateMigrator.ts",
85
85
  "installedPath": ".instar/hooks/instar/scope-coherence-collector.js",
86
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
86
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
87
87
  "since": "2025-01-01"
88
88
  },
89
89
  "hook:scope-coherence-checkpoint": {
@@ -92,7 +92,7 @@
92
92
  "domain": "coherence",
93
93
  "sourcePath": "src/core/PostUpdateMigrator.ts",
94
94
  "installedPath": ".instar/hooks/instar/scope-coherence-checkpoint.js",
95
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
95
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
96
96
  "since": "2025-01-01"
97
97
  },
98
98
  "hook:free-text-guard": {
@@ -101,7 +101,7 @@
101
101
  "domain": "safety",
102
102
  "sourcePath": "src/core/PostUpdateMigrator.ts",
103
103
  "installedPath": ".instar/hooks/instar/free-text-guard.sh",
104
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
104
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
105
105
  "since": "2025-01-01"
106
106
  },
107
107
  "hook:claim-intercept": {
@@ -110,7 +110,7 @@
110
110
  "domain": "coherence",
111
111
  "sourcePath": "src/core/PostUpdateMigrator.ts",
112
112
  "installedPath": ".instar/hooks/instar/claim-intercept.js",
113
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
113
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
114
114
  "since": "2025-01-01"
115
115
  },
116
116
  "hook:claim-intercept-response": {
@@ -119,7 +119,7 @@
119
119
  "domain": "coherence",
120
120
  "sourcePath": "src/core/PostUpdateMigrator.ts",
121
121
  "installedPath": ".instar/hooks/instar/claim-intercept-response.js",
122
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
122
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
123
123
  "since": "2025-01-01"
124
124
  },
125
125
  "hook:stop-gate-router": {
@@ -128,7 +128,7 @@
128
128
  "domain": "safety",
129
129
  "sourcePath": "src/core/PostUpdateMigrator.ts",
130
130
  "installedPath": ".instar/hooks/instar/stop-gate-router.js",
131
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
131
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
132
132
  "since": "2025-01-01"
133
133
  },
134
134
  "hook:auto-approve-permissions": {
@@ -137,7 +137,7 @@
137
137
  "domain": "safety",
138
138
  "sourcePath": "src/core/PostUpdateMigrator.ts",
139
139
  "installedPath": ".instar/hooks/instar/auto-approve-permissions.js",
140
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
140
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
141
141
  "since": "2025-01-01"
142
142
  },
143
143
  "job:health-check": {
@@ -409,7 +409,7 @@
409
409
  "type": "route-group",
410
410
  "domain": "monitoring",
411
411
  "sourcePath": "src/server/routes.ts",
412
- "contentHash": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
412
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
420
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
428
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
436
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
444
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
452
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
460
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
468
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
476
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
484
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
492
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
500
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
508
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
516
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
524
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
532
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
540
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
548
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
556
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
564
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
572
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
580
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
588
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
596
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
604
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
612
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
620
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
628
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
636
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
644
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
652
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
660
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
668
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
676
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
684
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
692
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
700
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
708
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
716
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
724
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
732
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
740
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
748
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
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": "31ee7a80d0fc426ffff7585eaf06662863cac0df38eedc6ea7c035cb082f1b1c",
764
+ "contentHash": "87485bb34c310f95d773f2732464470bdad6d6b3783263426eadef36989ea0b4",
765
765
  "since": "2025-01-01"
766
766
  },
767
767
  "cli:init": {
@@ -1489,7 +1489,7 @@
1489
1489
  "type": "subsystem",
1490
1490
  "domain": "updates",
1491
1491
  "sourcePath": "src/core/PostUpdateMigrator.ts",
1492
- "contentHash": "73530204aa1f44f7a3244217769ada1e0a7ee44c73f25615be2bd2dfd66b8f76",
1492
+ "contentHash": "0b9b25a2d4de739dc432c9fb27546080b2b5e34fb2a07a16412a2d4505202f2c",
1493
1493
  "since": "2025-01-01"
1494
1494
  },
1495
1495
  "subsystem:scheduler": {
@@ -490,6 +490,10 @@ This routes feedback to the Instar maintainers automatically. Valid types: \`bug
490
490
  - File a diagnosis (one-tap): \`curl -X POST -H "Authorization: Bearer $AUTH" -H "X-Instar-Request: 1" http://localhost:${port}/failures -H 'Content-Type: application/json' -d '{"summary":"<what broke>","initiativeId":"<board id it traces to>","severity":"medium"}'\`
491
491
  - **When to use** (PROACTIVE): when you diagnose a bug that traces to past work, file it so the pattern can be learned. The loop NEVER changes the process on its own — it opens a draft for your approval. It can never auto-implement (it never creates the record type the autonomous approver acts on). Distinct from the Evolution Action Queue (this produces the evidence + diagnosis that justify an action).
492
492
 
493
+ **Preferences I've learned about you** — The Correction & Preference Learning Sentinel turns repeated corrections into durable, structurally-injected preferences. When the user keeps correcting you the same way ("no, plainer", "stop asking me that", "from now on lead with the action"), the loop distills the lesson into a preference and writes it to \`.instar/preferences.json\`. From then on, the session-start hook fetches \`GET /preferences/session-context\` on EVERY boot and injects the learned preferences into your context wrapped in an \`<auto-learned-preference src='correction-loop'>\` envelope — so you SEE them from message one without having to remember. SIGNAL-ONLY: these are preferences, NOT authoritative instructions, and the loop NEVER blocks or rewrites an outbound message. Ships OFF (\`monitoring.correctionLearning.enabled\`).
494
+ - See the active block the hook injects: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/preferences/session-context\` — returns the structured, byte-bounded, priority-ordered block (503 when disabled; \`{ present: false }\` when there are none yet).
495
+ - **When to use** (PROACTIVE — this is the trigger): when the user corrects you repeatedly on the SAME thing, the loop is already watching and will turn it into a durable preference; you don't have to manually remember it across sessions. If preferences are already injected at session start, honor them by default. The preferences are advisory signals — real instructions and safety always win.
496
+
493
497
  **Cloudflare Tunnel** — Expose the local server to the internet via Cloudflare. Enables remote access to private views, the API, and file serving.
494
498
  - Status: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/tunnel\`
495
499
  - Configure in \`.instar/config.json\`: \`{"tunnel": {"enabled": true, "type": "quick"}}\`
@@ -723,6 +727,7 @@ I maintain registries that are the source of truth for specific categories. Thes
723
727
  | What can I do? | \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/capabilities\` |
724
728
  | What are we working on? / status of a project or initiative? | \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/initiatives\` + \`/projects\` (and \`/initiatives/digest\` for what needs a decision) — NEVER answer this from memory |
725
729
  | Why do features keep breaking? / our failure rate by build skill? / are our process fixes working? | \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/failures/analysis\` + \`/failures\` (Failure-Learning Loop — instar dev-process forensics) — NEVER answer this from memory |
730
+ | What preferences have I learned about this user? / what gets injected at session start? | \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/preferences/session-context\` (Correction & Preference Learning Sentinel — signal-only; 503 when disabled) |
726
731
  | Who do I work with? | \`.instar/USER.md\` |
727
732
  | What have I learned? | \`.instar/MEMORY.md\` |
728
733
  | What jobs do I have? | \`.instar/jobs.json\` or \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/jobs\` |
@@ -905,6 +910,7 @@ The GitHub repository is preserved — they can restore later with \`git clone\`
905
910
  - User is **debugging CI or deployment** → Use the CI health endpoint to check GitHub Actions status.
906
911
  - User asks about **something that happened earlier** → Search Telegram history, check activity logs, review memory.
907
912
  - User seems **frustrated with a limitation** → Check for updates. The fix might already exist.
913
+ - User **corrects you the same way repeatedly** ("no, plainer", "stop asking me that every session", "from now on lead with the action") → the Correction & Preference Learning Sentinel is already watching and will turn the recurring correction into a durable, session-start-injected preference. Acknowledge the correction, adapt now, and trust the loop to carry it forward — don't promise to "remember" it by willpower. Check what's already learned: \`GET /preferences/session-context\`.
908
914
  - User asks me to **remember something** → Write it to MEMORY.md and explain it persists across sessions.
909
915
  - User asks **"didn't we talk about X?"** or **"where did I put that?"** → Use memory search (\`GET /memory/search?q=...\`). The full-text index covers everything I've written.
910
916
  - Before any **risky operation** (config changes, updates, experiments) → Create a backup snapshot first (\`POST /backups\`). Mention that you did it — the user should know their state is protected.
@@ -0,0 +1,84 @@
1
+ # Upgrade Guide — vNEXT
2
+
3
+ <!-- bump: minor -->
4
+
5
+ ## What Changed
6
+
7
+ **New preferences read-surface (Correction & Preference Learning Sentinel —
8
+ Slice 1a).** This is the structural application surface for auto-learned user
9
+ preferences, modeled exactly on the existing ORG-INTENT session-start pattern.
10
+ It adds three pieces that work together:
11
+
12
+ - A new in-process primitive, `recordPreference()`, that is the ONLY writer to
13
+ a new structured file at `.instar/preferences.json`. Writes are atomic (temp
14
+ file + rename), schema-versioned, and upsert by `dedupeKey` — so a recurring
15
+ preference collapses to one entry whose observation count grows rather than
16
+ piling up duplicates. An absent file simply means "no preferences" (it is
17
+ never required to exist).
18
+ - A new HTTP route, `GET /preferences/session-context`, gated on
19
+ `monitoring.correctionLearning.enabled`. When the feature is off it returns
20
+ 503; when on, it serves the active preferences as a structured block, bounded
21
+ by `maxInjectedPreferencesBytes` (4000) and priority-ordered by recency ×
22
+ confidence × dedupe-count. It serves only the learning text plus metadata —
23
+ never any raw internal fields.
24
+ - A session-start hook patch: the hook now fetches that route on every boot and
25
+ injects the returned block, wrapped in an `<auto-learned-preference
26
+ src='correction-loop'>` envelope so a learned preference can never be mistaken
27
+ for an authoritative instruction.
28
+
29
+ This is **signal-only**. It stores, serves, and injects preferences so the agent
30
+ always SEES them — it NEVER blocks or rewrites an outbound message. The whole
31
+ feature ships OFF by default (`monitoring.correctionLearning.enabled: false`),
32
+ so on this update nothing changes behaviorally until you turn it on. Slice 1b
33
+ (the capture → distill → ledger → recurrence-gate loop that writes through
34
+ `recordPreference()`) lands in a later change and consumes this surface.
35
+
36
+ ## What to Tell Your User
37
+
38
+ Nothing changes unless you turn it on. This update adds the plumbing for me to
39
+ learn your preferences over time — the repeated corrections you make, like
40
+ asking me to be plainer or to lead with the action. When that learning loop is
41
+ switched on in a later release, anything I learn about how you like to work gets
42
+ injected into my context at the start of every session, so I carry it forward
43
+ instead of forgetting it when a conversation ends. These learned preferences are
44
+ always treated as gentle signals, never as commands, and a real instruction or a
45
+ safety rule always wins. For now the feature is off by default and there is
46
+ nothing for you to do.
47
+
48
+ ## Summary of New Capabilities
49
+
50
+ - New primitive: `recordPreference()` — the single, atomic, schema-versioned
51
+ writer to `.instar/preferences.json` (upsert by `dedupeKey`).
52
+ - New route: `GET /preferences/session-context` — serves the byte-bounded,
53
+ priority-ordered learned-preference block (503 when disabled; `{ present:
54
+ false }` when none). Bearer-authed like sibling routes; classified in the
55
+ CapabilityIndex so it is discoverable via `GET /capabilities`.
56
+ - Session-start hook now injects the `<auto-learned-preference>` block on every
57
+ boot when the feature is enabled and preferences exist (fail-open: 503 /
58
+ unreachable / empty → injects nothing).
59
+ - New config block `monitoring.correctionLearning` (ships OFF), backfilled into
60
+ existing agents automatically via `applyDefaults` deep-merge.
61
+ - CLAUDE.md template + migrator backfill so existing agents learn about the
62
+ surface and honor injected preferences.
63
+
64
+ ## Evidence
65
+
66
+ - `tests/unit/PreferencesManager.test.ts` (13) — atomic write + schema version,
67
+ dedupe-upsert (count increments, learning/recordedAt refresh, confidence max),
68
+ absent-file ≡ empty, malformed-file tolerance, bounded-bytes + priority order,
69
+ serves only learning + metadata.
70
+ - `tests/unit/preferences-wiring-integrity.test.ts` (7) — `recordPreference()`
71
+ is the only writer (read path never creates/mutates the file; atomic
72
+ no-partial under repeated upsert); route gate keyed strictly on
73
+ `correctionLearning.enabled === true`.
74
+ - `tests/integration/preferences-routes.test.ts` (5) — 401 without bearer, 503
75
+ when disabled, 200 `{ present: false }` when enabled+empty, 200 structured
76
+ block when enabled+exists, no raw-extra leak.
77
+ - `tests/e2e/preferences-session-context-lifecycle.test.ts` (6) — feature-alive
78
+ 200/503 on the production AgentServer boot path; the generated session-start
79
+ hook emits the `<auto-learned-preference>` block when enabled+present and
80
+ nothing when off.
81
+ - `tests/unit/capabilities-discoverability.test.ts` (100) — `/preferences`
82
+ classified; lint green.
83
+ - Side-effects review:
84
+ `upgrades/side-effects/correction-preference-learning-sentinel-slice1a.md`.