instar 1.2.24 → 1.2.26
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/dist/commands/server.d.ts.map +1 -1
- package/dist/commands/server.js +43 -5
- package/dist/commands/server.js.map +1 -1
- package/dist/core/PostUpdateMigrator.d.ts.map +1 -1
- package/dist/core/PostUpdateMigrator.js +21 -0
- package/dist/core/PostUpdateMigrator.js.map +1 -1
- package/dist/core/TradeoffResolver.d.ts +54 -0
- package/dist/core/TradeoffResolver.d.ts.map +1 -0
- package/dist/core/TradeoffResolver.js +181 -0
- package/dist/core/TradeoffResolver.js.map +1 -0
- package/dist/scaffold/templates.d.ts.map +1 -1
- package/dist/scaffold/templates.js +1 -0
- package/dist/scaffold/templates.js.map +1 -1
- package/dist/server/routes.d.ts.map +1 -1
- package/dist/server/routes.js +32 -0
- package/dist/server/routes.js.map +1 -1
- package/dist/utils/resolveNodeBinary.d.ts +71 -0
- package/dist/utils/resolveNodeBinary.d.ts.map +1 -0
- package/dist/utils/resolveNodeBinary.js +152 -0
- package/dist/utils/resolveNodeBinary.js.map +1 -0
- package/package.json +1 -1
- package/scripts/fix-better-sqlite3.cjs +24 -5
- package/scripts/resolve-node-binary.cjs +119 -0
- package/src/data/builtin-manifest.json +61 -61
- package/src/scaffold/templates.ts +1 -0
- package/upgrades/1.2.25.md +52 -0
- package/upgrades/1.2.26.md +51 -0
- package/upgrades/side-effects/fix-heal-execpath-staleness.md +92 -0
- package/upgrades/side-effects/org-intent-tradeoff-helper.md +88 -0
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "./builtin-manifest.schema.json",
|
|
3
3
|
"schemaVersion": 1,
|
|
4
|
-
"generatedAt": "2026-05-22T06:
|
|
5
|
-
"instarVersion": "1.2.
|
|
4
|
+
"generatedAt": "2026-05-22T06:46:36.393Z",
|
|
5
|
+
"instarVersion": "1.2.26",
|
|
6
6
|
"entryCount": 191,
|
|
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": "
|
|
14
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
23
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
32
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
41
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
50
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
59
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
68
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
77
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
86
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
95
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
104
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
113
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
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": "
|
|
122
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
123
123
|
"since": "2025-01-01"
|
|
124
124
|
},
|
|
125
125
|
"hook:auto-approve-permissions": {
|
|
@@ -128,7 +128,7 @@
|
|
|
128
128
|
"domain": "safety",
|
|
129
129
|
"sourcePath": "src/core/PostUpdateMigrator.ts",
|
|
130
130
|
"installedPath": ".instar/hooks/instar/auto-approve-permissions.js",
|
|
131
|
-
"contentHash": "
|
|
131
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
132
132
|
"since": "2025-01-01"
|
|
133
133
|
},
|
|
134
134
|
"job:health-check": {
|
|
@@ -392,7 +392,7 @@
|
|
|
392
392
|
"type": "route-group",
|
|
393
393
|
"domain": "monitoring",
|
|
394
394
|
"sourcePath": "src/server/routes.ts",
|
|
395
|
-
"contentHash": "
|
|
395
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
403
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
411
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
419
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
427
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
435
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
443
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
451
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
459
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
467
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
475
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
483
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
491
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
499
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
507
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
515
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
523
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
531
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
539
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
547
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
555
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
563
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
571
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
579
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
587
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
595
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
603
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
611
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
619
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
627
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
635
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
643
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
651
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
659
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
667
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
675
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
683
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
691
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
699
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
707
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
715
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
723
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
731
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
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": "
|
|
747
|
+
"contentHash": "1d93447de40690d7d09da0aa42cf55de249ff5a5d5f511aabe3920e177b734fd",
|
|
748
748
|
"since": "2025-01-01"
|
|
749
749
|
},
|
|
750
750
|
"cli:init": {
|
|
@@ -1472,7 +1472,7 @@
|
|
|
1472
1472
|
"type": "subsystem",
|
|
1473
1473
|
"domain": "updates",
|
|
1474
1474
|
"sourcePath": "src/core/PostUpdateMigrator.ts",
|
|
1475
|
-
"contentHash": "
|
|
1475
|
+
"contentHash": "80f699f4baffa32f6e703110d72a227d27ee6aa34c725d10ffecad5ad2310457",
|
|
1476
1476
|
"since": "2025-01-01"
|
|
1477
1477
|
},
|
|
1478
1478
|
"subsystem:scheduler": {
|
|
@@ -1503,6 +1503,7 @@ Manage it:
|
|
|
1503
1503
|
- Validate agent intent against org intent (static analysis): \`instar intent validate\`
|
|
1504
1504
|
- Inspect the parsed structure: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/intent/org\`
|
|
1505
1505
|
- Preview the session-start block: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/intent/org/session-context\`
|
|
1506
|
+
- Resolve a tradeoff via the org hierarchy (Phase 3): \`curl -X POST -H "Authorization: Bearer $AUTH" -H 'Content-Type: application/json' -d '{"valueA":"speed","valueB":"customer trust"}' http://localhost:${port}/intent/tradeoff-resolve\` — returns the winning value with explanation per the org's tradeoff hierarchy.
|
|
1506
1507
|
|
|
1507
1508
|
## Agent Infrastructure
|
|
1508
1509
|
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Upgrade Guide — vNEXT
|
|
2
|
+
|
|
3
|
+
<!-- bump: minor -->
|
|
4
|
+
<!-- minor = new capability (ORG-INTENT tradeoff helper — Phase 3). -->
|
|
5
|
+
|
|
6
|
+
## What Changed
|
|
7
|
+
|
|
8
|
+
**feat(org-intent-runtime): deterministic tradeoff helper for `ORG-INTENT.md` (Phase 3 of 4).**
|
|
9
|
+
|
|
10
|
+
Phases 1 (v1.2.23) and 2 (v1.2.24) surfaced the tradeoff hierarchy from `ORG-INTENT.md` to the Coherence Gate at message-review time and to the agent's session-start context. Both use LLM-based reasoning to resolve values collisions. Phase 3 adds a deterministic standalone helper so code paths OUTSIDE the reviewer — research agents, planning passes, future jobs, the agent itself when asked a direct "which value wins?" question — can consult the hierarchy without paying for an LLM call.
|
|
11
|
+
|
|
12
|
+
The helper is a pure function in a new module:
|
|
13
|
+
|
|
14
|
+
- `src/core/TradeoffResolver.ts` — exported `resolveTradeoff({ valueA, valueB, hierarchy })` returning `{ winner, basis, explanation, matchedIndexA, matchedIndexB }`. No LLM, no fuzzy matching beyond case-insensitive substring containment. Predictable for any caller.
|
|
15
|
+
|
|
16
|
+
It is also exposed via a single HTTP route:
|
|
17
|
+
|
|
18
|
+
- `POST /intent/tradeoff-resolve` — accepts `{ valueA, valueB }` body, loads `ORG-INTENT.md` via `OrgIntentManager.parse()`, applies the resolver, and returns the resolution plus the org's hierarchy.
|
|
19
|
+
|
|
20
|
+
The resolver applies three strategies in priority order:
|
|
21
|
+
|
|
22
|
+
1. **Pair-pattern** — entries like "customer trust over speed" honor explicit pairwise statements (also accepts `before`, `above`, `trumps`, `wins over`, `beats`).
|
|
23
|
+
2. **List-order** — case-insensitive substring matching against hierarchy entries; the earlier-indexed match wins.
|
|
24
|
+
3. **No match** — returns null winner with `basis: 'no-match'` for callers to handle (typically by escalating to value-alignment review).
|
|
25
|
+
|
|
26
|
+
Per `feedback_signal_vs_authority`: the resolver is SIGNAL — it has no authority over outcomes. The Coherence Gate from Phase 1 remains AUTHORITY for any value-alignment block. The reviewer in the gate continues to use LLM-based resolution from the structured hierarchy; this new helper is for non-reviewer code paths.
|
|
27
|
+
|
|
28
|
+
Phase 4 (drift detection job) remains queued.
|
|
29
|
+
|
|
30
|
+
Spec: `docs/specs/ORG-INTENT-TRADEOFF-HELPER-SPEC.md`. ELI16 companion: `docs/specs/ORG-INTENT-TRADEOFF-HELPER-SPEC.eli16.md`. Side-effects review: `upgrades/side-effects/org-intent-tradeoff-helper.md`.
|
|
31
|
+
|
|
32
|
+
## What to Tell Your User
|
|
33
|
+
|
|
34
|
+
If you have a tradeoff hierarchy in your organizational intent file, your agent can now resolve tradeoff questions deterministically: given two contending values, it can ask the new endpoint which value wins per the hierarchy, and get back a clear answer with a human-readable explanation. The agent uses this when it needs a fast non-LLM tie-break — for example in research or planning code paths.
|
|
35
|
+
|
|
36
|
+
The new endpoint is purely additive; existing behavior is unchanged. If you don't have a tradeoff hierarchy in your file, the endpoint returns a no-match response and callers fall back to LLM-based reasoning.
|
|
37
|
+
|
|
38
|
+
## Summary of New Capabilities
|
|
39
|
+
|
|
40
|
+
- **POST /intent/tradeoff-resolve** — new HTTP route returning a deterministic tradeoff resolution per the org's hierarchy.
|
|
41
|
+
- **`resolveTradeoff()` exported function** — pure logic helper usable by any new callsite that wants deterministic hierarchy consultation.
|
|
42
|
+
- **Three resolution strategies** — pair-pattern, list-order ranking, and no-match escalation.
|
|
43
|
+
- **Migration parity** — existing agents' CLAUDE.md ORG-INTENT subsection gains a Phase 3 curl line automatically.
|
|
44
|
+
|
|
45
|
+
## Evidence
|
|
46
|
+
|
|
47
|
+
- Tier 1 unit tests: `tests/unit/TradeoffResolver.test.ts` (16 new tests, all passing). `tests/unit/PostUpdateMigrator-org-intent-runtime.test.ts` extended with 1 new test for Phase 3 migration (8 total, all passing).
|
|
48
|
+
- Tier 2 integration tests: `tests/integration/org-intent-routes.test.ts` extended with 5 new tests for the tradeoff-resolve route (16 total, all passing).
|
|
49
|
+
- Tier 3 E2E lifecycle tests: `tests/e2e/org-intent-tradeoff-lifecycle.test.ts` (5 tests mirroring production wiring through `AgentServer` and `createRoutes`, all passing — including the "feature is alive" 200-not-503 check).
|
|
50
|
+
- Type-check: `npx tsc --noEmit` clean.
|
|
51
|
+
- Lint: clean.
|
|
52
|
+
- The full test suite must remain green before merge per Zero-Failure Standard.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Upgrade Guide — vNEXT
|
|
2
|
+
|
|
3
|
+
<!-- bump: patch -->
|
|
4
|
+
<!-- patch = bug fixes, refactors, test additions, doc updates -->
|
|
5
|
+
|
|
6
|
+
## What Changed
|
|
7
|
+
|
|
8
|
+
**fix(heal): better-sqlite3 self-heal now survives Homebrew Node updates that strand process.execPath.**
|
|
9
|
+
|
|
10
|
+
When Homebrew (or any package manager) updates Node while an instar server is running, the brew install swaps the `/opt/homebrew/bin/node` symlink and removes the previous Cellar directory. The server process keeps an open file descriptor to the deleted binary, so it continues executing — but any new `spawnSync(process.execPath, ...)` call returns ENOENT. The native-module self-heal path runs through exactly that kind of spawn, so the heal silently fails. The agent then degrades to legacy-memory fallbacks and stays there across restarts (the next startup hits the same stale execPath).
|
|
11
|
+
|
|
12
|
+
This was observed live on luna 2026-05-21. Server log showed the heal firing at 02:46:00, then 150ms later: `"rebuild failed (spawnSync /opt/homebrew/Cellar/node/25.6.1/bin/node ENOENT). SQLite subsystems may degrade."` Knowledge graph, conversation summaries, and the pending-relay queue all went offline while a healthy Node (a different Cellar version) was sitting on disk a few millimetres away.
|
|
13
|
+
|
|
14
|
+
The fix:
|
|
15
|
+
|
|
16
|
+
1. New `resolveStableNodeBinary()` helper at `src/utils/resolveNodeBinary.ts` (with a CommonJS twin at `scripts/resolve-node-binary.cjs`). It walks a fallback chain — `process.execPath` → `fs.realpathSync(execPath)` → optional caller-supplied bundled Node → `/opt/homebrew/bin/node` (the stable symlink Homebrew always maintains) → `/usr/local/bin/node` → `/usr/bin/node` → `which node` — and returns the first existing-and-executable path, or null when every candidate fails.
|
|
17
|
+
|
|
18
|
+
2. `ensureSqliteBindings()` in `src/commands/server.ts` now resolves the spawn target through `resolveStableNodeBinary()` before invoking either the bundled `fix-better-sqlite3.cjs` or the npm-rebuild fallback. If resolution returns null, a structured DegradationReporter event is emitted with an explicit recovery hint instead of the previous "rebuild failed (ENOENT)" log line.
|
|
19
|
+
|
|
20
|
+
3. `scripts/fix-better-sqlite3.cjs` resolves once at module load and uses the resolved path for every internal spawn (testBinary probe, verifyChildAbiMatches defence, source-build via npm). `findNpmCli` also resolves the npm sibling relative to the resolved Node so a stale execPath doesn't poison npm discovery.
|
|
21
|
+
|
|
22
|
+
4. When the rebuild itself still fails after resolution, `ensureSqliteBindings()` emits a second DegradationReporter event (`ensureSqliteBindings.rebuildFailed`) with a user-actionable recovery hint. Previously the failure was a single yellow log line; now it surfaces through the same degradation channel operators already monitor.
|
|
23
|
+
|
|
24
|
+
Fail-closed semantics preserved: if no Node binary is reachable anywhere, the heal does NOT proceed (the alternative — guessing wrong — risks producing an ABI-mismatched binary that fails silently later). The DegradationReporter event names the missing Node so the operator can fix it.
|
|
25
|
+
|
|
26
|
+
## Evidence
|
|
27
|
+
|
|
28
|
+
Failure mode reproduced and verified to stop:
|
|
29
|
+
|
|
30
|
+
Reproduction (`tests/integration/heal-execpath-staleness.test.ts`) covers six scenarios drawn directly from the luna incident:
|
|
31
|
+
|
|
32
|
+
1. `spawnSync` against a stale Cellar path (`/opt/homebrew/Cellar/node/0.0.0-removed-by-brew/bin/node`) returns ENOENT — the same shape as the luna server log line.
|
|
33
|
+
2. The resolver returns a working fallback when execPath is stale. A child process spawned against the resolved path executes successfully.
|
|
34
|
+
3. `fix-better-sqlite3.cjs` resolves a stable Node binary at module load (resolver and script both present, exported helpers callable).
|
|
35
|
+
4. The resolver fails closed when no Node is reachable anywhere — does not silently pick a phantom path.
|
|
36
|
+
5. The resolver rejects non-executable files even when they exist at the requested path (defence against `chmod -x` or write-only files).
|
|
37
|
+
|
|
38
|
+
Plus seven unit tests in `tests/unit/resolveNodeBinary.test.ts` covering the full fallback chain branch-by-branch.
|
|
39
|
+
|
|
40
|
+
The live fix on luna (manually-invoked `fix-better-sqlite3.cjs` via the resolved Node binary) brought her degradation count from 8 to 1, with SemanticMemory, TopicMemory, FeatureRegistry, and the pending-relay queue all returning to healthy. With this PR landed, the same recovery will run automatically on every server restart that detects the mismatch.
|
|
41
|
+
|
|
42
|
+
## What to Tell Your User
|
|
43
|
+
|
|
44
|
+
If your agent ever logged "rebuild failed (spawnSync ... ENOENT)" after a Homebrew Node update — most often visible as your knowledge graph or conversation summaries going offline while the agent still appears to be running — this fix lets the agent recover on the next restart without manual help. The heal now tries multiple Node paths instead of just the one the server happened to launch with, so a brew-swept-out-from-under-us Cellar path no longer blocks rebuild.
|
|
45
|
+
|
|
46
|
+
## Summary of New Capabilities
|
|
47
|
+
|
|
48
|
+
| Capability | How to Use |
|
|
49
|
+
|-----------|-----------|
|
|
50
|
+
| Heal survives stale `process.execPath` | automatic on next server restart |
|
|
51
|
+
| DegradationReporter event on heal failure | automatic — surfaces through existing `/degradations` and any consumers watching that channel |
|