dirac-lang 0.1.37 → 0.1.39

package/dist/{chunk-MVMLG434.js → chunk-NWGHO23V.js}

@@ -9,6 +9,7 @@ import {
   cleanToBoundary,
   emit,
   flushCurrentException,
+  getAvailableSubroutines,
   getCurrentExceptions,
   getCurrentParameters,
   getParentSubroutine,
@@ -447,12 +448,12 @@ async function executeIf(session, element) {
   const condition = await evaluatePredicate(session, conditionElement);
   if (condition) {
     if (thenElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-GLWAQHAW.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-UCWBT6KP.js");
       await integrateChildren2(session, thenElement);
     }
   } else {
     if (elseElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-GLWAQHAW.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-UCWBT6KP.js");
       await integrateChildren2(session, elseElement);
     }
   }
@@ -465,7 +466,7 @@ async function evaluatePredicate(session, predicateElement) {
     return await evaluateCondition(session, predicateElement);
   }
   const outputLengthBefore = session.output.length;
-  const { integrate: integrate2 } = await import("./interpreter-GLWAQHAW.js");
+  const { integrate: integrate2 } = await import("./interpreter-UCWBT6KP.js");
   await integrate2(session, predicateElement);
   const newOutputChunks = session.output.slice(outputLengthBefore);
   const result = newOutputChunks.join("").trim();
@@ -488,11 +489,11 @@ async function evaluateCondition(session, condElement) {
   }
   const outputLengthBefore = session.output.length;
   const args = [];
-  const { integrate: integrate2 } = await import("./interpreter-GLWAQHAW.js");
+  const { integrate: integrate2 } = await import("./interpreter-UCWBT6KP.js");
   for (const child of condElement.children) {
     if (child.tag.toLowerCase() === "arg") {
       const argOutputStart = session.output.length;
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-GLWAQHAW.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-UCWBT6KP.js");
       await integrateChildren2(session, child);
       const newChunks = session.output.slice(argOutputStart);
       const argValue = newChunks.join("");
@@ -602,8 +603,8 @@ async function executeLLM(session, element) {
       console.error("[LLM] Full prompt sent to LLM (noextra):\n" + prompt + "\n");
     }
   } else {
-    const { getAvailableSubroutines } = await import("./session-UBATJEND.js");
-    const subroutines = getAvailableSubroutines(session);
+    const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-UBATJEND.js");
+    const subroutines = getAvailableSubroutines2(session);
     if (session.debug) {
       console.error(
         "[LLM] Subroutines available at prompt composition:",
@@ -932,11 +933,11 @@ ${expr}
     for (const v of session.variables) {
       context[v.name] = v.value;
     }
-    const { default: fs4 } = await import("fs");
-    const { default: path2 } = await import("path");
+    const { default: fs5 } = await import("fs");
+    const { default: path3 } = await import("path");
     const { fileURLToPath } = await import("url");
-    context.fs = fs4;
-    context.path = path2;
+    context.fs = fs5;
+    context.path = path3;
     context.__dirname = process.cwd();
     context.getParams = () => {
       const params = session.parameterStack[session.parameterStack.length - 1];
@@ -1284,8 +1285,8 @@ async function getBestTagMatch(candidate, allowed) {
   return { tag: allowed[bestIdx], score: bestScore };
 }
 async function executeTagCheck(session, element) {
-  const { getAvailableSubroutines } = await import("./session-UBATJEND.js");
-  const subroutines = getAvailableSubroutines(session);
+  const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-UBATJEND.js");
+  const subroutines = getAvailableSubroutines2(session);
   const allowed = new Set(subroutines.map((s) => s.name));
   console.error("[tag-check] Allowed subroutines:", Array.from(allowed));
   const autocorrect = element.attributes?.autocorrect === "true";
@@ -1377,7 +1378,7 @@ async function executeTagCheck(session, element) {
       const executeTag = correctedTag || tagName;
       console.error(`[tag-check] Executing <${executeTag}/> as all checks passed and execute=true.`);
       const elementToExecute = correctedTag ? { ...child, tag: correctedTag } : child;
-      const { integrate: integrate2 } = await import("./interpreter-GLWAQHAW.js");
+      const { integrate: integrate2 } = await import("./interpreter-UCWBT6KP.js");
       await integrate2(session, elementToExecute);
     }
   }
@@ -1386,7 +1387,7 @@ async function executeTagCheck(session, element) {
 // src/tags/throw.ts
 async function executeThrow(session, element) {
   const exceptionName = element.attributes?.name || "exception";
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-GLWAQHAW.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-UCWBT6KP.js");
   const exceptionDom = {
     tag: "exception-content",
     attributes: { name: exceptionName },
@@ -1399,7 +1400,7 @@ async function executeThrow(session, element) {
 // src/tags/try.ts
 async function executeTry(session, element) {
   setExceptionBoundary(session);
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-GLWAQHAW.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-UCWBT6KP.js");
   await integrateChildren2(session, element);
   unsetExceptionBoundary(session);
 }
@@ -1409,7 +1410,7 @@ async function executeCatch(session, element) {
   const exceptionName = element.attributes?.name || "exception";
   const caughtCount = lookupException(session, exceptionName);
   if (caughtCount > 0) {
-    const { integrateChildren: integrateChildren2 } = await import("./interpreter-GLWAQHAW.js");
+    const { integrateChildren: integrateChildren2 } = await import("./interpreter-UCWBT6KP.js");
     await integrateChildren2(session, element);
   }
   flushCurrentException(session);
@@ -1418,7 +1419,7 @@ async function executeCatch(session, element) {
 // src/tags/exception.ts
 async function executeException(session, element) {
   const exceptions = getCurrentExceptions(session);
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-GLWAQHAW.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-UCWBT6KP.js");
   for (const exceptionDom of exceptions) {
     await integrateChildren2(session, exceptionDom);
   }
@@ -1538,6 +1539,423 @@ function escapeXml2(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
 
+// src/tags/list-subroutines.ts
+async function executeListSubroutines(session, element) {
+  const format = element.attributes.format || "text";
+  const outputVar = element.attributes.output;
+  const subroutines = getAvailableSubroutines(session);
+  let output = "";
+  switch (format) {
+    case "braket":
+      output = formatAsBraKet(subroutines);
+      break;
+    case "xml":
+      output = formatAsXml(subroutines);
+      break;
+    case "json":
+      output = JSON.stringify(subroutines, null, 2);
+      break;
+    case "text":
+    default:
+      output = formatAsText(subroutines);
+      break;
+  }
+  if (outputVar) {
+    setVariable(session, outputVar, output, false);
+  } else {
+    emit(session, output);
+  }
+}
+function formatAsBraKet(subroutines) {
+  const lines = ["Available subroutines:\n"];
+  for (const sub of subroutines) {
+    const params = sub.parameters?.map(
+      (p) => `${p.name}=${p.type || "any"}`
+    ).join(" ") || "";
+    const braLine = params ? `<${sub.name} ${params}|` : `<${sub.name}|`;
+    lines.push(braLine);
+    if (sub.description) {
+      lines.push(`  ${sub.description}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatAsXml(subroutines) {
+  const lines = ["Available subroutines:\n"];
+  for (const sub of subroutines) {
+    const params = sub.parameters?.map(
+      (p) => `param-${p.name}="${p.type || "any"}"`
+    ).join(" ") || "";
+    const xmlLine = params ? `<subroutine name="${sub.name}" ${params}/>` : `<subroutine name="${sub.name}"/>`;
+    lines.push(xmlLine);
+    if (sub.description) {
+      lines.push(`  <!-- ${sub.description} -->`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatAsText(subroutines) {
+  const lines = ["Available subroutines:\n"];
+  for (const sub of subroutines) {
+    lines.push(`${sub.name}(`);
+    if (sub.parameters && sub.parameters.length > 0) {
+      for (const param of sub.parameters) {
+        const required = param.required ? " [required]" : "";
+        const desc = param.description ? ` - ${param.description}` : "";
+        lines.push(`  ${param.name}: ${param.type || "any"}${required}${desc}`);
+      }
+    }
+    lines.push(`)${sub.description ? " - " + sub.description : ""}
+`);
+  }
+  return lines.join("\n");
+}
+
+// src/runtime/subroutine-registry.ts
+import * as fs3 from "fs";
+import * as path2 from "path";
+import * as os from "os";
+var SubroutineRegistry = class {
+  indexPath;
+  index;
+  constructor(indexPath) {
+    this.indexPath = indexPath || path2.join(os.homedir(), ".dirac", "subroutine-index.json");
+    this.index = this.loadIndex();
+  }
+  /**
+   * Load index from disk
+   */
+  loadIndex() {
+    if (fs3.existsSync(this.indexPath)) {
+      try {
+        const data = fs3.readFileSync(this.indexPath, "utf-8");
+        return JSON.parse(data);
+      } catch (err) {
+        console.error("Error loading subroutine index:", err);
+      }
+    }
+    return {
+      subroutines: [],
+      lastUpdated: Date.now()
+    };
+  }
+  /**
+   * Save index to disk
+   */
+  saveIndex() {
+    const dir = path2.dirname(this.indexPath);
+    if (!fs3.existsSync(dir)) {
+      fs3.mkdirSync(dir, { recursive: true });
+    }
+    this.index.lastUpdated = Date.now();
+    fs3.writeFileSync(this.indexPath, JSON.stringify(this.index, null, 2), "utf-8");
+  }
+  /**
+   * Scan a directory for .di files and index all subroutines
+   */
+  async indexDirectory(dirPath) {
+    let count = 0;
+    const scanDir = (dir) => {
+      const entries = fs3.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = path2.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          scanDir(fullPath);
+        } else if (entry.isFile() && entry.name.endsWith(".di")) {
+          count += this.indexFile(fullPath);
+        }
+      }
+    };
+    scanDir(dirPath);
+    this.saveIndex();
+    return count;
+  }
+  /**
+   * Index a single .di file
+   */
+  indexFile(filePath) {
+    try {
+      const content = fs3.readFileSync(filePath, "utf-8");
+      const parser = new DiracParser();
+      const ast = parser.parse(content);
+      this.index.subroutines = this.index.subroutines.filter((s) => s.filePath !== filePath);
+      const subroutines = this.extractSubroutines(ast, filePath);
+      this.index.subroutines.push(...subroutines);
+      return subroutines.length;
+    } catch (err) {
+      if (process.env.DEBUG_REGISTRY === "1") {
+        console.error(`Error indexing ${filePath}:`, err);
+      }
+      return 0;
+    }
+  }
+  /**
+   * Extract subroutines from AST
+   */
+  extractSubroutines(element, filePath) {
+    const subroutines = [];
+    if (element.tag === "subroutine") {
+      const name = element.attributes.name;
+      if (name) {
+        const metadata = {
+          name,
+          description: element.attributes.description,
+          parameters: [],
+          filePath
+        };
+        for (const [attrName, attrValue] of Object.entries(element.attributes)) {
+          if (attrName.startsWith("param-")) {
+            const paramName = attrName.substring(6);
+            const parts = attrValue.split(":");
+            metadata.parameters.push({
+              name: paramName,
+              type: parts[0] || "any",
+              required: parts[1] === "required",
+              description: parts[2]
+            });
+          }
+        }
+        subroutines.push(metadata);
+      }
+    }
+    if (element.children) {
+      for (const child of element.children) {
+        subroutines.push(...this.extractSubroutines(child, filePath));
+      }
+    }
+    return subroutines;
+  }
+  /**
+   * Simple text search (will be replaced with vector search)
+   * Supports multi-word queries by tokenizing and matching individual words
+   */
+  search(query, limit = 10) {
+    const lowerQuery = query.toLowerCase();
+    const queryTokens = lowerQuery.split(/[\s\-_]+/).filter((t) => t.length > 0);
+    const results = this.index.subroutines.map((sub) => {
+      let score = 0;
+      const lowerName = sub.name.toLowerCase();
+      const lowerDesc = (sub.description || "").toLowerCase();
+      const nameTokens = lowerName.split(/[\s\-_]+/);
+      if (lowerName === lowerQuery) {
+        score += 100;
+      } else if (lowerName.includes(lowerQuery)) {
+        score += 50;
+      } else if (lowerDesc.includes(lowerQuery)) {
+        score += 30;
+      }
+      let tokenMatchCount = 0;
+      for (const queryToken of queryTokens) {
+        if (nameTokens.some((nt) => nt === queryToken)) {
+          score += 40;
+          tokenMatchCount++;
+        } else if (nameTokens.some((nt) => nt.includes(queryToken))) {
+          score += 20;
+          tokenMatchCount++;
+        }
+        if (lowerDesc.includes(queryToken)) {
+          score += 15;
+          tokenMatchCount++;
+        }
+        for (const param of sub.parameters) {
+          const lowerParamName = param.name.toLowerCase();
+          if (lowerParamName === queryToken) {
+            score += 10;
+            tokenMatchCount++;
+          } else if (lowerParamName.includes(queryToken)) {
+            score += 5;
+          }
+        }
+      }
+      if (queryTokens.length > 1 && tokenMatchCount >= queryTokens.length * 0.5) {
+        score += 25;
+      }
+      return { sub, score };
+    }).filter((r) => r.score > 0).sort((a, b) => b.score - a.score).slice(0, limit).map((r) => r.sub);
+    return results;
+  }
+  /**
+   * Get all subroutines
+   */
+  getAll() {
+    return this.index.subroutines;
+  }
+  /**
+   * Get statistics
+   */
+  getStats() {
+    const files = new Set(this.index.subroutines.map((s) => s.filePath));
+    return {
+      totalSubroutines: this.index.subroutines.length,
+      totalFiles: files.size,
+      lastUpdated: new Date(this.index.lastUpdated)
+    };
+  }
+};
+
+// src/tags/subroutine-index.ts
+var registry = new SubroutineRegistry();
+async function executeIndexSubroutines(session, element) {
+  const pathAttr = element.attributes.path;
+  if (!pathAttr) {
+    throw new Error("<index-subroutines> requires path attribute");
+  }
+  const count = await registry.indexDirectory(pathAttr);
+  if (session.debug) {
+    emit(session, `Indexed ${count} subroutines from ${pathAttr}
+`);
+  }
+}
+async function executeSearchSubroutines(session, element) {
+  const query = element.attributes.query;
+  const limitAttr = element.attributes.limit;
+  const outputVar = element.attributes.output;
+  const format = element.attributes.format || "text";
+  if (!query) {
+    throw new Error("<search-subroutines> requires query attribute");
+  }
+  const limit = limitAttr ? parseInt(limitAttr, 10) : 10;
+  const results = registry.search(query, limit);
+  let output = "";
+  switch (format) {
+    case "json":
+      output = JSON.stringify(results, null, 2);
+      break;
+    case "xml":
+      output = "<subroutines>\n";
+      for (const sub of results) {
+        const params = sub.parameters.map((p) => `param-${p.name}="${p.type}"`).join(" ");
+        output += `  <subroutine name="${sub.name}" ${params} file="${sub.filePath}"/>
+`;
+        if (sub.description) {
+          output += `    <!-- ${sub.description} -->
+`;
+        }
+      }
+      output += "</subroutines>";
+      break;
+    case "text":
+    default:
+      if (results.length === 0) {
+        output = "No subroutines found.\n";
+      } else {
+        output = `Found ${results.length} subroutine(s):
+
+`;
+        for (const sub of results) {
+          output += `${sub.name}(${sub.parameters.map((p) => p.name).join(", ")})
+`;
+          if (sub.description) {
+            output += `  ${sub.description}
+`;
+          }
+          output += `  File: ${sub.filePath}
+
+`;
+        }
+      }
+      break;
+  }
+  if (outputVar) {
+    setVariable(session, outputVar, output, false);
+  } else {
+    emit(session, output);
+  }
+}
+async function executeRegistryStats(session, element) {
+  const stats = registry.getStats();
+  const output = `Subroutine Registry Statistics:
+  Total Subroutines: ${stats.totalSubroutines}
+  Total Files: ${stats.totalFiles}
+  Last Updated: ${stats.lastUpdated.toLocaleString()}
+`;
+  emit(session, output);
+}
+
+// src/tags/load-context.ts
+var registry2 = new SubroutineRegistry();
+async function executeLoadContext(session, element) {
+  let query = element.attributes.query;
+  if (!query && element.text) {
+    query = element.text.trim();
+  }
+  if (!query && element.children.length > 0) {
+    const { integrate: integrate2 } = await import("./interpreter-UCWBT6KP.js");
+    const beforeOutput = session.output.length;
+    for (const child of element.children) {
+      await integrate2(session, child);
+    }
+    const childOutput = session.output.slice(beforeOutput);
+    query = childOutput.join("").trim();
+    session.output = session.output.slice(0, beforeOutput);
+  }
+  if (!query) {
+    throw new Error("<load-context> requires query attribute or text content");
+  }
+  const limitAttr = element.attributes.limit;
+  const shouldImport = element.attributes.import !== "false";
+  const outputVar = element.attributes.output;
+  const stats = registry2.getStats();
+  if (stats.totalSubroutines === 0) {
+    emit(session, `[load-context] Registry is empty. Use :index <path> or <index-subroutines path="..."> first.
+`);
+    return;
+  }
+  const limit = limitAttr ? parseInt(limitAttr, 10) : 5;
+  const results = registry2.search(query, limit);
+  if (results.length === 0) {
+    emit(session, `[load-context] No subroutines found for query: "${query}". Try indexing more libraries.
+`);
+    return;
+  }
+  emit(session, `[load-context] Found ${results.length} subroutine(s): ${results.map((s) => s.name).join(", ")}
+`);
+  const fileMap = /* @__PURE__ */ new Map();
+  for (const sub of results) {
+    if (!fileMap.has(sub.filePath)) {
+      fileMap.set(sub.filePath, []);
+    }
+    fileMap.get(sub.filePath).push(sub);
+  }
+  emit(session, `[load-context] Importing ${fileMap.size} file(s)...
+`);
+  if (shouldImport) {
+    for (const filePath of fileMap.keys()) {
+      try {
+        const { resolve: resolve2 } = await import("path");
+        const absolutePath = filePath.startsWith("/") ? filePath : resolve2(process.cwd(), filePath);
+        const importElement = {
+          tag: "import",
+          attributes: { src: absolutePath },
+          children: [],
+          text: ""
+        };
+        await executeImport(session, importElement);
+        emit(session, `[load-context] \u2713 Imported: ${filePath}
+`);
+      } catch (error) {
+        emit(session, `[load-context] \u2717 Failed to import ${filePath}: ${error}
+`);
+      }
+    }
+  } else {
+    emit(session, `[load-context] (import=false, not loading files)
+`);
+  }
+  if (outputVar) {
+    const summary = results.map((s) => ({
+      name: s.name,
+      description: s.description,
+      parameters: s.parameters.map((p) => p.name),
+      filePath: s.filePath
+    }));
+    const { setVariable: setVariable2 } = await import("./session-UBATJEND.js");
+    setVariable2(session, outputVar, JSON.stringify(summary, null, 2), false);
+  }
+}
+
 // src/tags/foreach.ts
 import { XMLParser } from "fast-xml-parser";
 async function executeForeach(session, element) {
@@ -1558,7 +1976,7 @@ async function executeForeach(session, element) {
     const parser2 = new DiracParser2();
     try {
       const fromElement = parser2.parse(fromAttr);
-      const { integrate: integrate2 } = await import("./interpreter-GLWAQHAW.js");
+      const { integrate: integrate2 } = await import("./interpreter-UCWBT6KP.js");
       await integrate2(session, fromElement);
     } catch (e) {
       session.output = savedOutput;
@@ -1706,7 +2124,7 @@ async function executeEnvironment(session, element) {
 }
 
 // src/tags/input.ts
-import * as fs3 from "fs";
+import * as fs4 from "fs";
 import * as readline from "readline";
 var fileReaders = /* @__PURE__ */ new Map();
 var fileIterators = /* @__PURE__ */ new Map();
@@ -1730,11 +2148,11 @@ async function executeInput(session, element) {
       throw new Error(`<input> invalid mode: ${mode}. Use 'all' or 'line'`);
     }
   } else if (source === "file") {
-    const path2 = substituteAttribute(session, pathAttr);
+    const path3 = substituteAttribute(session, pathAttr);
     if (mode === "all") {
-      value = fs3.readFileSync(path2, "utf-8");
+      value = fs4.readFileSync(path3, "utf-8");
     } else if (mode === "line") {
-      value = await readLineFromFile(path2);
+      value = await readLineFromFile(path3);
     } else {
       throw new Error(`<input> invalid mode: ${mode}. Use 'all' or 'line'`);
     }
@@ -1791,23 +2209,23 @@ async function readLineStdin() {
   }
   return result.value;
 }
-async function readLineFromFile(path2) {
-  if (!fileReaders.has(path2)) {
-    const fileStream = fs3.createReadStream(path2);
+async function readLineFromFile(path3) {
+  if (!fileReaders.has(path3)) {
+    const fileStream = fs4.createReadStream(path3);
     const rl = readline.createInterface({
       input: fileStream,
       crlfDelay: Infinity
     });
-    fileReaders.set(path2, rl);
-    fileIterators.set(path2, rl[Symbol.asyncIterator]());
+    fileReaders.set(path3, rl);
+    fileIterators.set(path3, rl[Symbol.asyncIterator]());
   }
-  const iterator = fileIterators.get(path2);
+  const iterator = fileIterators.get(path3);
   const result = await iterator.next();
   if (result.done) {
-    const reader = fileReaders.get(path2);
+    const reader = fileReaders.get(path3);
     reader.close();
-    fileReaders.delete(path2);
-    fileIterators.delete(path2);
+    fileReaders.delete(path3);
+    fileIterators.delete(path3);
     return "";
   }
   return result.value;
@@ -1902,6 +2320,21 @@ async function integrate(session, element) {
       case "available-subroutines":
         await executeAvailableSubroutines(session, element);
         break;
+      case "list-subroutines":
+        await executeListSubroutines(session, element);
+        break;
+      case "index-subroutines":
+        await executeIndexSubroutines(session, element);
+        break;
+      case "search-subroutines":
+        await executeSearchSubroutines(session, element);
+        break;
+      case "registry-stats":
+        await executeRegistryStats(session, element);
+        break;
+      case "load-context":
+        await executeLoadContext(session, element);
+        break;
       case "foreach":
         await executeForeach(session, element);
         break;

package/dist/{chunk-E66LTAOE.js → chunk-UEFKQRYN.js}

@@ -277,15 +277,37 @@ var BraKetParser = class {
     }
     return `"${value}"`;
   }
+  /**
+   * Escape XML special characters in text content
+   */
+  escapeXml(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  }
   /**
    * Convert inline kets within text content
    * Example: "Hello |variable name=x> world" → "Hello <variable name="x"/> world"
+   * Example: "if x < 10 and y > 5" → "if x &lt; 10 and y &gt; 5"
    */
   convertInlineKets(text) {
-    return text.replace(/\|([a-zA-Z_][a-zA-Z0-9_-]*)\s*([^>]*?)>/g, (match, tag, attrs) => {
+    const parts = [];
+    let lastIndex = 0;
+    const ketRegex = /\|([a-zA-Z_][a-zA-Z0-9_-]*)\s*([^>]*?)>/g;
+    let match;
+    while ((match = ketRegex.exec(text)) !== null) {
+      if (match.index > lastIndex) {
+        const beforeText = text.substring(lastIndex, match.index);
+        parts.push(this.escapeXml(beforeText));
+      }
+      const [, tag, attrs] = match;
       const attrStr = attrs.trim() ? ` ${this.convertAttributes(attrs.trim())}` : "";
-      return `<${tag}${attrStr}/>`;
-    });
+      parts.push(`<${tag}${attrStr}/>`);
+      lastIndex = ketRegex.lastIndex;
+    }
+    if (lastIndex < text.length) {
+      const remainingText = text.substring(lastIndex);
+      parts.push(this.escapeXml(remainingText));
+    }
+    return parts.join("");
   }
 };
 

package/dist/{chunk-4J2UJXJZ.js → chunk-W6BEEC5D.js}

@@ -1,6 +1,6 @@
 import {
   integrate
-} from "./chunk-MVMLG434.js";
+} from "./chunk-NWGHO23V.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   BraKetParser
-} from "./chunk-E66LTAOE.js";
+} from "./chunk-UEFKQRYN.js";
 import {
   execute
-} from "./chunk-4J2UJXJZ.js";
-import "./chunk-MVMLG434.js";
+} from "./chunk-W6BEEC5D.js";
+import "./chunk-NWGHO23V.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-4QLTSCDG.js";
 import "./chunk-GLXVY235.js";
@@ -16,7 +16,7 @@ import "dotenv/config";
 // package.json
 var package_default = {
   name: "dirac-lang",
-  version: "0.1.37",
+  version: "0.1.38",
   description: "LLM-Augmented Declarative Execution",
   type: "module",
   main: "dist/index.js",
@@ -46,6 +46,7 @@ var package_default = {
   license: "MIT",
   dependencies: {
     "@anthropic-ai/sdk": "^0.30.1",
+    "dirac-stdlib": "^0.1.0",
     dotenv: "^17.2.3",
     "fast-xml-parser": "^4.3.5",
     "js-yaml": "^4.1.1",
@@ -95,7 +96,7 @@ async function main() {
     process.exit(0);
   }
   if (args[0] === "shell") {
-    const { DiracShell } = await import("./shell-B5RBRWK2.js");
+    const { DiracShell } = await import("./shell-T5G3PTPT.js");
     const shellConfig = { debug: false };
     for (let i = 1; i < args.length; i++) {
       const arg = args[i];
@@ -108,7 +109,8 @@ async function main() {
           Object.assign(shellConfig, {
             llmProvider: configData.llmProvider,
             llmModel: configData.llmModel,
-            customLLMUrl: configData.customLLMUrl
+            customLLMUrl: configData.customLLMUrl,
+            initScript: configData.initScript
           });
         }
       }
@@ -121,12 +123,13 @@ async function main() {
           shellConfig.llmProvider = shellConfig.llmProvider || configData.llmProvider;
           shellConfig.llmModel = shellConfig.llmModel || configData.llmModel;
           shellConfig.customLLMUrl = shellConfig.customLLMUrl || configData.customLLMUrl;
+          shellConfig.initScript = shellConfig.initScript || configData.initScript;
         } catch (err) {
         }
       }
     }
     const shell = new DiracShell(shellConfig);
-    shell.start();
+    await shell.start();
     return;
   }
   if (args.length === 0) {

package/dist/index.d.ts

@@ -95,6 +95,7 @@ interface DiracConfig {
     llmProvider?: string;
     llmModel?: string;
     customLLMUrl?: string;
+    initScript?: string;
 }
 
 /**

package/dist/index.js

@@ -2,10 +2,10 @@ import {
   createLLMAdapter,
   execute,
   executeUserCommand
-} from "./chunk-4J2UJXJZ.js";
+} from "./chunk-W6BEEC5D.js";
 import {
   integrate
-} from "./chunk-MVMLG434.js";
+} from "./chunk-NWGHO23V.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";

package/dist/{interpreter-GLWAQHAW.js → interpreter-UCWBT6KP.js}

@@ -1,7 +1,7 @@
 import {
   integrate,
   integrateChildren
-} from "./chunk-MVMLG434.js";
+} from "./chunk-NWGHO23V.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-4QLTSCDG.js";
 import "./chunk-GLXVY235.js";

package/dist/{shell-B5RBRWK2.js → shell-T5G3PTPT.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   BraKetParser
-} from "./chunk-E66LTAOE.js";
+} from "./chunk-UEFKQRYN.js";
 import {
   integrate
-} from "./chunk-MVMLG434.js";
+} from "./chunk-NWGHO23V.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
@@ -185,6 +185,10 @@ Commands:
   :clear          Clear session (reset variables and subroutines)
   :debug          Toggle debug mode
   :config         Show current configuration
+  :index <path>   Index subroutines from directory
+  :search <query> Search indexed subroutines
+  :load <query>   Load context (search and import subroutines)
+  :stats          Show registry statistics
   :exit           Exit shell
 
 Syntax:
@@ -255,6 +259,69 @@ Examples:
           console.log(`  Custom LLM URL: ${this.config.customLLMUrl}`);
         }
         break;
+      case "index":
+        if (args.length === 0) {
+          console.log("Usage: :index <path>");
+        } else {
+          const indexPath = args[0];
+          try {
+            const xml = `<index-subroutines path="${indexPath}" />`;
+            const ast = this.xmlParser.parse(xml);
+            await integrate(this.session, ast);
+            if (this.session.output.length > 0) {
+              console.log(this.session.output.join(""));
+            }
+          } catch (error) {
+            console.error("Error indexing:", error instanceof Error ? error.message : String(error));
+          }
+        }
+        break;
+      case "search":
+        if (args.length === 0) {
+          console.log("Usage: :search <query>");
+        } else {
+          const query = args.join(" ");
+          try {
+            const xml = `<search-subroutines query="${query}" format="text" />`;
+            const ast = this.xmlParser.parse(xml);
+            await integrate(this.session, ast);
+            if (this.session.output.length > 0) {
+              console.log(this.session.output.join(""));
+            }
+          } catch (error) {
+            console.error("Error searching:", error instanceof Error ? error.message : String(error));
+          }
+        }
+        break;
+      case "load":
+        if (args.length === 0) {
+          console.log("Usage: :load <query>");
+        } else {
+          const query = args.join(" ");
+          try {
+            const xml = `<load-context query="${query}" limit="5" import="true" />`;
+            const ast = this.xmlParser.parse(xml);
+            await integrate(this.session, ast);
+            if (this.session.output.length > 0) {
+              console.log(this.session.output.join(""));
+            }
+          } catch (error) {
+            console.error("Error loading context:", error instanceof Error ? error.message : String(error));
+          }
+        }
+        break;
+      case "stats":
+        try {
+          const xml = "<registry-stats />";
+          const ast = this.xmlParser.parse(xml);
+          await integrate(this.session, ast);
+          if (this.session.output.length > 0) {
+            console.log(this.session.output.join(""));
+          }
+        } catch (error) {
+          console.error("Error getting stats:", error instanceof Error ? error.message : String(error));
+        }
+        break;
       case "exit":
       case "quit":
         this.rl.close();
@@ -318,7 +385,7 @@ Examples:
       });
     });
   }
-  start() {
+  async start() {
     console.log("Dirac Shell v0.1.0");
     console.log("Type :help for commands, :exit to quit\n");
     if (this.config.llmProvider) {
@@ -327,8 +394,31 @@ Examples:
     } else {
       console.log("Warning: No LLM provider configured. Set LLM_PROVIDER environment variable.\n");
     }
+    if (this.config.initScript) {
+      await this.runInitScript(this.config.initScript);
+    }
     this.rl.prompt();
   }
+  async runInitScript(scriptPath) {
+    try {
+      const resolvedPath = path.isAbsolute(scriptPath) ? scriptPath : path.join(process.cwd(), scriptPath);
+      if (!fs.existsSync(resolvedPath)) {
+        console.log(`Init script not found: ${scriptPath}
+`);
+        return;
+      }
+      console.log(`Loading init script: ${scriptPath}`);
+      const scriptContent = fs.readFileSync(resolvedPath, "utf-8");
+      const xml = this.braketParser.parse(scriptContent);
+      const ast = this.xmlParser.parse(xml);
+      await integrate(this.session, ast);
+      console.log(`Init script loaded.
+`);
+    } catch (err) {
+      console.error(`Error loading init script: ${err instanceof Error ? err.message : String(err)}
+`);
+    }
+  }
 };
 async function main() {
   let config = {
@@ -342,7 +432,8 @@ async function main() {
         ...config,
         llmProvider: configData.llmProvider || process.env.LLM_PROVIDER,
         llmModel: configData.llmModel || process.env.LLM_MODEL,
-        customLLMUrl: configData.customLLMUrl || process.env.CUSTOM_LLM_URL
+        customLLMUrl: configData.customLLMUrl || process.env.CUSTOM_LLM_URL,
+        initScript: configData.initScript
       };
     } catch (err) {
       console.error("Warning: Could not load config.yml");
@@ -353,7 +444,7 @@ async function main() {
     config.customLLMUrl = process.env.CUSTOM_LLM_URL;
   }
   const shell = new DiracShell(config);
-  shell.start();
+  await shell.start();
 }
 if (import.meta.url === `file://${process.argv[1]}`) {
   main();

package/dist/test-runner.js

@@ -1,6 +1,6 @@
 import {
   integrate
-} from "./chunk-MVMLG434.js";
+} from "./chunk-NWGHO23V.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirac-lang",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "description": "LLM-Augmented Declarative Execution",
   "type": "module",
   "main": "dist/index.js",
@@ -30,6 +30,7 @@
   "license": "MIT",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.30.1",
+    "dirac-stdlib": "^0.1.0",
     "dotenv": "^17.2.3",
     "fast-xml-parser": "^4.3.5",
     "js-yaml": "^4.1.1",