dirac-lang 0.1.20 → 0.1.22

package/dist/{chunk-VA7VOLNV.js → chunk-7X5JYLMO.js}

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

package/dist/{chunk-UXTK2GC2.js → chunk-XGR3IHWY.js}

@@ -419,12 +419,12 @@ async function executeIf(session, element) {
   const condition = await evaluatePredicate(session, conditionElement);
   if (condition) {
     if (thenElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-X7EARER5.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-WUPTTWCU.js");
       await integrateChildren2(session, thenElement);
     }
   } else {
     if (elseElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-X7EARER5.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-WUPTTWCU.js");
       await integrateChildren2(session, elseElement);
     }
   }
@@ -437,7 +437,7 @@ async function evaluatePredicate(session, predicateElement) {
     return await evaluateCondition(session, predicateElement);
   }
   const outputLengthBefore = session.output.length;
-  const { integrate: integrate2 } = await import("./interpreter-X7EARER5.js");
+  const { integrate: integrate2 } = await import("./interpreter-WUPTTWCU.js");
   await integrate2(session, predicateElement);
   const newOutputChunks = session.output.slice(outputLengthBefore);
   const result = newOutputChunks.join("").trim();
@@ -460,11 +460,11 @@ async function evaluateCondition(session, condElement) {
   }
   const outputLengthBefore = session.output.length;
   const args = [];
-  const { integrate: integrate2 } = await import("./interpreter-X7EARER5.js");
+  const { integrate: integrate2 } = await import("./interpreter-WUPTTWCU.js");
   for (const child of condElement.children) {
     if (child.tag.toLowerCase() === "arg") {
       const argOutputStart = session.output.length;
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-X7EARER5.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-WUPTTWCU.js");
       await integrateChildren2(session, child);
       const newChunks = session.output.slice(argOutputStart);
       const argValue = newChunks.join("");
@@ -879,16 +879,17 @@ ${expr}
     for (const v of session.variables) {
       context[v.name] = v.value;
     }
-    const { default: fs3 } = await import("fs");
+    const { default: fs4 } = await import("fs");
     const { default: path2 } = await import("path");
     const { fileURLToPath } = await import("url");
-    context.fs = fs3;
+    context.fs = fs4;
     context.path = path2;
     context.__dirname = process.cwd();
     context.getParams = () => {
       const params = session.parameterStack[session.parameterStack.length - 1];
       return params && params[0] ? params[0] : null;
     };
+    context.session = session;
     let result;
     const func = new AsyncFunction(...Object.keys(context), expr);
     result = await func(...Object.values(context));
@@ -1068,7 +1069,7 @@ async function executeExpr(session, element) {
 }
 
 // src/tags/system.ts
-import { exec } from "child_process";
+import { exec, spawn } from "child_process";
 import { promisify } from "util";
 var execAsync = promisify(exec);
 async function executeSystem(session, element) {
@@ -1090,8 +1091,22 @@ async function executeSystem(session, element) {
   if (!command.trim()) {
     return;
   }
+  const backgroundAttr = element.attributes?.background;
+  const isBackground = backgroundAttr === "true";
   if (session.debug) {
-    console.error(`[SYSTEM] Executing: ${command}`);
+    console.error(`[SYSTEM] Executing${isBackground ? " (background)" : ""}: ${command}`);
+  }
+  if (isBackground) {
+    const child = spawn(command, {
+      detached: true,
+      stdio: "ignore",
+      shell: true
+    });
+    child.unref();
+    if (session.debug) {
+      console.error(`[SYSTEM] Background process started with PID: ${child.pid}`);
+    }
+    return;
   }
   try {
     const { stdout, stderr } = await execAsync(command, {
@@ -1267,7 +1282,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-X7EARER5.js");
+      const { integrate: integrate2 } = await import("./interpreter-WUPTTWCU.js");
       await integrate2(session, elementToExecute);
     }
   }
@@ -1276,7 +1291,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-X7EARER5.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-WUPTTWCU.js");
   const exceptionDom = {
     tag: "exception-content",
     attributes: { name: exceptionName },
@@ -1289,7 +1304,7 @@ async function executeThrow(session, element) {
 // src/tags/try.ts
 async function executeTry(session, element) {
   setExceptionBoundary(session);
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-X7EARER5.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-WUPTTWCU.js");
   await integrateChildren2(session, element);
   unsetExceptionBoundary(session);
 }
@@ -1299,7 +1314,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-X7EARER5.js");
+    const { integrateChildren: integrateChildren2 } = await import("./interpreter-WUPTTWCU.js");
     await integrateChildren2(session, element);
   }
   flushCurrentException(session);
@@ -1308,7 +1323,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-X7EARER5.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-WUPTTWCU.js");
   for (const exceptionDom of exceptions) {
     await integrateChildren2(session, exceptionDom);
   }
@@ -1448,7 +1463,7 @@ async function executeForeach(session, element) {
     const parser2 = new DiracParser2();
     try {
       const fromElement = parser2.parse(fromAttr);
-      const { integrate: integrate2 } = await import("./interpreter-X7EARER5.js");
+      const { integrate: integrate2 } = await import("./interpreter-WUPTTWCU.js");
       await integrate2(session, fromElement);
     } catch (e) {
       session.output = savedOutput;
@@ -1580,6 +1595,110 @@ function extractAttrFromXml(xml, attrName) {
   return match ? match[1] : "";
 }
 
+// src/tags/environment.ts
+async function executeEnvironment(session, element) {
+  const name = element.attributes.name;
+  if (!name) {
+    throw new Error("<environment> requires name attribute");
+  }
+  const value = process.env[name] || "";
+  emit(session, value);
+}
+
+// src/tags/input.ts
+import * as fs3 from "fs";
+import * as readline from "readline";
+var fileReaders = /* @__PURE__ */ new Map();
+var fileIterators = /* @__PURE__ */ new Map();
+async function executeInput(session, element) {
+  const source = element.attributes.source;
+  const mode = element.attributes.mode || "all";
+  const pathAttr = element.attributes.path;
+  if (!source) {
+    throw new Error("<input> requires source attribute (stdin or file)");
+  }
+  if (source === "file" && !pathAttr) {
+    throw new Error('<input source="file"> requires path attribute');
+  }
+  let value = "";
+  if (source === "stdin") {
+    if (mode === "all") {
+      value = await readAllStdin();
+    } else if (mode === "line") {
+      value = await readLineStdin();
+    } else {
+      throw new Error(`<input> invalid mode: ${mode}. Use 'all' or 'line'`);
+    }
+  } else if (source === "file") {
+    const path2 = substituteAttribute(session, pathAttr);
+    if (mode === "all") {
+      value = fs3.readFileSync(path2, "utf-8");
+    } else if (mode === "line") {
+      value = await readLineFromFile(path2);
+    } else {
+      throw new Error(`<input> invalid mode: ${mode}. Use 'all' or 'line'`);
+    }
+  } else {
+    throw new Error(`<input> invalid source: ${source}. Use 'stdin' or 'file'`);
+  }
+  emit(session, value);
+}
+async function readAllStdin() {
+  return new Promise((resolve2, reject) => {
+    const chunks = [];
+    process.stdin.on("data", (chunk) => {
+      chunks.push(chunk);
+    });
+    process.stdin.on("end", () => {
+      resolve2(Buffer.concat(chunks).toString("utf-8"));
+    });
+    process.stdin.on("error", (err) => {
+      reject(err);
+    });
+  });
+}
+var stdinReader = null;
+var stdinIterator = null;
+async function readLineStdin() {
+  if (!stdinReader) {
+    stdinReader = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: false
+    });
+    stdinIterator = stdinReader[Symbol.asyncIterator]();
+  }
+  const result = await stdinIterator.next();
+  if (result.done) {
+    stdinReader.close();
+    stdinReader = null;
+    stdinIterator = null;
+    return "";
+  }
+  return result.value;
+}
+async function readLineFromFile(path2) {
+  if (!fileReaders.has(path2)) {
+    const fileStream = fs3.createReadStream(path2);
+    const rl = readline.createInterface({
+      input: fileStream,
+      crlfDelay: Infinity
+    });
+    fileReaders.set(path2, rl);
+    fileIterators.set(path2, rl[Symbol.asyncIterator]());
+  }
+  const iterator = fileIterators.get(path2);
+  const result = await iterator.next();
+  if (result.done) {
+    const reader = fileReaders.get(path2);
+    reader.close();
+    fileReaders.delete(path2);
+    fileIterators.delete(path2);
+    return "";
+  }
+  return result.value;
+}
+
 // src/runtime/interpreter.ts
 async function integrate(session, element) {
   if (session.limits.currentDepth >= session.limits.maxDepth) {
@@ -1672,6 +1791,12 @@ async function integrate(session, element) {
       case "attr":
         await executeAttr(session, element);
         break;
+      case "environment":
+        await executeEnvironment(session, element);
+        break;
+      case "input":
+        await executeInput(session, element);
+        break;
       case "require_module":
         await executeRequireModule(session, element);
         break;

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   execute
-} from "./chunk-VA7VOLNV.js";
-import "./chunk-UXTK2GC2.js";
+} from "./chunk-7X5JYLMO.js";
+import "./chunk-XGR3IHWY.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-E7PWEMZA.js";
 import "./chunk-52ED23DR.js";
@@ -13,7 +13,7 @@ import "dotenv/config";
 // package.json
 var package_default = {
   name: "dirac-lang",
-  version: "0.1.20",
+  version: "0.1.22",
   description: "LLM-Augmented Declarative Execution",
   type: "module",
   main: "dist/index.js",

package/dist/index.js

@@ -2,10 +2,10 @@ import {
   createLLMAdapter,
   execute,
   executeUserCommand
-} from "./chunk-VA7VOLNV.js";
+} from "./chunk-7X5JYLMO.js";
 import {
   integrate
-} from "./chunk-UXTK2GC2.js";
+} from "./chunk-XGR3IHWY.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";

package/dist/{interpreter-X7EARER5.js → interpreter-WUPTTWCU.js}

@@ -1,7 +1,7 @@
 import {
   integrate,
   integrateChildren
-} from "./chunk-UXTK2GC2.js";
+} from "./chunk-XGR3IHWY.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-E7PWEMZA.js";
 import "./chunk-52ED23DR.js";

package/dist/test-runner.js

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

package/package.json

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

package/src/runtime/interpreter.ts

@@ -29,6 +29,8 @@ import { executeTestIf } from '../tags/test-if.js';
 import { executeAvailableSubroutines } from '../tags/available-subroutines.js';
 import { executeForeach } from '../tags/foreach.js';
 import { executeAttr } from '../tags/attr.js';
+import { executeEnvironment } from '../tags/environment.js';
+import { executeInput } from '../tags/input.js';
 
 export async function integrate(session: DiracSession, element: DiracElement): Promise<void> {
   // Check execution limits
@@ -152,6 +154,14 @@ export async function integrate(session: DiracSession, element: DiracElement): P
       case 'attr':
         await executeAttr(session, element);
         break;
+        
+      case 'environment':
+        await executeEnvironment(session, element);
+        break;
+        
+      case 'input':
+        await executeInput(session, element);
+        break;
 
       case 'require_module':
         await executeRequireModule(session, element);

package/src/tags/environment.ts

@@ -0,0 +1,21 @@
+/**
+ * <environment> tag - read environment variables
+ * Usage: <environment name="VAR_NAME" />
+ */
+
+import type { DiracSession, DiracElement } from '../types/index.js';
+import { emit } from '../runtime/session.js';
+
+export async function executeEnvironment(session: DiracSession, element: DiracElement): Promise<void> {
+  const name = element.attributes.name;
+
+  if (!name) {
+    throw new Error('<environment> requires name attribute');
+  }
+
+  // Get environment variable value
+  const value = process.env[name] || '';
+
+  // Emit the value to output
+  emit(session, value);
+}

package/src/tags/eval.ts

@@ -48,6 +48,9 @@ export async function executeEval(session: DiracSession, element: DiracElement):
       return params && params[0] ? params[0] : null;
     };
     
+    // Add session object for orchestration (reserved identifier in eval context)
+    context.session = session;
+    
     let result: any;
     // Execute as async function to support top-level await
     const func = new AsyncFunction(...Object.keys(context), expr);

package/src/tags/index.ts

@@ -15,6 +15,8 @@ import * as ifTag from './if';
 import * as importTag from './import';
 import * as mongodb from './mongodb';
 import * as requireModule from './require_module';
+import * as environment from './environment';
+import * as input from './input';
 
 export default {
   ...system,
@@ -34,4 +36,6 @@ export default {
   ...importTag,
   ...mongodb,
   ...requireModule,
+  ...environment,
+  ...input,
 };

package/src/tags/input.ts

@@ -0,0 +1,159 @@
+/**
+ * <input> tag - read from stdin or file
+ * Usage: 
+ *   <input source="stdin" mode="all" />
+ *   <input source="stdin" mode="line" />
+ *   <input source="file" path="file.txt" mode="all" />
+ *   <input source="file" path="file.txt" mode="line" />
+ */
+
+import type { DiracSession, DiracElement } from '../types/index.js';
+import { emit, substituteAttribute } from '../runtime/session.js';
+import * as fs from 'fs';
+import * as readline from 'readline';
+
+// Store file readers for line-by-line reading
+const fileReaders = new Map<string, readline.Interface>();
+const fileIterators = new Map<string, AsyncIterator<string>>();
+
+export async function executeInput(session: DiracSession, element: DiracElement): Promise<void> {
+  const source = element.attributes.source;
+  const mode = element.attributes.mode || 'all';
+  const pathAttr = element.attributes.path;
+
+  if (!source) {
+    throw new Error('<input> requires source attribute (stdin or file)');
+  }
+
+  if (source === 'file' && !pathAttr) {
+    throw new Error('<input source="file"> requires path attribute');
+  }
+
+  let value = '';
+
+  if (source === 'stdin') {
+    if (mode === 'all') {
+      // Read all stdin at once
+      value = await readAllStdin();
+    } else if (mode === 'line') {
+      // Read one line from stdin
+      value = await readLineStdin();
+    } else {
+      throw new Error(`<input> invalid mode: ${mode}. Use 'all' or 'line'`);
+    }
+  } else if (source === 'file') {
+    const path = substituteAttribute(session, pathAttr);
+    
+    if (mode === 'all') {
+      // Read entire file
+      value = fs.readFileSync(path, 'utf-8');
+    } else if (mode === 'line') {
+      // Read one line from file
+      value = await readLineFromFile(path);
+    } else {
+      throw new Error(`<input> invalid mode: ${mode}. Use 'all' or 'line'`);
+    }
+  } else {
+    throw new Error(`<input> invalid source: ${source}. Use 'stdin' or 'file'`);
+  }
+
+  // Emit the value to output
+  emit(session, value);
+}
+
+/**
+ * Read all stdin content at once
+ */
+async function readAllStdin(): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = [];
+    
+    process.stdin.on('data', (chunk) => {
+      chunks.push(chunk);
+    });
+    
+    process.stdin.on('end', () => {
+      resolve(Buffer.concat(chunks).toString('utf-8'));
+    });
+    
+    process.stdin.on('error', (err) => {
+      reject(err);
+    });
+  });
+}
+
+/**
+ * Read one line from stdin
+ */
+let stdinReader: readline.Interface | null = null;
+let stdinIterator: AsyncIterator<string> | null = null;
+
+async function readLineStdin(): Promise<string> {
+  if (!stdinReader) {
+    stdinReader = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: false
+    });
+    stdinIterator = stdinReader[Symbol.asyncIterator]();
+  }
+
+  const result = await stdinIterator!.next();
+  
+  if (result.done) {
+    // EOF reached, close reader
+    stdinReader.close();
+    stdinReader = null;
+    stdinIterator = null;
+    return '';
+  }
+  
+  return result.value;
+}
+
+/**
+ * Read one line from a file
+ */
+async function readLineFromFile(path: string): Promise<string> {
+  // Create reader if it doesn't exist for this file
+  if (!fileReaders.has(path)) {
+    const fileStream = fs.createReadStream(path);
+    const rl = readline.createInterface({
+      input: fileStream,
+      crlfDelay: Infinity
+    });
+    fileReaders.set(path, rl);
+    fileIterators.set(path, rl[Symbol.asyncIterator]());
+  }
+
+  const iterator = fileIterators.get(path)!;
+  const result = await iterator.next();
+  
+  if (result.done) {
+    // EOF reached, close and cleanup
+    const reader = fileReaders.get(path)!;
+    reader.close();
+    fileReaders.delete(path);
+    fileIterators.delete(path);
+    return '';
+  }
+  
+  return result.value;
+}
+
+/**
+ * Clean up all open file readers (can be called at end of session)
+ */
+export function cleanupInputReaders(): void {
+  if (stdinReader) {
+    stdinReader.close();
+    stdinReader = null;
+    stdinIterator = null;
+  }
+  
+  for (const reader of fileReaders.values()) {
+    reader.close();
+  }
+  fileReaders.clear();
+  fileIterators.clear();
+}

package/src/tags/system.ts

@@ -5,7 +5,7 @@
 
 import type { DiracSession, DiracElement } from '../types/index.js';
 import { substituteVariables, emit } from '../runtime/session.js';
-import { exec } from 'child_process';
+import { exec, spawn } from 'child_process';
 import { promisify } from 'util';
 import { integrate } from '../runtime/interpreter.js';
 
@@ -43,10 +43,33 @@ export async function executeSystem(session: DiracSession, element: DiracElement
     return;
   }
   
+  // Check for background attribute
+  const backgroundAttr = element.attributes?.background;
+  const isBackground = backgroundAttr === 'true';
+  
   if (session.debug) {
-    console.error(`[SYSTEM] Executing: ${command}`);
+    console.error(`[SYSTEM] Executing${isBackground ? ' (background)' : ''}: ${command}`);
+  }
+  
+  // Background mode - spawn and don't wait
+  if (isBackground) {
+    const child = spawn(command, {
+      detached: true,
+      stdio: 'ignore',
+      shell: true,
+    });
+    
+    // Unref so parent can exit without waiting
+    child.unref();
+    
+    if (session.debug) {
+      console.error(`[SYSTEM] Background process started with PID: ${child.pid}`);
+    }
+    
+    return;
   }
   
+  // Foreground mode - wait for completion (original behavior)
   try {
     const { stdout, stderr } = await execAsync(command, {
       encoding: 'utf-8',

package/test-input-debug.di

@@ -0,0 +1,19 @@
+<dirac>
+  <defvar name="counter" value="0" />
+  
+  <loop count="4">
+    <defvar name="line">
+      <input source="file" path="tests/test-input.txt" mode="line" />
+    </defvar>
+    
+    <test-if test="$line != ''">
+      <assign name="counter">
+        <eval><variable name="counter" /> + 1</eval>
+      </assign>
+      <variable name="counter" />
+      <output>:</output>
+      <variable name="line" />
+      <output>|</output>
+    </test-if>
+  </loop>
+</dirac>

package/tests/environment-basic.test.di

@@ -0,0 +1,22 @@
+<!-- TEST: environment_basic -->
+<!-- EXPECT: HOME exists: true USER exists: true -->
+<dirac>
+  <defvar name="home"><environment name="HOME" /></defvar>
+  <defvar name="user"><environment name="USER" /></defvar>
+  
+  <output>HOME exists: </output>
+  <test-if test="$home != ''">
+    <output>true</output>
+  </test-if>
+  <test-if test="$home == ''">
+    <output>false</output>
+  </test-if>
+  
+  <output> USER exists: </output>
+  <test-if test="$user != ''">
+    <output>true</output>
+  </test-if>
+  <test-if test="$user == ''">
+    <output>false</output>
+  </test-if>
+</dirac>

package/tests/environment-nonexistent.test.di

@@ -0,0 +1,5 @@
+<!-- TEST: environment_nonexistent -->
+<!-- EXPECT: Empty: [] -->
+<dirac>
+  <output>Empty: [<environment name="NONEXISTENT_VAR_12345_TEST" />]</output>
+</dirac>

package/tests/environment-with-defvar.test.di

@@ -0,0 +1,15 @@
+<!-- TEST: environment_with_defvar -->
+<!-- EXPECT: Path exists: true -->
+<dirac>
+  <defvar name="mypath">
+    <environment name="PATH" />
+  </defvar>
+  
+  <output>Path exists: </output>
+  <test-if test="$mypath != ''">
+    <output>true</output>
+  </test-if>
+  <test-if test="$mypath == ''">
+    <output>false</output>
+  </test-if>
+</dirac>

package/tests/input-file-all.test.di

@@ -0,0 +1,5 @@
+<!-- TEST: input_file_all -->
+<!-- EXPECT: line one line two line three -->
+<dirac>
+  <input source="file" path="tests/test-input.txt" mode="all" />
+</dirac>

package/tests/input-file-line.test.di

@@ -0,0 +1,15 @@
+<!-- TEST: input_file_line -->
+<!-- EXPECT: First: line one Second: line two Third: line three EOF: -->
+<dirac>
+  <output>First: </output>
+  <input source="file" path="tests/test-input.txt" mode="line" />
+  
+  <output> Second: </output>
+  <input source="file" path="tests/test-input.txt" mode="line" />
+  
+  <output> Third: </output>
+  <input source="file" path="tests/test-input.txt" mode="line" />
+  
+  <output> EOF: </output>
+  <input source="file" path="tests/test-input.txt" mode="line" />
+</dirac>

package/tests/input-file-loop.test.di

@@ -0,0 +1,12 @@
+<!-- TEST: input_file_with_loop -->
+<!-- EXPECT: line one | line two | line three | -->
+<dirac>
+  <loop count="3">
+    <defvar name="line">
+      <input source="file" path="tests/test-input.txt" mode="line" />
+    </defvar>
+    
+    <variable name="line" />
+    <output> | </output>
+  </loop>
+</dirac>

package/tests/system-background.test.di

@@ -0,0 +1,39 @@
+<dirac>
+  <output>Testing background processes with loop...</output>
+  
+  <!-- Setup: Clean up old test files -->
+  <system>rm -f /tmp/dirac-bg-counter.txt</system>
+  
+  <!-- Start a background process that writes incrementing numbers -->
+  <system background="true">(for i in 1 2 3 4 5; do echo "Count: $i"; sleep 1; done > /tmp/dirac-bg-counter.txt) &</system>
+  <output>✓ Background counter started</output>
+  
+  <!-- This executes immediately without waiting -->
+  <output>✓ DIRAC continuing without blocking</output>
+  
+  <!-- Wait a moment for background process to start writing -->
+  <system>sleep 2</system>
+  
+  <!-- Read the results in a loop (3 times, showing progressive output) -->
+  <loop count="3">
+    <system>wc -l /tmp/dirac-bg-counter.txt 2>/dev/null || echo "0"</system>
+    <output>Check: Background file now has lines</output>
+    <system>sleep 1</system>
+  </loop>
+  
+  <!-- Give background process time to finish all 5 counts -->
+  <system>sleep 2</system>
+  
+  <!-- Verify final result contains all 5 counts -->
+  <system>wc -l /tmp/dirac-bg-counter.txt</system>
+  <output>✓ Background process completed</output>
+  
+  <!-- Verify content -->
+  <system>grep -c "Count:" /tmp/dirac-bg-counter.txt</system>
+  <output>✓ Found all count entries</output>
+  
+  <!-- Cleanup -->
+  <system>rm -f /tmp/dirac-bg-counter.txt</system>
+  
+  <output>✓ Background process with loop test passed</output>
+</dirac>

package/tests/test-input.txt

@@ -0,0 +1,3 @@
+line one
+line two
+line three