@noyrax/5d-database-plugin 0.1.0

package/out/validators/integrity-validator.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrityValidator = void 0;
+const module_repository_1 = require("../repositories/module-repository");
+const symbol_repository_1 = require("../repositories/symbol-repository");
+const dependency_repository_1 = require("../repositories/dependency-repository");
+const adr_repository_1 = require("../repositories/adr-repository");
+const change_repository_1 = require("../repositories/change-repository");
+/**
+ * Validates data integrity within each dimension.
+ * Checks for orphaned records, missing foreign keys, etc.
+ */
+class IntegrityValidator {
+    constructor(dbManager) {
+        this.dbManager = dbManager;
+    }
+    /**
+     * Validates integrity across all dimensions.
+     *
+     * @param pluginId The plugin ID
+     * @returns Validation result
+     */
+    async validate(pluginId) {
+        const errors = [];
+        const warnings = [];
+        await this.validateModuleIntegrity(pluginId, errors, warnings);
+        await this.validateSymbolIntegrity(pluginId, errors, warnings);
+        await this.validateDependencyIntegrity(pluginId, errors, warnings);
+        await this.validateAdrIntegrity(pluginId, errors, warnings);
+        await this.validateChangeIntegrity(pluginId, errors, warnings);
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    /**
+     * Validates module integrity.
+     */
+    async validateModuleIntegrity(pluginId, errors, warnings) {
+        const moduleDb = await this.dbManager.getDatabase('X');
+        const moduleRepo = new module_repository_1.ModuleRepository(moduleDb);
+        const modules = await moduleRepo.getAll(pluginId);
+        for (const module of modules) {
+            if (!module.content_hash) {
+                errors.push(`Module ${module.file_path} has no content_hash`);
+            }
+            if (!module.content_markdown) {
+                errors.push(`Module ${module.file_path} has no content_markdown`);
+            }
+        }
+    }
+    /**
+     * Validates symbol integrity.
+     */
+    async validateSymbolIntegrity(pluginId, errors, warnings) {
+        const symbolDb = await this.dbManager.getDatabase('Y');
+        const symbolRepo = new symbol_repository_1.SymbolRepository(symbolDb);
+        const symbols = await symbolRepo.getAll(pluginId);
+        for (const symbol of symbols) {
+            if (!symbol.signature_hash) {
+                errors.push(`Symbol ${symbol.symbol_id} has no signature_hash`);
+            }
+            if (!symbol.signature_json) {
+                errors.push(`Symbol ${symbol.symbol_id} has no signature_json`);
+            }
+        }
+    }
+    /**
+     * Validates dependency integrity.
+     */
+    async validateDependencyIntegrity(pluginId, errors, warnings) {
+        const depDb = await this.dbManager.getDatabase('Z');
+        const depRepo = new dependency_repository_1.DependencyRepository(depDb);
+        const dependencies = await depRepo.getAll(pluginId);
+        for (const dep of dependencies) {
+            if (!dep.content_hash) {
+                errors.push(`Dependency ${dep.from_module} -> ${dep.to_module} has no content_hash`);
+            }
+        }
+    }
+    /**
+     * Validates ADR integrity.
+     */
+    async validateAdrIntegrity(pluginId, errors, warnings) {
+        const adrDb = await this.dbManager.getDatabase('W');
+        const adrRepo = new adr_repository_1.AdrRepository(adrDb);
+        const adrs = await adrRepo.getAll(pluginId);
+        for (const adr of adrs) {
+            if (!adr.content_hash) {
+                errors.push(`ADR ${adr.adr_number} has no content_hash`);
+            }
+            if (!adr.content_markdown) {
+                errors.push(`ADR ${adr.adr_number} has no content_markdown`);
+            }
+        }
+    }
+    /**
+     * Validates change report integrity.
+     */
+    async validateChangeIntegrity(pluginId, errors, warnings) {
+        const changeDb = await this.dbManager.getDatabase('T');
+        const changeRepo = new change_repository_1.ChangeRepository(changeDb);
+        const reports = await changeRepo.getAll(pluginId);
+        for (const report of reports) {
+            const symbolChanges = await changeRepo.getSymbolChanges(report.id);
+            const depChanges = await changeRepo.getDependencyChanges(report.id);
+            if (symbolChanges.length === 0 && depChanges.length === 0) {
+                warnings.push(`Change report ${report.id} has no changes`);
+            }
+        }
+    }
+}
+exports.IntegrityValidator = IntegrityValidator;
+//# sourceMappingURL=integrity-validator.js.map

package/out/validators/integrity-validator.js.map

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

package/package.json

@@ -0,0 +1,173 @@
+{
+  "name": "@noyrax/5d-database-plugin",
+  "displayName": "5D Database Plugin",
+  "description": "5-dimensional database layer for documentation system with semantic brain integration",
+  "version": "0.1.0",
+  "publisher": "noyrax",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/noyrax/5d-database-plugin.git"
+  },
+  "keywords": [
+    "documentation",
+    "database",
+    "semantic-search",
+    "mcp",
+    "llm",
+    "ai",
+    "code-analysis",
+    "architecture",
+    "5d-database",
+    "noyrax"
+  ],
+  "files": [
+    "out/",
+    "schemas/",
+    "README.md",
+    "LICENSE",
+    "package.json",
+    "MCP_SERVER_SETUP.md",
+    "SETUP_NEW_PROJECT.md",
+    "CHROMADB_SETUP.md",
+    "QUICK_START.md",
+    "ADR_VORSCHLAEGE.md",
+    "SYSTEM_ANALYSIS_REPORT.md",
+    "INSTALLATION_READINESS.md",
+    "MCP_SERVER_TEST_REPORT.md",
+    "KNOWN_ISSUES.md",
+    "IMPROVEMENT_ROADMAP.md",
+    "NOYRAX_INTEGRATION.md"
+  ],
+  "engines": {
+    "vscode": "^1.74.0"
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [
+    "onStartupFinished"
+  ],
+  "main": "./out/extension.js",
+  "bin": {
+    "noyrax-5d-database": "./out/cli/ingest-cli.js",
+    "noyrax-5d-database-mcp": "./out/cli/mcp-server-cli.js",
+    "noyrax-5d-database-query": "./out/cli/query-cli.js",
+    "noyrax-5d-database-tool": "./out/cli/tool-cli.js",
+    "noyrax-5d-database-search": "./out/cli/semantic-search-cli.js",
+    "noyrax-5d-database-embedding": "./out/cli/embedding-cli.js"
+  },
+  "contributes": {
+    "commands": [
+      {
+        "command": "5d-database.ingest",
+        "title": "Ingest Documentation"
+      },
+      {
+        "command": "5d-database.search",
+        "title": "Semantic Search"
+      },
+      {
+        "command": "5d-database.showModuleDetail",
+        "title": "Show Module Detail"
+      },
+      {
+        "command": "5d-database.showSymbolDetail",
+        "title": "Show Symbol Detail"
+      },
+      {
+        "command": "5d-database.showAdrDetail",
+        "title": "Show ADR Detail"
+      },
+      {
+        "command": "5d-database.showDependencyDetail",
+        "title": "Show Dependency Detail"
+      },
+      {
+        "command": "5d-database.showChangeDetail",
+        "title": "Show Change Report Detail"
+      },
+      {
+        "command": "5d-database.openSourceFile",
+        "title": "Open Source File"
+      }
+    ],
+    "menus": {
+      "view/item/context": [
+        {
+          "command": "5d-database.openSourceFile",
+          "when": "view == 5d-database-explorer && viewItem == module",
+          "group": "navigation"
+        },
+        {
+          "command": "5d-database.openSourceFile",
+          "when": "view == 5d-database-explorer && viewItem == symbol",
+          "group": "navigation"
+        },
+        {
+          "command": "5d-database.openSourceFile",
+          "when": "view == 5d-database-explorer && viewItem == dependency",
+          "group": "navigation"
+        }
+      ]
+    },
+    "views": {
+      "explorer": [
+        {
+          "id": "5d-database-explorer",
+          "name": "5D Database Explorer"
+        }
+      ]
+    }
+  },
+  "scripts": {
+    "compile": "tsc -p ./",
+    "postcompile": "npm run scan && npm run validate && npm run verify:adrs",
+    "scan": "cd .. && noyrax-scan",
+    "validate": "cd .. && noyrax-validate",
+    "verify:adrs": "cd .. && noyrax-verify-adrs",
+    "verify:architecture": "cd .. && noyrax-verify-architecture",
+    "verify:imports": "cd .. && noyrax-verify-imports",
+    "verify:all": "npm run compile && npm run verify:architecture && npm run verify:imports",
+    "watch": "tsc -watch -p ./",
+    "package": "vsce package --allow-missing-repository",
+    "prepublishOnly": "npm run compile",
+    "publish": "npm publish --access public",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "test:v-dimension": "node out/cli/test-v-dimension.js",
+    "test:chromadb": "node out/cli/test-chromadb.js",
+    "verify:openai-key": "node out/cli/verify-openai-key.js",
+    "verify:vss-status": "node out/cli/verify-vss-status.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "chromadb": "^3.2.0",
+    "dotenv": "^16.4.5",
+    "openai": "^6.15.0",
+    "sqlite-vss": "^0.1.2",
+    "sqlite3": "^5.1.6",
+    "uuid": "^9.0.1",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@types/dotenv": "^6.1.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "16.x",
+    "@types/uuid": "^10.0.0",
+    "@types/vscode": "^1.74.0",
+    "@vscode/vsce": "^2.22.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.1.6"
+  },
+  "peerDependencies": {
+    "@noyrax/documentation-system-plugin": "*"
+  },
+  "peerDependenciesMeta": {
+    "@noyrax/documentation-system-plugin": {
+      "optional": false,
+      "description": "Documentation System Plugin (Noyrax) must be installed and docs/ must be generated before using 5D Database Plugin"
+    }
+  }
+}

package/schemas/sqlite/001_initial_modules.sql

@@ -0,0 +1,39 @@
+-- X-Dimension: Modules Database Schema
+-- Stores module documentation from docs/modules/*.md
+
+CREATE TABLE IF NOT EXISTS modules (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    file_path TEXT NOT NULL,
+    content_hash TEXT NOT NULL,
+    content_markdown TEXT NOT NULL,
+    deleted_at DATETIME,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(plugin_id, file_path)
+);
+
+CREATE TABLE IF NOT EXISTS module_symbols (
+    id TEXT PRIMARY KEY,
+    module_id TEXT NOT NULL,
+    symbol_external_id TEXT NOT NULL,
+    symbol_name TEXT NOT NULL,
+    symbol_kind TEXT NOT NULL,
+    FOREIGN KEY (module_id) REFERENCES modules(id) ON DELETE CASCADE
+);
+
+-- ID Mapping for external IDs
+CREATE TABLE IF NOT EXISTS module_id_mapping (
+    internal_id TEXT PRIMARY KEY,
+    external_id TEXT NOT NULL UNIQUE,
+    plugin_id TEXT NOT NULL
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_modules_plugin_id ON modules(plugin_id);
+CREATE INDEX IF NOT EXISTS idx_modules_file_path ON modules(file_path);
+CREATE INDEX IF NOT EXISTS idx_modules_content_hash ON modules(content_hash);
+CREATE INDEX IF NOT EXISTS idx_module_symbols_module_id ON module_symbols(module_id);
+CREATE INDEX IF NOT EXISTS idx_module_id_mapping_external_id ON module_id_mapping(external_id);
+CREATE INDEX IF NOT EXISTS idx_module_id_mapping_plugin_id ON module_id_mapping(plugin_id);
+

package/schemas/sqlite/002_initial_symbols.sql

@@ -0,0 +1,46 @@
+-- Y-Dimension: Symbols Database Schema
+-- Stores symbols from docs/index/symbols.jsonl
+
+CREATE TABLE IF NOT EXISTS symbols (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    symbol_id TEXT NOT NULL,
+    path TEXT NOT NULL,
+    kind TEXT NOT NULL,
+    name TEXT NOT NULL,
+    signature_json TEXT NOT NULL,
+    signature_hash TEXT NOT NULL,
+    summary TEXT,
+    deleted_at DATETIME,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(plugin_id, symbol_id)
+);
+
+CREATE TABLE IF NOT EXISTS symbol_dependencies (
+    id TEXT PRIMARY KEY,
+    symbol_id TEXT NOT NULL,
+    dependency_module TEXT NOT NULL,
+    dependency_symbols_json TEXT,
+    is_type_only BOOLEAN DEFAULT FALSE,
+    is_reexport BOOLEAN DEFAULT FALSE,
+    FOREIGN KEY (symbol_id) REFERENCES symbols(id) ON DELETE CASCADE
+);
+
+-- ID Mapping for external IDs
+CREATE TABLE IF NOT EXISTS symbol_id_mapping (
+    internal_id TEXT PRIMARY KEY,
+    external_id TEXT NOT NULL UNIQUE,
+    plugin_id TEXT NOT NULL
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_symbols_plugin_id ON symbols(plugin_id);
+CREATE INDEX IF NOT EXISTS idx_symbols_symbol_id ON symbols(symbol_id);
+CREATE INDEX IF NOT EXISTS idx_symbols_path ON symbols(path);
+CREATE INDEX IF NOT EXISTS idx_symbols_signature_hash ON symbols(signature_hash);
+CREATE INDEX IF NOT EXISTS idx_symbol_dependencies_symbol_id ON symbol_dependencies(symbol_id);
+CREATE INDEX IF NOT EXISTS idx_symbol_dependencies_module ON symbol_dependencies(dependency_module);
+CREATE INDEX IF NOT EXISTS idx_symbol_id_mapping_external_id ON symbol_id_mapping(external_id);
+CREATE INDEX IF NOT EXISTS idx_symbol_id_mapping_plugin_id ON symbol_id_mapping(plugin_id);
+

package/schemas/sqlite/003_initial_dependencies.sql

@@ -0,0 +1,51 @@
+-- Z-Dimension: Dependencies Database Schema
+-- Stores module dependencies from docs/system/DEPENDENCY_GRAPH.md
+
+CREATE TABLE IF NOT EXISTS dependencies (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    from_module TEXT NOT NULL,
+    to_module TEXT NOT NULL,
+    dependency_type TEXT NOT NULL CHECK (dependency_type IN ('import', 'export', 'require')),
+    symbols_json TEXT,
+    content_hash TEXT NOT NULL,
+    is_type_only BOOLEAN DEFAULT FALSE,
+    is_reexport BOOLEAN DEFAULT FALSE,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(plugin_id, from_module, to_module, dependency_type)
+);
+
+CREATE TABLE IF NOT EXISTS dependency_graph_cache (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    mermaid_graph TEXT NOT NULL,
+    generated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(plugin_id)
+);
+
+-- Traceability: Links Z-Dimension dependencies to Y-Dimension symbol dependencies
+CREATE TABLE IF NOT EXISTS dependency_symbol_evidence (
+    id TEXT PRIMARY KEY,
+    dependency_id TEXT NOT NULL,
+    symbol_dependency_id TEXT NOT NULL,
+    FOREIGN KEY (dependency_id) REFERENCES dependencies(id) ON DELETE CASCADE
+);
+
+-- ID Mapping for external IDs
+CREATE TABLE IF NOT EXISTS dependency_id_mapping (
+    internal_id TEXT PRIMARY KEY,
+    external_id TEXT NOT NULL UNIQUE,
+    plugin_id TEXT NOT NULL
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_dependencies_plugin_id ON dependencies(plugin_id);
+CREATE INDEX IF NOT EXISTS idx_dependencies_from_module ON dependencies(from_module);
+CREATE INDEX IF NOT EXISTS idx_dependencies_to_module ON dependencies(to_module);
+CREATE INDEX IF NOT EXISTS idx_dependencies_content_hash ON dependencies(content_hash);
+CREATE INDEX IF NOT EXISTS idx_dependency_symbol_evidence_dependency_id ON dependency_symbol_evidence(dependency_id);
+CREATE INDEX IF NOT EXISTS idx_dependency_symbol_evidence_symbol_dep_id ON dependency_symbol_evidence(symbol_dependency_id);
+CREATE INDEX IF NOT EXISTS idx_dependency_id_mapping_external_id ON dependency_id_mapping(external_id);
+CREATE INDEX IF NOT EXISTS idx_dependency_id_mapping_plugin_id ON dependency_id_mapping(plugin_id);
+

package/schemas/sqlite/004_initial_adrs.sql

@@ -0,0 +1,41 @@
+-- W-Dimension: ADRs Database Schema
+-- Stores Architecture Decision Records from docs/adr/*.md
+
+CREATE TABLE IF NOT EXISTS adrs (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    adr_number TEXT NOT NULL,
+    title TEXT NOT NULL,
+    file_name TEXT NOT NULL,
+    content_markdown TEXT NOT NULL,
+    content_hash TEXT NOT NULL,
+    deleted_at DATETIME,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(plugin_id, adr_number)
+);
+
+CREATE TABLE IF NOT EXISTS adr_file_mappings (
+    id TEXT PRIMARY KEY,
+    adr_id TEXT NOT NULL,
+    file_path TEXT NOT NULL,
+    FOREIGN KEY (adr_id) REFERENCES adrs(id) ON DELETE CASCADE,
+    UNIQUE(adr_id, file_path)
+);
+
+-- ID Mapping for external IDs
+CREATE TABLE IF NOT EXISTS adr_id_mapping (
+    internal_id TEXT PRIMARY KEY,
+    external_id TEXT NOT NULL UNIQUE,
+    plugin_id TEXT NOT NULL
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_adrs_plugin_id ON adrs(plugin_id);
+CREATE INDEX IF NOT EXISTS idx_adrs_adr_number ON adrs(adr_number);
+CREATE INDEX IF NOT EXISTS idx_adrs_content_hash ON adrs(content_hash);
+CREATE INDEX IF NOT EXISTS idx_adr_file_mappings_adr_id ON adr_file_mappings(adr_id);
+CREATE INDEX IF NOT EXISTS idx_adr_file_mappings_file_path ON adr_file_mappings(file_path);
+CREATE INDEX IF NOT EXISTS idx_adr_id_mapping_external_id ON adr_id_mapping(external_id);
+CREATE INDEX IF NOT EXISTS idx_adr_id_mapping_plugin_id ON adr_id_mapping(plugin_id);
+

package/schemas/sqlite/005_initial_changes.sql

@@ -0,0 +1,54 @@
+-- T-Dimension: Changes Database Schema
+-- Stores change reports from docs/system/CHANGE_REPORT.md
+
+CREATE TABLE IF NOT EXISTS change_reports (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    run_type TEXT NOT NULL CHECK (run_type IN ('full', 'incremental')),
+    parsed_files INTEGER NOT NULL,
+    skipped_files INTEGER NOT NULL,
+    total_dependencies INTEGER NOT NULL,
+    validation_errors INTEGER NOT NULL,
+    validation_warnings INTEGER NOT NULL,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(plugin_id, created_at)
+);
+
+CREATE TABLE IF NOT EXISTS symbol_changes (
+    id TEXT PRIMARY KEY,
+    report_id TEXT NOT NULL,
+    change_type TEXT NOT NULL CHECK (change_type IN ('added', 'removed', 'changed')),
+    file_path TEXT NOT NULL,
+    symbol_name TEXT NOT NULL,
+    symbol_kind TEXT NOT NULL,
+    old_signature TEXT,
+    new_signature TEXT,
+    FOREIGN KEY (report_id) REFERENCES change_reports(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS dependency_changes (
+    id TEXT PRIMARY KEY,
+    report_id TEXT NOT NULL,
+    change_type TEXT NOT NULL CHECK (change_type IN ('added', 'removed')),
+    from_module TEXT NOT NULL,
+    to_module TEXT NOT NULL,
+    dependency_type TEXT NOT NULL,
+    FOREIGN KEY (report_id) REFERENCES change_reports(id) ON DELETE CASCADE
+);
+
+-- ID Mapping for external IDs
+CREATE TABLE IF NOT EXISTS change_id_mapping (
+    internal_id TEXT PRIMARY KEY,
+    external_id TEXT NOT NULL UNIQUE,
+    plugin_id TEXT NOT NULL
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_change_reports_plugin_id ON change_reports(plugin_id);
+CREATE INDEX IF NOT EXISTS idx_change_reports_created_at ON change_reports(created_at);
+CREATE INDEX IF NOT EXISTS idx_symbol_changes_report_id ON symbol_changes(report_id);
+CREATE INDEX IF NOT EXISTS idx_symbol_changes_file_path ON symbol_changes(file_path);
+CREATE INDEX IF NOT EXISTS idx_dependency_changes_report_id ON dependency_changes(report_id);
+CREATE INDEX IF NOT EXISTS idx_change_id_mapping_external_id ON change_id_mapping(external_id);
+CREATE INDEX IF NOT EXISTS idx_change_id_mapping_plugin_id ON change_id_mapping(plugin_id);
+

package/schemas/sqlite/006_initial_ingestion.sql

@@ -0,0 +1,34 @@
+-- Ingestion Management Schema
+-- This schema is used across all dimensions for tracking ingestion runs
+
+-- Note: This table should be created in a separate ingestion.db or in one of the dimension databases
+-- For simplicity, we'll create it in each dimension database, but only use it from one
+-- Alternatively, it could be in a separate ingestion.db file
+
+CREATE TABLE IF NOT EXISTS ingestion_runs (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    run_type TEXT NOT NULL CHECK (run_type IN ('full', 'incremental')),
+    started_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    completed_at DATETIME,
+    status TEXT NOT NULL CHECK (status IN ('running', 'completed', 'failed')),
+    dimensions_processed TEXT NOT NULL,
+    error_message TEXT
+);
+
+CREATE TABLE IF NOT EXISTS entity_renames (
+    id TEXT PRIMARY KEY,
+    dimension TEXT NOT NULL CHECK (dimension IN ('X', 'Y', 'Z', 'W')),
+    old_external_id TEXT NOT NULL,
+    new_external_id TEXT NOT NULL,
+    plugin_id TEXT NOT NULL,
+    detected_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_ingestion_runs_plugin_id ON ingestion_runs(plugin_id);
+CREATE INDEX IF NOT EXISTS idx_ingestion_runs_status ON ingestion_runs(status);
+CREATE INDEX IF NOT EXISTS idx_ingestion_runs_started_at ON ingestion_runs(started_at);
+CREATE INDEX IF NOT EXISTS idx_entity_renames_dimension ON entity_renames(dimension);
+CREATE INDEX IF NOT EXISTS idx_entity_renames_plugin_id ON entity_renames(plugin_id);
+

package/schemas/sqlite/006_vectors_schema.sql

@@ -0,0 +1,73 @@
+-- V-Dimension: Vectors Database Schema
+-- Stores embeddings, importance scores, and navigation metadata
+
+-- Embeddings pro Entity (aus 5D-DBs)
+CREATE TABLE IF NOT EXISTS embeddings (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    dimension TEXT NOT NULL CHECK (dimension IN ('X', 'Y', 'Z', 'W', 'T')),
+    entity_id TEXT NOT NULL,  -- Internal ID aus entsprechender Dimension
+    external_id TEXT NOT NULL,  -- External ID (file_path, symbol_id, etc.)
+    content_hash TEXT NOT NULL,  -- Hash des Original-Contents
+    embedding_model TEXT NOT NULL,  -- z.B. 'text-embedding-3-small'
+    embedding_vector BLOB NOT NULL,  -- VSS vector (1536 floats as binary)
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(plugin_id, dimension, entity_id, embedding_model)
+);
+
+-- Importance Scores pro Entity
+CREATE TABLE IF NOT EXISTS importance_scores (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    dimension TEXT NOT NULL CHECK (dimension IN ('X', 'Y', 'Z', 'W', 'T')),
+    entity_id TEXT NOT NULL,
+    pagerank_score REAL NOT NULL,
+    betweenness_score REAL NOT NULL,
+    combined_score REAL NOT NULL,  -- Gewichtete Kombination
+    rank INTEGER NOT NULL,  -- Ranking (1 = wichtigste)
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(plugin_id, dimension, entity_id)
+);
+
+-- Navigation Metadata
+CREATE TABLE IF NOT EXISTS navigation_metadata (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    dimension TEXT NOT NULL CHECK (dimension IN ('X', 'Y', 'Z', 'W', 'T')),
+    entity_id TEXT NOT NULL,
+    is_entry_point BOOLEAN DEFAULT FALSE,
+    cluster_id TEXT,  -- Gruppierung verwandter Entities
+    related_adrs TEXT,  -- JSON Array von ADR-Nummern
+    importance_rank INTEGER,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(plugin_id, dimension, entity_id)
+);
+
+-- Entry Points (manuelle Overrides)
+CREATE TABLE IF NOT EXISTS entry_points (
+    id TEXT PRIMARY KEY,
+    plugin_id TEXT NOT NULL,
+    dimension TEXT NOT NULL CHECK (dimension IN ('X', 'Y', 'Z', 'W', 'T')),
+    entity_id TEXT NOT NULL,
+    priority INTEGER NOT NULL DEFAULT 0,  -- Höher = wichtiger
+    reason TEXT,  -- Warum ist dies ein Entry Point?
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(plugin_id, dimension, entity_id)
+);
+
+-- VSS Index (wird von SQLite VSS verwaltet)
+-- Note: VSS virtual table creation is done programmatically after VSS extension is loaded
+-- CREATE VIRTUAL TABLE embeddings_vss USING vss0(embedding_vector(1536));
+
+-- Indexes for performance
+CREATE INDEX IF NOT EXISTS idx_embeddings_plugin_dimension ON embeddings(plugin_id, dimension);
+CREATE INDEX IF NOT EXISTS idx_embeddings_entity_id ON embeddings(entity_id);
+CREATE INDEX IF NOT EXISTS idx_embeddings_content_hash ON embeddings(content_hash);
+CREATE INDEX IF NOT EXISTS idx_importance_scores_plugin_dimension ON importance_scores(plugin_id, dimension);
+CREATE INDEX IF NOT EXISTS idx_importance_scores_rank ON importance_scores(rank);
+CREATE INDEX IF NOT EXISTS idx_navigation_metadata_plugin_dimension ON navigation_metadata(plugin_id, dimension);
+CREATE INDEX IF NOT EXISTS idx_navigation_metadata_entry_point ON navigation_metadata(is_entry_point);
+CREATE INDEX IF NOT EXISTS idx_entry_points_plugin_dimension ON entry_points(plugin_id, dimension);
+
+