dirac-lang 0.1.23 → 0.1.25

package/TEST-COVERAGE.md

@@ -1,113 +0,0 @@
-# Dirac Unit Test Coverage Report
-
-## Summary
-- **Total Tests**: 32
-- **Passing**: 20 (62.5%)
-- **Failing**: 12 (37.5%)
-
-## Test Status by Tag
-
-### ✅ Fully Covered (Passing)
-- `<output>` - Basic output, multiple outputs
-- `<defvar>` - Variable definition, multiple variables  
-- `<variable>` - Variable interpolation
-- `<assign>` - Basic assignment
-- `<eval>` - Basic eval, eval with variables, eval naming
-- `<loop>` - Basic loops
-- `<test-if>` - Attribute-based conditional testing
-- `<system>` - Basic system commands
-- `<require_module>` - Node.js module imports
-- `<subroutine>` - Basic subroutine calls
-- `<try>/<catch>` - Error handling, error expectations
-- `<exception>` - Exception handling
-
-### ⚠️ Partially Covered (Has Issues)
-- `<expr>` - Syntax needs fixing (requires `eval` attribute)
-- `<call>` - Subroutine calls (parameter definition issues)
-- `<loop>` - Nested loops (logic issues)
-- `<import>` - Import functionality (needs investigation)
-- `<system>` - Output capture order
-
-### ❌ Not Tested
-- `<llm>` - Requires LLM provider configuration
-- `<execute>` - Requires LLM provider configuration  
-- `<mongodb>` - Requires MongoDB connection
-- `<if>` - Conditional expression evaluation (different from test-if)
-- `<parameters>` - HTTP parameter extraction
-
-## Failing Tests Details
-
-### 1. call_basic & call_with_output
-**Issue**: Subroutine parameter binding
-```
-Error: Eval error: x is not defined
-```
-**Fix Needed**: Verify param-* attribute syntax
-
-### 2. expr_basic & expr_string_concat  
-**Issue**: Missing `eval` attribute
-```
-Error: <expr> requires eval or op attribute
-```
-**Already Fixed**: Changed to `<expr eval="..." />`
-
-### 3. if_else & if_with_variables
-**Issue**: test-if syntax
-```
-Error: <test-if> requires test attribute  
-```
-**Fix Needed**: Use proper test-if syntax with `test="$var"` and comparison operators
-
-### 4. import_basic
-**Issue**: Import not finding parameter
-```
-Error: Eval error: x is not defined
-```
-**Fix Needed**: Check import mechanism and subroutine parameter passing
-
-### 5. loop_nested
-**Issue**: Logic error in nested loop test
-```
-Expected: "0-A 0-B 1-A 1-B"
-Actual: "0-B 0-B 1-B 1-B"  
-```
-**Fix Needed**: Fix letter calculation logic
-
-### 6. subroutine_multiple_params & subroutine_recursive
-**Issue**: Output variable not captured
-```
-Expected: "Full name: John Doe"
-Actual: "Full name:"
-```
-**Fix Needed**: Check param-output and eval output assignment
-
-### 7. system_capture & system_with_trim
-**Issue**: Output order
-```
-Expected: "hello Result: hello"
-Actual: "hello Result:"
-```
-**Fix Needed**: System command output comes first, variable not captured
-
-## Next Steps
-
-1. **High Priority** - Fix subroutine parameter passing (4 tests)
-2. **Medium Priority** - Fix expr and test-if syntax (4 tests)  
-3. **Low Priority** - Fix system output capture (2 tests), loop logic (1 test), import (1 test)
-4. **Future** - Add LLM/MongoDB integration tests when services available
-
-## Test Execution
-
-```bash
-npm test
-```
-
-All tests run automatically on build. Test files are in `/tests` directory with format:
-```xml
-<!-- TEST: test_name -->
-<!-- EXPECT: expected output -->
-<!-- EXPECT_ERROR: expected error message -->
-<dirac>
-  <!-- test code -->
-</dirac>
-```

package/TESTING.md

@@ -1,162 +0,0 @@
-# Dirac Testing System
-
-A simple, lightweight testing framework for Dirac language files.
-
-## Running Tests
-
-```bash
-npm test
-```
-
-This will:
-1. Build the project
-2. Run all `*.test.di` files in the `tests/` directory
-3. Report results
-
-## Writing Tests
-
-Tests are standard Dirac `.di` files with special comments that define expectations.
-
-### Test File Format
-
-```xml
-<!-- TEST: test_name -->
-<!-- EXPECT: expected output -->
-<dirac>
-  <!-- your test code here -->
-</dirac>
-```
-
-### Test Metadata Comments
-
-- `<!-- TEST: name -->` - Name of the test (optional, defaults to filename)
-- `<!-- EXPECT: output -->` - Expected output (optional)
-- `<!-- EXPECT_ERROR: error message -->` - Expected error message (optional)
-
-### Example Tests
-
-#### Basic Output Test
-
-```xml
-<!-- TEST: hello_world -->
-<!-- EXPECT: Hello, World! -->
-<dirac>
-  <output>Hello, World!</output>
-</dirac>
-```
-
-#### Variable Test
-
-```xml
-<!-- TEST: variables -->
-<!-- EXPECT: Value is: test123 -->
-<dirac>
-  <defvar name="myvar" value="test123" />
-  <output>Value is: <variable name="myvar" /></output>
-</dirac>
-```
-
-#### Error Test
-
-```xml
-<!-- TEST: missing_variable -->
-<!-- EXPECT_ERROR: Variable 'missing' not found -->
-<dirac>
-  <variable name="missing" />
-</dirac>
-```
-
-#### No Expectation (Just Run)
-
-```xml
-<!-- TEST: runs_without_error -->
-<dirac>
-  <defvar name="x" value="10" />
-  <!-- Test passes if it runs without throwing an error -->
-</dirac>
-```
-
-## Test Organization
-
-Tests should be placed in the `tests/` directory with the `.test.di` extension:
-
-```
-tests/
-  ├── basic-output.test.di
-  ├── variable-basic.test.di
-  ├── subroutine-basic.test.di
-  ├── if-conditional.test.di
-  └── ...
-```
-
-You can organize tests into subdirectories:
-
-```
-tests/
-  ├── core/
-  │   ├── output.test.di
-  │   └── variables.test.di
-  ├── control-flow/
-  │   ├── if.test.di
-  │   └── loop.test.di
-  └── llm/
-      └── basic.test.di
-```
-
-## Output Matching
-
-The test runner normalizes whitespace when comparing output:
-- Multiple spaces/newlines are collapsed to single spaces
-- Leading/trailing whitespace is trimmed
-- This allows tests to ignore XML formatting whitespace
-
-For example, these are equivalent:
-- Expected: `Hello World`
-- Actual: `  Hello   World  ` → matches ✓
-- Actual: `Hello\n  World` → matches ✓
-
-## Exit Codes
-
-- `0` - All tests passed
-- `1` - One or more tests failed
-
-## Continuous Integration
-
-Add to your CI pipeline:
-
-```yaml
-# .github/workflows/test.yml
-- name: Run tests
-  run: npm test
-```
-
-## Best Practices
-
-1. **One concept per test** - Each test should verify one specific behavior
-2. **Descriptive names** - Use clear test names that describe what's being tested
-3. **Test edge cases** - Include tests for error conditions and boundary cases
-4. **Keep tests fast** - Avoid LLM calls in unit tests (use mocks or separate integration tests)
-5. **Test regressions** - When fixing bugs, add a test to prevent regression
-
-## Example Test Suite
-
-```
-tests/
-  ├── basic-output.test.di          # Basic output functionality
-  ├── variable-basic.test.di        # Variable definition and output
-  ├── subroutine-basic.test.di      # Subroutine calls
-  ├── if-conditional.test.di        # Conditional execution
-  ├── loop-basic.test.di            # Loop functionality
-  ├── exception-basic.test.di       # Exception handling
-  └── test-if-basic.test.di         # test-if conditional
-```
-
-## Future Enhancements
-
-Potential improvements:
-- Watch mode for TDD workflow
-- Code coverage reporting
-- Performance benchmarks
-- Parallel test execution
-- Test fixtures/setup/teardown
-- Snapshot testing for complex outputs

package/config.test.yml

@@ -1,5 +0,0 @@
-# Test configuration for verifying embedding config works
-embeddingServer:
-  host: localhost
-  port: 11434
-  model: nomic-embed-text  # Different model to test config loading

package/dirac-http/examples/demo.di

@@ -1,9 +0,0 @@
-#!/usr/bin/env dirac
-<dirac>
-  <import src="../lib/index.di"/>
-
-  <output>Demo:</output>
-  <output>&#10;</output>
-  <HTTP_EXAMPLE input="test"/>
-  <output>&#10;</output>
-</dirac>

package/dirac-http/lib/index.di

@@ -1,12 +0,0 @@
-<dirac>
-
-<!-- All tags use the library prefix to avoid naming conflicts -->
-<subroutine name="HTTP_EXAMPLE">
-  <eval>
-    const caller = getParams();
-    const input = caller.attributes.input || 'no input';
-    console.log('Processed: ' + input);
-  </eval>
-</subroutine>
-
-</dirac>

package/examples/add-demo.di

@@ -1,74 +0,0 @@
-#!/usr/bin/env dirac
-<dirac>
-  <!-- 
-    Method 1: Using <expr> tag (clean, declarative)
-  -->
-  <subroutine name="ADD">
-    <expr eval="plus">
-      <arg><parameters select="@x"/></arg>
-      <arg><parameters select="@y"/></arg>
-    </expr>
-  </subroutine>
-
-  <output>Method 1 (expr tag):&#10;</output>
-  <output>  1 + 2 = </output>
-  <ADD x="1" y="2"/>
-  <output>&#10;</output>
-
-  <output>  5 + 7 = </output>
-  <ADD x="5" y="7"/>
-  <output>&#10;</output>
-
-  <output>  100 + 200 = </output>
-  <ADD x="100" y="200"/>
-  <output>&#10;</output>
-
-  <!-- 
-    Method 2: Using getParams() in eval (programmatic)
-  -->
-  <subroutine name="MULTIPLY">
-    <eval>
-      const caller = getParams();
-      if (caller && caller.attributes) {
-        const x = parseInt(caller.attributes.x || 0);
-        const y = parseInt(caller.attributes.y || 0);
-        console.log(x * y);
-      }
-    </eval>
-  </subroutine>
-
-  <output>&#10;Method 2 (eval with getParams):&#10;</output>
-  <output>3 * 4 = </output>
-  <MULTIPLY x="3" y="4"/>
-  <output>&#10;</output>
-
-  <output>5 * 6 = </output>
-  <MULTIPLY x="5" y="6"/>
-  <output>&#10;</output>
-
-  <!-- More expr examples -->
-  <output>&#10;More operations:&#10;</output>
-  <output>10 - 3 = </output>
-  <expr eval="minus"><arg>10</arg><arg>3</arg></expr>
-  <output>&#10;</output>
-  
-  <output>7 * 8 = </output>
-  <expr eval="times"><arg>7</arg><arg>8</arg></expr>
-  <output>&#10;</output>
-  
-  <output>20 / 4 = </output>
-  <expr eval="divide"><arg>20</arg><arg>4</arg></expr>
-  <output>&#10;</output>
-  
-  <output>17 mod 5 = </output>
-  <expr eval="mod"><arg>17</arg><arg>5</arg></expr>
-  <output>&#10;</output>
-  
-  <output>5 &lt; 10 = </output>
-  <expr eval="lt"><arg>5</arg><arg>10</arg></expr>
-  <output>&#10;</output>
-  
-  <output>5 &gt; 10 = </output>
-  <expr eval="gt"><arg>5</arg><arg>10</arg></expr>
-  <output>&#10;</output>
-</dirac>

package/examples/add.bk

@@ -1,11 +0,0 @@
-<add|
-  |parameters select=@x>
-  |parameters select=@y>
-  |expr op=plus>
-    |arg>
-      |variable name=x>
-    |arg>
-      |variable name=y>
-
-|output>5 + 3 = 
-|add x=5 y=3>

package/examples/advanced-math-demo.di

@@ -1,53 +0,0 @@
-#!/usr/bin/env dirac
-<dirac>
-  <!-- Import advanced math library -->
-  <import src="./lib/advanced-math.di"/>
-
-  <output>Advanced Math Library Demo&#10;&#10;</output>
-
-  <!-- Square root -->
-  <output>Square root of 16: </output>
-  <MATH_SQRT n="16"/>
-  <output>&#10;</output>
-
-  <output>Square root of 2: </output>
-  <MATH_SQRT n="2"/>
-  <output>&#10;</output>
-
-  <!-- Factorial -->
-  <output>Factorial of 5: </output>
-  <MATH_FACTORIAL n="5"/>
-  <output>&#10;</output>
-
-  <output>Factorial of 10: </output>
-  <MATH_FACTORIAL n="10"/>
-  <output>&#10;</output>
-
-  <!-- GCD -->
-  <output>GCD(48, 18): </output>
-  <MATH_GCD a="48" b="18"/>
-  <output>&#10;</output>
-
-  <output>GCD(100, 35): </output>
-  <MATH_GCD a="100" b="35"/>
-  <output>&#10;</output>
-
-  <!-- Prime check -->
-  <output>Is 17 prime? </output>
-  <MATH_PRIME n="17"/>
-  <output>&#10;</output>
-
-  <output>Is 20 prime? </output>
-  <MATH_PRIME n="20"/>
-  <output>&#10;</output>
-
-  <!-- Random number -->
-  <output>Random number [0-100]: </output>
-  <MATH_RANDOM min="0" max="100"/>
-  <output>&#10;</output>
-
-  <!-- Statistics -->
-  <output>&#10;Statistics for [1,2,3,4,5,10,100]:&#10;</output>
-  <MATH_STATS data="[1,2,3,4,5,10,100]"/>
-  <output>&#10;</output>
-</dirac>

package/examples/calculator.di

@@ -1,32 +0,0 @@
-```xml
-<?xml version="1.0"?>
-<!-- Basic Arithmetic Calculator -->
-<dirac>
-    <!-- Declaration of variables -->
-    <defvar name="num1" value="0" />
-    <defvar name="num2" value="0" />
-    <defvar name="result" value="0" />
-    <defvar name="operation" value="" />
-
-    <!-- User input for first number -->
-    <LLM output="num1">Please enter the first number:</LLM>
-    
-    <!-- User input for second number -->
-    <LLM output="num2">Please enter the second number:</LLM>
-    
-    <!-- User input for the operation -->
-    <LLM output="operation">Please choose the operation (+, -, *, /):</LLM>
-    
-    <!-- Perform selected operation -->
-    <if test="${operation} == '+'">
-        <set var="result" value="${num1} + ${num2}" />
-    </if>
-    <if test="${operation} == '-'">
-        <set var="result" value="${num1} - ${num2}" />
-    </if>
-    <if test="${operation} == '*'">
-        <set var="result" value="${num1} * ${num2}" />
-    </if>
-    <if test="${operation} == '/'">
-        <if test="${num2} == 0">
-            <output>Division by zero is not allowed.</output>

package/examples/compact-test.di

@@ -1,6 +0,0 @@
-<dirac>
-  <defvar name="dir">examples</defvar>
-  <output>Files in <variable name="dir" />:</output>
-  <output>&#10;</output>
-  <system>ls -la <variable name="dir" /> | head -10</system>
-</dirac>

package/examples/comprehensive.bk

@@ -1,29 +0,0 @@
-|output>Bra-Ket Notation Demo
-
-<factorial|
-  |parameters select=@n>
-    |variable name=n>
-  |if>
-    |expr op=eq>
-      |arg>
-        |variable name=n>
-      |arg>1
-    |output>1
-    |expr op=times>
-      |arg>
-        |variable name=n>
-      |arg>
-        |factorial>
-          |expr op=minus>
-            |arg>
-              |variable name=n>
-            |arg>1
-
-|output>Factorial of 5 = 
-|factorial n=5>
-|output>
-
-<format|
-  |output>Name: |variable name=name>, Age: |variable name=age>
-
-|format name=Alice age=30>

package/examples/defvar-variable-demo.di

@@ -1,18 +0,0 @@
-<dirac>
-  <!-- Simple example: defvar sets, variable gets -->
-  <defvar name="greeting">Hello, World!</defvar>
-  <output><variable name="greeting"/></output>
-  <output>&#10;</output>
-  
-  <!-- Subroutine with parameter -->
-  <subroutine name="greet">
-    <parameters select="@name">
-      <defvar name="localname"/>
-    </parameters>
-    <output>Greetings, <variable name="localname"/>!</output>
-  </subroutine>
-  
-  <greet name="Alice"/>
-  <output>&#10;</output>
-  <greet name="Bob"/>
-</dirac>

package/examples/direct-call.di

@@ -1,17 +0,0 @@
-#!/usr/bin/env dirac
-<dirac>
-  <import src="./lib/math.di" />
-  
-  <output>Direct Tag Call Test&#10;&#10;</output>
-  
-  <defvar name="x" value="9" />
-  <output>Using &lt;SQUARE /&gt;: </output>
-  <SQUARE />
-  <output>&#10;</output>
-  
-  <defvar name="a" value="100" />
-  <defvar name="b" value="200" />
-  <output>Using &lt;ADD /&gt;: </output>
-  <ADD />
-  <output>&#10;</output>
-</dirac>

package/examples/disk-analysis.di

@@ -1,16 +0,0 @@
-<dirac>
-  <!-- Get disk usage and ask LLM to summarize -->
-  <output>Analyzing disk usage...</output>
-  <output>&#10;</output>
-  
-  <llm>
-    <system>du -sh . 2>/dev/null</system>
-    <system>df -h . | tail -1</system>
-    
-    Above are two commands:
-    1. Total size of current directory
-    2. Disk space information for the filesystem
-    
-    Please tell me in one sentence: How much space is this directory using and what percentage of the disk is free?
-  </llm>
-</dirac>

package/examples/exception-demo.di

@@ -1,82 +0,0 @@
-<dirac>
-  <output>===== Try/Catch/Throw Exception Handling Tests =====</output>
-  <output>
-</output>
-  
-  <!-- Test 1: Simple exception -->
-  <output>Test 1: Simple exception throw and catch</output>
-  <try>
-    <throw name="error1">
-      <output>Error message from throw</output>
-    </throw>
-  </try>
-  
-  <catch name="error1">
-    <output>Caught: </output>
-    <exception/>
-  </catch>
-  <output>
-</output>
-  
-  <!-- Test 2: Named exceptions -->
-  <output>Test 2: Multiple named exceptions</output>
-  <try>
-    <throw name="warning">
-      <output>This is a warning</output>
-    </throw>
-    <throw name="error">
-      <output>This is an error</output>
-    </throw>
-  </try>
-  
-  <catch name="warning">
-    <output>Warnings: </output>
-    <exception/>
-  </catch>
-  
-  <catch name="error">
-    <output>Errors: </output>
-    <exception/>
-  </catch>
-  <output>
-</output>
-  
-  <!-- Test 3: Exception with variable data -->
-  <output>Test 3: Exception with variable data</output>
-  <defvar name="errorCode" value="404"/>
-  <defvar name="errorMsg" value="Not Found"/>
-  
-  <try>
-    <throw name="httperror">
-      <output>HTTP Error </output>
-      <variable name="errorCode"/>
-      <output>: </output>
-      <variable name="errorMsg"/>
-    </throw>
-  </try>
-  
-  <catch name="httperror">
-    <output>Caught HTTP error: </output>
-    <exception/>
-  </catch>
-  <output>
-</output>
-  
-  <!-- Test 4: No matching catch -->
-  <output>Test 4: Exception with no matching catch (should not output)</output>
-  <try>
-    <throw name="uncaught">
-      <output>This won't be caught</output>
-    </throw>
-  </try>
-  
-  <catch name="different">
-    <output>This should NOT appear</output>
-    <exception/>
-  </catch>
-  <output>Done with test 4</output>
-  <output>
-</output>
-  
-  <output>===== All tests complete =====</output>
-</dirac>

package/examples/executable-hello.di

@@ -1,7 +0,0 @@
-#!/usr/bin/env dirac
-<!-- Executable Dirac Script -->
-<dirac>
-  <defvar name="name" value="World" />
-  <output>Hello, ${name}!&#10;</output>
-  <output>This script runs directly!&#10;</output>
-</dirac>