shieldcortex 2.0.0

package/dist/worker/link-discovery.js

@@ -0,0 +1,103 @@
+/**
+ * Link Discovery Module
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Finds memories that have no links and discovers relationships
+ * for them during background worker cycles.
+ */
+import { getDatabase } from '../database/init.js';
+import { rowToMemory, detectRelationships, createMemoryLink, } from '../memory/store.js';
+/**
+ * Find memories that have no outgoing links
+ * These are candidates for relationship discovery
+ *
+ * @param limit - Maximum number of memories to return
+ * @returns Array of Memory objects with no outgoing links
+ */
+export function findUnlinkedMemories(limit = 10) {
+    const db = getDatabase();
+    // Find memories that are not the source of any link
+    // Prioritize by salience (important memories should be linked first)
+    const rows = db.prepare(`
+    SELECT m.* FROM memories m
+    LEFT JOIN memory_links ml ON m.id = ml.source_id
+    WHERE ml.id IS NULL
+    ORDER BY m.salience DESC, m.last_accessed DESC
+    LIMIT ?
+  `).all(limit);
+    return rows.map(rowToMemory);
+}
+/**
+ * Find memories with few links (under-linked)
+ * These might benefit from additional connections
+ *
+ * @param maxLinks - Maximum number of existing links to qualify
+ * @param limit - Maximum number of memories to return
+ * @returns Array of Memory objects with fewer than maxLinks links
+ */
+export function findUnderlinkedMemories(maxLinks = 2, limit = 10) {
+    const db = getDatabase();
+    // Find memories with fewer than maxLinks total links (as source or target)
+    const rows = db.prepare(`
+    SELECT m.*, COUNT(ml.id) as link_count
+    FROM memories m
+    LEFT JOIN memory_links ml ON m.id = ml.source_id OR m.id = ml.target_id
+    GROUP BY m.id
+    HAVING link_count < ?
+    ORDER BY m.salience DESC
+    LIMIT ?
+  `).all(maxLinks, limit);
+    return rows.map(rowToMemory);
+}
+/**
+ * Discover and create links for unlinked memories
+ * Called during medium tick to build the knowledge graph organically
+ *
+ * @param limit - Maximum number of memories to process per cycle
+ * @returns Number of new links created
+ */
+export function discoverMissingLinks(limit = 10) {
+    const unlinked = findUnlinkedMemories(limit);
+    let linksCreated = 0;
+    for (const memory of unlinked) {
+        try {
+            // Find up to 3 related memories
+            const relationships = detectRelationships(memory, 3);
+            for (const rel of relationships) {
+                const link = createMemoryLink(memory.id, rel.targetId, rel.relationship, rel.strength);
+                if (link) {
+                    linksCreated++;
+                }
+            }
+        }
+        catch (e) {
+            // Log but don't stop - continue with other memories
+            console.error(`[BrainWorker] Link discovery failed for memory ${memory.id}:`, e);
+        }
+    }
+    return linksCreated;
+}
+/**
+ * Get statistics about memory link coverage
+ * Useful for dashboard visualization
+ *
+ * @returns Object with link coverage stats
+ */
+export function getLinkCoverageStats() {
+    const db = getDatabase();
+    const totalMemories = db.prepare('SELECT COUNT(*) as count FROM memories').get().count;
+    const memoriesWithLinks = db.prepare(`
+    SELECT COUNT(DISTINCT source_id) as count FROM memory_links
+  `).get().count;
+    const totalLinks = db.prepare('SELECT COUNT(*) as count FROM memory_links').get().count;
+    return {
+        totalMemories,
+        memoriesWithLinks,
+        memoriesWithoutLinks: totalMemories - memoriesWithLinks,
+        averageLinksPerMemory: totalMemories > 0
+            ? totalLinks / totalMemories
+            : 0,
+    };
+}
+//# sourceMappingURL=link-discovery.js.map

package/dist/worker/link-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-discovery.js","sourceRoot":"","sources":["../../src/worker/link-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE;IACrD,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEzB,oDAAoD;IACpD,qEAAqE;IACrE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;GAMvB,CAAC,CAAC,GAAG,CAAC,KAAK,CAA8B,CAAC;IAE3C,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAmB,CAAC,EACpB,QAAgB,EAAE;IAElB,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEzB,2EAA2E;IAC3E,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;;;GAQvB,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAA8B,CAAC;IAErD,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE;IACrD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,gCAAgC;YAChC,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAErD,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;gBAChC,MAAM,IAAI,GAAG,gBAAgB,CAC3B,MAAM,CAAC,EAAE,EACT,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,YAAY,EAChB,GAAG,CAAC,QAAQ,CACb,CAAC;gBACF,IAAI,IAAI,EAAE,CAAC;oBACT,YAAY,EAAE,CAAC;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,oDAAoD;YACpD,OAAO,CAAC,KAAK,CACX,kDAAkD,MAAM,CAAC,EAAE,GAAG,EAC9D,CAAC,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAMlC,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEzB,MAAM,aAAa,GAAI,EAAE,CAAC,OAAO,CAC/B,wCAAwC,CACzC,CAAC,GAAG,EAAwB,CAAC,KAAK,CAAC;IAEpC,MAAM,iBAAiB,GAAI,EAAE,CAAC,OAAO,CAAC;;GAErC,CAAC,CAAC,GAAG,EAAwB,CAAC,KAAK,CAAC;IAErC,MAAM,UAAU,GAAI,EAAE,CAAC,OAAO,CAC5B,4CAA4C,CAC7C,CAAC,GAAG,EAAwB,CAAC,KAAK,CAAC;IAEpC,OAAO;QACL,aAAa;QACb,iBAAiB;QACjB,oBAAoB,EAAE,aAAa,GAAG,iBAAiB;QACvD,qBAAqB,EAAE,aAAa,GAAG,CAAC;YACtC,CAAC,CAAC,UAAU,GAAG,aAAa;YAC5B,CAAC,CAAC,CAAC;KACN,CAAC;AACJ,CAAC"}

package/dist/worker/predictive-consolidation.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Predictive Consolidation Module
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Determines when to run consolidation early based on memory pressure
+ * and activity patterns, rather than waiting for the 4-hour cycle.
+ */
+import { WorkerConfig, PredictiveDecision } from './types.js';
+/**
+ * Memory statistics type (matches getMemoryStats return type)
+ */
+export interface MemoryStats {
+    total: number;
+    shortTerm: number;
+    longTerm: number;
+    episodic: number;
+    byCategory: Record<string, number>;
+    averageSalience: number;
+}
+/**
+ * Determine if consolidation should run early
+ * More intelligent than just waiting for the 4-hour cycle
+ *
+ * @param stats - Current memory statistics
+ * @param config - Worker configuration
+ * @returns Decision object with shouldRun, reason, and urgency
+ */
+export declare function shouldTriggerPredictiveConsolidation(stats: MemoryStats, config: WorkerConfig): PredictiveDecision;
+/**
+ * Get detailed memory pressure information
+ * Useful for dashboard visualization and debugging
+ *
+ * @param stats - Current memory statistics
+ * @param config - Worker configuration
+ * @returns Object with detailed pressure metrics
+ */
+export declare function getMemoryPressure(stats: MemoryStats, config: WorkerConfig): {
+    stmFullness: number;
+    totalFullness: number;
+    ltmFullness: number;
+    isWarning: boolean;
+    isCritical: boolean;
+    recommendation: string;
+};
+//# sourceMappingURL=predictive-consolidation.d.ts.map

package/dist/worker/predictive-consolidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictive-consolidation.d.ts","sourceRoot":"","sources":["../../src/worker/predictive-consolidation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;CACzB;AASD;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB,kBAAkB,CA8DpB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAwBA"}

package/dist/worker/predictive-consolidation.js

@@ -0,0 +1,110 @@
+/**
+ * Predictive Consolidation Module
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Determines when to run consolidation early based on memory pressure
+ * and activity patterns, rather than waiting for the 4-hour cycle.
+ */
+import { getDatabase } from '../database/init.js';
+/**
+ * Memory limits (from DEFAULT_CONFIG)
+ */
+const MAX_SHORT_TERM = 100;
+const MAX_LONG_TERM = 1000;
+const MAX_TOTAL = MAX_SHORT_TERM + MAX_LONG_TERM;
+/**
+ * Determine if consolidation should run early
+ * More intelligent than just waiting for the 4-hour cycle
+ *
+ * @param stats - Current memory statistics
+ * @param config - Worker configuration
+ * @returns Decision object with shouldRun, reason, and urgency
+ */
+export function shouldTriggerPredictiveConsolidation(stats, config) {
+    const stmFullness = stats.shortTerm / MAX_SHORT_TERM;
+    const totalFullness = stats.total / MAX_TOTAL;
+    // Critical: Over 85% STM capacity - consolidate immediately
+    if (stmFullness > config.stmCriticalThreshold) {
+        return {
+            shouldRun: true,
+            reason: `STM at ${(stmFullness * 100).toFixed(0)}% (critical threshold)`,
+            urgency: 'critical',
+        };
+    }
+    // High: Over 80% total capacity
+    if (totalFullness > config.totalMemoryWarningThreshold) {
+        return {
+            shouldRun: true,
+            reason: `Total memory at ${(totalFullness * 100).toFixed(0)}% capacity`,
+            urgency: 'high',
+        };
+    }
+    // Medium: Over 70% STM + high recent activity
+    if (stmFullness > config.stmWarningThreshold) {
+        const db = getDatabase();
+        // Check recent activity (memories created in last 30 minutes)
+        const recentActivity = db.prepare(`
+      SELECT COUNT(*) as count FROM memories
+      WHERE created_at > datetime('now', '-30 minutes')
+    `).get();
+        if (recentActivity.count >= config.highActivityThreshold) {
+            return {
+                shouldRun: true,
+                reason: `STM at ${(stmFullness * 100).toFixed(0)}% with high activity (${recentActivity.count} recent memories)`,
+                urgency: 'medium',
+            };
+        }
+        // Check if many memories are below deletion threshold
+        // These are candidates for cleanup
+        const lowScoreCount = db.prepare(`
+      SELECT COUNT(*) as count FROM memories
+      WHERE type = 'short_term' AND decayed_score < 0.25
+    `).get();
+        if (lowScoreCount.count > 15) {
+            return {
+                shouldRun: true,
+                reason: `${lowScoreCount.count} STM memories below salience threshold`,
+                urgency: 'medium',
+            };
+        }
+    }
+    // No consolidation needed
+    return {
+        shouldRun: false,
+        reason: 'No consolidation triggers met',
+        urgency: 'low',
+    };
+}
+/**
+ * Get detailed memory pressure information
+ * Useful for dashboard visualization and debugging
+ *
+ * @param stats - Current memory statistics
+ * @param config - Worker configuration
+ * @returns Object with detailed pressure metrics
+ */
+export function getMemoryPressure(stats, config) {
+    const stmFullness = stats.shortTerm / MAX_SHORT_TERM;
+    const ltmFullness = stats.longTerm / MAX_LONG_TERM;
+    const totalFullness = stats.total / MAX_TOTAL;
+    const isCritical = stmFullness > config.stmCriticalThreshold;
+    const isWarning = stmFullness > config.stmWarningThreshold ||
+        totalFullness > config.totalMemoryWarningThreshold;
+    let recommendation = 'Memory levels healthy';
+    if (isCritical) {
+        recommendation = 'Immediate consolidation recommended';
+    }
+    else if (isWarning) {
+        recommendation = 'Consider running consolidation soon';
+    }
+    return {
+        stmFullness,
+        totalFullness,
+        ltmFullness,
+        isWarning,
+        isCritical,
+        recommendation,
+    };
+}
+//# sourceMappingURL=predictive-consolidation.js.map

package/dist/worker/predictive-consolidation.js.map

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

package/dist/worker/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Brain Worker Types and Configuration
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Defines configuration, result types, and status interfaces
+ * for the background brain worker.
+ */
+import { ConsolidationResult } from '../memory/types.js';
+/**
+ * Configuration for the brain worker
+ */
+export interface WorkerConfig {
+    /** Light tick interval - activation pruning, predictive check (default: 5 min) */
+    lightTickIntervalMs: number;
+    /** Medium tick interval - link discovery, contradiction scan (default: 30 min) */
+    mediumTickIntervalMs: number;
+    /** STM warning threshold - consider consolidation when exceeded (default: 0.7 = 70%) */
+    stmWarningThreshold: number;
+    /** STM critical threshold - immediate consolidation (default: 0.85 = 85%) */
+    stmCriticalThreshold: number;
+    /** Total memory warning threshold (default: 0.8 = 80% of 1100 total) */
+    totalMemoryWarningThreshold: number;
+    /** Max memories to process for link discovery per cycle (default: 10) */
+    maxLinksPerCycle: number;
+    /** Max contradiction pairs to check per scan (default: 50) */
+    contradictionScanLimit: number;
+    /** High activity threshold - memories created in 30 min (default: 5) */
+    highActivityThreshold: number;
+}
+/**
+ * Default worker configuration
+ */
+export declare const DEFAULT_WORKER_CONFIG: WorkerConfig;
+/**
+ * Result of a light tick operation
+ */
+export interface LightTickResult {
+    /** Number of stale activation entries pruned */
+    activationsPruned: number;
+    /** Consolidation result if predictive consolidation ran, null otherwise */
+    predictiveConsolidation: ConsolidationResult | null;
+    /** When this tick completed */
+    timestamp: Date;
+}
+/**
+ * Result of a medium tick operation
+ */
+export interface MediumTickResult {
+    /** Number of new links discovered and created */
+    linksDiscovered: number;
+    /** Number of contradictions detected */
+    contradictionsFound: number;
+    /** Number of contradiction links created */
+    contradictionsLinked: number;
+    /** Number of memories scanned for links */
+    memoriesScanned: number;
+    /** When this tick completed */
+    timestamp: Date;
+}
+/**
+ * Current status of the brain worker
+ */
+export interface WorkerStatus {
+    /** Whether the worker is currently running */
+    isRunning: boolean;
+    /** When the last light tick completed */
+    lastLightTick: Date | null;
+    /** When the last medium tick completed */
+    lastMediumTick: Date | null;
+    /** When the last predictive consolidation ran */
+    lastConsolidation: Date | null;
+    /** Cumulative statistics */
+    stats: {
+        lightTicks: number;
+        mediumTicks: number;
+        consolidations: number;
+    };
+}
+/**
+ * Decision from predictive consolidation check
+ */
+export interface PredictiveDecision {
+    /** Whether consolidation should run */
+    shouldRun: boolean;
+    /** Human-readable reason for the decision */
+    reason: string;
+    /** Urgency level of the consolidation need */
+    urgency: 'low' | 'medium' | 'high' | 'critical';
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/worker/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,mBAAmB,EAAE,MAAM,CAAC;IAE5B,kFAAkF;IAClF,oBAAoB,EAAE,MAAM,CAAC;IAE7B,wFAAwF;IACxF,mBAAmB,EAAE,MAAM,CAAC;IAE5B,6EAA6E;IAC7E,oBAAoB,EAAE,MAAM,CAAC;IAE7B,wEAAwE;IACxE,2BAA2B,EAAE,MAAM,CAAC;IAEpC,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IAEzB,8DAA8D;IAC9D,sBAAsB,EAAE,MAAM,CAAC;IAE/B,wEAAwE;IACxE,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YASnC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,2EAA2E;IAC3E,uBAAuB,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAEpD,+BAA+B;IAC/B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IAExB,wCAAwC;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,4CAA4C;IAC5C,oBAAoB,EAAE,MAAM,CAAC;IAE7B,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IAExB,+BAA+B;IAC/B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IAEnB,yCAAyC;IACzC,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAE3B,0CAA0C;IAC1C,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAE5B,iDAAiD;IACjD,iBAAiB,EAAE,IAAI,GAAG,IAAI,CAAC;IAE/B,4BAA4B;IAC5B,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IAEnB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IAEf,8CAA8C;IAC9C,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CACjD"}

package/dist/worker/types.js

@@ -0,0 +1,22 @@
+/**
+ * Brain Worker Types and Configuration
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Defines configuration, result types, and status interfaces
+ * for the background brain worker.
+ */
+/**
+ * Default worker configuration
+ */
+export const DEFAULT_WORKER_CONFIG = {
+    lightTickIntervalMs: 5 * 60 * 1000, // 5 minutes
+    mediumTickIntervalMs: 30 * 60 * 1000, // 30 minutes
+    stmWarningThreshold: 0.7, // 70 of 100 STM
+    stmCriticalThreshold: 0.85, // 85 of 100 STM
+    totalMemoryWarningThreshold: 0.8, // 880 of 1100 total
+    maxLinksPerCycle: 10,
+    contradictionScanLimit: 50,
+    highActivityThreshold: 5,
+};
+//# sourceMappingURL=types.js.map

package/dist/worker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/worker/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiCH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,mBAAmB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAQ,YAAY;IACtD,oBAAoB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAM,aAAa;IACvD,mBAAmB,EAAE,GAAG,EAAmB,gBAAgB;IAC3D,oBAAoB,EAAE,IAAI,EAAiB,gBAAgB;IAC3D,2BAA2B,EAAE,GAAG,EAAW,oBAAoB;IAC/D,gBAAgB,EAAE,EAAE;IACpB,sBAAsB,EAAE,EAAE;IAC1B,qBAAqB,EAAE,CAAC;CACzB,CAAC"}

package/hooks/clawdbot/cortex-memory/HOOK.md

@@ -0,0 +1,71 @@
+---
+name: cortex-memory
+description: "Persistent brain-like memory via ShieldCortex — auto-saves session context and recalls past knowledge"
+homepage: https://github.com/mkdelta221/shieldcortex
+metadata:
+  {
+    "clawdbot":
+      {
+        "emoji": "🧠",
+        "events": ["command:new", "agent:bootstrap", "command"],
+        "requires": { "anyBins": ["npx"] },
+        "install": [{ "id": "community", "kind": "community", "label": "ShieldCortex" }],
+      },
+  }
+---
+
+# Cortex Memory Hook
+
+Integrates [ShieldCortex](https://github.com/mkdelta221/shieldcortex) persistent memory. Automatically saves important session context and recalls past knowledge at session start.
+
+## What It Does
+
+### On `/new` (Session End)
+1. Reads the ending session transcript
+2. Pattern-matches for decisions, bug fixes, learnings, architecture changes, and preferences
+3. Saves up to 5 high-salience memories to ShieldCortex via mcporter
+
+### On Session Start (Agent Bootstrap)
+1. Calls Cortex `get_context` to retrieve relevant memories
+2. Injects them into the agent's bootstrap context
+3. Agent starts with knowledge of past sessions
+
+### Keyword Triggers
+- Say **"remember this"** or **"don't forget"** followed by content
+- Auto-saves to Cortex with critical importance
+
+## Requirements
+
+- **npx** must be available (Node.js installed)
+- ShieldCortex installs automatically on first use via `npx -y shieldcortex`
+- mcporter must be available for MCP tool calls
+
+## Database
+
+Memories stored in `~/.shieldcortex/memories.db` (SQLite). Shared with Claude Code sessions — memories created here are available everywhere.
+
+## Install
+
+```bash
+npx shieldcortex clawdbot install
+```
+
+## Uninstall
+
+```bash
+npx shieldcortex clawdbot uninstall
+```
+
+Or disable without removing:
+
+```json
+{
+  "hooks": {
+    "internal": {
+      "entries": {
+        "cortex-memory": { "enabled": false }
+      }
+    }
+  }
+}
+```