@origintrail-official/dkg-node-ui 10.0.9 → 10.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. package/LICENSE +201 -201
  2. package/README.md +50 -50
  3. package/dist/chain-cursor-stores.js +6 -6
  4. package/dist/chat-memory.js +209 -209
  5. package/dist/db.d.ts.map +1 -1
  6. package/dist/db.js +956 -938
  7. package/dist/db.js.map +1 -1
  8. package/dist/metrics-collector.js +1 -1
  9. package/dist/metrics-collector.js.map +1 -1
  10. package/dist-ui/assets/{3d-force-graph-32vYp3Gt.js → 3d-force-graph-CQA2D9yg.js} +1 -1
  11. package/dist-ui/assets/{AgentHub-B9W-efVf.js → AgentHub-CSSV1CuQ.js} +1 -1
  12. package/dist-ui/assets/{AgentProfilePage-DxS9zMTU.js → AgentProfilePage-C96h7Jti.js} +1 -1
  13. package/dist-ui/assets/{ApproveWalletsModal-DIwmlqqm.js → ApproveWalletsModal-CjNXwm4Q.js} +3 -3
  14. package/dist-ui/assets/{ConvictionDetailView-BozGXkJn.js → ConvictionDetailView-DIwJDW-h.js} +1 -1
  15. package/dist-ui/assets/{Network-DSwIFRGu.js → Network--HTk881J.js} +1 -1
  16. package/dist-ui/assets/{OnChainProvenanceCard-C73dR0ZK.js → OnChainProvenanceCard-B27Dv2LS.js} +1 -1
  17. package/dist-ui/assets/{Operations-CpTCodwd.js → Operations-CVOxbIG3.js} +1 -1
  18. package/dist-ui/assets/{PublishingConviction-BKppjqUt.js → PublishingConviction-Cq4tU73y.js} +1 -1
  19. package/dist-ui/assets/{Settings-Cgn410CQ.js → Settings-CAoRacEr.js} +1 -1
  20. package/dist-ui/assets/{ccip-DYNah0HH.js → ccip-Bhdk2CFT.js} +1 -1
  21. package/dist-ui/assets/{index-91k1Z-EI.js → index-ByKu4and.js} +943 -943
  22. package/dist-ui/assets/{index-I_u_n2I5.js → index-CqY4Svqw.js} +3 -3
  23. package/dist-ui/assets/{jsonld-32FQRO67-DoKvywR8.js → jsonld-B67IUHNU-Be6d6eKI.js} +2 -2
  24. package/dist-ui/assets/{jsonld-DLUtuDjD.js → jsonld-DAi1sJLi.js} +1 -1
  25. package/dist-ui/assets/{renderer-3d-2EVDZII7-DmIioW4I.js → renderer-3d-OSESAPET-BiTfqzJc.js} +2 -2
  26. package/dist-ui/assets/{shikiHighlighter-BPMtNhWI.js → shikiHighlighter-Cie8jX4V.js} +1 -1
  27. package/dist-ui/index.html +13 -13
  28. package/package.json +3 -3
  29. /package/dist-ui/assets/{ntriples-ZWBY2WET-DH7OofPp.js → ntriples-SF2LFNMC-DH7OofPp.js} +0 -0
  30. /package/dist-ui/assets/{turtle-JJPK7LJ5-BzTu0283.js → turtle-BXN4L2BY-BzTu0283.js} +0 -0
package/dist/db.js CHANGED
@@ -2,7 +2,7 @@ import Database from 'better-sqlite3';
2
2
  import { join } from 'node:path';
3
3
  import { RESPONSE_CACHE_BYTES, parseContextGraphJoinPolicyRecord, } from '@origintrail-official/dkg-core';
4
4
  export { SqliteChainEventCursorStore, SqliteContextGraphRegistryScanCursorStore, } from './chain-cursor-stores.js';
5
- const SCHEMA_VERSION = 30;
5
+ const SCHEMA_VERSION = 31;
6
6
  // Default operator retention. Lowered from 90 → 14 days on V15 (2026-05) after
7
7
  // a production incident in which the `logs` table + its FTS5 shadow tables
8
8
  // grew to ~9 GB on a 12-day-old node and corrupted the SQLite page (header
@@ -138,44 +138,44 @@ export class DashboardDB {
138
138
  migrate() {
139
139
  const version = this.db.pragma('user_version', { simple: true });
140
140
  const upgradedExistingDb = version > 0 && version < SCHEMA_VERSION;
141
- const ensureJoinPolicyAuditCapTrigger = () => this.db.exec(`
142
- CREATE TRIGGER IF NOT EXISTS cap_cg_join_policy_audit_rows
143
- AFTER INSERT ON context_graph_join_policy_audit
144
- BEGIN
145
- DELETE FROM context_graph_join_policy_audit
146
- WHERE id <= NEW.id - 100000
147
- AND event_type NOT IN (
148
- 'join_admission_committed',
149
- 'join_policy_changed'
150
- );
151
- END;
141
+ const ensureJoinPolicyAuditCapTrigger = () => this.db.exec(`
142
+ CREATE TRIGGER IF NOT EXISTS cap_cg_join_policy_audit_rows
143
+ AFTER INSERT ON context_graph_join_policy_audit
144
+ BEGIN
145
+ DELETE FROM context_graph_join_policy_audit
146
+ WHERE id <= NEW.id - 100000
147
+ AND event_type NOT IN (
148
+ 'join_admission_committed',
149
+ 'join_policy_changed'
150
+ );
151
+ END;
152
152
  `);
153
153
  const ensureJoinApprovalRepairMarker = () => {
154
- const table = this.db.prepare(`
155
- SELECT 1 AS found FROM sqlite_master
156
- WHERE type = 'table' AND name = 'context_graph_join_approval_ledger'
154
+ const table = this.db.prepare(`
155
+ SELECT 1 AS found FROM sqlite_master
156
+ WHERE type = 'table' AND name = 'context_graph_join_approval_ledger'
157
157
  `).get();
158
158
  if (!table)
159
159
  return;
160
160
  const columns = this.db.pragma('table_info(context_graph_join_approval_ledger)');
161
161
  if (!columns.some((column) => column.name === 'repair_pending')) {
162
- this.db.exec(`
163
- ALTER TABLE context_graph_join_approval_ledger
164
- ADD COLUMN repair_pending INTEGER NOT NULL DEFAULT 0
165
- CHECK (repair_pending IN (0, 1));
162
+ this.db.exec(`
163
+ ALTER TABLE context_graph_join_approval_ledger
164
+ ADD COLUMN repair_pending INTEGER NOT NULL DEFAULT 0
165
+ CHECK (repair_pending IN (0, 1));
166
166
  `);
167
167
  }
168
- this.db.exec(`
169
- CREATE INDEX IF NOT EXISTS idx_cg_join_approval_ledger_repair
170
- ON context_graph_join_approval_ledger(
171
- context_graph_id, request_digest, repair_pending, reserved_at DESC
172
- );
168
+ this.db.exec(`
169
+ CREATE INDEX IF NOT EXISTS idx_cg_join_approval_ledger_repair
170
+ ON context_graph_join_approval_ledger(
171
+ context_graph_id, request_digest, repair_pending, reserved_at DESC
172
+ );
173
173
  `);
174
174
  };
175
175
  const ensureSyncCheckpointResponderSessionColumns = () => {
176
- const table = this.db.prepare(`
177
- SELECT 1 AS found FROM sqlite_master
178
- WHERE type = 'table' AND name = 'sync_checkpoints'
176
+ const table = this.db.prepare(`
177
+ SELECT 1 AS found FROM sqlite_master
178
+ WHERE type = 'table' AND name = 'sync_checkpoints'
179
179
  `).get();
180
180
  if (!table)
181
181
  return;
@@ -199,117 +199,117 @@ export class DashboardDB {
199
199
  return;
200
200
  }
201
201
  if (version < 1) {
202
- this.db.exec(`
203
- CREATE TABLE IF NOT EXISTS metric_snapshots (
204
- id INTEGER PRIMARY KEY AUTOINCREMENT,
205
- ts INTEGER NOT NULL,
206
- cpu_percent REAL,
207
- mem_used_bytes INTEGER,
208
- mem_total_bytes INTEGER,
209
- disk_used_bytes INTEGER,
210
- disk_total_bytes INTEGER,
211
- heap_used_bytes INTEGER,
212
- uptime_seconds INTEGER,
213
- peer_count INTEGER,
214
- direct_peers INTEGER,
215
- relayed_peers INTEGER,
216
- mesh_peers INTEGER,
217
- contextGraph_count INTEGER,
218
- total_triples INTEGER,
219
- total_kcs INTEGER,
220
- total_kas INTEGER,
221
- store_bytes INTEGER,
222
- confirmed_kcs INTEGER,
223
- tentative_kcs INTEGER,
224
- rpc_latency_ms INTEGER,
225
- rpc_healthy INTEGER,
226
- relay_capacity INTEGER,
227
- relay_reservation_count INTEGER,
228
- relay_active_circuits INTEGER,
229
- relay_bytes_in INTEGER,
230
- relay_bytes_out INTEGER
231
- );
232
- CREATE INDEX IF NOT EXISTS idx_snapshots_ts ON metric_snapshots(ts);
233
-
234
- CREATE TABLE IF NOT EXISTS operations (
235
- id INTEGER PRIMARY KEY AUTOINCREMENT,
236
- operation_id TEXT NOT NULL,
237
- operation_name TEXT NOT NULL,
238
- started_at INTEGER NOT NULL,
239
- duration_ms INTEGER,
240
- status TEXT DEFAULT 'in_progress',
241
- peer_id TEXT,
242
- contextGraph_id TEXT,
243
- triple_count INTEGER,
244
- error_message TEXT,
245
- details TEXT
246
- );
247
- CREATE INDEX IF NOT EXISTS idx_ops_operation_id ON operations(operation_id);
248
- CREATE INDEX IF NOT EXISTS idx_ops_started_at ON operations(started_at);
249
- CREATE INDEX IF NOT EXISTS idx_ops_name ON operations(operation_name);
250
-
251
- CREATE TABLE IF NOT EXISTS logs (
252
- id INTEGER PRIMARY KEY AUTOINCREMENT,
253
- ts INTEGER NOT NULL,
254
- level TEXT NOT NULL,
255
- operation_name TEXT,
256
- operation_id TEXT,
257
- module TEXT,
258
- message TEXT NOT NULL
259
- );
260
- CREATE INDEX IF NOT EXISTS idx_logs_ts ON logs(ts);
261
- CREATE INDEX IF NOT EXISTS idx_logs_operation_id ON logs(operation_id);
262
- CREATE INDEX IF NOT EXISTS idx_logs_level ON logs(level);
263
-
264
- -- NOTE: Earlier schema versions (V1..V14) also created an FTS5
265
- -- virtual table "logs_fts" plus AFTER INSERT/DELETE triggers to
266
- -- keep it in sync with "logs". That fed a free-text search path
267
- -- behind /api/logs?q=... The FTS5 index turned out to dominate
268
- -- on-disk size (multi-GB shadow tables on long-lived nodes) and
269
- -- the corresponding HTTP route had no production consumer
270
- -- (the dashboard log viewer is file-backed via /api/node-log).
271
- -- V15 drops it for fresh installs; the migration below cleans
272
- -- it up for in-place upgrades.
273
-
274
- CREATE TABLE IF NOT EXISTS query_history (
275
- id INTEGER PRIMARY KEY AUTOINCREMENT,
276
- ts INTEGER NOT NULL,
277
- sparql TEXT NOT NULL,
278
- duration_ms INTEGER,
279
- result_count INTEGER,
280
- error TEXT
281
- );
282
- CREATE INDEX IF NOT EXISTS idx_qhist_ts ON query_history(ts);
283
-
284
- CREATE TABLE IF NOT EXISTS saved_queries (
285
- id INTEGER PRIMARY KEY AUTOINCREMENT,
286
- name TEXT NOT NULL,
287
- description TEXT,
288
- sparql TEXT NOT NULL,
289
- created_at INTEGER NOT NULL,
290
- updated_at INTEGER NOT NULL
291
- );
202
+ this.db.exec(`
203
+ CREATE TABLE IF NOT EXISTS metric_snapshots (
204
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
205
+ ts INTEGER NOT NULL,
206
+ cpu_percent REAL,
207
+ mem_used_bytes INTEGER,
208
+ mem_total_bytes INTEGER,
209
+ disk_used_bytes INTEGER,
210
+ disk_total_bytes INTEGER,
211
+ heap_used_bytes INTEGER,
212
+ uptime_seconds INTEGER,
213
+ peer_count INTEGER,
214
+ direct_peers INTEGER,
215
+ relayed_peers INTEGER,
216
+ mesh_peers INTEGER,
217
+ contextGraph_count INTEGER,
218
+ total_triples INTEGER,
219
+ total_kcs INTEGER,
220
+ total_kas INTEGER,
221
+ store_bytes INTEGER,
222
+ confirmed_kcs INTEGER,
223
+ tentative_kcs INTEGER,
224
+ rpc_latency_ms INTEGER,
225
+ rpc_healthy INTEGER,
226
+ relay_capacity INTEGER,
227
+ relay_reservation_count INTEGER,
228
+ relay_active_circuits INTEGER,
229
+ relay_bytes_in INTEGER,
230
+ relay_bytes_out INTEGER
231
+ );
232
+ CREATE INDEX IF NOT EXISTS idx_snapshots_ts ON metric_snapshots(ts);
233
+
234
+ CREATE TABLE IF NOT EXISTS operations (
235
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
236
+ operation_id TEXT NOT NULL,
237
+ operation_name TEXT NOT NULL,
238
+ started_at INTEGER NOT NULL,
239
+ duration_ms INTEGER,
240
+ status TEXT DEFAULT 'in_progress',
241
+ peer_id TEXT,
242
+ contextGraph_id TEXT,
243
+ triple_count INTEGER,
244
+ error_message TEXT,
245
+ details TEXT
246
+ );
247
+ CREATE INDEX IF NOT EXISTS idx_ops_operation_id ON operations(operation_id);
248
+ CREATE INDEX IF NOT EXISTS idx_ops_started_at ON operations(started_at);
249
+ CREATE INDEX IF NOT EXISTS idx_ops_name ON operations(operation_name);
250
+
251
+ CREATE TABLE IF NOT EXISTS logs (
252
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
253
+ ts INTEGER NOT NULL,
254
+ level TEXT NOT NULL,
255
+ operation_name TEXT,
256
+ operation_id TEXT,
257
+ module TEXT,
258
+ message TEXT NOT NULL
259
+ );
260
+ CREATE INDEX IF NOT EXISTS idx_logs_ts ON logs(ts);
261
+ CREATE INDEX IF NOT EXISTS idx_logs_operation_id ON logs(operation_id);
262
+ CREATE INDEX IF NOT EXISTS idx_logs_level ON logs(level);
263
+
264
+ -- NOTE: Earlier schema versions (V1..V14) also created an FTS5
265
+ -- virtual table "logs_fts" plus AFTER INSERT/DELETE triggers to
266
+ -- keep it in sync with "logs". That fed a free-text search path
267
+ -- behind /api/logs?q=... The FTS5 index turned out to dominate
268
+ -- on-disk size (multi-GB shadow tables on long-lived nodes) and
269
+ -- the corresponding HTTP route had no production consumer
270
+ -- (the dashboard log viewer is file-backed via /api/node-log).
271
+ -- V15 drops it for fresh installs; the migration below cleans
272
+ -- it up for in-place upgrades.
273
+
274
+ CREATE TABLE IF NOT EXISTS query_history (
275
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
276
+ ts INTEGER NOT NULL,
277
+ sparql TEXT NOT NULL,
278
+ duration_ms INTEGER,
279
+ result_count INTEGER,
280
+ error TEXT
281
+ );
282
+ CREATE INDEX IF NOT EXISTS idx_qhist_ts ON query_history(ts);
283
+
284
+ CREATE TABLE IF NOT EXISTS saved_queries (
285
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
286
+ name TEXT NOT NULL,
287
+ description TEXT,
288
+ sparql TEXT NOT NULL,
289
+ created_at INTEGER NOT NULL,
290
+ updated_at INTEGER NOT NULL
291
+ );
292
292
  `);
293
293
  }
294
294
  if (version < 2) {
295
- this.db.exec(`
296
- CREATE TABLE IF NOT EXISTS operation_phases (
297
- id INTEGER PRIMARY KEY AUTOINCREMENT,
298
- operation_id TEXT NOT NULL,
299
- phase TEXT NOT NULL,
300
- started_at INTEGER NOT NULL,
301
- duration_ms INTEGER,
302
- status TEXT DEFAULT 'in_progress',
303
- details TEXT
304
- );
305
- CREATE INDEX IF NOT EXISTS idx_phases_op ON operation_phases(operation_id);
306
-
307
- ALTER TABLE operations ADD COLUMN gas_used INTEGER;
308
- ALTER TABLE operations ADD COLUMN gas_price_gwei REAL;
309
- ALTER TABLE operations ADD COLUMN gas_cost_eth REAL;
310
- ALTER TABLE operations ADD COLUMN trac_cost REAL;
311
- ALTER TABLE operations ADD COLUMN tx_hash TEXT;
312
- ALTER TABLE operations ADD COLUMN chain_id INTEGER;
295
+ this.db.exec(`
296
+ CREATE TABLE IF NOT EXISTS operation_phases (
297
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
298
+ operation_id TEXT NOT NULL,
299
+ phase TEXT NOT NULL,
300
+ started_at INTEGER NOT NULL,
301
+ duration_ms INTEGER,
302
+ status TEXT DEFAULT 'in_progress',
303
+ details TEXT
304
+ );
305
+ CREATE INDEX IF NOT EXISTS idx_phases_op ON operation_phases(operation_id);
306
+
307
+ ALTER TABLE operations ADD COLUMN gas_used INTEGER;
308
+ ALTER TABLE operations ADD COLUMN gas_price_gwei REAL;
309
+ ALTER TABLE operations ADD COLUMN gas_cost_eth REAL;
310
+ ALTER TABLE operations ADD COLUMN trac_cost REAL;
311
+ ALTER TABLE operations ADD COLUMN tx_hash TEXT;
312
+ ALTER TABLE operations ADD COLUMN chain_id INTEGER;
313
313
  `);
314
314
  }
315
315
  if (version < 3) {
@@ -319,42 +319,42 @@ export class DashboardDB {
319
319
  // column + the partial unique index in one step; the V11 block
320
320
  // below idempotently adds the column to nodes that upgraded
321
321
  // through versions 3..10 first.
322
- this.db.exec(`
323
- CREATE TABLE IF NOT EXISTS chat_messages (
324
- id INTEGER PRIMARY KEY AUTOINCREMENT,
325
- ts INTEGER NOT NULL,
326
- direction TEXT NOT NULL,
327
- peer TEXT NOT NULL,
328
- peer_name TEXT,
329
- text TEXT NOT NULL,
330
- delivered INTEGER,
331
- message_id TEXT
332
- );
333
- CREATE INDEX IF NOT EXISTS idx_chat_ts ON chat_messages(ts);
334
- CREATE INDEX IF NOT EXISTS idx_chat_peer ON chat_messages(peer);
322
+ this.db.exec(`
323
+ CREATE TABLE IF NOT EXISTS chat_messages (
324
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
325
+ ts INTEGER NOT NULL,
326
+ direction TEXT NOT NULL,
327
+ peer TEXT NOT NULL,
328
+ peer_name TEXT,
329
+ text TEXT NOT NULL,
330
+ delivered INTEGER,
331
+ message_id TEXT
332
+ );
333
+ CREATE INDEX IF NOT EXISTS idx_chat_ts ON chat_messages(ts);
334
+ CREATE INDEX IF NOT EXISTS idx_chat_peer ON chat_messages(peer);
335
335
  `);
336
336
  }
337
337
  if (version < 4) {
338
- this.db.exec(`
339
- CREATE TABLE IF NOT EXISTS chat_persistence_jobs (
340
- turn_id TEXT PRIMARY KEY,
341
- session_id TEXT NOT NULL,
342
- user_message TEXT NOT NULL,
343
- assistant_reply TEXT NOT NULL,
344
- tool_calls_json TEXT,
345
- status TEXT NOT NULL,
346
- attempts INTEGER NOT NULL DEFAULT 0,
347
- max_attempts INTEGER NOT NULL DEFAULT 3,
348
- next_attempt_at INTEGER NOT NULL,
349
- queued_at INTEGER NOT NULL,
350
- updated_at INTEGER NOT NULL,
351
- store_ms INTEGER,
352
- error_message TEXT
353
- );
354
- CREATE INDEX IF NOT EXISTS idx_chat_persist_status_next
355
- ON chat_persistence_jobs(status, next_attempt_at);
356
- CREATE INDEX IF NOT EXISTS idx_chat_persist_session
357
- ON chat_persistence_jobs(session_id);
338
+ this.db.exec(`
339
+ CREATE TABLE IF NOT EXISTS chat_persistence_jobs (
340
+ turn_id TEXT PRIMARY KEY,
341
+ session_id TEXT NOT NULL,
342
+ user_message TEXT NOT NULL,
343
+ assistant_reply TEXT NOT NULL,
344
+ tool_calls_json TEXT,
345
+ status TEXT NOT NULL,
346
+ attempts INTEGER NOT NULL DEFAULT 0,
347
+ max_attempts INTEGER NOT NULL DEFAULT 3,
348
+ next_attempt_at INTEGER NOT NULL,
349
+ queued_at INTEGER NOT NULL,
350
+ updated_at INTEGER NOT NULL,
351
+ store_ms INTEGER,
352
+ error_message TEXT
353
+ );
354
+ CREATE INDEX IF NOT EXISTS idx_chat_persist_status_next
355
+ ON chat_persistence_jobs(status, next_attempt_at);
356
+ CREATE INDEX IF NOT EXISTS idx_chat_persist_session
357
+ ON chat_persistence_jobs(session_id);
358
358
  `);
359
359
  }
360
360
  if (version < 5) {
@@ -363,77 +363,77 @@ export class DashboardDB {
363
363
  // fresh-install CREATE so new nodes get the column + its index in one
364
364
  // step; the V16 block below idempotently adds it to nodes that upgraded
365
365
  // through versions 5..15 first (same pattern as `message_id` in V3/V11).
366
- this.db.exec(`
367
- CREATE TABLE IF NOT EXISTS notifications (
368
- id INTEGER PRIMARY KEY AUTOINCREMENT,
369
- ts INTEGER NOT NULL,
370
- type TEXT NOT NULL,
371
- title TEXT NOT NULL,
372
- message TEXT NOT NULL,
373
- source TEXT,
374
- peer TEXT,
375
- read INTEGER NOT NULL DEFAULT 0,
376
- meta TEXT,
377
- context_graph_id TEXT
378
- );
379
- CREATE INDEX IF NOT EXISTS idx_notif_ts ON notifications(ts);
380
- CREATE INDEX IF NOT EXISTS idx_notif_read ON notifications(read);
381
- CREATE INDEX IF NOT EXISTS idx_notif_cg ON notifications(context_graph_id);
366
+ this.db.exec(`
367
+ CREATE TABLE IF NOT EXISTS notifications (
368
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
369
+ ts INTEGER NOT NULL,
370
+ type TEXT NOT NULL,
371
+ title TEXT NOT NULL,
372
+ message TEXT NOT NULL,
373
+ source TEXT,
374
+ peer TEXT,
375
+ read INTEGER NOT NULL DEFAULT 0,
376
+ meta TEXT,
377
+ context_graph_id TEXT
378
+ );
379
+ CREATE INDEX IF NOT EXISTS idx_notif_ts ON notifications(ts);
380
+ CREATE INDEX IF NOT EXISTS idx_notif_read ON notifications(read);
381
+ CREATE INDEX IF NOT EXISTS idx_notif_cg ON notifications(context_graph_id);
382
382
  `);
383
383
  }
384
384
  if (version < 6) {
385
- this.db.exec(`
386
- CREATE TABLE IF NOT EXISTS settings (
387
- key TEXT PRIMARY KEY,
388
- value TEXT NOT NULL
389
- );
385
+ this.db.exec(`
386
+ CREATE TABLE IF NOT EXISTS settings (
387
+ key TEXT PRIMARY KEY,
388
+ value TEXT NOT NULL
389
+ );
390
390
  `);
391
391
  }
392
392
  if (version < 7) {
393
- this.db.exec(`
394
- CREATE TABLE IF NOT EXISTS context_graph_subscriptions (
395
- context_graph_id TEXT PRIMARY KEY,
396
- name TEXT,
397
- subscribed INTEGER NOT NULL,
398
- synced INTEGER NOT NULL,
399
- meta_synced INTEGER,
400
- on_chain_id TEXT,
401
- sync_scoped INTEGER NOT NULL DEFAULT 1,
402
- updated_at INTEGER NOT NULL
403
- );
404
- CREATE INDEX IF NOT EXISTS idx_cg_subs_sync_scoped
405
- ON context_graph_subscriptions(sync_scoped);
393
+ this.db.exec(`
394
+ CREATE TABLE IF NOT EXISTS context_graph_subscriptions (
395
+ context_graph_id TEXT PRIMARY KEY,
396
+ name TEXT,
397
+ subscribed INTEGER NOT NULL,
398
+ synced INTEGER NOT NULL,
399
+ meta_synced INTEGER,
400
+ on_chain_id TEXT,
401
+ sync_scoped INTEGER NOT NULL DEFAULT 1,
402
+ updated_at INTEGER NOT NULL
403
+ );
404
+ CREATE INDEX IF NOT EXISTS idx_cg_subs_sync_scoped
405
+ ON context_graph_subscriptions(sync_scoped);
406
406
  `);
407
407
  }
408
408
  if (version < 8) {
409
- this.db.exec(`
410
- CREATE TABLE IF NOT EXISTS context_graph_memberships (
411
- context_graph_id TEXT NOT NULL,
412
- principal_type TEXT NOT NULL,
413
- principal_id TEXT NOT NULL,
414
- role TEXT,
415
- status TEXT NOT NULL,
416
- source TEXT,
417
- display_name TEXT,
418
- metadata TEXT,
419
- first_seen_at INTEGER NOT NULL,
420
- updated_at INTEGER NOT NULL,
421
- PRIMARY KEY (context_graph_id, principal_type, principal_id)
422
- );
423
- CREATE INDEX IF NOT EXISTS idx_cg_members_context
424
- ON context_graph_memberships(context_graph_id);
425
- CREATE INDEX IF NOT EXISTS idx_cg_members_principal
426
- ON context_graph_memberships(principal_type, principal_id);
427
- CREATE INDEX IF NOT EXISTS idx_cg_members_status
428
- ON context_graph_memberships(status);
409
+ this.db.exec(`
410
+ CREATE TABLE IF NOT EXISTS context_graph_memberships (
411
+ context_graph_id TEXT NOT NULL,
412
+ principal_type TEXT NOT NULL,
413
+ principal_id TEXT NOT NULL,
414
+ role TEXT,
415
+ status TEXT NOT NULL,
416
+ source TEXT,
417
+ display_name TEXT,
418
+ metadata TEXT,
419
+ first_seen_at INTEGER NOT NULL,
420
+ updated_at INTEGER NOT NULL,
421
+ PRIMARY KEY (context_graph_id, principal_type, principal_id)
422
+ );
423
+ CREATE INDEX IF NOT EXISTS idx_cg_members_context
424
+ ON context_graph_memberships(context_graph_id);
425
+ CREATE INDEX IF NOT EXISTS idx_cg_members_principal
426
+ ON context_graph_memberships(principal_type, principal_id);
427
+ CREATE INDEX IF NOT EXISTS idx_cg_members_status
428
+ ON context_graph_memberships(status);
429
429
  `);
430
430
  }
431
431
  if (version < 9) {
432
432
  const columns = this.db.prepare('PRAGMA table_info(context_graph_subscriptions)').all();
433
433
  if (!columns.some((column) => column.name === 'shared_memory_synced')) {
434
- this.db.exec(`
435
- ALTER TABLE context_graph_subscriptions
436
- ADD COLUMN shared_memory_synced INTEGER;
434
+ this.db.exec(`
435
+ ALTER TABLE context_graph_subscriptions
436
+ ADD COLUMN shared_memory_synced INTEGER;
437
437
  `);
438
438
  }
439
439
  }
@@ -502,10 +502,10 @@ export class DashboardDB {
502
502
  if (!chatCols.has('message_id')) {
503
503
  this.db.exec(`ALTER TABLE chat_messages ADD COLUMN message_id TEXT;`);
504
504
  }
505
- this.db.exec(`
506
- CREATE UNIQUE INDEX IF NOT EXISTS idx_chat_msgid
507
- ON chat_messages(peer, direction, message_id)
508
- WHERE message_id IS NOT NULL;
505
+ this.db.exec(`
506
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_chat_msgid
507
+ ON chat_messages(peer, direction, message_id)
508
+ WHERE message_id IS NOT NULL;
509
509
  `);
510
510
  }
511
511
  if (version < 12) {
@@ -561,33 +561,33 @@ export class DashboardDB {
561
561
  // `message_id` is enforced via `message_idempotency` instead.
562
562
  // V13 will also preserve `chat_messages.message_id` as
563
563
  // nullable + unwritten for rollback safety.
564
- this.db.exec(`
565
- CREATE TABLE IF NOT EXISTS message_idempotency (
566
- peer_id TEXT NOT NULL,
567
- protocol TEXT NOT NULL,
568
- message_id TEXT NOT NULL,
569
- direction TEXT NOT NULL CHECK (direction IN ('in', 'out')),
570
- response_blob BLOB,
571
- response_size INTEGER NOT NULL DEFAULT 0,
572
- ts INTEGER NOT NULL,
573
- PRIMARY KEY (peer_id, protocol, message_id, direction)
574
- );
575
- CREATE INDEX IF NOT EXISTS idx_idem_ts ON message_idempotency(ts);
576
-
577
- CREATE TABLE IF NOT EXISTS protocol_outbox (
578
- peer_id TEXT NOT NULL,
579
- protocol TEXT NOT NULL,
580
- message_id TEXT NOT NULL,
581
- payload BLOB NOT NULL,
582
- attempts INTEGER NOT NULL DEFAULT 0,
583
- first_failure_at INTEGER NOT NULL,
584
- last_attempt_at INTEGER NOT NULL,
585
- next_attempt_at INTEGER NOT NULL,
586
- last_error TEXT,
587
- PRIMARY KEY (peer_id, protocol, message_id)
588
- );
589
- CREATE INDEX IF NOT EXISTS idx_outbox_next_attempt
590
- ON protocol_outbox(next_attempt_at);
564
+ this.db.exec(`
565
+ CREATE TABLE IF NOT EXISTS message_idempotency (
566
+ peer_id TEXT NOT NULL,
567
+ protocol TEXT NOT NULL,
568
+ message_id TEXT NOT NULL,
569
+ direction TEXT NOT NULL CHECK (direction IN ('in', 'out')),
570
+ response_blob BLOB,
571
+ response_size INTEGER NOT NULL DEFAULT 0,
572
+ ts INTEGER NOT NULL,
573
+ PRIMARY KEY (peer_id, protocol, message_id, direction)
574
+ );
575
+ CREATE INDEX IF NOT EXISTS idx_idem_ts ON message_idempotency(ts);
576
+
577
+ CREATE TABLE IF NOT EXISTS protocol_outbox (
578
+ peer_id TEXT NOT NULL,
579
+ protocol TEXT NOT NULL,
580
+ message_id TEXT NOT NULL,
581
+ payload BLOB NOT NULL,
582
+ attempts INTEGER NOT NULL DEFAULT 0,
583
+ first_failure_at INTEGER NOT NULL,
584
+ last_attempt_at INTEGER NOT NULL,
585
+ next_attempt_at INTEGER NOT NULL,
586
+ last_error TEXT,
587
+ PRIMARY KEY (peer_id, protocol, message_id)
588
+ );
589
+ CREATE INDEX IF NOT EXISTS idx_outbox_next_attempt
590
+ ON protocol_outbox(next_attempt_at);
591
591
  `);
592
592
  }
593
593
  if (version < 13) {
@@ -612,8 +612,8 @@ export class DashboardDB {
612
612
  // table rebuild on downgrade.
613
613
  //
614
614
  // No data migration. No new tables. Pure DROP INDEX.
615
- this.db.exec(`
616
- DROP INDEX IF EXISTS idx_chat_msgid;
615
+ this.db.exec(`
616
+ DROP INDEX IF EXISTS idx_chat_msgid;
617
617
  `);
618
618
  }
619
619
  if (version < 14) {
@@ -654,10 +654,10 @@ export class DashboardDB {
654
654
  // operation-correlated log views (`getOperation`,
655
655
  // `getFailedOperations`). Substring/text search moves to
656
656
  // /api/node-log, which already supports `?q=`.
657
- this.db.exec(`
658
- DROP TRIGGER IF EXISTS logs_ai;
659
- DROP TRIGGER IF EXISTS logs_ad;
660
- DROP TABLE IF EXISTS logs_fts;
657
+ this.db.exec(`
658
+ DROP TRIGGER IF EXISTS logs_ai;
659
+ DROP TRIGGER IF EXISTS logs_ad;
660
+ DROP TABLE IF EXISTS logs_fts;
661
661
  `);
662
662
  // VACUUM cannot run inside a transaction; better-sqlite3 wraps
663
663
  // multi-statement exec() in implicit BEGIN/COMMIT, so we issue
@@ -721,23 +721,23 @@ export class DashboardDB {
721
721
  // re-parsing the daemon log. One row per decision point (sweep / fetch /
722
722
  // promote / already / defer / cursor-advance / core-fill). Pruned by `ts`
723
723
  // like the other event tables.
724
- this.db.exec(`
725
- CREATE TABLE IF NOT EXISTS replication_events (
726
- id INTEGER PRIMARY KEY AUTOINCREMENT,
727
- ts INTEGER NOT NULL,
728
- context_graph_id TEXT NOT NULL,
729
- on_chain_cg_id TEXT,
730
- action TEXT NOT NULL,
731
- ual TEXT,
732
- ordinal INTEGER,
733
- ka_id TEXT,
734
- from_watermark INTEGER,
735
- to_watermark INTEGER,
736
- head INTEGER,
737
- reconciled INTEGER,
738
- pending INTEGER,
739
- detail TEXT
740
- );
724
+ this.db.exec(`
725
+ CREATE TABLE IF NOT EXISTS replication_events (
726
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
727
+ ts INTEGER NOT NULL,
728
+ context_graph_id TEXT NOT NULL,
729
+ on_chain_cg_id TEXT,
730
+ action TEXT NOT NULL,
731
+ ual TEXT,
732
+ ordinal INTEGER,
733
+ ka_id TEXT,
734
+ from_watermark INTEGER,
735
+ to_watermark INTEGER,
736
+ head INTEGER,
737
+ reconciled INTEGER,
738
+ pending INTEGER,
739
+ detail TEXT
740
+ );
741
741
  `);
742
742
  this.db.exec(`CREATE INDEX IF NOT EXISTS idx_repl_ts ON replication_events(ts);`);
743
743
  this.db.exec(`CREATE INDEX IF NOT EXISTS idx_repl_cg ON replication_events(context_graph_id, ts);`);
@@ -776,54 +776,54 @@ export class DashboardDB {
776
776
  // the 2^63 INTEGER max and under the uint96 on-chain field. Like
777
777
  // `protocol_outbox`, this state is durable and is NEVER pruned —
778
778
  // reclaiming a number could mint a duplicate kaId.
779
- this.db.exec(`
780
- CREATE TABLE IF NOT EXISTS ka_numbers (
781
- author_address TEXT PRIMARY KEY,
782
- next_number INTEGER NOT NULL
783
- );
779
+ this.db.exec(`
780
+ CREATE TABLE IF NOT EXISTS ka_numbers (
781
+ author_address TEXT PRIMARY KEY,
782
+ next_number INTEGER NOT NULL
783
+ );
784
784
  `);
785
785
  }
786
786
  if (version < 21) {
787
- this.db.exec(`
788
- CREATE TABLE IF NOT EXISTS sync_checkpoints (
789
- key TEXT PRIMARY KEY,
790
- offset INTEGER NOT NULL CHECK (offset >= 0),
791
- updated_at INTEGER NOT NULL,
792
- expires_at INTEGER NOT NULL
793
- );
794
- CREATE INDEX IF NOT EXISTS idx_sync_checkpoints_expires_at
795
- ON sync_checkpoints(expires_at);
787
+ this.db.exec(`
788
+ CREATE TABLE IF NOT EXISTS sync_checkpoints (
789
+ key TEXT PRIMARY KEY,
790
+ offset INTEGER NOT NULL CHECK (offset >= 0),
791
+ updated_at INTEGER NOT NULL,
792
+ expires_at INTEGER NOT NULL
793
+ );
794
+ CREATE INDEX IF NOT EXISTS idx_sync_checkpoints_expires_at
795
+ ON sync_checkpoints(expires_at);
796
796
  `);
797
797
  }
798
798
  if (version < 22) {
799
- this.db.exec(`
800
- CREATE TABLE IF NOT EXISTS runtime_cursors (
801
- namespace TEXT NOT NULL,
802
- scope TEXT NOT NULL,
803
- key TEXT NOT NULL,
804
- value INTEGER NOT NULL CHECK (value > 0),
805
- updated_at INTEGER NOT NULL,
806
- PRIMARY KEY (namespace, scope, key)
807
- );
799
+ this.db.exec(`
800
+ CREATE TABLE IF NOT EXISTS runtime_cursors (
801
+ namespace TEXT NOT NULL,
802
+ scope TEXT NOT NULL,
803
+ key TEXT NOT NULL,
804
+ value INTEGER NOT NULL CHECK (value > 0),
805
+ updated_at INTEGER NOT NULL,
806
+ PRIMARY KEY (namespace, scope, key)
807
+ );
808
808
  `);
809
- this.db.exec(`
810
- CREATE INDEX IF NOT EXISTS idx_runtime_cursors_namespace_scope
811
- ON runtime_cursors(namespace, scope);
809
+ this.db.exec(`
810
+ CREATE INDEX IF NOT EXISTS idx_runtime_cursors_namespace_scope
811
+ ON runtime_cursors(namespace, scope);
812
812
  `);
813
813
  }
814
814
  if (version < 23) {
815
815
  // OT-RFC-59 SC5: durable per-(peer, contextGraph) changelog cursor. NEVER
816
816
  // pruned (see SqliteChangelogCursorStore) — a TTL would defeat the O(delta)
817
817
  // cross-restart catch-up this table exists for.
818
- this.db.exec(`
819
- CREATE TABLE IF NOT EXISTS changelog_cursors (
820
- peer_id TEXT NOT NULL,
821
- context_graph_id TEXT NOT NULL,
822
- era TEXT NOT NULL,
823
- seq INTEGER NOT NULL CHECK (seq >= 0),
824
- updated_at INTEGER NOT NULL,
825
- PRIMARY KEY (peer_id, context_graph_id)
826
- );
818
+ this.db.exec(`
819
+ CREATE TABLE IF NOT EXISTS changelog_cursors (
820
+ peer_id TEXT NOT NULL,
821
+ context_graph_id TEXT NOT NULL,
822
+ era TEXT NOT NULL,
823
+ seq INTEGER NOT NULL CHECK (seq >= 0),
824
+ updated_at INTEGER NOT NULL,
825
+ PRIMARY KEY (peer_id, context_graph_id)
826
+ );
827
827
  `);
828
828
  }
829
829
  if (version < 24) {
@@ -832,39 +832,39 @@ export class DashboardDB {
832
832
  // `store.nq` restore does NOT roll back with the RDF store. node-ui.db
833
833
  // survives such a restore, so a rollback under the same era rotates the era
834
834
  // (forcing peers to full-resync instead of silently skipping). Single row.
835
- this.db.exec(`
836
- CREATE TABLE IF NOT EXISTS changelog_era (
837
- id INTEGER PRIMARY KEY CHECK (id = 1),
838
- era TEXT NOT NULL,
839
- high_seq INTEGER NOT NULL CHECK (high_seq >= 0),
840
- updated_at INTEGER NOT NULL
841
- );
835
+ this.db.exec(`
836
+ CREATE TABLE IF NOT EXISTS changelog_era (
837
+ id INTEGER PRIMARY KEY CHECK (id = 1),
838
+ era TEXT NOT NULL,
839
+ high_seq INTEGER NOT NULL CHECK (high_seq >= 0),
840
+ updated_at INTEGER NOT NULL
841
+ );
842
842
  `);
843
843
  }
844
844
  if (version < 25) {
845
845
  // Durable security audit for private-CG open enrollment. V25/V26 also
846
846
  // used this table as admission state; V27 projects those legacy rows into
847
847
  // the typed operational ledger below.
848
- this.db.exec(`
849
- CREATE TABLE IF NOT EXISTS context_graph_join_policy_audit (
850
- id INTEGER PRIMARY KEY AUTOINCREMENT,
851
- ts INTEGER NOT NULL,
852
- context_graph_id TEXT NOT NULL,
853
- event_type TEXT NOT NULL,
854
- actor TEXT,
855
- agent_address TEXT,
856
- outcome TEXT NOT NULL,
857
- reason TEXT,
858
- request_digest TEXT,
859
- policy_version INTEGER,
860
- details TEXT
861
- );
862
- CREATE INDEX IF NOT EXISTS idx_cg_join_policy_audit_ts
863
- ON context_graph_join_policy_audit(ts);
864
- CREATE INDEX IF NOT EXISTS idx_cg_join_policy_audit_cg_ts
865
- ON context_graph_join_policy_audit(context_graph_id, ts);
866
- CREATE INDEX IF NOT EXISTS idx_cg_join_policy_audit_event_ts
867
- ON context_graph_join_policy_audit(event_type, ts);
848
+ this.db.exec(`
849
+ CREATE TABLE IF NOT EXISTS context_graph_join_policy_audit (
850
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
851
+ ts INTEGER NOT NULL,
852
+ context_graph_id TEXT NOT NULL,
853
+ event_type TEXT NOT NULL,
854
+ actor TEXT,
855
+ agent_address TEXT,
856
+ outcome TEXT NOT NULL,
857
+ reason TEXT,
858
+ request_digest TEXT,
859
+ policy_version INTEGER,
860
+ details TEXT
861
+ );
862
+ CREATE INDEX IF NOT EXISTS idx_cg_join_policy_audit_ts
863
+ ON context_graph_join_policy_audit(ts);
864
+ CREATE INDEX IF NOT EXISTS idx_cg_join_policy_audit_cg_ts
865
+ ON context_graph_join_policy_audit(context_graph_id, ts);
866
+ CREATE INDEX IF NOT EXISTS idx_cg_join_policy_audit_event_ts
867
+ ON context_graph_join_policy_audit(event_type, ts);
868
868
  `);
869
869
  }
870
870
  if (version < 26) {
@@ -883,108 +883,108 @@ export class DashboardDB {
883
883
  // Operational admission state is deliberately separate from the audit
884
884
  // stream. Audit retention and event naming must never alter rate-limit,
885
885
  // epoch, or commit-idempotency behaviour.
886
- this.db.exec(`
887
- CREATE TABLE IF NOT EXISTS context_graph_join_approval_ledger (
888
- context_graph_id TEXT NOT NULL,
889
- request_digest TEXT NOT NULL,
890
- policy_epoch INTEGER NOT NULL,
891
- reserved_at INTEGER NOT NULL,
892
- state TEXT NOT NULL CHECK (state IN ('reserved', 'committed')),
893
- committed_at INTEGER,
894
- actor TEXT NOT NULL,
895
- agent_address TEXT NOT NULL,
896
- policy_version INTEGER NOT NULL,
897
- PRIMARY KEY (context_graph_id, request_digest, policy_epoch),
898
- CHECK (length(context_graph_id) > 0),
899
- CHECK (length(request_digest) > 0),
900
- CHECK (typeof(policy_epoch) = 'integer'),
901
- CHECK (typeof(reserved_at) = 'integer'),
902
- CHECK (committed_at IS NULL OR typeof(committed_at) = 'integer'),
903
- CHECK (typeof(policy_version) = 'integer'),
904
- CHECK (
905
- (state = 'reserved' AND committed_at IS NULL)
906
- OR (state = 'committed' AND committed_at IS NOT NULL)
907
- )
908
- );
909
- CREATE INDEX IF NOT EXISTS idx_cg_join_approval_ledger_reserved_at
910
- ON context_graph_join_approval_ledger(reserved_at);
911
- CREATE INDEX IF NOT EXISTS idx_cg_join_approval_ledger_cg_reserved_at
912
- ON context_graph_join_approval_ledger(context_graph_id, reserved_at);
913
- CREATE INDEX IF NOT EXISTS idx_cg_join_approval_ledger_digest_reserved_at
914
- ON context_graph_join_approval_ledger(context_graph_id, request_digest, reserved_at DESC);
915
- CREATE INDEX IF NOT EXISTS idx_cg_join_approval_ledger_committed_at
916
- ON context_graph_join_approval_ledger(committed_at);
886
+ this.db.exec(`
887
+ CREATE TABLE IF NOT EXISTS context_graph_join_approval_ledger (
888
+ context_graph_id TEXT NOT NULL,
889
+ request_digest TEXT NOT NULL,
890
+ policy_epoch INTEGER NOT NULL,
891
+ reserved_at INTEGER NOT NULL,
892
+ state TEXT NOT NULL CHECK (state IN ('reserved', 'committed')),
893
+ committed_at INTEGER,
894
+ actor TEXT NOT NULL,
895
+ agent_address TEXT NOT NULL,
896
+ policy_version INTEGER NOT NULL,
897
+ PRIMARY KEY (context_graph_id, request_digest, policy_epoch),
898
+ CHECK (length(context_graph_id) > 0),
899
+ CHECK (length(request_digest) > 0),
900
+ CHECK (typeof(policy_epoch) = 'integer'),
901
+ CHECK (typeof(reserved_at) = 'integer'),
902
+ CHECK (committed_at IS NULL OR typeof(committed_at) = 'integer'),
903
+ CHECK (typeof(policy_version) = 'integer'),
904
+ CHECK (
905
+ (state = 'reserved' AND committed_at IS NULL)
906
+ OR (state = 'committed' AND committed_at IS NOT NULL)
907
+ )
908
+ );
909
+ CREATE INDEX IF NOT EXISTS idx_cg_join_approval_ledger_reserved_at
910
+ ON context_graph_join_approval_ledger(reserved_at);
911
+ CREATE INDEX IF NOT EXISTS idx_cg_join_approval_ledger_cg_reserved_at
912
+ ON context_graph_join_approval_ledger(context_graph_id, reserved_at);
913
+ CREATE INDEX IF NOT EXISTS idx_cg_join_approval_ledger_digest_reserved_at
914
+ ON context_graph_join_approval_ledger(context_graph_id, request_digest, reserved_at DESC);
915
+ CREATE INDEX IF NOT EXISTS idx_cg_join_approval_ledger_committed_at
916
+ ON context_graph_join_approval_ledger(committed_at);
917
917
  `);
918
918
  // Best-effort one-time projection for V25/V26 databases. Invalid legacy
919
919
  // JSON cannot abort startup; only rows with a typed numeric epoch can be
920
920
  // authoritative operational state. For duplicate audit reservations,
921
921
  // retain the newest row for each (CG, digest, epoch).
922
- this.db.exec(`
923
- WITH raw_reservations AS (
924
- SELECT
925
- id,
926
- context_graph_id,
927
- request_digest,
928
- CASE
929
- WHEN json_valid(details)
930
- AND json_type(details, '$.policyEpoch') IN ('integer', 'real')
931
- THEN CAST(json_extract(details, '$.policyEpoch') AS INTEGER)
932
- ELSE NULL
933
- END AS policy_epoch,
934
- ts AS reserved_at,
935
- COALESCE(actor, '') AS actor,
936
- COALESCE(agent_address, '') AS agent_address,
937
- COALESCE(policy_version, 1) AS policy_version
938
- FROM context_graph_join_policy_audit
939
- WHERE event_type = 'join_auto_reservation'
940
- AND outcome = 'reserved'
941
- AND request_digest IS NOT NULL
942
- ),
943
- ranked_reservations AS (
944
- SELECT *, ROW_NUMBER() OVER (
945
- PARTITION BY context_graph_id, request_digest, policy_epoch
946
- ORDER BY reserved_at DESC, id DESC
947
- ) AS rank
948
- FROM raw_reservations
949
- WHERE policy_epoch IS NOT NULL
950
- ),
951
- raw_commits AS (
952
- SELECT
953
- context_graph_id,
954
- request_digest,
955
- CASE
956
- WHEN json_valid(details)
957
- AND json_type(details, '$.policyEpoch') IN ('integer', 'real')
958
- THEN CAST(json_extract(details, '$.policyEpoch') AS INTEGER)
959
- ELSE NULL
960
- END AS policy_epoch,
961
- MIN(ts) AS committed_at
962
- FROM context_graph_join_policy_audit
963
- WHERE event_type = 'join_admission_committed'
964
- AND outcome = 'approved'
965
- AND request_digest IS NOT NULL
966
- GROUP BY context_graph_id, request_digest, policy_epoch
967
- )
968
- INSERT OR IGNORE INTO context_graph_join_approval_ledger (
969
- context_graph_id, request_digest, policy_epoch, reserved_at,
970
- state, committed_at, actor, agent_address, policy_version
971
- )
972
- SELECT
973
- reservation.context_graph_id,
974
- reservation.request_digest,
975
- reservation.policy_epoch,
976
- reservation.reserved_at,
977
- CASE WHEN commit_row.committed_at IS NULL THEN 'reserved' ELSE 'committed' END,
978
- commit_row.committed_at,
979
- reservation.actor,
980
- reservation.agent_address,
981
- reservation.policy_version
982
- FROM ranked_reservations AS reservation
983
- LEFT JOIN raw_commits AS commit_row
984
- ON commit_row.context_graph_id = reservation.context_graph_id
985
- AND commit_row.request_digest = reservation.request_digest
986
- AND commit_row.policy_epoch = reservation.policy_epoch
987
- WHERE reservation.rank = 1;
922
+ this.db.exec(`
923
+ WITH raw_reservations AS (
924
+ SELECT
925
+ id,
926
+ context_graph_id,
927
+ request_digest,
928
+ CASE
929
+ WHEN json_valid(details)
930
+ AND json_type(details, '$.policyEpoch') IN ('integer', 'real')
931
+ THEN CAST(json_extract(details, '$.policyEpoch') AS INTEGER)
932
+ ELSE NULL
933
+ END AS policy_epoch,
934
+ ts AS reserved_at,
935
+ COALESCE(actor, '') AS actor,
936
+ COALESCE(agent_address, '') AS agent_address,
937
+ COALESCE(policy_version, 1) AS policy_version
938
+ FROM context_graph_join_policy_audit
939
+ WHERE event_type = 'join_auto_reservation'
940
+ AND outcome = 'reserved'
941
+ AND request_digest IS NOT NULL
942
+ ),
943
+ ranked_reservations AS (
944
+ SELECT *, ROW_NUMBER() OVER (
945
+ PARTITION BY context_graph_id, request_digest, policy_epoch
946
+ ORDER BY reserved_at DESC, id DESC
947
+ ) AS rank
948
+ FROM raw_reservations
949
+ WHERE policy_epoch IS NOT NULL
950
+ ),
951
+ raw_commits AS (
952
+ SELECT
953
+ context_graph_id,
954
+ request_digest,
955
+ CASE
956
+ WHEN json_valid(details)
957
+ AND json_type(details, '$.policyEpoch') IN ('integer', 'real')
958
+ THEN CAST(json_extract(details, '$.policyEpoch') AS INTEGER)
959
+ ELSE NULL
960
+ END AS policy_epoch,
961
+ MIN(ts) AS committed_at
962
+ FROM context_graph_join_policy_audit
963
+ WHERE event_type = 'join_admission_committed'
964
+ AND outcome = 'approved'
965
+ AND request_digest IS NOT NULL
966
+ GROUP BY context_graph_id, request_digest, policy_epoch
967
+ )
968
+ INSERT OR IGNORE INTO context_graph_join_approval_ledger (
969
+ context_graph_id, request_digest, policy_epoch, reserved_at,
970
+ state, committed_at, actor, agent_address, policy_version
971
+ )
972
+ SELECT
973
+ reservation.context_graph_id,
974
+ reservation.request_digest,
975
+ reservation.policy_epoch,
976
+ reservation.reserved_at,
977
+ CASE WHEN commit_row.committed_at IS NULL THEN 'reserved' ELSE 'committed' END,
978
+ commit_row.committed_at,
979
+ reservation.actor,
980
+ reservation.agent_address,
981
+ reservation.policy_version
982
+ FROM ranked_reservations AS reservation
983
+ LEFT JOIN raw_commits AS commit_row
984
+ ON commit_row.context_graph_id = reservation.context_graph_id
985
+ AND commit_row.request_digest = reservation.request_digest
986
+ AND commit_row.policy_epoch = reservation.policy_epoch
987
+ WHERE reservation.rank = 1;
988
988
  `);
989
989
  // V26's trigger protected live reservation audit rows because they were
990
990
  // operational state. The ledger makes that coupling obsolete, so replace
@@ -1002,21 +1002,21 @@ export class DashboardDB {
1002
1002
  // idempotent and keeps the audit bound fail-closed on every open.
1003
1003
  ensureJoinPolicyAuditCapTrigger();
1004
1004
  if (version < 29) {
1005
- this.db.exec(`
1006
- CREATE TABLE IF NOT EXISTS vm_reconcile_negative_cache (
1007
- cache_key TEXT PRIMARY KEY,
1008
- context_graph_id TEXT NOT NULL,
1009
- failures INTEGER NOT NULL,
1010
- next_retry_at INTEGER NOT NULL,
1011
- swm_gen TEXT NOT NULL,
1012
- candidate_namespaces TEXT NOT NULL,
1013
- peer_topology_key TEXT NOT NULL,
1014
- updated_at INTEGER NOT NULL
1015
- );
1016
- CREATE INDEX IF NOT EXISTS idx_vm_reconcile_negative_cg
1017
- ON vm_reconcile_negative_cache(context_graph_id);
1018
- CREATE INDEX IF NOT EXISTS idx_vm_reconcile_negative_retry
1019
- ON vm_reconcile_negative_cache(next_retry_at);
1005
+ this.db.exec(`
1006
+ CREATE TABLE IF NOT EXISTS vm_reconcile_negative_cache (
1007
+ cache_key TEXT PRIMARY KEY,
1008
+ context_graph_id TEXT NOT NULL,
1009
+ failures INTEGER NOT NULL,
1010
+ next_retry_at INTEGER NOT NULL,
1011
+ swm_gen TEXT NOT NULL,
1012
+ candidate_namespaces TEXT NOT NULL,
1013
+ peer_topology_key TEXT NOT NULL,
1014
+ updated_at INTEGER NOT NULL
1015
+ );
1016
+ CREATE INDEX IF NOT EXISTS idx_vm_reconcile_negative_cg
1017
+ ON vm_reconcile_negative_cache(context_graph_id);
1018
+ CREATE INDEX IF NOT EXISTS idx_vm_reconcile_negative_retry
1019
+ ON vm_reconcile_negative_cache(next_retry_at);
1020
1020
  `);
1021
1021
  }
1022
1022
  if (version < 30) {
@@ -1025,6 +1025,24 @@ export class DashboardDB {
1025
1025
  // restart can resume that same list instead of discarding durable work.
1026
1026
  ensureSyncCheckpointResponderSessionColumns();
1027
1027
  }
1028
+ if (version < 31) {
1029
+ this.db.exec(`
1030
+ CREATE TABLE IF NOT EXISTS snapshot_page_indexes (
1031
+ snapshot_digest TEXT PRIMARY KEY,
1032
+ format_version INTEGER NOT NULL CHECK (format_version > 0),
1033
+ stride INTEGER NOT NULL CHECK (stride > 0),
1034
+ snapshot_file_size INTEGER NOT NULL CHECK (snapshot_file_size >= 0),
1035
+ modification_fingerprint TEXT NOT NULL,
1036
+ offset_count INTEGER NOT NULL CHECK (offset_count > 0),
1037
+ offsets BLOB NOT NULL,
1038
+ checksum TEXT NOT NULL,
1039
+ CHECK (length(snapshot_digest) > 0),
1040
+ CHECK (length(modification_fingerprint) > 0),
1041
+ CHECK (length(offsets) = offset_count * 8),
1042
+ CHECK (length(checksum) > 0)
1043
+ );
1044
+ `);
1045
+ }
1028
1046
  this.db.pragma(`user_version = ${SCHEMA_VERSION}`);
1029
1047
  if (upgradedExistingDb && !this.explicitRetentionDays) {
1030
1048
  this.retentionDays = LEGACY_IMPLICIT_RETENTION_DAYS;
@@ -1062,10 +1080,10 @@ export class DashboardDB {
1062
1080
  // not depend on whether the corresponding audit rows still exist. Preserve
1063
1081
  // the historical retention envelope for durable commit idempotency while
1064
1082
  // allowing fully expired reservation/commit state to age out.
1065
- this.db.prepare(`
1066
- DELETE FROM context_graph_join_approval_ledger
1067
- WHERE reserved_at < ?
1068
- AND (committed_at IS NULL OR committed_at < ?)
1083
+ this.db.prepare(`
1084
+ DELETE FROM context_graph_join_approval_ledger
1085
+ WHERE reserved_at < ?
1086
+ AND (committed_at IS NULL OR committed_at < ?)
1069
1087
  `).run(cutoff, cutoff);
1070
1088
  this.db.prepare(`DELETE FROM sync_checkpoints WHERE expires_at < ?`).run(Date.now());
1071
1089
  // Reconcile negatives are accelerators, never historical records. Once the
@@ -1118,16 +1136,16 @@ export class DashboardDB {
1118
1136
  : 'done',
1119
1137
  };
1120
1138
  }
1121
- const deleted = this.db.prepare(`
1122
- DELETE FROM logs
1123
- WHERE id IN (
1124
- SELECT id
1125
- FROM logs
1126
- WHERE id <= @cutoff
1127
- AND level NOT IN ('warn', 'error')
1128
- ORDER BY id ASC
1129
- LIMIT @batchRows
1130
- )
1139
+ const deleted = this.db.prepare(`
1140
+ DELETE FROM logs
1141
+ WHERE id IN (
1142
+ SELECT id
1143
+ FROM logs
1144
+ WHERE id <= @cutoff
1145
+ AND level NOT IN ('warn', 'error')
1146
+ ORDER BY id ASC
1147
+ LIMIT @batchRows
1148
+ )
1131
1149
  `).run({
1132
1150
  cutoff: overflowCutoff,
1133
1151
  batchRows: this.logVolumePruneBatchRows,
@@ -1153,12 +1171,12 @@ export class DashboardDB {
1153
1171
  };
1154
1172
  }
1155
1173
  routineLogOverflowCutoff() {
1156
- const row = this.db.prepare(`
1157
- SELECT id
1158
- FROM logs
1159
- WHERE level NOT IN ('warn', 'error')
1160
- ORDER BY id DESC
1161
- LIMIT 1 OFFSET ?
1174
+ const row = this.db.prepare(`
1175
+ SELECT id
1176
+ FROM logs
1177
+ WHERE level NOT IN ('warn', 'error')
1178
+ ORDER BY id DESC
1179
+ LIMIT 1 OFFSET ?
1162
1180
  `).get(this.routineLogRowCap);
1163
1181
  return row?.id ?? null;
1164
1182
  }
@@ -1259,50 +1277,50 @@ export class DashboardDB {
1259
1277
  }
1260
1278
  // --- Metric snapshots ---
1261
1279
  insertSnapshot(snap) {
1262
- this.stmt('insertSnapshot', `
1263
- INSERT INTO metric_snapshots (
1264
- ts, cpu_percent, mem_used_bytes, mem_total_bytes,
1265
- disk_used_bytes, disk_total_bytes, heap_used_bytes, uptime_seconds,
1266
- peer_count, direct_peers, relayed_peers, mesh_peers, contextGraph_count,
1267
- total_triples, total_kcs, total_kas, store_bytes,
1268
- confirmed_kcs, tentative_kcs, rpc_latency_ms, rpc_healthy,
1269
- relay_capacity, relay_reservation_count, relay_active_circuits,
1270
- relay_bytes_in, relay_bytes_out
1271
- ) VALUES (
1272
- @ts, @cpu_percent, @mem_used_bytes, @mem_total_bytes,
1273
- @disk_used_bytes, @disk_total_bytes, @heap_used_bytes, @uptime_seconds,
1274
- @peer_count, @direct_peers, @relayed_peers, @mesh_peers, @contextGraph_count,
1275
- @total_triples, @total_kcs, @total_kas, @store_bytes,
1276
- @confirmed_kcs, @tentative_kcs, @rpc_latency_ms, @rpc_healthy,
1277
- @relay_capacity, @relay_reservation_count, @relay_active_circuits,
1278
- @relay_bytes_in, @relay_bytes_out
1279
- )
1280
+ this.stmt('insertSnapshot', `
1281
+ INSERT INTO metric_snapshots (
1282
+ ts, cpu_percent, mem_used_bytes, mem_total_bytes,
1283
+ disk_used_bytes, disk_total_bytes, heap_used_bytes, uptime_seconds,
1284
+ peer_count, direct_peers, relayed_peers, mesh_peers, contextGraph_count,
1285
+ total_triples, total_kcs, total_kas, store_bytes,
1286
+ confirmed_kcs, tentative_kcs, rpc_latency_ms, rpc_healthy,
1287
+ relay_capacity, relay_reservation_count, relay_active_circuits,
1288
+ relay_bytes_in, relay_bytes_out
1289
+ ) VALUES (
1290
+ @ts, @cpu_percent, @mem_used_bytes, @mem_total_bytes,
1291
+ @disk_used_bytes, @disk_total_bytes, @heap_used_bytes, @uptime_seconds,
1292
+ @peer_count, @direct_peers, @relayed_peers, @mesh_peers, @contextGraph_count,
1293
+ @total_triples, @total_kcs, @total_kas, @store_bytes,
1294
+ @confirmed_kcs, @tentative_kcs, @rpc_latency_ms, @rpc_healthy,
1295
+ @relay_capacity, @relay_reservation_count, @relay_active_circuits,
1296
+ @relay_bytes_in, @relay_bytes_out
1297
+ )
1280
1298
  `).run(snap);
1281
1299
  }
1282
1300
  getLatestSnapshot() {
1283
1301
  return this.db.prepare('SELECT * FROM metric_snapshots ORDER BY ts DESC LIMIT 1').get();
1284
1302
  }
1285
1303
  upsertContextGraphSubscription(record) {
1286
- this.stmt('upsertContextGraphSubscription', `
1287
- INSERT INTO context_graph_subscriptions (
1288
- context_graph_id, name, subscribed, synced, shared_memory_synced, meta_synced,
1289
- on_chain_id, on_chain_hash, last_reconciled_ordinal, core_hosted, sync_scoped, updated_at
1290
- ) VALUES (
1291
- @context_graph_id, @name, @subscribed, @synced, @shared_memory_synced, @meta_synced,
1292
- @on_chain_id, @on_chain_hash, @last_reconciled_ordinal, @core_hosted, @sync_scoped, @updated_at
1293
- )
1294
- ON CONFLICT(context_graph_id) DO UPDATE SET
1295
- name = excluded.name,
1296
- subscribed = excluded.subscribed,
1297
- synced = excluded.synced,
1298
- shared_memory_synced = excluded.shared_memory_synced,
1299
- meta_synced = excluded.meta_synced,
1300
- on_chain_id = excluded.on_chain_id,
1301
- on_chain_hash = excluded.on_chain_hash,
1302
- last_reconciled_ordinal = excluded.last_reconciled_ordinal,
1303
- core_hosted = excluded.core_hosted,
1304
- sync_scoped = excluded.sync_scoped,
1305
- updated_at = excluded.updated_at
1304
+ this.stmt('upsertContextGraphSubscription', `
1305
+ INSERT INTO context_graph_subscriptions (
1306
+ context_graph_id, name, subscribed, synced, shared_memory_synced, meta_synced,
1307
+ on_chain_id, on_chain_hash, last_reconciled_ordinal, core_hosted, sync_scoped, updated_at
1308
+ ) VALUES (
1309
+ @context_graph_id, @name, @subscribed, @synced, @shared_memory_synced, @meta_synced,
1310
+ @on_chain_id, @on_chain_hash, @last_reconciled_ordinal, @core_hosted, @sync_scoped, @updated_at
1311
+ )
1312
+ ON CONFLICT(context_graph_id) DO UPDATE SET
1313
+ name = excluded.name,
1314
+ subscribed = excluded.subscribed,
1315
+ synced = excluded.synced,
1316
+ shared_memory_synced = excluded.shared_memory_synced,
1317
+ meta_synced = excluded.meta_synced,
1318
+ on_chain_id = excluded.on_chain_id,
1319
+ on_chain_hash = excluded.on_chain_hash,
1320
+ last_reconciled_ordinal = excluded.last_reconciled_ordinal,
1321
+ core_hosted = excluded.core_hosted,
1322
+ sync_scoped = excluded.sync_scoped,
1323
+ updated_at = excluded.updated_at
1306
1324
  `).run({
1307
1325
  context_graph_id: record.context_graph_id,
1308
1326
  name: record.name ?? null,
@@ -1400,37 +1418,37 @@ export class DashboardDB {
1400
1418
  transition();
1401
1419
  }
1402
1420
  appendContextGraphJoinPolicyAudit(event) {
1403
- this.stmt('appendContextGraphJoinPolicyAudit', `
1404
- INSERT INTO context_graph_join_policy_audit (
1405
- ts, context_graph_id, event_type, actor, agent_address, outcome,
1406
- reason, request_digest, policy_version, details
1407
- ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
1421
+ this.stmt('appendContextGraphJoinPolicyAudit', `
1422
+ INSERT INTO context_graph_join_policy_audit (
1423
+ ts, context_graph_id, event_type, actor, agent_address, outcome,
1424
+ reason, request_digest, policy_version, details
1425
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
1408
1426
  `).run(event.timestamp, event.contextGraphId, event.eventType, event.actor ?? null, event.agentAddress ?? null, event.outcome, event.reason ?? null, event.requestDigest ?? null, event.policyVersion ?? null, event.details ? JSON.stringify(event.details) : null);
1409
1427
  }
1410
1428
  reserveContextGraphAutomaticApproval(input) {
1411
1429
  const reserve = this.db.transaction(() => {
1412
1430
  const since = input.timestamp - 60 * 60 * 1000;
1413
- const cgRow = this.stmt('countContextGraphAutomaticApprovalReservations', `
1414
- SELECT COUNT(*) AS count
1415
- FROM context_graph_join_approval_ledger
1416
- WHERE context_graph_id = ?
1417
- AND reserved_at >= ?
1431
+ const cgRow = this.stmt('countContextGraphAutomaticApprovalReservations', `
1432
+ SELECT COUNT(*) AS count
1433
+ FROM context_graph_join_approval_ledger
1434
+ WHERE context_graph_id = ?
1435
+ AND reserved_at >= ?
1418
1436
  `).get(input.contextGraphId, since);
1419
- const nodeRow = this.stmt('countNodeAutomaticApprovalReservations', `
1420
- SELECT COUNT(*) AS count
1421
- FROM context_graph_join_approval_ledger
1422
- WHERE reserved_at >= ?
1437
+ const nodeRow = this.stmt('countNodeAutomaticApprovalReservations', `
1438
+ SELECT COUNT(*) AS count
1439
+ FROM context_graph_join_approval_ledger
1440
+ WHERE reserved_at >= ?
1423
1441
  `).get(since);
1424
1442
  const contextGraphCount = Number(cgRow?.count ?? 0);
1425
1443
  const nodeCount = Number(nodeRow?.count ?? 0);
1426
- const existing = this.stmt('findContextGraphAutomaticApprovalReservation', `
1427
- SELECT 1 AS found
1428
- FROM context_graph_join_approval_ledger
1429
- WHERE context_graph_id = ?
1430
- AND request_digest = ?
1431
- AND policy_epoch = ?
1432
- AND reserved_at >= ?
1433
- LIMIT 1
1444
+ const existing = this.stmt('findContextGraphAutomaticApprovalReservation', `
1445
+ SELECT 1 AS found
1446
+ FROM context_graph_join_approval_ledger
1447
+ WHERE context_graph_id = ?
1448
+ AND request_digest = ?
1449
+ AND policy_epoch = ?
1450
+ AND reserved_at >= ?
1451
+ LIMIT 1
1434
1452
  `).get(input.contextGraphId, input.requestDigest, input.policyEpoch, since);
1435
1453
  if (existing) {
1436
1454
  return {
@@ -1460,16 +1478,16 @@ export class DashboardDB {
1460
1478
  // reservation without durable operational state. An expired replay of
1461
1479
  // the same digest+epoch refreshes its reservation timestamp and consumes
1462
1480
  // the rolling-window quota again, matching the former append-only model.
1463
- this.stmt('upsertContextGraphAutomaticApprovalReservation', `
1464
- INSERT INTO context_graph_join_approval_ledger (
1465
- context_graph_id, request_digest, policy_epoch, reserved_at,
1466
- state, committed_at, actor, agent_address, policy_version
1467
- ) VALUES (?, ?, ?, ?, 'reserved', NULL, ?, ?, ?)
1468
- ON CONFLICT(context_graph_id, request_digest, policy_epoch) DO UPDATE SET
1469
- reserved_at = excluded.reserved_at,
1470
- actor = excluded.actor,
1471
- agent_address = excluded.agent_address,
1472
- policy_version = excluded.policy_version
1481
+ this.stmt('upsertContextGraphAutomaticApprovalReservation', `
1482
+ INSERT INTO context_graph_join_approval_ledger (
1483
+ context_graph_id, request_digest, policy_epoch, reserved_at,
1484
+ state, committed_at, actor, agent_address, policy_version
1485
+ ) VALUES (?, ?, ?, ?, 'reserved', NULL, ?, ?, ?)
1486
+ ON CONFLICT(context_graph_id, request_digest, policy_epoch) DO UPDATE SET
1487
+ reserved_at = excluded.reserved_at,
1488
+ actor = excluded.actor,
1489
+ agent_address = excluded.agent_address,
1490
+ policy_version = excluded.policy_version
1473
1491
  `).run(input.contextGraphId, input.requestDigest, input.policyEpoch, input.timestamp, input.actor, input.agentAddress, input.policyVersion);
1474
1492
  this.appendContextGraphJoinPolicyAudit({
1475
1493
  timestamp: input.timestamp,
@@ -1495,26 +1513,26 @@ export class DashboardDB {
1495
1513
  return reserve();
1496
1514
  }
1497
1515
  markContextGraphAutomaticApprovalRepairPending(input) {
1498
- const marked = this.stmt('markContextGraphAutomaticApprovalRepairPending', `
1499
- UPDATE context_graph_join_approval_ledger
1500
- SET repair_pending = 1
1501
- WHERE context_graph_id = ?
1502
- AND request_digest = ?
1503
- AND policy_epoch = ?
1504
- AND state = 'reserved'
1516
+ const marked = this.stmt('markContextGraphAutomaticApprovalRepairPending', `
1517
+ UPDATE context_graph_join_approval_ledger
1518
+ SET repair_pending = 1
1519
+ WHERE context_graph_id = ?
1520
+ AND request_digest = ?
1521
+ AND policy_epoch = ?
1522
+ AND state = 'reserved'
1505
1523
  `).run(input.contextGraphId, input.requestDigest, input.policyEpoch);
1506
1524
  return marked.changes === 1;
1507
1525
  }
1508
1526
  getContextGraphAutomaticApprovalRepair(contextGraphId, requestDigest) {
1509
- const repair = this.stmt('getContextGraphAutomaticApprovalRepair', `
1510
- SELECT policy_epoch, actor, agent_address
1511
- FROM context_graph_join_approval_ledger
1512
- WHERE context_graph_id = ?
1513
- AND request_digest = ?
1514
- AND state = 'reserved'
1515
- AND repair_pending = 1
1516
- ORDER BY reserved_at DESC
1517
- LIMIT 1
1527
+ const repair = this.stmt('getContextGraphAutomaticApprovalRepair', `
1528
+ SELECT policy_epoch, actor, agent_address
1529
+ FROM context_graph_join_approval_ledger
1530
+ WHERE context_graph_id = ?
1531
+ AND request_digest = ?
1532
+ AND state = 'reserved'
1533
+ AND repair_pending = 1
1534
+ ORDER BY reserved_at DESC
1535
+ LIMIT 1
1518
1536
  `).get(contextGraphId, requestDigest);
1519
1537
  return repair
1520
1538
  ? {
@@ -1526,26 +1544,26 @@ export class DashboardDB {
1526
1544
  }
1527
1545
  commitContextGraphAutomaticApproval(input) {
1528
1546
  const commit = this.db.transaction(() => {
1529
- const reservation = this.stmt('findExactContextGraphAutomaticApprovalReservation', `
1530
- SELECT context_graph_id, request_digest, policy_epoch, reserved_at,
1531
- state, committed_at, actor, agent_address, policy_version
1532
- FROM context_graph_join_approval_ledger
1533
- WHERE context_graph_id = ?
1534
- AND request_digest = ?
1535
- AND policy_epoch = ?
1536
- LIMIT 1
1547
+ const reservation = this.stmt('findExactContextGraphAutomaticApprovalReservation', `
1548
+ SELECT context_graph_id, request_digest, policy_epoch, reserved_at,
1549
+ state, committed_at, actor, agent_address, policy_version
1550
+ FROM context_graph_join_approval_ledger
1551
+ WHERE context_graph_id = ?
1552
+ AND request_digest = ?
1553
+ AND policy_epoch = ?
1554
+ LIMIT 1
1537
1555
  `).get(input.contextGraphId, input.requestDigest, input.policyEpoch);
1538
1556
  if (!reservation)
1539
1557
  return false;
1540
1558
  if (reservation.state === 'committed')
1541
1559
  return true;
1542
- const updated = this.stmt('commitContextGraphAutomaticApprovalReservation', `
1543
- UPDATE context_graph_join_approval_ledger
1544
- SET state = 'committed', committed_at = ?, repair_pending = 0
1545
- WHERE context_graph_id = ?
1546
- AND request_digest = ?
1547
- AND policy_epoch = ?
1548
- AND state = 'reserved'
1560
+ const updated = this.stmt('commitContextGraphAutomaticApprovalReservation', `
1561
+ UPDATE context_graph_join_approval_ledger
1562
+ SET state = 'committed', committed_at = ?, repair_pending = 0
1563
+ WHERE context_graph_id = ?
1564
+ AND request_digest = ?
1565
+ AND policy_epoch = ?
1566
+ AND state = 'reserved'
1549
1567
  `).run(input.timestamp, reservation.context_graph_id, reservation.request_digest, reservation.policy_epoch);
1550
1568
  if (updated.changes !== 1)
1551
1569
  return false;
@@ -1569,48 +1587,48 @@ export class DashboardDB {
1569
1587
  }
1570
1588
  getContextGraphAutomaticApprovalUsage(contextGraphId, timestamp) {
1571
1589
  const since = timestamp - 60 * 60 * 1000;
1572
- const contextGraphApprovalsLastHour = Number(this.stmt('getContextGraphAutomaticApprovalUsage', `
1573
- SELECT COUNT(*) AS count
1574
- FROM context_graph_join_approval_ledger
1575
- WHERE context_graph_id = ?
1576
- AND reserved_at >= ?
1590
+ const contextGraphApprovalsLastHour = Number(this.stmt('getContextGraphAutomaticApprovalUsage', `
1591
+ SELECT COUNT(*) AS count
1592
+ FROM context_graph_join_approval_ledger
1593
+ WHERE context_graph_id = ?
1594
+ AND reserved_at >= ?
1577
1595
  `).get(contextGraphId, since)?.count ?? 0);
1578
- const nodeApprovalsLastHour = Number(this.stmt('getNodeAutomaticApprovalUsage', `
1579
- SELECT COUNT(*) AS count
1580
- FROM context_graph_join_approval_ledger
1581
- WHERE reserved_at >= ?
1596
+ const nodeApprovalsLastHour = Number(this.stmt('getNodeAutomaticApprovalUsage', `
1597
+ SELECT COUNT(*) AS count
1598
+ FROM context_graph_join_approval_ledger
1599
+ WHERE reserved_at >= ?
1582
1600
  `).get(since)?.count ?? 0);
1583
1601
  return { contextGraphApprovalsLastHour, nodeApprovalsLastHour };
1584
1602
  }
1585
1603
  listContextGraphJoinPolicyAudit(contextGraphId) {
1586
- return this.stmt('listContextGraphJoinPolicyAudit', `
1587
- SELECT id, ts, context_graph_id, event_type, actor, agent_address,
1588
- outcome, reason, request_digest, policy_version, details
1589
- FROM context_graph_join_policy_audit
1590
- WHERE context_graph_id = ?
1591
- ORDER BY id ASC
1604
+ return this.stmt('listContextGraphJoinPolicyAudit', `
1605
+ SELECT id, ts, context_graph_id, event_type, actor, agent_address,
1606
+ outcome, reason, request_digest, policy_version, details
1607
+ FROM context_graph_join_policy_audit
1608
+ WHERE context_graph_id = ?
1609
+ ORDER BY id ASC
1592
1610
  `).all(contextGraphId);
1593
1611
  }
1594
1612
  contextGraphJoinPolicyKey(contextGraphId) {
1595
1613
  return `contextGraphJoinPolicy:${contextGraphId}`;
1596
1614
  }
1597
1615
  upsertVmReconcileNegative(record) {
1598
- this.stmt('upsertVmReconcileNegative', `
1599
- INSERT INTO vm_reconcile_negative_cache (
1600
- cache_key, context_graph_id, failures, next_retry_at, swm_gen,
1601
- candidate_namespaces, peer_topology_key, updated_at
1602
- ) VALUES (
1603
- @cache_key, @context_graph_id, @failures, @next_retry_at, @swm_gen,
1604
- @candidate_namespaces, @peer_topology_key, @updated_at
1605
- )
1606
- ON CONFLICT(cache_key) DO UPDATE SET
1607
- context_graph_id = excluded.context_graph_id,
1608
- failures = excluded.failures,
1609
- next_retry_at = excluded.next_retry_at,
1610
- swm_gen = excluded.swm_gen,
1611
- candidate_namespaces = excluded.candidate_namespaces,
1612
- peer_topology_key = excluded.peer_topology_key,
1613
- updated_at = excluded.updated_at
1616
+ this.stmt('upsertVmReconcileNegative', `
1617
+ INSERT INTO vm_reconcile_negative_cache (
1618
+ cache_key, context_graph_id, failures, next_retry_at, swm_gen,
1619
+ candidate_namespaces, peer_topology_key, updated_at
1620
+ ) VALUES (
1621
+ @cache_key, @context_graph_id, @failures, @next_retry_at, @swm_gen,
1622
+ @candidate_namespaces, @peer_topology_key, @updated_at
1623
+ )
1624
+ ON CONFLICT(cache_key) DO UPDATE SET
1625
+ context_graph_id = excluded.context_graph_id,
1626
+ failures = excluded.failures,
1627
+ next_retry_at = excluded.next_retry_at,
1628
+ swm_gen = excluded.swm_gen,
1629
+ candidate_namespaces = excluded.candidate_namespaces,
1630
+ peer_topology_key = excluded.peer_topology_key,
1631
+ updated_at = excluded.updated_at
1614
1632
  `).run(record);
1615
1633
  }
1616
1634
  getVmReconcileNegative(cacheKey) {
@@ -1629,14 +1647,14 @@ export class DashboardDB {
1629
1647
  * coerced defensively so a malformed event can never abort the insert.
1630
1648
  */
1631
1649
  insertReplicationEvent(ev) {
1632
- this.stmt('insertReplicationEvent', `
1633
- INSERT INTO replication_events (
1634
- ts, context_graph_id, on_chain_cg_id, action, ual, ordinal, ka_id,
1635
- from_watermark, to_watermark, head, reconciled, pending, detail
1636
- ) VALUES (
1637
- @ts, @context_graph_id, @on_chain_cg_id, @action, @ual, @ordinal, @ka_id,
1638
- @from_watermark, @to_watermark, @head, @reconciled, @pending, @detail
1639
- )
1650
+ this.stmt('insertReplicationEvent', `
1651
+ INSERT INTO replication_events (
1652
+ ts, context_graph_id, on_chain_cg_id, action, ual, ordinal, ka_id,
1653
+ from_watermark, to_watermark, head, reconciled, pending, detail
1654
+ ) VALUES (
1655
+ @ts, @context_graph_id, @on_chain_cg_id, @action, @ual, @ordinal, @ka_id,
1656
+ @from_watermark, @to_watermark, @head, @reconciled, @pending, @detail
1657
+ )
1640
1658
  `).run({
1641
1659
  ts: ev.ts,
1642
1660
  context_graph_id: ev.context_graph_id,
@@ -1683,15 +1701,15 @@ export class DashboardDB {
1683
1701
  // and inflate the reported latency. fetch/promote for one version always
1684
1702
  // share the same ordinal, so this pairs them exactly; a fast-path promote
1685
1703
  // with no fetch for its ordinal correctly contributes a 0ms latency.
1686
- const latencyRows = this.db.prepare(`
1687
- SELECT p.ts AS promote_ts,
1688
- (SELECT MAX(f.ts) FROM replication_events f
1689
- WHERE f.action = 'fetch'
1690
- AND f.context_graph_id = p.context_graph_id
1691
- AND f.ordinal = p.ordinal
1692
- AND f.ts <= p.ts AND f.ts >= ?) AS fetch_ts
1693
- FROM replication_events p
1694
- WHERE p.action = 'promote' AND p.ts >= ? AND p.ordinal IS NOT NULL
1704
+ const latencyRows = this.db.prepare(`
1705
+ SELECT p.ts AS promote_ts,
1706
+ (SELECT MAX(f.ts) FROM replication_events f
1707
+ WHERE f.action = 'fetch'
1708
+ AND f.context_graph_id = p.context_graph_id
1709
+ AND f.ordinal = p.ordinal
1710
+ AND f.ts <= p.ts AND f.ts >= ?) AS fetch_ts
1711
+ FROM replication_events p
1712
+ WHERE p.action = 'promote' AND p.ts >= ? AND p.ordinal IS NOT NULL
1695
1713
  `).all(cutoff, cutoff);
1696
1714
  const latencies = latencyRows
1697
1715
  .map((r) => (r.fetch_ts != null ? r.promote_ts - r.fetch_ts : 0))
@@ -1721,20 +1739,20 @@ export class DashboardDB {
1721
1739
  }
1722
1740
  _computeReplicationPerCg(periodMs) {
1723
1741
  const cutoff = Date.now() - periodMs;
1724
- return this.db.prepare(`
1725
- SELECT context_graph_id,
1726
- on_chain_cg_id,
1727
- SUM(CASE WHEN action = 'promote' THEN 1 ELSE 0 END) AS promotes,
1728
- SUM(CASE WHEN action = 'fetch' THEN 1 ELSE 0 END) AS fetches,
1729
- SUM(CASE WHEN action = 'defer' THEN 1 ELSE 0 END) AS defers,
1730
- SUM(CASE WHEN action = 'cursor-advance' THEN 1 ELSE 0 END) AS cursor_advances,
1731
- MAX(to_watermark) AS last_watermark,
1732
- MAX(head) AS last_head,
1733
- MAX(ts) AS last_event_ts
1734
- FROM replication_events
1735
- WHERE ts >= ?
1736
- GROUP BY context_graph_id, on_chain_cg_id
1737
- ORDER BY last_event_ts DESC
1742
+ return this.db.prepare(`
1743
+ SELECT context_graph_id,
1744
+ on_chain_cg_id,
1745
+ SUM(CASE WHEN action = 'promote' THEN 1 ELSE 0 END) AS promotes,
1746
+ SUM(CASE WHEN action = 'fetch' THEN 1 ELSE 0 END) AS fetches,
1747
+ SUM(CASE WHEN action = 'defer' THEN 1 ELSE 0 END) AS defers,
1748
+ SUM(CASE WHEN action = 'cursor-advance' THEN 1 ELSE 0 END) AS cursor_advances,
1749
+ MAX(to_watermark) AS last_watermark,
1750
+ MAX(head) AS last_head,
1751
+ MAX(ts) AS last_event_ts
1752
+ FROM replication_events
1753
+ WHERE ts >= ?
1754
+ GROUP BY context_graph_id, on_chain_cg_id
1755
+ ORDER BY last_event_ts DESC
1738
1756
  `).all(cutoff);
1739
1757
  }
1740
1758
  /**
@@ -1753,16 +1771,16 @@ export class DashboardDB {
1753
1771
  const cutoff = Date.now() - opts.periodMs;
1754
1772
  const bucket = Math.max(1, Math.floor(opts.bucketMs));
1755
1773
  const where = opts.contextGraphId ? 'AND context_graph_id = @cg' : '';
1756
- return this.db.prepare(`
1757
- SELECT (ts / @bucket) * @bucket AS bucket,
1758
- SUM(CASE WHEN action = 'promote' THEN 1 ELSE 0 END) AS promotes,
1759
- SUM(CASE WHEN action = 'fetch' THEN 1 ELSE 0 END) AS fetches,
1760
- SUM(CASE WHEN action = 'defer' THEN 1 ELSE 0 END) AS defers,
1761
- COUNT(*) AS total
1762
- FROM replication_events
1763
- WHERE ts >= @cutoff ${where}
1764
- GROUP BY bucket
1765
- ORDER BY bucket ASC
1774
+ return this.db.prepare(`
1775
+ SELECT (ts / @bucket) * @bucket AS bucket,
1776
+ SUM(CASE WHEN action = 'promote' THEN 1 ELSE 0 END) AS promotes,
1777
+ SUM(CASE WHEN action = 'fetch' THEN 1 ELSE 0 END) AS fetches,
1778
+ SUM(CASE WHEN action = 'defer' THEN 1 ELSE 0 END) AS defers,
1779
+ COUNT(*) AS total
1780
+ FROM replication_events
1781
+ WHERE ts >= @cutoff ${where}
1782
+ GROUP BY bucket
1783
+ ORDER BY bucket ASC
1766
1784
  `).all({ cutoff, bucket, cg: opts.contextGraphId ?? null });
1767
1785
  }
1768
1786
  /**
@@ -1774,13 +1792,13 @@ export class DashboardDB {
1774
1792
  const safeLimit = Number.isFinite(limit)
1775
1793
  ? Math.max(1, Math.min(1000, Math.trunc(limit)))
1776
1794
  : 100;
1777
- return this.db.prepare(`
1778
- SELECT ts, context_graph_id, on_chain_cg_id, action, ual, ordinal, ka_id,
1779
- from_watermark, to_watermark, head, reconciled, pending, detail
1780
- FROM replication_events
1781
- WHERE context_graph_id = ?
1782
- ORDER BY ts DESC
1783
- LIMIT ?
1795
+ return this.db.prepare(`
1796
+ SELECT ts, context_graph_id, on_chain_cg_id, action, ual, ordinal, ka_id,
1797
+ from_watermark, to_watermark, head, reconciled, pending, detail
1798
+ FROM replication_events
1799
+ WHERE context_graph_id = ?
1800
+ ORDER BY ts DESC
1801
+ LIMIT ?
1784
1802
  `).all(contextGraphId, safeLimit);
1785
1803
  }
1786
1804
  /**
@@ -1789,38 +1807,38 @@ export class DashboardDB {
1789
1807
  * on-disk truth the Replication tab's cursor inspector renders.
1790
1808
  */
1791
1809
  getReplicationCursors() {
1792
- return this.db.prepare(`
1793
- SELECT s.context_graph_id AS context_graph_id,
1794
- s.on_chain_id AS on_chain_id,
1795
- s.last_reconciled_ordinal AS last_reconciled_ordinal,
1796
- s.core_hosted AS core_hosted,
1797
- s.subscribed AS subscribed,
1798
- (SELECT MAX(head) FROM replication_events e
1799
- WHERE e.context_graph_id = s.context_graph_id) AS last_head,
1800
- (SELECT MAX(ts) FROM replication_events e
1801
- WHERE e.context_graph_id = s.context_graph_id) AS last_event_ts
1802
- FROM context_graph_subscriptions s
1803
- ORDER BY s.context_graph_id ASC
1810
+ return this.db.prepare(`
1811
+ SELECT s.context_graph_id AS context_graph_id,
1812
+ s.on_chain_id AS on_chain_id,
1813
+ s.last_reconciled_ordinal AS last_reconciled_ordinal,
1814
+ s.core_hosted AS core_hosted,
1815
+ s.subscribed AS subscribed,
1816
+ (SELECT MAX(head) FROM replication_events e
1817
+ WHERE e.context_graph_id = s.context_graph_id) AS last_head,
1818
+ (SELECT MAX(ts) FROM replication_events e
1819
+ WHERE e.context_graph_id = s.context_graph_id) AS last_event_ts
1820
+ FROM context_graph_subscriptions s
1821
+ ORDER BY s.context_graph_id ASC
1804
1822
  `).all();
1805
1823
  }
1806
1824
  upsertContextGraphMember(record) {
1807
1825
  const firstSeenAt = record.first_seen_at ?? record.updated_at;
1808
- this.stmt('upsertContextGraphMember', `
1809
- INSERT INTO context_graph_memberships (
1810
- context_graph_id, principal_type, principal_id, role, status, source,
1811
- display_name, metadata, first_seen_at, updated_at
1812
- ) VALUES (
1813
- @context_graph_id, @principal_type, @principal_id, @role, @status, @source,
1814
- @display_name, @metadata, @first_seen_at, @updated_at
1815
- )
1816
- ON CONFLICT(context_graph_id, principal_type, principal_id) DO UPDATE SET
1817
- role = excluded.role,
1818
- status = excluded.status,
1819
- source = excluded.source,
1820
- display_name = excluded.display_name,
1821
- metadata = excluded.metadata,
1822
- first_seen_at = context_graph_memberships.first_seen_at,
1823
- updated_at = excluded.updated_at
1826
+ this.stmt('upsertContextGraphMember', `
1827
+ INSERT INTO context_graph_memberships (
1828
+ context_graph_id, principal_type, principal_id, role, status, source,
1829
+ display_name, metadata, first_seen_at, updated_at
1830
+ ) VALUES (
1831
+ @context_graph_id, @principal_type, @principal_id, @role, @status, @source,
1832
+ @display_name, @metadata, @first_seen_at, @updated_at
1833
+ )
1834
+ ON CONFLICT(context_graph_id, principal_type, principal_id) DO UPDATE SET
1835
+ role = excluded.role,
1836
+ status = excluded.status,
1837
+ source = excluded.source,
1838
+ display_name = excluded.display_name,
1839
+ metadata = excluded.metadata,
1840
+ first_seen_at = context_graph_memberships.first_seen_at,
1841
+ updated_at = excluded.updated_at
1824
1842
  `).run({
1825
1843
  context_graph_id: record.context_graph_id,
1826
1844
  principal_type: record.principal_type,
@@ -1836,15 +1854,15 @@ export class DashboardDB {
1836
1854
  }
1837
1855
  listContextGraphMembers(contextGraphId) {
1838
1856
  if (contextGraphId) {
1839
- return this.db.prepare(`
1840
- SELECT * FROM context_graph_memberships
1841
- WHERE context_graph_id = ?
1842
- ORDER BY principal_type ASC, principal_id ASC
1857
+ return this.db.prepare(`
1858
+ SELECT * FROM context_graph_memberships
1859
+ WHERE context_graph_id = ?
1860
+ ORDER BY principal_type ASC, principal_id ASC
1843
1861
  `).all(contextGraphId);
1844
1862
  }
1845
- return this.db.prepare(`
1846
- SELECT * FROM context_graph_memberships
1847
- ORDER BY context_graph_id ASC, principal_type ASC, principal_id ASC
1863
+ return this.db.prepare(`
1864
+ SELECT * FROM context_graph_memberships
1865
+ ORDER BY context_graph_id ASC, principal_type ASC, principal_id ASC
1848
1866
  `).all();
1849
1867
  }
1850
1868
  deleteContextGraphMember(contextGraphId, principalType, principalId) {
@@ -1856,18 +1874,18 @@ export class DashboardDB {
1856
1874
  return this.db.prepare('SELECT * FROM metric_snapshots WHERE ts >= ? AND ts <= ? ORDER BY ts').all(from, to);
1857
1875
  }
1858
1876
  const step = Math.ceil(total.c / maxPoints);
1859
- return this.db.prepare(`
1860
- SELECT * FROM (
1861
- SELECT *, ROW_NUMBER() OVER (ORDER BY ts) as rn
1862
- FROM metric_snapshots WHERE ts >= ? AND ts <= ?
1863
- ) WHERE rn % ? = 0 ORDER BY ts
1877
+ return this.db.prepare(`
1878
+ SELECT * FROM (
1879
+ SELECT *, ROW_NUMBER() OVER (ORDER BY ts) as rn
1880
+ FROM metric_snapshots WHERE ts >= ? AND ts <= ?
1881
+ ) WHERE rn % ? = 0 ORDER BY ts
1864
1882
  `).all(from, to, step);
1865
1883
  }
1866
1884
  // --- Operations ---
1867
1885
  insertOperation(op) {
1868
- this.stmt('insertOp', `
1869
- INSERT INTO operations (operation_id, operation_name, started_at, status, peer_id, contextGraph_id, details)
1870
- VALUES (@operation_id, @operation_name, @started_at, 'in_progress', @peer_id, @contextGraph_id, @details)
1886
+ this.stmt('insertOp', `
1887
+ INSERT INTO operations (operation_id, operation_name, started_at, status, peer_id, contextGraph_id, details)
1888
+ VALUES (@operation_id, @operation_name, @started_at, 'in_progress', @peer_id, @contextGraph_id, @details)
1871
1889
  `).run({
1872
1890
  operation_id: op.operation_id,
1873
1891
  operation_name: op.operation_name,
@@ -1878,10 +1896,10 @@ export class DashboardDB {
1878
1896
  });
1879
1897
  }
1880
1898
  completeOperation(op) {
1881
- this.stmt('completeOp', `
1882
- UPDATE operations SET status = 'success', duration_ms = @duration_ms,
1883
- triple_count = @triple_count, details = COALESCE(@details, details)
1884
- WHERE operation_id = @operation_id AND status = 'in_progress'
1899
+ this.stmt('completeOp', `
1900
+ UPDATE operations SET status = 'success', duration_ms = @duration_ms,
1901
+ triple_count = @triple_count, details = COALESCE(@details, details)
1902
+ WHERE operation_id = @operation_id AND status = 'in_progress'
1885
1903
  `).run({
1886
1904
  operation_id: op.operation_id,
1887
1905
  duration_ms: op.duration_ms,
@@ -1890,10 +1908,10 @@ export class DashboardDB {
1890
1908
  });
1891
1909
  }
1892
1910
  failOperation(op) {
1893
- this.stmt('failOp', `
1894
- UPDATE operations SET status = 'error', duration_ms = @duration_ms,
1895
- error_message = @error_message
1896
- WHERE operation_id = @operation_id AND status = 'in_progress'
1911
+ this.stmt('failOp', `
1912
+ UPDATE operations SET status = 'error', duration_ms = @duration_ms,
1913
+ error_message = @error_message
1914
+ WHERE operation_id = @operation_id AND status = 'in_progress'
1897
1915
  `).run(op);
1898
1916
  }
1899
1917
  getOperations(opts = {}) {
@@ -1950,22 +1968,22 @@ export class DashboardDB {
1950
1968
  }
1951
1969
  getErrorHotspots(periodMs = 7 * 86_400_000) {
1952
1970
  const cutoff = Date.now() - periodMs;
1953
- return this.db.prepare(`
1954
- SELECT
1955
- p.phase,
1956
- o.operation_name,
1957
- COUNT(*) as error_count,
1958
- (SELECT p2.details FROM operation_phases p2
1959
- JOIN operations o2 ON o2.operation_id = p2.operation_id
1960
- WHERE p2.phase = p.phase AND o2.operation_name = o.operation_name
1961
- AND p2.status = 'error' AND p2.started_at >= ?
1962
- ORDER BY p2.started_at DESC LIMIT 1) as last_error,
1963
- MAX(p.started_at) as last_occurred
1964
- FROM operation_phases p
1965
- JOIN operations o ON o.operation_id = p.operation_id
1966
- WHERE p.status = 'error' AND p.started_at >= ?
1967
- GROUP BY p.phase, o.operation_name
1968
- ORDER BY error_count DESC
1971
+ return this.db.prepare(`
1972
+ SELECT
1973
+ p.phase,
1974
+ o.operation_name,
1975
+ COUNT(*) as error_count,
1976
+ (SELECT p2.details FROM operation_phases p2
1977
+ JOIN operations o2 ON o2.operation_id = p2.operation_id
1978
+ WHERE p2.phase = p.phase AND o2.operation_name = o.operation_name
1979
+ AND p2.status = 'error' AND p2.started_at >= ?
1980
+ ORDER BY p2.started_at DESC LIMIT 1) as last_error,
1981
+ MAX(p.started_at) as last_occurred
1982
+ FROM operation_phases p
1983
+ JOIN operations o ON o.operation_id = p.operation_id
1984
+ WHERE p.status = 'error' AND p.started_at >= ?
1985
+ GROUP BY p.phase, o.operation_name
1986
+ ORDER BY error_count DESC
1969
1987
  `).all(cutoff, cutoff);
1970
1988
  }
1971
1989
  getFailedOperations(opts = {}) {
@@ -1987,17 +2005,17 @@ export class DashboardDB {
1987
2005
  params.push(like, like, like);
1988
2006
  }
1989
2007
  params.push(limit);
1990
- const rows = this.db.prepare(`
1991
- SELECT
1992
- o.*,
1993
- p.phase AS phase,
1994
- p.details AS phase_error,
1995
- p.started_at AS phase_started_at
1996
- FROM operation_phases p
1997
- JOIN operations o ON o.operation_id = p.operation_id
1998
- WHERE ${where}
1999
- ORDER BY p.started_at DESC
2000
- LIMIT ?
2008
+ const rows = this.db.prepare(`
2009
+ SELECT
2010
+ o.*,
2011
+ p.phase AS phase,
2012
+ p.details AS phase_error,
2013
+ p.started_at AS phase_started_at
2014
+ FROM operation_phases p
2015
+ JOIN operations o ON o.operation_id = p.operation_id
2016
+ WHERE ${where}
2017
+ ORDER BY p.started_at DESC
2018
+ LIMIT ?
2001
2019
  `).all(...params);
2002
2020
  const operations = rows.map(row => {
2003
2021
  const logs = this.db.prepare('SELECT * FROM logs WHERE operation_id = ? ORDER BY ts DESC LIMIT 20').all(row.operation_id);
@@ -2014,42 +2032,42 @@ export class DashboardDB {
2014
2032
  }
2015
2033
  // --- Operation phases ---
2016
2034
  insertPhase(op) {
2017
- this.stmt('insertPhase', `
2018
- INSERT INTO operation_phases (operation_id, phase, started_at, status)
2019
- VALUES (@operation_id, @phase, @started_at, 'in_progress')
2035
+ this.stmt('insertPhase', `
2036
+ INSERT INTO operation_phases (operation_id, phase, started_at, status)
2037
+ VALUES (@operation_id, @phase, @started_at, 'in_progress')
2020
2038
  `).run(op);
2021
2039
  }
2022
2040
  completePhase(op) {
2023
- this.stmt('completePhase', `
2024
- UPDATE operation_phases SET status = 'success', duration_ms = @duration_ms
2025
- WHERE operation_id = @operation_id AND phase = @phase AND status = 'in_progress'
2041
+ this.stmt('completePhase', `
2042
+ UPDATE operation_phases SET status = 'success', duration_ms = @duration_ms
2043
+ WHERE operation_id = @operation_id AND phase = @phase AND status = 'in_progress'
2026
2044
  `).run(op);
2027
2045
  }
2028
2046
  failPhase(op) {
2029
- this.stmt('failPhase', `
2030
- UPDATE operation_phases SET status = 'error', duration_ms = @duration_ms,
2031
- details = @error_message
2032
- WHERE operation_id = @operation_id AND phase = @phase AND status = 'in_progress'
2047
+ this.stmt('failPhase', `
2048
+ UPDATE operation_phases SET status = 'error', duration_ms = @duration_ms,
2049
+ details = @error_message
2050
+ WHERE operation_id = @operation_id AND phase = @phase AND status = 'in_progress'
2033
2051
  `).run(op);
2034
2052
  }
2035
2053
  failAllPhases(op) {
2036
- this.stmt('failAllPhases', `
2037
- UPDATE operation_phases SET status = 'error', duration_ms = @duration_ms,
2038
- details = @error_message
2039
- WHERE operation_id = @operation_id AND status = 'in_progress'
2054
+ this.stmt('failAllPhases', `
2055
+ UPDATE operation_phases SET status = 'error', duration_ms = @duration_ms,
2056
+ details = @error_message
2057
+ WHERE operation_id = @operation_id AND status = 'in_progress'
2040
2058
  `).run(op);
2041
2059
  }
2042
2060
  // --- Operation cost & tx ---
2043
2061
  setOperationCost(op) {
2044
- this.stmt('setCost', `
2045
- UPDATE operations SET
2046
- gas_used = COALESCE(@gas_used, gas_used),
2047
- gas_price_gwei = COALESCE(@gas_price_gwei, gas_price_gwei),
2048
- gas_cost_eth = COALESCE(@gas_cost_eth, gas_cost_eth),
2049
- trac_cost = COALESCE(@trac_cost, trac_cost),
2050
- tx_hash = COALESCE(@tx_hash, tx_hash),
2051
- chain_id = COALESCE(@chain_id, chain_id)
2052
- WHERE operation_id = @operation_id
2062
+ this.stmt('setCost', `
2063
+ UPDATE operations SET
2064
+ gas_used = COALESCE(@gas_used, gas_used),
2065
+ gas_price_gwei = COALESCE(@gas_price_gwei, gas_price_gwei),
2066
+ gas_cost_eth = COALESCE(@gas_cost_eth, gas_cost_eth),
2067
+ trac_cost = COALESCE(@trac_cost, trac_cost),
2068
+ tx_hash = COALESCE(@tx_hash, tx_hash),
2069
+ chain_id = COALESCE(@chain_id, chain_id)
2070
+ WHERE operation_id = @operation_id
2053
2071
  `).run({
2054
2072
  operation_id: op.operation_id,
2055
2073
  gas_used: op.gas_used ?? null,
@@ -2067,17 +2085,17 @@ export class DashboardDB {
2067
2085
  const params = [cutoff];
2068
2086
  if (opts.name)
2069
2087
  params.push(opts.name);
2070
- const summaryRow = this.db.prepare(`
2071
- SELECT
2072
- COUNT(*) as totalCount,
2073
- SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successCount,
2074
- SUM(CASE WHEN status = 'error' THEN 1 ELSE 0 END) as errorCount,
2075
- AVG(CASE WHEN status = 'success' THEN duration_ms END) as avgDurationMs,
2076
- AVG(gas_cost_eth) as avgGasCostEth,
2077
- SUM(gas_cost_eth) as totalGasCostEth,
2078
- AVG(trac_cost) as avgTracCost,
2079
- SUM(trac_cost) as totalTracCost
2080
- FROM operations WHERE started_at >= ? ${nameFilter}
2088
+ const summaryRow = this.db.prepare(`
2089
+ SELECT
2090
+ COUNT(*) as totalCount,
2091
+ SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successCount,
2092
+ SUM(CASE WHEN status = 'error' THEN 1 ELSE 0 END) as errorCount,
2093
+ AVG(CASE WHEN status = 'success' THEN duration_ms END) as avgDurationMs,
2094
+ AVG(gas_cost_eth) as avgGasCostEth,
2095
+ SUM(gas_cost_eth) as totalGasCostEth,
2096
+ AVG(trac_cost) as avgTracCost,
2097
+ SUM(trac_cost) as totalTracCost
2098
+ FROM operations WHERE started_at >= ? ${nameFilter}
2081
2099
  `).get(...params);
2082
2100
  const summary = {
2083
2101
  totalCount: summaryRow.totalCount ?? 0,
@@ -2094,17 +2112,17 @@ export class DashboardDB {
2094
2112
  const tsParams = [bucketSize, cutoff];
2095
2113
  if (opts.name)
2096
2114
  tsParams.push(opts.name);
2097
- const timeSeries = this.db.prepare(`
2098
- SELECT
2099
- (CAST(started_at / ? AS INTEGER) * ?) as bucket,
2100
- COUNT(*) as count,
2101
- SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successCount,
2102
- AVG(CASE WHEN status = 'success' THEN duration_ms END) as avgDurationMs,
2103
- AVG(gas_cost_eth) as avgGasCostEth,
2104
- SUM(gas_cost_eth) as totalGasCostEth
2105
- FROM operations
2106
- WHERE started_at >= ? ${nameFilter}
2107
- GROUP BY bucket ORDER BY bucket
2115
+ const timeSeries = this.db.prepare(`
2116
+ SELECT
2117
+ (CAST(started_at / ? AS INTEGER) * ?) as bucket,
2118
+ COUNT(*) as count,
2119
+ SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successCount,
2120
+ AVG(CASE WHEN status = 'success' THEN duration_ms END) as avgDurationMs,
2121
+ AVG(gas_cost_eth) as avgGasCostEth,
2122
+ SUM(gas_cost_eth) as totalGasCostEth
2123
+ FROM operations
2124
+ WHERE started_at >= ? ${nameFilter}
2125
+ GROUP BY bucket ORDER BY bucket
2108
2126
  `).all(bucketSize, bucketSize, ...params);
2109
2127
  return {
2110
2128
  summary,
@@ -2121,16 +2139,16 @@ export class DashboardDB {
2121
2139
  // --- Per-type time series ---
2122
2140
  getPerTypeTimeSeries(opts) {
2123
2141
  const cutoff = Date.now() - opts.periodMs;
2124
- const rows = this.db.prepare(`
2125
- SELECT
2126
- (CAST(started_at / ? AS INTEGER) * ?) as bucket,
2127
- operation_name as type,
2128
- COUNT(*) as count,
2129
- AVG(CASE WHEN status = 'success' THEN duration_ms END) as avgMs,
2130
- SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successCount,
2131
- SUM(gas_cost_eth) as gasCostEth
2132
- FROM operations WHERE started_at >= ?
2133
- GROUP BY bucket, operation_name ORDER BY bucket
2142
+ const rows = this.db.prepare(`
2143
+ SELECT
2144
+ (CAST(started_at / ? AS INTEGER) * ?) as bucket,
2145
+ operation_name as type,
2146
+ COUNT(*) as count,
2147
+ AVG(CASE WHEN status = 'success' THEN duration_ms END) as avgMs,
2148
+ SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successCount,
2149
+ SUM(gas_cost_eth) as gasCostEth
2150
+ FROM operations WHERE started_at >= ?
2151
+ GROUP BY bucket, operation_name ORDER BY bucket
2134
2152
  `).all(opts.bucketMs, opts.bucketMs, cutoff);
2135
2153
  const bucketSet = new Set();
2136
2154
  const typeSet = new Set();
@@ -2160,15 +2178,15 @@ export class DashboardDB {
2160
2178
  // --- Success rates by operation type ---
2161
2179
  getSuccessRatesByType(periodMs) {
2162
2180
  const cutoff = Date.now() - periodMs;
2163
- return this.db.prepare(`
2164
- SELECT
2165
- operation_name as type,
2166
- COUNT(*) as total,
2167
- SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as success,
2168
- SUM(CASE WHEN status = 'error' THEN 1 ELSE 0 END) as error,
2169
- AVG(CASE WHEN status = 'success' THEN duration_ms END) as avgMs
2170
- FROM operations WHERE started_at >= ?
2171
- GROUP BY operation_name ORDER BY total DESC
2181
+ return this.db.prepare(`
2182
+ SELECT
2183
+ operation_name as type,
2184
+ COUNT(*) as total,
2185
+ SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as success,
2186
+ SUM(CASE WHEN status = 'error' THEN 1 ELSE 0 END) as error,
2187
+ AVG(CASE WHEN status = 'success' THEN duration_ms END) as avgMs
2188
+ FROM operations WHERE started_at >= ?
2189
+ GROUP BY operation_name ORDER BY total DESC
2172
2190
  `).all(cutoff).map(r => ({
2173
2191
  ...r,
2174
2192
  rate: r.total > 0 ? r.success / r.total : 0,
@@ -2191,16 +2209,16 @@ export class DashboardDB {
2191
2209
  // on-chain (Verifiable Memory commits) are counted, so the publish
2192
2210
  // count and the TRAC total are consistent. Free SWM/local/testnet
2193
2211
  // publishes record trac_cost = 0 and are intentionally excluded.
2194
- const row = this.db.prepare(`
2195
- SELECT
2196
- SUM(CASE WHEN trac_cost > 0 THEN 1 ELSE 0 END) as publishCount,
2197
- SUM(CASE WHEN status = 'success' AND trac_cost > 0 THEN 1 ELSE 0 END) as successCount,
2198
- COALESCE(SUM(gas_cost_eth), 0) as totalGasEth,
2199
- COALESCE(SUM(trac_cost), 0) as totalTrac,
2200
- COALESCE(AVG(CASE WHEN trac_cost > 0 THEN gas_cost_eth END), 0) as avgGasEth,
2201
- COALESCE(AVG(CASE WHEN trac_cost > 0 THEN trac_cost END), 0) as avgTrac
2202
- FROM operations
2203
- WHERE operation_name = 'publish' AND trac_cost > 0 AND started_at >= ?
2212
+ const row = this.db.prepare(`
2213
+ SELECT
2214
+ SUM(CASE WHEN trac_cost > 0 THEN 1 ELSE 0 END) as publishCount,
2215
+ SUM(CASE WHEN status = 'success' AND trac_cost > 0 THEN 1 ELSE 0 END) as successCount,
2216
+ COALESCE(SUM(gas_cost_eth), 0) as totalGasEth,
2217
+ COALESCE(SUM(trac_cost), 0) as totalTrac,
2218
+ COALESCE(AVG(CASE WHEN trac_cost > 0 THEN gas_cost_eth END), 0) as avgGasEth,
2219
+ COALESCE(AVG(CASE WHEN trac_cost > 0 THEN trac_cost END), 0) as avgTrac
2220
+ FROM operations
2221
+ WHERE operation_name = 'publish' AND trac_cost > 0 AND started_at >= ?
2204
2222
  `).get(cutoff);
2205
2223
  results.periods.push({
2206
2224
  label: p.label,
@@ -2235,9 +2253,9 @@ export class DashboardDB {
2235
2253
  * still throw — pinned by db.test.ts.
2236
2254
  */
2237
2255
  insertChatMessage(msg) {
2238
- const info = this.stmt('insertChat', `
2239
- INSERT INTO chat_messages (ts, direction, peer, peer_name, text, delivered, message_id)
2240
- VALUES (@ts, @direction, @peer, @peer_name, @text, @delivered, @message_id)
2256
+ const info = this.stmt('insertChat', `
2257
+ INSERT INTO chat_messages (ts, direction, peer, peer_name, text, delivered, message_id)
2258
+ VALUES (@ts, @direction, @peer, @peer_name, @text, @delivered, @message_id)
2241
2259
  `).run({
2242
2260
  ts: msg.ts,
2243
2261
  direction: msg.direction,
@@ -2328,16 +2346,16 @@ export class DashboardDB {
2328
2346
  return this.db.prepare('SELECT * FROM chat_persistence_jobs WHERE turn_id = ?').get(turnId);
2329
2347
  }
2330
2348
  insertChatPersistenceJob(job) {
2331
- this.stmt('insertChatPersistenceJob', `
2332
- INSERT INTO chat_persistence_jobs (
2333
- turn_id, session_id, user_message, assistant_reply, tool_calls_json,
2334
- status, attempts, max_attempts, next_attempt_at, queued_at, updated_at,
2335
- store_ms, error_message
2336
- ) VALUES (
2337
- @turn_id, @session_id, @user_message, @assistant_reply, @tool_calls_json,
2338
- @status, @attempts, @max_attempts, @next_attempt_at, @queued_at, @updated_at,
2339
- @store_ms, @error_message
2340
- )
2349
+ this.stmt('insertChatPersistenceJob', `
2350
+ INSERT INTO chat_persistence_jobs (
2351
+ turn_id, session_id, user_message, assistant_reply, tool_calls_json,
2352
+ status, attempts, max_attempts, next_attempt_at, queued_at, updated_at,
2353
+ store_ms, error_message
2354
+ ) VALUES (
2355
+ @turn_id, @session_id, @user_message, @assistant_reply, @tool_calls_json,
2356
+ @status, @attempts, @max_attempts, @next_attempt_at, @queued_at, @updated_at,
2357
+ @store_ms, @error_message
2358
+ )
2341
2359
  `).run({
2342
2360
  ...job,
2343
2361
  tool_calls_json: job.tool_calls_json ?? null,
@@ -2346,46 +2364,46 @@ export class DashboardDB {
2346
2364
  });
2347
2365
  }
2348
2366
  markChatPersistenceInProgress(turnId, attempts, updatedAt) {
2349
- this.stmt('markChatPersistenceInProgress', `
2350
- UPDATE chat_persistence_jobs
2351
- SET status = 'in_progress', attempts = ?, updated_at = ?, error_message = NULL
2352
- WHERE turn_id = ?
2367
+ this.stmt('markChatPersistenceInProgress', `
2368
+ UPDATE chat_persistence_jobs
2369
+ SET status = 'in_progress', attempts = ?, updated_at = ?, error_message = NULL
2370
+ WHERE turn_id = ?
2353
2371
  `).run(attempts, updatedAt, turnId);
2354
2372
  }
2355
2373
  markChatPersistenceStored(turnId, storeMs, updatedAt) {
2356
- this.stmt('markChatPersistenceStored', `
2357
- UPDATE chat_persistence_jobs
2358
- SET status = 'stored', store_ms = ?, updated_at = ?, error_message = NULL
2359
- WHERE turn_id = ?
2374
+ this.stmt('markChatPersistenceStored', `
2375
+ UPDATE chat_persistence_jobs
2376
+ SET status = 'stored', store_ms = ?, updated_at = ?, error_message = NULL
2377
+ WHERE turn_id = ?
2360
2378
  `).run(storeMs, updatedAt, turnId);
2361
2379
  }
2362
2380
  markChatPersistencePendingRetry(turnId, attempts, nextAttemptAt, updatedAt, errorMessage) {
2363
- this.stmt('markChatPersistencePendingRetry', `
2364
- UPDATE chat_persistence_jobs
2365
- SET status = 'pending', attempts = ?, next_attempt_at = ?, updated_at = ?, error_message = ?
2366
- WHERE turn_id = ?
2381
+ this.stmt('markChatPersistencePendingRetry', `
2382
+ UPDATE chat_persistence_jobs
2383
+ SET status = 'pending', attempts = ?, next_attempt_at = ?, updated_at = ?, error_message = ?
2384
+ WHERE turn_id = ?
2367
2385
  `).run(attempts, nextAttemptAt, updatedAt, errorMessage, turnId);
2368
2386
  }
2369
2387
  markChatPersistenceFailed(turnId, attempts, updatedAt, errorMessage) {
2370
- this.stmt('markChatPersistenceFailed', `
2371
- UPDATE chat_persistence_jobs
2372
- SET status = 'failed', attempts = ?, updated_at = ?, error_message = ?
2373
- WHERE turn_id = ?
2388
+ this.stmt('markChatPersistenceFailed', `
2389
+ UPDATE chat_persistence_jobs
2390
+ SET status = 'failed', attempts = ?, updated_at = ?, error_message = ?
2391
+ WHERE turn_id = ?
2374
2392
  `).run(attempts, updatedAt, errorMessage, turnId);
2375
2393
  }
2376
2394
  recoverInProgressChatPersistenceJobs(now) {
2377
- this.stmt('recoverInProgressChatPersistenceJobs', `
2378
- UPDATE chat_persistence_jobs
2379
- SET status = 'pending', next_attempt_at = ?, updated_at = ?
2380
- WHERE status = 'in_progress'
2395
+ this.stmt('recoverInProgressChatPersistenceJobs', `
2396
+ UPDATE chat_persistence_jobs
2397
+ SET status = 'pending', next_attempt_at = ?, updated_at = ?
2398
+ WHERE status = 'in_progress'
2381
2399
  `).run(now, now);
2382
2400
  }
2383
2401
  getRunnableChatPersistenceJobs(now, limit = 10) {
2384
- return this.db.prepare(`
2385
- SELECT * FROM chat_persistence_jobs
2386
- WHERE status = 'pending' AND next_attempt_at <= ?
2387
- ORDER BY next_attempt_at ASC, queued_at ASC
2388
- LIMIT ?
2402
+ return this.db.prepare(`
2403
+ SELECT * FROM chat_persistence_jobs
2404
+ WHERE status = 'pending' AND next_attempt_at <= ?
2405
+ ORDER BY next_attempt_at ASC, queued_at ASC
2406
+ LIMIT ?
2389
2407
  `).all(now, limit);
2390
2408
  }
2391
2409
  getNextPendingChatPersistenceAt() {
@@ -2393,19 +2411,19 @@ export class DashboardDB {
2393
2411
  return row?.next_at ?? null;
2394
2412
  }
2395
2413
  getChatPersistenceHealth(now) {
2396
- const counts = this.db.prepare(`
2397
- SELECT
2398
- SUM(CASE WHEN status = 'pending' THEN 1 ELSE 0 END) AS pending_count,
2399
- SUM(CASE WHEN status = 'in_progress' THEN 1 ELSE 0 END) AS in_progress_count,
2400
- SUM(CASE WHEN status = 'stored' THEN 1 ELSE 0 END) AS stored_count,
2401
- SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END) AS failed_count,
2402
- SUM(CASE WHEN status = 'pending' AND next_attempt_at < ? THEN 1 ELSE 0 END) AS overdue_pending_count
2403
- FROM chat_persistence_jobs
2414
+ const counts = this.db.prepare(`
2415
+ SELECT
2416
+ SUM(CASE WHEN status = 'pending' THEN 1 ELSE 0 END) AS pending_count,
2417
+ SUM(CASE WHEN status = 'in_progress' THEN 1 ELSE 0 END) AS in_progress_count,
2418
+ SUM(CASE WHEN status = 'stored' THEN 1 ELSE 0 END) AS stored_count,
2419
+ SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END) AS failed_count,
2420
+ SUM(CASE WHEN status = 'pending' AND next_attempt_at < ? THEN 1 ELSE 0 END) AS overdue_pending_count
2421
+ FROM chat_persistence_jobs
2404
2422
  `).get(now);
2405
- const oldest = this.db.prepare(`
2406
- SELECT MIN(queued_at) AS oldest_pending_queued_at
2407
- FROM chat_persistence_jobs
2408
- WHERE status = 'pending'
2423
+ const oldest = this.db.prepare(`
2424
+ SELECT MIN(queued_at) AS oldest_pending_queued_at
2425
+ FROM chat_persistence_jobs
2426
+ WHERE status = 'pending'
2409
2427
  `).get();
2410
2428
  return {
2411
2429
  pending_count: counts?.pending_count ?? 0,
@@ -2418,9 +2436,9 @@ export class DashboardDB {
2418
2436
  }
2419
2437
  // --- Logs ---
2420
2438
  insertLog(entry) {
2421
- this.stmt('insertLog', `
2422
- INSERT INTO logs (ts, level, operation_name, operation_id, module, message)
2423
- VALUES (@ts, @level, @operation_name, @operation_id, @module, @message)
2439
+ this.stmt('insertLog', `
2440
+ INSERT INTO logs (ts, level, operation_name, operation_id, module, message)
2441
+ VALUES (@ts, @level, @operation_name, @operation_id, @module, @message)
2424
2442
  `).run({
2425
2443
  ts: entry.ts,
2426
2444
  level: entry.level,
@@ -2475,9 +2493,9 @@ export class DashboardDB {
2475
2493
  }
2476
2494
  // --- Query history ---
2477
2495
  insertQueryHistory(entry) {
2478
- this.stmt('insertQueryHistory', `
2479
- INSERT INTO query_history (ts, sparql, duration_ms, result_count, error)
2480
- VALUES (@ts, @sparql, @duration_ms, @result_count, @error)
2496
+ this.stmt('insertQueryHistory', `
2497
+ INSERT INTO query_history (ts, sparql, duration_ms, result_count, error)
2498
+ VALUES (@ts, @sparql, @duration_ms, @result_count, @error)
2481
2499
  `).run({
2482
2500
  ts: Date.now(),
2483
2501
  sparql: entry.sparql,
@@ -2521,9 +2539,9 @@ export class DashboardDB {
2521
2539
  }
2522
2540
  // --- Notifications ---
2523
2541
  insertNotification(n) {
2524
- const result = this.stmt('insertNotif', `
2525
- INSERT INTO notifications (ts, type, title, message, source, peer, read, meta, context_graph_id)
2526
- VALUES (@ts, @type, @title, @message, @source, @peer, 0, @meta, @contextGraphId)
2542
+ const result = this.stmt('insertNotif', `
2543
+ INSERT INTO notifications (ts, type, title, message, source, peer, read, meta, context_graph_id)
2544
+ VALUES (@ts, @type, @title, @message, @source, @peer, 0, @meta, @contextGraphId)
2527
2545
  `).run({
2528
2546
  ts: n.ts,
2529
2547
  type: n.type,
@@ -2559,8 +2577,8 @@ export class DashboardDB {
2559
2577
  if (cgIds.length === 0)
2560
2578
  return [];
2561
2579
  const placeholders = cgIds.map(() => '?').join(',');
2562
- return this.db.prepare(`SELECT * FROM notifications
2563
- WHERE context_graph_id IN (${placeholders})
2580
+ return this.db.prepare(`SELECT * FROM notifications
2581
+ WHERE context_graph_id IN (${placeholders})
2564
2582
  ORDER BY ts DESC LIMIT ?`).all(...cgIds, limit);
2565
2583
  }
2566
2584
  /**
@@ -2591,8 +2609,8 @@ export class DashboardDB {
2591
2609
  if (types.length === 0)
2592
2610
  return [];
2593
2611
  const placeholders = types.map(() => '?').join(',');
2594
- return this.db.prepare(`SELECT * FROM notifications
2595
- WHERE type IN (${placeholders})
2612
+ return this.db.prepare(`SELECT * FROM notifications
2613
+ WHERE type IN (${placeholders})
2596
2614
  ORDER BY ts DESC LIMIT ?`).all(...types, limit);
2597
2615
  }
2598
2616
  /**
@@ -2612,9 +2630,9 @@ export class DashboardDB {
2612
2630
  const wallet = walletAddress.trim().toLowerCase();
2613
2631
  if (!wallet)
2614
2632
  return [];
2615
- return this.db.prepare(`SELECT * FROM notifications
2616
- WHERE type = 'pca_cost_covered'
2617
- AND lower(json_extract(meta, '$.publisherAddress')) = ?
2633
+ return this.db.prepare(`SELECT * FROM notifications
2634
+ WHERE type = 'pca_cost_covered'
2635
+ AND lower(json_extract(meta, '$.publisherAddress')) = ?
2618
2636
  ORDER BY ts DESC LIMIT ?`).all(wallet, limit);
2619
2637
  }
2620
2638
  markNotificationsRead(ids) {
@@ -2644,10 +2662,10 @@ export class DashboardDB {
2644
2662
  return [];
2645
2663
  const windowStart = parsed.windowBucket * ACTIVITY_DIGEST_WINDOW_MS;
2646
2664
  const windowEnd = windowStart + ACTIVITY_DIGEST_WINDOW_MS;
2647
- const rows = this.db.prepare(`SELECT id FROM notifications
2648
- WHERE context_graph_id = ?
2649
- AND type = ?
2650
- AND ts >= ? AND ts < ?
2665
+ const rows = this.db.prepare(`SELECT id FROM notifications
2666
+ WHERE context_graph_id = ?
2667
+ AND type = ?
2668
+ AND ts >= ? AND ts < ?
2651
2669
  AND json_extract(meta, '$.kind') = ?`).all(parsed.contextGraphId, ASSERTION_ACTIVITY_TYPE, windowStart, windowEnd, parsed.kind);
2652
2670
  return rows.map((r) => r.id);
2653
2671
  }
@@ -2668,8 +2686,8 @@ export class SqliteSyncCheckpointStore {
2668
2686
  }
2669
2687
  get(key) {
2670
2688
  const now = this.clock();
2671
- const row = this.db.prepare(`SELECT offset, updated_at, expires_at,
2672
- responder_session_id, responder_session_expires_at
2689
+ const row = this.db.prepare(`SELECT offset, updated_at, expires_at,
2690
+ responder_session_id, responder_session_expires_at
2673
2691
  FROM sync_checkpoints WHERE key = ?`).get(key);
2674
2692
  if (!row)
2675
2693
  return undefined;
@@ -2699,13 +2717,13 @@ export class SqliteSyncCheckpointStore {
2699
2717
  if (!Number.isSafeInteger(value) || value < 0) {
2700
2718
  throw new Error(`Invalid sync checkpoint offset for ${key}: ${value}`);
2701
2719
  }
2702
- this.db.prepare(`
2703
- INSERT INTO sync_checkpoints (key, offset, updated_at, expires_at)
2704
- VALUES (?, ?, ?, ?)
2705
- ON CONFLICT(key) DO UPDATE SET
2706
- offset = excluded.offset,
2707
- updated_at = excluded.updated_at,
2708
- expires_at = excluded.expires_at
2720
+ this.db.prepare(`
2721
+ INSERT INTO sync_checkpoints (key, offset, updated_at, expires_at)
2722
+ VALUES (?, ?, ?, ?)
2723
+ ON CONFLICT(key) DO UPDATE SET
2724
+ offset = excluded.offset,
2725
+ updated_at = excluded.updated_at,
2726
+ expires_at = excluded.expires_at
2709
2727
  `).run(key, value, nowMs, nowMs + this.ttlMs);
2710
2728
  }
2711
2729
  setResponderSession(key, sessionId, expiresAtMs, nowMs = this.clock()) {
@@ -2716,22 +2734,22 @@ export class SqliteSyncCheckpointStore {
2716
2734
  this.clearResponderSession(key);
2717
2735
  return;
2718
2736
  }
2719
- this.db.prepare(`
2720
- INSERT INTO sync_checkpoints (
2721
- key, offset, updated_at, expires_at,
2722
- responder_session_id, responder_session_expires_at
2723
- ) VALUES (?, 0, ?, ?, ?, ?)
2724
- ON CONFLICT(key) DO UPDATE SET
2725
- responder_session_id = excluded.responder_session_id,
2726
- responder_session_expires_at = excluded.responder_session_expires_at
2737
+ this.db.prepare(`
2738
+ INSERT INTO sync_checkpoints (
2739
+ key, offset, updated_at, expires_at,
2740
+ responder_session_id, responder_session_expires_at
2741
+ ) VALUES (?, 0, ?, ?, ?, ?)
2742
+ ON CONFLICT(key) DO UPDATE SET
2743
+ responder_session_id = excluded.responder_session_id,
2744
+ responder_session_expires_at = excluded.responder_session_expires_at
2727
2745
  `).run(key, nowMs, nowMs + this.ttlMs, sessionId, expiresAtMs);
2728
2746
  }
2729
2747
  clearResponderSession(key) {
2730
- this.db.prepare(`
2731
- UPDATE sync_checkpoints
2732
- SET responder_session_id = NULL,
2733
- responder_session_expires_at = NULL
2734
- WHERE key = ?
2748
+ this.db.prepare(`
2749
+ UPDATE sync_checkpoints
2750
+ SET responder_session_id = NULL,
2751
+ responder_session_expires_at = NULL
2752
+ WHERE key = ?
2735
2753
  `).run(key);
2736
2754
  }
2737
2755
  delete(key) {
@@ -2765,13 +2783,13 @@ export class SqliteChangelogCursorStore {
2765
2783
  if (!Number.isSafeInteger(seq) || seq < 0) {
2766
2784
  throw new Error(`Invalid changelog cursor seq for ${peerId}/${contextGraphId}: ${seq}`);
2767
2785
  }
2768
- this.db.prepare(`
2769
- INSERT INTO changelog_cursors (peer_id, context_graph_id, era, seq, updated_at)
2770
- VALUES (?, ?, ?, ?, ?)
2771
- ON CONFLICT(peer_id, context_graph_id) DO UPDATE SET
2772
- era = excluded.era,
2773
- seq = excluded.seq,
2774
- updated_at = excluded.updated_at
2786
+ this.db.prepare(`
2787
+ INSERT INTO changelog_cursors (peer_id, context_graph_id, era, seq, updated_at)
2788
+ VALUES (?, ?, ?, ?, ?)
2789
+ ON CONFLICT(peer_id, context_graph_id) DO UPDATE SET
2790
+ era = excluded.era,
2791
+ seq = excluded.seq,
2792
+ updated_at = excluded.updated_at
2775
2793
  `).run(peerId, contextGraphId, era, seq, nowMs);
2776
2794
  }
2777
2795
  }
@@ -2799,13 +2817,13 @@ export class SqliteChangelogEraGuard {
2799
2817
  if (!Number.isSafeInteger(highSeq) || highSeq < 0) {
2800
2818
  throw new Error(`Invalid changelog era high_seq: ${highSeq}`);
2801
2819
  }
2802
- this.db.prepare(`
2803
- INSERT INTO changelog_era (id, era, high_seq, updated_at)
2804
- VALUES (1, ?, ?, ?)
2805
- ON CONFLICT(id) DO UPDATE SET
2806
- era = excluded.era,
2807
- high_seq = excluded.high_seq,
2808
- updated_at = excluded.updated_at
2820
+ this.db.prepare(`
2821
+ INSERT INTO changelog_era (id, era, high_seq, updated_at)
2822
+ VALUES (1, ?, ?, ?)
2823
+ ON CONFLICT(id) DO UPDATE SET
2824
+ era = excluded.era,
2825
+ high_seq = excluded.high_seq,
2826
+ updated_at = excluded.updated_at
2809
2827
  `).run(era, highSeq, this.clock());
2810
2828
  }
2811
2829
  }
@@ -2839,7 +2857,7 @@ export class SqliteMessageIdempotencyStore {
2839
2857
  }
2840
2858
  check(peer, protocol, messageId, direction) {
2841
2859
  const row = this.db
2842
- .prepare(`SELECT response_blob FROM message_idempotency
2860
+ .prepare(`SELECT response_blob FROM message_idempotency
2843
2861
  WHERE peer_id = ? AND protocol = ? AND message_id = ? AND direction = ?`)
2844
2862
  .get(peer, protocol, messageId, direction);
2845
2863
  if (!row)
@@ -2869,9 +2887,9 @@ export class SqliteMessageIdempotencyStore {
2869
2887
  // SqliteError so the substrate's bug doesn't disguise itself as
2870
2888
  // a normal duplicate.
2871
2889
  this.db
2872
- .prepare(`INSERT INTO message_idempotency
2873
- (peer_id, protocol, message_id, direction, response_blob, response_size, ts)
2874
- VALUES (?, ?, ?, ?, ?, ?, ?)
2890
+ .prepare(`INSERT INTO message_idempotency
2891
+ (peer_id, protocol, message_id, direction, response_blob, response_size, ts)
2892
+ VALUES (?, ?, ?, ?, ?, ?, ?)
2875
2893
  ON CONFLICT (peer_id, protocol, message_id, direction) DO NOTHING`)
2876
2894
  .run(peer, protocol, messageId, direction, blob, responseSize, this.clock());
2877
2895
  }
@@ -2896,15 +2914,15 @@ export class SqliteProtocolOutboxStore {
2896
2914
  }
2897
2915
  enqueue(peer, protocol, messageId, payload, error, now) {
2898
2916
  const existing = this.db
2899
- .prepare(`SELECT * FROM protocol_outbox
2917
+ .prepare(`SELECT * FROM protocol_outbox
2900
2918
  WHERE peer_id = ? AND protocol = ? AND message_id = ?`)
2901
2919
  .get(peer, protocol, messageId);
2902
2920
  if (existing) {
2903
2921
  const newAttempts = existing.attempts + 1;
2904
2922
  const nextAttemptAt = now + this.backoffFor(newAttempts);
2905
2923
  this.db
2906
- .prepare(`UPDATE protocol_outbox
2907
- SET attempts = ?, last_attempt_at = ?, next_attempt_at = ?, last_error = ?
2924
+ .prepare(`UPDATE protocol_outbox
2925
+ SET attempts = ?, last_attempt_at = ?, next_attempt_at = ?, last_error = ?
2908
2926
  WHERE peer_id = ? AND protocol = ? AND message_id = ?`)
2909
2927
  .run(newAttempts, now, nextAttemptAt, error, peer, protocol, messageId);
2910
2928
  return {
@@ -2923,9 +2941,9 @@ export class SqliteProtocolOutboxStore {
2923
2941
  const nextAttemptAt = now + this.backoffFor(attempts);
2924
2942
  const blob = Buffer.from(payload);
2925
2943
  this.db
2926
- .prepare(`INSERT INTO protocol_outbox
2927
- (peer_id, protocol, message_id, payload, attempts,
2928
- first_failure_at, last_attempt_at, next_attempt_at, last_error)
2944
+ .prepare(`INSERT INTO protocol_outbox
2945
+ (peer_id, protocol, message_id, payload, attempts,
2946
+ first_failure_at, last_attempt_at, next_attempt_at, last_error)
2929
2947
  VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
2930
2948
  .run(peer, protocol, messageId, blob, attempts, now, now, nextAttemptAt, error);
2931
2949
  return {
@@ -2942,14 +2960,14 @@ export class SqliteProtocolOutboxStore {
2942
2960
  }
2943
2961
  markDelivered(peer, protocol, messageId) {
2944
2962
  const result = this.db
2945
- .prepare(`DELETE FROM protocol_outbox
2963
+ .prepare(`DELETE FROM protocol_outbox
2946
2964
  WHERE peer_id = ? AND protocol = ? AND message_id = ?`)
2947
2965
  .run(peer, protocol, messageId);
2948
2966
  return result.changes > 0;
2949
2967
  }
2950
2968
  hasEntry(peer, protocol, messageId) {
2951
2969
  const row = this.db
2952
- .prepare(`SELECT 1 FROM protocol_outbox
2970
+ .prepare(`SELECT 1 FROM protocol_outbox
2953
2971
  WHERE peer_id = ? AND protocol = ? AND message_id = ? LIMIT 1`)
2954
2972
  .get(peer, protocol, messageId);
2955
2973
  return row !== undefined;
@@ -2959,27 +2977,27 @@ export class SqliteProtocolOutboxStore {
2959
2977
  }
2960
2978
  pendingFor(peer) {
2961
2979
  const rows = this.db
2962
- .prepare(`SELECT * FROM protocol_outbox
2963
- WHERE peer_id = ?
2980
+ .prepare(`SELECT * FROM protocol_outbox
2981
+ WHERE peer_id = ?
2964
2982
  ORDER BY first_failure_at ASC, protocol ASC, message_id ASC`)
2965
2983
  .all(peer);
2966
2984
  return rows.map(SqliteProtocolOutboxStore.rowToEntry);
2967
2985
  }
2968
2986
  due(now) {
2969
2987
  const rows = this.db
2970
- .prepare(`SELECT * FROM protocol_outbox
2971
- WHERE next_attempt_at <= ?
2972
- ORDER BY next_attempt_at ASC, first_failure_at ASC,
2988
+ .prepare(`SELECT * FROM protocol_outbox
2989
+ WHERE next_attempt_at <= ?
2990
+ ORDER BY next_attempt_at ASC, first_failure_at ASC,
2973
2991
  peer_id ASC, protocol ASC, message_id ASC`)
2974
2992
  .all(now);
2975
2993
  return rows.map(SqliteProtocolOutboxStore.rowToEntry);
2976
2994
  }
2977
2995
  duePage(now, limit) {
2978
2996
  const rows = this.db
2979
- .prepare(`SELECT * FROM protocol_outbox
2980
- WHERE next_attempt_at <= ?
2981
- ORDER BY next_attempt_at ASC, first_failure_at ASC,
2982
- peer_id ASC, protocol ASC, message_id ASC
2997
+ .prepare(`SELECT * FROM protocol_outbox
2998
+ WHERE next_attempt_at <= ?
2999
+ ORDER BY next_attempt_at ASC, first_failure_at ASC,
3000
+ peer_id ASC, protocol ASC, message_id ASC
2983
3001
  LIMIT ?`)
2984
3002
  .all(now, limit);
2985
3003
  return rows.map(SqliteProtocolOutboxStore.rowToEntry);
@@ -3069,9 +3087,9 @@ export class SqliteKaNumberStore {
3069
3087
  // `safeIntegers(true)` opts INTO bigint returns so the counter is
3070
3088
  // exact past `Number.MAX_SAFE_INTEGER` (codex PR #976 F6).
3071
3089
  const row = this.db
3072
- .prepare(`INSERT INTO ka_numbers (author_address, next_number)
3073
- VALUES (?, 1)
3074
- ON CONFLICT(author_address) DO UPDATE SET next_number = next_number + 1
3090
+ .prepare(`INSERT INTO ka_numbers (author_address, next_number)
3091
+ VALUES (?, 1)
3092
+ ON CONFLICT(author_address) DO UPDATE SET next_number = next_number + 1
3075
3093
  RETURNING next_number - 1 AS number`)
3076
3094
  .safeIntegers(true)
3077
3095
  .get(author);
@@ -3083,9 +3101,9 @@ export class SqliteKaNumberStore {
3083
3101
  // `excluded.next_number` is the proposed floor from the VALUES row.
3084
3102
  // `better-sqlite3` accepts bigint statement parameters natively.
3085
3103
  this.db
3086
- .prepare(`INSERT INTO ka_numbers (author_address, next_number)
3087
- VALUES (?, ?)
3088
- ON CONFLICT(author_address) DO UPDATE SET
3104
+ .prepare(`INSERT INTO ka_numbers (author_address, next_number)
3105
+ VALUES (?, ?)
3106
+ ON CONFLICT(author_address) DO UPDATE SET
3089
3107
  next_number = MAX(next_number, excluded.next_number)`)
3090
3108
  .run(author, nextNumberFloor);
3091
3109
  }