@soleri/core 2.4.0 → 2.6.0

package/src/control/identity-manager.ts

@@ -2,11 +2,13 @@
  * IdentityManager — Agent identity CRUD with versioning and rollback.
  *
  * Follows the Curator/BrainIntelligence pattern: separate class, own SQLite
- * tables, takes Vault as constructor dep. All methods synchronous (better-sqlite3).
+ * tables, takes Vault as constructor dep. Uses PersistenceProvider abstraction
+ * for all database access.
  */
 
 import { randomUUID } from 'node:crypto';
 import type { Vault } from '../vault/vault.js';
+import type { PersistenceProvider } from '../persistence/types.js';
 import type {
   AgentIdentity,
   IdentityVersion,
@@ -20,17 +22,18 @@ import type {
 
 export class IdentityManager {
   private vault: Vault;
+  private provider: PersistenceProvider;
 
   constructor(vault: Vault) {
     this.vault = vault;
+    this.provider = vault.getProvider();
     this.initializeTables();
   }
 
   // ─── Table Initialization ───────────────────────────────────────────
 
   private initializeTables(): void {
-    const db = this.vault.getDb();
-    db.exec(`
+    this.provider.execSql(`
       CREATE TABLE IF NOT EXISTS agent_identity (
         agent_id TEXT PRIMARY KEY,
         name TEXT NOT NULL,
@@ -38,7 +41,7 @@ export class IdentityManager {
         description TEXT NOT NULL DEFAULT '',
         personality TEXT NOT NULL DEFAULT '[]',
         version INTEGER NOT NULL DEFAULT 1,
-        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+        updated_at INTEGER NOT NULL DEFAULT (unixepoch())
       );
 
       CREATE TABLE IF NOT EXISTS agent_identity_versions (
@@ -48,7 +51,7 @@ export class IdentityManager {
         snapshot TEXT NOT NULL,
         changed_by TEXT NOT NULL DEFAULT 'system',
         change_reason TEXT NOT NULL DEFAULT '',
-        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        created_at INTEGER NOT NULL DEFAULT (unixepoch()),
         UNIQUE(agent_id, version)
       );
 
@@ -58,8 +61,8 @@ export class IdentityManager {
         category TEXT NOT NULL CHECK(category IN ('behavior', 'preference', 'restriction', 'style')),
         text TEXT NOT NULL,
         priority INTEGER NOT NULL DEFAULT 0,
-        created_at TEXT NOT NULL DEFAULT (datetime('now')),
-        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+        created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+        updated_at INTEGER NOT NULL DEFAULT (unixepoch())
       );
 
       CREATE INDEX IF NOT EXISTS idx_guidelines_agent
@@ -72,10 +75,9 @@ export class IdentityManager {
   // ─── Identity CRUD ──────────────────────────────────────────────────
 
   getIdentity(agentId: string): AgentIdentity | null {
-    const db = this.vault.getDb();
-    const row = db.prepare('SELECT * FROM agent_identity WHERE agent_id = ?').get(agentId) as
-      | IdentityRow
-      | undefined;
+    const row = this.provider.get<IdentityRow>('SELECT * FROM agent_identity WHERE agent_id = ?', [
+      agentId,
+    ]);
     if (!row) return null;
 
     const guidelines = this.getGuidelines(agentId);
@@ -83,25 +85,25 @@ export class IdentityManager {
   }
 
   setIdentity(agentId: string, input: IdentityUpdateInput): AgentIdentity {
-    const db = this.vault.getDb();
-
-    db.transaction(() => {
-      const existing = db.prepare('SELECT * FROM agent_identity WHERE agent_id = ?').get(agentId) as
-        | IdentityRow
-        | undefined;
+    this.provider.transaction(() => {
+      const existing = this.provider.get<IdentityRow>(
+        'SELECT * FROM agent_identity WHERE agent_id = ?',
+        [agentId],
+      );
 
       if (existing) {
         // Snapshot current state before updating
         const snapshot = JSON.stringify(rowToIdentitySnapshot(existing));
-        db.prepare(
+        this.provider.run(
           `INSERT INTO agent_identity_versions (agent_id, version, snapshot, changed_by, change_reason)
            VALUES (?, ?, ?, ?, ?)`,
-        ).run(
-          agentId,
-          existing.version,
-          snapshot,
-          input.changedBy ?? 'system',
-          input.changeReason ?? '',
+          [
+            agentId,
+            existing.version,
+            snapshot,
+            input.changedBy ?? 'system',
+            input.changeReason ?? '',
+          ],
         );
 
         const newVersion = existing.version + 1;
@@ -112,12 +114,13 @@ export class IdentityManager {
           ? JSON.stringify(input.personality)
           : existing.personality;
 
-        db.prepare(
+        this.provider.run(
           `UPDATE agent_identity
            SET name = ?, role = ?, description = ?, personality = ?,
-               version = ?, updated_at = datetime('now')
+               version = ?, updated_at = unixepoch()
            WHERE agent_id = ?`,
-        ).run(name, role, description, personality, newVersion, agentId);
+          [name, role, description, personality, newVersion, agentId],
+        );
       } else {
         // First identity creation — version 1
         const name = input.name ?? agentId;
@@ -125,12 +128,13 @@ export class IdentityManager {
         const description = input.description ?? '';
         const personality = JSON.stringify(input.personality ?? []);
 
-        db.prepare(
+        this.provider.run(
           `INSERT INTO agent_identity (agent_id, name, role, description, personality, version)
            VALUES (?, ?, ?, ?, ?, 1)`,
-        ).run(agentId, name, role, description, personality);
+          [agentId, name, role, description, personality],
+        );
       }
-    })();
+    });
 
     return this.getIdentity(agentId)!;
   }
@@ -138,94 +142,92 @@ export class IdentityManager {
   // ─── Guidelines ─────────────────────────────────────────────────────
 
   addGuideline(agentId: string, input: GuidelineInput): Guideline {
-    const db = this.vault.getDb();
     const id = randomUUID();
     const priority = input.priority ?? 0;
 
-    db.prepare(
+    this.provider.run(
       `INSERT INTO agent_guidelines (id, agent_id, category, text, priority)
        VALUES (?, ?, ?, ?, ?)`,
-    ).run(id, agentId, input.category, input.text, priority);
+      [id, agentId, input.category, input.text, priority],
+    );
 
-    const row = db.prepare('SELECT * FROM agent_guidelines WHERE id = ?').get(id) as GuidelineRow;
-    return rowToGuideline(row);
+    const row = this.provider.get<GuidelineRow>('SELECT * FROM agent_guidelines WHERE id = ?', [
+      id,
+    ]);
+    return rowToGuideline(row!);
   }
 
   removeGuideline(guidelineId: string): boolean {
-    const db = this.vault.getDb();
-    const result = db.prepare('DELETE FROM agent_guidelines WHERE id = ?').run(guidelineId);
+    const result = this.provider.run('DELETE FROM agent_guidelines WHERE id = ?', [guidelineId]);
     return result.changes > 0;
   }
 
   getGuidelines(agentId: string, category?: GuidelineCategory): Guideline[] {
-    const db = this.vault.getDb();
     if (category) {
-      const rows = db
-        .prepare(
-          'SELECT * FROM agent_guidelines WHERE agent_id = ? AND category = ? ORDER BY priority DESC, created_at ASC',
-        )
-        .all(agentId, category) as GuidelineRow[];
+      const rows = this.provider.all<GuidelineRow>(
+        'SELECT * FROM agent_guidelines WHERE agent_id = ? AND category = ? ORDER BY priority DESC, created_at ASC',
+        [agentId, category],
+      );
       return rows.map(rowToGuideline);
     }
-    const rows = db
-      .prepare(
-        'SELECT * FROM agent_guidelines WHERE agent_id = ? ORDER BY priority DESC, created_at ASC',
-      )
-      .all(agentId) as GuidelineRow[];
+    const rows = this.provider.all<GuidelineRow>(
+      'SELECT * FROM agent_guidelines WHERE agent_id = ? ORDER BY priority DESC, created_at ASC',
+      [agentId],
+    );
     return rows.map(rowToGuideline);
   }
 
   // ─── Versioning ─────────────────────────────────────────────────────
 
   getVersionHistory(agentId: string, limit = 20): IdentityVersion[] {
-    const db = this.vault.getDb();
-    const rows = db
-      .prepare(
-        'SELECT * FROM agent_identity_versions WHERE agent_id = ? ORDER BY version DESC LIMIT ?',
-      )
-      .all(agentId, limit) as VersionRow[];
+    const rows = this.provider.all<VersionRow>(
+      'SELECT * FROM agent_identity_versions WHERE agent_id = ? ORDER BY version DESC LIMIT ?',
+      [agentId, limit],
+    );
     return rows.map(rowToVersion);
   }
 
   rollback(agentId: string, version: number): AgentIdentity {
-    const db = this.vault.getDb();
-
-    db.transaction(() => {
-      const versionRow = db
-        .prepare('SELECT * FROM agent_identity_versions WHERE agent_id = ? AND version = ?')
-        .get(agentId, version) as VersionRow | undefined;
+    this.provider.transaction(() => {
+      const versionRow = this.provider.get<VersionRow>(
+        'SELECT * FROM agent_identity_versions WHERE agent_id = ? AND version = ?',
+        [agentId, version],
+      );
 
       if (!versionRow) {
         throw new Error(`Version ${version} not found for agent ${agentId}`);
       }
 
       const snapshot = JSON.parse(versionRow.snapshot) as IdentitySnapshot;
-      const current = db
-        .prepare('SELECT * FROM agent_identity WHERE agent_id = ?')
-        .get(agentId) as IdentityRow;
+      const current = this.provider.get<IdentityRow>(
+        'SELECT * FROM agent_identity WHERE agent_id = ?',
+        [agentId],
+      )!;
 
       // Snapshot current state before rollback
       const currentSnapshot = JSON.stringify(rowToIdentitySnapshot(current));
-      db.prepare(
+      this.provider.run(
         `INSERT INTO agent_identity_versions (agent_id, version, snapshot, changed_by, change_reason)
          VALUES (?, ?, ?, ?, ?)`,
-      ).run(agentId, current.version, currentSnapshot, 'system', `Before rollback to v${version}`);
+        [agentId, current.version, currentSnapshot, 'system', `Before rollback to v${version}`],
+      );
 
       const newVersion = current.version + 1;
-      db.prepare(
+      this.provider.run(
         `UPDATE agent_identity
          SET name = ?, role = ?, description = ?, personality = ?,
-             version = ?, updated_at = datetime('now')
+             version = ?, updated_at = unixepoch()
          WHERE agent_id = ?`,
-      ).run(
-        snapshot.name,
-        snapshot.role,
-        snapshot.description,
-        JSON.stringify(snapshot.personality),
-        newVersion,
-        agentId,
+        [
+          snapshot.name,
+          snapshot.role,
+          snapshot.description,
+          JSON.stringify(snapshot.personality),
+          newVersion,
+          agentId,
+        ],
       );
-    })();
+    });
 
     return this.getIdentity(agentId)!;
   }

package/src/control/intent-router.ts

@@ -9,6 +9,7 @@
  */
 
 import type { Vault } from '../vault/vault.js';
+import type { PersistenceProvider } from '../persistence/types.js';
 import type {
   IntentType,
   OperationalMode,
@@ -96,10 +97,12 @@ const DEFAULT_MODES: ModeConfig[] = [
 
 export class IntentRouter {
   private vault: Vault;
+  private provider: PersistenceProvider;
   private currentMode: OperationalMode = 'GENERAL-MODE';
 
   constructor(vault: Vault) {
     this.vault = vault;
+    this.provider = vault.getProvider();
     this.initializeTables();
     this.seedDefaultModes();
   }
@@ -107,8 +110,7 @@ export class IntentRouter {
   // ─── Table Initialization ───────────────────────────────────────────
 
   private initializeTables(): void {
-    const db = this.vault.getDb();
-    db.exec(`
+    this.provider.execSql(`
       CREATE TABLE IF NOT EXISTS agent_modes (
         mode TEXT PRIMARY KEY,
         intent TEXT NOT NULL,
@@ -130,20 +132,21 @@ export class IntentRouter {
   }
 
   private seedDefaultModes(): void {
-    const db = this.vault.getDb();
-    const insert = db.prepare(
-      `INSERT OR IGNORE INTO agent_modes (mode, intent, description, behavior_rules, keywords)
-       VALUES (?, ?, ?, ?, ?)`,
-    );
-    for (const m of DEFAULT_MODES) {
-      insert.run(
-        m.mode,
-        m.intent,
-        m.description,
-        JSON.stringify(m.behaviorRules),
-        JSON.stringify(m.keywords),
-      );
-    }
+    this.provider.transaction(() => {
+      for (const m of DEFAULT_MODES) {
+        this.provider.run(
+          `INSERT OR IGNORE INTO agent_modes (mode, intent, description, behavior_rules, keywords)
+           VALUES (?, ?, ?, ?, ?)`,
+          [
+            m.mode,
+            m.intent,
+            m.description,
+            JSON.stringify(m.behaviorRules),
+            JSON.stringify(m.keywords),
+          ],
+        );
+      }
+    });
   }
 
   // ─── Intent Classification ──────────────────────────────────────────
@@ -194,26 +197,23 @@ export class IntentRouter {
   }
 
   private logRouting(prompt: string, classification: IntentClassification): void {
-    const db = this.vault.getDb();
-    db.prepare(
+    this.provider.run(
       `INSERT INTO agent_routing_log (prompt, intent, mode, confidence, matched_keywords)
        VALUES (?, ?, ?, ?, ?)`,
-    ).run(
-      prompt,
-      classification.intent,
-      classification.mode,
-      classification.confidence,
-      JSON.stringify(classification.matchedKeywords),
+      [
+        prompt,
+        classification.intent,
+        classification.mode,
+        classification.confidence,
+        JSON.stringify(classification.matchedKeywords),
+      ],
     );
   }
 
   // ─── Mode Management ───────────────────────────────────────────────
 
   morph(mode: OperationalMode): MorphResult {
-    const db = this.vault.getDb();
-    const row = db.prepare('SELECT * FROM agent_modes WHERE mode = ?').get(mode) as
-      | ModeRow
-      | undefined;
+    const row = this.provider.get<ModeRow>('SELECT * FROM agent_modes WHERE mode = ?', [mode]);
 
     if (!row) {
       throw new Error(`Unknown mode: ${mode}`);
@@ -231,41 +231,40 @@ export class IntentRouter {
   }
 
   getBehaviorRules(mode?: OperationalMode): string[] {
-    const db = this.vault.getDb();
     const target = mode ?? this.currentMode;
-    const row = db.prepare('SELECT behavior_rules FROM agent_modes WHERE mode = ?').get(target) as
-      | { behavior_rules: string }
-      | undefined;
+    const row = this.provider.get<{ behavior_rules: string }>(
+      'SELECT behavior_rules FROM agent_modes WHERE mode = ?',
+      [target],
+    );
 
     if (!row) return [];
     return JSON.parse(row.behavior_rules) as string[];
   }
 
   getModes(): ModeConfig[] {
-    const db = this.vault.getDb();
-    const rows = db.prepare('SELECT * FROM agent_modes ORDER BY mode').all() as ModeRow[];
+    const rows = this.provider.all<ModeRow>('SELECT * FROM agent_modes ORDER BY mode');
     return rows.map(rowToModeConfig);
   }
 
   registerMode(config: ModeConfig): void {
-    const db = this.vault.getDb();
-    db.prepare(
+    this.provider.run(
       `INSERT OR REPLACE INTO agent_modes (mode, intent, description, behavior_rules, keywords)
        VALUES (?, ?, ?, ?, ?)`,
-    ).run(
-      config.mode,
-      config.intent,
-      config.description,
-      JSON.stringify(config.behaviorRules),
-      JSON.stringify(config.keywords),
+      [
+        config.mode,
+        config.intent,
+        config.description,
+        JSON.stringify(config.behaviorRules),
+        JSON.stringify(config.keywords),
+      ],
     );
   }
 
   updateModeRules(mode: OperationalMode, rules: string[]): void {
-    const db = this.vault.getDb();
-    const result = db
-      .prepare('UPDATE agent_modes SET behavior_rules = ? WHERE mode = ?')
-      .run(JSON.stringify(rules), mode);
+    const result = this.provider.run('UPDATE agent_modes SET behavior_rules = ? WHERE mode = ?', [
+      JSON.stringify(rules),
+      mode,
+    ]);
     if (result.changes === 0) {
       throw new Error(`Unknown mode: ${mode}`);
     }
@@ -278,22 +277,21 @@ export class IntentRouter {
     byIntent: Record<string, number>;
     byMode: Record<string, number>;
   } {
-    const db = this.vault.getDb();
-    const total = (
-      db.prepare('SELECT COUNT(*) as count FROM agent_routing_log').get() as { count: number }
-    ).count;
-
-    const intentRows = db
-      .prepare('SELECT intent, COUNT(*) as count FROM agent_routing_log GROUP BY intent')
-      .all() as Array<{ intent: string; count: number }>;
+    const total = this.provider.get<{ count: number }>(
+      'SELECT COUNT(*) as count FROM agent_routing_log',
+    )!.count;
+
+    const intentRows = this.provider.all<{ intent: string; count: number }>(
+      'SELECT intent, COUNT(*) as count FROM agent_routing_log GROUP BY intent',
+    );
     const byIntent: Record<string, number> = {};
     for (const row of intentRows) {
       byIntent[row.intent] = row.count;
     }
 
-    const modeRows = db
-      .prepare('SELECT mode, COUNT(*) as count FROM agent_routing_log GROUP BY mode')
-      .all() as Array<{ mode: string; count: number }>;
+    const modeRows = this.provider.all<{ mode: string; count: number }>(
+      'SELECT mode, COUNT(*) as count FROM agent_routing_log GROUP BY mode',
+    );
     const byMode: Record<string, number> = {};
     for (const row of modeRows) {
       byMode[row.mode] = row.count;