instar 1.3.760 → 1.3.762

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.3.760",
3
+ "version": "1.3.762",
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",
@@ -4,8 +4,8 @@
4
4
  "$schemaNote": "registrySchemaVersion 2 = the enriched Doorway/Model Knowledge Registry. Increment 1 (spec §Rollout step 1) added the per-door topModels[] frontier-derivation layer + the derived-frontier lint (report mode). Increment 2 (spec §Rollout step 2) ADDS the per-door probe{} block + candidateDoorways[] below — the metadata the deterministic prober (scripts/doorway-scan.mjs) reads to know HOW to re-verify each door — plus the live scan-state (.instar/state/doorway-scan.json) + the dark (enabled:false) doorway-scan job. Both additions are backward-compatible: the freshness lint ignores probe{}/candidateDoorways entirely (it reads only topModels/frontier/pins). GET /doorways is a LATER increment (spec §Rollout step 3) and is NOT wired yet.",
5
5
  "lastReviewedAt": "2026-07-03",
6
6
  "stalenessWindowDays": 45,
7
- "enforcement": "report",
8
- "$enforcementNote": "'report' = non-gating (prints findings, always exits 0) the dark/reversible default while the current list is known-stale. Flip to 'strict' (exits 1 on any finding) ONLY after the flaggedStale door swaps below are operator-confirmed and applied AND the standard is ratified (spec §Rollout step 5). Env INSTAR_MODEL_FRESHNESS_STRICT=1 forces strict for a one-off run.",
7
+ "enforcement": "strict",
8
+ "$enforcementNote": "'strict' = GATING (exits 1 on any finding: staleness, drift, or a flaggedStale row) flipped from 'report' in rollout increment 5 (spec §Rollout step 5, the companion-gated activation) now that the prior flaggedStale door swaps are operator-confirmed + reconciled into topModels (flaggedStale is empty) and the derived-frontier drift + staleness teeth pass clean. This is the LIVE TEETH that the 'Keep the Doorway/Model Map Current' constitutional standard is ratified WITH (not ahead of). The lint runs in the `npm run lint` chain, so a future staleness age-out (lastReviewedAt exceeds stalenessWindowDays) or a pin drifting off its door's derived frontier set now FAILS CI — the anti-rot ratchet, by design. To revert to non-gating (dark/reversible rollback), set this field back to 'report'. Env INSTAR_MODEL_FRESHNESS_STRICT=1 forces strict for a one-off run regardless of this field.",
9
9
  "doors": {
10
10
  "claude-code": {
11
11
  "name": "Claude Code CLI",
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "./builtin-manifest.schema.json",
3
3
  "schemaVersion": 1,
4
- "generatedAt": "2026-07-04T20:03:31.063Z",
5
- "instarVersion": "1.3.760",
4
+ "generatedAt": "2026-07-04T21:09:40.527Z",
5
+ "instarVersion": "1.3.762",
6
6
  "entryCount": 202,
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": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
14
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
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": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
23
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
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": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
32
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
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": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
41
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
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": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
50
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
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": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
59
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
60
60
  "since": "2025-01-01"
61
61
  },
62
62
  "hook:self-stop-guard": {
@@ -65,7 +65,7 @@
65
65
  "domain": "coherence",
66
66
  "sourcePath": "src/core/PostUpdateMigrator.ts",
67
67
  "installedPath": ".instar/hooks/instar/self-stop-guard.js",
68
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
68
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
69
69
  "since": "2025-01-01"
70
70
  },
71
71
  "hook:post-action-reflection": {
@@ -74,7 +74,7 @@
74
74
  "domain": "evolution",
75
75
  "sourcePath": "src/core/PostUpdateMigrator.ts",
76
76
  "installedPath": ".instar/hooks/instar/post-action-reflection.js",
77
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
77
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
78
78
  "since": "2025-01-01"
79
79
  },
80
80
  "hook:external-communication-guard": {
@@ -83,7 +83,7 @@
83
83
  "domain": "safety",
84
84
  "sourcePath": "src/core/PostUpdateMigrator.ts",
85
85
  "installedPath": ".instar/hooks/instar/external-communication-guard.js",
86
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
86
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
87
87
  "since": "2025-01-01"
88
88
  },
89
89
  "hook:scope-coherence-collector": {
@@ -92,7 +92,7 @@
92
92
  "domain": "coherence",
93
93
  "sourcePath": "src/core/PostUpdateMigrator.ts",
94
94
  "installedPath": ".instar/hooks/instar/scope-coherence-collector.js",
95
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
95
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
96
96
  "since": "2025-01-01"
97
97
  },
98
98
  "hook:scope-coherence-checkpoint": {
@@ -101,7 +101,7 @@
101
101
  "domain": "coherence",
102
102
  "sourcePath": "src/core/PostUpdateMigrator.ts",
103
103
  "installedPath": ".instar/hooks/instar/scope-coherence-checkpoint.js",
104
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
104
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
105
105
  "since": "2025-01-01"
106
106
  },
107
107
  "hook:free-text-guard": {
@@ -110,7 +110,7 @@
110
110
  "domain": "safety",
111
111
  "sourcePath": "src/core/PostUpdateMigrator.ts",
112
112
  "installedPath": ".instar/hooks/instar/free-text-guard.sh",
113
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
113
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
114
114
  "since": "2025-01-01"
115
115
  },
116
116
  "hook:claim-intercept": {
@@ -119,7 +119,7 @@
119
119
  "domain": "coherence",
120
120
  "sourcePath": "src/core/PostUpdateMigrator.ts",
121
121
  "installedPath": ".instar/hooks/instar/claim-intercept.js",
122
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
122
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
123
123
  "since": "2025-01-01"
124
124
  },
125
125
  "hook:claim-intercept-response": {
@@ -128,7 +128,7 @@
128
128
  "domain": "coherence",
129
129
  "sourcePath": "src/core/PostUpdateMigrator.ts",
130
130
  "installedPath": ".instar/hooks/instar/claim-intercept-response.js",
131
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
131
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
132
132
  "since": "2025-01-01"
133
133
  },
134
134
  "hook:stop-gate-router": {
@@ -137,7 +137,7 @@
137
137
  "domain": "safety",
138
138
  "sourcePath": "src/core/PostUpdateMigrator.ts",
139
139
  "installedPath": ".instar/hooks/instar/stop-gate-router.js",
140
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
140
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
141
141
  "since": "2025-01-01"
142
142
  },
143
143
  "hook:auto-approve-permissions": {
@@ -146,7 +146,7 @@
146
146
  "domain": "safety",
147
147
  "sourcePath": "src/core/PostUpdateMigrator.ts",
148
148
  "installedPath": ".instar/hooks/instar/auto-approve-permissions.js",
149
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
149
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
150
150
  "since": "2025-01-01"
151
151
  },
152
152
  "job:health-check": {
@@ -418,7 +418,7 @@
418
418
  "type": "route-group",
419
419
  "domain": "monitoring",
420
420
  "sourcePath": "src/server/routes.ts",
421
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
421
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
422
422
  "since": "2025-01-01"
423
423
  },
424
424
  "route-group:agents": {
@@ -426,7 +426,7 @@
426
426
  "type": "route-group",
427
427
  "domain": "sessions",
428
428
  "sourcePath": "src/server/routes.ts",
429
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
429
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
430
430
  "since": "2025-01-01"
431
431
  },
432
432
  "route-group:backups": {
@@ -434,7 +434,7 @@
434
434
  "type": "route-group",
435
435
  "domain": "operations",
436
436
  "sourcePath": "src/server/routes.ts",
437
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
437
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
438
438
  "since": "2025-01-01"
439
439
  },
440
440
  "route-group:git": {
@@ -442,7 +442,7 @@
442
442
  "type": "route-group",
443
443
  "domain": "coordination",
444
444
  "sourcePath": "src/server/routes.ts",
445
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
445
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
446
446
  "since": "2025-01-01"
447
447
  },
448
448
  "route-group:memory": {
@@ -450,7 +450,7 @@
450
450
  "type": "route-group",
451
451
  "domain": "memory",
452
452
  "sourcePath": "src/server/routes.ts",
453
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
453
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
454
454
  "since": "2025-01-01"
455
455
  },
456
456
  "route-group:semantic": {
@@ -458,7 +458,7 @@
458
458
  "type": "route-group",
459
459
  "domain": "memory",
460
460
  "sourcePath": "src/server/routes.ts",
461
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
461
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
462
462
  "since": "2025-01-01"
463
463
  },
464
464
  "route-group:status": {
@@ -466,7 +466,7 @@
466
466
  "type": "route-group",
467
467
  "domain": "monitoring",
468
468
  "sourcePath": "src/server/routes.ts",
469
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
469
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
470
470
  "since": "2025-01-01"
471
471
  },
472
472
  "route-group:capabilities": {
@@ -474,7 +474,7 @@
474
474
  "type": "route-group",
475
475
  "domain": "mapping",
476
476
  "sourcePath": "src/server/routes.ts",
477
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
477
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
478
478
  "since": "2025-01-01"
479
479
  },
480
480
  "route-group:project-map": {
@@ -482,7 +482,7 @@
482
482
  "type": "route-group",
483
483
  "domain": "mapping",
484
484
  "sourcePath": "src/server/routes.ts",
485
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
485
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
486
486
  "since": "2025-01-01"
487
487
  },
488
488
  "route-group:coherence": {
@@ -490,7 +490,7 @@
490
490
  "type": "route-group",
491
491
  "domain": "coherence",
492
492
  "sourcePath": "src/server/routes.ts",
493
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
493
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
494
494
  "since": "2025-01-01"
495
495
  },
496
496
  "route-group:topic-bindings": {
@@ -498,7 +498,7 @@
498
498
  "type": "route-group",
499
499
  "domain": "sessions",
500
500
  "sourcePath": "src/server/routes.ts",
501
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
501
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
502
502
  "since": "2025-01-01"
503
503
  },
504
504
  "route-group:context": {
@@ -506,7 +506,7 @@
506
506
  "type": "route-group",
507
507
  "domain": "context",
508
508
  "sourcePath": "src/server/routes.ts",
509
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
509
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
510
510
  "since": "2025-01-01"
511
511
  },
512
512
  "route-group:scope-coherence": {
@@ -514,7 +514,7 @@
514
514
  "type": "route-group",
515
515
  "domain": "coherence",
516
516
  "sourcePath": "src/server/routes.ts",
517
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
517
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
518
518
  "since": "2025-01-01"
519
519
  },
520
520
  "route-group:canonical-state": {
@@ -522,7 +522,7 @@
522
522
  "type": "route-group",
523
523
  "domain": "state",
524
524
  "sourcePath": "src/server/routes.ts",
525
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
525
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
526
526
  "since": "2025-01-01"
527
527
  },
528
528
  "route-group:ci": {
@@ -530,7 +530,7 @@
530
530
  "type": "route-group",
531
531
  "domain": "monitoring",
532
532
  "sourcePath": "src/server/routes.ts",
533
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
533
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
534
534
  "since": "2025-01-01"
535
535
  },
536
536
  "route-group:sessions": {
@@ -538,7 +538,7 @@
538
538
  "type": "route-group",
539
539
  "domain": "sessions",
540
540
  "sourcePath": "src/server/routes.ts",
541
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
541
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
542
542
  "since": "2025-01-01"
543
543
  },
544
544
  "route-group:jobs": {
@@ -546,7 +546,7 @@
546
546
  "type": "route-group",
547
547
  "domain": "scheduling",
548
548
  "sourcePath": "src/server/routes.ts",
549
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
549
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
550
550
  "since": "2025-01-01"
551
551
  },
552
552
  "route-group:skip-ledger": {
@@ -554,7 +554,7 @@
554
554
  "type": "route-group",
555
555
  "domain": "scheduling",
556
556
  "sourcePath": "src/server/routes.ts",
557
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
557
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
558
558
  "since": "2025-01-01"
559
559
  },
560
560
  "route-group:telegram": {
@@ -562,7 +562,7 @@
562
562
  "type": "route-group",
563
563
  "domain": "communication",
564
564
  "sourcePath": "src/server/routes.ts",
565
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
565
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
566
566
  "since": "2025-01-01"
567
567
  },
568
568
  "route-group:attention": {
@@ -570,7 +570,7 @@
570
570
  "type": "route-group",
571
571
  "domain": "communication",
572
572
  "sourcePath": "src/server/routes.ts",
573
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
573
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
574
574
  "since": "2025-01-01"
575
575
  },
576
576
  "route-group:relationships": {
@@ -578,7 +578,7 @@
578
578
  "type": "route-group",
579
579
  "domain": "relationships",
580
580
  "sourcePath": "src/server/routes.ts",
581
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
581
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
582
582
  "since": "2025-01-01"
583
583
  },
584
584
  "route-group:feedback": {
@@ -586,7 +586,7 @@
586
586
  "type": "route-group",
587
587
  "domain": "feedback",
588
588
  "sourcePath": "src/server/routes.ts",
589
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
589
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
590
590
  "since": "2025-01-01"
591
591
  },
592
592
  "route-group:updates": {
@@ -594,7 +594,7 @@
594
594
  "type": "route-group",
595
595
  "domain": "updates",
596
596
  "sourcePath": "src/server/routes.ts",
597
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
597
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
598
598
  "since": "2025-01-01"
599
599
  },
600
600
  "route-group:dispatches": {
@@ -602,7 +602,7 @@
602
602
  "type": "route-group",
603
603
  "domain": "dispatches",
604
604
  "sourcePath": "src/server/routes.ts",
605
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
605
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
606
606
  "since": "2025-01-01"
607
607
  },
608
608
  "route-group:quota": {
@@ -610,7 +610,7 @@
610
610
  "type": "route-group",
611
611
  "domain": "monitoring",
612
612
  "sourcePath": "src/server/routes.ts",
613
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
613
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
614
614
  "since": "2025-01-01"
615
615
  },
616
616
  "route-group:publishing": {
@@ -618,7 +618,7 @@
618
618
  "type": "route-group",
619
619
  "domain": "publishing",
620
620
  "sourcePath": "src/server/routes.ts",
621
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
621
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
622
622
  "since": "2025-01-01"
623
623
  },
624
624
  "route-group:private-views": {
@@ -626,7 +626,7 @@
626
626
  "type": "route-group",
627
627
  "domain": "publishing",
628
628
  "sourcePath": "src/server/routes.ts",
629
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
629
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
630
630
  "since": "2025-01-01"
631
631
  },
632
632
  "route-group:tunnel": {
@@ -634,7 +634,7 @@
634
634
  "type": "route-group",
635
635
  "domain": "networking",
636
636
  "sourcePath": "src/server/routes.ts",
637
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
637
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
638
638
  "since": "2025-01-01"
639
639
  },
640
640
  "route-group:events": {
@@ -642,7 +642,7 @@
642
642
  "type": "route-group",
643
643
  "domain": "networking",
644
644
  "sourcePath": "src/server/routes.ts",
645
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
645
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
646
646
  "since": "2025-01-01"
647
647
  },
648
648
  "route-group:evolution": {
@@ -650,7 +650,7 @@
650
650
  "type": "route-group",
651
651
  "domain": "evolution",
652
652
  "sourcePath": "src/server/routes.ts",
653
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
653
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
654
654
  "since": "2025-01-01"
655
655
  },
656
656
  "route-group:watchdog": {
@@ -658,7 +658,7 @@
658
658
  "type": "route-group",
659
659
  "domain": "monitoring",
660
660
  "sourcePath": "src/server/routes.ts",
661
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
661
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
662
662
  "since": "2025-01-01"
663
663
  },
664
664
  "route-group:topic-memory": {
@@ -666,7 +666,7 @@
666
666
  "type": "route-group",
667
667
  "domain": "memory",
668
668
  "sourcePath": "src/server/routes.ts",
669
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
669
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
670
670
  "since": "2025-01-01"
671
671
  },
672
672
  "route-group:state-sync": {
@@ -674,7 +674,7 @@
674
674
  "type": "route-group",
675
675
  "domain": "coordination",
676
676
  "sourcePath": "src/server/routes.ts",
677
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
677
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
678
678
  "since": "2025-01-01"
679
679
  },
680
680
  "route-group:intent": {
@@ -682,7 +682,7 @@
682
682
  "type": "route-group",
683
683
  "domain": "intent",
684
684
  "sourcePath": "src/server/routes.ts",
685
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
685
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
686
686
  "since": "2025-01-01"
687
687
  },
688
688
  "route-group:triage": {
@@ -690,7 +690,7 @@
690
690
  "type": "route-group",
691
691
  "domain": "safety",
692
692
  "sourcePath": "src/server/routes.ts",
693
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
693
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
694
694
  "since": "2025-01-01"
695
695
  },
696
696
  "route-group:operations": {
@@ -698,7 +698,7 @@
698
698
  "type": "route-group",
699
699
  "domain": "safety",
700
700
  "sourcePath": "src/server/routes.ts",
701
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
701
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
702
702
  "since": "2025-01-01"
703
703
  },
704
704
  "route-group:sentinel": {
@@ -706,7 +706,7 @@
706
706
  "type": "route-group",
707
707
  "domain": "safety",
708
708
  "sourcePath": "src/server/routes.ts",
709
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
709
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
710
710
  "since": "2025-01-01"
711
711
  },
712
712
  "route-group:trust": {
@@ -714,7 +714,7 @@
714
714
  "type": "route-group",
715
715
  "domain": "safety",
716
716
  "sourcePath": "src/server/routes.ts",
717
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
717
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
718
718
  "since": "2025-01-01"
719
719
  },
720
720
  "route-group:monitoring": {
@@ -722,7 +722,7 @@
722
722
  "type": "route-group",
723
723
  "domain": "monitoring",
724
724
  "sourcePath": "src/server/routes.ts",
725
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
725
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
726
726
  "since": "2025-01-01"
727
727
  },
728
728
  "route-group:commitments": {
@@ -730,7 +730,7 @@
730
730
  "type": "route-group",
731
731
  "domain": "commitments",
732
732
  "sourcePath": "src/server/routes.ts",
733
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
733
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
734
734
  "since": "2025-01-01"
735
735
  },
736
736
  "route-group:episodes": {
@@ -738,7 +738,7 @@
738
738
  "type": "route-group",
739
739
  "domain": "memory",
740
740
  "sourcePath": "src/server/routes.ts",
741
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
741
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
742
742
  "since": "2025-01-01"
743
743
  },
744
744
  "route-group:messages": {
@@ -746,7 +746,7 @@
746
746
  "type": "route-group",
747
747
  "domain": "coordination",
748
748
  "sourcePath": "src/server/routes.ts",
749
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
749
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
750
750
  "since": "2025-01-01"
751
751
  },
752
752
  "route-group:system-reviews": {
@@ -754,7 +754,7 @@
754
754
  "type": "route-group",
755
755
  "domain": "monitoring",
756
756
  "sourcePath": "src/server/routes.ts",
757
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
757
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
758
758
  "since": "2025-01-01"
759
759
  },
760
760
  "route-group:machine-mesh": {
@@ -770,7 +770,7 @@
770
770
  "type": "route-group",
771
771
  "domain": "security",
772
772
  "sourcePath": "src/server/routes.ts",
773
- "contentHash": "13d7a09d6e23886a37ddc267c77cad510edf9b1013cd6324312773d8c3429cd8",
773
+ "contentHash": "2cf5227213f33fee0e634e024dc90cef6b51880242b8101921af631a2b15bac3",
774
774
  "since": "2025-01-01"
775
775
  },
776
776
  "cli:init": {
@@ -1562,7 +1562,7 @@
1562
1562
  "type": "subsystem",
1563
1563
  "domain": "updates",
1564
1564
  "sourcePath": "src/core/PostUpdateMigrator.ts",
1565
- "contentHash": "ae15e23b7525213595701aaac82b83f9ca3f74f99b0b6ab498930096d16ace7a",
1565
+ "contentHash": "387d05da5a63b6ae1463c481820d94a613cde16bef85a0b72619949e4a151763",
1566
1566
  "since": "2025-01-01"
1567
1567
  },
1568
1568
  "subsystem:scheduler": {
@@ -14,7 +14,7 @@
14
14
  // existing-agent migration there) so the two can never drift. Imported as a runtime
15
15
  // function call inside generateClaudeMd — no module-init cycle (PostUpdateMigrator
16
16
  // never imports templates).
17
- import { PLAYWRIGHT_PROFILE_REGISTRY_CLAUDEMD_SECTION, MACHINE_LOAD_ASSESSMENT_CLAUDEMD_SECTION, DYNAMIC_MCP_CLAUDEMD_SECTION, SENDER_REJECTION_CLAUDEMD_SECTION, SCOPE_ACCRETION_CLAUDEMD_SECTION, MESH_SELF_HEALING_CLAUDEMD_SECTION, WRITE_ADMISSION_CLAUDEMD_SECTION } from '../core/PostUpdateMigrator.js';
17
+ import { PLAYWRIGHT_PROFILE_REGISTRY_CLAUDEMD_SECTION, MACHINE_LOAD_ASSESSMENT_CLAUDEMD_SECTION, DYNAMIC_MCP_CLAUDEMD_SECTION, SENDER_REJECTION_CLAUDEMD_SECTION, SCOPE_ACCRETION_CLAUDEMD_SECTION, MESH_SELF_HEALING_CLAUDEMD_SECTION, WRITE_ADMISSION_CLAUDEMD_SECTION, DOORWAY_REGISTRY_CLAUDEMD_SECTION } from '../core/PostUpdateMigrator.js';
18
18
 
19
19
  export interface AgentIdentity {
20
20
  name: string;
@@ -872,6 +872,7 @@ ${SENDER_REJECTION_CLAUDEMD_SECTION()}
872
872
  ${DYNAMIC_MCP_CLAUDEMD_SECTION(port)}
873
873
  ${MESH_SELF_HEALING_CLAUDEMD_SECTION(port)}
874
874
  ${WRITE_ADMISSION_CLAUDEMD_SECTION(port)}
875
+ ${DOORWAY_REGISTRY_CLAUDEMD_SECTION(port)}
875
876
  **Per-Feature LLM Metrics & LLM Activity (Observable Intelligence)** — Audit what each of your LLM-driven gates/sentinels actually does: WHICH provider + model ran it, how often it ACTED (fired) vs found nothing (noop), how often it was skipped to save rate limits (shed), cost, and latency. This is the *Observable Intelligence* standard — no autonomous AI action the system takes is allowed to be invisible. Read-only observability — it never gates anything.
876
877
  - Check: \`curl -H "Authorization: Bearer $AUTH" "http://localhost:${port}/metrics/features?sinceHours=24"\`
877
878
  - Returns \`{ totals, features: [{ feature, frameworks, models, byModel, calls, realCalls, tokensIn, tokensOut, tokensCached, fired, noop, shed, fireRate, p50LatencyMs, p95LatencyMs, ... }] }\` — one row per system (e.g. MessagingToneGate, MessageSentinel). \`frameworks\`/\`models\` = which provider(s) actually served the call; \`fireRate\` = how often it acts; \`shed\` = skipped by the rate-limit guard. Filter with \`?feature=<name>\`.
@@ -0,0 +1,34 @@
1
+ # Upgrade Guide — vNEXT
2
+
3
+ <!-- assembled-by: assemble-next-md -->
4
+ <!-- bump: patch -->
5
+
6
+ ## What Changed
7
+
8
+ Doorway/Model Knowledge Registry — rollout increment 3 (the `GET /doorways` read surface + CLAUDE.md awareness + the `maintenance.doorwayScan` config knob, per `docs/specs/DOORWAY-MODEL-KNOWLEDGE-REGISTRY-SPEC.md` §Rollout step 3). Increments 1 (enriched manifest + lint) and 2 (deterministic prober + scan-state + dark job + §2.7 guard) are already merged. **The scan job stays DARK** — this increment adds a READ route + awareness only; nothing probes, spends, or changes routing.
9
+
10
+ - **`GET /doorways`** (`src/core/DoorwayRegistryReader.ts` + `src/server/routes.ts`, spec §D5) — a read-only, Bearer-authed, always-mounted route returning the merged doorway→model map: the git-tracked canonical `topModels` (authoritative for routing, with pricing) overlaid with THIS machine's read-validated live reachability, keyed by `doorId`. It honors the **D5 two-state contract**: `200` with `scanState:"never-run"` when the registry is present but no scan has run yet (each door honestly `reachable:null`/`probeStatus:"never-scanned"`), `200` merged once a scan has run, and `503` with a stable `code` when the registry is genuinely unavailable — `registry-unavailable-no-instar-source` (a pure end-user install carries no manifest) or `registry-corrupt` (present but unparseable). It never fabricates an empty map. The machine-local scan-state is UNTRUSTED and re-validated field-by-field on read (door id charset + known-candidate cross-check, `probeStatus` fixed enum, ISO timestamps; `reachable` DERIVED from the clamped `probeStatus`, never the stored boolean), so a poisoned local file is contained.
11
+ - **CLAUDE.md awareness block** (`generateClaudeMd()` for new agents + a content-sniffed `migrateClaudeMd()` block for existing agents, via the shared `DOORWAY_REGISTRY_CLAUDEMD_SECTION()`, spec §Agent Awareness + §Migration Parity) — a pointer (not an inlined door/model table): what the registry is, the `GET /doorways` read, the OFF-by-default scan job + how to enable it, and the proactive trigger ("what models can I reach? / is my model map current?" → read `GET /doorways`, don't guess). `/doorways` is also registered in `CAPABILITY_INDEX` so it surfaces in `/capabilities`.
12
+ - **`maintenance.doorwayScan` config knob** (`migrateConfig()` via `ConfigDefaults.SHARED_DEFAULTS`, seeded on both init AND update, spec §D6 + §Migration Parity) — the D6 fail-closed defaults `scope:"free-probes"`, `cadence:"0 4 * * 1"` (weekly), `digestTopicId:null`, `budgetCapUsd:0`. It seeds **every field EXCEPT `enabled`** (which stays absent): a seeded `false` would trip the D6 deny-wins predicate (`config.enabled !== false`) and permanently block the scan even after the job manifest is enabled — the round-2/round-5 bug the spec calls out. Whether the scan RUNS is governed by the (dark) job manifest; `maintenance.doorwayScan.enabled:false` is a master kill-switch.
13
+
14
+ Increment 5 (reconcile `flaggedStale` → flip the freshness lint to `strict` → ratify the "Keep the Doorway/Model Map Current" standard) is companion-gated + operator-gated and is NOT in this increment.
15
+
16
+ ## What to Tell Your User
17
+
18
+ You can now ask me "what models can I reach right now?" or "is my model map current?" and I'll read a real, live answer instead of guessing — a map from each of your doorways (Claude Code, Codex, Gemini, a paid API key, …) to the top models each one reaches. Before the (still-off-by-default) weekly scan ever runs, that map is honest: it shows the reviewed model list and says "not scanned yet" for live reachability, rather than pretending to be empty. Nothing here turns on any probing or spends any money — the scan that keeps the map fresh remains switched off until you deliberately enable it later.
19
+
20
+ ## Summary of New Capabilities
21
+
22
+ - **`GET /doorways`** — a read-only "what models can I reach?" map: canonical top-models per doorway (with pricing) overlaid with this machine's live reachability. Honest two-state contract (200 never-run / 200 merged / 503 with a precise `code` when there's no registry to serve), never a fabricated empty payload, with the untrusted machine-local scan-state re-validated on every read.
23
+ - **Agent awareness** of the doorway registry — every agent (new via init, existing via update) now knows the registry + `GET /doorways` + the dark scan job exist, and the proactive trigger to read it.
24
+ - **A `maintenance.doorwayScan` config knob** with fail-closed defaults (free-probes, weekly, `budgetCapUsd:0`) seeded on init and update — every field except `enabled`, so the scan can never be permanently blocked by a seeded `false`.
25
+
26
+ ## Evidence
27
+
28
+ - `tests/unit/doorway-registry-reader.test.ts` (10) — the D5 two-state contract at the reader layer (never-run / scanned / no-manifest / corrupt), the merged view, `reachable` derived from the clamped `probeStatus` (P20 tri-state: ok→true, timeout→null, not-installed/http-4xx→false, malformed→true), the EXHAUSTIVE §1.3 read-clamp (out-of-enum probeStatus coerced, injection/metachar door-ids dropped, unknown door dropped, bad timestamp → null, machineId control-chars stripped), corrupt-scan-state → degrades to never-run (never crashes), and a MIRROR-PIN asserting the TS clamp constants (`PROBE_STATUS_ENUM`, `probeStatusToReachable`) match the prober's exported source of truth so they can't drift.
29
+ - `tests/unit/doorway-config-migration.test.ts` (6) — `getInitDefaults`/`getMigrationDefaults` seed every field EXCEPT `enabled`; `applyDefaults` seeds `0`/`null` correctly, never clobbers an operator override, never adds an `enabled` the operator omitted, preserves an operator's explicit `enabled:false`, and is idempotent; a full `PostUpdateMigrator.migrate()` seeds `maintenance.doorwayScan` on an existing agent with `enabled` absent.
30
+ - `tests/unit/doorway-claudemd-migration.test.ts` (4) — `generateClaudeMd` includes the awareness section + the `GET /doorways` read; the section function honors the injected port (never hardcoded); `migrateClaudeMd` appends the section once, is a no-op on a second run (content-sniffed idempotency), and does not re-append when already present.
31
+ - `tests/integration/doorway-routes.test.ts` (4) — `GET /doorways` through the real `createRoutes` HTTP pipeline: never-run → 200 `scanState:"never-run"` + canonical topModels (asserted NOT 503); scan-state present → 200 merged; no manifest → 503 `registry-unavailable-no-instar-source`; corrupt manifest → 503 `registry-corrupt`.
32
+ - `tests/e2e/doorway-registry-alive.test.ts` (4) — the "feature is alive" test on the REAL `AgentServer` init path: a source-carrying agent returns **200-not-503 with `scanState:"never-run"` before any scan** and 200 merged after; a non-instar-source agent returns 503 `registry-unavailable-no-instar-source`; the route requires Bearer auth (401 without a token).
33
+ - Ratchets satisfied: `capabilities-discoverability` (145) — `/doorways` classified in `CAPABILITY_INDEX`; `feature-delivery-completeness` (115) — the CLAUDE.md section tracked in `legacyMigratorSections`; `CapabilityIndex` (10), `ConfigDefaults` (36), `scaffold-templates` (26) all green. `npx tsc --noEmit` clean; the full `npm run lint` chain PASS (incl. `lint-model-registry-freshness` report-mode PASS, `lint-dev-agent-dark-gate` PASS); `npm run build` OK.
34
+ - Deferred items (spec §Deferred DF1-DF6, incl. the pool-scope `/doorways` merge) remain tracked in `docs/specs/reports/DOORWAY-MODEL-KNOWLEDGE-REGISTRY-followups.md`.