dirac-lang 0.1.99 → 0.1.100

package/README.md

@@ -252,6 +252,21 @@ Dirac is more than a language—it's a **paradigm shift** in how we think about
 npm install -g dirac-lang
 ```
 
+## Documentation
+
+For detailed guides on using Dirac:
+
+- **[Getting Started](GETTING-STARTED.md)** - Installation and first programs
+- **[Quick Start Library Guide](QUICKSTART-LIBRARY.md)** - Building reusable libraries
+- **[LLM Integration](LLM-DIALOG-CONTEXT.md)** - Working with LLMs in Dirac
+- **[Subroutine Management](SUBROUTINE-MANAGEMENT.md)** - Stack operations and subroutine control
+- **[Training Data Export](TRAINING-DATA-EXPORT.md)** - Creating fine-tuning datasets
+- **[Debugging](DEBUGGING.md)** - Debug mode and troubleshooting
+- **[Exception Handling](EXCEPTION-HANDLING.md)** - Error handling and recovery
+- **[Namespaces](NAMESPACES.md)** - Organizing code with namespaces
+- **[Libraries](LIBRARIES.md)** - Using and creating libraries
+- **[Conditional Tags](CONDITIONAL-TAGS.md)** - Control flow patterns
+
 ---
 
 *"In the quantum realm, a bra meets a ket to produce reality. In Dirac, a declaration meets an LLM to produce execution."*

package/dist/{agent-3SJF56JW.js → agent-CWCOOLLO.js}

@@ -2,8 +2,8 @@ import {
   SessionServer,
   getSocketPath,
   isSessionRunning
-} from "./chunk-R6R6OHPA.js";
-import "./chunk-3VCKPUTQ.js";
+} from "./chunk-TIQ36H2U.js";
+import "./chunk-OUCAV57A.js";
 import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-EAM7IZWA.js";

package/dist/{chunk-EE3YBMAD.js → chunk-7MSWEFH5.js}

@@ -1,6 +1,6 @@
 import {
   integrate
-} from "./chunk-3VCKPUTQ.js";
+} from "./chunk-OUCAV57A.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";

package/dist/{chunk-3VCKPUTQ.js → chunk-OUCAV57A.js}

@@ -487,12 +487,12 @@ async function executeIf(session, element) {
   const condition = await evaluatePredicate(session, conditionElement);
   if (condition) {
     if (thenElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-ENHZAIWT.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
       await integrateChildren2(session, thenElement);
     }
   } else {
     if (elseElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-ENHZAIWT.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
       await integrateChildren2(session, elseElement);
     }
   }
@@ -505,7 +505,7 @@ async function evaluatePredicate(session, predicateElement) {
     return await evaluateCondition(session, predicateElement);
   }
   const outputLengthBefore = session.output.length;
-  const { integrate: integrate2 } = await import("./interpreter-ENHZAIWT.js");
+  const { integrate: integrate2 } = await import("./interpreter-KOWJFLNS.js");
   await integrate2(session, predicateElement);
   const newOutputChunks = session.output.slice(outputLengthBefore);
   const result = newOutputChunks.join("").trim();
@@ -528,11 +528,11 @@ async function evaluateCondition(session, condElement) {
   }
   const outputLengthBefore = session.output.length;
   const args = [];
-  const { integrate: integrate2 } = await import("./interpreter-ENHZAIWT.js");
+  const { integrate: integrate2 } = await import("./interpreter-KOWJFLNS.js");
   for (const child of condElement.children) {
     if (child.tag.toLowerCase() === "arg") {
       const argOutputStart = session.output.length;
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-ENHZAIWT.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
       await integrateChildren2(session, child);
       const newChunks = session.output.slice(argOutputStart);
       const argValue = newChunks.join("");
@@ -1053,6 +1053,13 @@ ${result}
       const maxRetries = parseInt(element.attributes["max-retries"] || "0", 10);
       const feedbackMode = element.attributes["feedback"] === "true";
       const confirmCorrections = element.attributes["confirm-corrections"] === "true";
+      console.error(`
+${"=".repeat(60)}`);
+      console.error(`[LLM Original Response]`);
+      console.error(`${"=".repeat(60)}`);
+      console.error(result);
+      console.error(`${"=".repeat(60)}
+`);
       console.error(`[LLM] Execute mode - validate: ${validateTags}, autocorrect: ${autocorrect}, feedback: ${feedbackMode}, confirm-corrections: ${confirmCorrections}, debug: ${session.debug}`);
       const maxIterationsAttr = substituteAttribute(session, element.attributes["max-iterations"] || "3");
       const maxIterations = parseInt(maxIterationsAttr, 10);
@@ -1098,7 +1105,7 @@ ${result}
             if (session.debug) {
               console.error(`[LLM] Validation enabled, autocorrect: ${autocorrect}`);
             }
-            const { validateDiracCode, applyCorrectedTags } = await import("./tag-validator-QS7T4GFE.js");
+            const { validateDiracCode, applyCorrectedTags } = await import("./tag-validator-PWJG4OAM.js");
             let validation = await validateDiracCode(session, dynamicAST, { autocorrect, deepValidation: true });
             console.error(`[LLM] Iteration ${iteration}: Validation complete - valid: ${validation.valid}, errors: ${validation.errorMessages.length}`);
             if (session.debug) {
@@ -1132,7 +1139,7 @@ ${result}
               if (correctionMessages.length > 0) {
                 console.error("[LLM] Corrections:", correctionMessages.join("; "));
               }
-              dynamicAST = applyCorrectedTags(dynamicAST, validation.results);
+              dynamicAST = applyCorrectedTags(session, dynamicAST, validation.results);
               console.error("[LLM] Applied initial auto-corrections to AST");
               validation = await validateDiracCode(session, dynamicAST, { autocorrect: false, deepValidation: true });
               console.error(`[LLM] Re-validation after corrections: valid=${validation.valid}`);
@@ -1183,6 +1190,13 @@ Please fix these errors and generate valid Dirac XML again. Remember to only use
               } else if (saveDialog) {
                 setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
               }
+              console.error(`
+${"=".repeat(60)}`);
+              console.error(`[LLM Original Response - Retry ${retryCount}]`);
+              console.error(`${"=".repeat(60)}`);
+              console.error(result);
+              console.error(`${"=".repeat(60)}
+`);
               if (session.debug) {
                 console.error(`[LLM] Retry ${retryCount} response:
 ${result}
@@ -1266,6 +1280,13 @@ If you resubmit this corrected code, I will execute it for you. Please review an
                 } else if (saveDialog) {
                   setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
                 }
+                console.error(`
+${"=".repeat(60)}`);
+                console.error(`[LLM Original Response - Confirmation]`);
+                console.error(`${"=".repeat(60)}`);
+                console.error(result);
+                console.error(`${"=".repeat(60)}
+`);
                 console.error(`[LLM] LLM confirmation response:
 ${result}
 `);
@@ -1343,6 +1364,13 @@ Please fix the error and try again.`;
               } else if (saveDialog) {
                 setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
               }
+              console.error(`
+${"=".repeat(60)}`);
+              console.error(`[LLM Original Response - After Error]`);
+              console.error(`${"=".repeat(60)}`);
+              console.error(result);
+              console.error(`${"=".repeat(60)}
+`);
               continue;
             } else {
               throw execError;
@@ -1428,6 +1456,13 @@ ${feedbackPrompt}
             } else if (saveDialog) {
               setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
             }
+            console.error(`
+${"=".repeat(60)}`);
+            console.error(`[LLM Original Response - Feedback Loop]`);
+            console.error(`${"=".repeat(60)}`);
+            console.error(result);
+            console.error(`${"=".repeat(60)}
+`);
             if (session.debug) {
               console.error(`[LLM] Feedback response:
 ${result}
@@ -1494,6 +1529,13 @@ Please fix these errors and generate valid Dirac XML code. Remember:
             } else if (saveDialog) {
               setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
             }
+            console.error(`
+${"=".repeat(60)}`);
+            console.error(`[LLM Original Response - After Parse Error]`);
+            console.error(`${"=".repeat(60)}`);
+            console.error(result);
+            console.error(`${"=".repeat(60)}
+`);
             if (session.debug) {
               console.error(`[LLM] LLM correction response:
 ${result}
@@ -2061,7 +2103,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-ENHZAIWT.js");
+      const { integrate: integrate2 } = await import("./interpreter-KOWJFLNS.js");
       await integrate2(session, elementToExecute);
     }
   }
@@ -2070,7 +2112,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-ENHZAIWT.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
   const exceptionDom = {
     tag: "exception-content",
     attributes: { name: exceptionName },
@@ -2083,7 +2125,7 @@ async function executeThrow(session, element) {
 // src/tags/try.ts
 async function executeTry(session, element) {
   setExceptionBoundary(session);
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-ENHZAIWT.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
   await integrateChildren2(session, element);
   unsetExceptionBoundary(session);
 }
@@ -2093,7 +2135,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-ENHZAIWT.js");
+    const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
     await integrateChildren2(session, element);
   }
   flushCurrentException(session);
@@ -2102,7 +2144,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-ENHZAIWT.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
   for (const exceptionDom of exceptions) {
     await integrateChildren2(session, exceptionDom);
   }
@@ -2303,7 +2345,7 @@ async function executeLoadContext(session, element) {
     query = element.text.trim();
   }
   if (!query && element.children.length > 0) {
-    const { integrate: integrate2 } = await import("./interpreter-ENHZAIWT.js");
+    const { integrate: integrate2 } = await import("./interpreter-KOWJFLNS.js");
     const beforeOutput = session.output.length;
     for (const child of element.children) {
       await integrate2(session, child);
@@ -3147,7 +3189,7 @@ async function executeForeach(session, element) {
     const parser2 = new DiracParser2();
     try {
       const fromElement = parser2.parse(fromAttr);
-      const { integrate: integrate2 } = await import("./interpreter-ENHZAIWT.js");
+      const { integrate: integrate2 } = await import("./interpreter-KOWJFLNS.js");
       await integrate2(session, fromElement);
     } catch (e) {
       session.output = savedOutput;

package/dist/{chunk-R6R6OHPA.js → chunk-TIQ36H2U.js}

@@ -1,6 +1,6 @@
 import {
   integrate
-} from "./chunk-3VCKPUTQ.js";
+} from "./chunk-OUCAV57A.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   execute
-} from "./chunk-EE3YBMAD.js";
+} from "./chunk-7MSWEFH5.js";
 import {
   BraKetParser
-} from "./chunk-3VCKPUTQ.js";
+} from "./chunk-OUCAV57A.js";
 import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-EAM7IZWA.js";
@@ -16,7 +16,7 @@ import "dotenv/config";
 // package.json
 var package_default = {
   name: "dirac-lang",
-  version: "0.1.98",
+  version: "0.1.99",
   description: "LLM-Augmented Declarative Execution",
   type: "module",
   main: "dist/index.js",
@@ -150,7 +150,7 @@ async function main() {
   const args = process.argv.slice(2);
   const calledAs = process.argv[1];
   if (calledAs && calledAs.endsWith("/dish")) {
-    const { DiracShell } = await import("./shell-PV6KIJL5.js");
+    const { DiracShell } = await import("./shell-GXXSZYY7.js");
     const shellConfig = loadShellConfig(args);
     const shell = new DiracShell(shellConfig);
     await shell.start();
@@ -199,11 +199,11 @@ async function main() {
   if (args[0] === "agent") {
     const subcommand = args[1];
     if (subcommand === "daemon") {
-      const { runAgentDaemon } = await import("./agent-3SJF56JW.js");
+      const { runAgentDaemon } = await import("./agent-CWCOOLLO.js");
       await runAgentDaemon();
       return;
     }
-    const { AgentCLI } = await import("./agent-3SJF56JW.js");
+    const { AgentCLI } = await import("./agent-CWCOOLLO.js");
     const agent = new AgentCLI();
     switch (subcommand) {
       case "start":
@@ -230,8 +230,8 @@ async function main() {
     return;
   }
   if (args[0] === "shell") {
-    const { DiracShell } = await import("./shell-PV6KIJL5.js");
-    const { SessionServer, isSessionRunning, getSocketPath } = await import("./session-server-LMDDND5E.js");
+    const { DiracShell } = await import("./shell-GXXSZYY7.js");
+    const { SessionServer, isSessionRunning, getSocketPath } = await import("./session-server-QXL2SQWJ.js");
     const { SessionClient } = await import("./session-client-3VTC5MLO.js");
     const daemonMode = args.includes("--daemon") || args.includes("-d");
     const agentMode = args.includes("--agent") || args.includes("-a");
@@ -277,7 +277,7 @@ async function main() {
     return;
   }
   if (args[0] === "daemon") {
-    const { SessionServer } = await import("./session-server-LMDDND5E.js");
+    const { SessionServer } = await import("./session-server-QXL2SQWJ.js");
     const server = new SessionServer();
     await server.start();
     console.log("Session daemon started");

package/dist/{cron-TTPFON3Y.js → cron-3W32GKBD.js}

@@ -3,7 +3,7 @@ import {
   listCronJobs,
   stopAllCronJobs,
   stopCronJob
-} from "./chunk-3VCKPUTQ.js";
+} from "./chunk-OUCAV57A.js";
 import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-EAM7IZWA.js";

package/dist/index.js

@@ -2,10 +2,10 @@ import {
   createLLMAdapter,
   execute,
   executeUserCommand
-} from "./chunk-EE3YBMAD.js";
+} from "./chunk-7MSWEFH5.js";
 import {
   integrate
-} from "./chunk-3VCKPUTQ.js";
+} from "./chunk-OUCAV57A.js";
 import "./chunk-53QJQ2CC.js";
 import {
   DiracParser

package/dist/{interpreter-ENHZAIWT.js → interpreter-KOWJFLNS.js}

@@ -1,7 +1,7 @@
 import {
   integrate,
   integrateChildren
-} from "./chunk-3VCKPUTQ.js";
+} from "./chunk-OUCAV57A.js";
 import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-EAM7IZWA.js";

package/dist/{run-at-A3CJX4TR.js → run-at-S37OQ7RA.js}

@@ -3,7 +3,7 @@ import {
   cancelScheduledRun,
   executeRunAt,
   listScheduledRuns
-} from "./chunk-3VCKPUTQ.js";
+} from "./chunk-OUCAV57A.js";
 import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-EAM7IZWA.js";

package/dist/{schedule-OYEKDXZV.js → schedule-6RWIIII3.js}

@@ -3,7 +3,7 @@ import {
   listScheduledTasks,
   stopAllScheduledTasks,
   stopScheduledTask
-} from "./chunk-3VCKPUTQ.js";
+} from "./chunk-OUCAV57A.js";
 import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-EAM7IZWA.js";

package/dist/{session-server-LMDDND5E.js → session-server-QXL2SQWJ.js}

@@ -2,8 +2,8 @@ import {
   SessionServer,
   getSocketPath,
   isSessionRunning
-} from "./chunk-R6R6OHPA.js";
-import "./chunk-3VCKPUTQ.js";
+} from "./chunk-TIQ36H2U.js";
+import "./chunk-OUCAV57A.js";
 import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-EAM7IZWA.js";

package/dist/{shell-PV6KIJL5.js → shell-GXXSZYY7.js}

@@ -2,7 +2,7 @@
 import {
   BraKetParser,
   integrate
-} from "./chunk-3VCKPUTQ.js";
+} from "./chunk-OUCAV57A.js";
 import "./chunk-53QJQ2CC.js";
 import {
   DiracParser
@@ -358,7 +358,7 @@ var DiracShell = class {
     if (this.client) {
       this.client.disconnect();
     }
-    import("./schedule-OYEKDXZV.js").then(({ stopAllScheduledTasks }) => {
+    import("./schedule-6RWIIII3.js").then(({ stopAllScheduledTasks }) => {
       stopAllScheduledTasks();
       console.log("\nGoodbye!");
       process.exit(0);
@@ -818,7 +818,7 @@ Examples:
         break;
       case "tasks":
         try {
-          const { listScheduledTasks } = await import("./schedule-OYEKDXZV.js");
+          const { listScheduledTasks } = await import("./schedule-6RWIIII3.js");
           const tasks = listScheduledTasks();
           if (tasks.length === 0) {
             console.log("No scheduled tasks running.");
@@ -837,7 +837,7 @@ Examples:
           console.log("Usage: :stop <task-name>");
         } else {
           try {
-            const { stopScheduledTask } = await import("./schedule-OYEKDXZV.js");
+            const { stopScheduledTask } = await import("./schedule-6RWIIII3.js");
             const taskName = args[0];
             const stopped = stopScheduledTask(taskName);
             if (stopped) {
@@ -852,7 +852,7 @@ Examples:
         break;
       case "stopall":
         try {
-          const { stopAllScheduledTasks } = await import("./schedule-OYEKDXZV.js");
+          const { stopAllScheduledTasks } = await import("./schedule-6RWIIII3.js");
           stopAllScheduledTasks();
           console.log("All scheduled tasks stopped.");
         } catch (error) {
@@ -861,7 +861,7 @@ Examples:
         break;
       case "crons":
         try {
-          const { listCronJobs } = await import("./cron-TTPFON3Y.js");
+          const { listCronJobs } = await import("./cron-3W32GKBD.js");
           const jobs = listCronJobs();
           if (jobs.length === 0) {
             console.log("No cron jobs running.");
@@ -881,7 +881,7 @@ Examples:
           console.log("Usage: :stopcron <job-name>");
         } else {
           try {
-            const { stopCronJob } = await import("./cron-TTPFON3Y.js");
+            const { stopCronJob } = await import("./cron-3W32GKBD.js");
             const jobName = args[0];
             const stopped = stopCronJob(jobName);
             if (stopped) {
@@ -896,7 +896,7 @@ Examples:
         break;
       case "stopallcrons":
         try {
-          const { stopAllCronJobs } = await import("./cron-TTPFON3Y.js");
+          const { stopAllCronJobs } = await import("./cron-3W32GKBD.js");
           stopAllCronJobs();
           console.log("All cron jobs stopped.");
         } catch (error) {
@@ -905,7 +905,7 @@ Examples:
         break;
       case "scheduled":
         try {
-          const { listScheduledRuns } = await import("./run-at-A3CJX4TR.js");
+          const { listScheduledRuns } = await import("./run-at-S37OQ7RA.js");
           const runs = listScheduledRuns();
           if (runs.length === 0) {
             console.log("No scheduled runs pending.");
@@ -925,7 +925,7 @@ Examples:
           console.log("Usage: :cancel <run-name>");
         } else {
           try {
-            const { cancelScheduledRun } = await import("./run-at-A3CJX4TR.js");
+            const { cancelScheduledRun } = await import("./run-at-S37OQ7RA.js");
             const runName = args[0];
             const cancelled = cancelScheduledRun(runName);
             if (cancelled) {
@@ -940,7 +940,7 @@ Examples:
         break;
       case "cancelall":
         try {
-          const { cancelAllScheduledRuns } = await import("./run-at-A3CJX4TR.js");
+          const { cancelAllScheduledRuns } = await import("./run-at-S37OQ7RA.js");
           cancelAllScheduledRuns();
           console.log("All scheduled runs cancelled.");
         } catch (error) {

package/dist/{tag-validator-QS7T4GFE.js → tag-validator-PWJG4OAM.js}

@@ -108,7 +108,9 @@ async function validateNestedTags(session, element, options = {}) {
 }
 async function validateTag(session, element, options = {}) {
   const { autocorrect = false, similarityCutoff = SIMILARITY_CUTOFF, deepValidation = false } = options;
-  console.error(`[VALIDATE] Tag: <${element.tag}>, autocorrect: ${autocorrect}, attributes:`, Object.keys(element.attributes));
+  if (session.debug) {
+    console.error(`[VALIDATE] Tag: <${element.tag}>, autocorrect: ${autocorrect}, attributes:`, Object.keys(element.attributes));
+  }
   const { getAvailableSubroutines } = await import("./session-6WX5O74B.js");
   const subroutines = getAvailableSubroutines(session);
   const allowed = new Set(subroutines.map((s) => s.name));
@@ -126,11 +128,15 @@ async function validateTag(session, element, options = {}) {
     scopeValidation: void 0
   };
   if (allowed.has(tagName)) {
-    console.error(`[VALIDATE] Tag <${tagName}> is valid`);
+    if (session.debug) {
+      console.error(`[VALIDATE] Tag <${tagName}> is valid`);
+    }
     const sub = subroutines.find((s) => s.name === tagName);
     if (sub && Array.isArray(sub.parameters)) {
       const paramNames = sub.parameters.map((p) => p.name);
-      console.error(`[VALIDATE] Tag <${tagName}> has ${paramNames.length} parameters:`, paramNames);
+      if (session.debug) {
+        console.error(`[VALIDATE] Tag <${tagName}> has ${paramNames.length} parameters:`, paramNames);
+      }
       for (const param of sub.parameters) {
         if (param.required && !(param.name in element.attributes)) {
           result.errors.push(`Missing required parameter: ${param.name}`);
@@ -138,11 +144,15 @@ async function validateTag(session, element, options = {}) {
       }
       for (const attr in element.attributes) {
         if (tagName === "subroutine" && (attr.startsWith("param-") || attr.startsWith("meta-"))) {
-          console.error(`[VALIDATE] Skipping validation for wildcard attribute '${attr}' on <subroutine>`);
+          if (session.debug) {
+            console.error(`[VALIDATE] Skipping validation for wildcard attribute '${attr}' on <subroutine>`);
+          }
           continue;
         }
         if (!paramNames.includes(attr)) {
-          console.error(`[VALIDATE] Unknown attribute '${attr}' on <${tagName}>`);
+          if (session.debug) {
+            console.error(`[VALIDATE] Unknown attribute '${attr}' on <${tagName}>`);
+          }
           if (autocorrect && paramNames.length > 0) {
             let correctedAttr = null;
             let similarityScore = 0;
@@ -152,21 +162,31 @@ async function validateTag(session, element, options = {}) {
               result.attributeCorrections[attr] = correctedAttr;
               result.corrected = true;
               result.warnings.push(`Auto-corrected attribute: ${attr}="${element.attributes[attr]}" \u2192 ${correctedAttr}="${element.attributes[attr]}" (only parameter available)`);
-              console.error(`[VALIDATE] Auto-corrected (single param): ${attr} \u2192 ${correctedAttr}`);
+              if (session.debug) {
+                console.error(`[VALIDATE] Auto-corrected (single param): ${attr} \u2192 ${correctedAttr}`);
+              }
             } else {
-              console.error(`[VALIDATE] Checking similarity for '${attr}' against:`, paramNames);
+              if (session.debug) {
+                console.error(`[VALIDATE] Checking similarity for '${attr}' against:`, paramNames);
+              }
               const best = await getBestTagMatch(attr, paramNames);
-              console.error(`[VALIDATE] Best match: ${best.tag} with score ${best.score.toFixed(2)}, cutoff: ${similarityCutoff}`);
+              if (session.debug) {
+                console.error(`[VALIDATE] Best match: ${best.tag} with score ${best.score.toFixed(2)}, cutoff: ${similarityCutoff}`);
+              }
               if (best.score >= similarityCutoff) {
                 correctedAttr = best.tag;
                 similarityScore = best.score;
                 result.attributeCorrections[attr] = correctedAttr;
                 result.corrected = true;
                 result.warnings.push(`Auto-corrected attribute: ${attr}="${element.attributes[attr]}" \u2192 ${correctedAttr}="${element.attributes[attr]}" (similarity: ${similarityScore.toFixed(2)})`);
-                console.error(`[VALIDATE] Auto-corrected (similarity): ${attr} \u2192 ${correctedAttr}`);
+                if (session.debug) {
+                  console.error(`[VALIDATE] Auto-corrected (similarity): ${attr} \u2192 ${correctedAttr}`);
+                }
               } else {
                 result.warnings.push(`Unknown attribute: ${attr} (no similar match found, best: ${best.tag} with score ${best.score.toFixed(2)})`);
-                console.error(`[VALIDATE] No correction (score too low): ${attr}, best was ${best.tag} (${best.score.toFixed(2)})`);
+                if (session.debug) {
+                  console.error(`[VALIDATE] No correction (score too low): ${attr}, best was ${best.tag} (${best.score.toFixed(2)})`);
+                }
               }
             }
           } else {
@@ -193,7 +213,9 @@ async function validateTag(session, element, options = {}) {
         }
       }
       if (deepValidation && tagName === "subroutine" && element.children && element.children.length > 0) {
-        console.error(`[VALIDATE] Deep validation of <subroutine name="${element.attributes.name}">`);
+        if (session.debug) {
+          console.error(`[VALIDATE] Deep validation of <subroutine name="${element.attributes.name}">`);
+        }
         result.nestedValidation = await validateNestedTags(session, element, options);
         for (const nestedResult of result.nestedValidation) {
           if (!nestedResult.valid) {
@@ -202,14 +224,16 @@ async function validateTag(session, element, options = {}) {
         }
         const { validateSubroutineScope } = await import("./scope-validator-TVQIOEAI.js");
         result.scopeValidation = validateSubroutineScope(element);
-        console.error(`[VALIDATE] Scope validation for <subroutine name="${element.attributes.name}">:`, {
-          errors: result.scopeValidation.errors.length,
-          warnings: result.scopeValidation.warnings.length,
-          undefinedParams: result.scopeValidation.undefinedParameters,
-          undefinedVars: result.scopeValidation.undefinedVariables,
-          unusedParams: result.scopeValidation.unusedParameters,
-          unusedVars: result.scopeValidation.unusedVariables
-        });
+        if (session.debug) {
+          console.error(`[VALIDATE] Scope validation for <subroutine name="${element.attributes.name}">:`, {
+            errors: result.scopeValidation.errors.length,
+            warnings: result.scopeValidation.warnings.length,
+            undefinedParams: result.scopeValidation.undefinedParameters,
+            undefinedVars: result.scopeValidation.undefinedVariables,
+            unusedParams: result.scopeValidation.unusedParameters,
+            unusedVars: result.scopeValidation.unusedVariables
+          });
+        }
         if (result.scopeValidation.warnings.length > 0) {
           result.warnings.push(...result.scopeValidation.warnings.map((w) => `Scope: ${w}`));
         }
@@ -282,7 +306,7 @@ async function validateDiracCode(session, ast, options = {}) {
     }
   }
   extractLocalSubroutines(ast);
-  if (localSubroutineNames.size > 0) {
+  if (localSubroutineNames.size > 0 && session.debug) {
     console.error(`[VALIDATE] Found ${localSubroutineNames.size} local subroutine definitions:`, Array.from(localSubroutineNames));
   }
   const tempSubroutines = [];
@@ -303,7 +327,9 @@ async function validateDiracCode(session, ast, options = {}) {
         });
       }
     }
-    console.error(`[VALIDATE] Temp subroutine '${subName}' has ${parameters.length} parameters:`, parameters.map((p) => p.name));
+    if (session.debug) {
+      console.error(`[VALIDATE] Temp subroutine '${subName}' has ${parameters.length} parameters:`, parameters.map((p) => p.name));
+    }
     const tempSub = {
       name: subName,
       element: subElement,
@@ -342,30 +368,36 @@ async function validateDiracCode(session, ast, options = {}) {
     typeErrors
   };
 }
-function applyCorrectedTags(ast, results) {
+function applyCorrectedTags(session, ast, results) {
   let resultIndex = 0;
   function correctElement(element) {
     const shouldProcess = element.tag && element.tag !== "dirac" && element.tag !== "DIRAC-ROOT" && element.tag.trim() !== "";
     if (shouldProcess && resultIndex < results.length) {
       const result = results[resultIndex++];
-      console.error(`[APPLY-CORRECTION] Processing <${element.tag}> with result #${resultIndex - 1} for <${result.originalTag}>, corrected: ${result.corrected}`);
+      if (session.debug) {
+        console.error(`[APPLY-CORRECTION] Processing <${element.tag}> with result #${resultIndex - 1} for <${result.originalTag}>, corrected: ${result.corrected}`);
+      }
       if (result.corrected && result.tagName !== element.tag) {
-        console.error(`[APPLY-CORRECTION] Tag: ${element.tag} \u2192 ${result.tagName}`);
+        if (session.debug) {
+          console.error(`[APPLY-CORRECTION] Tag: ${element.tag} \u2192 ${result.tagName}`);
+        }
         element = { ...element, tag: result.tagName };
       }
       if (result.attributeCorrections && Object.keys(result.attributeCorrections).length > 0) {
-        console.error(`[APPLY-CORRECTION] Attributes on <${element.tag}>:`, result.attributeCorrections);
+        if (session.debug) {
+          console.error(`[APPLY-CORRECTION] Attributes on <${element.tag}>:`, result.attributeCorrections);
+        }
         const newAttributes = {};
         for (const [oldAttr, value] of Object.entries(element.attributes)) {
           const newAttr = result.attributeCorrections[oldAttr] || oldAttr;
-          if (newAttr !== oldAttr) {
+          if (newAttr !== oldAttr && session.debug) {
             console.error(`[APPLY-CORRECTION]   ${oldAttr}="${value}" \u2192 ${newAttr}="${value}"`);
           }
           newAttributes[newAttr] = value;
         }
         element = { ...element, attributes: newAttributes };
       }
-    } else if (shouldProcess) {
+    } else if (shouldProcess && session.debug) {
       console.error(`[APPLY-CORRECTION] WARNING: No result for <${element.tag}> at index ${resultIndex} (total results: ${results.length})`);
     }
     return {

package/dist/test-runner.js

@@ -1,6 +1,6 @@
 import {
   integrate
-} from "./chunk-3VCKPUTQ.js";
+} from "./chunk-OUCAV57A.js";
 import "./chunk-53QJQ2CC.js";
 import {
   DiracParser

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirac-lang",
-  "version": "0.1.99",
+  "version": "0.1.100",
   "description": "LLM-Augmented Declarative Execution",
   "type": "module",
   "main": "dist/index.js",