mcard-js 2.1.41 → 2.1.43

package/dist/storage/schema.d.ts

@@ -1,162 +0,0 @@
-/**
- * MCard Database Schema Loader for JavaScript/TypeScript
- *
- * Singleton implementation that loads all schemas from:
- *   schema/mcard_schema.sql (SINGLE SOURCE OF TRUTH)
- *
- * This ensures schema consistency between Python and JavaScript runtimes.
- *
- * Usage:
- *   import { MCardSchema } from './schema';
- *
- *   const schema = MCardSchema.getInstance();
- *   const cardSchema = schema.getTable('card');
- *   schema.initAllTables(db);
- *
- * Architecture Layers:
- *   Layer 1: Core Content Storage (card)
- *   Layer 2: Handle System (handle_registry, handle_history)
- *   Layer 3: Vector Storage (mcard_vector_metadata, mcard_embeddings)
- *   Layer 4: Semantic Versioning (handle_version_vectors, similarity_cache)
- *   Layer 5: Knowledge Graph (entities, relationships, communities)
- *
- * See: docs/architecture/Handle_Vector_Similarity_Design.md
- */
-export type SchemaLayer = 'core' | 'handle' | 'vector' | 'semantic' | 'graph' | 'metadata';
-/**
- * Singleton class for MCard database schema management.
- *
- * Ensures all schema definitions come from the single source of truth:
- * schema/mcard_schema.sql
- */
-export declare class MCardSchema {
-    private static instance;
-    private schemaPath;
-    private rawSql;
-    private statements;
-    private tables;
-    private indexes;
-    private loaded;
-    private constructor();
-    /**
-     * Get the singleton instance.
-     */
-    static getInstance(): MCardSchema;
-    /**
-     * Reset the singleton (for testing).
-     */
-    static resetInstance(): void;
-    private load;
-    private parseStatements;
-    private extractName;
-    getSchemaPath(): string;
-    getTable(tableName: string): string | undefined;
-    getIndex(indexName: string): string | undefined;
-    getAllTables(): Map<string, string>;
-    getAllIndexes(): Map<string, string>;
-    getAllStatements(): string[];
-    getTablesByLayer(layer: SchemaLayer): string[];
-    getLayerStatements(layer: SchemaLayer): string[];
-    private execStatements;
-    initLayer(db: {
-        exec: (sql: string) => void;
-    }, layer: SchemaLayer): number;
-    initCoreTables(db: {
-        exec: (sql: string) => void;
-    }): number;
-    initHandleTables(db: {
-        exec: (sql: string) => void;
-    }): number;
-    initVectorTables(db: {
-        exec: (sql: string) => void;
-    }, enableFts?: boolean): number;
-    initSemanticTables(db: {
-        exec: (sql: string) => void;
-    }): number;
-    initGraphTables(db: {
-        exec: (sql: string) => void;
-    }): number;
-    initAllTables(db: {
-        exec: (sql: string) => void;
-    }, options?: {
-        enableFts?: boolean;
-        enableGraph?: boolean;
-        enableSemantic?: boolean;
-    }): number;
-    initVec0Table(db: {
-        exec: (sql: string) => void;
-    }, dimensions: number): void;
-}
-export declare const CARD_TABLE_SCHEMA: string;
-export declare const HANDLE_REGISTRY_SCHEMA: string;
-export declare const HANDLE_HISTORY_SCHEMA: string;
-export declare const HANDLE_INDEX_SCHEMA: string;
-export declare const VECTOR_METADATA_SCHEMA: string;
-export declare const VECTOR_METADATA_INDEX: string;
-export declare const VECTOR_EMBEDDINGS_SCHEMA: string;
-export declare const VECTOR_FTS_SCHEMA: string;
-export declare const HANDLE_VERSION_VECTORS_SCHEMA: string;
-export declare const HANDLE_VERSION_VECTORS_INDEXES: string;
-export declare const VERSION_SIMILARITY_CACHE_SCHEMA: string;
-export declare const VERSION_SIMILARITY_CACHE_INDEX: string;
-export declare const GRAPH_ENTITY_SCHEMA: string;
-export declare const GRAPH_ENTITY_INDEX_NAME: string;
-export declare const GRAPH_ENTITY_INDEX_TYPE: string;
-export declare const GRAPH_ENTITY_INDEX_SOURCE: string;
-export declare const GRAPH_RELATIONSHIP_SCHEMA: string;
-export declare const GRAPH_RELATIONSHIP_INDEX_SOURCE: string;
-export declare const GRAPH_RELATIONSHIP_INDEX_TARGET: string;
-export declare const GRAPH_COMMUNITY_SCHEMA: string;
-export declare const GRAPH_COMMUNITY_INDEX_LEVEL: string;
-export declare const GRAPH_EXTRACTION_SCHEMA: string;
-export declare const CORE_SCHEMAS: {
-    card: string;
-    handleRegistry: string;
-    handleHistory: string;
-    handleIndex: string;
-};
-export declare const VECTOR_SCHEMAS: {
-    metadata: string;
-    metadataIndex: string;
-    embeddings: string;
-    fts: string;
-};
-export declare const SEMANTIC_SCHEMAS: {
-    handleVersionVectors: string;
-    handleVersionVectorsIndexes: string;
-    similarityCache: string;
-    similarityCacheIndex: string;
-};
-export declare const GRAPH_SCHEMAS: {
-    entities: string;
-    entityIndexName: string;
-    entityIndexType: string;
-    entityIndexSource: string;
-    relationships: string;
-    relIndexSource: string;
-    relIndexTarget: string;
-    communities: string;
-    communityIndexLevel: string;
-    extractions: string;
-};
-export declare function initCoreSchemas(db: {
-    exec: (sql: string) => void;
-}): void;
-export declare function initVectorSchemas(db: {
-    exec: (sql: string) => void;
-}, enableFts?: boolean): void;
-export declare function initSemanticSchemas(db: {
-    exec: (sql: string) => void;
-}): void;
-export declare function initGraphSchemas(db: {
-    exec: (sql: string) => void;
-}): void;
-export declare function initAllSchemas(db: {
-    exec: (sql: string) => void;
-}, options?: {
-    enableFts?: boolean;
-    enableGraph?: boolean;
-    enableSemantic?: boolean;
-}): void;
-export declare function getVec0Schema(dimensions: number): string;
-//# sourceMappingURL=schema.d.ts.map

package/dist/storage/schema.d.ts.map

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

package/dist/storage/schema.js

@@ -1,335 +0,0 @@
-/**
- * MCard Database Schema Loader for JavaScript/TypeScript
- *
- * Singleton implementation that loads all schemas from:
- *   schema/mcard_schema.sql (SINGLE SOURCE OF TRUTH)
- *
- * This ensures schema consistency between Python and JavaScript runtimes.
- *
- * Usage:
- *   import { MCardSchema } from './schema';
- *
- *   const schema = MCardSchema.getInstance();
- *   const cardSchema = schema.getTable('card');
- *   schema.initAllTables(db);
- *
- * Architecture Layers:
- *   Layer 1: Core Content Storage (card)
- *   Layer 2: Handle System (handle_registry, handle_history)
- *   Layer 3: Vector Storage (mcard_vector_metadata, mcard_embeddings)
- *   Layer 4: Semantic Versioning (handle_version_vectors, similarity_cache)
- *   Layer 5: Knowledge Graph (entities, relationships, communities)
- *
- * See: docs/architecture/Handle_Vector_Similarity_Design.md
- */
-import { MCARD_SCHEMA_SQL, MCARD_VECTOR_SCHEMA_SQL } from './schema_constants';
-const TABLE_LAYERS = {
-    // Layer 1: Core
-    'card': 'core',
-    // Layer 2: Handle System
-    'handle_registry': 'handle',
-    'handle_history': 'handle',
-    // Layer 3: Vector Storage
-    'mcard_vector_metadata': 'vector',
-    'mcard_embeddings': 'vector',
-    'mcard_fts': 'vector',
-    // Layer 4: Semantic Versioning
-    'handle_version_vectors': 'semantic',
-    'version_similarity_cache': 'semantic',
-    // Layer 5: Knowledge Graph
-    'graph_entities': 'graph',
-    'graph_relationships': 'graph',
-    'graph_communities': 'graph',
-    'graph_extractions': 'graph',
-    // Metadata
-    'schema_version': 'metadata',
-};
-// ─────────────────────────────────────────────────────────────────────────────
-// Singleton Schema Manager
-// ─────────────────────────────────────────────────────────────────────────────
-/**
- * Singleton class for MCard database schema management.
- *
- * Ensures all schema definitions come from the single source of truth:
- * schema/mcard_schema.sql
- */
-export class MCardSchema {
-    static instance = null;
-    schemaPath = '';
-    rawSql = '';
-    statements = [];
-    tables = new Map();
-    indexes = new Map();
-    loaded = false;
-    constructor() { }
-    /**
-     * Get the singleton instance.
-     */
-    static getInstance() {
-        if (!MCardSchema.instance) {
-            MCardSchema.instance = new MCardSchema();
-            MCardSchema.instance.load();
-        }
-        return MCardSchema.instance;
-    }
-    /**
-     * Reset the singleton (for testing).
-     */
-    static resetInstance() {
-        MCardSchema.instance = null;
-    }
-    load() {
-        if (this.loaded)
-            return;
-        this.schemaPath = 'IN_MEMORY_CONSTANTS'; // path no longer relevant
-        this.rawSql = MCARD_SCHEMA_SQL;
-        // Load vector schema if available
-        if (MCARD_VECTOR_SCHEMA_SQL) {
-            this.rawSql += "\n\n" + MCARD_VECTOR_SCHEMA_SQL;
-        }
-        this.statements = this.parseStatements(this.rawSql);
-        for (const stmt of this.statements) {
-            const name = this.extractName(stmt);
-            if (name) {
-                const upper = stmt.toUpperCase();
-                if (upper.includes('CREATE TABLE') || upper.includes('CREATE VIRTUAL TABLE')) {
-                    this.tables.set(name.toLowerCase(), stmt);
-                }
-                else if (upper.includes('CREATE INDEX')) {
-                    this.indexes.set(name.toLowerCase(), stmt);
-                }
-            }
-        }
-        this.loaded = true;
-    }
-    parseStatements(sql) {
-        // Remove block comments
-        sql = sql.replace(/\/\*[\s\S]*?\*\//g, '');
-        const statements = [];
-        let current = [];
-        for (const line of sql.split('\n')) {
-            // Skip line comments
-            const stripped = line.split('--')[0].trim();
-            if (!stripped)
-                continue;
-            current.push(stripped);
-            if (stripped.endsWith(';')) {
-                const statement = current.join(' ');
-                // Skip INSERT statements
-                if (!statement.trim().toUpperCase().startsWith('INSERT')) {
-                    statements.push(statement);
-                }
-                current = [];
-            }
-        }
-        return statements.filter(s => s.trim());
-    }
-    extractName(statement) {
-        // Handle CREATE TABLE
-        let match = statement.match(/CREATE\s+(?:VIRTUAL\s+)?TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?(\w+)/i);
-        if (match)
-            return match[1];
-        // Handle CREATE INDEX
-        match = statement.match(/CREATE\s+INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?(\w+)/i);
-        if (match)
-            return match[1];
-        return null;
-    }
-    // ─────────────────────────────────────────────────────────────────────────
-    // Schema Access
-    // ─────────────────────────────────────────────────────────────────────────
-    getSchemaPath() {
-        return this.schemaPath;
-    }
-    getTable(tableName) {
-        return this.tables.get(tableName.toLowerCase());
-    }
-    getIndex(indexName) {
-        return this.indexes.get(indexName.toLowerCase());
-    }
-    getAllTables() {
-        return new Map(this.tables);
-    }
-    getAllIndexes() {
-        return new Map(this.indexes);
-    }
-    getAllStatements() {
-        return [...this.statements];
-    }
-    getTablesByLayer(layer) {
-        return Object.entries(TABLE_LAYERS)
-            .filter(([_, l]) => l === layer)
-            .map(([name, _]) => name);
-    }
-    getLayerStatements(layer) {
-        const statements = [];
-        const tables = this.getTablesByLayer(layer);
-        // Add tables
-        for (const table of tables) {
-            const stmt = this.getTable(table);
-            if (stmt)
-                statements.push(stmt);
-        }
-        // Add indexes for these tables
-        for (const [_, stmt] of this.indexes) {
-            const match = stmt.match(/ON\s+(\w+)/i);
-            if (match && tables.includes(match[1].toLowerCase())) {
-                statements.push(stmt);
-            }
-        }
-        return statements;
-    }
-    // ─────────────────────────────────────────────────────────────────────────
-    // Database Initialization
-    // ─────────────────────────────────────────────────────────────────────────
-    execStatements(db, statements) {
-        for (const stmt of statements) {
-            db.exec(stmt);
-        }
-        return statements.length;
-    }
-    initLayer(db, layer) {
-        return this.execStatements(db, this.getLayerStatements(layer));
-    }
-    initCoreTables(db) {
-        return this.initLayer(db, 'core');
-    }
-    initHandleTables(db) {
-        return this.initLayer(db, 'handle');
-    }
-    initVectorTables(db, enableFts = true) {
-        const statements = this.getLayerStatements('vector')
-            .filter(s => enableFts || !s.toLowerCase().includes('fts'));
-        return this.execStatements(db, statements);
-    }
-    initSemanticTables(db) {
-        return this.initLayer(db, 'semantic');
-    }
-    initGraphTables(db) {
-        return this.initLayer(db, 'graph');
-    }
-    initAllTables(db, options = {}) {
-        const { enableFts = true, enableGraph = true, enableSemantic = true } = options;
-        let count = 0;
-        count += this.initCoreTables(db);
-        count += this.initHandleTables(db);
-        count += this.initVectorTables(db, enableFts);
-        if (enableSemantic) {
-            count += this.initSemanticTables(db);
-        }
-        if (enableGraph) {
-            count += this.initGraphTables(db);
-        }
-        return count;
-    }
-    initVec0Table(db, dimensions) {
-        db.exec(`
-            CREATE VIRTUAL TABLE IF NOT EXISTS mcard_vec USING vec0(
-                metadata_id INTEGER PRIMARY KEY,
-                embedding float[${dimensions}]
-            )
-        `);
-    }
-}
-// ─────────────────────────────────────────────────────────────────────────────
-// Convenience Exports (Backward Compatibility)
-// ─────────────────────────────────────────────────────────────────────────────
-// These are lazy-loaded from the singleton
-let _cachedSchemas = {};
-function getSchemaInstance() {
-    return MCardSchema.getInstance();
-}
-// Core schemas
-export const CARD_TABLE_SCHEMA = getSchemaInstance().getTable('card') || '';
-export const HANDLE_REGISTRY_SCHEMA = getSchemaInstance().getTable('handle_registry') || '';
-export const HANDLE_HISTORY_SCHEMA = getSchemaInstance().getTable('handle_history') || '';
-export const HANDLE_INDEX_SCHEMA = getSchemaInstance().getIndex('idx_handle_current_hash') || '';
-// Vector schemas
-export const VECTOR_METADATA_SCHEMA = getSchemaInstance().getTable('mcard_vector_metadata') || '';
-export const VECTOR_METADATA_INDEX = getSchemaInstance().getIndex('idx_vector_metadata_hash') || '';
-export const VECTOR_EMBEDDINGS_SCHEMA = getSchemaInstance().getTable('mcard_embeddings') || '';
-export const VECTOR_FTS_SCHEMA = getSchemaInstance().getTable('mcard_fts') || '';
-// Semantic versioning schemas
-export const HANDLE_VERSION_VECTORS_SCHEMA = getSchemaInstance().getTable('handle_version_vectors') || '';
-export const HANDLE_VERSION_VECTORS_INDEXES = [
-    getSchemaInstance().getIndex('idx_hvv_handle'),
-    getSchemaInstance().getIndex('idx_hvv_hash'),
-    getSchemaInstance().getIndex('idx_hvv_current'),
-    getSchemaInstance().getIndex('idx_hvv_parent'),
-].filter(Boolean).join('; ');
-export const VERSION_SIMILARITY_CACHE_SCHEMA = getSchemaInstance().getTable('version_similarity_cache') || '';
-export const VERSION_SIMILARITY_CACHE_INDEX = getSchemaInstance().getIndex('idx_vsc_handle') || '';
-// Graph schemas
-export const GRAPH_ENTITY_SCHEMA = getSchemaInstance().getTable('graph_entities') || '';
-export const GRAPH_ENTITY_INDEX_NAME = getSchemaInstance().getIndex('idx_entity_name') || '';
-export const GRAPH_ENTITY_INDEX_TYPE = getSchemaInstance().getIndex('idx_entity_type') || '';
-export const GRAPH_ENTITY_INDEX_SOURCE = getSchemaInstance().getIndex('idx_entity_source') || '';
-export const GRAPH_RELATIONSHIP_SCHEMA = getSchemaInstance().getTable('graph_relationships') || '';
-export const GRAPH_RELATIONSHIP_INDEX_SOURCE = getSchemaInstance().getIndex('idx_rel_source') || '';
-export const GRAPH_RELATIONSHIP_INDEX_TARGET = getSchemaInstance().getIndex('idx_rel_target') || '';
-export const GRAPH_COMMUNITY_SCHEMA = getSchemaInstance().getTable('graph_communities') || '';
-export const GRAPH_COMMUNITY_INDEX_LEVEL = getSchemaInstance().getIndex('idx_community_level') || '';
-export const GRAPH_EXTRACTION_SCHEMA = getSchemaInstance().getTable('graph_extractions') || '';
-// Schema collections
-export const CORE_SCHEMAS = {
-    card: CARD_TABLE_SCHEMA,
-    handleRegistry: HANDLE_REGISTRY_SCHEMA,
-    handleHistory: HANDLE_HISTORY_SCHEMA,
-    handleIndex: HANDLE_INDEX_SCHEMA,
-};
-export const VECTOR_SCHEMAS = {
-    metadata: VECTOR_METADATA_SCHEMA,
-    metadataIndex: VECTOR_METADATA_INDEX,
-    embeddings: VECTOR_EMBEDDINGS_SCHEMA,
-    fts: VECTOR_FTS_SCHEMA,
-};
-export const SEMANTIC_SCHEMAS = {
-    handleVersionVectors: HANDLE_VERSION_VECTORS_SCHEMA,
-    handleVersionVectorsIndexes: HANDLE_VERSION_VECTORS_INDEXES,
-    similarityCache: VERSION_SIMILARITY_CACHE_SCHEMA,
-    similarityCacheIndex: VERSION_SIMILARITY_CACHE_INDEX,
-};
-export const GRAPH_SCHEMAS = {
-    entities: GRAPH_ENTITY_SCHEMA,
-    entityIndexName: GRAPH_ENTITY_INDEX_NAME,
-    entityIndexType: GRAPH_ENTITY_INDEX_TYPE,
-    entityIndexSource: GRAPH_ENTITY_INDEX_SOURCE,
-    relationships: GRAPH_RELATIONSHIP_SCHEMA,
-    relIndexSource: GRAPH_RELATIONSHIP_INDEX_SOURCE,
-    relIndexTarget: GRAPH_RELATIONSHIP_INDEX_TARGET,
-    communities: GRAPH_COMMUNITY_SCHEMA,
-    communityIndexLevel: GRAPH_COMMUNITY_INDEX_LEVEL,
-    extractions: GRAPH_EXTRACTION_SCHEMA,
-};
-// ─────────────────────────────────────────────────────────────────────────────
-// Initialization Functions (use singleton internally)
-// ─────────────────────────────────────────────────────────────────────────────
-export function initCoreSchemas(db) {
-    const schema = MCardSchema.getInstance();
-    // Initialize both core (card) and handle tables (handle_registry, handle_history)
-    // because they are fundamental to MCard operation
-    schema.initCoreTables(db);
-    schema.initHandleTables(db);
-}
-export function initVectorSchemas(db, enableFts = true) {
-    MCardSchema.getInstance().initVectorTables(db, enableFts);
-}
-export function initSemanticSchemas(db) {
-    MCardSchema.getInstance().initSemanticTables(db);
-}
-export function initGraphSchemas(db) {
-    MCardSchema.getInstance().initGraphTables(db);
-}
-export function initAllSchemas(db, options = {}) {
-    MCardSchema.getInstance().initAllTables(db, options);
-}
-// Dynamic schema generator (dimensions can't come from SQL file)
-export function getVec0Schema(dimensions) {
-    return `
-CREATE VIRTUAL TABLE IF NOT EXISTS mcard_vec USING vec0(
-    metadata_id INTEGER PRIMARY KEY,
-    embedding float[${dimensions}]
-)
-`;
-}
-//# sourceMappingURL=schema.js.map

package/dist/storage/schema.js.map

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

package/dist/storage/schema_constants.d.ts

@@ -1,7 +0,0 @@
-/**
- * AUTO-GENERATED FILE - DO NOT EDIT
- * Generated by scripts/sync-schemas.js
- */
-export declare const MCARD_SCHEMA_SQL = "-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- MCard Unified Database Schema (Monadic Core)\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- \n-- STABILITY WARNING: This schema is the invariant \"seeding meta-language\" for all\n-- Domain Specific Languages (DSLs). It must remain as stable as possible.\n--\n-- THE UNIFICATION THESIS:\n-- This design unites three distinct namespaces into a single relational network\n-- by leveraging the power of cryptographic hash functions:\n-- 1. CONTENT SPACE (Intrinsic Identity): Content-Addressable Storage (CAS).\n-- 2. HANDLE SPACE (Reserved Words): Mapping human logic to content hashes.\n-- 3. VERSION SPACE (Temporal Evolution): Tracking state transitions via hash history.\n--\n-- TURING MACHINE ANALOGY (The Infinitely Long Tape):\n-- The `card` table stores content blobs with unique identities, emulating the \n-- \"Infinitely Long Tape\" of the Turing Machine formalism. By using relational \n-- queries, this tape can be dynamically constructed and traversed for different \n-- DSLs, providing a flexible substrate for practically all computable languages.\n--\n-- By using hash values as the universal primitives across content, handles, and \n-- time, we create a \"Wordless Book\" \u2014 a minimal substrate capable of seeding any \n-- domain-specific knowledge system without requiring schema changes.\n--\n-- Monadic Mapping (See: Monadic Justification for Schema Design.md):\n-- 1. Card    = Monad (Perception/State/Exponent) - Intrinsic Identity\n-- 2. Handle  = Registry (Appetition/Reader/Sum) - Mutable Reference\n-- 3. Version = History (Harmony/Writer/Product) - Coordinated Evolution\n--\n-- Version: 3.0.2 (Turing Tape Refinement)\n-- Last Updated: 2025-12-20\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- LAYER 1: CORE CONTENT-ADDRESSABLE STORAGE (The Monad / Exponent)\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- The fundamental MCard storage: content-addressed by cryptographic hash.\n-- \"Each Monad ... mirrors the universe\"\n\n-- @table card\n-- @description Core content-addressable storage table (Monad/State)\n-- @column hash    - SHA-256 hash of content (primary key)\n-- @column content - The actual content (BLOB for binary safety)\n-- @column g_time  - Generation timestamp (ISO 8601)\nCREATE TABLE IF NOT EXISTS card (\n    hash TEXT PRIMARY KEY,\n    content BLOB NOT NULL,\n    g_time TEXT NOT NULL\n);\n\n\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- LAYER 2: HANDLE SYSTEM (Appetition / Sum)\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- The mutable pointer that \"desires\" to reference new content.\n-- \"Appetition: the tendency to move to new states\"\n\n-- @table handle_registry (Monadic Role: Handle)\n-- @description Maps human-readable handles to current content hashes\n-- @column handle       - UTF-8 handle name (primary key)\n-- @column current_hash - FK to card.hash of current version\n-- @column created_at   - When handle was first created\n-- @column updated_at   - When handle was last updated\nCREATE TABLE IF NOT EXISTS handle_registry (\n    handle TEXT PRIMARY KEY,\n    current_hash TEXT NOT NULL,\n    created_at TEXT NOT NULL,\n    updated_at TEXT NOT NULL,\n    FOREIGN KEY (current_hash) REFERENCES card(hash)\n);\n\n-- @index idx_handle_current_hash\n-- @description Efficient reverse lookup from hash to handles\nCREATE INDEX IF NOT EXISTS idx_handle_current_hash \nON handle_registry(current_hash);\n\n-- @table handle_history (Monadic Role: Version / Product)\n-- @description Audit trail for handle pointer changes (Pre-Established Harmony)\n-- @column id            - Auto-increment primary key\n-- @column handle        - The handle that was updated\n-- @column previous_hash - Hash it pointed to before update\n-- @column changed_at    - When the change occurred\nCREATE TABLE IF NOT EXISTS handle_history (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    handle TEXT NOT NULL,\n    previous_hash TEXT NOT NULL,\n    changed_at TEXT NOT NULL,\n    FOREIGN KEY (handle) REFERENCES handle_registry(handle),\n    FOREIGN KEY (previous_hash) REFERENCES card(hash)\n);\n\n-- @index idx_handle_history_handle\n-- @description Efficient lookup of history by handle\nCREATE INDEX IF NOT EXISTS idx_handle_history_handle \nON handle_history(handle);\n\n\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- LEGACY SUPPORT: FTS5 Documents Table\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- KEPT FOR BACKWARD COMPATIBILITY with existing codebase.\n-- New implementations should use mcard_vector_schema.sql -> mcard_fts\n\n-- @virtual_table documents\n-- @description Legacy FTS table for backward compatibility\n-- @note Synced with card table via triggers\nCREATE VIRTUAL TABLE IF NOT EXISTS documents USING fts5(content);\n\n\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- SCHEMA METADATA\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n-- @table schema_version\n-- @description Tracks schema version for migrations\nCREATE TABLE IF NOT EXISTS schema_version (\n    version TEXT PRIMARY KEY,\n    applied_at TEXT NOT NULL,\n    description TEXT\n);\n\n-- Insert current schema version\nINSERT OR IGNORE INTO schema_version (version, applied_at, description)\nVALUES ('3.0.0', datetime('now'), 'Monadic Core Schema (split vectors to mcard_vector_schema.sql)');\n";
-export declare const MCARD_VECTOR_SCHEMA_SQL = "-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- MCard Vector Database Schema (mcard_vectors.db)\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- \n-- This schema defines the structure for \"Secondary Qualities\" (Extrinsic Embeddings).\n-- It is separated from the core mcard.db (Monadic Intrinsic Properties) to ensure:\n-- 1. Separation of Concerns (Intrinsic vs Extrinsic)\n-- 2. Linearity (Vectors are observer-dependent and large)\n-- 3. Upgradability (Embedding models change frequently)\n--\n-- See: Monadic Justification for Schema Design.md\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- LAYER 3: VECTOR STORAGE (Semantic Embeddings)\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- Storage for vector embeddings enabling semantic search.\n-- Links to content via hash for content-addressing.\n\n-- @table mcard_vector_metadata\n-- @description Metadata for stored embeddings\n-- @column id          - Auto-increment primary key\n-- @column hash        - FK to card.hash\n-- @column model_name  - Embedding model used (e.g., \"nomic-embed-text\")\n-- @column dimensions  - Vector dimensions\n-- @column chunk_index - Index for chunked documents (0 = first/whole)\n-- @column chunk_total - Total chunks for this document\n-- @column chunk_text  - Preview text for this chunk\n-- @column created_at  - When embedding was created\nCREATE TABLE IF NOT EXISTS mcard_vector_metadata (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    hash TEXT NOT NULL,\n    model_name TEXT NOT NULL,\n    dimensions INTEGER NOT NULL,\n    chunk_index INTEGER DEFAULT 0,\n    chunk_total INTEGER DEFAULT 1,\n    chunk_text TEXT,\n    created_at TEXT NOT NULL,\n    UNIQUE(hash, chunk_index)\n);\n\n-- @index idx_vector_metadata_hash\n-- @description Efficient lookup of embeddings by content hash\nCREATE INDEX IF NOT EXISTS idx_vector_metadata_hash \nON mcard_vector_metadata(hash);\n\n-- @table mcard_embeddings\n-- @description Fallback embedding storage when sqlite-vec is unavailable\n-- @column id          - Auto-increment primary key\n-- @column metadata_id - FK to mcard_vector_metadata.id\n-- @column embedding   - Serialized float32 vector as BLOB\nCREATE TABLE IF NOT EXISTS mcard_embeddings (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    metadata_id INTEGER NOT NULL,\n    embedding BLOB NOT NULL,\n    UNIQUE(metadata_id),\n    FOREIGN KEY (metadata_id) REFERENCES mcard_vector_metadata(id)\n);\n\n-- @virtual_table mcard_fts\n-- @description Full-text search for hybrid retrieval\n-- @note Uses Porter stemming with Unicode support\nCREATE VIRTUAL TABLE IF NOT EXISTS mcard_fts USING fts5(\n    hash,\n    content,\n    tokenize='porter unicode61'\n);\n\n-- Note: sqlite-vec virtual table is created dynamically with dimensions:\n-- CREATE VIRTUAL TABLE IF NOT EXISTS mcard_vec USING vec0(\n--     metadata_id INTEGER PRIMARY KEY,\n--     embedding float[${dimensions}]\n-- );\n\n\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- LAYER 4: SEMANTIC VERSIONING (Handle-Vector Bridge)\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- Bridges handles to vector embeddings for semantic version comparison.\n-- Enables measuring semantic drift between document versions.\n\n-- @table handle_version_vectors\n-- @description Links handle versions to their semantic embeddings\n-- @column id                        - Auto-increment primary key\n-- @column handle                    - FK to handle_registry.handle\n-- @column hash                      - FK to card.hash (this version)\n-- @column parent_hash               - FK to card.hash (previous version)\n-- @column version_order             - 0 = current, 1 = previous, etc.\n-- @column is_current                - TRUE if this is the current version\n-- @column embedding_id              - FK to mcard_vector_metadata.id\n-- @column semantic_delta_from_parent - Cosine similarity to parent [-1, 1]\n-- @column upgrade_type              - Classification: 'trivial' | 'minor' | 'major' | 'breaking'\n-- @column created_at                - When this version was linked\nCREATE TABLE IF NOT EXISTS handle_version_vectors (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    handle TEXT NOT NULL,\n    hash TEXT NOT NULL,\n    parent_hash TEXT,\n    version_order INTEGER NOT NULL,\n    is_current BOOLEAN DEFAULT FALSE,\n    embedding_id INTEGER,\n    semantic_delta_from_parent REAL,\n    upgrade_type TEXT,\n    created_at TEXT NOT NULL,\n    UNIQUE(handle, hash),\n    FOREIGN KEY (embedding_id) REFERENCES mcard_vector_metadata(id)\n);\n\n-- @index idx_hvv_handle\n-- @description Efficient lookup of versions by handle\nCREATE INDEX IF NOT EXISTS idx_hvv_handle \nON handle_version_vectors(handle);\n\n-- @index idx_hvv_hash\n-- @description Efficient lookup of versions by hash\nCREATE INDEX IF NOT EXISTS idx_hvv_hash \nON handle_version_vectors(hash);\n\n-- @index idx_hvv_current\n-- @description Efficient lookup of current versions\nCREATE INDEX IF NOT EXISTS idx_hvv_current \nON handle_version_vectors(is_current);\n\n-- @index idx_hvv_parent\n-- @description Efficient lookup by parent hash\nCREATE INDEX IF NOT EXISTS idx_hvv_parent \nON handle_version_vectors(parent_hash);\n\n-- @table version_similarity_cache\n-- @description Precomputed pairwise similarities for performance\n-- @column id               - Auto-increment primary key\n-- @column handle           - Handle these versions belong to\n-- @column hash_a           - First version hash\n-- @column hash_b           - Second version hash\n-- @column similarity_score - Cosine similarity [-1, 1]\n-- @column distance_euclidean - L2 distance [0, \u221E)\n-- @column computed_at      - When similarity was computed\nCREATE TABLE IF NOT EXISTS version_similarity_cache (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    handle TEXT NOT NULL,\n    hash_a TEXT NOT NULL,\n    hash_b TEXT NOT NULL,\n    similarity_score REAL NOT NULL,\n    distance_euclidean REAL,\n    computed_at TEXT NOT NULL,\n    UNIQUE(handle, hash_a, hash_b)\n);\n\n-- @index idx_vsc_handle\n-- @description Efficient lookup of cached similarities by handle\nCREATE INDEX IF NOT EXISTS idx_vsc_handle \nON version_similarity_cache(handle);\n\n\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- LAYER 5: KNOWLEDGE GRAPH (GraphRAG)\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- Storage for extracted knowledge graph entities and relationships.\n\n-- @table graph_entities\n-- @description Nodes in the knowledge graph\n-- @column id          - Auto-increment primary key\n-- @column name        - Entity name\n-- @column type        - Entity type (e.g., \"Person\", \"Organization\")\n-- @column description - Optional description\n-- @column source_hash - FK to card.hash where entity was extracted\n-- @column embedding   - Optional entity embedding\n-- @column created_at  - When entity was created\nCREATE TABLE IF NOT EXISTS graph_entities (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    name TEXT NOT NULL,\n    type TEXT NOT NULL,\n    description TEXT,\n    source_hash TEXT NOT NULL,\n    embedding BLOB,\n    created_at TEXT NOT NULL,\n    UNIQUE(name, type, source_hash)\n);\n\n-- @index idx_entity_name\n-- @description Efficient entity lookup by name\nCREATE INDEX IF NOT EXISTS idx_entity_name \nON graph_entities(name);\n\n-- @index idx_entity_type\n-- @description Efficient entity lookup by type\nCREATE INDEX IF NOT EXISTS idx_entity_type \nON graph_entities(type);\n\n-- @index idx_entity_source\n-- @description Efficient entity lookup by source document\nCREATE INDEX IF NOT EXISTS idx_entity_source \nON graph_entities(source_hash);\n\n-- @table graph_relationships\n-- @description Edges in the knowledge graph\n-- @column id               - Auto-increment primary key\n-- @column source_entity_id - FK to graph_entities.id (from)\n-- @column target_entity_id - FK to graph_entities.id (to)\n-- @column relationship     - Relationship type/label\n-- @column description      - Optional description\n-- @column weight           - Relationship strength\n-- @column source_hash      - FK to card.hash where relationship was extracted\n-- @column created_at       - When relationship was created\nCREATE TABLE IF NOT EXISTS graph_relationships (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    source_entity_id INTEGER NOT NULL,\n    target_entity_id INTEGER NOT NULL,\n    relationship TEXT NOT NULL,\n    description TEXT,\n    weight REAL DEFAULT 1.0,\n    source_hash TEXT NOT NULL,\n    created_at TEXT NOT NULL,\n    UNIQUE(source_entity_id, target_entity_id, relationship, source_hash),\n    FOREIGN KEY (source_entity_id) REFERENCES graph_entities(id),\n    FOREIGN KEY (target_entity_id) REFERENCES graph_entities(id)\n);\n\n-- @index idx_rel_source\n-- @description Efficient lookup of relationships by source entity\nCREATE INDEX IF NOT EXISTS idx_rel_source \nON graph_relationships(source_entity_id);\n\n-- @index idx_rel_target\n-- @description Efficient lookup of relationships by target entity\nCREATE INDEX IF NOT EXISTS idx_rel_target \nON graph_relationships(target_entity_id);\n\n-- @table graph_communities\n-- @description Hierarchical community summaries (GraphRAG)\n-- @column id                  - Auto-increment primary key\n-- @column level               - Hierarchy level (0 = leaf)\n-- @column title               - Community title\n-- @column summary             - AI-generated summary\n-- @column embedding           - Community embedding\n-- @column member_entity_ids   - JSON array of entity IDs\n-- @column parent_community_id - FK to parent community\n-- @column created_at          - When community was created\nCREATE TABLE IF NOT EXISTS graph_communities (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    level INTEGER NOT NULL DEFAULT 0,\n    title TEXT,\n    summary TEXT NOT NULL,\n    embedding BLOB,\n    member_entity_ids TEXT,\n    parent_community_id INTEGER,\n    created_at TEXT NOT NULL,\n    FOREIGN KEY (parent_community_id) REFERENCES graph_communities(id)\n);\n\n-- @index idx_community_level\n-- @description Efficient lookup of communities by level\nCREATE INDEX IF NOT EXISTS idx_community_level \nON graph_communities(level);\n\n-- @table graph_extractions\n-- @description Tracks which documents have been processed for entity extraction\n-- @column hash               - FK to card.hash (primary key)\n-- @column entity_count       - Number of entities extracted\n-- @column relationship_count - Number of relationships extracted\n-- @column extracted_at       - When extraction was performed\nCREATE TABLE IF NOT EXISTS graph_extractions (\n    hash TEXT PRIMARY KEY,\n    entity_count INTEGER DEFAULT 0,\n    relationship_count INTEGER DEFAULT 0,\n    extracted_at TEXT NOT NULL\n);\n\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- SCHEMA METADATA (Vector DB)\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n-- @table schema_version\n-- @description Tracks schema version for migrations\nCREATE TABLE IF NOT EXISTS vector_schema_version (\n    version TEXT PRIMARY KEY,\n    applied_at TEXT NOT NULL,\n    description TEXT\n);\n\n-- Insert current schema version\nINSERT OR IGNORE INTO vector_schema_version (version, applied_at, description)\nVALUES ('1.0.0', datetime('now'), 'Initial MCard Vector Schema');\n";
-//# sourceMappingURL=schema_constants.d.ts.map

package/dist/storage/schema_constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema_constants.d.ts","sourceRoot":"","sources":["../../src/storage/schema_constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,gBAAgB,y4TA6H5B,CAAC;AAEF,eAAO,MAAM,uBAAuB,8ofA2RnC,CAAC"}