pmx-canvas 0.3.0 → 0.3.1

package/src/server/canvas-db.ts

@@ -358,7 +358,10 @@ export function saveStateToDB(db: Database, state: PersistedCanvasState): void {
       insertPin.run(pinId);
     }
 
-    db.run('INSERT INTO ax_state (key, value) VALUES (?, ?)', ['state', JSON.stringify(state.ax ?? createEmptyAxState())]);
+    db.run('INSERT INTO ax_state (key, value) VALUES (?, ?)', [
+      'state',
+      JSON.stringify(state.ax ?? createEmptyAxState()),
+    ]);
   });
 
   transaction();
@@ -366,14 +369,14 @@ export function saveStateToDB(db: Database, state: PersistedCanvasState): void {
 
 /** Check if the DB has been populated with canvas state at least once. */
 export function isDbPopulated(db: Database): boolean {
-  const row = db.query<{ value: string }, [string]>(
-    'SELECT value FROM meta WHERE key = ?',
-  ).get('state_populated');
+  const row = db.query<{ value: string }, [string]>('SELECT value FROM meta WHERE key = ?').get('state_populated');
   return row?.value === '1';
 }
 
 export function loadStateFromDB(db: Database): PersistedCanvasState | null {
-  const schemaVersion = db.query<{ value: string }, [string]>('SELECT value FROM meta WHERE key = ?').get('schema_version');
+  const schemaVersion = db
+    .query<{ value: string }, [string]>('SELECT value FROM meta WHERE key = ?')
+    .get('schema_version');
   if (!schemaVersion) return null;
 
   // Load viewport
@@ -464,7 +467,9 @@ export function loadStateFromDB(db: Database): PersistedCanvasState | null {
   }));
 
   // Load context pins
-  interface PinRow { node_id: string }
+  interface PinRow {
+    node_id: string;
+  }
   const pinRows = db.query<PinRow, []>('SELECT node_id FROM context_pins').all();
   const contextPins = pinRows.map((row) => row.node_id);
 
@@ -484,23 +489,38 @@ export function loadStateFromDB(db: Database): PersistedCanvasState | null {
 
 // ── Snapshot Persistence ────────────────────────────────────────
 
-export function saveSnapshotToDB(
-  db: Database,
-  snapshot: CanvasSnapshot,
-  state: PersistedCanvasState,
-): void {
+export function saveSnapshotToDB(db: Database, snapshot: CanvasSnapshot, state: PersistedCanvasState): void {
   const transaction = db.transaction(() => {
     // Insert snapshot metadata
-    db.run(
-      'INSERT INTO snapshots (id, name, created_at, node_count, edge_count) VALUES (?, ?, ?, ?, ?)',
-      [snapshot.id, snapshot.name, snapshot.createdAt, state.nodes.length, state.edges.length],
-    );
+    db.run('INSERT INTO snapshots (id, name, created_at, node_count, edge_count) VALUES (?, ?, ?, ?, ?)', [
+      snapshot.id,
+      snapshot.name,
+      snapshot.createdAt,
+      state.nodes.length,
+      state.edges.length,
+    ]);
 
     // Insert snapshot viewport meta
-    db.run('INSERT INTO snapshot_meta (snapshot_id, key, value) VALUES (?, ?, ?)', [snapshot.id, 'viewport_x', String(state.viewport.x)]);
-    db.run('INSERT INTO snapshot_meta (snapshot_id, key, value) VALUES (?, ?, ?)', [snapshot.id, 'viewport_y', String(state.viewport.y)]);
-    db.run('INSERT INTO snapshot_meta (snapshot_id, key, value) VALUES (?, ?, ?)', [snapshot.id, 'viewport_scale', String(state.viewport.scale)]);
-    db.run('INSERT INTO snapshot_meta (snapshot_id, key, value) VALUES (?, ?, ?)', [snapshot.id, 'ax_state', JSON.stringify(state.ax ?? createEmptyAxState())]);
+    db.run('INSERT INTO snapshot_meta (snapshot_id, key, value) VALUES (?, ?, ?)', [
+      snapshot.id,
+      'viewport_x',
+      String(state.viewport.x),
+    ]);
+    db.run('INSERT INTO snapshot_meta (snapshot_id, key, value) VALUES (?, ?, ?)', [
+      snapshot.id,
+      'viewport_y',
+      String(state.viewport.y),
+    ]);
+    db.run('INSERT INTO snapshot_meta (snapshot_id, key, value) VALUES (?, ?, ?)', [
+      snapshot.id,
+      'viewport_scale',
+      String(state.viewport.scale),
+    ]);
+    db.run('INSERT INTO snapshot_meta (snapshot_id, key, value) VALUES (?, ?, ?)', [
+      snapshot.id,
+      'ax_state',
+      JSON.stringify(state.ax ?? createEmptyAxState()),
+    ]);
 
     // Insert snapshot nodes
     const insertNode = db.prepare(
@@ -584,14 +604,12 @@ export function loadSnapshotFromDB(
     node_count: number;
     edge_count: number;
   }
-  let snapshotRow = db.query<SnapshotRow, [string]>(
-    'SELECT * FROM snapshots WHERE id = ?',
-  ).get(idOrName);
+  let snapshotRow = db.query<SnapshotRow, [string]>('SELECT * FROM snapshots WHERE id = ?').get(idOrName);
 
   if (!snapshotRow) {
-    snapshotRow = db.query<SnapshotRow, [string]>(
-      'SELECT * FROM snapshots WHERE name = ? ORDER BY created_at DESC LIMIT 1',
-    ).get(idOrName);
+    snapshotRow = db
+      .query<SnapshotRow, [string]>('SELECT * FROM snapshots WHERE name = ? ORDER BY created_at DESC LIMIT 1')
+      .get(idOrName);
   }
 
   if (!snapshotRow) return null;
@@ -605,10 +623,13 @@ export function loadSnapshotFromDB(
   };
 
   // Load snapshot viewport
-  interface MetaRow { key: string; value: string }
-  const metaRows = db.query<MetaRow, [string]>(
-    'SELECT key, value FROM snapshot_meta WHERE snapshot_id = ?',
-  ).all(snapshotRow.id);
+  interface MetaRow {
+    key: string;
+    value: string;
+  }
+  const metaRows = db
+    .query<MetaRow, [string]>('SELECT key, value FROM snapshot_meta WHERE snapshot_id = ?')
+    .all(snapshotRow.id);
   const metaMap = new Map(metaRows.map((r) => [r.key, r.value]));
 
   const viewport: ViewportState = {
@@ -631,9 +652,9 @@ export function loadSnapshotFromDB(
     dock_position: string | null;
     data: string;
   }
-  const nodeRows = db.query<NodeRow, [string]>(
-    'SELECT * FROM snapshot_nodes WHERE snapshot_id = ?',
-  ).all(snapshotRow.id);
+  const nodeRows = db
+    .query<NodeRow, [string]>('SELECT * FROM snapshot_nodes WHERE snapshot_id = ?')
+    .all(snapshotRow.id);
   const nodes: CanvasNodeState[] = nodeRows.map((row) => ({
     id: row.id,
     type: row.type as CanvasNodeState['type'],
@@ -656,9 +677,9 @@ export function loadSnapshotFromDB(
     style: string | null;
     animated: number;
   }
-  const edgeRows = db.query<EdgeRow, [string]>(
-    'SELECT * FROM snapshot_edges WHERE snapshot_id = ?',
-  ).all(snapshotRow.id);
+  const edgeRows = db
+    .query<EdgeRow, [string]>('SELECT * FROM snapshot_edges WHERE snapshot_id = ?')
+    .all(snapshotRow.id);
   const edges: CanvasEdge[] = edgeRows.map((row) => ({
     id: row.id,
     from: row.from_node,
@@ -681,9 +702,9 @@ export function loadSnapshotFromDB(
     label: string | null;
     created_at: string;
   }
-  const annotationRows = db.query<AnnotationRow, [string]>(
-    'SELECT * FROM snapshot_annotations WHERE snapshot_id = ?',
-  ).all(snapshotRow.id);
+  const annotationRows = db
+    .query<AnnotationRow, [string]>('SELECT * FROM snapshot_annotations WHERE snapshot_id = ?')
+    .all(snapshotRow.id);
   const annotations: CanvasAnnotation[] = annotationRows.map((row) => ({
     id: row.id,
     type: row.type as CanvasAnnotation['type'],
@@ -697,10 +718,12 @@ export function loadSnapshotFromDB(
   }));
 
   // Load snapshot pins
-  interface PinRow { node_id: string }
-  const pinRows = db.query<PinRow, [string]>(
-    'SELECT node_id FROM snapshot_pins WHERE snapshot_id = ?',
-  ).all(snapshotRow.id);
+  interface PinRow {
+    node_id: string;
+  }
+  const pinRows = db
+    .query<PinRow, [string]>('SELECT node_id FROM snapshot_pins WHERE snapshot_id = ?')
+    .all(snapshotRow.id);
   const contextPins = pinRows.map((row) => row.node_id);
 
   return {
@@ -782,27 +805,29 @@ export function deleteSnapshotFromDB(db: Database, id: string): boolean {
 
 export function writeBlobToDB(db: Database, sha256: string, jsonValue: string): number {
   const compressed = gzipSync(jsonValue);
-  db.run(
-    'INSERT OR IGNORE INTO blobs (sha256, data, json_bytes) VALUES (?, ?, ?)',
-    [sha256, compressed, Buffer.byteLength(jsonValue)],
-  );
+  db.run('INSERT OR IGNORE INTO blobs (sha256, data, json_bytes) VALUES (?, ?, ?)', [
+    sha256,
+    compressed,
+    Buffer.byteLength(jsonValue),
+  ]);
   return compressed.byteLength;
 }
 
 export function readBlobFromDB(db: Database, sha256: string): string | null {
-  interface BlobRow { data: Buffer; json_bytes: number }
-  const row = db.query<BlobRow, [string]>(
-    'SELECT data, json_bytes FROM blobs WHERE sha256 = ?',
-  ).get(sha256);
+  interface BlobRow {
+    data: Buffer;
+    json_bytes: number;
+  }
+  const row = db.query<BlobRow, [string]>('SELECT data, json_bytes FROM blobs WHERE sha256 = ?').get(sha256);
   if (!row) return null;
   return gunzipSync(row.data).toString('utf-8');
 }
 
 export function hasBlobInDB(db: Database, sha256: string): boolean {
-  interface CountRow { c: number }
-  const row = db.query<CountRow, [string]>(
-    'SELECT COUNT(*) as c FROM blobs WHERE sha256 = ?',
-  ).get(sha256);
+  interface CountRow {
+    c: number;
+  }
+  const row = db.query<CountRow, [string]>('SELECT COUNT(*) as c FROM blobs WHERE sha256 = ?').get(sha256);
   return (row?.c ?? 0) > 0;
 }
 
@@ -828,10 +853,9 @@ function clampTimelineLimit(limit: number | undefined): number {
 }
 
 function trimAxTable(db: Database, table: 'ax_events' | 'ax_evidence' | 'ax_steering'): void {
-  db.run(
-    `DELETE FROM ${table} WHERE seq <= (SELECT seq FROM ${table} ORDER BY seq DESC LIMIT 1 OFFSET ?)`,
-    [AX_TIMELINE_RETENTION],
-  );
+  db.run(`DELETE FROM ${table} WHERE seq <= (SELECT seq FROM ${table} ORDER BY seq DESC LIMIT 1 OFFSET ?)`, [
+    AX_TIMELINE_RETENTION,
+  ]);
 }
 
 function readLastSeq(db: Database, table: 'ax_events' | 'ax_evidence' | 'ax_steering'): number {
@@ -842,7 +866,16 @@ function readLastSeq(db: Database, table: 'ax_events' | 'ax_evidence' | 'ax_stee
 export function appendAxEventToDB(db: Database, ev: Omit<PmxAxEvent, 'seq'>): PmxAxEvent {
   db.run(
     'INSERT INTO ax_events (id, kind, summary, detail, node_ids, data, created_at, source) VALUES (?, ?, ?, ?, ?, ?, ?, ?)',
-    [ev.id, ev.kind, ev.summary, ev.detail, JSON.stringify(ev.nodeIds), ev.data ? JSON.stringify(ev.data) : null, ev.createdAt, ev.source],
+    [
+      ev.id,
+      ev.kind,
+      ev.summary,
+      ev.detail,
+      JSON.stringify(ev.nodeIds),
+      ev.data ? JSON.stringify(ev.data) : null,
+      ev.createdAt,
+      ev.source,
+    ],
   );
   const seq = readLastSeq(db, 'ax_events');
   trimAxTable(db, 'ax_events');
@@ -852,7 +885,17 @@ export function appendAxEventToDB(db: Database, ev: Omit<PmxAxEvent, 'seq'>): Pm
 export function appendAxEvidenceToDB(db: Database, ev: Omit<PmxAxEvidence, 'seq'>): PmxAxEvidence {
   db.run(
     'INSERT INTO ax_evidence (id, kind, title, body, ref, node_ids, data, created_at, source) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)',
-    [ev.id, ev.kind, ev.title, ev.body, ev.ref, JSON.stringify(ev.nodeIds), ev.data ? JSON.stringify(ev.data) : null, ev.createdAt, ev.source],
+    [
+      ev.id,
+      ev.kind,
+      ev.title,
+      ev.body,
+      ev.ref,
+      JSON.stringify(ev.nodeIds),
+      ev.data ? JSON.stringify(ev.data) : null,
+      ev.createdAt,
+      ev.source,
+    ],
   );
   const seq = readLastSeq(db, 'ax_evidence');
   trimAxTable(db, 'ax_evidence');
@@ -860,10 +903,13 @@ export function appendAxEvidenceToDB(db: Database, ev: Omit<PmxAxEvidence, 'seq'
 }
 
 export function appendAxSteeringToDB(db: Database, s: Omit<PmxAxSteeringMessage, 'seq'>): PmxAxSteeringMessage {
-  db.run(
-    'INSERT INTO ax_steering (id, message, delivered, created_at, source) VALUES (?, ?, ?, ?, ?)',
-    [s.id, s.message, s.delivered ? 1 : 0, s.createdAt, s.source],
-  );
+  db.run('INSERT INTO ax_steering (id, message, delivered, created_at, source) VALUES (?, ?, ?, ?, ?)', [
+    s.id,
+    s.message,
+    s.delivered ? 1 : 0,
+    s.createdAt,
+    s.source,
+  ]);
   const seq = readLastSeq(db, 'ax_steering');
   trimAxTable(db, 'ax_steering');
   return { ...s, seq };
@@ -875,23 +921,72 @@ export function markAxSteeringDeliveredInDB(db: Database, id: string): boolean {
 }
 
 export function loadAxEventsFromDB(db: Database, q: AxTimelineQuery = {}): PmxAxEvent[] {
-  interface Row { seq: number; id: string; kind: string; summary: string; detail: string | null; node_ids: string; data: string | null; created_at: string; source: string | null }
-  const rows = db.query<Row, [number]>('SELECT * FROM ax_events ORDER BY seq DESC LIMIT ?').all(clampTimelineLimit(q.limit));
+  interface Row {
+    seq: number;
+    id: string;
+    kind: string;
+    summary: string;
+    detail: string | null;
+    node_ids: string;
+    data: string | null;
+    created_at: string;
+    source: string | null;
+  }
+  const rows = db
+    .query<Row, [number]>('SELECT * FROM ax_events ORDER BY seq DESC LIMIT ?')
+    .all(clampTimelineLimit(q.limit));
   return rows
-    .map((r) => normalizeAxEvent({ ...r, createdAt: r.created_at, nodeIds: safeParseJson(r.node_ids), data: safeParseJson(r.data) }))
+    .map((r) =>
+      normalizeAxEvent({
+        ...r,
+        createdAt: r.created_at,
+        nodeIds: safeParseJson(r.node_ids),
+        data: safeParseJson(r.data),
+      }),
+    )
     .filter((e): e is PmxAxEvent => e !== null);
 }
 
 export function loadAxEvidenceFromDB(db: Database, q: AxTimelineQuery = {}): PmxAxEvidence[] {
-  interface Row { seq: number; id: string; kind: string; title: string; body: string | null; ref: string | null; node_ids: string; data: string | null; created_at: string; source: string | null }
-  const rows = db.query<Row, [number]>('SELECT * FROM ax_evidence ORDER BY seq DESC LIMIT ?').all(clampTimelineLimit(q.limit));
+  interface Row {
+    seq: number;
+    id: string;
+    kind: string;
+    title: string;
+    body: string | null;
+    ref: string | null;
+    node_ids: string;
+    data: string | null;
+    created_at: string;
+    source: string | null;
+  }
+  const rows = db
+    .query<Row, [number]>('SELECT * FROM ax_evidence ORDER BY seq DESC LIMIT ?')
+    .all(clampTimelineLimit(q.limit));
   return rows
-    .map((r) => normalizeAxEvidence({ ...r, createdAt: r.created_at, nodeIds: safeParseJson(r.node_ids), data: safeParseJson(r.data) }))
+    .map((r) =>
+      normalizeAxEvidence({
+        ...r,
+        createdAt: r.created_at,
+        nodeIds: safeParseJson(r.node_ids),
+        data: safeParseJson(r.data),
+      }),
+    )
     .filter((e): e is PmxAxEvidence => e !== null);
 }
 
-export function loadAxSteeringFromDB(db: Database, q: AxTimelineQuery & { onlyPending?: boolean } = {}): PmxAxSteeringMessage[] {
-  interface Row { seq: number; id: string; message: string; delivered: number; created_at: string; source: string | null }
+export function loadAxSteeringFromDB(
+  db: Database,
+  q: AxTimelineQuery & { onlyPending?: boolean } = {},
+): PmxAxSteeringMessage[] {
+  interface Row {
+    seq: number;
+    id: string;
+    message: string;
+    delivered: number;
+    created_at: string;
+    source: string | null;
+  }
   const sql = q.onlyPending
     ? 'SELECT * FROM ax_steering WHERE delivered = 0 ORDER BY seq DESC LIMIT ?'
     : 'SELECT * FROM ax_steering ORDER BY seq DESC LIMIT ?';
@@ -905,17 +1000,24 @@ export function loadPendingAxSteeringFromDB(
   db: Database,
   options: { consumer?: string; limit?: number } = {},
 ): PmxAxSteeringMessage[] {
-  interface Row { seq: number; id: string; message: string; delivered: number; created_at: string; source: string | null }
+  interface Row {
+    seq: number;
+    id: string;
+    message: string;
+    delivered: number;
+    created_at: string;
+    source: string | null;
+  }
   // FIFO (oldest undelivered first); exclude the consumer's own steering in SQL
   // so the LIMIT is applied AFTER loop-prevention, not before.
   const limit = clampTimelineLimit(options.limit);
   const rows = options.consumer
-    ? db.query<Row, [string, number]>(
-        'SELECT * FROM ax_steering WHERE delivered = 0 AND (source IS NULL OR source != ?) ORDER BY seq ASC LIMIT ?',
-      ).all(options.consumer, limit)
-    : db.query<Row, [number]>(
-        'SELECT * FROM ax_steering WHERE delivered = 0 ORDER BY seq ASC LIMIT ?',
-      ).all(limit);
+    ? db
+        .query<Row, [string, number]>(
+          'SELECT * FROM ax_steering WHERE delivered = 0 AND (source IS NULL OR source != ?) ORDER BY seq ASC LIMIT ?',
+        )
+        .all(options.consumer, limit)
+    : db.query<Row, [number]>('SELECT * FROM ax_steering WHERE delivered = 0 ORDER BY seq ASC LIMIT ?').all(limit);
   return rows
     .map((r) => normalizeAxSteeringMessage({ ...r, createdAt: r.created_at, delivered: r.delivered === 1 }))
     .filter((s): s is PmxAxSteeringMessage => s !== null);
@@ -932,15 +1034,22 @@ export function loadNewestPendingAxSteeringFromDB(
   db: Database,
   options: { consumer?: string; limit?: number } = {},
 ): PmxAxSteeringMessage[] {
-  interface Row { seq: number; id: string; message: string; delivered: number; created_at: string; source: string | null }
+  interface Row {
+    seq: number;
+    id: string;
+    message: string;
+    delivered: number;
+    created_at: string;
+    source: string | null;
+  }
   const limit = clampTimelineLimit(options.limit);
   const rows = options.consumer
-    ? db.query<Row, [string, number]>(
-        'SELECT * FROM ax_steering WHERE delivered = 0 AND (source IS NULL OR source != ?) ORDER BY seq DESC LIMIT ?',
-      ).all(options.consumer, limit)
-    : db.query<Row, [number]>(
-        'SELECT * FROM ax_steering WHERE delivered = 0 ORDER BY seq DESC LIMIT ?',
-      ).all(limit);
+    ? db
+        .query<Row, [string, number]>(
+          'SELECT * FROM ax_steering WHERE delivered = 0 AND (source IS NULL OR source != ?) ORDER BY seq DESC LIMIT ?',
+        )
+        .all(options.consumer, limit)
+    : db.query<Row, [number]>('SELECT * FROM ax_steering WHERE delivered = 0 ORDER BY seq DESC LIMIT ?').all(limit);
   return rows
     .map((r) => normalizeAxSteeringMessage({ ...r, createdAt: r.created_at, delivered: r.delivered === 1 }))
     .filter((s): s is PmxAxSteeringMessage => s !== null);
@@ -949,9 +1058,11 @@ export function loadNewestPendingAxSteeringFromDB(
 /** Total undelivered steering for a consumer (loop-safe — excludes the consumer's own). */
 export function countPendingAxSteeringFromDB(db: Database, consumer?: string): number {
   const n = consumer
-    ? db.query<{ n: number }, [string]>(
-        'SELECT COUNT(*) AS n FROM ax_steering WHERE delivered = 0 AND (source IS NULL OR source != ?)',
-      ).get(consumer)?.n
+    ? db
+        .query<{ n: number }, [string]>(
+          'SELECT COUNT(*) AS n FROM ax_steering WHERE delivered = 0 AND (source IS NULL OR source != ?)',
+        )
+        .get(consumer)?.n
     : db.query<{ n: number }, []>('SELECT COUNT(*) AS n FROM ax_steering WHERE delivered = 0').get()?.n;
   return Number(n ?? 0);
 }
@@ -965,19 +1076,26 @@ export function loadAxTimelineSummaryFromDB(db: Database): PmxAxTimelineSummary
     recentEvents: loadAxEventsFromDB(db, { limit: AX_CONTEXT_EVENT_LIMIT }),
     recentEvidence: loadAxEvidenceFromDB(db, { limit: AX_CONTEXT_EVIDENCE_LIMIT }),
     pendingSteering: loadAxSteeringFromDB(db, { onlyPending: true, limit: AX_CONTEXT_STEERING_LIMIT }),
-    counts: { events: countRows(db, 'ax_events'), evidence: countRows(db, 'ax_evidence'), steering: countRows(db, 'ax_steering') },
+    counts: {
+      events: countRows(db, 'ax_events'),
+      evidence: countRows(db, 'ax_evidence'),
+      steering: countRows(db, 'ax_steering'),
+    },
   };
 }
 
 export function upsertAxHostCapabilityToDB(db: Database, cap: PmxAxHostCapability): void {
   const host = cap.host ?? 'default';
-  db.run(
-    'INSERT OR REPLACE INTO ax_host_capabilities (host, reported_at, payload) VALUES (?, ?, ?)',
-    [host, cap.reportedAt ?? new Date().toISOString(), JSON.stringify(cap)],
-  );
+  db.run('INSERT OR REPLACE INTO ax_host_capabilities (host, reported_at, payload) VALUES (?, ?, ?)', [
+    host,
+    cap.reportedAt ?? new Date().toISOString(),
+    JSON.stringify(cap),
+  ]);
 }
 
 export function loadAxHostCapabilityFromDB(db: Database): PmxAxHostCapability | null {
-  const row = db.query<{ payload: string }, []>('SELECT payload FROM ax_host_capabilities ORDER BY reported_at DESC LIMIT 1').get();
+  const row = db
+    .query<{ payload: string }, []>('SELECT payload FROM ax_host_capabilities ORDER BY reported_at DESC LIMIT 1')
+    .get();
   return row ? normalizeAxHostCapability(safeParseJson(row.payload)) : null;
 }