@soleri/core 2.1.0 → 2.5.0

package/dist/cognee/sync-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../src/cognee/sync-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAIlE,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AASD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAsB;IAChC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,YAAY,CAAkB;gBAE1B,EAAE,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM;IAU1E,OAAO,CAAC,UAAU;IA2BlB;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM;IAoBpD;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAgBrE;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAsF9B;;;;;OAKG;IACH,SAAS,IAAI,MAAM;IAsCnB,QAAQ,IAAI,gBAAgB;IA0B5B;;;;;OAKG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtC;;OAEG;IACH,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,aAAa;IAOrB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,UAAU;CAkBnB"}

package/dist/cognee/sync-manager.js

@@ -0,0 +1,293 @@
+/**
+ * CogneeSyncManager — queued, resilient sync between the Vault SQLite DB and Cognee.
+ *
+ * Maintains a persistent queue (`cognee_sync_queue`) so that ingestions, updates,
+ * and deletions survive process restarts. Drain is idempotent and retry-safe.
+ * Health-flip detection auto-drains when Cognee comes back online.
+ *
+ * Ported from Salvador MCP's battle-tested cognee-sync module.
+ */
+import { createHash } from 'node:crypto';
+// ─── Constants ──────────────────────────────────────────────────────
+const MAX_BATCH = 10;
+const MAX_RETRIES = 3;
+// ─── CogneeSyncManager ─────────────────────────────────────────────
+export class CogneeSyncManager {
+    db;
+    cognee;
+    dataset;
+    lastDrainAt = null;
+    drainTimer = null;
+    wasAvailable = false;
+    constructor(db, cognee, dataset) {
+        this.db = db;
+        this.cognee = cognee;
+        this.dataset = dataset;
+        this.initSchema();
+        this.wasAvailable = cognee.isAvailable;
+    }
+    // ─── Schema ────────────────────────────────────────────────────
+    initSchema() {
+        this.db.execSql(`
+      CREATE TABLE IF NOT EXISTS cognee_sync_queue (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        op TEXT NOT NULL,
+        entry_id TEXT NOT NULL,
+        dataset TEXT NOT NULL,
+        content_hash TEXT,
+        status TEXT NOT NULL DEFAULT 'pending',
+        attempts INTEGER NOT NULL DEFAULT 0,
+        error TEXT,
+        created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+        processed_at INTEGER
+      )
+    `);
+        // Add cognee_ingested_hash column to entries table for reconciliation.
+        // ALTER TABLE ... ADD COLUMN is a no-op error when the column already exists.
+        try {
+            this.db.run('ALTER TABLE entries ADD COLUMN cognee_ingested_hash TEXT');
+        }
+        catch {
+            // Column already exists — expected on subsequent runs.
+        }
+    }
+    // ─── Content hashing ──────────────────────────────────────────
+    /**
+     * SHA-256 of the serialized entry fields, truncated to 16 hex characters.
+     * Deterministic for identical content — used to detect drift.
+     */
+    static contentHash(entry) {
+        const payload = JSON.stringify({
+            id: entry.id,
+            type: entry.type,
+            domain: entry.domain,
+            title: entry.title,
+            severity: entry.severity,
+            description: entry.description,
+            context: entry.context ?? null,
+            example: entry.example ?? null,
+            counterExample: entry.counterExample ?? null,
+            why: entry.why ?? null,
+            tags: entry.tags,
+            appliesTo: entry.appliesTo ?? [],
+        });
+        return createHash('sha256').update(payload).digest('hex').slice(0, 16);
+    }
+    // ─── Enqueue ──────────────────────────────────────────────────
+    /**
+     * Add an operation to the sync queue.
+     *
+     * @param op       The operation type (ingest | update | delete).
+     * @param entryId  The vault entry ID.
+     * @param entry    Optional entry for hash computation. If omitted, hash is null.
+     */
+    enqueue(op, entryId, entry) {
+        const contentHash = entry ? CogneeSyncManager.contentHash(entry) : null;
+        this.db.run(`INSERT INTO cognee_sync_queue (op, entry_id, dataset, content_hash)
+       VALUES (@op, @entryId, @dataset, @contentHash)`, {
+            op,
+            entryId,
+            dataset: this.dataset,
+            contentHash,
+        });
+    }
+    // ─── Drain ────────────────────────────────────────────────────
+    /**
+     * Process up to MAX_BATCH pending items from the queue.
+     * Returns the number of items successfully processed.
+     *
+     * If Cognee is not available, returns 0 without touching the queue.
+     */
+    async drain() {
+        if (!this.cognee.isAvailable)
+            return 0;
+        // Claim a batch: move pending → processing
+        const items = this.db.all(`SELECT * FROM cognee_sync_queue
+       WHERE status = 'pending' AND dataset = @dataset
+       ORDER BY created_at ASC
+       LIMIT @limit`, { dataset: this.dataset, limit: MAX_BATCH });
+        if (items.length === 0)
+            return 0;
+        let processed = 0;
+        for (const raw of items) {
+            const item = rowToQueueItem(raw);
+            // Mark as processing
+            this.db.run(`UPDATE cognee_sync_queue SET status = 'processing', attempts = attempts + 1 WHERE id = @id`, { id: item.id });
+            try {
+                if (item.op === 'ingest' || item.op === 'update') {
+                    const entry = this.readEntry(item.entryId);
+                    if (!entry) {
+                        // Entry was deleted from vault before we could sync — mark completed
+                        this.markCompleted(item.id);
+                        processed++;
+                        continue;
+                    }
+                    const result = await this.cognee.addEntries([entry]);
+                    if (result.added === 0) {
+                        throw new Error('Cognee addEntries returned 0 added');
+                    }
+                    // Update the ingested hash on the entries table
+                    const hash = CogneeSyncManager.contentHash(entry);
+                    this.db.run(`UPDATE entries SET cognee_ingested_hash = @hash WHERE id = @id`, {
+                        hash,
+                        id: item.entryId,
+                    });
+                    this.markCompleted(item.id);
+                    processed++;
+                }
+                else if (item.op === 'delete') {
+                    // deleteEntries may not exist yet — graceful degradation
+                    const client = this.cognee;
+                    if (typeof client.deleteEntries === 'function') {
+                        await client.deleteEntries([item.entryId]);
+                    }
+                    // Clear the ingested hash (entry may already be gone from entries table)
+                    this.db.run(`UPDATE entries SET cognee_ingested_hash = NULL WHERE id = @id`, {
+                        id: item.entryId,
+                    });
+                    this.markCompleted(item.id);
+                    processed++;
+                }
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                const attempts = item.attempts + 1; // Already incremented above
+                if (attempts >= MAX_RETRIES) {
+                    this.db.run(`UPDATE cognee_sync_queue SET status = 'failed', error = @error, processed_at = unixepoch() WHERE id = @id`, { id: item.id, error: errorMsg });
+                }
+                else {
+                    // Back to pending for retry
+                    this.db.run(`UPDATE cognee_sync_queue SET status = 'pending', error = @error WHERE id = @id`, { id: item.id, error: errorMsg });
+                }
+            }
+        }
+        this.lastDrainAt = Math.floor(Date.now() / 1000);
+        return processed;
+    }
+    // ─── Reconciliation ───────────────────────────────────────────
+    /**
+     * Find entries whose cognee_ingested_hash is NULL or doesn't match the
+     * current content hash. Enqueue dirty entries for re-ingestion.
+     *
+     * Returns the number of entries enqueued.
+     */
+    reconcile() {
+        // Get all entries that either have never been ingested or whose content changed
+        const rows = this.db.all(`SELECT * FROM entries WHERE cognee_ingested_hash IS NULL
+       UNION ALL
+       SELECT * FROM entries WHERE cognee_ingested_hash IS NOT NULL`);
+        let enqueued = 0;
+        for (const raw of rows) {
+            const entry = this.rowToEntry(raw);
+            const currentHash = CogneeSyncManager.contentHash(entry);
+            const ingestedHash = raw.cognee_ingested_hash;
+            if (ingestedHash === currentHash)
+                continue;
+            // Determine op: null hash means never ingested, mismatched means update
+            const op = ingestedHash === null ? 'ingest' : 'update';
+            // Avoid duplicate pending items for the same entry
+            const existing = this.db.get(`SELECT id FROM cognee_sync_queue
+         WHERE entry_id = @entryId AND dataset = @dataset AND status = 'pending'`, { entryId: entry.id, dataset: this.dataset });
+            if (!existing) {
+                this.enqueue(op, entry.id, entry);
+                enqueued++;
+            }
+        }
+        return enqueued;
+    }
+    // ─── Stats ────────────────────────────────────────────────────
+    getStats() {
+        const countByStatus = (status) => {
+            const row = this.db.get(`SELECT COUNT(*) as count FROM cognee_sync_queue WHERE status = @status AND dataset = @dataset`, { status, dataset: this.dataset });
+            return row?.count ?? 0;
+        };
+        const pending = countByStatus('pending');
+        const processing = countByStatus('processing');
+        const completed = countByStatus('completed');
+        const failed = countByStatus('failed');
+        return {
+            pending,
+            processing,
+            completed,
+            failed,
+            queueSize: pending + processing,
+            lastDrainAt: this.lastDrainAt,
+        };
+    }
+    // ─── Health-flip detection ────────────────────────────────────
+    /**
+     * Detects an unavailable-to-available transition on the Cognee client.
+     * When Cognee comes back online, automatically triggers a drain.
+     *
+     * Call this periodically (e.g. after each health check).
+     */
+    async checkHealthFlip() {
+        const nowAvailable = this.cognee.isAvailable;
+        if (nowAvailable && !this.wasAvailable) {
+            // Cognee just came back online — drain the queue
+            await this.drain();
+        }
+        this.wasAvailable = nowAvailable;
+    }
+    // ─── Cleanup ──────────────────────────────────────────────────
+    /**
+     * Clear any periodic drain timer.
+     */
+    close() {
+        if (this.drainTimer) {
+            clearInterval(this.drainTimer);
+            this.drainTimer = null;
+        }
+    }
+    // ─── Private helpers ──────────────────────────────────────────
+    markCompleted(id) {
+        this.db.run(`UPDATE cognee_sync_queue SET status = 'completed', processed_at = unixepoch() WHERE id = @id`, { id });
+    }
+    /**
+     * Read an entry from the entries table by ID.
+     * Returns null if the entry doesn't exist.
+     */
+    readEntry(id) {
+        const row = this.db.get('SELECT * FROM entries WHERE id = @id', {
+            id,
+        });
+        return row ? this.rowToEntry(row) : null;
+    }
+    /**
+     * Convert a raw DB row into an IntelligenceEntry.
+     */
+    rowToEntry(row) {
+        return {
+            id: row.id,
+            type: row.type,
+            domain: row.domain,
+            title: row.title,
+            severity: row.severity,
+            description: row.description,
+            context: row.context ?? undefined,
+            example: row.example ?? undefined,
+            counterExample: row.counter_example ?? undefined,
+            why: row.why ?? undefined,
+            tags: JSON.parse(row.tags || '[]'),
+            appliesTo: JSON.parse(row.applies_to || '[]'),
+            validFrom: row.valid_from ?? undefined,
+            validUntil: row.valid_until ?? undefined,
+        };
+    }
+}
+// ─── Module-level helpers ─────────────────────────────────────────
+function rowToQueueItem(row) {
+    return {
+        id: row.id,
+        op: row.op,
+        entryId: row.entry_id,
+        dataset: row.dataset,
+        contentHash: row.content_hash ?? null,
+        status: row.status,
+        attempts: row.attempts,
+        error: row.error ?? null,
+        createdAt: row.created_at,
+        processedAt: row.processed_at ?? null,
+    };
+}
+//# sourceMappingURL=sync-manager.js.map

package/dist/cognee/sync-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-manager.js","sourceRoot":"","sources":["../../src/cognee/sync-manager.ts"],"names":[],"mappings":"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"}

package/dist/control/identity-manager.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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).
+ */
+import type { Vault } from '../vault/vault.js';
+import type { AgentIdentity, IdentityVersion, IdentityUpdateInput, Guideline, GuidelineInput, GuidelineCategory } from './types.js';
+export declare class IdentityManager {
+    private vault;
+    constructor(vault: Vault);
+    private initializeTables;
+    getIdentity(agentId: string): AgentIdentity | null;
+    setIdentity(agentId: string, input: IdentityUpdateInput): AgentIdentity;
+    addGuideline(agentId: string, input: GuidelineInput): Guideline;
+    removeGuideline(guidelineId: string): boolean;
+    getGuidelines(agentId: string, category?: GuidelineCategory): Guideline[];
+    getVersionHistory(agentId: string, limit?: number): IdentityVersion[];
+    rollback(agentId: string, version: number): AgentIdentity;
+    renderIdentityMarkdown(agentId: string): string;
+}
+//# sourceMappingURL=identity-manager.d.ts.map

package/dist/control/identity-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-manager.d.ts","sourceRoot":"","sources":["../../src/control/identity-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAIpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAQ;gBAET,KAAK,EAAE,KAAK;IAOxB,OAAO,CAAC,gBAAgB;IA2CxB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAWlD,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,aAAa;IAuDvE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,SAAS;IAc/D,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAM7C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,EAAE;IAoBzE,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,eAAe,EAAE;IAUjE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;IA6CzD,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAmChD"}

package/dist/control/identity-manager.js

@@ -0,0 +1,233 @@
+/**
+ * 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).
+ */
+import { randomUUID } from 'node:crypto';
+// ─── Class ──────────────────────────────────────────────────────────
+export class IdentityManager {
+    vault;
+    constructor(vault) {
+        this.vault = vault;
+        this.initializeTables();
+    }
+    // ─── Table Initialization ───────────────────────────────────────────
+    initializeTables() {
+        const db = this.vault.getDb();
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS agent_identity (
+        agent_id TEXT PRIMARY KEY,
+        name TEXT NOT NULL,
+        role TEXT NOT NULL DEFAULT '',
+        description TEXT NOT NULL DEFAULT '',
+        personality TEXT NOT NULL DEFAULT '[]',
+        version INTEGER NOT NULL DEFAULT 1,
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      CREATE TABLE IF NOT EXISTS agent_identity_versions (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        agent_id TEXT NOT NULL,
+        version INTEGER NOT NULL,
+        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')),
+        UNIQUE(agent_id, version)
+      );
+
+      CREATE TABLE IF NOT EXISTS agent_guidelines (
+        id TEXT PRIMARY KEY,
+        agent_id TEXT NOT NULL,
+        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'))
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_guidelines_agent
+        ON agent_guidelines(agent_id);
+      CREATE INDEX IF NOT EXISTS idx_identity_versions_agent
+        ON agent_identity_versions(agent_id, version);
+    `);
+    }
+    // ─── Identity CRUD ──────────────────────────────────────────────────
+    getIdentity(agentId) {
+        const db = this.vault.getDb();
+        const row = db.prepare('SELECT * FROM agent_identity WHERE agent_id = ?').get(agentId);
+        if (!row)
+            return null;
+        const guidelines = this.getGuidelines(agentId);
+        return rowToIdentity(row, guidelines);
+    }
+    setIdentity(agentId, input) {
+        const db = this.vault.getDb();
+        db.transaction(() => {
+            const existing = db.prepare('SELECT * FROM agent_identity WHERE agent_id = ?').get(agentId);
+            if (existing) {
+                // Snapshot current state before updating
+                const snapshot = JSON.stringify(rowToIdentitySnapshot(existing));
+                db.prepare(`INSERT INTO agent_identity_versions (agent_id, version, snapshot, changed_by, change_reason)
+           VALUES (?, ?, ?, ?, ?)`).run(agentId, existing.version, snapshot, input.changedBy ?? 'system', input.changeReason ?? '');
+                const newVersion = existing.version + 1;
+                const name = input.name ?? existing.name;
+                const role = input.role ?? existing.role;
+                const description = input.description ?? existing.description;
+                const personality = input.personality
+                    ? JSON.stringify(input.personality)
+                    : existing.personality;
+                db.prepare(`UPDATE agent_identity
+           SET name = ?, role = ?, description = ?, personality = ?,
+               version = ?, updated_at = datetime('now')
+           WHERE agent_id = ?`).run(name, role, description, personality, newVersion, agentId);
+            }
+            else {
+                // First identity creation — version 1
+                const name = input.name ?? agentId;
+                const role = input.role ?? '';
+                const description = input.description ?? '';
+                const personality = JSON.stringify(input.personality ?? []);
+                db.prepare(`INSERT INTO agent_identity (agent_id, name, role, description, personality, version)
+           VALUES (?, ?, ?, ?, ?, 1)`).run(agentId, name, role, description, personality);
+            }
+        })();
+        return this.getIdentity(agentId);
+    }
+    // ─── Guidelines ─────────────────────────────────────────────────────
+    addGuideline(agentId, input) {
+        const db = this.vault.getDb();
+        const id = randomUUID();
+        const priority = input.priority ?? 0;
+        db.prepare(`INSERT INTO agent_guidelines (id, agent_id, category, text, priority)
+       VALUES (?, ?, ?, ?, ?)`).run(id, agentId, input.category, input.text, priority);
+        const row = db.prepare('SELECT * FROM agent_guidelines WHERE id = ?').get(id);
+        return rowToGuideline(row);
+    }
+    removeGuideline(guidelineId) {
+        const db = this.vault.getDb();
+        const result = db.prepare('DELETE FROM agent_guidelines WHERE id = ?').run(guidelineId);
+        return result.changes > 0;
+    }
+    getGuidelines(agentId, category) {
+        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);
+            return rows.map(rowToGuideline);
+        }
+        const rows = db
+            .prepare('SELECT * FROM agent_guidelines WHERE agent_id = ? ORDER BY priority DESC, created_at ASC')
+            .all(agentId);
+        return rows.map(rowToGuideline);
+    }
+    // ─── Versioning ─────────────────────────────────────────────────────
+    getVersionHistory(agentId, limit = 20) {
+        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);
+        return rows.map(rowToVersion);
+    }
+    rollback(agentId, version) {
+        const db = this.vault.getDb();
+        db.transaction(() => {
+            const versionRow = db
+                .prepare('SELECT * FROM agent_identity_versions WHERE agent_id = ? AND version = ?')
+                .get(agentId, version);
+            if (!versionRow) {
+                throw new Error(`Version ${version} not found for agent ${agentId}`);
+            }
+            const snapshot = JSON.parse(versionRow.snapshot);
+            const current = db
+                .prepare('SELECT * FROM agent_identity WHERE agent_id = ?')
+                .get(agentId);
+            // Snapshot current state before rollback
+            const currentSnapshot = JSON.stringify(rowToIdentitySnapshot(current));
+            db.prepare(`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}`);
+            const newVersion = current.version + 1;
+            db.prepare(`UPDATE agent_identity
+         SET name = ?, role = ?, description = ?, personality = ?,
+             version = ?, updated_at = datetime('now')
+         WHERE agent_id = ?`).run(snapshot.name, snapshot.role, snapshot.description, JSON.stringify(snapshot.personality), newVersion, agentId);
+        })();
+        return this.getIdentity(agentId);
+    }
+    // ─── Rendering ──────────────────────────────────────────────────────
+    renderIdentityMarkdown(agentId) {
+        const identity = this.getIdentity(agentId);
+        if (!identity)
+            return `# Unknown Agent\n\nNo identity found for ${agentId}.`;
+        const lines = [
+            `# ${identity.name}`,
+            '',
+            `**Role:** ${identity.role}`,
+            '',
+            identity.description,
+            '',
+        ];
+        if (identity.personality.length > 0) {
+            lines.push('## Personality', '');
+            for (const trait of identity.personality) {
+                lines.push(`- ${trait}`);
+            }
+            lines.push('');
+        }
+        const categories = ['behavior', 'preference', 'restriction', 'style'];
+        for (const cat of categories) {
+            const guidelines = identity.guidelines.filter((g) => g.category === cat);
+            if (guidelines.length > 0) {
+                lines.push(`## ${cat.charAt(0).toUpperCase() + cat.slice(1)}s`, '');
+                for (const g of guidelines) {
+                    lines.push(`- ${g.text}`);
+                }
+                lines.push('');
+            }
+        }
+        return lines.join('\n');
+    }
+}
+// ─── Row Converters ─────────────────────────────────────────────────
+function rowToIdentity(row, guidelines) {
+    return {
+        agentId: row.agent_id,
+        name: row.name,
+        role: row.role,
+        description: row.description,
+        personality: JSON.parse(row.personality),
+        guidelines,
+        version: row.version,
+        updatedAt: row.updated_at,
+    };
+}
+function rowToIdentitySnapshot(row) {
+    return {
+        name: row.name,
+        role: row.role,
+        description: row.description,
+        personality: JSON.parse(row.personality),
+    };
+}
+function rowToGuideline(row) {
+    return {
+        id: row.id,
+        category: row.category,
+        text: row.text,
+        priority: row.priority,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function rowToVersion(row) {
+    return {
+        version: row.version,
+        snapshot: row.snapshot,
+        changedBy: row.changed_by,
+        changeReason: row.change_reason,
+        createdAt: row.created_at,
+    };
+}
+//# sourceMappingURL=identity-manager.js.map

package/dist/control/identity-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-manager.js","sourceRoot":"","sources":["../../src/control/identity-manager.ts"],"names":[],"mappings":"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"}

package/dist/control/intent-router.d.ts

@@ -0,0 +1,32 @@
+/**
+ * IntentRouter — Keyword-based intent classification and operational mode management.
+ *
+ * Follows the Curator/BrainIntelligence pattern: separate class, own SQLite
+ * tables, takes Vault as constructor dep. All methods synchronous (better-sqlite3).
+ *
+ * 10 default modes seeded on first use via INSERT OR IGNORE.
+ * Agents can register custom modes at runtime.
+ */
+import type { Vault } from '../vault/vault.js';
+import type { OperationalMode, IntentClassification, ModeConfig, MorphResult } from './types.js';
+export declare class IntentRouter {
+    private vault;
+    private currentMode;
+    constructor(vault: Vault);
+    private initializeTables;
+    private seedDefaultModes;
+    routeIntent(prompt: string): IntentClassification;
+    private logRouting;
+    morph(mode: OperationalMode): MorphResult;
+    getCurrentMode(): OperationalMode;
+    getBehaviorRules(mode?: OperationalMode): string[];
+    getModes(): ModeConfig[];
+    registerMode(config: ModeConfig): void;
+    updateModeRules(mode: OperationalMode, rules: string[]): void;
+    getRoutingStats(): {
+        totalRouted: number;
+        byIntent: Record<string, number>;
+        byMode: Record<string, number>;
+    };
+}
+//# sourceMappingURL=intent-router.d.ts.map

package/dist/control/intent-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-router.d.ts","sourceRoot":"","sources":["../../src/control/intent-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAEV,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,WAAW,EACZ,MAAM,YAAY,CAAC;AA+EpB,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAmC;gBAE1C,KAAK,EAAE,KAAK;IAQxB,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,gBAAgB;IAmBxB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB;IA6CjD,OAAO,CAAC,UAAU;IAgBlB,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW;IAiBzC,cAAc,IAAI,eAAe;IAIjC,gBAAgB,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE;IAWlD,QAAQ,IAAI,UAAU,EAAE;IAMxB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IActC,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAY7D,eAAe,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC;CAwBF"}