instar 1.3.895 → 1.3.897
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/dashboard/index.html +30 -0
- package/dist/commands/server.d.ts.map +1 -1
- package/dist/commands/server.js +111 -1
- package/dist/commands/server.js.map +1 -1
- package/dist/config/ConfigDefaults.d.ts.map +1 -1
- package/dist/config/ConfigDefaults.js +12 -0
- package/dist/config/ConfigDefaults.js.map +1 -1
- package/dist/core/CoherenceJournal.d.ts +17 -1
- package/dist/core/CoherenceJournal.d.ts.map +1 -1
- package/dist/core/CoherenceJournal.js +29 -2
- package/dist/core/CoherenceJournal.js.map +1 -1
- package/dist/core/FailureEpisodeLatch.d.ts +8 -0
- package/dist/core/FailureEpisodeLatch.d.ts.map +1 -1
- package/dist/core/FailureEpisodeLatch.js +14 -0
- package/dist/core/FailureEpisodeLatch.js.map +1 -1
- package/dist/core/JournalSyncApplier.d.ts.map +1 -1
- package/dist/core/JournalSyncApplier.js +11 -0
- package/dist/core/JournalSyncApplier.js.map +1 -1
- package/dist/core/MachineSshEndpoint.d.ts +47 -0
- package/dist/core/MachineSshEndpoint.d.ts.map +1 -0
- package/dist/core/MachineSshEndpoint.js +221 -0
- package/dist/core/MachineSshEndpoint.js.map +1 -0
- package/dist/core/MachineSshIdentity.d.ts +26 -0
- package/dist/core/MachineSshIdentity.d.ts.map +1 -0
- package/dist/core/MachineSshIdentity.js +97 -0
- package/dist/core/MachineSshIdentity.js.map +1 -0
- package/dist/core/MeshRpc.d.ts +6 -0
- package/dist/core/MeshRpc.d.ts.map +1 -1
- package/dist/core/MeshRpc.js +2 -0
- package/dist/core/MeshRpc.js.map +1 -1
- package/dist/core/MutualSshHealthController.d.ts +33 -0
- package/dist/core/MutualSshHealthController.d.ts.map +1 -0
- package/dist/core/MutualSshHealthController.js +113 -0
- package/dist/core/MutualSshHealthController.js.map +1 -0
- package/dist/core/MutualSshProbeScheduler.d.ts +21 -0
- package/dist/core/MutualSshProbeScheduler.d.ts.map +1 -0
- package/dist/core/MutualSshProbeScheduler.js +57 -0
- package/dist/core/MutualSshProbeScheduler.js.map +1 -0
- package/dist/core/MutualSshRuntime.d.ts +106 -0
- package/dist/core/MutualSshRuntime.d.ts.map +1 -0
- package/dist/core/MutualSshRuntime.js +423 -0
- package/dist/core/MutualSshRuntime.js.map +1 -0
- package/dist/core/MutualSshVerifier.d.ts +44 -0
- package/dist/core/MutualSshVerifier.d.ts.map +1 -0
- package/dist/core/MutualSshVerifier.js +97 -0
- package/dist/core/MutualSshVerifier.js.map +1 -0
- package/dist/core/SelfHealGate.d.ts +148 -0
- package/dist/core/SelfHealGate.d.ts.map +1 -0
- package/dist/core/SelfHealGate.js +391 -0
- package/dist/core/SelfHealGate.js.map +1 -0
- package/dist/core/SshBootstrapAdvert.d.ts +23 -0
- package/dist/core/SshBootstrapAdvert.d.ts.map +1 -0
- package/dist/core/SshBootstrapAdvert.js +43 -0
- package/dist/core/SshBootstrapAdvert.js.map +1 -0
- package/dist/core/SshHostKeyLifecycle.d.ts +43 -0
- package/dist/core/SshHostKeyLifecycle.d.ts.map +1 -0
- package/dist/core/SshHostKeyLifecycle.js +68 -0
- package/dist/core/SshHostKeyLifecycle.js.map +1 -0
- package/dist/core/SshPeerAdmissionStore.d.ts +29 -0
- package/dist/core/SshPeerAdmissionStore.d.ts.map +1 -0
- package/dist/core/SshPeerAdmissionStore.js +86 -0
- package/dist/core/SshPeerAdmissionStore.js.map +1 -0
- package/dist/core/devGatedFeatures.d.ts.map +1 -1
- package/dist/core/devGatedFeatures.js +6 -0
- package/dist/core/devGatedFeatures.js.map +1 -1
- package/dist/core/machineCoherenceManifest.d.ts.map +1 -1
- package/dist/core/machineCoherenceManifest.js +8 -0
- package/dist/core/machineCoherenceManifest.js.map +1 -1
- package/dist/core/types.d.ts +10 -0
- package/dist/core/types.d.ts.map +1 -1
- package/dist/core/types.js.map +1 -1
- package/dist/feedback-factory/drain/FeedbackFactoryDefaultsSelfHeal.d.ts +19 -0
- package/dist/feedback-factory/drain/FeedbackFactoryDefaultsSelfHeal.d.ts.map +1 -0
- package/dist/feedback-factory/drain/FeedbackFactoryDefaultsSelfHeal.js +118 -0
- package/dist/feedback-factory/drain/FeedbackFactoryDefaultsSelfHeal.js.map +1 -0
- package/dist/feedback-factory/drain/FeedbackFactoryGeneratedDefaults.d.ts +11 -1
- package/dist/feedback-factory/drain/FeedbackFactoryGeneratedDefaults.d.ts.map +1 -1
- package/dist/feedback-factory/drain/FeedbackFactoryGeneratedDefaults.js +88 -25
- package/dist/feedback-factory/drain/FeedbackFactoryGeneratedDefaults.js.map +1 -1
- package/dist/monitoring/selfaction/policies.d.ts.map +1 -1
- package/dist/monitoring/selfaction/policies.js +14 -0
- package/dist/monitoring/selfaction/policies.js.map +1 -1
- package/dist/server/AgentServer.d.ts +1 -0
- package/dist/server/AgentServer.d.ts.map +1 -1
- package/dist/server/AgentServer.js +46 -6
- package/dist/server/AgentServer.js.map +1 -1
- package/dist/server/CapabilityIndex.js +2 -2
- package/dist/server/CapabilityIndex.js.map +1 -1
- package/dist/server/routes.d.ts +2 -0
- package/dist/server/routes.d.ts.map +1 -1
- package/dist/server/routes.js +9 -0
- package/dist/server/routes.js.map +1 -1
- package/dist/testing/selfActionRegistry.d.ts.map +1 -1
- package/dist/testing/selfActionRegistry.js +64 -0
- package/dist/testing/selfActionRegistry.js.map +1 -1
- package/package.json +3 -1
- package/src/data/builtin-manifest.json +47 -47
- package/src/data/state-coherence-registry.json +53 -0
- package/upgrades/1.3.896.md +25 -0
- package/upgrades/1.3.897.md +39 -0
- package/upgrades/side-effects/mutual-ssh-autobootstrap.md +137 -0
- package/upgrades/side-effects/self-heal-gate.md +87 -0
|
@@ -0,0 +1,391 @@
|
|
|
1
|
+
import crypto from 'node:crypto';
|
|
2
|
+
import fs from 'node:fs';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import Database from 'better-sqlite3';
|
|
5
|
+
import { FailureEpisodeLatch } from './FailureEpisodeLatch.js';
|
|
6
|
+
import { registerSqliteHandle } from './SqliteRegistry.js';
|
|
7
|
+
function cloneRecord(record) { return structuredClone(record); }
|
|
8
|
+
function validateRecord(value) {
|
|
9
|
+
if (!value || typeof value !== 'object')
|
|
10
|
+
throw new Error('invalid self-heal episode');
|
|
11
|
+
const r = value;
|
|
12
|
+
if (r.schemaVersion !== 1 || typeof r.key !== 'string' || r.key.length < 1 || r.key.length > 240)
|
|
13
|
+
throw new Error('invalid self-heal episode');
|
|
14
|
+
for (const n of [r.revision, r.startedAt, r.attempts, r.nextEligibleAt, r.updatedAt])
|
|
15
|
+
if (!Number.isFinite(n) || n < 0)
|
|
16
|
+
throw new Error('invalid self-heal episode');
|
|
17
|
+
if (!Number.isInteger(r.revision) || !Number.isInteger(r.attempts) || !['active', 'recovered', 'exhausted'].includes(r.status))
|
|
18
|
+
throw new Error('invalid self-heal episode');
|
|
19
|
+
if (!Array.isArray(r.recoveries) || r.recoveries.length > 64 || r.recoveries.some((n) => !Number.isFinite(n) || n < 0))
|
|
20
|
+
throw new Error('invalid self-heal episode');
|
|
21
|
+
const latch = new FailureEpisodeLatch({ signalAfterMs: 1 });
|
|
22
|
+
latch.restore(r.latch);
|
|
23
|
+
return r;
|
|
24
|
+
}
|
|
25
|
+
export class InMemorySelfHealEpisodeStore {
|
|
26
|
+
rows = new Map();
|
|
27
|
+
audits = [];
|
|
28
|
+
load(key) { const row = this.rows.get(key); return row ? cloneRecord(row) : null; }
|
|
29
|
+
create(record) { if (this.rows.has(record.key))
|
|
30
|
+
return null; const row = validateRecord(cloneRecord(record)); this.rows.set(row.key, row); return cloneRecord(row); }
|
|
31
|
+
mutate(key, expectedRevision, update, guard) {
|
|
32
|
+
const current = this.rows.get(key);
|
|
33
|
+
if (!current || current.revision !== expectedRevision)
|
|
34
|
+
return null;
|
|
35
|
+
if (guard && !guard())
|
|
36
|
+
return null;
|
|
37
|
+
const next = validateRecord(update(cloneRecord(current)));
|
|
38
|
+
if (next.key !== key || next.revision !== expectedRevision + 1)
|
|
39
|
+
throw new Error('self-heal mutation must increment revision once');
|
|
40
|
+
if (current.status === 'exhausted' && next.status !== 'exhausted')
|
|
41
|
+
throw new Error('self-heal exhausted state is monotonic');
|
|
42
|
+
this.rows.set(key, cloneRecord(next));
|
|
43
|
+
return cloneRecord(next);
|
|
44
|
+
}
|
|
45
|
+
appendAudit(event) { this.audits.push(structuredClone(event)); }
|
|
46
|
+
}
|
|
47
|
+
export class SqliteSelfHealEpisodeStore {
|
|
48
|
+
db;
|
|
49
|
+
unregisterSqlite;
|
|
50
|
+
constructor(dbPath) {
|
|
51
|
+
const parent = path.dirname(dbPath);
|
|
52
|
+
fs.mkdirSync(parent, { recursive: true, mode: 0o700 });
|
|
53
|
+
const ps = fs.lstatSync(parent);
|
|
54
|
+
if (!ps.isDirectory() || ps.isSymbolicLink())
|
|
55
|
+
throw new Error('unsafe self-heal store parent');
|
|
56
|
+
if (fs.existsSync(dbPath)) {
|
|
57
|
+
const st = fs.lstatSync(dbPath);
|
|
58
|
+
if (!st.isFile() || st.isSymbolicLink())
|
|
59
|
+
throw new Error('unsafe self-heal store file');
|
|
60
|
+
}
|
|
61
|
+
this.db = new Database(dbPath, { timeout: 100 });
|
|
62
|
+
this.db.pragma('journal_mode = WAL');
|
|
63
|
+
this.db.pragma('busy_timeout = 100');
|
|
64
|
+
this.db.exec('CREATE TABLE IF NOT EXISTS self_heal_episodes (episode_key TEXT PRIMARY KEY, revision INTEGER NOT NULL, payload TEXT NOT NULL, updated_at INTEGER NOT NULL); CREATE TABLE IF NOT EXISTS self_heal_audit (id INTEGER PRIMARY KEY, at_ms INTEGER NOT NULL, controller_id TEXT NOT NULL, event TEXT NOT NULL, reason TEXT, attempt INTEGER, elapsed_ms INTEGER);');
|
|
65
|
+
try {
|
|
66
|
+
fs.chmodSync(dbPath, 0o600);
|
|
67
|
+
}
|
|
68
|
+
catch { /* non-posix */ }
|
|
69
|
+
this.unregisterSqlite = registerSqliteHandle(() => { try {
|
|
70
|
+
this.db.close();
|
|
71
|
+
}
|
|
72
|
+
catch { /* already closed */ } });
|
|
73
|
+
}
|
|
74
|
+
load(key) { const row = this.db.prepare('SELECT payload FROM self_heal_episodes WHERE episode_key=?').get(key); return row ? validateRecord(JSON.parse(row.payload)) : null; }
|
|
75
|
+
create(record) {
|
|
76
|
+
const row = validateRecord(cloneRecord(record));
|
|
77
|
+
const tx = this.db.transaction(() => {
|
|
78
|
+
const count = this.db.prepare('SELECT COUNT(*) AS n FROM self_heal_episodes').get().n;
|
|
79
|
+
if (count >= 256)
|
|
80
|
+
return false;
|
|
81
|
+
return this.db.prepare('INSERT OR IGNORE INTO self_heal_episodes(episode_key,revision,payload,updated_at) VALUES(?,?,?,?)').run(row.key, row.revision, JSON.stringify(row), row.updatedAt).changes === 1;
|
|
82
|
+
});
|
|
83
|
+
try {
|
|
84
|
+
return tx() ? cloneRecord(row) : null;
|
|
85
|
+
}
|
|
86
|
+
catch (error) {
|
|
87
|
+
if (/busy|locked/i.test(String(error)))
|
|
88
|
+
return null;
|
|
89
|
+
throw error;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
mutate(key, expectedRevision, update, guard) {
|
|
93
|
+
const tx = this.db.transaction(() => {
|
|
94
|
+
const current = this.load(key);
|
|
95
|
+
if (!current || current.revision !== expectedRevision)
|
|
96
|
+
return null;
|
|
97
|
+
if (guard && !guard())
|
|
98
|
+
return null;
|
|
99
|
+
const next = validateRecord(update(cloneRecord(current)));
|
|
100
|
+
if (next.key !== key || next.revision !== expectedRevision + 1)
|
|
101
|
+
throw new Error('self-heal mutation must increment revision once');
|
|
102
|
+
if (current.status === 'exhausted' && next.status !== 'exhausted')
|
|
103
|
+
throw new Error('self-heal exhausted state is monotonic');
|
|
104
|
+
const changed = this.db.prepare('UPDATE self_heal_episodes SET revision=?,payload=?,updated_at=? WHERE episode_key=? AND revision=?').run(next.revision, JSON.stringify(next), next.updatedAt, key, expectedRevision).changes;
|
|
105
|
+
return changed === 1 ? next : null;
|
|
106
|
+
});
|
|
107
|
+
try {
|
|
108
|
+
const row = tx();
|
|
109
|
+
return row ? cloneRecord(row) : null;
|
|
110
|
+
}
|
|
111
|
+
catch (error) {
|
|
112
|
+
if (/busy|locked/i.test(String(error)))
|
|
113
|
+
return null;
|
|
114
|
+
throw error;
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
appendAudit(event) { this.db.prepare('INSERT OR REPLACE INTO self_heal_audit(id,at_ms,controller_id,event,reason,attempt,elapsed_ms) VALUES(?,?,?,?,?,?,?)').run(event.at % 1024, event.at, event.controllerId, event.event, event.reason ?? null, event.attempt ?? null, event.elapsedMs ?? null); }
|
|
118
|
+
close() { this.unregisterSqlite(); this.db.close(); }
|
|
119
|
+
}
|
|
120
|
+
export class SelfHealGate {
|
|
121
|
+
spec;
|
|
122
|
+
deps;
|
|
123
|
+
now;
|
|
124
|
+
store;
|
|
125
|
+
bootId;
|
|
126
|
+
stateFailureNotices = new Set();
|
|
127
|
+
constructor(spec, deps) {
|
|
128
|
+
this.spec = spec;
|
|
129
|
+
this.deps = deps;
|
|
130
|
+
if (spec.controllerResource !== 'hardware-bound')
|
|
131
|
+
throw new Error('v1 SelfHealGate refuses pool-shared controllers');
|
|
132
|
+
if (!Number.isInteger(spec.maxAttempts) || spec.maxAttempts < 1 || spec.maxAttempts > 32)
|
|
133
|
+
throw new Error('invalid maxAttempts');
|
|
134
|
+
for (const value of [spec.maxWallClockMs, spec.notificationLatencyCeilingMs, spec.flap.maxRecoveries, spec.flap.windowMs])
|
|
135
|
+
if (!Number.isFinite(value) || value <= 0)
|
|
136
|
+
throw new Error('invalid SelfHealGate bound');
|
|
137
|
+
this.now = deps.now ?? Date.now;
|
|
138
|
+
this.store = deps.episodeStore ?? new InMemorySelfHealEpisodeStore();
|
|
139
|
+
this.bootId = deps.bootId ?? crypto.randomUUID();
|
|
140
|
+
}
|
|
141
|
+
needsRestartVerification(ctx) { return this.store.load(this.key(ctx))?.restart !== null; }
|
|
142
|
+
async attempt(ctx) { const began = this.now(); try {
|
|
143
|
+
return await this.attemptInner(ctx);
|
|
144
|
+
}
|
|
145
|
+
catch {
|
|
146
|
+
return this.stateFailureWithNotice('store-operation-failed');
|
|
147
|
+
}
|
|
148
|
+
finally {
|
|
149
|
+
this.audit({ event: 'attempt-finished', elapsedMs: Math.max(0, this.now() - began) });
|
|
150
|
+
} }
|
|
151
|
+
recordHealthy(ctx) {
|
|
152
|
+
const current = this.store.load(this.key(ctx));
|
|
153
|
+
if (!current)
|
|
154
|
+
return { outcome: 'healed', reason: 'already-healthy' };
|
|
155
|
+
if (current.status === 'exhausted')
|
|
156
|
+
return { outcome: 'exhausted', reason: 'terminal' };
|
|
157
|
+
if (current.restart)
|
|
158
|
+
return { outcome: 'governed', reason: 'restart-verification-required' };
|
|
159
|
+
const next = this.cas(current, (row) => ({ ...row, status: 'recovered', recoveries: [...row.recoveries, this.now()].slice(-64), restart: null }));
|
|
160
|
+
return next ? { outcome: 'healed', reason: 'recorded-healthy' } : { outcome: 'busy', reason: 'revision-conflict' };
|
|
161
|
+
}
|
|
162
|
+
async attemptInner(ctx) {
|
|
163
|
+
const key = this.key(ctx);
|
|
164
|
+
let row = this.store.load(key);
|
|
165
|
+
if (!row) {
|
|
166
|
+
const fresh = this.newEpisode(key);
|
|
167
|
+
row = this.store.create(fresh) ?? this.store.load(key);
|
|
168
|
+
}
|
|
169
|
+
if (!row)
|
|
170
|
+
return this.stateFailureWithNotice('create-failed');
|
|
171
|
+
if (row.status === 'active') {
|
|
172
|
+
const now = this.now();
|
|
173
|
+
const recent = row.recoveries.filter((at) => now - at <= this.spec.flap.windowMs);
|
|
174
|
+
if (now - row.startedAt >= this.spec.maxWallClockMs)
|
|
175
|
+
return this.exhaust(row, 'wall-clock');
|
|
176
|
+
if (recent.length >= this.spec.flap.maxRecoveries)
|
|
177
|
+
return this.exhaust(row, 'flap');
|
|
178
|
+
if (row.attempts >= this.spec.maxAttempts && !row.restart)
|
|
179
|
+
return this.exhaust(row, 'max-attempts');
|
|
180
|
+
}
|
|
181
|
+
if (row.restart) {
|
|
182
|
+
if (row.restart.state === 'required')
|
|
183
|
+
return this.requestPendingRestart(row);
|
|
184
|
+
if (row.restart.requestingBootId === this.bootId)
|
|
185
|
+
return { outcome: 'attempted', reason: 'restart-awaiting-new-boot' };
|
|
186
|
+
let verified = false;
|
|
187
|
+
try {
|
|
188
|
+
verified = this.spec.restartVerified?.(ctx) === true;
|
|
189
|
+
}
|
|
190
|
+
catch {
|
|
191
|
+
verified = false;
|
|
192
|
+
}
|
|
193
|
+
if (!verified) {
|
|
194
|
+
let severity;
|
|
195
|
+
try {
|
|
196
|
+
severity = this.spec.severity(ctx);
|
|
197
|
+
}
|
|
198
|
+
catch {
|
|
199
|
+
severity = 'unknown';
|
|
200
|
+
}
|
|
201
|
+
if (severity === 'unknown')
|
|
202
|
+
return this.noticeAndReturn(row, 'unknown-severity', 'invalid-severity');
|
|
203
|
+
return { outcome: 'attempted', reason: 'restart-verification-not-healthy' };
|
|
204
|
+
}
|
|
205
|
+
const closed = this.cas(row, (r) => ({ ...r, status: 'recovered', restart: null, recoveries: [...r.recoveries, this.now()].slice(-64) }));
|
|
206
|
+
return closed ? { outcome: 'healed', reason: 'restart-verified' } : { outcome: 'busy', reason: 'revision-conflict' };
|
|
207
|
+
}
|
|
208
|
+
let severity;
|
|
209
|
+
try {
|
|
210
|
+
severity = this.spec.severity(ctx);
|
|
211
|
+
}
|
|
212
|
+
catch {
|
|
213
|
+
severity = 'unknown';
|
|
214
|
+
}
|
|
215
|
+
if (!['recoverable', 'irreversible', 'data-loss', 'security'].includes(severity))
|
|
216
|
+
return this.noticeAndReturn(row, 'unknown-severity', 'invalid-severity');
|
|
217
|
+
if (severity !== 'recoverable') {
|
|
218
|
+
const notice = await this.ensureNotice(row, severity);
|
|
219
|
+
row = notice.row;
|
|
220
|
+
}
|
|
221
|
+
if (row.status === 'recovered') {
|
|
222
|
+
const now = this.now();
|
|
223
|
+
const reset = this.cas(row, (r) => ({ ...r, status: 'active', startedAt: now, attempts: 0, nextEligibleAt: 0, latch: emptyLatch(), notices: {}, restart: null }));
|
|
224
|
+
if (!reset)
|
|
225
|
+
return { outcome: 'busy', reason: 'revision-conflict' };
|
|
226
|
+
row = reset;
|
|
227
|
+
}
|
|
228
|
+
if (row.status === 'exhausted')
|
|
229
|
+
return { outcome: 'exhausted', reason: 'terminal' };
|
|
230
|
+
const latch = new FailureEpisodeLatch({ signalAfterMs: this.spec.notificationLatencyCeilingMs, now: this.now });
|
|
231
|
+
latch.restore(row.latch);
|
|
232
|
+
const failure = latch.recordFailure();
|
|
233
|
+
const detected = this.cas(row, (r) => ({ ...r, latch: latch.snapshot() }));
|
|
234
|
+
if (!detected)
|
|
235
|
+
return { outcome: 'busy', reason: 'revision-conflict' };
|
|
236
|
+
row = detected;
|
|
237
|
+
if (failure.shouldSignal) {
|
|
238
|
+
const notice = await this.ensureNotice(row, 'latency');
|
|
239
|
+
row = notice.row;
|
|
240
|
+
}
|
|
241
|
+
const now = this.now();
|
|
242
|
+
const recent = row.recoveries.filter((at) => now - at <= this.spec.flap.windowMs);
|
|
243
|
+
if (now - row.startedAt >= this.spec.maxWallClockMs)
|
|
244
|
+
return this.exhaust(row, 'wall-clock');
|
|
245
|
+
if (recent.length >= this.spec.flap.maxRecoveries)
|
|
246
|
+
return this.exhaust(row, 'flap');
|
|
247
|
+
if (row.attempts >= this.spec.maxAttempts)
|
|
248
|
+
return this.exhaust(row, 'max-attempts');
|
|
249
|
+
if (row.nextEligibleAt > now)
|
|
250
|
+
return { outcome: 'backoff', reason: 'not-eligible-yet' };
|
|
251
|
+
const eligibility = safeEligible(this.spec, ctx);
|
|
252
|
+
if (!eligibility.eligible || !eligibility.fence)
|
|
253
|
+
return { outcome: 'governed', reason: 'fence-stale' };
|
|
254
|
+
const target = { key: keyHash(key), classId: this.spec.classId, keyIsVolatile: false };
|
|
255
|
+
const admission = await this.deps.admit(target, { incarnation: eligibility.fence, eligible: () => safeEligible(this.spec, ctx).fence === eligibility.fence, onAdmitted: (token) => { void this.runAdmitted(ctx, target, token).catch(() => { void this.stateFailureWithNotice('queued-attempt-failed'); }); }, lane: 'job', nowMs: now });
|
|
256
|
+
if (admission.outcome !== 'allow')
|
|
257
|
+
return { outcome: 'governed', reason: admission.outcome };
|
|
258
|
+
return this.runAdmitted(ctx, target, admission.token);
|
|
259
|
+
}
|
|
260
|
+
async runAdmitted(ctx, target, token) {
|
|
261
|
+
let row = this.store.load(this.key(ctx));
|
|
262
|
+
if (!row || row.status !== 'active')
|
|
263
|
+
return { outcome: 'governed', reason: 'episode-not-active' };
|
|
264
|
+
const latch = new FailureEpisodeLatch({ signalAfterMs: this.spec.notificationLatencyCeilingMs, now: this.now });
|
|
265
|
+
latch.restore(row.latch);
|
|
266
|
+
const failure = latch.recordFailure();
|
|
267
|
+
const observed = this.cas(row, (r) => ({ ...r, latch: latch.snapshot() }));
|
|
268
|
+
if (!observed)
|
|
269
|
+
return { outcome: 'busy', reason: 'revision-conflict' };
|
|
270
|
+
row = observed;
|
|
271
|
+
if (failure.shouldSignal) {
|
|
272
|
+
const notice = await this.ensureNotice(row, 'latency');
|
|
273
|
+
row = notice.row;
|
|
274
|
+
}
|
|
275
|
+
const now = this.now();
|
|
276
|
+
const recent = row.recoveries.filter((at) => now - at <= this.spec.flap.windowMs);
|
|
277
|
+
if (now - row.startedAt >= this.spec.maxWallClockMs)
|
|
278
|
+
return this.exhaust(row, 'wall-clock');
|
|
279
|
+
if (recent.length >= this.spec.flap.maxRecoveries)
|
|
280
|
+
return this.exhaust(row, 'flap');
|
|
281
|
+
if (row.nextEligibleAt > now)
|
|
282
|
+
return { outcome: 'backoff', reason: 'not-eligible-yet' };
|
|
283
|
+
const eligibility = safeEligible(this.spec, ctx);
|
|
284
|
+
if (!eligibility.eligible || !eligibility.fence)
|
|
285
|
+
return { outcome: 'governed', reason: 'fence-stale' };
|
|
286
|
+
const consumed = this.deps.consumeToken(token, this.spec.id, { targetKey: target.key, nowMs: this.now() });
|
|
287
|
+
if (!consumed.proceed)
|
|
288
|
+
return { outcome: 'governed', reason: consumed.reason ?? 'token-refused', tokenValid: consumed.valid };
|
|
289
|
+
const again = safeEligible(this.spec, ctx);
|
|
290
|
+
if (!again.eligible || again.fence !== eligibility.fence)
|
|
291
|
+
return { outcome: 'governed', reason: 'fence-stale', tokenValid: consumed.valid };
|
|
292
|
+
if (row.attempts >= this.spec.maxAttempts)
|
|
293
|
+
return this.exhaust(row, 'max-attempts');
|
|
294
|
+
const claim = this.cas(row, (r) => ({ ...r, attempts: r.attempts + 1 }), () => {
|
|
295
|
+
const live = safeEligible(this.spec, ctx);
|
|
296
|
+
return live.eligible && live.fence === eligibility.fence;
|
|
297
|
+
});
|
|
298
|
+
if (!claim)
|
|
299
|
+
return { outcome: 'governed', reason: 'fence-stale-or-revision-conflict' };
|
|
300
|
+
row = claim;
|
|
301
|
+
let result;
|
|
302
|
+
try {
|
|
303
|
+
result = this.spec.remediation(ctx);
|
|
304
|
+
if (result && typeof result.then === 'function')
|
|
305
|
+
throw new Error('async remediation forbidden');
|
|
306
|
+
}
|
|
307
|
+
catch {
|
|
308
|
+
result = { outcome: 'not-healed', evidence: 'io-error' };
|
|
309
|
+
}
|
|
310
|
+
if (result.outcome === 'healed') {
|
|
311
|
+
const closed = this.cas(row, (r) => ({ ...r, status: 'recovered', recoveries: [...r.recoveries, this.now()].slice(-64) }));
|
|
312
|
+
return closed ? { outcome: 'healed', reason: result.evidence, tokenValid: consumed.valid } : { outcome: 'busy', reason: 'revision-conflict' };
|
|
313
|
+
}
|
|
314
|
+
if (result.outcome === 'pending-restart') {
|
|
315
|
+
const stableRequestId = `self-heal:${keyHash(row.key)}:${row.startedAt}`;
|
|
316
|
+
const pending = this.cas(row, (r) => ({ ...r, restart: { state: 'required', requestingBootId: this.bootId, stableRequestId } }));
|
|
317
|
+
return pending ? this.requestPendingRestart(pending) : { outcome: 'busy', reason: 'revision-conflict' };
|
|
318
|
+
}
|
|
319
|
+
const failed = this.cas(row, (r) => ({ ...r, nextEligibleAt: this.now() + Math.max(0, this.spec.backoffMs(row.attempts)) }));
|
|
320
|
+
return failed ? { outcome: 'attempted', reason: result.evidence, tokenValid: consumed.valid } : { outcome: 'busy', reason: 'revision-conflict' };
|
|
321
|
+
}
|
|
322
|
+
requestPendingRestart(row) {
|
|
323
|
+
if (!row.restart)
|
|
324
|
+
return { outcome: 'state-failure', reason: 'restart-state-missing' };
|
|
325
|
+
const ok = this.deps.requestRestart?.(row.restart.stableRequestId) ?? false;
|
|
326
|
+
if (!ok)
|
|
327
|
+
return { outcome: 'attempted', reason: 'restart-request-failed' };
|
|
328
|
+
if (row.restart.state === 'requested')
|
|
329
|
+
return { outcome: 'attempted', reason: 'restart-requested' };
|
|
330
|
+
const requested = this.cas(row, (r) => ({ ...r, restart: r.restart ? { ...r.restart, state: 'requested' } : null }));
|
|
331
|
+
return requested ? { outcome: 'attempted', reason: 'restart-requested' } : { outcome: 'busy', reason: 'revision-conflict' };
|
|
332
|
+
}
|
|
333
|
+
async ensureNotice(row, reason) {
|
|
334
|
+
const existing = row.notices[reason];
|
|
335
|
+
if (existing?.state === 'enqueued')
|
|
336
|
+
return { row, attempted: false };
|
|
337
|
+
const id = existing?.id ?? `self-heal:${keyHash(row.key)}:${reason}:${row.startedAt}`;
|
|
338
|
+
if (!existing) {
|
|
339
|
+
const pending = this.cas(row, (r) => ({ ...r, notices: { ...r.notices, [reason]: { state: 'pending', id } } }));
|
|
340
|
+
if (!pending)
|
|
341
|
+
return { row: this.store.load(row.key) ?? row, attempted: false };
|
|
342
|
+
row = pending;
|
|
343
|
+
}
|
|
344
|
+
try {
|
|
345
|
+
await this.deps.notify({ id, controllerId: this.spec.id, reason, priority: ['irreversible', 'data-loss', 'security'].includes(reason) ? 'URGENT' : 'HIGH' });
|
|
346
|
+
}
|
|
347
|
+
catch {
|
|
348
|
+
this.audit({ event: 'notice-enqueue-failed', reason });
|
|
349
|
+
return { row, attempted: true };
|
|
350
|
+
}
|
|
351
|
+
const enqueued = this.cas(row, (r) => ({ ...r, notices: { ...r.notices, [reason]: { state: 'enqueued', id } } }));
|
|
352
|
+
return { row: enqueued ?? row, attempted: true };
|
|
353
|
+
}
|
|
354
|
+
async noticeAndReturn(row, reason, outcome) { const notice = await this.ensureNotice(row, reason); return { outcome, reason, noticeAttempted: notice.attempted, noticeReason: reason }; }
|
|
355
|
+
async exhaust(row, reason) { const notice = await this.ensureNotice(row, reason); row = notice.row; const terminal = this.cas(row, (r) => ({ ...r, status: 'exhausted' })); return terminal ? { outcome: 'exhausted', reason, noticeAttempted: notice.attempted, noticeReason: reason } : { outcome: 'busy', reason: 'revision-conflict' }; }
|
|
356
|
+
stateFailure(reason) { this.audit({ event: 'state-failure', reason }); return { outcome: 'state-failure', reason }; }
|
|
357
|
+
async stateFailureWithNotice(reason) {
|
|
358
|
+
this.audit({ event: 'state-failure', reason });
|
|
359
|
+
const id = `self-heal:${this.spec.id}:state-failure:${this.bootId}`;
|
|
360
|
+
if (!this.stateFailureNotices.has(id)) {
|
|
361
|
+
try {
|
|
362
|
+
await this.deps.notify({ id, controllerId: this.spec.id, reason: 'state-failure', priority: 'HIGH' });
|
|
363
|
+
this.stateFailureNotices.add(id);
|
|
364
|
+
}
|
|
365
|
+
catch {
|
|
366
|
+
this.audit({ event: 'notice-enqueue-failed', reason: 'state-failure' });
|
|
367
|
+
}
|
|
368
|
+
}
|
|
369
|
+
return { outcome: 'state-failure', reason, noticeAttempted: true, noticeReason: 'state-failure' };
|
|
370
|
+
}
|
|
371
|
+
key(ctx) { const d = this.spec.dedupeKey(ctx); if (!/^[a-z0-9][a-z0-9._:-]{0,119}$/i.test(d))
|
|
372
|
+
throw new Error('invalid self-heal dedupe key'); return `${this.spec.id}:${d}`; }
|
|
373
|
+
newEpisode(key) { const now = this.now(); return { schemaVersion: 1, key, revision: 0, status: 'active', startedAt: now, attempts: 0, nextEligibleAt: 0, latch: emptyLatch(), notices: {}, recoveries: [], restart: null, updatedAt: now }; }
|
|
374
|
+
cas(row, update, guard) { return this.store.mutate(row.key, row.revision, (r) => ({ ...update(r), revision: r.revision + 1, updatedAt: this.now() }), guard); }
|
|
375
|
+
audit(input) { const event = { ...input, at: this.now(), controllerId: this.spec.id }; try {
|
|
376
|
+
this.store.appendAudit?.(event);
|
|
377
|
+
}
|
|
378
|
+
catch { /* secondary sink below */ } try {
|
|
379
|
+
this.deps.audit(event);
|
|
380
|
+
}
|
|
381
|
+
catch { /* metadata audit best effort */ } }
|
|
382
|
+
}
|
|
383
|
+
function safeEligible(spec, ctx) { try {
|
|
384
|
+
return spec.eligible(ctx);
|
|
385
|
+
}
|
|
386
|
+
catch {
|
|
387
|
+
return { eligible: false, fence: null };
|
|
388
|
+
} }
|
|
389
|
+
function emptyLatch() { return { schemaVersion: 1, failingSince: null, failures: 0, signaledFor: null }; }
|
|
390
|
+
function keyHash(value) { return crypto.createHash('sha256').update(value).digest('hex').slice(0, 24); }
|
|
391
|
+
//# sourceMappingURL=SelfHealGate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SelfHealGate.js","sourceRoot":"","sources":["../../src/core/SelfHealGate.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
export interface SshBootstrapAdvert {
|
|
2
|
+
machineId: string;
|
|
3
|
+
agentId: string;
|
|
4
|
+
pairingEpoch: number;
|
|
5
|
+
observerBootId: string;
|
|
6
|
+
clientKeyGeneration: number;
|
|
7
|
+
hostKeyGeneration: number;
|
|
8
|
+
clientPublicKey: string;
|
|
9
|
+
sshHostPublicKeys: string[];
|
|
10
|
+
endpoints: Array<{
|
|
11
|
+
host: string;
|
|
12
|
+
port: number;
|
|
13
|
+
source: 'tailscale' | 'lan' | 'configured';
|
|
14
|
+
}>;
|
|
15
|
+
issuedAt: string;
|
|
16
|
+
expiresAt: string;
|
|
17
|
+
hostKeyTransitionSignature?: string;
|
|
18
|
+
machineSignature: string;
|
|
19
|
+
}
|
|
20
|
+
export declare function canonicalSshBootstrapAdvert(advert: Omit<SshBootstrapAdvert, 'machineSignature'>): string;
|
|
21
|
+
/** Structural security floor; MachineAuth signature/principal validation precedes this call. */
|
|
22
|
+
export declare function validateSshBootstrapAdvert(input: unknown, principalMachineId: string, principalAgentId: string, now?: number): SshBootstrapAdvert;
|
|
23
|
+
//# sourceMappingURL=SshBootstrapAdvert.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SshBootstrapAdvert.d.ts","sourceRoot":"","sources":["../../src/core/SshBootstrapAdvert.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,GAAG,KAAK,GAAG,YAAY,CAAA;KAAE,CAAC,CAAC;IAC7F,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,MAAM,CASxG;AAED,gGAAgG;AAChG,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,kBAAkB,CAarJ"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import net from 'node:net';
|
|
2
|
+
export function canonicalSshBootstrapAdvert(advert) {
|
|
3
|
+
return JSON.stringify({
|
|
4
|
+
machineId: advert.machineId, agentId: advert.agentId, pairingEpoch: advert.pairingEpoch,
|
|
5
|
+
observerBootId: advert.observerBootId, clientKeyGeneration: advert.clientKeyGeneration,
|
|
6
|
+
hostKeyGeneration: advert.hostKeyGeneration, clientPublicKey: advert.clientPublicKey,
|
|
7
|
+
sshHostPublicKeys: advert.sshHostPublicKeys, endpoints: advert.endpoints,
|
|
8
|
+
issuedAt: advert.issuedAt, expiresAt: advert.expiresAt,
|
|
9
|
+
...(advert.hostKeyTransitionSignature ? { hostKeyTransitionSignature: advert.hostKeyTransitionSignature } : {}),
|
|
10
|
+
});
|
|
11
|
+
}
|
|
12
|
+
/** Structural security floor; MachineAuth signature/principal validation precedes this call. */
|
|
13
|
+
export function validateSshBootstrapAdvert(input, principalMachineId, principalAgentId, now = Date.now()) {
|
|
14
|
+
if (!input || typeof input !== 'object')
|
|
15
|
+
throw new Error('invalid-ssh-advert');
|
|
16
|
+
const row = input;
|
|
17
|
+
if (row.machineId !== principalMachineId || row.agentId !== principalAgentId)
|
|
18
|
+
throw new Error('ssh-advert-principal-mismatch');
|
|
19
|
+
if (!Number.isSafeInteger(row.pairingEpoch) || row.pairingEpoch < 1 || !Number.isSafeInteger(row.clientKeyGeneration) || !Number.isSafeInteger(row.hostKeyGeneration))
|
|
20
|
+
throw new Error('ssh-advert-generation-invalid');
|
|
21
|
+
const issuedAt = Date.parse(row.issuedAt);
|
|
22
|
+
const expiresAt = Date.parse(row.expiresAt);
|
|
23
|
+
if (!Number.isFinite(issuedAt) || !Number.isFinite(expiresAt) || issuedAt > now + 30_000 || expiresAt <= now || expiresAt - now > 300_000)
|
|
24
|
+
throw new Error('ssh-advert-expired');
|
|
25
|
+
if (!Array.isArray(row.sshHostPublicKeys) || !/^ssh-ed25519 [A-Za-z0-9+/=]+(?:\s|$)/.test(row.clientPublicKey) || row.sshHostPublicKeys.length < 1 || row.sshHostPublicKeys.length > 2 || row.sshHostPublicKeys.some(key => !/^ssh-ed25519 [A-Za-z0-9+/=]+(?:\s|$)/.test(key)))
|
|
26
|
+
throw new Error('ssh-advert-key-invalid');
|
|
27
|
+
if (!Array.isArray(row.endpoints) || row.endpoints.length > 8 || row.endpoints.some(endpoint => !validEndpoint(endpoint)))
|
|
28
|
+
throw new Error('ssh-advert-endpoint-invalid');
|
|
29
|
+
if (typeof row.observerBootId !== 'string' || row.observerBootId.length < 8 || row.observerBootId.length > 128 || typeof row.machineSignature !== 'string' || row.machineSignature.length < 32 || row.machineSignature.length > 512)
|
|
30
|
+
throw new Error('ssh-advert-signature-invalid');
|
|
31
|
+
if (row.hostKeyTransitionSignature !== undefined && (typeof row.hostKeyTransitionSignature !== 'string' || row.hostKeyTransitionSignature.length < 32 || row.hostKeyTransitionSignature.length > 512))
|
|
32
|
+
throw new Error('ssh-advert-transition-signature-invalid');
|
|
33
|
+
return row;
|
|
34
|
+
}
|
|
35
|
+
function validEndpoint(endpoint) {
|
|
36
|
+
if (!['tailscale', 'lan', 'configured'].includes(endpoint.source) || !Number.isInteger(endpoint.port) || endpoint.port < 1024 || endpoint.port > 65535)
|
|
37
|
+
return false;
|
|
38
|
+
if (net.isIP(endpoint.host) !== 4)
|
|
39
|
+
return false;
|
|
40
|
+
const [a, b] = endpoint.host.split('.').map(Number);
|
|
41
|
+
return a === 10 || (a === 100 && b >= 64 && b <= 127) || (a === 172 && b >= 16 && b <= 31) || (a === 192 && b === 168);
|
|
42
|
+
}
|
|
43
|
+
//# sourceMappingURL=SshBootstrapAdvert.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SshBootstrapAdvert.js","sourceRoot":"","sources":["../../src/core/SshBootstrapAdvert.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
export type SshHostKeyState = 'current' | 'quarantined' | 'overlap' | 'retired' | 'rollback-rejected';
|
|
2
|
+
export interface SignedHostKeyProposal {
|
|
3
|
+
agentId: string;
|
|
4
|
+
machineId: string;
|
|
5
|
+
pairingEpoch: number;
|
|
6
|
+
generation: number;
|
|
7
|
+
previousGeneration: number;
|
|
8
|
+
publicKey: string;
|
|
9
|
+
issuedAt: string;
|
|
10
|
+
machineSignature: string;
|
|
11
|
+
previousHostSignature?: string;
|
|
12
|
+
}
|
|
13
|
+
export interface HostKeyProposalVerifier {
|
|
14
|
+
verifyMachine(proposal: SignedHostKeyProposal): boolean;
|
|
15
|
+
verifyPreviousHost(proposal: SignedHostKeyProposal): boolean;
|
|
16
|
+
}
|
|
17
|
+
export interface HostKeyGeneration {
|
|
18
|
+
generation: number;
|
|
19
|
+
fingerprint: string;
|
|
20
|
+
publicKey: string;
|
|
21
|
+
state: SshHostKeyState;
|
|
22
|
+
quarantinedAt?: number;
|
|
23
|
+
}
|
|
24
|
+
export declare function canonicalHostKeyProposal(proposal: Omit<SignedHostKeyProposal, 'machineSignature' | 'previousHostSignature'>): string;
|
|
25
|
+
/** Monotonic, fail-closed host-key rotation state machine. */
|
|
26
|
+
export declare class SshHostKeyLifecycle {
|
|
27
|
+
private readonly overlapCeilingMs;
|
|
28
|
+
private current;
|
|
29
|
+
private candidate?;
|
|
30
|
+
constructor(initial: {
|
|
31
|
+
generation: number;
|
|
32
|
+
publicKey: string;
|
|
33
|
+
}, overlapCeilingMs?: number);
|
|
34
|
+
propose(proposal: SignedHostKeyProposal, verifier: HostKeyProposalVerifier, now?: number): HostKeyGeneration;
|
|
35
|
+
proveCandidate(generation: number): HostKeyGeneration;
|
|
36
|
+
promote(generation: number, allRequiredInboundProofs: boolean, now?: number): HostKeyGeneration;
|
|
37
|
+
expire(now?: number): void;
|
|
38
|
+
snapshot(): {
|
|
39
|
+
current: HostKeyGeneration;
|
|
40
|
+
candidate?: HostKeyGeneration;
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
//# sourceMappingURL=SshHostKeyLifecycle.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SshHostKeyLifecycle.d.ts","sourceRoot":"","sources":["../../src/core/SshHostKeyLifecycle.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,mBAAmB,CAAC;AAEtG,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACxD,kBAAkB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC;CAC9D;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,GAAG,uBAAuB,CAAC,GAAG,MAAM,CAMpI;AAED,8DAA8D;AAC9D,qBAAa,mBAAmB;IAIkC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAHjG,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,SAAS,CAAC,CAAoB;gBAE1B,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAmB,gBAAgB,SAAU;IAI3G,OAAO,CAAC,QAAQ,EAAE,qBAAqB,EAAE,QAAQ,EAAE,uBAAuB,EAAE,GAAG,SAAa,GAAG,iBAAiB;IAgBhH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB;IAMrD,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,wBAAwB,EAAE,OAAO,EAAE,GAAG,SAAa,GAAG,iBAAiB;IASnG,MAAM,CAAC,GAAG,SAAa,GAAG,IAAI;IAI9B,QAAQ,IAAI;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,SAAS,CAAC,EAAE,iBAAiB,CAAA;KAAE;CAG1E"}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
export function canonicalHostKeyProposal(proposal) {
|
|
3
|
+
return JSON.stringify({
|
|
4
|
+
agentId: proposal.agentId, machineId: proposal.machineId, pairingEpoch: proposal.pairingEpoch,
|
|
5
|
+
generation: proposal.generation, previousGeneration: proposal.previousGeneration,
|
|
6
|
+
publicKey: proposal.publicKey, issuedAt: proposal.issuedAt,
|
|
7
|
+
});
|
|
8
|
+
}
|
|
9
|
+
/** Monotonic, fail-closed host-key rotation state machine. */
|
|
10
|
+
export class SshHostKeyLifecycle {
|
|
11
|
+
overlapCeilingMs;
|
|
12
|
+
current;
|
|
13
|
+
candidate;
|
|
14
|
+
constructor(initial, overlapCeilingMs = 600_000) {
|
|
15
|
+
this.overlapCeilingMs = overlapCeilingMs;
|
|
16
|
+
this.current = { ...initial, fingerprint: keyFingerprint(initial.publicKey), state: 'current' };
|
|
17
|
+
}
|
|
18
|
+
propose(proposal, verifier, now = Date.now()) {
|
|
19
|
+
const fp = keyFingerprint(proposal.publicKey);
|
|
20
|
+
if (!verifier.verifyMachine(proposal))
|
|
21
|
+
throw new Error('host-key-machine-signature-invalid');
|
|
22
|
+
if (proposal.generation <= this.current.generation || proposal.previousGeneration !== this.current.generation) {
|
|
23
|
+
throw new Error('host-key-rollback-rejected');
|
|
24
|
+
}
|
|
25
|
+
if (proposal.generation !== this.current.generation + 1)
|
|
26
|
+
throw new Error('host-key-generation-gap');
|
|
27
|
+
if (this.candidate) {
|
|
28
|
+
if (this.candidate.generation === proposal.generation && this.candidate.fingerprint === fp)
|
|
29
|
+
return this.candidate;
|
|
30
|
+
throw new Error('host-key-competing-proposal');
|
|
31
|
+
}
|
|
32
|
+
this.candidate = { generation: proposal.generation, publicKey: proposal.publicKey, fingerprint: fp, state: 'quarantined', quarantinedAt: now };
|
|
33
|
+
if (proposal.previousHostSignature && verifier.verifyPreviousHost(proposal))
|
|
34
|
+
this.candidate.state = 'overlap';
|
|
35
|
+
return this.candidate;
|
|
36
|
+
}
|
|
37
|
+
proveCandidate(generation) {
|
|
38
|
+
if (!this.candidate || this.candidate.generation !== generation)
|
|
39
|
+
throw new Error('host-key-not-quarantined');
|
|
40
|
+
this.candidate.state = 'overlap';
|
|
41
|
+
return this.candidate;
|
|
42
|
+
}
|
|
43
|
+
promote(generation, allRequiredInboundProofs, now = Date.now()) {
|
|
44
|
+
if (!this.candidate || this.candidate.generation !== generation || this.candidate.state !== 'overlap')
|
|
45
|
+
throw new Error('host-key-not-in-overlap');
|
|
46
|
+
if (now - (this.candidate.quarantinedAt ?? now) > this.overlapCeilingMs)
|
|
47
|
+
throw new Error('host-key-overlap-expired');
|
|
48
|
+
if (!allRequiredInboundProofs)
|
|
49
|
+
throw new Error('host-key-proofs-incomplete');
|
|
50
|
+
this.current = { ...this.candidate, state: 'current', quarantinedAt: undefined };
|
|
51
|
+
this.candidate = undefined;
|
|
52
|
+
return this.current;
|
|
53
|
+
}
|
|
54
|
+
expire(now = Date.now()) {
|
|
55
|
+
if (this.candidate && now - (this.candidate.quarantinedAt ?? now) > this.overlapCeilingMs)
|
|
56
|
+
this.candidate = undefined;
|
|
57
|
+
}
|
|
58
|
+
snapshot() {
|
|
59
|
+
return { current: { ...this.current }, candidate: this.candidate ? { ...this.candidate } : undefined };
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
function keyFingerprint(publicKey) {
|
|
63
|
+
const body = publicKey.trim().split(/\s+/)[1];
|
|
64
|
+
if (!body)
|
|
65
|
+
throw new Error('host-key-invalid');
|
|
66
|
+
return createHash('sha256').update(Buffer.from(body, 'base64')).digest('hex');
|
|
67
|
+
}
|
|
68
|
+
//# sourceMappingURL=SshHostKeyLifecycle.js.map
|