@soleri/core 2.1.0 → 2.5.0

package/dist/control/intent-router.js

@@ -0,0 +1,242 @@
+/**
+ * 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.
+ */
+// ─── Default Mode Definitions ───────────────────────────────────────
+const DEFAULT_MODES = [
+    {
+        mode: 'BUILD-MODE',
+        intent: 'build',
+        description: 'Creating new components, features, or scaffolding',
+        behaviorRules: ['Focus on clean architecture', 'Follow existing patterns', 'Write tests'],
+        keywords: ['build', 'create', 'add', 'implement', 'scaffold', 'generate', 'new', 'feature'],
+    },
+    {
+        mode: 'FIX-MODE',
+        intent: 'fix',
+        description: 'Fixing bugs, errors, and broken behavior',
+        behaviorRules: ['Identify root cause first', 'Verify fix with tests', 'Check for regressions'],
+        keywords: ['fix', 'bug', 'broken', 'error', 'crash', 'issue', 'debug', 'repair', 'janky'],
+    },
+    {
+        mode: 'VALIDATE-MODE',
+        intent: 'validate',
+        description: 'Validating, checking, verifying, and testing code',
+        behaviorRules: ['Be thorough', 'Check edge cases', 'Report all findings'],
+        keywords: ['validate', 'check', 'verify', 'test', 'lint', 'audit'],
+    },
+    {
+        mode: 'DESIGN-MODE',
+        intent: 'design',
+        description: 'Visual design, styling, layout, and color decisions',
+        behaviorRules: ['Use semantic tokens', 'Check contrast ratios', 'Follow design system'],
+        keywords: ['design', 'style', 'layout', 'color', 'typography', 'spacing', 'visual', 'ui'],
+    },
+    {
+        mode: 'IMPROVE-MODE',
+        intent: 'improve',
+        description: 'Refactoring, optimization, and code enhancement',
+        behaviorRules: ['Measure before optimizing', 'Keep changes minimal', 'Preserve behavior'],
+        keywords: ['improve', 'refactor', 'optimize', 'clean', 'enhance', 'simplify', 'faster'],
+    },
+    {
+        mode: 'DELIVER-MODE',
+        intent: 'deliver',
+        description: 'Deploying, shipping, releasing, and publishing',
+        behaviorRules: ['Run all checks first', 'Update changelog', 'Tag releases properly'],
+        keywords: ['deploy', 'ship', 'release', 'publish', 'merge', 'pr', 'push', 'package'],
+    },
+    {
+        mode: 'EXPLORE-MODE',
+        intent: 'explore',
+        description: 'Exploring, searching, and understanding the codebase',
+        behaviorRules: ['Be thorough in search', 'Provide context', 'Map dependencies'],
+        keywords: ['explore', 'search', 'find', 'show', 'list', 'explain'],
+    },
+    {
+        mode: 'PLAN-MODE',
+        intent: 'plan',
+        description: 'Planning, architecting, and strategy development',
+        behaviorRules: ['Consider trade-offs', 'Break into steps', 'Identify risks'],
+        keywords: ['plan', 'architect', 'strategy', 'approach', 'roadmap'],
+    },
+    {
+        mode: 'REVIEW-MODE',
+        intent: 'review',
+        description: 'Code review, feedback, and quality assessment',
+        behaviorRules: ['Be constructive', 'Focus on high-impact issues', 'Suggest alternatives'],
+        keywords: ['review', 'feedback', 'critique', 'assess', 'evaluate', 'quality'],
+    },
+    {
+        mode: 'GENERAL-MODE',
+        intent: 'general',
+        description: 'General-purpose fallback mode',
+        behaviorRules: ['Be helpful', 'Ask clarifying questions when needed'],
+        keywords: [],
+    },
+];
+// ─── Class ──────────────────────────────────────────────────────────
+export class IntentRouter {
+    vault;
+    currentMode = 'GENERAL-MODE';
+    constructor(vault) {
+        this.vault = vault;
+        this.initializeTables();
+        this.seedDefaultModes();
+    }
+    // ─── Table Initialization ───────────────────────────────────────────
+    initializeTables() {
+        const db = this.vault.getDb();
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS agent_modes (
+        mode TEXT PRIMARY KEY,
+        intent TEXT NOT NULL,
+        description TEXT NOT NULL DEFAULT '',
+        behavior_rules TEXT NOT NULL DEFAULT '[]',
+        keywords TEXT NOT NULL DEFAULT '[]'
+      );
+
+      CREATE TABLE IF NOT EXISTS agent_routing_log (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        prompt TEXT NOT NULL,
+        intent TEXT NOT NULL,
+        mode TEXT NOT NULL,
+        confidence REAL NOT NULL,
+        matched_keywords TEXT NOT NULL DEFAULT '[]',
+        created_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+    `);
+    }
+    seedDefaultModes() {
+        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));
+        }
+    }
+    // ─── Intent Classification ──────────────────────────────────────────
+    routeIntent(prompt) {
+        const tokens = new Set(prompt.toLowerCase().split(/\s+/).filter(Boolean));
+        const modes = this.getModes();
+        let bestMode = null;
+        let bestMatchCount = 0;
+        let bestMatchedKeywords = [];
+        for (const mode of modes) {
+            if (mode.keywords.length === 0)
+                continue;
+            const matched = mode.keywords.filter((kw) => tokens.has(kw));
+            if (matched.length > bestMatchCount) {
+                bestMatchCount = matched.length;
+                bestMode = mode;
+                bestMatchedKeywords = matched;
+            }
+        }
+        if (!bestMode || bestMatchCount === 0) {
+            const classification = {
+                intent: 'general',
+                mode: 'GENERAL-MODE',
+                confidence: 0,
+                method: 'keyword',
+                matchedKeywords: [],
+            };
+            this.logRouting(prompt, classification);
+            this.currentMode = 'GENERAL-MODE';
+            return classification;
+        }
+        const confidence = Math.min(bestMatchCount / bestMode.keywords.length, 1.0);
+        const classification = {
+            intent: bestMode.intent,
+            mode: bestMode.mode,
+            confidence,
+            method: 'keyword',
+            matchedKeywords: bestMatchedKeywords,
+        };
+        this.logRouting(prompt, classification);
+        this.currentMode = bestMode.mode;
+        return classification;
+    }
+    logRouting(prompt, classification) {
+        const db = this.vault.getDb();
+        db.prepare(`INSERT INTO agent_routing_log (prompt, intent, mode, confidence, matched_keywords)
+       VALUES (?, ?, ?, ?, ?)`).run(prompt, classification.intent, classification.mode, classification.confidence, JSON.stringify(classification.matchedKeywords));
+    }
+    // ─── Mode Management ───────────────────────────────────────────────
+    morph(mode) {
+        const db = this.vault.getDb();
+        const row = db.prepare('SELECT * FROM agent_modes WHERE mode = ?').get(mode);
+        if (!row) {
+            throw new Error(`Unknown mode: ${mode}`);
+        }
+        const previousMode = this.currentMode;
+        this.currentMode = mode;
+        const behaviorRules = JSON.parse(row.behavior_rules);
+        return { previousMode, currentMode: mode, behaviorRules };
+    }
+    getCurrentMode() {
+        return this.currentMode;
+    }
+    getBehaviorRules(mode) {
+        const db = this.vault.getDb();
+        const target = mode ?? this.currentMode;
+        const row = db.prepare('SELECT behavior_rules FROM agent_modes WHERE mode = ?').get(target);
+        if (!row)
+            return [];
+        return JSON.parse(row.behavior_rules);
+    }
+    getModes() {
+        const db = this.vault.getDb();
+        const rows = db.prepare('SELECT * FROM agent_modes ORDER BY mode').all();
+        return rows.map(rowToModeConfig);
+    }
+    registerMode(config) {
+        const db = this.vault.getDb();
+        db.prepare(`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));
+    }
+    updateModeRules(mode, rules) {
+        const db = this.vault.getDb();
+        const result = db
+            .prepare('UPDATE agent_modes SET behavior_rules = ? WHERE mode = ?')
+            .run(JSON.stringify(rules), mode);
+        if (result.changes === 0) {
+            throw new Error(`Unknown mode: ${mode}`);
+        }
+    }
+    // ─── Analytics ──────────────────────────────────────────────────────
+    getRoutingStats() {
+        const db = this.vault.getDb();
+        const total = db.prepare('SELECT COUNT(*) as count FROM agent_routing_log').get().count;
+        const intentRows = db
+            .prepare('SELECT intent, COUNT(*) as count FROM agent_routing_log GROUP BY intent')
+            .all();
+        const byIntent = {};
+        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();
+        const byMode = {};
+        for (const row of modeRows) {
+            byMode[row.mode] = row.count;
+        }
+        return { totalRouted: total, byIntent, byMode };
+    }
+}
+// ─── Row Converters ─────────────────────────────────────────────────
+function rowToModeConfig(row) {
+    return {
+        mode: row.mode,
+        intent: row.intent,
+        description: row.description,
+        behaviorRules: JSON.parse(row.behavior_rules),
+        keywords: JSON.parse(row.keywords),
+    };
+}
+//# sourceMappingURL=intent-router.js.map

package/dist/control/intent-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-router.js","sourceRoot":"","sources":["../../src/control/intent-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,uEAAuE;AAEvE,MAAM,aAAa,GAAiB;IAClC;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,OAAO;QACf,WAAW,EAAE,mDAAmD;QAChE,aAAa,EAAE,CAAC,6BAA6B,EAAE,0BAA0B,EAAE,aAAa,CAAC;QACzF,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC;KAC5F;IACD;QACE,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,0CAA0C;QACvD,aAAa,EAAE,CAAC,2BAA2B,EAAE,uBAAuB,EAAE,uBAAuB,CAAC;QAC9F,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;KAC1F;IACD;QACE,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,mDAAmD;QAChE,aAAa,EAAE,CAAC,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,CAAC;QACzE,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;KACnE;IACD;QACE,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,qDAAqD;QAClE,aAAa,EAAE,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,sBAAsB,CAAC;QACvF,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC;KAC1F;IACD;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,iDAAiD;QAC9D,aAAa,EAAE,CAAC,2BAA2B,EAAE,sBAAsB,EAAE,mBAAmB,CAAC;QACzF,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC;KACxF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,gDAAgD;QAC7D,aAAa,EAAE,CAAC,sBAAsB,EAAE,kBAAkB,EAAE,uBAAuB,CAAC;QACpF,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC;KACrF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,sDAAsD;QACnE,aAAa,EAAE,CAAC,uBAAuB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;QAC/E,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;KACnE;IACD;QACE,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,kDAAkD;QAC/D,aAAa,EAAE,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,gBAAgB,CAAC;QAC5E,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC;KACnE;IACD;QACE,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,+CAA+C;QAC5D,aAAa,EAAE,CAAC,iBAAiB,EAAE,6BAA6B,EAAE,sBAAsB,CAAC;QACzF,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC;KAC9E;IACD;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,+BAA+B;QAC5C,aAAa,EAAE,CAAC,YAAY,EAAE,sCAAsC,CAAC;QACrE,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAEF,uEAAuE;AAEvE,MAAM,OAAO,YAAY;IACf,KAAK,CAAQ;IACb,WAAW,GAAoB,cAAc,CAAC;IAEtD,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED,uEAAuE;IAE/D,gBAAgB;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;KAkBP,CAAC,CAAC;IACL,CAAC;IAEO,gBAAgB;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACvB;8BACwB,CACzB,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CACR,CAAC,CAAC,IAAI,EACN,CAAC,CAAC,MAAM,EACR,CAAC,CAAC,WAAW,EACb,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,EAC/B,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAC3B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,uEAAuE;IAEvE,WAAW,CAAC,MAAc;QACxB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAE9B,IAAI,QAAQ,GAAsB,IAAI,CAAC;QACvC,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,mBAAmB,GAAa,EAAE,CAAC;QAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7D,IAAI,OAAO,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;gBACpC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;gBAChC,QAAQ,GAAG,IAAI,CAAC;gBAChB,mBAAmB,GAAG,OAAO,CAAC;YAChC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,cAAc,GAAyB;gBAC3C,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,cAAc;gBACpB,UAAU,EAAE,CAAC;gBACb,MAAM,EAAE,SAAS;gBACjB,eAAe,EAAE,EAAE;aACpB,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YACxC,IAAI,CAAC,WAAW,GAAG,cAAc,CAAC;YAClC,OAAO,cAAc,CAAC;QACxB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5E,MAAM,cAAc,GAAyB;YAC3C,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,UAAU;YACV,MAAM,EAAE,SAAS;YACjB,eAAe,EAAE,mBAAmB;SACrC,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IAEO,UAAU,CAAC,MAAc,EAAE,cAAoC;QACrE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,EAAE,CAAC,OAAO,CACR;8BACwB,CACzB,CAAC,GAAG,CACH,MAAM,EACN,cAAc,CAAC,MAAM,EACrB,cAAc,CAAC,IAAI,EACnB,cAAc,CAAC,UAAU,EACzB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,eAAe,CAAC,CAC/C,CAAC;IACJ,CAAC;IAED,sEAAsE;IAEtE,KAAK,CAAC,IAAqB;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,GAAG,CAAC,IAAI,CAE9D,CAAC;QAEd,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAa,CAAC;QAEjE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC5D,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,gBAAgB,CAAC,IAAsB;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC;QACxC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,uDAAuD,CAAC,CAAC,GAAG,CAAC,MAAM,CAE7E,CAAC;QAEd,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAa,CAAC;IACpD,CAAC;IAED,QAAQ;QACN,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC,GAAG,EAAe,CAAC;QACtF,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,YAAY,CAAC,MAAkB;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,EAAE,CAAC,OAAO,CACR;8BACwB,CACzB,CAAC,GAAG,CACH,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,WAAW,EAClB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,EACpC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAChC,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,IAAqB,EAAE,KAAe;QACpD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,EAAE;aACd,OAAO,CAAC,0DAA0D,CAAC;aACnE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,uEAAuE;IAEvE,eAAe;QAKb,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,KAAK,GACT,EAAE,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC,GAAG,EAClE,CAAC,KAAK,CAAC;QAER,MAAM,UAAU,GAAG,EAAE;aAClB,OAAO,CAAC,yEAAyE,CAAC;aAClF,GAAG,EAA8C,CAAC;QACrD,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;QACnC,CAAC;QAED,MAAM,QAAQ,GAAG,EAAE;aAChB,OAAO,CAAC,qEAAqE,CAAC;aAC9E,GAAG,EAA4C,CAAC;QACnD,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;QAC/B,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC;CACF;AAYD,uEAAuE;AAEvE,SAAS,eAAe,CAAC,GAAY;IACnC,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAuB;QACjC,MAAM,EAAE,GAAG,CAAC,MAAoB;QAChC,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAa;QACzD,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAa;KAC/C,CAAC;AACJ,CAAC"}

package/dist/control/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Types for Identity Management and Intent Routing.
+ *
+ * Two separate concerns:
+ * - Identity: agent persona CRUD with versioning and guidelines
+ * - Intent Routing: keyword-based intent classification and operational modes
+ */
+export type GuidelineCategory = 'behavior' | 'preference' | 'restriction' | 'style';
+export interface Guideline {
+    id: string;
+    category: GuidelineCategory;
+    text: string;
+    priority: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentIdentity {
+    agentId: string;
+    name: string;
+    role: string;
+    description: string;
+    personality: string[];
+    guidelines: Guideline[];
+    version: number;
+    updatedAt: string;
+}
+export interface IdentityVersion {
+    version: number;
+    snapshot: string;
+    changedBy: string;
+    changeReason: string;
+    createdAt: string;
+}
+export interface IdentityUpdateInput {
+    name?: string;
+    role?: string;
+    description?: string;
+    personality?: string[];
+    changedBy?: string;
+    changeReason?: string;
+}
+export interface GuidelineInput {
+    category: GuidelineCategory;
+    text: string;
+    priority?: number;
+}
+export type IntentType = 'build' | 'fix' | 'validate' | 'design' | 'improve' | 'deliver' | 'explore' | 'plan' | 'review' | 'general';
+export type OperationalMode = 'BUILD-MODE' | 'FIX-MODE' | 'VALIDATE-MODE' | 'DESIGN-MODE' | 'IMPROVE-MODE' | 'DELIVER-MODE' | 'EXPLORE-MODE' | 'PLAN-MODE' | 'REVIEW-MODE' | 'GENERAL-MODE';
+export interface IntentClassification {
+    intent: IntentType;
+    mode: OperationalMode;
+    confidence: number;
+    method: 'keyword';
+    matchedKeywords: string[];
+}
+export interface ModeConfig {
+    mode: OperationalMode;
+    intent: IntentType;
+    description: string;
+    behaviorRules: string[];
+    keywords: string[];
+}
+export interface MorphResult {
+    previousMode: OperationalMode;
+    currentMode: OperationalMode;
+    behaviorRules: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/control/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/control/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,OAAO,CAAC;AAEpF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,KAAK,GACL,UAAU,GACV,QAAQ,GACR,SAAS,GACT,SAAS,GACT,SAAS,GACT,MAAM,GACN,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,UAAU,GACV,eAAe,GACf,aAAa,GACb,cAAc,GACd,cAAc,GACd,cAAc,GACd,WAAW,GACX,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,eAAe,CAAC;IAC9B,WAAW,EAAE,eAAe,CAAC;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/control/types.js

@@ -0,0 +1,9 @@
+/**
+ * Types for Identity Management and Intent Routing.
+ *
+ * Two separate concerns:
+ * - Identity: agent persona CRUD with versioning and guidelines
+ * - Intent Routing: keyword-based intent classification and operational modes
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/control/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/control/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/curator/curator.d.ts

@@ -1,8 +1,11 @@
 import type { Vault } from '../vault/vault.js';
+import type { IntelligenceEntry } from '../intelligence/types.js';
+import type { CogneeClient } from '../cognee/client.js';
 import type { CuratorStatus, TagNormalizationResult, CanonicalTag, DuplicateDetectionResult, Contradiction, ContradictionStatus, GroomResult, GroomAllResult, ConsolidationOptions, ConsolidationResult, ChangelogEntry, HealthAuditResult } from './types.js';
 export declare class Curator {
     private vault;
-    constructor(vault: Vault);
+    private cognee;
+    constructor(vault: Vault, cognee?: CogneeClient);
     private initializeTables;
     private seedDefaultAliases;
     getStatus(): CuratorStatus;
@@ -15,11 +18,44 @@ export declare class Curator {
     detectContradictions(threshold?: number): Contradiction[];
     getContradictions(status?: ContradictionStatus): Contradiction[];
     resolveContradiction(id: number, resolution: 'resolved' | 'dismissed'): Contradiction | null;
+    detectContradictionsHybrid(threshold?: number): Promise<{
+        contradictions: Contradiction[];
+        cogneeAvailable: boolean;
+        method: 'hybrid' | 'tfidf-only';
+    }>;
     groomEntry(entryId: string): GroomResult | null;
     groomAll(): GroomAllResult;
     consolidate(options?: ConsolidationOptions): ConsolidationResult;
     getEntryHistory(entryId: string, limit?: number): ChangelogEntry[];
     healthAudit(): HealthAuditResult;
+    recordSnapshot(entryId: string, changedBy?: string, changeReason?: string): {
+        recorded: boolean;
+        historyId: number;
+    };
+    getVersionHistory(entryId: string): Array<{
+        historyId: number;
+        entryId: string;
+        snapshot: IntelligenceEntry;
+        changedBy: string;
+        changeReason: string | null;
+        createdAt: number;
+    }>;
+    getQueueStats(): {
+        totalEntries: number;
+        groomedEntries: number;
+        ungroomedEntries: number;
+        staleEntries: number;
+        freshEntries: number;
+        avgDaysSinceGroom: number;
+    };
+    enrichMetadata(entryId: string): {
+        enriched: boolean;
+        changes: Array<{
+            field: string;
+            before: string;
+            after: string;
+        }>;
+    };
     private buildVocabulary;
     private logChange;
     private rowToContradiction;

package/dist/curator/curator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"curator.d.ts","sourceRoot":"","sources":["../../src/curator/curator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAQ/C,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,YAAY,EAEZ,wBAAwB,EACxB,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA2BpB,qBAAa,OAAO;IAClB,OAAO,CAAC,KAAK,CAAQ;gBAET,KAAK,EAAE,KAAK;IAQxB,OAAO,CAAC,gBAAgB;IAgDxB,OAAO,CAAC,kBAAkB;IAsB1B,SAAS,IAAI,aAAa;IA0B1B,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB;IAYjD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAkCxD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAWnD,gBAAgB,IAAI,YAAY,EAAE;IAmBlC,OAAO,CAAC,aAAa;IAUrB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,wBAAwB,EAAE;IAsDlF,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAqDzD,iBAAiB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,aAAa,EAAE;IAWhE,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,IAAI;IAa5F,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAiC/C,QAAQ,IAAI,cAAc;IAyB1B,WAAW,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,mBAAmB;IA2EhE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IAYlE,WAAW,IAAI,iBAAiB;IA4HhC,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,cAAc;CAWvB"}
+{"version":3,"file":"curator.d.ts","sourceRoot":"","sources":["../../src/curator/curator.ts"],"names":[],"mappings":"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"}

package/dist/curator/curator.js

@@ -22,8 +22,10 @@ const DEFAULT_TAG_ALIASES = [
 // ─── Curator Class ──────────────────────────────────────────────────
 export class Curator {
     vault;
-    constructor(vault) {
+    cognee;
+    constructor(vault, cognee) {
         this.vault = vault;
+        this.cognee = cognee;
         this.initializeTables();
         this.seedDefaultAliases();
     }
@@ -63,6 +65,15 @@ export class Curator {
         created_at INTEGER NOT NULL DEFAULT (unixepoch())
       );
 
+      CREATE TABLE IF NOT EXISTS curator_entry_history (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entry_id TEXT NOT NULL,
+        snapshot TEXT NOT NULL,
+        changed_by TEXT DEFAULT 'system',
+        change_reason TEXT,
+        created_at INTEGER NOT NULL DEFAULT (unixepoch())
+      );
+
       CREATE TABLE IF NOT EXISTS curator_contradictions (
         id INTEGER PRIMARY KEY AUTOINCREMENT,
         pattern_id TEXT NOT NULL,
@@ -271,6 +282,67 @@ export class Curator {
         const row = db.prepare('SELECT * FROM curator_contradictions WHERE id = ?').get(id);
         return row ? this.rowToContradiction(row) : null;
     }
+    async detectContradictionsHybrid(threshold) {
+        const effectiveThreshold = threshold ?? DEFAULT_CONTRADICTION_THRESHOLD;
+        const entries = this.vault.list({ limit: 100000 });
+        const antipatterns = entries.filter((e) => e.type === 'anti-pattern');
+        const patterns = entries.filter((e) => e.type === 'pattern');
+        if (antipatterns.length === 0 || patterns.length === 0) {
+            return { contradictions: [], cogneeAvailable: false, method: 'tfidf-only' };
+        }
+        const vocabulary = this.buildVocabulary(entries);
+        const db = this.vault.getDb();
+        const detected = [];
+        const insertStmt = db.prepare(`INSERT OR IGNORE INTO curator_contradictions (pattern_id, antipattern_id, similarity)
+       VALUES (?, ?, ?)`);
+        const cogneeAvailable = this.cognee?.isAvailable ?? false;
+        for (const ap of antipatterns) {
+            let candidates;
+            try {
+                const searchResults = this.vault.search(ap.title, { type: 'pattern', limit: 20 });
+                candidates = searchResults.length > 0 ? searchResults.map((r) => r.entry) : patterns;
+            }
+            catch {
+                candidates = patterns;
+            }
+            const apText = [ap.title, ap.description, ap.context ?? ''].join(' ');
+            const apVec = calculateTfIdf(tokenize(apText), vocabulary);
+            for (const pattern of candidates) {
+                const pText = [pattern.title, pattern.description, pattern.context ?? ''].join(' ');
+                const pVec = calculateTfIdf(tokenize(pText), vocabulary);
+                const tfidfScore = cosineSimilarity(apVec, pVec);
+                let finalScore = tfidfScore;
+                if (cogneeAvailable && this.cognee) {
+                    try {
+                        const cogneeResults = await this.cognee.search(`${ap.title} ${pattern.title}`, {
+                            limit: 5,
+                        });
+                        const cogneeScore = cogneeResults.length > 0
+                            ? cogneeResults.reduce((sum, r) => sum + r.score, 0) / cogneeResults.length
+                            : 0;
+                        finalScore = 0.6 * tfidfScore + 0.4 * cogneeScore;
+                    }
+                    catch {
+                        finalScore = tfidfScore;
+                    }
+                }
+                if (finalScore >= effectiveThreshold) {
+                    const result = insertStmt.run(pattern.id, ap.id, finalScore);
+                    if (result.changes > 0) {
+                        const row = db
+                            .prepare('SELECT * FROM curator_contradictions WHERE pattern_id = ? AND antipattern_id = ?')
+                            .get(pattern.id, ap.id);
+                        detected.push(this.rowToContradiction(row));
+                    }
+                }
+            }
+        }
+        return {
+            contradictions: detected,
+            cogneeAvailable,
+            method: cogneeAvailable ? 'hybrid' : 'tfidf-only',
+        };
+    }
     // ─── Grooming ───────────────────────────────────────────────────
     groomEntry(entryId) {
         const entry = this.vault.get(entryId);
@@ -477,6 +549,132 @@ export class Curator {
             recommendations,
         };
     }
+    // ─── Entry History (Version Snapshots) ─────────────────────────
+    recordSnapshot(entryId, changedBy, changeReason) {
+        const entry = this.vault.get(entryId);
+        if (!entry)
+            return { recorded: false, historyId: -1 };
+        const db = this.vault.getDb();
+        const result = db
+            .prepare('INSERT INTO curator_entry_history (entry_id, snapshot, changed_by, change_reason, created_at) VALUES (?, ?, ?, ?, unixepoch())')
+            .run(entryId, JSON.stringify(entry), changedBy ?? 'system', changeReason ?? null);
+        return { recorded: true, historyId: Number(result.lastInsertRowid) };
+    }
+    getVersionHistory(entryId) {
+        const db = this.vault.getDb();
+        const rows = db
+            .prepare('SELECT * FROM curator_entry_history WHERE entry_id = ? ORDER BY created_at ASC, id ASC')
+            .all(entryId);
+        return rows.map((row) => ({
+            historyId: row.id,
+            entryId: row.entry_id,
+            snapshot: JSON.parse(row.snapshot),
+            changedBy: row.changed_by,
+            changeReason: row.change_reason ?? null,
+            createdAt: row.created_at,
+        }));
+    }
+    // ─── Queue Stats ──────────────────────────────────────────────
+    getQueueStats() {
+        const db = this.vault.getDb();
+        const totalEntries = db.prepare('SELECT COUNT(*) as count FROM entries').get().count;
+        const groomedEntries = db
+            .prepare('SELECT COUNT(*) as count FROM curator_entry_state WHERE last_groomed_at IS NOT NULL')
+            .get().count;
+        const ungroomedEntries = totalEntries - groomedEntries;
+        const now = Math.floor(Date.now() / 1000);
+        const staleThreshold = now - 30 * 86400;
+        const freshThreshold = now - 7 * 86400;
+        const staleEntries = db
+            .prepare('SELECT COUNT(*) as count FROM curator_entry_state WHERE last_groomed_at IS NOT NULL AND last_groomed_at < ?')
+            .get(staleThreshold).count;
+        const freshEntries = db
+            .prepare('SELECT COUNT(*) as count FROM curator_entry_state WHERE last_groomed_at IS NOT NULL AND last_groomed_at >= ?')
+            .get(freshThreshold).count;
+        let avgDaysSinceGroom = 0;
+        if (groomedEntries > 0) {
+            const sumRow = db
+                .prepare('SELECT SUM(? - last_groomed_at) as total FROM curator_entry_state WHERE last_groomed_at IS NOT NULL')
+                .get(now);
+            const totalSeconds = sumRow.total ?? 0;
+            avgDaysSinceGroom = Math.round((totalSeconds / groomedEntries / 86400) * 100) / 100;
+        }
+        return {
+            totalEntries,
+            groomedEntries,
+            ungroomedEntries,
+            staleEntries,
+            freshEntries,
+            avgDaysSinceGroom,
+        };
+    }
+    // ─── Metadata Enrichment ──────────────────────────────────────
+    enrichMetadata(entryId) {
+        const entry = this.vault.get(entryId);
+        if (!entry)
+            return { enriched: false, changes: [] };
+        const changes = [];
+        const updates = {};
+        // Auto-capitalize title
+        if (entry.title.length > 0 && entry.title[0] !== entry.title[0].toUpperCase()) {
+            const capitalized = entry.title[0].toUpperCase() + entry.title.slice(1);
+            changes.push({ field: 'title', before: entry.title, after: capitalized });
+            updates.title = capitalized;
+        }
+        // Normalize tags: lowercase, trim, dedup
+        const normalizedTags = [...new Set(entry.tags.map((t) => t.toLowerCase().trim()))];
+        const tagsChanged = normalizedTags.length !== entry.tags.length ||
+            normalizedTags.some((t, i) => t !== entry.tags[i]);
+        if (tagsChanged) {
+            changes.push({
+                field: 'tags',
+                before: JSON.stringify(entry.tags),
+                after: JSON.stringify(normalizedTags),
+            });
+            updates.tags = normalizedTags;
+        }
+        // Infer severity from keywords if currently 'suggestion'
+        if (entry.severity === 'suggestion') {
+            const text = (entry.title + ' ' + entry.description).toLowerCase();
+            const criticalKeywords = ['never', 'must not', 'critical', 'security', 'vulnerability'];
+            const warningKeywords = ['avoid', 'should not', 'deprecated', 'careful', 'warning'];
+            if (criticalKeywords.some((k) => text.includes(k))) {
+                changes.push({ field: 'severity', before: entry.severity, after: 'critical' });
+                updates.severity = 'critical';
+            }
+            else if (warningKeywords.some((k) => text.includes(k))) {
+                changes.push({ field: 'severity', before: entry.severity, after: 'warning' });
+                updates.severity = 'warning';
+            }
+        }
+        // Infer type from title patterns
+        if (entry.type === 'pattern') {
+            const titleLower = entry.title.toLowerCase();
+            if (titleLower.startsWith('avoid') ||
+                titleLower.startsWith('never') ||
+                titleLower.startsWith("don't") ||
+                titleLower.startsWith('do not')) {
+                changes.push({ field: 'type', before: entry.type, after: 'anti-pattern' });
+                updates.type = 'anti-pattern';
+            }
+        }
+        // Trim whitespace from description
+        const trimmed = entry.description.trim();
+        if (trimmed !== entry.description) {
+            changes.push({ field: 'description', before: entry.description, after: trimmed });
+            updates.description = trimmed;
+        }
+        if (changes.length === 0) {
+            return { enriched: false, changes: [] };
+        }
+        // Apply updates
+        this.vault.update(entryId, updates);
+        // Record snapshot
+        this.recordSnapshot(entryId, 'curator', 'Metadata enrichment');
+        // Log change
+        this.logChange('enrich_metadata', entryId, JSON.stringify(changes.map((c) => c.field)), JSON.stringify(changes.map((c) => c.after)), 'Rule-based metadata enrichment');
+        return { enriched: true, changes };
+    }
     // ─── Private Helpers ────────────────────────────────────────────
     buildVocabulary(entries) {
         const docCount = entries.length;