shieldcortex 2.0.0

package/dist/defence/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Defence layer type definitions
+ *
+ * Backend-agnostic security types that define the interface for protecting
+ * any memory backend, not just the built-in Cortex store.
+ */
+export type SensitivityLevel = 'PUBLIC' | 'INTERNAL' | 'CONFIDENTIAL' | 'RESTRICTED';
+export type FirewallResult = 'ALLOW' | 'BLOCK' | 'QUARANTINE';
+export type ThreatIndicator = 'instruction_injection' | 'privilege_escalation' | 'encoding_obfuscation' | 'credential_leak' | 'external_url' | 'fragmented_payload';
+export interface DefenceSource {
+    type: 'user' | 'email' | 'web' | 'agent' | 'file' | 'api';
+    identifier: string;
+}
+export interface FirewallAnalysis {
+    result: FirewallResult;
+    reason: string;
+    threatIndicators: ThreatIndicator[];
+    anomalyScore: number;
+    blockedPatterns: string[];
+}
+export interface FragmentationAnalysis {
+    score: number;
+    relatedMemoryIds: number[];
+    suspiciousEntities: string[];
+    assemblyRisk: string;
+}
+export interface SensitivityClassification {
+    level: SensitivityLevel;
+    confidence: number;
+    detectedPatterns: string[];
+    redactionRequired: boolean;
+}
+export interface TrustScore {
+    score: number;
+    source: DefenceSource;
+    hierarchy: string[];
+}
+export interface DefencePipelineResult {
+    allowed: boolean;
+    firewall: FirewallAnalysis;
+    fragmentation: FragmentationAnalysis | null;
+    sensitivity: SensitivityClassification;
+    trust: TrustScore;
+    auditId: number;
+}
+export interface DefenceConfig {
+    mode: 'strict' | 'balanced' | 'permissive';
+    enableFragmentationDetection: boolean;
+    fragmentationWindowHours: number;
+    trustThresholdForActions: number;
+    autoQuarantineThreshold: number;
+    flagThreshold: number;
+}
+export declare const DEFAULT_DEFENCE_CONFIG: DefenceConfig;
+export interface QuarantineEntry {
+    id: number;
+    original_content: string;
+    original_title: string | null;
+    source_type: string;
+    source_identifier: string;
+    reason: string;
+    threat_indicators: string;
+    anomaly_score: number;
+    firewall_result: 'BLOCK' | 'QUARANTINE';
+    status: 'pending' | 'approved' | 'rejected' | 'expired';
+    reviewed_at: string | null;
+    reviewed_by: string | null;
+    created_at: string;
+    expires_at: string | null;
+    audit_id: number | null;
+}
+export interface AuditEntry {
+    id: number;
+    memory_id: number | null;
+    timestamp: string;
+    source_type: string;
+    source_identifier: string;
+    trust_score: number;
+    sensitivity_level: string;
+    firewall_result: FirewallResult;
+    anomaly_score: number;
+    threat_indicators: string;
+    blocked_patterns: string;
+    reason: string | null;
+    fragmentation_score: number | null;
+    pipeline_duration_ms: number | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/defence/types.js

@@ -0,0 +1,15 @@
+/**
+ * Defence layer type definitions
+ *
+ * Backend-agnostic security types that define the interface for protecting
+ * any memory backend, not just the built-in Cortex store.
+ */
+export const DEFAULT_DEFENCE_CONFIG = {
+    mode: 'balanced',
+    enableFragmentationDetection: true,
+    fragmentationWindowHours: 24,
+    trustThresholdForActions: 0.7,
+    autoQuarantineThreshold: 0.3,
+    flagThreshold: 0.5,
+};
+//# sourceMappingURL=types.js.map

package/dist/defence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/defence/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuEH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,IAAI,EAAE,UAAU;IAChB,4BAA4B,EAAE,IAAI;IAClC,wBAAwB,EAAE,EAAE;IAC5B,wBAAwB,EAAE,GAAG;IAC7B,uBAAuB,EAAE,GAAG;IAC5B,aAAa,EAAE,GAAG;CACnB,CAAC"}

package/dist/embeddings/generator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generate embedding vector for text
+ * @param text - Text to embed (title + content recommended)
+ * @returns Float32Array of 384 dimensions
+ */
+export declare function generateEmbedding(text: string): Promise<Float32Array>;
+/**
+ * Calculate cosine similarity between two embeddings
+ * @returns Similarity score 0-1 (1 = identical)
+ */
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+/**
+ * Check if embedding model is loaded
+ */
+export declare function isModelLoaded(): boolean;
+/**
+ * Preload the model (call during startup if desired)
+ */
+export declare function preloadModel(): Promise<void>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/embeddings/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/embeddings/generator.ts"],"names":[],"mappings":"AAoCA;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAgB3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAmBzE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD"}

package/dist/embeddings/generator.js

@@ -0,0 +1,83 @@
+import { pipeline, env } from '@huggingface/transformers';
+// Configure for operation
+env.allowRemoteModels = true;
+env.allowLocalModels = true;
+let embeddingPipeline = null;
+let isLoading = false;
+let loadPromise = null;
+/**
+ * Lazy-load the embedding model
+ * Model: all-MiniLM-L6-v2 (22MB, 384 dimensions)
+ * Uses @huggingface/transformers (successor to @xenova/transformers)
+ * with better ARM64 Linux support
+ */
+async function getEmbeddingPipeline() {
+    if (embeddingPipeline)
+        return embeddingPipeline;
+    if (isLoading && loadPromise) {
+        return loadPromise;
+    }
+    isLoading = true;
+    loadPromise = pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2');
+    try {
+        embeddingPipeline = await loadPromise;
+        return embeddingPipeline;
+    }
+    finally {
+        isLoading = false;
+        loadPromise = null;
+    }
+}
+/**
+ * Generate embedding vector for text
+ * @param text - Text to embed (title + content recommended)
+ * @returns Float32Array of 384 dimensions
+ */
+export async function generateEmbedding(text) {
+    const extractor = await getEmbeddingPipeline();
+    // Truncate to ~512 tokens worth (~2000 chars) for model limits
+    const truncated = text.slice(0, 2000);
+    const output = await extractor(truncated, {
+        pooling: 'mean',
+        normalize: true,
+    });
+    // Handle both Tensor objects (new @huggingface/transformers) and plain objects
+    const data = typeof output.tolist === 'function'
+        ? new Float32Array(output.tolist().flat(Infinity))
+        : new Float32Array(output.data);
+    return data;
+}
+/**
+ * Calculate cosine similarity between two embeddings
+ * @returns Similarity score 0-1 (1 = identical)
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Embedding dimension mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+    if (magnitude === 0)
+        return 0;
+    return dotProduct / magnitude;
+}
+/**
+ * Check if embedding model is loaded
+ */
+export function isModelLoaded() {
+    return embeddingPipeline !== null;
+}
+/**
+ * Preload the model (call during startup if desired)
+ */
+export async function preloadModel() {
+    await getEmbeddingPipeline();
+}
+//# sourceMappingURL=generator.js.map

package/dist/embeddings/generator.js.map

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

package/dist/embeddings/index.d.ts

@@ -0,0 +1,2 @@
+export { generateEmbedding, cosineSimilarity, isModelLoaded, preloadModel } from './generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/embeddings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/embeddings/index.js

@@ -0,0 +1,2 @@
+export { generateEmbedding, cosineSimilarity, isModelLoaded, preloadModel } from './generator.js';
+//# sourceMappingURL=index.js.map

package/dist/embeddings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Custom Error Classes
+ *
+ * Provides actionable error messages that help users understand
+ * what went wrong and how to fix it.
+ */
+/**
+ * Base class for ShieldCortex errors
+ */
+export declare class MemoryError extends Error {
+    readonly code: string;
+    readonly suggestion: string;
+    constructor(message: string, code: string, suggestion: string);
+    toUserMessage(): string;
+}
+/**
+ * Database blocked due to size limits
+ */
+export declare class DatabaseBlockedError extends MemoryError {
+    constructor(currentSize: string);
+}
+/**
+ * Database size warning (approaching limit)
+ */
+export declare class DatabaseSizeWarning extends MemoryError {
+    constructor(currentSize: string);
+}
+/**
+ * Memory not found
+ */
+export declare class MemoryNotFoundError extends MemoryError {
+    constructor(id: number);
+}
+/**
+ * Invalid search query
+ */
+export declare class InvalidQueryError extends MemoryError {
+    constructor(query: string, reason: string);
+}
+/**
+ * Content too large
+ */
+export declare class ContentTooLargeError extends MemoryError {
+    constructor(contentSize: number, maxSize: number);
+}
+/**
+ * Bulk delete safety guard
+ */
+export declare class BulkDeleteSafetyError extends MemoryError {
+    constructor(count: number);
+}
+/**
+ * Database not initialized
+ */
+export declare class DatabaseNotInitializedError extends MemoryError {
+    constructor();
+}
+/**
+ * Session not found
+ */
+export declare class SessionNotFoundError extends MemoryError {
+    constructor(sessionId: number);
+}
+/**
+ * Invalid memory relationship
+ */
+export declare class InvalidRelationshipError extends MemoryError {
+    constructor(sourceId: number, targetId: number, reason: string);
+}
+/**
+ * Format error for MCP tool output
+ */
+export declare function formatErrorForMcp(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAO7D,aAAa,IAAI,MAAM;CAGxB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,WAAW,EAAE,MAAM;CAQhC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,WAAW,EAAE,MAAM;CAQhC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,EAAE,EAAE,MAAM;CAQvB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ1C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAUjD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,KAAK,EAAE,MAAM;CAQ1B;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,WAAW;;CAS3D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,SAAS,EAAE,MAAM;CAQ9B;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,WAAW;gBAC3C,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAwBxD"}

package/dist/errors.js

@@ -0,0 +1,131 @@
+/**
+ * Custom Error Classes
+ *
+ * Provides actionable error messages that help users understand
+ * what went wrong and how to fix it.
+ */
+/**
+ * Base class for ShieldCortex errors
+ */
+export class MemoryError extends Error {
+    code;
+    suggestion;
+    constructor(message, code, suggestion) {
+        super(message);
+        this.name = 'MemoryError';
+        this.code = code;
+        this.suggestion = suggestion;
+    }
+    toUserMessage() {
+        return `${this.message}\n\nSuggestion: ${this.suggestion}`;
+    }
+}
+/**
+ * Database blocked due to size limits
+ */
+export class DatabaseBlockedError extends MemoryError {
+    constructor(currentSize) {
+        super(`Database blocked: ${currentSize} exceeds the 100MB limit`, 'DB_BLOCKED', 'Run "consolidate" to clean up old memories, or use "forget" to remove memories you no longer need.');
+        this.name = 'DatabaseBlockedError';
+    }
+}
+/**
+ * Database size warning (approaching limit)
+ */
+export class DatabaseSizeWarning extends MemoryError {
+    constructor(currentSize) {
+        super(`Database size warning: ${currentSize} is approaching the 100MB limit`, 'DB_SIZE_WARNING', 'Consider running "consolidate" to clean up old memories before reaching the limit.');
+        this.name = 'DatabaseSizeWarning';
+    }
+}
+/**
+ * Memory not found
+ */
+export class MemoryNotFoundError extends MemoryError {
+    constructor(id) {
+        super(`Memory with ID ${id} not found`, 'MEMORY_NOT_FOUND', 'Use "recall" to search for existing memories, or check if the memory was deleted by consolidation.');
+        this.name = 'MemoryNotFoundError';
+    }
+}
+/**
+ * Invalid search query
+ */
+export class InvalidQueryError extends MemoryError {
+    constructor(query, reason) {
+        super(`Invalid search query "${query}": ${reason}`, 'INVALID_QUERY', 'Try simpler search terms. Avoid special characters like *, ^, ( ). Use quotes around phrases.');
+        this.name = 'InvalidQueryError';
+    }
+}
+/**
+ * Content too large
+ */
+export class ContentTooLargeError extends MemoryError {
+    constructor(contentSize, maxSize) {
+        const sizeKB = (contentSize / 1024).toFixed(1);
+        const maxKB = (maxSize / 1024).toFixed(1);
+        super(`Content size (${sizeKB}KB) exceeds maximum allowed (${maxKB}KB)`, 'CONTENT_TOO_LARGE', 'Split large content into multiple smaller memories. Focus on the key points rather than storing everything.');
+        this.name = 'ContentTooLargeError';
+    }
+}
+/**
+ * Bulk delete safety guard
+ */
+export class BulkDeleteSafetyError extends MemoryError {
+    constructor(count) {
+        super(`Bulk delete blocked: ${count} memories would be deleted`, 'BULK_DELETE_BLOCKED', 'This operation would delete many memories. Use "dryRun: true" first to preview what would be deleted, then set "confirm: true" to proceed.');
+        this.name = 'BulkDeleteSafetyError';
+    }
+}
+/**
+ * Database not initialized
+ */
+export class DatabaseNotInitializedError extends MemoryError {
+    constructor() {
+        super('Database not initialized', 'DB_NOT_INIT', 'This usually means the MCP server failed to start properly. Check that the database path is accessible and try restarting the server.');
+        this.name = 'DatabaseNotInitializedError';
+    }
+}
+/**
+ * Session not found
+ */
+export class SessionNotFoundError extends MemoryError {
+    constructor(sessionId) {
+        super(`Session ${sessionId} not found`, 'SESSION_NOT_FOUND', 'The session may have already ended or was never started. Use "start_session" to begin a new session.');
+        this.name = 'SessionNotFoundError';
+    }
+}
+/**
+ * Invalid memory relationship
+ */
+export class InvalidRelationshipError extends MemoryError {
+    constructor(sourceId, targetId, reason) {
+        super(`Cannot create relationship between memory ${sourceId} and ${targetId}: ${reason}`, 'INVALID_RELATIONSHIP', 'Ensure both memories exist and are not the same memory. Use "get_memory" to verify the memory IDs.');
+        this.name = 'InvalidRelationshipError';
+    }
+}
+/**
+ * Format error for MCP tool output
+ */
+export function formatErrorForMcp(error) {
+    if (error instanceof MemoryError) {
+        return error.toUserMessage();
+    }
+    if (error instanceof Error) {
+        // Try to make common errors more helpful
+        if (error.message.includes('SQLITE_BUSY')) {
+            return 'Database is busy (another operation in progress). Please try again in a moment.';
+        }
+        if (error.message.includes('SQLITE_LOCKED')) {
+            return 'Database is locked. This may happen if multiple processes are accessing the database. Wait a moment and try again.';
+        }
+        if (error.message.includes('SQLITE_CORRUPT')) {
+            return 'Database corruption detected. Try running "consolidate" to repair, or restore from backup.';
+        }
+        if (error.message.includes('no such table')) {
+            return 'Database schema error. The database may need to be reinitialized. Try restarting the MCP server.';
+        }
+        return `Error: ${error.message}`;
+    }
+    return 'An unknown error occurred. Please try again or check the server logs.';
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,IAAI,CAAS;IACb,UAAU,CAAS;IAEnC,YAAY,OAAe,EAAE,IAAY,EAAE,UAAkB;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,aAAa;QACX,OAAO,GAAG,IAAI,CAAC,OAAO,mBAAmB,IAAI,CAAC,UAAU,EAAE,CAAC;IAC7D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,WAAmB;QAC7B,KAAK,CACH,qBAAqB,WAAW,0BAA0B,EAC1D,YAAY,EACZ,oGAAoG,CACrG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,WAAmB;QAC7B,KAAK,CACH,0BAA0B,WAAW,iCAAiC,EACtE,iBAAiB,EACjB,oFAAoF,CACrF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,EAAU;QACpB,KAAK,CACH,kBAAkB,EAAE,YAAY,EAChC,kBAAkB,EAClB,oGAAoG,CACrG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,YAAY,KAAa,EAAE,MAAc;QACvC,KAAK,CACH,yBAAyB,KAAK,MAAM,MAAM,EAAE,EAC5C,eAAe,EACf,+FAA+F,CAChG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,WAAmB,EAAE,OAAe;QAC9C,MAAM,MAAM,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1C,KAAK,CACH,iBAAiB,MAAM,gCAAgC,KAAK,KAAK,EACjE,mBAAmB,EACnB,6GAA6G,CAC9G,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD,YAAY,KAAa;QACvB,KAAK,CACH,wBAAwB,KAAK,4BAA4B,EACzD,qBAAqB,EACrB,4IAA4I,CAC7I,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,WAAW;IAC1D;QACE,KAAK,CACH,0BAA0B,EAC1B,aAAa,EACb,uIAAuI,CACxI,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,SAAiB;QAC3B,KAAK,CACH,WAAW,SAAS,YAAY,EAChC,mBAAmB,EACnB,sGAAsG,CACvG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,WAAW;IACvD,YAAY,QAAgB,EAAE,QAAgB,EAAE,MAAc;QAC5D,KAAK,CACH,6CAA6C,QAAQ,QAAQ,QAAQ,KAAK,MAAM,EAAE,EAClF,sBAAsB,EACtB,oGAAoG,CACrG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,aAAa,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,yCAAyC;QACzC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1C,OAAO,iFAAiF,CAAC;QAC3F,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC5C,OAAO,oHAAoH,CAAC;QAC9H,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC7C,OAAO,4FAA4F,CAAC;QACtG,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC5C,OAAO,kGAAkG,CAAC;QAC5G,CAAC;QAED,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,uEAAuE,CAAC;AACjF,CAAC"}

package/dist/graph/backfill.d.ts

@@ -0,0 +1,6 @@
+export declare function backfillGraph(): {
+    entities: number;
+    triples: number;
+    memoriesProcessed: number;
+};
+//# sourceMappingURL=backfill.d.ts.map

package/dist/graph/backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../src/graph/backfill.ts"],"names":[],"mappings":"AAIA,wBAAgB,aAAa,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAqChG"}

package/dist/graph/backfill.js

@@ -0,0 +1,33 @@
+import { getDatabase } from '../database/init.js';
+import { extractFromMemory } from './extract.js';
+import { processExtractionResult } from './resolve.js';
+export function backfillGraph() {
+    const db = getDatabase();
+    const memories = db.prepare('SELECT id, title, content, category FROM memories ORDER BY id').all();
+    let entitiesBefore = db.prepare('SELECT COUNT(*) as c FROM entities').get().c;
+    let triplesBefore = db.prepare('SELECT COUNT(*) as c FROM triples').get().c;
+    let processed = 0;
+    for (const mem of memories) {
+        try {
+            const extraction = extractFromMemory(mem.title, mem.content, mem.category);
+            if (extraction.entities.length > 0) {
+                processExtractionResult(extraction, mem.id);
+            }
+        }
+        catch (e) {
+            console.error(`[backfill] Failed on memory #${mem.id}: ${e}`);
+        }
+        processed++;
+        if (processed % 50 === 0) {
+            console.log(`[backfill] Processed ${processed}/${memories.length} memories...`);
+        }
+    }
+    const entitiesAfter = db.prepare('SELECT COUNT(*) as c FROM entities').get().c;
+    const triplesAfter = db.prepare('SELECT COUNT(*) as c FROM triples').get().c;
+    return {
+        entities: entitiesAfter - entitiesBefore,
+        triples: triplesAfter - triplesBefore,
+        memoriesProcessed: processed,
+    };
+}
+//# sourceMappingURL=backfill.js.map

package/dist/graph/backfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.js","sourceRoot":"","sources":["../../src/graph/backfill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,UAAU,aAAa;IAC3B,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEzB,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,+DAA+D,CAAC,CAAC,GAAG,EAK9F,CAAC;IAEH,IAAI,cAAc,GAAI,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;IACjG,IAAI,aAAa,GAAI,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;IAE/F,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC3E,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,uBAAuB,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,gCAAgC,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,SAAS,EAAE,CAAC;QACZ,IAAI,SAAS,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,wBAAwB,SAAS,IAAI,QAAQ,CAAC,MAAM,cAAc,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAI,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;IAClG,MAAM,YAAY,GAAI,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;IAEhG,OAAO;QACL,QAAQ,EAAE,aAAa,GAAG,cAAc;QACxC,OAAO,EAAE,YAAY,GAAG,aAAa;QACrC,iBAAiB,EAAE,SAAS;KAC7B,CAAC;AACJ,CAAC"}

package/dist/graph/extract.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pattern-based entity and triple extraction engine.
+ * Extracts entities (files, languages, tools, people, concepts) and
+ * relationship triples from memory title + content using pure regex matching.
+ */
+export type EntityType = 'person' | 'tool' | 'concept' | 'file' | 'language' | 'service' | 'pattern';
+export interface ExtractedEntity {
+    name: string;
+    type: EntityType;
+}
+export interface ExtractedTriple {
+    subject: string;
+    predicate: string;
+    object: string;
+}
+export interface ExtractionResult {
+    entities: ExtractedEntity[];
+    triples: ExtractedTriple[];
+}
+export declare function extractFromMemory(title: string, content: string, category: string): ExtractionResult;
+//# sourceMappingURL=extract.d.ts.map

package/dist/graph/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/graph/extract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAErG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAoED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAsLpG"}