mcard-js 2.1.41 → 2.1.43

package/dist/index.cjs

@@ -176,1013 +176,51 @@ var init_GTime = __esm({
   }
 });
 
-// src/model/detectors/BinaryDetector.ts
-var BinarySignatureDetector;
-var init_BinaryDetector = __esm({
-  "src/model/detectors/BinaryDetector.ts"() {
-    "use strict";
-    BinarySignatureDetector = class _BinarySignatureDetector {
-      contentTypeName = "binary";
-      // Signatures map: [Signature Bytes, Mime Type]
-      static SIGNATURES = [
-        [new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]), "image/png"],
-        [new Uint8Array([255, 216, 255]), "image/jpeg"],
-        [new Uint8Array([71, 73, 70, 56, 55, 97]), "image/gif"],
-        // GIF87a
-        [new Uint8Array([71, 73, 70, 56, 57, 97]), "image/gif"],
-        // GIF89a
-        [new Uint8Array([66, 77]), "image/bmp"],
-        // BM
-        [new Uint8Array([0, 0, 1, 0]), "image/x-icon"],
-        [new Uint8Array([0, 0, 2, 0]), "image/x-icon"],
-        [new Uint8Array([37, 80, 68, 70]), "application/pdf"],
-        // %PDF
-        [new Uint8Array([80, 75, 3, 4]), "application/zip"],
-        // PK..
-        [new Uint8Array([31, 139, 8]), "application/gzip"],
-        [new Uint8Array([82, 97, 114, 33, 26, 7, 0]), "application/x-rar-compressed"],
-        [new Uint8Array([55, 122, 188, 175, 39, 28]), "application/x-7z-compressed"],
-        [new Uint8Array([83, 81, 76, 105, 116, 101, 32, 102, 111, 114, 109, 97, 116, 32, 51, 0]), "application/x-sqlite3"]
-      ];
-      // Extension-to-MIME mapping for binary types (used when byte detection fails)
-      static EXT_TO_MIME = {
-        // Video
-        ".mp4": "video/mp4",
-        ".webm": "video/webm",
-        ".avi": "video/x-msvideo",
-        ".mov": "video/quicktime",
-        ".mkv": "video/x-matroska",
-        ".wmv": "video/x-ms-wmv",
-        ".flv": "video/x-flv",
-        ".m4v": "video/x-m4v",
-        // Audio
-        ".mp3": "audio/mpeg",
-        ".ogg": "audio/ogg",
-        ".flac": "audio/flac",
-        ".aac": "audio/aac",
-        ".m4a": "audio/mp4",
-        ".wma": "audio/x-ms-wma",
-        // Images (backup for when signature detection fails)
-        ".png": "image/png",
-        ".jpg": "image/jpeg",
-        ".jpeg": "image/jpeg",
-        ".gif": "image/gif",
-        ".bmp": "image/bmp",
-        ".ico": "image/x-icon",
-        ".webp": "image/webp",
-        ".svg": "image/svg+xml",
-        // Documents
-        ".pdf": "application/pdf",
-        // Archives
-        ".zip": "application/zip",
-        ".gz": "application/gzip",
-        ".rar": "application/x-rar-compressed",
-        ".7z": "application/x-7z-compressed",
-        ".tar": "application/x-tar",
-        // Database
-        ".db": "application/x-sqlite3",
-        ".sqlite": "application/x-sqlite3",
-        ".sqlite3": "application/x-sqlite3",
-        // Fonts
-        ".woff": "font/woff",
-        ".woff2": "font/woff2",
-        ".ttf": "font/ttf",
-        ".otf": "font/otf",
-        ".eot": "application/vnd.ms-fontobject"
-      };
-      detect(contentSample, lines, firstLine, fileExtension) {
-        const mime = this.getMimeType(contentSample, lines, firstLine, fileExtension);
-        return mime && mime !== "application/octet-stream" ? 0.95 : 0;
-      }
-      getMimeType(contentSample, lines, firstLine, fileExtension) {
-        const bytes = this.toBytes(contentSample);
-        const detected = this.detectFromBytes(bytes);
-        if (detected !== "application/octet-stream") {
-          return detected;
-        }
-        if (fileExtension) {
-          let ext = fileExtension.toLowerCase();
-          const lastDotIndex = ext.lastIndexOf(".");
-          if (lastDotIndex > -1) {
-            ext = ext.substring(lastDotIndex);
-          } else if (!ext.startsWith(".")) {
-            if (ext.includes("/") || ext.includes("\\")) {
-              return "application/octet-stream";
-            }
-            ext = "." + ext;
-          }
-          const extMime = _BinarySignatureDetector.EXT_TO_MIME[ext];
-          if (extMime) {
-            return extMime;
-          }
-        }
-        return "application/octet-stream";
-      }
-      /**
-       * Detect MIME type directly from bytes.
-       */
-      detectFromBytes(bytes) {
-        if (this.startsWith(bytes, new Uint8Array([82, 73, 70, 70]))) {
-          return this.detectRiffFormat(bytes);
-        }
-        for (const [sig, mime] of _BinarySignatureDetector.SIGNATURES) {
-          if (this.startsWith(bytes, sig)) {
-            if (mime === "application/zip") {
-              return this.detectZipType(bytes);
-            }
-            return mime;
-          }
-        }
-        return "application/octet-stream";
-      }
-      toBytes(content) {
-        if (content instanceof Uint8Array) return content;
-        return new TextEncoder().encode(content);
-      }
-      startsWith(data, prefix) {
-        if (data.length < prefix.length) return false;
-        for (let i = 0; i < prefix.length; i++) {
-          if (data[i] !== prefix[i]) return false;
-        }
-        return true;
-      }
-      detectRiffFormat(bytes) {
-        if (bytes.length < 12) return "application/octet-stream";
-        const format = new TextDecoder().decode(bytes.slice(8, 12));
-        if (format === "WAVE") return "audio/wav";
-        if (format === "WEBP") return "image/webp";
-        return "application/octet-stream";
-      }
-      detectZipType(bytes) {
-        const header = new TextDecoder().decode(bytes.slice(0, 2048));
-        if (header.includes("[Content_Types].xml") && header.includes("_rels/.rels")) {
-          if (header.includes("word/")) return "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-          if (header.includes("xl/")) return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
-          if (header.includes("ppt/")) return "application/vnd.openxmlformats-officedocument.presentationml.presentation";
-        }
-        return "application/zip";
-      }
-    };
-  }
-});
-
-// src/model/detectors/LanguageDetector.ts
-var ProgrammingLanguageDetector;
-var init_LanguageDetector = __esm({
-  "src/model/detectors/LanguageDetector.ts"() {
-    "use strict";
-    ProgrammingLanguageDetector = class {
-      contentTypeName = "code";
-      detect(contentSample, lines, firstLine, fileExtension) {
-        const mime = this.getMimeType(contentSample, lines, firstLine, fileExtension);
-        return mime && mime !== "text/plain" ? 0.95 : 0;
-      }
-      getMimeType(contentSample, lines, firstLine, fileExtension) {
-        const text = typeof contentSample === "string" ? contentSample : new TextDecoder().decode(contentSample);
-        if (this.isPython(firstLine, text, lines)) {
-          return "text/x-python";
-        }
-        const cType = this.detectCFamily(text);
-        if (cType) return cType;
-        const jsType = this.detectJsType(text);
-        if (jsType) return jsType;
-        if (this.isTypescript(text)) {
-          return "text/typescript";
-        }
-        return "text/plain";
-      }
-      isPython(firstLine, text, lines) {
-        if (/^\s*import\s+(\w+|\w+\.\w+)/m.test(text) || /^\s*from\s+(\w+|\w+\.\w+)\s+import\s+/m.test(text)) {
-          const stdLibs = ["os", "sys", "re", "json", "math", "random", "datetime"];
-          if (stdLibs.some((lib) => text.includes(`import ${lib}`) || text.includes(`from ${lib}`))) {
-            return true;
-          }
-        }
-        if (firstLine.startsWith("#!") && firstLine.toLowerCase().includes("python")) return true;
-        if (text.includes("if __name__ ==") && text.includes("__main__")) return true;
-        if (/^\s*def\s+\w+\s*\(/.test(text) && !text.includes("function")) return true;
-        if (/^\s*class\s+\w+\s*[\(:]/m.test(text)) return true;
-        if (/^\s*@\w+/m.test(text)) return true;
-        let count = 0;
-        const patterns = [
-          /\bif\b.*?:/,
-          /\belif\b.*?:/,
-          /\belse\s*:/,
-          /\bfor\b.*?\bin\b.*?:/,
-          /\bwhile\b.*?:/,
-          /\btry\s*:/,
-          /\bexcept\b.*?:/,
-          /\bfinally\s*:/,
-          /\bNone\b/,
-          /\bTrue\b/,
-          /\bFalse\b/,
-          /f["'].*?\{.*?\}["']/,
-          // f-string
-          /\bdef\b/,
-          /\bclass\b/,
-          /\bimport\b/,
-          /\bfrom\b/,
-          /\blambda\b.*?:/
-        ];
-        for (const p of patterns) {
-          if (p.test(text)) count++;
-        }
-        const nonEmptyLines = lines.filter((l) => l.trim().length > 0).length;
-        if (nonEmptyLines <= 5 && count >= 1) {
-          return true;
-        }
-        return count >= 3;
-      }
-      detectCFamily(text) {
-        const cPatterns = [
-          /#include\s*<.*?>/,
-          /#include\s*".*?"/,
-          /\b(int|void|char|float|double)\s+main\s*\(.*\)\s*\{/,
-          /\bstruct\s+\w+\s*\{/,
-          /#define\s+\w+/,
-          /printf\(.*?\);/,
-          /scanf\(.*?\);/
-        ];
-        const cppPatterns = [
-          /\bclass\s+\w+\s*\{/,
-          /\bnamespace\s+\w+\s*\{/,
-          /\btemplate\s*<.*?>/,
-          /::/,
-          /\bstd::/,
-          /\bcout\s*<</,
-          /\bcin\s*>>/,
-          /\bnew\s+\w+/,
-          /\bdelete\s+\w+/,
-          /#include\s*<iostream>/
-        ];
-        let cCount = 0;
-        let cppCount = 0;
-        cPatterns.forEach((p) => {
-          if (p.test(text)) cCount++;
-        });
-        cppPatterns.forEach((p) => {
-          if (p.test(text)) cppCount++;
-        });
-        if (cppCount >= 2 || cppCount >= 1 && text.includes("std::")) return "text/x-c++";
-        if (cCount >= 2) return "text/x-c";
-        return null;
-      }
-      detectJsType(text) {
-        const jsPatterns = [
-          /function\s+\w+\s*\(/.test(text),
-          // function foo(
-          /\bconst\s+\w+\s*=/.test(text),
-          /\blet\s+\w+\s*=/.test(text),
-          /\bvar\s+\w+\s*=/.test(text),
-          /\bimport\s+.*\s+from/.test(text),
-          /\bexport\s+/.test(text),
-          /\=\>\s*\{/.test(text),
-          // Arrow func
-          /console\.log\(/.test(text)
-        ];
-        const jsxPatterns = [
-          /<\w+(>|\s+.*?>)[\s\S]*?<\/\w+>/m.test(text),
-          /<\w+\s+\/>/m.test(text),
-          /className=/.test(text),
-          /React\.createElement/.test(text)
-        ];
-        const jsCount = jsPatterns.filter(Boolean).length;
-        const jsxCount = jsxPatterns.filter(Boolean).length;
-        if (jsxCount > 0 && (text.includes("import React") || text.includes('from "react"'))) return "text/jsx";
-        if (jsxCount >= 2) return "text/jsx";
-        if (jsCount >= 2) {
-          const stripped = text.trim();
-          if (stripped.startsWith("{") && stripped.endsWith("}") || stripped.startsWith("[") && stripped.endsWith("]")) {
-            try {
-              JSON.parse(text);
-              if (jsCount < 2) return null;
-            } catch {
-            }
-          }
-          return "text/javascript";
-        }
-        return null;
-      }
-      isTypescript(text) {
-        const tsPatterns = [
-          /:\s*(string|number|boolean|any|void|null|undefined)\b/,
-          /\binterface\s+\w+\s*\{/,
-          /\bclass\s+\w+\s+implements\s+\w+/,
-          /\btype\s+\w+\s*=/,
-          /\b(public|private|protected)\s+/,
-          /\bnamespace\s+\w+\s*\{/,
-          /<\w+>/
-          // Generics (simple check)
-        ];
-        let count = 0;
-        tsPatterns.forEach((p) => {
-          if (p.test(text)) count++;
-        });
-        return count >= 2;
-      }
-    };
-  }
-});
-
-// src/model/detectors/MarkupDetectors.ts
-var XMLDetector, MarkdownDetector, PlainTextDetector;
-var init_MarkupDetectors = __esm({
-  "src/model/detectors/MarkupDetectors.ts"() {
-    "use strict";
-    XMLDetector = class _XMLDetector {
-      contentTypeName = "xml";
-      static XML_DECLARATION = /^\s*<\?xml/i;
-      static BASIC_TAG_PAIR = /<(\w+)[^>]*>.*?<\/\1>/s;
-      detect(contentSample, lines, firstLine, fileExtension) {
-        const text = typeof contentSample === "string" ? contentSample : new TextDecoder().decode(contentSample);
-        let confidence = 0;
-        if (fileExtension && fileExtension.toLowerCase() === ".xml") {
-          confidence = Math.max(confidence, 0.95);
-        }
-        if (_XMLDetector.XML_DECLARATION.test(firstLine) || text.trim().startsWith("<?xml")) {
-          confidence = Math.max(confidence, 0.95);
-        }
-        if (text.includes("<") && text.includes(">") && text.includes("</")) {
-          confidence = Math.max(confidence, 0.5);
-          if (_XMLDetector.BASIC_TAG_PAIR.test(text)) {
-            confidence = Math.max(confidence, 0.7);
-          }
-        }
-        if (text.toLowerCase().includes("<!doctype html")) {
-          if (confidence > 0.3) confidence -= 0.4;
-        }
-        return Math.min(Math.max(confidence, 0), 1);
-      }
-      getMimeType(contentSample, lines, firstLine, fileExtension) {
-        const text = typeof contentSample === "string" ? contentSample : new TextDecoder().decode(contentSample);
-        if (fileExtension === ".xml") return "application/xml";
-        if (text.toLowerCase().includes("<svg")) return "image/svg+xml";
-        if (text.toLowerCase().includes("<html") || text.toLowerCase().includes("<!doctype html")) return "text/html";
-        if (this.detect(contentSample, lines, firstLine, fileExtension) > 0.5) return "application/xml";
-        return "text/plain";
-      }
-    };
-    MarkdownDetector = class _MarkdownDetector {
-      contentTypeName = "markdown";
-      static MD_PATTERNS = [
-        /^#{1,6}\s+\S+/,
-        // ATX Headers
-        /^\s*[\*\+\-]\s+\S+/,
-        // List items
-        /^\s*\d+\.\s+\S+/,
-        // Ordered list items
-        /`{1,3}[^`]+`{1,3}/,
-        // Inline code
-        /\[[^\]]+\]\([^\)]+\)/,
-        // Links
-        /!\[[^\]]+\]\([^\)]+\)/,
-        // Images
-        /^\s*>.*/
-        // Blockquotes
-      ];
-      static SETEXT_HEADER = /^.*\n(?:={3,}|-{3,})\s*$/m;
-      detect(contentSample, lines, firstLine, fileExtension) {
-        const text = typeof contentSample === "string" ? contentSample : new TextDecoder().decode(contentSample);
-        let confidence = 0;
-        if (fileExtension && [".md", ".markdown"].includes(fileExtension.toLowerCase())) {
-          confidence = Math.max(confidence, 0.95);
-        }
-        let mdFeatures = 0;
-        if (_MarkdownDetector.SETEXT_HEADER.test(text)) mdFeatures += 2;
-        for (const line of lines.slice(0, 20)) {
-          if (_MarkdownDetector.MD_PATTERNS.some((p) => p.test(line))) {
-            mdFeatures++;
-          }
-        }
-        const hasCodeFence = text.includes("```");
-        if (hasCodeFence) mdFeatures++;
-        if (mdFeatures > 1 && hasCodeFence) confidence = Math.max(confidence, 0.85);
-        if (mdFeatures > 3 && hasCodeFence) confidence = Math.max(confidence, 0.95);
-        else if (mdFeatures > 1) confidence = Math.max(confidence, 0.6);
-        else if (mdFeatures > 3) confidence = Math.max(confidence, 0.8);
-        else if (mdFeatures > 5) confidence = Math.max(confidence, 0.9);
-        const stripped = text.trim();
-        if (stripped.startsWith("{") && stripped.endsWith("}") || stripped.startsWith("[") && stripped.endsWith("]")) {
-          try {
-            JSON.parse(text);
-            if (confidence > 0.3) confidence -= 0.4;
-          } catch {
-          }
-        }
-        if (stripped.startsWith("<") && text.includes("<?xml")) {
-          if (confidence > 0.3) confidence -= 0.4;
-        }
-        return Math.min(Math.max(confidence, 0), 1);
-      }
-      getMimeType(contentSample, lines, firstLine, fileExtension) {
-        return this.detect(contentSample, lines, firstLine, fileExtension) > 0.5 ? "text/markdown" : "text/plain";
-      }
-    };
-    PlainTextDetector = class _PlainTextDetector {
-      contentTypeName = "text";
-      static IMAGE_EXTS = [".png", ".jpg", ".jpeg", ".gif", ".bmp", ".svg", ".webp"];
-      detect(contentSample, lines, firstLine, fileExtension) {
-        if (!contentSample && lines.length === 0) return 0.1;
-        if (fileExtension) {
-          const ext = fileExtension.toLowerCase();
-          if (_PlainTextDetector.IMAGE_EXTS.includes(ext) || ext === ".pdf") return 0;
-        }
-        const text = typeof contentSample === "string" ? contentSample : new TextDecoder().decode(contentSample);
-        if (text.includes(",") && lines.length < 5) {
-          const commaLines = lines.filter((l) => l.includes(",")).length;
-          if (commaLines > 0 && commaLines === lines.length) {
-            return 0.8;
-          }
-        }
-        return 0.15;
-      }
-      getMimeType(contentSample, lines, firstLine, fileExtension) {
-        return "text/plain";
-      }
-    };
-  }
-});
-
-// src/model/detectors/DataFormatDetectors.ts
-var SQLDetector, JSONDetector, YAMLDetector, CSVDetector;
-var init_DataFormatDetectors = __esm({
-  "src/model/detectors/DataFormatDetectors.ts"() {
-    "use strict";
-    SQLDetector = class _SQLDetector {
-      contentTypeName = "sql";
-      // Keywords (case insensitive checking handled in method)
-      static KEYWORDS = [
-        "SELECT ",
-        "INSERT ",
-        "UPDATE ",
-        "DELETE ",
-        "CREATE ",
-        "DROP ",
-        "ALTER ",
-        "FROM ",
-        "WHERE ",
-        "JOIN ",
-        "TABLE ",
-        "INTO ",
-        "VALUES ",
-        "SET ",
-        "PRIMARY KEY"
-      ];
-      detect(contentSample, lines, firstLine, fileExtension) {
-        const text = typeof contentSample === "string" ? contentSample : new TextDecoder().decode(contentSample);
-        let confidence = 0;
-        if (fileExtension && fileExtension.toLowerCase() === ".sql") {
-          confidence = Math.max(confidence, 0.95);
-        }
-        let hits = 0;
-        const upperText = text.toUpperCase();
-        for (const line of lines.slice(0, 10)) {
-          const upperLine = line.toUpperCase();
-          for (const kw of _SQLDetector.KEYWORDS) {
-            if (upperLine.includes(kw)) {
-              hits++;
-            }
-          }
-        }
-        if (hits >= 2) confidence = Math.max(confidence, 0.85);
-        else if (hits === 1) confidence = Math.max(confidence, 0.6);
-        return Math.min(confidence, 1);
-      }
-      getMimeType(contentSample, lines, firstLine, fileExtension) {
-        return this.detect(contentSample, lines, firstLine, fileExtension) > 0.5 ? "text/x-sql" : "text/plain";
-      }
-    };
-    JSONDetector = class {
-      contentTypeName = "json";
-      detect(contentSample, lines, firstLine, fileExtension) {
-        const text = typeof contentSample === "string" ? contentSample : new TextDecoder().decode(contentSample);
-        if (fileExtension && fileExtension.toLowerCase() === ".json") {
-          return this.verifyJsonStructure(text) ? 0.95 : 0.6;
-        }
-        const stripped = text.trim();
-        if (!(stripped.startsWith("{") && stripped.endsWith("}") || stripped.startsWith("[") && stripped.endsWith("]"))) {
-          return 0;
-        }
-        for (const line of lines.slice(0, 5)) {
-          const l = line.trim();
-          if (l.startsWith("//") || l.startsWith("/*")) return 0;
-        }
-        try {
-          JSON.parse(text);
-          return 0.9;
-        } catch (e) {
-          return 0;
-        }
-      }
-      getMimeType(contentSample, lines, firstLine, fileExtension) {
-        return this.detect(contentSample, lines, firstLine, fileExtension) > 0.5 ? "application/json" : "text/plain";
-      }
-      verifyJsonStructure(text) {
-        try {
-          JSON.parse(text);
-          return true;
-        } catch {
-          return false;
-        }
-      }
-    };
-    YAMLDetector = class _YAMLDetector {
-      contentTypeName = "yaml";
-      static YAML_START_PATTERNS = [/^---\s*$/, /^%YAML/];
-      static KEY_VALUE_PATTERN = /^\s*[\w.-]+:\s+(?![=\{\[])/;
-      static LIST_ITEM_PATTERN = /^\s*-\s+[\w\'\"]/;
-      detect(contentSample, lines, firstLine, fileExtension) {
-        const text = typeof contentSample === "string" ? contentSample : new TextDecoder().decode(contentSample);
-        let confidence = 0;
-        if (fileExtension && [".yaml", ".yml"].includes(fileExtension.toLowerCase())) {
-          confidence = Math.max(confidence, 0.95);
-        }
-        if (_YAMLDetector.YAML_START_PATTERNS.some((p) => p.test(firstLine))) {
-          confidence = Math.max(confidence, 0.9);
-        }
-        let yamlFeatures = 0;
-        if (_YAMLDetector.YAML_START_PATTERNS.some((p) => new RegExp(p.source, "m").test(text))) {
-          yamlFeatures += 2;
-        }
-        for (const line of lines.slice(0, 20)) {
-          const stripped = line.trim();
-          if (_YAMLDetector.KEY_VALUE_PATTERN.test(stripped)) yamlFeatures++;
-          else if (_YAMLDetector.LIST_ITEM_PATTERN.test(stripped)) yamlFeatures++;
-        }
-        const firstNonEmpty = lines.find((l) => l.trim().length > 0) || "";
-        if (firstNonEmpty.trim() === "---") {
-          if (yamlFeatures > 1) confidence = Math.max(confidence, 0.5);
-          if (yamlFeatures > 3) confidence = Math.max(confidence, 0.75);
-          if (yamlFeatures > 5) confidence = Math.max(confidence, 0.9);
-        } else {
-          if (fileExtension && [".yaml", ".yml"].includes(fileExtension.toLowerCase())) {
-          }
-        }
-        return Math.min(Math.max(confidence, 0), 1);
-      }
-      getMimeType(contentSample, lines, firstLine, fileExtension) {
-        const conf = this.detect(contentSample, lines, firstLine, fileExtension);
-        return conf > 0.5 ? "application/x-yaml" : "text/plain";
-      }
-    };
-    CSVDetector = class {
-      contentTypeName = "csv";
-      detect(contentSample, lines, firstLine, fileExtension) {
-        const text = typeof contentSample === "string" ? contentSample : new TextDecoder().decode(contentSample);
-        if (fileExtension && fileExtension.toLowerCase() === ".csv") {
-          return this.verifyCsvStructure(lines) ? 0.95 : 0.6;
-        }
-        const hasComma = lines.some((l) => l.includes(","));
-        if (hasComma) {
-          if (lines.length < 3) {
-            const commaLines = lines.filter((l) => l.includes(",")).length;
-            if (commaLines > 0 && commaLines === lines.length) {
-              const delimCounts = lines.filter((l) => l.trim()).map((l) => (l.match(/,/g) || []).length);
-              if (delimCounts.length > 0 && delimCounts.every((c) => c <= 2)) {
-                return 0;
-              }
-            }
-          }
-        }
-        return this.analyzeCsvContent(lines);
-      }
-      getMimeType(contentSample, lines, firstLine, fileExtension) {
-        return this.detect(contentSample, lines, firstLine, fileExtension) > 0.5 ? "text/csv" : "text/plain";
-      }
-      verifyCsvStructure(lines) {
-        const sampleLines = lines.slice(0, 10).filter((l) => l.trim().length > 0);
-        if (sampleLines.length === 0) return false;
-        if (!sampleLines.every((l) => l.includes(","))) return false;
-        const counts = sampleLines.map((l) => (l.match(/,/g) || []).length);
-        const uniqueCounts = [...new Set(counts)];
-        if (uniqueCounts.length === 1 && uniqueCounts[0] > 0) return true;
-        if (sampleLines.length > 1) {
-          const dataCounts = counts.slice(1);
-          const uniqueData = [...new Set(dataCounts)];
-          if (uniqueData.length === 1 && uniqueData[0] > 0) return true;
-        }
-        return false;
-      }
-      analyzeCsvContent(lines) {
-        if (!lines || lines.length === 0) return 0;
-        const sampleLines = lines.slice(0, 10).filter((l) => l.trim().length > 0);
-        if (sampleLines.length === 0 || !sampleLines.every((l) => l.includes(","))) return 0;
-        const counts = sampleLines.map((l) => (l.match(/,/g) || []).length);
-        const uniqueCounts = [...new Set(counts)];
-        if (uniqueCounts.length === 1 && uniqueCounts[0] > 0) return 0.9;
-        if (sampleLines.length > 1) {
-          const dataCounts = counts.slice(1);
-          const uniqueData = [...new Set(dataCounts)];
-          if (uniqueData.length === 1 && uniqueData[0] > 0) return 0.8;
-        }
-        if (counts.every((c) => c > 0)) return 0.5;
-        return 0;
-      }
-    };
-  }
-});
-
-// src/model/detectors/OBJDetector.ts
-var OBJDetector;
-var init_OBJDetector = __esm({
-  "src/model/detectors/OBJDetector.ts"() {
-    "use strict";
-    OBJDetector = class _OBJDetector {
-      contentTypeName = "obj";
-      // Check for 'v ' (vertex), 'f ' (face), 'vn ', 'vt '
-      static COMMANDS = ["v ", "vt ", "vn ", "f ", "g ", "o ", "s ", "mtllib ", "usemtl "];
-      detect(contentSample, lines, firstLine, fileExtension) {
-        const text = typeof contentSample === "string" ? contentSample : new TextDecoder().decode(contentSample);
-        let confidence = 0;
-        if (fileExtension && fileExtension.toLowerCase() === ".obj") {
-          confidence = Math.max(confidence, 0.95);
-        }
-        const validLines = lines.filter((l) => l.trim().length > 0 && !l.trim().startsWith("#"));
-        let commandCount = 0;
-        for (const line of validLines.slice(0, 20)) {
-          const trimmed = line.trim();
-          for (const cmd of _OBJDetector.COMMANDS) {
-            if (trimmed.startsWith(cmd)) {
-              commandCount++;
-              break;
-            }
-          }
-        }
-        if (commandCount >= 2) {
-          if (commandCount > 10) confidence = Math.max(confidence, 0.9);
-          else if (commandCount > 5) confidence = Math.max(confidence, 0.8);
-          else confidence = Math.max(confidence, 0.7);
-        }
-        const codeKeywords = ["def ", "class ", "import ", "function ", "var ", "let ", "const "];
-        if (codeKeywords.some((k) => text.includes(k))) {
-          return 0;
-        }
-        return Math.min(confidence, 1);
-      }
-      getMimeType(contentSample, lines, firstLine, fileExtension) {
-        return this.detect(contentSample, lines, firstLine, fileExtension) > 0.5 ? "application/3d-obj" : "text/plain";
-      }
-    };
-  }
-});
-
-// src/model/detectors/registry.ts
-var DetectorRegistry, registry;
-var init_registry = __esm({
-  "src/model/detectors/registry.ts"() {
-    "use strict";
-    init_BinaryDetector();
-    init_LanguageDetector();
-    init_MarkupDetectors();
-    init_DataFormatDetectors();
-    init_OBJDetector();
-    DetectorRegistry = class {
-      detectors;
-      constructor() {
-        this.detectors = [
-          new BinarySignatureDetector(),
-          // Programming languages
-          new ProgrammingLanguageDetector(),
-          // Structured data
-          new XMLDetector(),
-          new JSONDetector(),
-          new OBJDetector(),
-          // Markup
-          new MarkdownDetector(),
-          // Data formats (lower priority)
-          new SQLDetector(),
-          new CSVDetector(),
-          new YAMLDetector(),
-          // Fallback
-          new PlainTextDetector()
-        ];
-      }
-      /**
-       * Get the active detectors.
-       */
-      getDetectors() {
-        return this.detectors;
-      }
-    };
-    registry = new DetectorRegistry();
-  }
-});
-
-// ../mime_extensions.json
-var mime_extensions_default;
-var init_mime_extensions = __esm({
-  "../mime_extensions.json"() {
-    mime_extensions_default = {
-      textMimeTypes: [
-        "text/plain",
-        "text/html",
-        "text/xml",
-        "text/csv",
-        "text/css",
-        "text/javascript",
-        "text/markdown",
-        "text/x-python",
-        "text/x-java",
-        "text/x-c",
-        "text/x-c++",
-        "text/x-sql",
-        "text/jsx",
-        "text/typescript",
-        "application/json",
-        "application/xml",
-        "application/x-yaml",
-        "application/javascript",
-        "application/x-httpd-php",
-        "application/x-sh",
-        "application/x-tex",
-        "application/3d-obj",
-        "text/vnd.graphviz",
-        "text/x-mermaid",
-        "text/x-plantuml",
-        "application/x-properties",
-        "application/toml"
-      ],
-      mimeToExtension: {
-        "image/png": "png",
-        "image/jpeg": "jpg",
-        "image/gif": "gif",
-        "image/bmp": "bmp",
-        "image/x-icon": "ico",
-        "image/svg+xml": "svg",
-        "image/djvu": "djvu",
-        "image/vnd.djvu": "djv",
-        "image/webp": "webp",
-        "audio/wav": "wav",
-        "audio/x-wav": "wav",
-        "video/mp4": "mp4",
-        "video/quicktime": "mov",
-        "application/pdf": "pdf",
-        "application/msword": "doc",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx",
-        "application/vnd.ms-excel": "xls",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "xlsx",
-        "application/vnd.ms-powerpoint": "ppt",
-        "application/vnd.openxmlformats-officedocument.presentationml.presentation": "pptx",
-        "application/zip": "zip",
-        "application/gzip": "gz",
-        "application/x-rar-compressed": "rar",
-        "application/x-7z-compressed": "7z",
-        "application/x-sqlite3": "db",
-        "application/x-parquet": "parquet",
-        "text/plain": "txt",
-        "text/html": "html",
-        "text/xml": "xml",
-        "text/csv": "csv",
-        "text/css": "css",
-        "text/javascript": "js",
-        "text/markdown": "md",
-        "text/x-python": "py",
-        "text/x-java": "java",
-        "text/x-c": "c",
-        "text/x-sql": "sql",
-        "text/jsx": "js",
-        "application/json": "json",
-        "application/xml": "xml",
-        "application/x-yaml": "yaml",
-        "application/javascript": "js",
-        "application/x-httpd-php": "php",
-        "application/x-sh": "sh",
-        "application/x-tex": "tex",
-        "text/vnd.graphviz": "dot",
-        "text/x-mermaid": "mmd",
-        "text/x-plantuml": "puml",
-        "application/3d-obj": "obj",
-        "application/x-properties": "properties",
-        "application/toml": "toml"
-      }
-    };
-  }
-});
-
-// src/config/constants.ts
-var DEFAULT_PAGE_SIZE, DETECTION_SAMPLE_CAP, MAX_FILE_SIZE, KNOWN_TYPE_SIZE_LIMIT, BINARY_CHECK_SAMPLE_SIZE, CONTENT_DETECTION_SAMPLE_SIZE, DEFAULT_MAX_PROBLEM_BYTES, INDEXEDDB_DEFAULT_DB_NAME, INDEXEDDB_DEFAULT_DB_VERSION, SQLITE_BUSY_TIMEOUT_MS, DEFAULT_SQLJS_WASM_URL;
-var init_constants = __esm({
-  "src/config/constants.ts"() {
-    "use strict";
-    DEFAULT_PAGE_SIZE = 10;
-    DETECTION_SAMPLE_CAP = 8192;
-    MAX_FILE_SIZE = 50 * 1024 * 1024;
-    KNOWN_TYPE_SIZE_LIMIT = 1024 * 1024;
-    BINARY_CHECK_SAMPLE_SIZE = 32 * 1024;
-    CONTENT_DETECTION_SAMPLE_SIZE = 1024 * 1024;
-    DEFAULT_MAX_PROBLEM_BYTES = 2 * 1024 * 1024;
-    INDEXEDDB_DEFAULT_DB_NAME = "mcard-db";
-    INDEXEDDB_DEFAULT_DB_VERSION = 1;
-    SQLITE_BUSY_TIMEOUT_MS = 5e3;
-    DEFAULT_SQLJS_WASM_URL = "https://sql.js.org/dist/";
-  }
-});
-
-// src/model/strategies/DetectionStrategy.ts
-function loadSharedMimeData() {
-  return {
-    textMimeTypes: new Set(mime_extensions_default.textMimeTypes || []),
-    mimeToExtension: mime_extensions_default.mimeToExtension || {}
-  };
-}
-function withDot(ext) {
-  return ext.startsWith(".") ? ext : `.${ext}`;
-}
-var _sharedData, DefaultDetectionStrategy;
-var init_DetectionStrategy = __esm({
-  "src/model/strategies/DetectionStrategy.ts"() {
-    "use strict";
-    init_registry();
-    init_mime_extensions();
-    init_constants();
-    _sharedData = loadSharedMimeData();
-    DefaultDetectionStrategy = class _DefaultDetectionStrategy {
-      constructor(customRegistry) {
-        this.customRegistry = customRegistry;
-      }
-      // Loaded from the shared JSON
-      static extensionsRegistry = Object.fromEntries(
-        Object.entries(_sharedData.mimeToExtension).map(([k, v]) => [k, withDot(v)])
-      );
-      static textMimeTypes = _sharedData.textMimeTypes;
-      static registerExtension(mimeType, extension) {
-        this.extensionsRegistry[mimeType] = extension;
-      }
-      static loadExtensions(mapping) {
-        for (const [mime, ext] of Object.entries(mapping)) {
-          this.extensionsRegistry[mime] = ext;
-        }
-      }
-      static getExtension(mimeType) {
-        return this.extensionsRegistry[mimeType] || "";
-      }
-      detect(content, fileExtension) {
-        const contentSample = typeof content === "string" ? content.slice(0, DETECTION_SAMPLE_CAP) : content.slice(0, DETECTION_SAMPLE_CAP);
-        const textSample = this.getTextSample(contentSample);
-        const lines = textSample.split("\n").slice(0, 20);
-        const firstLine = lines[0] || "";
-        const detectors = this.customRegistry ? this.customRegistry.getDetectors() : registry.getDetectors();
-        let bestConfidence = 0;
-        let mimeType = "text/plain";
-        for (const detector of detectors) {
-          const confidence = detector.detect(contentSample, lines, firstLine, fileExtension);
-          if (confidence > bestConfidence) {
-            const detectedMime = detector.getMimeType(contentSample, lines, firstLine, fileExtension);
-            if (detectedMime) {
-              bestConfidence = confidence;
-              mimeType = detectedMime;
-              if (confidence >= 0.99) break;
-            }
-          }
-        }
-        let extension = this.getExtension(mimeType);
-        if (fileExtension && extension) {
-          if (fileExtension.toLowerCase() === extension || fileExtension.toLowerCase() === `.${extension}`) {
-            extension = fileExtension;
-          }
-        }
-        if (!extension && fileExtension) {
-          extension = fileExtension;
-        }
-        if (!extension) {
-          extension = ".txt";
-        }
-        return { mimeType, extension };
-      }
-      getTextSample(content) {
-        if (typeof content === "string") {
-          return content.slice(0, DETECTION_SAMPLE_CAP);
-        }
-        return new TextDecoder("utf-8", { fatal: false }).decode(content.slice(0, DETECTION_SAMPLE_CAP));
-      }
-      getExtension(mimeType) {
-        return _DefaultDetectionStrategy.getExtension(mimeType);
-      }
-    };
-  }
-});
-
-// src/model/utils/ContentAnalyzer.ts
-var ContentAnalyzer;
-var init_ContentAnalyzer = __esm({
-  "src/model/utils/ContentAnalyzer.ts"() {
-    "use strict";
-    ContentAnalyzer = class {
-      /**
-       * Check if content should be treated as binary.
-       */
-      static isBinaryContent(content, mimeType) {
-        if (mimeType) {
-          if (mimeType.startsWith("text/") || mimeType.includes("json") || mimeType.includes("xml") || mimeType.includes("javascript") || mimeType.includes("ecmascript")) {
-            return false;
-          }
-          return true;
-        }
-        if (typeof content === "string") return false;
-        if (content.indexOf(0) !== -1) {
-          return true;
-        }
-        try {
-          const decoder = new TextDecoder("utf-8", { fatal: true });
-          const decoded = decoder.decode(content);
-          const sample = content.slice(0, 4096);
-          if (sample.length === 0) return false;
-          let nonTextChars = 0;
-          for (let i = 0; i < sample.length; i++) {
-            const b = sample[i];
-            if (b < 9 || b > 13 && b < 32 || b > 126) {
-              nonTextChars++;
-            }
-          }
-          const textRatio = 1 - nonTextChars / sample.length;
-          return textRatio < 0.7;
-        } catch (e) {
-          return true;
-        }
-      }
-      static isKnownLongLineExtension(extension) {
-        if (!extension) return false;
-        const ext = extension.toLowerCase();
-        return [".min.js", ".min.css", ".map", ".svg", ".json", ".geojson"].some((e) => ext.endsWith(e));
-      }
-      static isUnstructuredBinary(sample) {
-        if (sample.length < 512) return false;
-        let nullCount = 0;
-        let controlCount = 0;
-        const len = Math.min(sample.length, 32 * 1024);
-        for (let i = 0; i < len; i++) {
-          const byte = sample[i];
-          if (byte === 0) {
-            nullCount++;
-          }
-          if (byte < 32 && byte !== 9 && byte !== 10 && byte !== 13) {
-            controlCount++;
-          }
-        }
-        const nullRatio = nullCount / len;
-        const controlRatio = controlCount / len;
-        return nullRatio > 0.1 || controlRatio > 0.2;
-      }
-      static hasPathologicalLines(sample, isKnownType) {
-        if (isKnownType || sample.length < 32768) return false;
-        for (let i = 0; i < sample.length; i++) {
-          if (sample[i] === 10 || sample[i] === 13) return false;
-        }
-        return true;
-      }
-    };
-  }
-});
-
 // src/model/ContentTypeInterpreter.ts
-var ContentTypeInterpreter;
+var import_mcard_wasm, ContentTypeInterpreter;
 var init_ContentTypeInterpreter = __esm({
   "src/model/ContentTypeInterpreter.ts"() {
     "use strict";
-    init_DetectionStrategy();
-    init_ContentAnalyzer();
+    import_mcard_wasm = require("mcard-wasm");
     ContentTypeInterpreter = class {
-      static strategy = new DefaultDetectionStrategy();
-      /**
-       * Convenience method to detect MIME type only.
-       * Matches the API expected by MCard/PCard/VCard.
-       */
       static detect(content) {
         return this.detectContentType(content).mimeType;
       }
-      /**
-       * Detect content type and suggest extension.
-       *
-       * @param content Content string or binary buffer
-       * @param fileExtension Optional file extension hint
-       * @returns Object containing detected mimeType and suggested extension
-       */
       static detectContentType(content, fileExtension) {
-        return this.strategy.detect(content, fileExtension);
-      }
-      static registerExtension(mimeType, extension) {
-        DefaultDetectionStrategy.registerExtension(mimeType, extension);
-      }
-      static registerExtensions(mapping) {
-        DefaultDetectionStrategy.loadExtensions(mapping);
+        const buffer = typeof content === "string" ? new TextEncoder().encode(content) : content;
+        const result = (0, import_mcard_wasm.detect_content_type)(buffer, fileExtension);
+        return { mimeType: result[0], extension: result[1] };
       }
       static getExtension(mimeType) {
-        return DefaultDetectionStrategy.getExtension(mimeType);
+        return (0, import_mcard_wasm.get_extension)(mimeType) || "bin";
       }
-      /**
-       * Check if content should be treated as binary.
-       */
       static isBinaryContent(content, mimeType) {
-        return ContentAnalyzer.isBinaryContent(content, mimeType);
+        const buffer = typeof content === "string" ? new TextEncoder().encode(content) : content;
+        return (0, import_mcard_wasm.is_binary_content)(buffer);
+      }
+      // Stub or bypass irrelevant manual TS rules now managed by mcard-core
+      static registerExtension(mimeType, extension) {
+      }
+      static registerExtensions(mapping) {
       }
       static isKnownLongLineExtension(extension) {
-        return ContentAnalyzer.isKnownLongLineExtension(extension);
+        return false;
       }
       static isUnstructuredBinary(sample) {
-        return ContentAnalyzer.isUnstructuredBinary(sample);
+        if (sample.length < 512) return false;
+        let nullCount = 0;
+        let controlChars = 0;
+        for (let i = 0; i < sample.length; i++) {
+          const b = sample[i];
+          if (b === 0) nullCount++;
+          if (b < 32 && b !== 9 && b !== 10 && b !== 13) controlChars++;
+        }
+        const nullRatio = nullCount / sample.length;
+        const controlRatio = controlChars / sample.length;
+        return nullRatio > 0.1 || controlRatio > 0.2;
       }
       static hasPathologicalLines(sample, isKnownType) {
-        return ContentAnalyzer.hasPathologicalLines(sample, isKnownType);
+        return false;
       }
     };
   }
@@ -1297,16 +335,16 @@ var init_MCard = __esm({
       }
       /**
        * Get DOTS vocabulary metadata for this MCard
-       * 
+       *
        * Returns the DOTS role information that positions this MCard
        * in the Double Operadic Theory of Systems framework.
-       * 
+       *
        * MCard is always a CARRIER object in the Data Plane.
-       * 
+       *
        * @param tightRefs - Optional array of prerequisite MCard hashes (vertical composition)
        * @param looseRefs - Optional array of alternative MCard hashes (horizontal composition)
        * @returns DOTSMetadata describing this card's role in the compositional system
-       * 
+       *
        * @example
        * ```typescript
        * const card = await MCard.create('Hello World');
@@ -1406,6 +444,44 @@ var init_Handle = __esm({
   }
 });
 
+// src/config/constants.ts
+var DEFAULT_PAGE_SIZE, MAX_FILE_SIZE, READ_TIMEOUT_MS, KNOWN_TYPE_SIZE_LIMIT, BINARY_CHECK_SAMPLE_SIZE, CONTENT_DETECTION_SAMPLE_SIZE, DEFAULT_MAX_PROBLEM_BYTES, INDEXEDDB_DEFAULT_DB_NAME, INDEXEDDB_DEFAULT_DB_VERSION, SQLITE_BUSY_TIMEOUT_MS, getEnvUrl, DEFAULT_OLLAMA_BASE_URL, DEFAULT_OTLP_ENDPOINT, DEFAULT_VLLM_BASE_URL, DEFAULT_LMSTUDIO_BASE_URL, DEFAULT_SQLJS_WASM_URL, DEFAULT_SANDBOX_TIMEOUT_MS, DEFAULT_CLM_TIMEOUT_MS, DEFAULT_VM_EXECUTION_TIMEOUT_MS, LLM_DEFAULT_TIMEOUT_SECS, LLM_DEFAULT_RETRY_COUNT, LLM_DEFAULT_RETRY_DELAY_SECS;
+var init_constants = __esm({
+  "src/config/constants.ts"() {
+    "use strict";
+    DEFAULT_PAGE_SIZE = 10;
+    MAX_FILE_SIZE = 50 * 1024 * 1024;
+    READ_TIMEOUT_MS = 5e3;
+    KNOWN_TYPE_SIZE_LIMIT = 1024 * 1024;
+    BINARY_CHECK_SAMPLE_SIZE = 32 * 1024;
+    CONTENT_DETECTION_SAMPLE_SIZE = 1024 * 1024;
+    DEFAULT_MAX_PROBLEM_BYTES = 2 * 1024 * 1024;
+    INDEXEDDB_DEFAULT_DB_NAME = "mcard-db";
+    INDEXEDDB_DEFAULT_DB_VERSION = 1;
+    SQLITE_BUSY_TIMEOUT_MS = 5e3;
+    getEnvUrl = (key, fallback) => {
+      try {
+        if (typeof process !== "undefined" && process.env && process.env[key]) {
+          return process.env[key];
+        }
+      } catch (e) {
+      }
+      return fallback;
+    };
+    DEFAULT_OLLAMA_BASE_URL = getEnvUrl("OLLAMA_BASE_URL", "http://localhost:11434");
+    DEFAULT_OTLP_ENDPOINT = getEnvUrl("OTLP_ENDPOINT", "http://localhost:4317");
+    DEFAULT_VLLM_BASE_URL = getEnvUrl("VLLM_BASE_URL", "http://localhost:8000");
+    DEFAULT_LMSTUDIO_BASE_URL = getEnvUrl("LMSTUDIO_BASE_URL", "http://localhost:1234");
+    DEFAULT_SQLJS_WASM_URL = "https://sql.js.org/dist/";
+    DEFAULT_SANDBOX_TIMEOUT_MS = 5e3;
+    DEFAULT_CLM_TIMEOUT_MS = 5e3;
+    DEFAULT_VM_EXECUTION_TIMEOUT_MS = 5e3;
+    LLM_DEFAULT_TIMEOUT_SECS = 120;
+    LLM_DEFAULT_RETRY_COUNT = 3;
+    LLM_DEFAULT_RETRY_DELAY_SECS = 1;
+  }
+});
+
 // src/monads/Maybe.ts
 var Maybe;
 var init_Maybe = __esm({
@@ -2084,424 +1160,6 @@ var init_IndexedDBEngine2 = __esm({
   }
 });
 
-// src/storage/schema_constants.ts
-var MCARD_SCHEMA_SQL, MCARD_VECTOR_SCHEMA_SQL;
-var init_schema_constants = __esm({
-  "src/storage/schema_constants.ts"() {
-    "use strict";
-    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
--- MCard Unified Database Schema (Monadic Core)
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- 
--- STABILITY WARNING: This schema is the invariant "seeding meta-language" for all
--- Domain Specific Languages (DSLs). It must remain as stable as possible.
---
--- THE UNIFICATION THESIS:
--- This design unites three distinct namespaces into a single relational network
--- by leveraging the power of cryptographic hash functions:
--- 1. CONTENT SPACE (Intrinsic Identity): Content-Addressable Storage (CAS).
--- 2. HANDLE SPACE (Reserved Words): Mapping human logic to content hashes.
--- 3. VERSION SPACE (Temporal Evolution): Tracking state transitions via hash history.
---
--- TURING MACHINE ANALOGY (The Infinitely Long Tape):
--- The \`card\` table stores content blobs with unique identities, emulating the 
--- "Infinitely Long Tape" of the Turing Machine formalism. By using relational 
--- queries, this tape can be dynamically constructed and traversed for different 
--- DSLs, providing a flexible substrate for practically all computable languages.
---
--- By using hash values as the universal primitives across content, handles, and 
--- time, we create a "Wordless Book" \u2014 a minimal substrate capable of seeding any 
--- domain-specific knowledge system without requiring schema changes.
---
--- Monadic Mapping (See: Monadic Justification for Schema Design.md):
--- 1. Card    = Monad (Perception/State/Exponent) - Intrinsic Identity
--- 2. Handle  = Registry (Appetition/Reader/Sum) - Mutable Reference
--- 3. Version = History (Harmony/Writer/Product) - Coordinated Evolution
---
--- Version: 3.0.2 (Turing Tape Refinement)
--- Last Updated: 2025-12-20
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
-
-
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- LAYER 1: CORE CONTENT-ADDRESSABLE STORAGE (The Monad / Exponent)
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- The fundamental MCard storage: content-addressed by cryptographic hash.
--- "Each Monad ... mirrors the universe"
-
--- @table card
--- @description Core content-addressable storage table (Monad/State)
--- @column hash    - SHA-256 hash of content (primary key)
--- @column content - The actual content (BLOB for binary safety)
--- @column g_time  - Generation timestamp (ISO 8601)
-CREATE TABLE IF NOT EXISTS card (
-    hash TEXT PRIMARY KEY,
-    content BLOB NOT NULL,
-    g_time TEXT NOT NULL
-);
-
-
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- LAYER 2: HANDLE SYSTEM (Appetition / Sum)
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- The mutable pointer that "desires" to reference new content.
--- "Appetition: the tendency to move to new states"
-
--- @table handle_registry (Monadic Role: Handle)
--- @description Maps human-readable handles to current content hashes
--- @column handle       - UTF-8 handle name (primary key)
--- @column current_hash - FK to card.hash of current version
--- @column created_at   - When handle was first created
--- @column updated_at   - When handle was last updated
-CREATE TABLE IF NOT EXISTS handle_registry (
-    handle TEXT PRIMARY KEY,
-    current_hash TEXT NOT NULL,
-    created_at TEXT NOT NULL,
-    updated_at TEXT NOT NULL,
-    FOREIGN KEY (current_hash) REFERENCES card(hash)
-);
-
--- @index idx_handle_current_hash
--- @description Efficient reverse lookup from hash to handles
-CREATE INDEX IF NOT EXISTS idx_handle_current_hash 
-ON handle_registry(current_hash);
-
--- @table handle_history (Monadic Role: Version / Product)
--- @description Audit trail for handle pointer changes (Pre-Established Harmony)
--- @column id            - Auto-increment primary key
--- @column handle        - The handle that was updated
--- @column previous_hash - Hash it pointed to before update
--- @column changed_at    - When the change occurred
-CREATE TABLE IF NOT EXISTS handle_history (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    handle TEXT NOT NULL,
-    previous_hash TEXT NOT NULL,
-    changed_at TEXT NOT NULL,
-    FOREIGN KEY (handle) REFERENCES handle_registry(handle),
-    FOREIGN KEY (previous_hash) REFERENCES card(hash)
-);
-
--- @index idx_handle_history_handle
--- @description Efficient lookup of history by handle
-CREATE INDEX IF NOT EXISTS idx_handle_history_handle 
-ON handle_history(handle);
-
-
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- LEGACY SUPPORT: FTS5 Documents Table
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- KEPT FOR BACKWARD COMPATIBILITY with existing codebase.
--- New implementations should use mcard_vector_schema.sql -> mcard_fts
-
--- @virtual_table documents
--- @description Legacy FTS table for backward compatibility
--- @note Synced with card table via triggers
-CREATE VIRTUAL TABLE IF NOT EXISTS documents USING fts5(content);
-
-
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- SCHEMA METADATA
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
-
--- @table schema_version
--- @description Tracks schema version for migrations
-CREATE TABLE IF NOT EXISTS schema_version (
-    version TEXT PRIMARY KEY,
-    applied_at TEXT NOT NULL,
-    description TEXT
-);
-
--- Insert current schema version
-INSERT OR IGNORE INTO schema_version (version, applied_at, description)
-VALUES ('3.0.0', datetime('now'), 'Monadic Core Schema (split vectors to mcard_vector_schema.sql)');
-`;
-    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
--- MCard Vector Database Schema (mcard_vectors.db)
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- 
--- This schema defines the structure for "Secondary Qualities" (Extrinsic Embeddings).
--- It is separated from the core mcard.db (Monadic Intrinsic Properties) to ensure:
--- 1. Separation of Concerns (Intrinsic vs Extrinsic)
--- 2. Linearity (Vectors are observer-dependent and large)
--- 3. Upgradability (Embedding models change frequently)
---
--- See: Monadic Justification for Schema Design.md
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
-
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- LAYER 3: VECTOR STORAGE (Semantic Embeddings)
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- Storage for vector embeddings enabling semantic search.
--- Links to content via hash for content-addressing.
-
--- @table mcard_vector_metadata
--- @description Metadata for stored embeddings
--- @column id          - Auto-increment primary key
--- @column hash        - FK to card.hash
--- @column model_name  - Embedding model used (e.g., "nomic-embed-text")
--- @column dimensions  - Vector dimensions
--- @column chunk_index - Index for chunked documents (0 = first/whole)
--- @column chunk_total - Total chunks for this document
--- @column chunk_text  - Preview text for this chunk
--- @column created_at  - When embedding was created
-CREATE TABLE IF NOT EXISTS mcard_vector_metadata (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    hash TEXT NOT NULL,
-    model_name TEXT NOT NULL,
-    dimensions INTEGER NOT NULL,
-    chunk_index INTEGER DEFAULT 0,
-    chunk_total INTEGER DEFAULT 1,
-    chunk_text TEXT,
-    created_at TEXT NOT NULL,
-    UNIQUE(hash, chunk_index)
-);
-
--- @index idx_vector_metadata_hash
--- @description Efficient lookup of embeddings by content hash
-CREATE INDEX IF NOT EXISTS idx_vector_metadata_hash 
-ON mcard_vector_metadata(hash);
-
--- @table mcard_embeddings
--- @description Fallback embedding storage when sqlite-vec is unavailable
--- @column id          - Auto-increment primary key
--- @column metadata_id - FK to mcard_vector_metadata.id
--- @column embedding   - Serialized float32 vector as BLOB
-CREATE TABLE IF NOT EXISTS mcard_embeddings (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    metadata_id INTEGER NOT NULL,
-    embedding BLOB NOT NULL,
-    UNIQUE(metadata_id),
-    FOREIGN KEY (metadata_id) REFERENCES mcard_vector_metadata(id)
-);
-
--- @virtual_table mcard_fts
--- @description Full-text search for hybrid retrieval
--- @note Uses Porter stemming with Unicode support
-CREATE VIRTUAL TABLE IF NOT EXISTS mcard_fts USING fts5(
-    hash,
-    content,
-    tokenize='porter unicode61'
-);
-
--- Note: sqlite-vec virtual table is created dynamically with dimensions:
--- CREATE VIRTUAL TABLE IF NOT EXISTS mcard_vec USING vec0(
---     metadata_id INTEGER PRIMARY KEY,
---     embedding float[\${dimensions}]
--- );
-
-
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- LAYER 4: SEMANTIC VERSIONING (Handle-Vector Bridge)
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- Bridges handles to vector embeddings for semantic version comparison.
--- Enables measuring semantic drift between document versions.
-
--- @table handle_version_vectors
--- @description Links handle versions to their semantic embeddings
--- @column id                        - Auto-increment primary key
--- @column handle                    - FK to handle_registry.handle
--- @column hash                      - FK to card.hash (this version)
--- @column parent_hash               - FK to card.hash (previous version)
--- @column version_order             - 0 = current, 1 = previous, etc.
--- @column is_current                - TRUE if this is the current version
--- @column embedding_id              - FK to mcard_vector_metadata.id
--- @column semantic_delta_from_parent - Cosine similarity to parent [-1, 1]
--- @column upgrade_type              - Classification: 'trivial' | 'minor' | 'major' | 'breaking'
--- @column created_at                - When this version was linked
-CREATE TABLE IF NOT EXISTS handle_version_vectors (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    handle TEXT NOT NULL,
-    hash TEXT NOT NULL,
-    parent_hash TEXT,
-    version_order INTEGER NOT NULL,
-    is_current BOOLEAN DEFAULT FALSE,
-    embedding_id INTEGER,
-    semantic_delta_from_parent REAL,
-    upgrade_type TEXT,
-    created_at TEXT NOT NULL,
-    UNIQUE(handle, hash),
-    FOREIGN KEY (embedding_id) REFERENCES mcard_vector_metadata(id)
-);
-
--- @index idx_hvv_handle
--- @description Efficient lookup of versions by handle
-CREATE INDEX IF NOT EXISTS idx_hvv_handle 
-ON handle_version_vectors(handle);
-
--- @index idx_hvv_hash
--- @description Efficient lookup of versions by hash
-CREATE INDEX IF NOT EXISTS idx_hvv_hash 
-ON handle_version_vectors(hash);
-
--- @index idx_hvv_current
--- @description Efficient lookup of current versions
-CREATE INDEX IF NOT EXISTS idx_hvv_current 
-ON handle_version_vectors(is_current);
-
--- @index idx_hvv_parent
--- @description Efficient lookup by parent hash
-CREATE INDEX IF NOT EXISTS idx_hvv_parent 
-ON handle_version_vectors(parent_hash);
-
--- @table version_similarity_cache
--- @description Precomputed pairwise similarities for performance
--- @column id               - Auto-increment primary key
--- @column handle           - Handle these versions belong to
--- @column hash_a           - First version hash
--- @column hash_b           - Second version hash
--- @column similarity_score - Cosine similarity [-1, 1]
--- @column distance_euclidean - L2 distance [0, \u221E)
--- @column computed_at      - When similarity was computed
-CREATE TABLE IF NOT EXISTS version_similarity_cache (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    handle TEXT NOT NULL,
-    hash_a TEXT NOT NULL,
-    hash_b TEXT NOT NULL,
-    similarity_score REAL NOT NULL,
-    distance_euclidean REAL,
-    computed_at TEXT NOT NULL,
-    UNIQUE(handle, hash_a, hash_b)
-);
-
--- @index idx_vsc_handle
--- @description Efficient lookup of cached similarities by handle
-CREATE INDEX IF NOT EXISTS idx_vsc_handle 
-ON version_similarity_cache(handle);
-
-
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- LAYER 5: KNOWLEDGE GRAPH (GraphRAG)
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- Storage for extracted knowledge graph entities and relationships.
-
--- @table graph_entities
--- @description Nodes in the knowledge graph
--- @column id          - Auto-increment primary key
--- @column name        - Entity name
--- @column type        - Entity type (e.g., "Person", "Organization")
--- @column description - Optional description
--- @column source_hash - FK to card.hash where entity was extracted
--- @column embedding   - Optional entity embedding
--- @column created_at  - When entity was created
-CREATE TABLE IF NOT EXISTS graph_entities (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    name TEXT NOT NULL,
-    type TEXT NOT NULL,
-    description TEXT,
-    source_hash TEXT NOT NULL,
-    embedding BLOB,
-    created_at TEXT NOT NULL,
-    UNIQUE(name, type, source_hash)
-);
-
--- @index idx_entity_name
--- @description Efficient entity lookup by name
-CREATE INDEX IF NOT EXISTS idx_entity_name 
-ON graph_entities(name);
-
--- @index idx_entity_type
--- @description Efficient entity lookup by type
-CREATE INDEX IF NOT EXISTS idx_entity_type 
-ON graph_entities(type);
-
--- @index idx_entity_source
--- @description Efficient entity lookup by source document
-CREATE INDEX IF NOT EXISTS idx_entity_source 
-ON graph_entities(source_hash);
-
--- @table graph_relationships
--- @description Edges in the knowledge graph
--- @column id               - Auto-increment primary key
--- @column source_entity_id - FK to graph_entities.id (from)
--- @column target_entity_id - FK to graph_entities.id (to)
--- @column relationship     - Relationship type/label
--- @column description      - Optional description
--- @column weight           - Relationship strength
--- @column source_hash      - FK to card.hash where relationship was extracted
--- @column created_at       - When relationship was created
-CREATE TABLE IF NOT EXISTS graph_relationships (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    source_entity_id INTEGER NOT NULL,
-    target_entity_id INTEGER NOT NULL,
-    relationship TEXT NOT NULL,
-    description TEXT,
-    weight REAL DEFAULT 1.0,
-    source_hash TEXT NOT NULL,
-    created_at TEXT NOT NULL,
-    UNIQUE(source_entity_id, target_entity_id, relationship, source_hash),
-    FOREIGN KEY (source_entity_id) REFERENCES graph_entities(id),
-    FOREIGN KEY (target_entity_id) REFERENCES graph_entities(id)
-);
-
--- @index idx_rel_source
--- @description Efficient lookup of relationships by source entity
-CREATE INDEX IF NOT EXISTS idx_rel_source 
-ON graph_relationships(source_entity_id);
-
--- @index idx_rel_target
--- @description Efficient lookup of relationships by target entity
-CREATE INDEX IF NOT EXISTS idx_rel_target 
-ON graph_relationships(target_entity_id);
-
--- @table graph_communities
--- @description Hierarchical community summaries (GraphRAG)
--- @column id                  - Auto-increment primary key
--- @column level               - Hierarchy level (0 = leaf)
--- @column title               - Community title
--- @column summary             - AI-generated summary
--- @column embedding           - Community embedding
--- @column member_entity_ids   - JSON array of entity IDs
--- @column parent_community_id - FK to parent community
--- @column created_at          - When community was created
-CREATE TABLE IF NOT EXISTS graph_communities (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    level INTEGER NOT NULL DEFAULT 0,
-    title TEXT,
-    summary TEXT NOT NULL,
-    embedding BLOB,
-    member_entity_ids TEXT,
-    parent_community_id INTEGER,
-    created_at TEXT NOT NULL,
-    FOREIGN KEY (parent_community_id) REFERENCES graph_communities(id)
-);
-
--- @index idx_community_level
--- @description Efficient lookup of communities by level
-CREATE INDEX IF NOT EXISTS idx_community_level 
-ON graph_communities(level);
-
--- @table graph_extractions
--- @description Tracks which documents have been processed for entity extraction
--- @column hash               - FK to card.hash (primary key)
--- @column entity_count       - Number of entities extracted
--- @column relationship_count - Number of relationships extracted
--- @column extracted_at       - When extraction was performed
-CREATE TABLE IF NOT EXISTS graph_extractions (
-    hash TEXT PRIMARY KEY,
-    entity_count INTEGER DEFAULT 0,
-    relationship_count INTEGER DEFAULT 0,
-    extracted_at TEXT NOT NULL
-);
-
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
--- SCHEMA METADATA (Vector DB)
--- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
-
--- @table schema_version
--- @description Tracks schema version for migrations
-CREATE TABLE IF NOT EXISTS vector_schema_version (
-    version TEXT PRIMARY KEY,
-    applied_at TEXT NOT NULL,
-    description TEXT
-);
-
--- Insert current schema version
-INSERT OR IGNORE INTO vector_schema_version (version, applied_at, description)
-VALUES ('1.0.0', datetime('now'), 'Initial MCard Vector Schema');
-`;
-  }
-});
-
 // src/storage/schema.ts
 function getSchemaInstance() {
   return MCardSchema.getInstance();
@@ -2511,11 +1169,11 @@ function initCoreSchemas(db) {
   schema.initCoreTables(db);
   schema.initHandleTables(db);
 }
-var TABLE_LAYERS, MCardSchema, CARD_TABLE_SCHEMA, HANDLE_REGISTRY_SCHEMA, HANDLE_HISTORY_SCHEMA, HANDLE_INDEX_SCHEMA, VECTOR_METADATA_SCHEMA, VECTOR_METADATA_INDEX, VECTOR_EMBEDDINGS_SCHEMA, VECTOR_FTS_SCHEMA, HANDLE_VERSION_VECTORS_SCHEMA, HANDLE_VERSION_VECTORS_INDEXES, VERSION_SIMILARITY_CACHE_SCHEMA, VERSION_SIMILARITY_CACHE_INDEX, GRAPH_ENTITY_SCHEMA, GRAPH_ENTITY_INDEX_NAME, GRAPH_ENTITY_INDEX_TYPE, GRAPH_ENTITY_INDEX_SOURCE, GRAPH_RELATIONSHIP_SCHEMA, GRAPH_RELATIONSHIP_INDEX_SOURCE, GRAPH_RELATIONSHIP_INDEX_TARGET, GRAPH_COMMUNITY_SCHEMA, GRAPH_COMMUNITY_INDEX_LEVEL, GRAPH_EXTRACTION_SCHEMA, CORE_SCHEMAS;
+var import_mcard_wasm2, TABLE_LAYERS, MCardSchema, CARD_TABLE_SCHEMA, HANDLE_REGISTRY_SCHEMA, HANDLE_HISTORY_SCHEMA, HANDLE_INDEX_SCHEMA, VECTOR_METADATA_SCHEMA, VECTOR_METADATA_INDEX, VECTOR_EMBEDDINGS_SCHEMA, VECTOR_FTS_SCHEMA, HANDLE_VERSION_VECTORS_SCHEMA, HANDLE_VERSION_VECTORS_INDEXES, VERSION_SIMILARITY_CACHE_SCHEMA, VERSION_SIMILARITY_CACHE_INDEX, GRAPH_ENTITY_SCHEMA, GRAPH_ENTITY_INDEX_NAME, GRAPH_ENTITY_INDEX_TYPE, GRAPH_ENTITY_INDEX_SOURCE, GRAPH_RELATIONSHIP_SCHEMA, GRAPH_RELATIONSHIP_INDEX_SOURCE, GRAPH_RELATIONSHIP_INDEX_TARGET, GRAPH_COMMUNITY_SCHEMA, GRAPH_COMMUNITY_INDEX_LEVEL, GRAPH_EXTRACTION_SCHEMA, CORE_SCHEMAS;
 var init_schema = __esm({
   "src/storage/schema.ts"() {
     "use strict";
-    init_schema_constants();
+    import_mcard_wasm2 = require("mcard-wasm");
     TABLE_LAYERS = {
       // Layer 1: Core
       "card": "core",
@@ -2565,10 +1223,11 @@ var init_schema = __esm({
       }
       load() {
         if (this.loaded) return;
-        this.schemaPath = "IN_MEMORY_CONSTANTS";
-        this.rawSql = MCARD_SCHEMA_SQL;
-        if (MCARD_VECTOR_SCHEMA_SQL) {
-          this.rawSql += "\n\n" + MCARD_VECTOR_SCHEMA_SQL;
+        this.schemaPath = "WASM_MEMORY_SPACE";
+        this.rawSql = (0, import_mcard_wasm2.get_core_schema)();
+        const vectorSql = (0, import_mcard_wasm2.get_vector_schema)();
+        if (vectorSql) {
+          this.rawSql += "\n\n" + vectorSql;
         }
         this.statements = this.parseStatements(this.rawSql);
         for (const stmt of this.statements) {
@@ -3571,7 +2230,7 @@ async function readFileSafely(filePath, options = {}) {
   const stats = await fs.stat(filePath);
   if (stats.size > MAX_FILE_SIZE2) throw new Error(`File too large: ${stats.size}`);
   const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), READ_TIMEOUT_MS);
+  const timeout = setTimeout(() => controller.abort(), READ_TIMEOUT_MS2);
   try {
     const handle = await fs.open(filePath, "r");
     try {
@@ -3634,16 +2293,17 @@ async function processFileContent(filePath, options = {}) {
     size: rawContent.length
   };
 }
-var crypto2, fs, path, MAX_FILE_SIZE2, READ_TIMEOUT_MS;
+var crypto2, fs, path, MAX_FILE_SIZE2, READ_TIMEOUT_MS2;
 var init_FileIO = __esm({
   "src/FileIO.ts"() {
     "use strict";
     crypto2 = __toESM(require("crypto"), 1);
     fs = __toESM(require("fs/promises"), 1);
     path = __toESM(require("path"), 1);
+    init_constants();
     init_ContentTypeInterpreter();
-    MAX_FILE_SIZE2 = 50 * 1024 * 1024;
-    READ_TIMEOUT_MS = 5e3;
+    MAX_FILE_SIZE2 = MAX_FILE_SIZE;
+    READ_TIMEOUT_MS2 = READ_TIMEOUT_MS;
   }
 });
 
@@ -3664,13 +2324,13 @@ async function processAndStoreFile(filePath, collection, options = {}) {
     let fileInfo;
     if (await isProblematicFile(filePath)) {
       if (!allowProblematic) {
-        console.warn(`Skipping problematic file: ${filePath}`);
+        Logger.warn(`Skipping problematic file: ${filePath}`);
         return null;
       }
       const extension = path2.extname(filePath).toLowerCase();
       const isKnownType = ContentTypeInterpreter.isKnownLongLineExtension(extension);
       const wrapWidth = isKnownType ? WRAP_WIDTH_KNOWN : WRAP_WIDTH_DEFAULT;
-      console.warn(`Problematic file detected, processing as safe text: ${filePath}`);
+      Logger.warn(`Problematic file detected, processing as safe text: ${filePath}`);
       try {
         const streamed = await streamReadNormalizedText(filePath, {
           byteCap: maxBytesOnProblem,
@@ -3689,7 +2349,7 @@ async function processAndStoreFile(filePath, collection, options = {}) {
           wrapWidth
         };
       } catch (e) {
-        console.warn(`Safe text processing failed, falling back to capped binary: ${filePath}`);
+        Logger.warn(`Safe text processing failed, falling back to capped binary: ${filePath}`, e);
         fileInfo = await processFileContent(filePath, {
           forceBinary: true,
           allowPathological: true,
@@ -3697,15 +2357,13 @@ async function processAndStoreFile(filePath, collection, options = {}) {
         });
       }
     } else {
-      console.log(`Processing file: ${filePath}`);
+      Logger.info(`Processing file: ${filePath}`);
       fileInfo = await processFileContent(filePath);
     }
     if (!fileInfo) return null;
     const content = fileInfo.content;
     if (!content || typeof content === "string" && content.length === 0 || content instanceof Uint8Array && content.length === 0) {
-      if (process.env.DEBUG) {
-        console.log(`Skipping empty file: ${filePath} (empty files cannot be stored as MCards)`);
-      }
+      Logger.debug(`Skipping empty file: ${filePath} (empty files cannot be stored as MCards)`);
       return {
         hash: "",
         contentType: fileInfo.mimeType,
@@ -3733,11 +2391,9 @@ async function processAndStoreFile(filePath, collection, options = {}) {
               await collection.addWithHandle(mcard, relPath);
               registered = true;
             } catch (e2) {
-              if (process.env.DEBUG) {
-                console.log(
-                  `Handle name '${handle}' already in use (common for files like README.md, LICENSE). MCard stored successfully with hash ${mcard.hash.slice(0, 8)}... (accessible by hash, not by handle)`
-                );
-              }
+              Logger.debug(
+                `Handle name '${handle}' already in use (common for files like README.md, LICENSE). MCard stored successfully with hash ${mcard.hash.slice(0, 8)}... (accessible by hash, not by handle)`
+              );
             }
           }
         }
@@ -3745,6 +2401,7 @@ async function processAndStoreFile(filePath, collection, options = {}) {
           try {
             await collection.add(mcard);
           } catch (e3) {
+            Logger.warn(`Hash fallback also failed for ${handle}:`, e3);
           }
         }
       }
@@ -3762,7 +2419,7 @@ async function processAndStoreFile(filePath, collection, options = {}) {
     if (metadataOnly && isProblematic) result.metadataOnly = true;
     return result;
   } catch (e) {
-    console.error(`Error processing ${filePath}:`, e);
+    Logger.error(`Error processing ${filePath}:`, e);
     return null;
   }
 }
@@ -3804,7 +2461,7 @@ async function loadFileToCollection(targetPath, collection, options = {}) {
     directoriesCount: uniqueDirs.size,
     directoryLevels: maxDepth
   };
-  console.log(`About to process ${files.length} files`);
+  Logger.info(`About to process ${files.length} files`);
   for (const file of files) {
     const result = await processAndStoreFile(file, collection, {
       allowProblematic: includeProblematic,
@@ -3816,7 +2473,7 @@ async function loadFileToCollection(targetPath, collection, options = {}) {
   }
   return { metrics, results };
 }
-var fs2, path2, DEFAULT_MAX_PROBLEM_BYTES2, WRAP_WIDTH_KNOWN, WRAP_WIDTH_DEFAULT;
+var fs2, path2, DEFAULT_MAX_PROBLEM_BYTES2, WRAP_WIDTH_KNOWN, WRAP_WIDTH_DEFAULT, Logger;
 var init_Loader = __esm({
   "src/Loader.ts"() {
     "use strict";
@@ -3828,6 +2485,14 @@ var init_Loader = __esm({
     DEFAULT_MAX_PROBLEM_BYTES2 = 2 * 1024 * 1024;
     WRAP_WIDTH_KNOWN = 1e3;
     WRAP_WIDTH_DEFAULT = 80;
+    Logger = {
+      info: (...args) => console.log("[Loader]", ...args),
+      warn: (...args) => console.warn("[Loader]", ...args),
+      error: (...args) => console.error("[Loader]", ...args),
+      debug: (...args) => {
+        if (process.env.DEBUG) console.log("[Loader]", ...args);
+      }
+    };
   }
 });
 
@@ -3836,6 +2501,7 @@ var DEFAULT_PROVIDER, LLM_PROVIDERS, DEFAULT_LLM_CONFIG, RESPONSE_FORMATS, LLMCo
 var init_Config = __esm({
   "src/ptr/llm/Config.ts"() {
     "use strict";
+    init_constants();
     DEFAULT_PROVIDER = "ollama";
     LLM_PROVIDERS = {
       "ollama": {
@@ -3893,11 +2559,11 @@ var init_Config = __esm({
       max_tokens: 2048,
       top_p: 1,
       top_k: 40,
-      timeout: 120,
+      timeout: LLM_DEFAULT_TIMEOUT_SECS,
       stream: false,
       response_format: "text",
-      retry_count: 3,
-      retry_delay: 1
+      retry_count: LLM_DEFAULT_RETRY_COUNT,
+      retry_delay: LLM_DEFAULT_RETRY_DELAY_SECS
     };
     RESPONSE_FORMATS = ["text", "json", "structured", "markdown"];
     LLMConfig = class _LLMConfig {
@@ -4056,6 +2722,7 @@ var http, https, OllamaProvider;
 var init_OllamaProvider = __esm({
   "src/ptr/llm/providers/OllamaProvider.ts"() {
     "use strict";
+    init_constants();
     init_LLMProvider();
     init_Either();
     init_Config();
@@ -4066,7 +2733,7 @@ var init_OllamaProvider = __esm({
       base_url;
       timeout;
       config;
-      constructor(base_url = null, timeout = 180) {
+      constructor(base_url = null, timeout = LLM_DEFAULT_TIMEOUT_SECS) {
         super();
         this.config = LLM_PROVIDERS["ollama"];
         this.base_url = (base_url || this.config.base_url).replace(/\/$/, "");
@@ -4085,6 +2752,11 @@ var init_OllamaProvider = __esm({
           timeout: this.timeout
         };
         return new Promise((resolve10) => {
+          let payload;
+          if (data) {
+            payload = JSON.stringify(data);
+            options.headers["Content-Length"] = Buffer.byteLength(payload);
+          }
           const req = client.request(url, options, (res) => {
             let body = "";
             res.on("data", (chunk) => {
@@ -4122,18 +2794,21 @@ var init_OllamaProvider = __esm({
             req.destroy();
             resolve10(Either.left(`Ollama request timed out after ${this.timeout}ms`));
           });
-          if (data) {
-            req.write(JSON.stringify(data));
+          if (payload) {
+            req.write(payload);
           }
           req.end();
         });
       }
-      async complete(prompt, params) {
+      async complete(prompt, params, images) {
         const data = {
           model: typeof params.model === "string" ? params.model : this.config.default_model,
           prompt,
           stream: false
         };
+        if (images && images.length > 0) {
+          data.images = images;
+        }
         if (params.options) {
           data.options = params.options;
         }
@@ -4273,7 +2948,7 @@ var init_WebLLMProvider = __esm({
           return Either.left(`WebLLM init failed: ${error.message || String(e)}`);
         }
       }
-      async complete(prompt, params) {
+      async complete(prompt, params, images) {
         const model = typeof params.model === "string" ? params.model : this.config.default_model;
         const engineResult = await this._get_engine(model);
         if (engineResult.isLeft) return Either.left(engineResult.left);
@@ -4340,6 +3015,7 @@ var http2, https2, MLCLLMProvider;
 var init_MLCLLMProvider = __esm({
   "src/ptr/llm/providers/MLCLLMProvider.ts"() {
     "use strict";
+    init_constants();
     init_LLMProvider();
     init_Either();
     init_Config();
@@ -4350,7 +3026,7 @@ var init_MLCLLMProvider = __esm({
       base_url;
       timeout;
       config;
-      constructor(base_url = null, timeout = 120) {
+      constructor(base_url = null, timeout = LLM_DEFAULT_TIMEOUT_SECS) {
         super();
         this.config = LLM_PROVIDERS["mlc-llm"];
         this.base_url = (base_url || this.config.base_url).replace(/\/$/, "");
@@ -4415,10 +3091,10 @@ var init_MLCLLMProvider = __esm({
           req.end();
         });
       }
-      async complete(prompt, params) {
+      async complete(prompt, params, images) {
         const data = {
-          model: params.model || this.config.default_model,
-          prompt,
+          model: typeof params.model === "string" ? params.model : this.config.default_model,
+          messages: [{ role: "user", content: prompt }],
           max_tokens: params.max_tokens,
           temperature: params.temperature,
           top_p: params.top_p,
@@ -4488,7 +3164,7 @@ __export(LLMRuntime_exports, {
   get_provider: () => get_provider,
   promptMonad: () => promptMonad
 });
-function get_provider(provider_name = DEFAULT_PROVIDER, base_url = null, timeout = 120) {
+function get_provider(provider_name = DEFAULT_PROVIDER, base_url = null, timeout = LLM_DEFAULT_TIMEOUT_SECS) {
   if (provider_name === "ollama") {
     return new OllamaProvider(base_url, timeout);
   }
@@ -4542,6 +3218,7 @@ var LLMRuntime;
 var init_LLMRuntime = __esm({
   "src/ptr/llm/LLMRuntime.ts"() {
     "use strict";
+    init_constants();
     init_Config();
     init_OllamaProvider();
     init_WebLLMProvider();
@@ -4571,32 +3248,45 @@ var init_LLMRuntime = __esm({
           this._provider = get_provider(llmConfig.provider, llmConfig.endpoint_url, llmConfig.timeout);
         }
         let prompt = "";
+        let images;
         if (typeof context === "string") {
           prompt = context;
-        } else {
-          prompt = JSON.stringify(context);
+        } else if (context && typeof context === "object") {
+          const ctx = context;
+          if (typeof ctx.prompt === "string") {
+            prompt = ctx.prompt;
+            if (Array.isArray(ctx.images)) {
+              images = ctx.images;
+            }
+          } else {
+            prompt = JSON.stringify(context);
+          }
         }
         let result;
         if (llmConfig.system_prompt) {
-          result = await this._execute_chat(prompt, llmConfig);
+          result = await this._execute_chat(prompt, llmConfig, images);
         } else {
-          result = await this._execute_completion(prompt, llmConfig);
+          result = await this._execute_completion(prompt, llmConfig, images);
         }
         if (result.isLeft) {
           return `Error: ${result.left}`;
         }
         return this._format_response(result.right, llmConfig);
       }
-      async _execute_completion(prompt, config) {
+      async _execute_completion(prompt, config, images) {
         const params = config.to_provider_params();
-        return this.provider.complete(prompt, params);
+        return this.provider.complete(prompt, params, images);
       }
-      async _execute_chat(prompt, config) {
+      async _execute_chat(prompt, config, images) {
         const messages = [];
         if (config.system_prompt) {
           messages.push({ role: "system", content: config.system_prompt });
         }
-        messages.push({ role: "user", content: prompt });
+        const userMsg = { role: "user", content: prompt };
+        if (images && images.length > 0) {
+          userMsg.images = images;
+        }
+        messages.push(userMsg);
         if (config.assistant_instruction) {
           messages.push({ role: "assistant", content: config.assistant_instruction });
         }
@@ -5614,6 +4304,7 @@ var init_javascript = __esm({
     vm = __toESM(require("vm"), 1);
     child_process2 = __toESM(require("child_process"), 1);
     util2 = __toESM(require("util"), 1);
+    init_constants();
     init_base();
     init_FileSystemUtils();
     writeFile2 = util2.promisify(fs4.writeFile);
@@ -5665,7 +4356,7 @@ var init_javascript = __esm({
         const codeRunnable = code + "\nresult;";
         const script = new vm.Script(codeRunnable);
         const vmContext = vm.createContext(sandbox);
-        const executionResult = script.runInContext(vmContext, { timeout: 5e3 });
+        const executionResult = script.runInContext(vmContext, { timeout: DEFAULT_VM_EXECUTION_TIMEOUT_MS });
         return sandbox.result !== void 0 ? sandbox.result : executionResult;
       }
       /**
@@ -5675,7 +4366,9 @@ var init_javascript = __esm({
         const contextStr = JSON.stringify(context);
         const projectRoot = findProjectRoot();
         const wrapper = `
-const process = require('process');
+import process from 'process';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
 const context = JSON.parse(process.argv[2]);
 global.context = context;
 let result;
@@ -5768,6 +4461,35 @@ Stdout: ${execError.stdout.toString()}` : "";
        * Create Python wrapper script with entry point invocation.
        */
       createWrapper(code, entryPoint) {
+        let userLogic = code;
+        let actualEntryPoint = entryPoint;
+        if (code.startsWith("module://")) {
+          const withoutPrefix = code.substring(9);
+          const colonIndex = withoutPrefix.indexOf(":");
+          let modulePath = withoutPrefix;
+          let moduleFunc = "";
+          if (colonIndex !== -1) {
+            modulePath = withoutPrefix.substring(0, colonIndex);
+            moduleFunc = withoutPrefix.substring(colonIndex + 1);
+          }
+          if (modulePath) {
+            if (moduleFunc) {
+              actualEntryPoint = moduleFunc;
+            }
+            userLogic = `
+import importlib
+try:
+    _mod = importlib.import_module('${modulePath}')
+    for _k in dir(_mod):
+        if not _k.startswith('_'):
+            globals()[_k] = getattr(_mod, _k)
+except Exception as e:
+    import sys, json
+    print(json.dumps({"error": f"Failed to import module ${modulePath}: {e}"}))
+    sys.exit(1)
+`;
+          }
+        }
         return `
 import sys
 import json
@@ -5784,7 +4506,7 @@ except:
     pass
 
 # User logic
-${code}
+${userLogic}
 
 # Entry point invocation
 def _is_arg_error(e):
@@ -5793,10 +4515,10 @@ def _is_arg_error(e):
 
 try:
     fn = None
-    if '${entryPoint}' in dir():
-        fn = ${entryPoint}
-    elif '${entryPoint}' in globals():
-        fn = globals()['${entryPoint}']
+    if '${actualEntryPoint}' in dir():
+        fn = locals()['${actualEntryPoint}']
+    elif '${actualEntryPoint}' in globals():
+        fn = globals()['${actualEntryPoint}']
 
     if fn is not None:
         try:
@@ -6093,6 +4815,34 @@ var init_loader = __esm({
   }
 });
 
+// src/ptr/node/NetworkConfig.ts
+var HTTP_DEFAULT_MAX_ATTEMPTS, HTTP_DEFAULT_BACKOFF, HTTP_DEFAULT_BASE_DELAY_MS, HTTP_DEFAULT_MAX_DELAY_MS, HTTP_DEFAULT_TIMEOUT_MS, HTTP_DEFAULT_CACHE_TTL_SECONDS, RATE_LIMIT_DEFAULT_TOKENS_PER_SECOND, RATE_LIMIT_DEFAULT_MAX_BURST, RATE_LIMIT_WAIT_INTERVAL_MS, NETWORK_DEFAULT_LISTEN_PORT, NETWORK_DEFAULT_SIGNALING_MAX_PORT_TRIES, NETWORK_SIGNALING_PORT_RELEASE_WAIT_MS, NETWORK_DEFAULT_HOST, NETWORK_DEFAULT_ORCHESTRATOR_SLEEP_MS, WEBSOCKET_SERVER_START_WAIT_MS, STATIC_SERVER_START_WAIT_MS, PROCESS_TERMINATE_WAIT_MS, SESSION_RECORD_DEFAULT_MAX_BUFFER_SIZE, WEBRTC_DEFAULT_TIMEOUT_MS, WEBRTC_DEFAULT_MOCK_DELAY_MS;
+var init_NetworkConfig = __esm({
+  "src/ptr/node/NetworkConfig.ts"() {
+    "use strict";
+    HTTP_DEFAULT_MAX_ATTEMPTS = 1;
+    HTTP_DEFAULT_BACKOFF = "exponential";
+    HTTP_DEFAULT_BASE_DELAY_MS = 1e3;
+    HTTP_DEFAULT_MAX_DELAY_MS = 3e4;
+    HTTP_DEFAULT_TIMEOUT_MS = 3e4;
+    HTTP_DEFAULT_CACHE_TTL_SECONDS = 300;
+    RATE_LIMIT_DEFAULT_TOKENS_PER_SECOND = 10;
+    RATE_LIMIT_DEFAULT_MAX_BURST = 20;
+    RATE_LIMIT_WAIT_INTERVAL_MS = 100;
+    NETWORK_DEFAULT_LISTEN_PORT = 3e3;
+    NETWORK_DEFAULT_SIGNALING_MAX_PORT_TRIES = 10;
+    NETWORK_SIGNALING_PORT_RELEASE_WAIT_MS = 500;
+    NETWORK_DEFAULT_HOST = "localhost";
+    NETWORK_DEFAULT_ORCHESTRATOR_SLEEP_MS = 1e3;
+    WEBSOCKET_SERVER_START_WAIT_MS = 3e3;
+    STATIC_SERVER_START_WAIT_MS = 1500;
+    PROCESS_TERMINATE_WAIT_MS = 500;
+    SESSION_RECORD_DEFAULT_MAX_BUFFER_SIZE = 5;
+    WEBRTC_DEFAULT_TIMEOUT_MS = 3e4;
+    WEBRTC_DEFAULT_MOCK_DELAY_MS = 100;
+  }
+});
+
 // src/ptr/node/P2PChatSession.ts
 var P2PChatSession;
 var init_P2PChatSession = __esm({
@@ -6231,17 +4981,17 @@ function killProcessOnPort(port) {
   return new Promise((resolve10) => {
     (0, import_child_process.exec)(`lsof -ti:${port} | xargs kill -9 2>/dev/null`, (error) => {
       if (error) {
-        console.log(`[Signal] No existing process on port ${port} to kill`);
+        Logger2.info(`No existing process on port ${port} to kill`);
       } else {
-        console.log(`[Signal] Killed existing process on port ${port}`);
+        Logger2.info(`Killed existing process on port ${port}`);
       }
-      setTimeout(resolve10, 500);
+      setTimeout(resolve10, NETWORK_SIGNALING_PORT_RELEASE_WAIT_MS);
     });
   });
 }
 async function createSignalingServer(config = {}) {
-  const startPort = config.port || 3e3;
-  const maxTries = config.maxPortTries || 10;
+  const startPort = config.port || NETWORK_DEFAULT_LISTEN_PORT;
+  const maxTries = config.maxPortTries || NETWORK_DEFAULT_SIGNALING_MAX_PORT_TRIES;
   const autoFindPort = config.autoFindPort !== false;
   const clients = /* @__PURE__ */ new Map();
   const messageBuffer = /* @__PURE__ */ new Map();
@@ -6272,7 +5022,7 @@ async function createSignalingServer(config = {}) {
         res.end("Missing peer_id");
         return;
       }
-      console.log(`[Signal] Client connected: ${peerId}`);
+      Logger2.info(`Client connected: ${peerId}`);
       res.writeHead(200, {
         "Content-Type": "text/event-stream",
         "Cache-Control": "no-cache",
@@ -6292,7 +5042,7 @@ async function createSignalingServer(config = {}) {
         messageBuffer.delete(peerId);
       }
       req.on("close", () => {
-        console.log(`[Signal] Client disconnected: ${peerId}`);
+        Logger2.info(`Client disconnected: ${peerId}`);
         clearInterval(keepAlive);
         clients.delete(peerId);
       });
@@ -6310,7 +5060,7 @@ async function createSignalingServer(config = {}) {
             res.end("Missing target");
             return;
           }
-          console.log(`[Signal] Relaying ${msg.type} to ${target}`);
+          Logger2.info(`Relaying ${msg.type} to ${target}`);
           if (clients.has(target)) {
             clients.get(target).write(`data: ${JSON.stringify(msg)}
 
@@ -6325,7 +5075,7 @@ async function createSignalingServer(config = {}) {
           res.writeHead(200);
           res.end("Sent");
         } catch (e) {
-          console.error(e);
+          Logger2.error(`Failed to handle generic post-signal error`, e);
           res.writeHead(500);
           res.end(String(e));
         }
@@ -6351,7 +5101,7 @@ async function createSignalingServer(config = {}) {
           resolve10();
         });
       });
-      console.log(`[Signal] Server running on port ${port}`);
+      Logger2.info(`Server running on port ${port}`);
       return {
         success: true,
         port,
@@ -6361,7 +5111,7 @@ async function createSignalingServer(config = {}) {
     } catch (err) {
       server.removeAllListeners("error");
       if (attempt === 0 && autoFindPort) {
-        console.log(`[Signal] Port ${port} in use, trying to kill existing process...`);
+        Logger2.info(`Port ${port} in use, trying to kill existing process...`);
         await killProcessOnPort(port);
         try {
           await new Promise((resolve10, reject) => {
@@ -6371,7 +5121,7 @@ async function createSignalingServer(config = {}) {
               resolve10();
             });
           });
-          console.log(`[Signal] Server running on port ${port} (after kill)`);
+          Logger2.info(`Server running on port ${port} (after kill)`);
           return {
             success: true,
             port,
@@ -6388,7 +5138,7 @@ async function createSignalingServer(config = {}) {
           error: `Port ${port} is already in use`
         };
       }
-      console.log(`[Signal] Port ${port} still in use, trying next...`);
+      Logger2.info(`Port ${port} still in use, trying next...`);
     }
   }
   return {
@@ -6396,12 +5146,18 @@ async function createSignalingServer(config = {}) {
     error: `Could not find available port after ${maxTries} attempts starting from ${startPort}`
   };
 }
-var import_http, import_child_process;
+var import_http, import_child_process, Logger2;
 var init_SignalingServer = __esm({
   "src/ptr/node/SignalingServer.ts"() {
     "use strict";
     import_http = require("http");
     import_child_process = require("child_process");
+    init_NetworkConfig();
+    Logger2 = {
+      info: (...args) => console.log("[Signal]", ...args),
+      warn: (...args) => console.warn("[Signal]", ...args),
+      error: (...args) => console.error("[Signal]", ...args)
+    };
   }
 });
 
@@ -6589,10 +5345,11 @@ var init_NetworkInfrastructure = __esm({
   "src/ptr/node/network/NetworkInfrastructure.ts"() {
     "use strict";
     init_MCard();
+    init_NetworkConfig();
     RateLimiter = class {
       limits;
       defaultLimit;
-      constructor(tokensPerSecond = 10, maxBurst = 20) {
+      constructor(tokensPerSecond = RATE_LIMIT_DEFAULT_TOKENS_PER_SECOND, maxBurst = RATE_LIMIT_DEFAULT_MAX_BURST) {
         this.limits = /* @__PURE__ */ new Map();
         this.defaultLimit = { tokensPerSecond, maxBurst };
       }
@@ -6622,7 +5379,7 @@ var init_NetworkInfrastructure = __esm({
        */
       async waitFor(domain) {
         while (!this.check(domain)) {
-          await new Promise((resolve10) => setTimeout(resolve10, 100));
+          await new Promise((resolve10) => setTimeout(resolve10, RATE_LIMIT_WAIT_INTERVAL_MS));
         }
       }
     };
@@ -6711,6 +5468,7 @@ var HttpClient;
 var init_HttpClient = __esm({
   "src/ptr/node/network/HttpClient.ts"() {
     "use strict";
+    init_NetworkConfig();
     init_MCard();
     init_NetworkInfrastructure();
     HttpClient = class {
@@ -6735,16 +5493,16 @@ var init_HttpClient = __esm({
         const domain = fetchUrl.hostname;
         await this.rateLimiter.waitFor(domain);
         const retryConfig = config.retry || {
-          max_attempts: 1,
-          backoff: "exponential",
-          base_delay: 1e3,
-          max_delay: 3e4
+          max_attempts: HTTP_DEFAULT_MAX_ATTEMPTS,
+          backoff: HTTP_DEFAULT_BACKOFF,
+          base_delay: HTTP_DEFAULT_BASE_DELAY_MS,
+          max_delay: HTTP_DEFAULT_MAX_DELAY_MS
         };
         let lastError = null;
         let lastStatus = null;
         let retriesAttempted = 0;
         for (let attempt = 1; attempt <= retryConfig.max_attempts; attempt++) {
-          const timeout = config.timeout || 3e4;
+          const timeout = config.timeout || HTTP_DEFAULT_TIMEOUT_MS;
           const controller = new AbortController();
           const timeoutId = setTimeout(() => controller.abort(), timeout);
           try {
@@ -6811,7 +5569,12 @@ var init_HttpClient = __esm({
               mcard_hash
             };
             if (cacheConfig?.enabled && method === "GET" && response.ok) {
-              await this.cache.set(cacheKey, result, cacheConfig.ttl, cacheConfig.storage === "mcard");
+              await this.cache.set(
+                cacheKey,
+                result,
+                cacheConfig.ttl ?? HTTP_DEFAULT_CACHE_TTL_SECONDS,
+                cacheConfig.storage === "mcard"
+              );
             }
             return result;
           } catch (error) {
@@ -6856,6 +5619,7 @@ var init_NetworkRuntime = __esm({
   "src/ptr/node/NetworkRuntime.ts"() {
     "use strict";
     http3 = __toESM(require("http"), 1);
+    init_NetworkConfig();
     init_P2PChatSession();
     init_SignalingServer();
     init_NetworkSecurity();
@@ -6994,7 +5758,7 @@ var init_NetworkRuntime = __esm({
         }, context);
       }
       async handleListenHttp(config, context) {
-        const port = Number(this.interpolate(String(config.port || 3e3), context));
+        const port = Number(this.interpolate(String(config.port || NETWORK_DEFAULT_LISTEN_PORT), context));
         const path15 = this.interpolate(config.path || "/mcard", context);
         return new Promise((resolve10, reject) => {
           const server = http3.createServer(async (req, res) => {
@@ -7163,7 +5927,7 @@ var init_NetworkRuntime = __esm({
                 status: "connected",
                 mock: true
               });
-            }, 100);
+            }, WEBRTC_DEFAULT_MOCK_DELAY_MS);
           });
         }
         console.log(`[WebRTC] Connecting to ${targetPeerId} via ${signalingUrl} as ${myPeerId}`);
@@ -7172,7 +5936,7 @@ var init_NetworkRuntime = __esm({
         });
         const dc = pc.createDataChannel(channelLabel);
         const connectionPromise = new Promise((resolve10, reject) => {
-          const timeoutMs = config.timeout || 3e4;
+          const timeoutMs = config.timeout || WEBRTC_DEFAULT_TIMEOUT_MS;
           const timeoutId = setTimeout(() => {
             pc.close();
             reject(new Error("WebRTC connection timed out"));
@@ -7277,7 +6041,7 @@ var init_NetworkRuntime = __esm({
                 status: "listening",
                 mock: true
               });
-            }, 100);
+            }, WEBRTC_DEFAULT_MOCK_DELAY_MS);
           });
         }
         console.log(`[WebRTC] Listening on ${signalingUrl} as ${myPeerId}`);
@@ -7292,7 +6056,7 @@ var init_NetworkRuntime = __esm({
         if (!this.collection) {
           throw new Error("Listen Sync requires a CardCollection.");
         }
-        const port = Number(this.interpolate(String(config.port || 3e3), context));
+        const port = Number(this.interpolate(String(config.port || NETWORK_DEFAULT_LISTEN_PORT), context));
         const basePath = this.interpolate(config.base_path || "/sync", context);
         return new Promise((resolve10, reject) => {
           const server = http3.createServer(async (req, res) => {
@@ -7406,7 +6170,7 @@ var init_NetworkRuntime = __esm({
           if (this.sessions.has(sessionId)) {
             return { success: true, message: "Session already exists", sessionId };
           }
-          let bufferSize = config.maxBufferSize || 5;
+          let bufferSize = config.maxBufferSize || SESSION_RECORD_DEFAULT_MAX_BUFFER_SIZE;
           if (typeof config.maxBufferSize === "string") {
             bufferSize = parseInt(this.interpolate(config.maxBufferSize, context), 10);
           }
@@ -7589,10 +6353,10 @@ var init_NetworkRuntime = __esm({
                 console.warn(`[Orchestrator] No PID found for key '${key}'`);
               }
             } else if (step.action === "sleep") {
-              const ms = step.ms || 1e3;
+              const ms = step.ms || NETWORK_DEFAULT_ORCHESTRATOR_SLEEP_MS;
               await new Promise((r) => setTimeout(r, ms));
             } else if (step.action === "start_signaling_server") {
-              const port = step.port || 3e3;
+              const port = step.port || NETWORK_DEFAULT_LISTEN_PORT;
               console.log(`[Orchestrator] Starting builtin signaling server on port ${port}...`);
               const result = await this.handleSignalingServer({ port, background: true }, context);
               if (result.success) {
@@ -7694,12 +6458,12 @@ ${stdout}`);
         });
       }
       async handleSignalingServer(config, _context) {
-        const port = config.port || 3e3;
+        const port = config.port || NETWORK_DEFAULT_LISTEN_PORT;
         console.log(`[NetworkRuntime] Starting signaling server on port ${port}...`);
         const result = await createSignalingServer({
           port,
           autoFindPort: true,
-          maxPortTries: 10
+          maxPortTries: NETWORK_DEFAULT_SIGNALING_MAX_PORT_TRIES
         });
         if (result.success && result.server) {
           this._signalingServer = result.server;
@@ -8995,6 +7759,7 @@ var ErrorCodes = {
 };
 
 // src/ptr/SandboxWorker.ts
+init_constants();
 var WORKER_CODE = `
 // Multi-runtime sandboxed execution environment
 let pyodide = null;
@@ -9007,7 +7772,7 @@ const PYODIDE_CDN = 'https://cdn.jsdelivr.net/pyodide/v0.24.1/full/';
 async function loadPyodide() {
   if (pyodide) return pyodide;
   if (pyodideLoading) return pyodideLoading;
-  
+
   pyodideLoading = (async () => {
     // Import Pyodide from CDN
     importScripts(PYODIDE_CDN + 'pyodide.js');
@@ -9017,25 +7782,25 @@ async function loadPyodide() {
     console.log('[SandboxWorker] Pyodide loaded successfully');
     return pyodide;
   })();
-  
+
   return pyodideLoading;
 }
 
 self.onmessage = async function(e) {
   const request = e.data;
-  
+
   try {
     if (request.method === 'pcard.execute') {
       const { pcard, context } = request.params;
       const runtime = pcard.runtime || 'javascript';
-      
+
       let result;
       if (runtime === 'python' || runtime === 'py') {
         result = await executePython(pcard.code, pcard.input, context);
       } else {
         result = await executeJavaScript(pcard.code, pcard.input, context);
       }
-      
+
       self.postMessage({
         jsonrpc: '2.0',
         id: request.id,
@@ -9090,11 +7855,11 @@ async function executeJavaScript(code, input, context) {
 // Execute Python code via Pyodide
 async function executePython(code, input, context) {
   const py = await loadPyodide();
-  
+
   // Convert input to Python dict
   py.globals.set('input', py.toPy(input || {}));
   py.globals.set('context', py.toPy(context || {}));
-  
+
   // Wrap code to capture result
   const wrappedCode = \`
 import json
@@ -9115,7 +7880,7 @@ result = None
 # Return result
 result
 \`;
-  
+
   try {
     const pyResult = await py.runPythonAsync(wrappedCode);
     // Convert Python result to JavaScript
@@ -9131,8 +7896,7 @@ var SandboxWorker = class {
   worker = null;
   pythonLoaded = false;
   pendingRequests = /* @__PURE__ */ new Map();
-  defaultTimeout = 5e3;
-  // 5 seconds
+  defaultTimeout = DEFAULT_SANDBOX_TIMEOUT_MS;
   /**
    * Initialize the sandbox worker
    */
@@ -9364,24 +8128,24 @@ var MCardStore = class {
   async setHandle(handle, newHash) {
     const db = await this.dbPromise;
     const tx = db.transaction(["handle_registry", "handle_history"], "readwrite");
-    const registry2 = tx.objectStore("handle_registry");
+    const registry = tx.objectStore("handle_registry");
     const history = tx.objectStore("handle_history");
     const now = (/* @__PURE__ */ new Date()).toISOString();
-    const existing = await registry2.get(handle);
+    const existing = await registry.get(handle);
     if (existing) {
       await history.add({
         handle,
         previous_hash: existing.current_hash,
         changed_at: now
       });
-      await registry2.put({
+      await registry.put({
         handle,
         current_hash: newHash,
         created_at: existing.created_at,
         updated_at: now
       });
     } else {
-      await registry2.put({
+      await registry.put({
         handle,
         current_hash: newHash,
         created_at: now,
@@ -9393,8 +8157,8 @@ var MCardStore = class {
   async resolveHandle(handle) {
     const db = await this.dbPromise;
     const tx = db.transaction(["handle_registry", "card"], "readonly");
-    const registry2 = tx.objectStore("handle_registry");
-    const entry = await registry2.get(handle);
+    const registry = tx.objectStore("handle_registry");
+    const entry = await registry.get(handle);
     if (!entry) return void 0;
     const cardStore = tx.objectStore("card");
     return cardStore.get(entry.current_hash);
@@ -9792,6 +8556,8 @@ function buildBaseContext(clm, input) {
   const inputObj = asObject(input);
   return {
     balanced: clm.clm.balanced,
+    input_arguments: clm.clm.concrete?.input_arguments,
+    output_arguments: clm.clm.concrete?.output_arguments,
     params: inputObj,
     ...inputObj
   };
@@ -9821,6 +8587,7 @@ function isMultiRuntime(clm) {
 // src/ptr/node/clm/runner.ts
 var path14 = __toESM(require("path"), 1);
 var yaml2 = __toESM(require("yaml"), 1);
+init_constants();
 
 // src/ptr/node/runtimes/index.ts
 init_base();
@@ -10922,6 +9689,7 @@ async function executePruneSingle(handle, versions, pruneType, olderThanSeconds)
 var import_child_process2 = require("child_process");
 var fs8 = __toESM(require("fs"), 1);
 var path10 = __toESM(require("path"), 1);
+init_NetworkConfig();
 function resolveConfigValue(val) {
   if (typeof val === "string" && val.startsWith("${") && val.endsWith("}")) {
     const envVar = val.slice(2, -1);
@@ -10951,7 +9719,7 @@ async function executeStaticServer(config, context, chapterDir) {
   const defaultPort = parseInt(process.env.HTTP_PORT || "8080", 10);
   const rawPort = context.port || config.port || defaultPort;
   const port = parseInt(String(resolveConfigValue(rawPort)), 10);
-  const host = context.host || config.host || "localhost";
+  const host = context.host || config.host || NETWORK_DEFAULT_HOST;
   let rootDir = context.root_dir || config.root_dir || ".";
   let projectRoot = chapterDir;
   while (projectRoot !== path10.dirname(projectRoot)) {
@@ -11052,7 +9820,7 @@ setInterval(() => {}, 1000);
       });
       child.unref();
       fs8.writeFileSync(pidFile, String(child.pid));
-      await new Promise((resolve10) => setTimeout(resolve10, 1500));
+      await new Promise((resolve10) => setTimeout(resolve10, STATIC_SERVER_START_WAIT_MS));
       if (isPortInUse(port)) {
         return {
           success: true,
@@ -11105,10 +9873,10 @@ setInterval(() => {}, 1000);
     }
     try {
       process.kill(pid, "SIGTERM");
-      await new Promise((resolve10) => setTimeout(resolve10, 500));
+      await new Promise((resolve10) => setTimeout(resolve10, PROCESS_TERMINATE_WAIT_MS));
       if (isPortInUse(port)) {
         process.kill(pid, "SIGKILL");
-        await new Promise((resolve10) => setTimeout(resolve10, 500));
+        await new Promise((resolve10) => setTimeout(resolve10, PROCESS_TERMINATE_WAIT_MS));
       }
       if (fs8.existsSync(pidFile)) {
         fs8.unlinkSync(pidFile);
@@ -11143,6 +9911,7 @@ setInterval(() => {}, 1000);
 var import_child_process3 = require("child_process");
 var fs9 = __toESM(require("fs"), 1);
 var path11 = __toESM(require("path"), 1);
+init_NetworkConfig();
 function resolveConfigValue2(val) {
   if (typeof val === "string" && val.startsWith("${") && val.endsWith("}")) {
     const envVar = val.slice(2, -1);
@@ -11172,7 +9941,7 @@ async function executeWebSocketServer(config, context, chapterDir) {
   const defaultPort = parseInt(process.env.VITE_WS_PORT || process.env.WS_PORT || "5321", 10);
   const rawPort = context.port || config.port || defaultPort;
   const port = parseInt(String(resolveConfigValue2(rawPort)), 10);
-  const host = context.host || config.host || "localhost";
+  const host = context.host || config.host || NETWORK_DEFAULT_HOST;
   let projectRoot = chapterDir;
   while (projectRoot !== path11.dirname(projectRoot)) {
     if (fs9.existsSync(path11.join(projectRoot, "package.json")) || fs9.existsSync(path11.join(projectRoot, ".git"))) {
@@ -11250,7 +10019,7 @@ Process exited with code ${code}
       } catch {
       }
       fs9.writeFileSync(pidFile, String(child.pid));
-      await new Promise((resolve10) => setTimeout(resolve10, 3e3));
+      await new Promise((resolve10) => setTimeout(resolve10, WEBSOCKET_SERVER_START_WAIT_MS));
       if (isPortInUse2(port)) {
         console.log(`[WebSocket Server] Successfully started on port ${port}`);
         return {
@@ -11314,10 +10083,10 @@ Process exited with code ${code}
     }
     try {
       process.kill(pid, "SIGTERM");
-      await new Promise((resolve10) => setTimeout(resolve10, 500));
+      await new Promise((resolve10) => setTimeout(resolve10, PROCESS_TERMINATE_WAIT_MS));
       if (isPortInUse2(port)) {
         process.kill(pid, "SIGKILL");
-        await new Promise((resolve10) => setTimeout(resolve10, 500));
+        await new Promise((resolve10) => setTimeout(resolve10, PROCESS_TERMINATE_WAIT_MS));
       }
       if (fs9.existsSync(pidFile)) {
         fs9.unlinkSync(pidFile);
@@ -11465,6 +10234,9 @@ var CLMLoader = class {
       }
     }
     if (config.code_file) {
+      if (config.code_file.startsWith("module://")) {
+        return config.code_file;
+      }
       const logicPath = path12.resolve(this.basePath, chapterDir, config.code_file);
       if (fs10.existsSync(logicPath)) {
         return fs10.readFileSync(logicPath, "utf-8");
@@ -11643,7 +10415,7 @@ var CLMRunner = class _CLMRunner {
   loader;
   timeout;
   collection;
-  constructor(basePath = process.cwd(), timeout = 5e3, collection) {
+  constructor(basePath = process.cwd(), timeout = DEFAULT_CLM_TIMEOUT_MS, collection) {
     this.loader = new CLMLoader(basePath);
     this.timeout = timeout;
     this.collection = collection;
@@ -12119,92 +10891,6 @@ var TextValidator = class _TextValidator extends BaseValidator {
   }
 };
 
-// src/model/detectors/BinarySignatureDetector.ts
-var BinarySignatureDetector2 = class _BinarySignatureDetector {
-  // Dictionary of binary signatures mapped to MIME types
-  // Note: In TS, we use numbers or number arrays for bytes
-  static SIGNATURES = {
-    // Images
-    "89504e470d0a1a0a": "image/png",
-    // \x89PNG\r\n\x1a\n
-    "ffd8ff": "image/jpeg",
-    "474946383761": "image/gif",
-    // GIF87a
-    "474946383961": "image/gif",
-    // GIF89a
-    "424d": "image/bmp",
-    // BM
-    "00000100": "image/x-icon",
-    "00000200": "image/x-icon",
-    // MP4
-    "00000018667479706d703432": "video/mp4",
-    // ...ftypmp42
-    "000000186674797069736f6d": "video/mp4",
-    // ...ftypisom
-    // ... (simplified for key common ones)
-    // Documents
-    "25504446": "application/pdf",
-    // %PDF
-    // Archives
-    "504b0304": "application/zip",
-    // PK\x03\x04
-    "1f8b08": "application/gzip",
-    "526172211a0700": "application/x-rar-compressed",
-    // Rar!
-    "377abcaf271c": "application/x-7z-compressed",
-    // 7z...
-    // Database
-    "53514c69746520666f726d6174203300": "application/x-sqlite3"
-    // SQLite format 3\0
-  };
-  static OLE_SIGNATURE = "d0cf11e0a1b11ae1";
-  /**
-   * Helper to convert hex string to Uint8Array for easy comparison if needed,
-   * but we will convert input bytes to hex for lookup.
-   */
-  detect(content) {
-    return this.detectFromBytes(content);
-  }
-  detectFromBytes(content) {
-    if (this.startsWithAscii(content, "RIFF")) {
-      return this.detectRiffFormat(content);
-    }
-    const hexHeader = this.toHex(content.slice(0, 32));
-    for (const [signature, mimeType] of Object.entries(_BinarySignatureDetector.SIGNATURES)) {
-      if (hexHeader.startsWith(signature)) {
-        if (signature === _BinarySignatureDetector.OLE_SIGNATURE) {
-          return "application/oleobject";
-        }
-        if (signature === "504b0304") {
-          return "application/zip";
-        }
-        return mimeType;
-      }
-    }
-    return "application/octet-stream";
-  }
-  detectRiffFormat(content) {
-    if (content.length < 12) return "application/octet-stream";
-    const formatType = this.toAscii(content.slice(8, 12));
-    if (formatType === "WAVE") return "audio/wav";
-    if (formatType === "WEBP") return "image/webp";
-    return "application/octet-stream";
-  }
-  startsWithAscii(content, str) {
-    if (content.length < str.length) return false;
-    for (let i = 0; i < str.length; i++) {
-      if (content[i] !== str.charCodeAt(i)) return false;
-    }
-    return true;
-  }
-  toAscii(content) {
-    return Array.from(content).map((b) => String.fromCharCode(b)).join("");
-  }
-  toHex(content) {
-    return Array.from(content).map((b) => b.toString(16).padStart(2, "0")).join("");
-  }
-};
-
 // src/model/validators/BinaryValidator.ts
 var BinaryValidator = class _BinaryValidator extends BaseValidator {
   static BINARY_MIME_TYPES = /* @__PURE__ */ new Set([
@@ -12218,7 +10904,6 @@ var BinaryValidator = class _BinaryValidator extends BaseValidator {
     "audio/wav",
     "application/octet-stream"
   ]);
-  detector = new BinarySignatureDetector2();
   canValidate(mimeType) {
     return _BinaryValidator.BINARY_MIME_TYPES.has(mimeType) || mimeType.startsWith("image/") || mimeType.startsWith("audio/") || mimeType.startsWith("video/");
   }
@@ -12246,29 +10931,19 @@ var BinaryValidator = class _BinaryValidator extends BaseValidator {
     } else if (mimeType === "image/gif" && content.length <= 6) {
       throw new ValidationError("Invalid GIF content: truncated file");
     }
-    const signatures = BinarySignatureDetector2.SIGNATURES;
-    let expectedSig = null;
-    for (const [sig, mime] of Object.entries(signatures)) {
-      if (mime === mimeType) {
-        expectedSig = sig;
-      }
-    }
-    if (expectedSig) {
-      const contentHex = this.toHex(content.slice(0, expectedSig.length / 2));
-      if (contentHex !== expectedSig) {
-        let hasMatch = false;
-        for (const [sig, mime] of Object.entries(signatures)) {
-          if (mime === mimeType) {
-            const currentHex = this.toHex(content.slice(0, sig.length / 2));
-            if (currentHex === sig) {
-              hasMatch = true;
-              break;
-            }
-          }
-        }
-        if (!hasMatch) {
-          throw new ValidationError(`Invalid ${mimeType} content: missing proper header`);
-        }
+    const signatures = {
+      "image/png": "89504e470d0a1a0a",
+      // \x89PNG\r\n\x1a\n
+      "image/jpeg": "ffd8ff",
+      // \xff\xd8\xff
+      "image/gif": "47494638"
+      // GIF8
+    };
+    if (signatures[mimeType]) {
+      const expectedSig = signatures[mimeType];
+      const currentHex = this.toHex(content.slice(0, expectedSig.length / 2));
+      if (!currentHex.startsWith(expectedSig) && currentHex !== expectedSig) {
+        throw new ValidationError(`Invalid ${mimeType} content: missing proper header`);
       }
     }
   }
@@ -12306,7 +10981,7 @@ var ValidationRegistry = class {
   }
   /**
    * Validate content using appropriate validator.
-   * 
+   *
    * @param content The content to validate
    * @param mimeType The detected MIME type
    * @throws ValidationError If content is invalid