dirac-lang 0.1.24 → 0.1.26

package/src/utils/tag-validator.ts

@@ -1,231 +0,0 @@
-/**
- * Tag validation utilities
- * Provides reusable validation logic for tag-check and LLM execution
- */
-
-import type { DiracSession, DiracElement, Subroutine } from '../types/index.js';
-import fs from 'fs';
-import yaml from 'js-yaml';
-
-// Configurable similarity cutoff
-const SIMILARITY_CUTOFF = 0.75;
-
-export interface ValidationResult {
-  valid: boolean;
-  tagName: string;
-  originalTag: string;
-  corrected: boolean;
-  errors: string[];
-  warnings: string[];
-  similarity?: number;
-}
-
-// Helper: get embedding server config from config.yml
-function getEmbeddingServerConfig() {
-  try {
-    const configPath = process.env.DIRAC_CONFIG || 'config.yml';
-    const config = yaml.load(fs.readFileSync(configPath, 'utf8')) as any;
-    const host = config.embeddingServer?.host || 'localhost';
-    const port = config.embeddingServer?.port || 11434;
-    const model = config.embeddingServer?.model || 'embeddinggemma';
-    return { host, port, model };
-  } catch (e) {
-    // Fallback to defaults if config file not found
-    return { host: 'localhost', port: 11434, model: 'embeddinggemma' };
-  }
-}
-
-// Helper: call Ollama embedding API directly
-async function getEmbeddings(tags: string[]): Promise<number[][]> {
-  const { host, port, model } = getEmbeddingServerConfig();
-  return await Promise.all(tags.map(async tag => {
-    const response = await fetch(`http://${host}:${port}/api/embeddings`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ model, prompt: tag })
-    });
-    const data = await response.json();
-    return data.embedding;
-  }));
-}
-
-function cosine(a: number[], b: number[]): number {
-  const dot = a.reduce((sum, v, i) => sum + v * b[i], 0);
-  const normA = Math.sqrt(a.reduce((sum, v) => sum + v * v, 0));
-  const normB = Math.sqrt(b.reduce((sum, v) => sum + v * v, 0));
-  return dot / (normA * normB);
-}
-
-async function getBestTagMatch(candidate: string, allowed: string[]): Promise<{tag: string, score: number}> {
-  const tags = [candidate, ...allowed];
-  const embeddings = await getEmbeddings(tags);
-  const candidateVec = embeddings[0];
-  const allowedVecs = embeddings.slice(1);
-  let bestIdx = 0, bestScore = -1;
-  allowedVecs.forEach((vec, i) => {
-    const score = cosine(candidateVec, vec);
-    if (score > bestScore) { bestScore = score; bestIdx = i; }
-  });
-  return { tag: allowed[bestIdx], score: bestScore };
-}
-
-/**
- * Validate a single tag element against available subroutines
- */
-export async function validateTag(
-  session: DiracSession,
-  element: DiracElement,
-  options: {
-    autocorrect?: boolean;
-    similarityCutoff?: number;
-  } = {}
-): Promise<ValidationResult> {
-  const { autocorrect = false, similarityCutoff = SIMILARITY_CUTOFF } = options;
-  
-  // Get allowed subroutine names
-  const { getAvailableSubroutines } = await import('../runtime/session.js');
-  const subroutines = getAvailableSubroutines(session);
-  const allowed = new Set(subroutines.map(s => s.name));
-  
-  const tagName = element.tag;
-  const result: ValidationResult = {
-    valid: false,
-    tagName,
-    originalTag: tagName,
-    corrected: false,
-    errors: [],
-    warnings: [],
-  };
-  
-  // Check if tag exists
-  if (allowed.has(tagName)) {
-    // Tag name is valid, now check required and unknown parameters
-    const sub = subroutines.find(s => s.name === tagName);
-    if (sub && Array.isArray(sub.parameters)) {
-      const paramNames = sub.parameters.map(p => p.name);
-      
-      // Check for missing required parameters
-      for (const param of sub.parameters) {
-        if (param.required && !(param.name in element.attributes)) {
-          result.errors.push(`Missing required parameter: ${param.name}`);
-        }
-      }
-      
-      // Check for unknown attributes
-      for (const attr in element.attributes) {
-        if (!paramNames.includes(attr)) {
-          result.warnings.push(`Unknown attribute: ${attr}`);
-        }
-      }
-    }
-    
-    result.valid = result.errors.length === 0;
-  } else {
-    // Tag doesn't exist, try to find semantic match
-    const best = await getBestTagMatch(tagName, Array.from(allowed));
-    
-    if (best.score >= similarityCutoff) {
-      result.similarity = best.score;
-      
-      if (autocorrect) {
-        result.tagName = best.tag;
-        result.corrected = true;
-        result.warnings.push(`Auto-corrected from <${tagName}> to <${best.tag}> (similarity: ${best.score.toFixed(2)})`);
-        
-        // Validate parameters for corrected tag
-        const sub = subroutines.find(s => s.name === best.tag);
-        if (sub && Array.isArray(sub.parameters)) {
-          const paramNames = sub.parameters.map(p => p.name);
-          
-          for (const param of sub.parameters) {
-            if (param.required && !(param.name in element.attributes)) {
-              result.errors.push(`Missing required parameter: ${param.name}`);
-            }
-          }
-          
-          for (const attr in element.attributes) {
-            if (!paramNames.includes(attr)) {
-              result.warnings.push(`Unknown attribute: ${attr}`);
-            }
-          }
-        }
-        
-        result.valid = result.errors.length === 0;
-      } else {
-        result.errors.push(`Tag <${tagName}> does not exist. Did you mean <${best.tag}>? (similarity: ${best.score.toFixed(2)})`);
-      }
-    } else {
-      result.errors.push(`Tag <${tagName}> does not exist and no similar tag was found.`);
-    }
-  }
-  
-  return result;
-}
-
-/**
- * Validate all child tags in a parsed Dirac AST
- */
-export async function validateDiracCode(
-  session: DiracSession,
-  ast: DiracElement,
-  options: {
-    autocorrect?: boolean;
-    similarityCutoff?: number;
-  } = {}
-): Promise<{
-  valid: boolean;
-  results: ValidationResult[];
-  errorMessages: string[];
-}> {
-  const results: ValidationResult[] = [];
-  const errorMessages: string[] = [];
-  
-  // Recursively validate all elements
-  async function validateElement(element: DiracElement) {
-    // Skip text nodes, whitespace-only tags, and root wrapper tags
-    if (element.tag && element.tag !== 'dirac' && element.tag !== 'DIRAC-ROOT' && element.tag.trim() !== '') {
-      const result = await validateTag(session, element, options);
-      results.push(result);
-      
-      if (!result.valid) {
-        errorMessages.push(`<${result.originalTag}>: ${result.errors.join(', ')}`);
-      }
-    }
-    
-    // Validate children
-    for (const child of element.children) {
-      await validateElement(child);
-    }
-  }
-  
-  await validateElement(ast);
-  
-  return {
-    valid: errorMessages.length === 0,
-    results,
-    errorMessages,
-  };
-}
-
-/**
- * Apply auto-corrections to a parsed Dirac AST
- */
-export function applyCorrectedTags(ast: DiracElement, results: ValidationResult[]): DiracElement {
-  let resultIndex = 0;
-  
-  function correctElement(element: DiracElement): DiracElement {
-    if (element.tag && element.tag !== 'dirac' && element.tag !== '') {
-      const result = results[resultIndex++];
-      if (result && result.corrected) {
-        element = { ...element, tag: result.tagName };
-      }
-    }
-    
-    return {
-      ...element,
-      children: element.children.map(child => correctElement(child))
-    };
-  }
-  
-  return correctElement(ast);
-}

package/test-available-extends.di

@@ -1,28 +0,0 @@
-<dirac>
-  <subroutine name="Base">
-    <subroutine name="method1" description="Base method 1">
-      <output>Base 1</output>
-    </subroutine>
-    <subroutine name="method2" description="Base method 2">
-      <output>Base 2</output>
-    </subroutine>
-    <output>In Base body, calling available-subroutines:</output>
-    <output>
-</output>
-    <available-subroutines />
-  </subroutine>
-  
-  <subroutine name="Base" extends="">
-    <subroutine name="method1" description="Override method 1">
-      <output>Override 1</output>
-    </subroutine>
-    <subroutine name="method3" description="New method 3">
-      <output>New 3</output>
-    </subroutine>
-  </subroutine>
-  
-  <output>Calling Base:</output>
-  <output>
-</output>
-  <Base />
-</dirac>

package/test-available-simple.di

@@ -1,12 +0,0 @@
-<dirac>
-  <subroutine name="Test">
-    <subroutine name="nested1">
-      <output>N1</output>
-    </subroutine>
-    <output>Boundary: <variable name="boundary" /></output>
-    <output>, Stack size: <variable name="size" /></output>
-    <available-subroutines />
-  </subroutine>
-  
-  <Test />
-</dirac>

package/test-available-subroutines.di

@@ -1,16 +0,0 @@
-<dirac>
-  <subroutine name="Person" description="Represents a person with age and gender">
-    <subroutine name="age" param-value="integer:required:Age of the person">
-      <output><variable name="value" /></output>
-    </subroutine>
-    <subroutine name="gender" param-type="string:optional:Gender M/F">
-      <output><variable name="type" /></output>
-    </subroutine>
-    <available-subroutines />
-  </subroutine>
-  
-  <output>Available methods for Person:</output>
-  <output>
-</output>
-  <Person />
-</dirac>

package/test-call.di

@@ -1,9 +0,0 @@
-<dirac>
-  <subroutine name="test" param-x="number">
-    <output>In subroutine, x=<variable name="x" /></output>
-  </subroutine>
-  
-  <output>Before call</output>
-  <call name="test" x="5" />
-  <output>After call</output>
-</dirac>

package/test-extend-basic.di

@@ -1,17 +0,0 @@
-<dirac>
-  <subroutine name="parent">
-    <subroutine name="nested">
-      <output>Parent nested</output>
-    </subroutine>
-    <output>In parent, calling: </output>
-    <call name="nested" />
-  </subroutine>
-  
-  <subroutine name="child" extends="parent">
-    <subroutine name="nested">
-      <output>Child nested</output>
-    </subroutine>
-  </subroutine>
-  
-  <call name="child" />
-</dirac>

package/test-extend-chain.di

@@ -1,26 +0,0 @@
-<dirac>
-  <!-- Base who subroutine -->
-  <subroutine name="who">
-    <subroutine name="_operation">
-      <output>Base operation</output>
-    </subroutine>
-    <output>Who: </output>
-    <call name="_operation" />
-  </subroutine>
-  
-  <!-- First extension - self-extend -->
-  <subroutine name="who" extend="">
-    <subroutine name="_operation">
-      <output>First extension</output>
-    </subroutine>
-  </subroutine>
-  
-  <!-- Second extension - self-extend -->
-  <subroutine name="who" extend="">
-    <subroutine name="_operation">
-      <output>Second extension</output>
-    </subroutine>
-  </subroutine>
-  
-  <call name="who" />
-</dirac>

package/test-extend-debug.di

@@ -1,17 +0,0 @@
-<dirac>
-  <!-- Define base age -->
-  <subroutine name="age">
-    <output>Base: 60</output>
-  </subroutine>
-  
-  <!-- Call age - should show Base: 60 -->
-  <call name="age" />
-  
-  <!-- Override age -->
-  <subroutine name="age">
-    <output>Override: 63</output>
-  </subroutine>
-  
-  <!-- Call age again - should show Override: 63 -->
-  <call name="age" />
-</dirac>

package/test-extend-debug2.di

@@ -1,15 +0,0 @@
-<dirac>
-  <!-- Simplified test -->
-  <subroutine name="parent">
-    <output>In parent, calling nested: </output>
-    <call name="nested" />
-  </subroutine>
-  
-  <subroutine name="child" extends="parent">
-    <subroutine name="nested">
-      <output>Child's nested</output>
-    </subroutine>
-  </subroutine>
-  
-  <call name="child" />
-</dirac>

package/test-extend-person.di

@@ -1,17 +0,0 @@
-<dirac>
-  <subroutine name="person">
-    <subroutine name="age">
-      <output>60</output>
-    </subroutine>
-    <output>Age: </output>
-    <call name="age" />
-  </subroutine>
-  
-  <subroutine name="person" extends="person">
-    <subroutine name="age">
-      <output>63</output>
-    </subroutine>
-  </subroutine>
-  
-  <call name="person" />
-</dirac>

package/test-extend-simple.di

@@ -1,11 +0,0 @@
-<dirac>
-  <subroutine name="parent">
-    <output>Parent body</output>
-  </subroutine>
-  
-  <subroutine name="child" extends="parent">
-    <output>Child body</output>
-  </subroutine>
-  
-  <call name="child" />
-</dirac>

package/test-extend-zhi.di

@@ -1,23 +0,0 @@
-<dirac>
-  <subroutine name="Zhi">
-    <subroutine name="age">
-      <output>60</output>
-    </subroutine>
-    <subroutine name="gender">
-      <output>M</output>
-    </subroutine>
-    <output>Age: </output>
-    <call name="age" />
-    <output>, Gender: </output>
-    <call name="gender" />
-  </subroutine> 
-  
-  <!-- Extended Zhi with new age -->
-  <subroutine name="Zhi" extends="Zhi">
-    <subroutine name="age">
-      <output>63</output>
-    </subroutine>
-  </subroutine>
-  
-  <call name="Zhi" />
-</dirac>

package/test-extend.di

@@ -1,19 +0,0 @@
-<dirac>
-  <!-- Original Zhi subroutine -->
-  <subroutine name="Zhi">
-    <subroutine name="age">
-      <output>60</output>
-    </subroutine>
-    <output>Name: Zhi, Age: </output>
-    <call name="age" />
-  </subroutine>
-  
-  <!-- Extended Zhi subroutine with updated age -->
-  <subroutine name="Zhi" extends="Zhi">
-    <subroutine name="age">
-      <output>63</output>
-    </subroutine>
-  </subroutine>
-  
-  <call name="Zhi" />
-</dirac>

package/test-extend2.di

@@ -1,26 +0,0 @@
-<dirac>
-  <!-- Original Zhi subroutine with nested age -->
-  <subroutine name="Zhi">
-    <subroutine name="age">
-      <output>60</output>
-    </subroutine>
-    <output>Name: Zhi, Age: </output>
-    <call name="age" />
-  </subroutine>
-  
-  <!-- Test: call original -->
-  <output>First call: </output>
-  <call name="Zhi" />
-  <output>&#10;</output>
-  
-  <!-- Extended Zhi with updated age -->
-  <subroutine name="Zhi" extends="Zhi">
-    <subroutine name="age">
-      <output>63</output>
-    </subroutine>
-  </subroutine>
-  
-  <!-- Test: call extended -->
-  <output>Second call: </output>
-  <call name="Zhi" />
-</dirac>

package/test-extend3-fixed.di

@@ -1,23 +0,0 @@
-<dirac>
-  <subroutine name="Zhi">
-    <subroutine name="age">
-      <output>60</output>
-    </subroutine>
-    <subroutine name="gender">
-      <output>M</output>
-    </subroutine>
-    <parameters select="*" />
-  </subroutine> 
-  
-  <!-- Extended Zhi -->
-  <subroutine name="Zhi" extends="Zhi">
-    <subroutine name="age">
-      <output>63</output>
-    </subroutine>
-    <parameters select="*" />
-  </subroutine>
-  
-  <Zhi><age /></Zhi>
-  <output> | </output>
-  <Zhi><gender /></Zhi>
-</dirac>

package/test-extend3-trouble.di

@@ -1,23 +0,0 @@
-<dirac>
-  <subroutine name="Zhi">
-    <subroutine name="age">
-      <output>60</output>
-    </subroutine>
-    <subroutine name="gender">
-      <output>M</output>
-    </subroutine>
-    <parameters select="*" />
-  </subroutine> 
-  
-  <!-- Extended Zhi -->
-  <subroutine name="Zhi" extends="Zhi" >
-    <subroutine name="age">
-      <output>63</output>
-    </subroutine>
-    <parameters select="*" />
-  </subroutine>
-  
-  <Zhi><age /></Zhi>
-  <output> | </output>
-  <Zhi><gender /></Zhi>
-</dirac>

package/test-extend3.di

@@ -1,21 +0,0 @@
-<dirac>
-  <!-- <subroutine name="Zhi" >
-    <subroutine name="age">
-      <output>60</output>
-    </subroutine>
-    <subroutine name="gender">
-     <output>M</output>
-    </subroutine>
-  </subroutine>  -->
-  
-  <!-- Extended Zhi -->
-  <subroutine name="Zhi" >
-    <subroutine name="age">
-      <output>63</output>
-    </subroutine>
-    <parameters select="*" />
-  </subroutine>
-  
-  <Zhi><age /></Zhi>
-  <Zhi><gender /></Zhi>
-</dirac>

package/test-factorial.di

@@ -1,19 +0,0 @@
-<dirac>
-  <subroutine name="factorial" param-num="number">
-    <eval name="result">
-      const n = parseInt(num);
-      if (n <= 1) {
-        return 1;
-      } else {
-        let fact = 1;
-        for (let i = 2; i <= n; i++) {
-          fact *= i;
-        }
-        return fact;
-      }
-    </eval>
-    <output><variable name="result" /></output>
-  </subroutine>
-  
-  <call name="factorial" num="5" />
-</dirac>

package/test-input-debug.di

@@ -1,19 +0,0 @@
-<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/test-nested-debug.di

@@ -1,7 +0,0 @@
-<dirac>
-  <loop count="2" var="i">
-    <loop count="2" var="j">
-      <output>[i=<variable name="i" /> j=<variable name="j" />] </output>
-    </loop>
-  </loop>
-</dirac>

package/test-nested-debug2.di

@@ -1,8 +0,0 @@
-<dirac>
-  <loop count="2" var="i">
-    <loop count="2" var="j">
-      <eval name="letter">return j === '0' ? 'A' : 'B';</eval>
-      <output>[j=<variable name="j" /> letter=<variable name="letter" />] </output>
-    </loop>
-  </loop>
-</dirac>

package/test-no-extend.di

@@ -1,16 +0,0 @@
-<dirac>
-  <!-- Just the extended Zhi without extends -->
-  <subroutine name="Zhi">
-    <subroutine name="age">
-      <output>63</output>
-    </subroutine>
-    <subroutine name="gender">
-      <output>F</output>
-    </subroutine>
-    <parameters select="*" />
-  </subroutine>
-  
-  <Zhi><age /></Zhi>
-  <output> | </output>
-  <Zhi><gender /></Zhi>
-</dirac>

package/test-simple-call.di

@@ -1,7 +0,0 @@
-<dirac>
-  <subroutine name="Test">
-    <output>In Test</output>
-  </subroutine>
-  
-  <call name="Test" />
-</dirac>

package/test-simple.di

@@ -1,6 +0,0 @@
-<dirac>
-  <defvar name="x" value="10" />
-  <test-if test="$x" gt="5">
-    <output>Greater!</output>
-  </test-if>
-</dirac>