@agentix-e/nl2spel 0.0.0 → 1.0.0

package/dist/validation/self-correction-loop.d.ts

@@ -0,0 +1,46 @@
+import type { LLMPrompt, LLMResponse } from '../provider/llm-provider.js';
+import { ValidationPipeline } from './validation-pipeline.js';
+import { AutoFixer } from './auto-fixer.js';
+import type { ContextSchema } from '../SpelEvaluator.js';
+export interface SelfCorrectionResult {
+    /** Final expression */
+    expression: string;
+    /** Whether validation passed */
+    valid: boolean;
+    /** Original LLM output */
+    originalOutput: string;
+    /** Number of correction attempts */
+    correctionAttempts: number;
+    /** Log of each correction round */
+    corrections: CorrectionLog[];
+    /** Total latency (ms) */
+    totalLatencyMs: number;
+}
+export interface CorrectionLog {
+    attempt: number;
+    expression: string;
+    valid: boolean;
+    errorCount: number;
+    warningCount: number;
+    autoFixed: boolean;
+    autoFixChanges: string[];
+}
+export interface SelfCorrectionConfig {
+    /** Maximum correction attempts (default 3) */
+    maxAttempts?: number;
+    /** Minimum confidence threshold (default 0.7) */
+    minConfidence?: number;
+    /** Whether AutoFix is enabled (default true) */
+    enableAutoFix?: boolean;
+}
+export declare class SelfCorrectionLoop {
+    private readonly pipeline;
+    private readonly autoFixer;
+    private readonly config;
+    constructor(config?: SelfCorrectionConfig, pipeline?: ValidationPipeline, autoFixer?: AutoFixer);
+    /**
+     * Execute the self-correction loop
+     */
+    correct(expression: string, contextSchema: ContextSchema, generateFn: (prompt: LLMPrompt) => Promise<LLMResponse>, originalPrompt: LLMPrompt): Promise<SelfCorrectionResult>;
+}
+//# sourceMappingURL=self-correction-loop.d.ts.map

package/dist/validation/self-correction-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-correction-loop.d.ts","sourceRoot":"","sources":["../../src/validation/self-correction-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,SAAS,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAyB,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IAEf,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAC;IAEvB,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAE3B,mCAAmC;IACnC,WAAW,EAAE,aAAa,EAAE,CAAC;IAE7B,yBAAyB;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAG5C,MAAM,GAAE,oBAAyB,EACjC,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,SAAS,CAAC,EAAE,SAAS;IAWvB;;OAEG;IACU,OAAO,CAClB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,WAAW,CAAC,EACvD,cAAc,EAAE,SAAS,GACxB,OAAO,CAAC,oBAAoB,CAAC;CAwIjC"}

package/dist/validation/self-correction-loop.js

@@ -0,0 +1,141 @@
+import { ValidationPipeline } from './validation-pipeline.js';
+import { AutoFixer } from './auto-fixer.js';
+export class SelfCorrectionLoop {
+    pipeline;
+    autoFixer;
+    config;
+    constructor(config = {}, pipeline, autoFixer) {
+        this.config = {
+            maxAttempts: config.maxAttempts ?? 3,
+            minConfidence: config.minConfidence ?? 0.7,
+            enableAutoFix: config.enableAutoFix ?? true,
+        };
+        this.pipeline = pipeline ?? new ValidationPipeline();
+        this.autoFixer = autoFixer ?? new AutoFixer();
+    }
+    /**
+     * Execute the self-correction loop
+     */
+    async correct(expression, contextSchema, generateFn, originalPrompt) {
+        const startTime = Date.now();
+        const corrections = [];
+        let currentExpression = expression;
+        let valid = false;
+        // Attempt 0: directly validate original output
+        const initialResult = await this.pipeline.validate(currentExpression, contextSchema);
+        if (initialResult.valid) {
+            return {
+                expression: currentExpression,
+                valid: true,
+                originalOutput: expression,
+                correctionAttempts: 0,
+                corrections,
+                totalLatencyMs: Date.now() - startTime,
+            };
+        }
+        // Attempt 0.5: try AutoFix
+        if (this.config.enableAutoFix && initialResult.errors.length > 0) {
+            const autoFixResult = this.autoFixer.fix(currentExpression);
+            if (autoFixResult.wasFixed) {
+                currentExpression = autoFixResult.expression;
+                corrections.push({
+                    attempt: 0,
+                    expression: currentExpression,
+                    valid: false,
+                    errorCount: initialResult.errors.length,
+                    warningCount: initialResult.warnings.length,
+                    autoFixed: true,
+                    autoFixChanges: autoFixResult.changes,
+                });
+                // Validate AutoFix result
+                const afterFix = await this.pipeline.validate(currentExpression, contextSchema);
+                if (afterFix.valid) {
+                    return {
+                        expression: currentExpression,
+                        valid: true,
+                        originalOutput: expression,
+                        correctionAttempts: 1,
+                        corrections,
+                        totalLatencyMs: Date.now() - startTime,
+                    };
+                }
+                // AutoFix not sufficient, continue to LLM correction
+                corrections.push({
+                    attempt: 0,
+                    expression: currentExpression,
+                    valid: afterFix.valid,
+                    errorCount: afterFix.errors.length,
+                    warningCount: afterFix.warnings.length,
+                    autoFixed: false,
+                    autoFixChanges: [],
+                });
+            }
+        }
+        // Attempts 1..N: LLM regeneration
+        for (let attempt = 1; attempt <= this.config.maxAttempts; attempt++) {
+            const lastValidation = await this.pipeline.validate(currentExpression, contextSchema);
+            // Build correction prompt
+            const errorDescriptions = lastValidation.errors
+                .map(e => `- [${e.code}] ${e.message}`)
+                .join('\n');
+            const correctionPrompt = {
+                ...originalPrompt,
+                user: [
+                    originalPrompt.user,
+                    '',
+                    '---',
+                    'The previous generated expression was INVALID. Please fix it:',
+                    `Expression: ${currentExpression}`,
+                    `Errors:\n${errorDescriptions}`,
+                    '---',
+                    'Generate ONLY the corrected SpEL expression, nothing else.',
+                ].join('\n'),
+            };
+            try {
+                const response = await generateFn(correctionPrompt);
+                currentExpression = response.text.trim();
+                // Apply AutoFix again
+                if (this.config.enableAutoFix) {
+                    const afResult = this.autoFixer.fix(currentExpression);
+                    if (afResult.wasFixed) {
+                        currentExpression = afResult.expression;
+                    }
+                }
+                const currentValidation = await this.pipeline.validate(currentExpression, contextSchema);
+                corrections.push({
+                    attempt,
+                    expression: currentExpression,
+                    valid: currentValidation.valid,
+                    errorCount: currentValidation.errors.length,
+                    warningCount: currentValidation.warnings.length,
+                    autoFixed: false,
+                    autoFixChanges: [],
+                });
+                if (currentValidation.valid) {
+                    valid = true;
+                    break;
+                }
+            }
+            catch (err) {
+                corrections.push({
+                    attempt,
+                    expression: currentExpression,
+                    valid: false,
+                    errorCount: 1,
+                    warningCount: 0,
+                    autoFixed: false,
+                    autoFixChanges: [],
+                });
+            }
+        }
+        return {
+            expression: currentExpression,
+            valid,
+            originalOutput: expression,
+            correctionAttempts: corrections.filter(c => c.attempt > 0).length,
+            corrections,
+            totalLatencyMs: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=self-correction-loop.js.map

package/dist/validation/self-correction-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-correction-loop.js","sourceRoot":"","sources":["../../src/validation/self-correction-loop.ts"],"names":[],"mappings":"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"}

package/dist/validation/validation-pipeline.d.ts

@@ -0,0 +1,81 @@
+import type { ContextSchema, SpelEvaluator } from '../SpelEvaluator.js';
+export interface ValidationResult {
+    /** Whether all validation stages passed */
+    valid: boolean;
+    /** Stage results */
+    stages: {
+        parse: StageResult;
+        type: StageResult;
+        semantic: StageResult;
+        context: StageResult;
+    };
+    /** All errors */
+    errors: ValidationError[];
+    /** All warnings */
+    warnings: ValidationWarning[];
+}
+export interface StageResult {
+    passed: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+export interface ValidationError {
+    code: string;
+    message: string;
+    /** Error position in expression */
+    position?: number;
+    /** Stage the error belongs to */
+    stage: 'parse' | 'type' | 'semantic' | 'context';
+    /** Whether LLM regeneration is needed */
+    requiresLLM?: boolean;
+}
+export interface ValidationWarning {
+    code: string;
+    message: string;
+    /** Warning position in expression */
+    position?: number;
+    /** Stage the warning belongs to */
+    stage: 'parse' | 'type' | 'semantic' | 'context';
+}
+/**
+ * ValidationPipeline — four-stage validation pipeline.
+ *
+ * 1. Parse: syntax validity (depends on SpelEvaluator)
+ * 2. Type: type checking (operator-operand type matching)
+ * 3. Semantic: semantic reasonableness (is the expression meaningful)
+ * 4. Context: context references (do all references exist in ContextSchema)
+ */
+export declare class ValidationPipeline {
+    private evaluator;
+    constructor(evaluator?: SpelEvaluator | null);
+    setEvaluator(evaluator: SpelEvaluator): void;
+    /**
+     * Run the full validation pipeline
+     */
+    validate(expression: string, contextSchema?: ContextSchema): Promise<ValidationResult>;
+    /**
+     * Stage 1: Parse Check — syntax validation
+     */
+    private validateParse;
+    /**
+     * Stage 2: Type Check — type validation
+     */
+    private validateTypes;
+    /**
+     * Stage 3: Semantic Check — semantic reasonableness validation
+     */
+    private validateSemantic;
+    /**
+     * Stage 4: Context Check — context reference validation
+     */
+    private validateContext;
+    /**
+     * Check if parentheses are balanced
+     */
+    private hasBalancedParentheses;
+    /**
+     * Extract all identifier references from expression
+     */
+    private extractReferences;
+}
+//# sourceMappingURL=validation-pipeline.d.ts.map

package/dist/validation/validation-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-pipeline.d.ts","sourceRoot":"","sources":["../../src/validation/validation-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMxE,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,KAAK,EAAE,OAAO,CAAC;IAEf,oBAAoB;IACpB,MAAM,EAAE;QACN,KAAK,EAAE,WAAW,CAAC;QACnB,IAAI,EAAE,WAAW,CAAC;QAClB,QAAQ,EAAE,WAAW,CAAC;QACtB,OAAO,EAAE,WAAW,CAAC;KACtB,CAAC;IAEF,iBAAiB;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAE1B,mBAAmB;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACjD,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;CAClD;AAMD;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAuB;gBAE5B,SAAS,GAAE,aAAa,GAAG,IAAW;IAI3C,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAInD;;OAEG;IACU,QAAQ,CACnB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,gBAAgB,CAAC;IA0C5B;;OAEG;YACW,aAAa;IAsF3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAyCrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyEvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAoB1B"}

package/dist/validation/validation-pipeline.js

@@ -0,0 +1,306 @@
+// ============================================================
+// ValidationPipeline
+// ============================================================
+/**
+ * ValidationPipeline — four-stage validation pipeline.
+ *
+ * 1. Parse: syntax validity (depends on SpelEvaluator)
+ * 2. Type: type checking (operator-operand type matching)
+ * 3. Semantic: semantic reasonableness (is the expression meaningful)
+ * 4. Context: context references (do all references exist in ContextSchema)
+ */
+export class ValidationPipeline {
+    evaluator;
+    constructor(evaluator = null) {
+        this.evaluator = evaluator;
+    }
+    setEvaluator(evaluator) {
+        this.evaluator = evaluator;
+    }
+    /**
+     * Run the full validation pipeline
+     */
+    async validate(expression, contextSchema) {
+        const errors = [];
+        const warnings = [];
+        // Stage 1: Parse Check
+        const parseStage = await this.validateParse(expression);
+        // Stage 2: Type Check
+        const typeStage = this.validateTypes(expression, contextSchema);
+        // Stage 3: Semantic Check
+        const semanticStage = this.validateSemantic(expression);
+        // Stage 4: Context Check
+        const contextStage = this.validateContext(expression, contextSchema);
+        errors.push(...parseStage.errors, ...typeStage.errors, ...semanticStage.errors, ...contextStage.errors);
+        warnings.push(...parseStage.warnings, ...typeStage.warnings, ...semanticStage.warnings, ...contextStage.warnings);
+        return {
+            valid: parseStage.passed && typeStage.passed && semanticStage.passed && contextStage.passed,
+            stages: {
+                parse: parseStage,
+                type: typeStage,
+                semantic: semanticStage,
+                context: contextStage,
+            },
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Stage 1: Parse Check — syntax validation
+     */
+    async validateParse(expression) {
+        const errors = [];
+        const warnings = [];
+        // Basic empty expression check
+        if (!expression || expression.trim().length === 0) {
+            errors.push({
+                code: 'PARSE-EMPTY',
+                message: 'Expression is empty',
+                stage: 'parse',
+                requiresLLM: true,
+            });
+            return { passed: false, errors, warnings };
+        }
+        // Parentheses balance check
+        if (!this.hasBalancedParentheses(expression)) {
+            errors.push({
+                code: 'PARSE-UNBALANCED_PARENS',
+                message: 'Unbalanced parentheses in expression',
+                stage: 'parse',
+                requiresLLM: true,
+            });
+        }
+        // Illegal character check
+        if (expression.includes('===') || expression.includes('!==')) {
+            errors.push({
+                code: 'PARSE-JS_OPERATOR',
+                message: 'JavaScript operators detected (=== or !==), use == or != in SpEL',
+                stage: 'parse',
+                requiresLLM: true,
+            });
+        }
+        // Check for JS-style logical operators
+        if (expression.includes('&&')) {
+            errors.push({
+                code: 'PARSE-JS_LOGIC',
+                message: 'JavaScript && detected, use "and" in SpEL',
+                stage: 'parse',
+                requiresLLM: true,
+            });
+        }
+        if (expression.includes('||')) {
+            errors.push({
+                code: 'PARSE-JS_LOGIC',
+                message: 'JavaScript || detected, use "or" in SpEL',
+                stage: 'parse',
+                requiresLLM: true,
+            });
+        }
+        // If an evaluator is configured, perform actual syntax parsing
+        if (this.evaluator) {
+            try {
+                const parseResult = await this.evaluator.parse(expression);
+                if (!parseResult.valid) {
+                    for (const pe of parseResult.errors) {
+                        errors.push({
+                            code: `PARSE-${pe.code ?? 'SYNTAX'}`,
+                            message: pe.message,
+                            position: pe.position,
+                            stage: 'parse',
+                            requiresLLM: true,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                errors.push({
+                    code: 'PARSE-EXCEPTION',
+                    message: `Parse threw exception: ${err.message}`,
+                    stage: 'parse',
+                    requiresLLM: true,
+                });
+            }
+        }
+        return {
+            passed: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Stage 2: Type Check — type validation
+     */
+    validateTypes(expression, contextSchema) {
+        const errors = [];
+        const warnings = [];
+        // Check string vs number comparison (may require full ContextSchema support)
+        // Here we do basic heuristic checks
+        // Check if string literals are used with numeric operators
+        const strNumMismatch = /'(?:\\.|[^'\\])*'\s*(?:>|<|>=|<=)\s*\d+/;
+        if (strNumMismatch.test(expression)) {
+            warnings.push({
+                code: 'TYPE-STR_NUM_CMP',
+                message: 'String literal compared with number using arithmetic operator',
+                stage: 'type',
+            });
+        }
+        // If ContextSchema is provided, do deeper checks
+        if (contextSchema?.root) {
+            for (const [fieldName, field] of Object.entries(contextSchema.root.fields)) {
+                if (field.type === 'boolean') {
+                    // Check boolean field compared with number
+                    const boolNumPattern = new RegExp(`#\\w+\\.${fieldName}\\s*(?:>|<|>=|<=)\\s*\\d+`);
+                    if (boolNumPattern.test(expression)) {
+                        warnings.push({
+                            code: 'TYPE-BOOL_NUM_CMP',
+                            message: `Boolean field '${fieldName}' compared with number`,
+                            stage: 'type',
+                        });
+                    }
+                }
+            }
+        }
+        return {
+            passed: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Stage 3: Semantic Check — semantic reasonableness validation
+     */
+    validateSemantic(expression) {
+        const errors = [];
+        const warnings = [];
+        // Check for tautology/contradiction like `x == x`
+        const selfCompare = /(#\w+(?:\.\w+)*)\s*==\s*\1/;
+        if (selfCompare.test(expression)) {
+            warnings.push({
+                code: 'SEM-SELF_COMPARE',
+                message: 'Self-comparison detected: expression is always true',
+                stage: 'semantic',
+            });
+        }
+        // Check for double negation (`!!`)
+        if (expression.includes('!!')) {
+            warnings.push({
+                code: 'SEM-DOUBLE_NEGATION',
+                message: 'Double negation detected, consider simplifying',
+                stage: 'semantic',
+            });
+        }
+        return {
+            passed: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Stage 4: Context Check — context reference validation
+     */
+    validateContext(expression, contextSchema) {
+        const errors = [];
+        const warnings = [];
+        if (!contextSchema) {
+            warnings.push({
+                code: 'CTX-NO_SCHEMA',
+                message: 'No ContextSchema provided, skipping context validation',
+                stage: 'context',
+            });
+            return { passed: true, errors, warnings };
+        }
+        // Extract all references from expression
+        const refs = this.extractReferences(expression);
+        // Validate root references
+        if (contextSchema.root) {
+            const rootName = contextSchema.root.name;
+            for (const ref of refs) {
+                if (ref.startsWith(`#${rootName}`)) {
+                    const parts = ref.split('.');
+                    const field = parts[1];
+                    if (field && !(field in contextSchema.root.fields)) {
+                        warnings.push({
+                            code: 'CTX-UNKNOWN_FIELD',
+                            message: `Field '${field}' not found in root '${rootName}'`,
+                            stage: 'context',
+                        });
+                    }
+                }
+            }
+        }
+        // Validate variable references
+        for (const ref of refs) {
+            if (ref.startsWith('#') && !ref.includes('.')) {
+                const varName = ref.slice(1);
+                const isRoot = contextSchema.root?.name === varName;
+                const isVariable = varName in contextSchema.variables;
+                const isFunction = varName in contextSchema.functions;
+                if (!isRoot && !isVariable && !isFunction) {
+                    warnings.push({
+                        code: 'CTX-UNKNOWN_REF',
+                        message: `Unknown reference '${ref}'`,
+                        stage: 'context',
+                    });
+                }
+            }
+        }
+        // Validate Bean references
+        const beanMatch = expression.match(/@(\w+)/g);
+        if (beanMatch && contextSchema.beans) {
+            for (const b of beanMatch) {
+                const beanName = b.slice(1);
+                if (!(beanName in contextSchema.beans)) {
+                    warnings.push({
+                        code: 'CTX-UNKNOWN_BEAN',
+                        message: `Bean '${beanName}' not found in ContextSchema`,
+                        stage: 'context',
+                    });
+                }
+            }
+        }
+        return {
+            passed: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Check if parentheses are balanced
+     */
+    hasBalancedParentheses(expression) {
+        const stack = [];
+        const pairs = { '(': ')', '[': ']', '{': '}' };
+        for (const ch of expression) {
+            if (ch in pairs) {
+                stack.push(ch);
+            }
+            else if (ch === ')' || ch === ']' || ch === '}') {
+                const last = stack.pop();
+                if (!last || pairs[last] !== ch)
+                    return false;
+            }
+        }
+        return stack.length === 0;
+    }
+    /**
+     * Extract all identifier references from expression
+     */
+    extractReferences(expression) {
+        const refs = [];
+        // #root.field pattern
+        const varMatch = expression.matchAll(/#(\w+(?:\.\w+(?:\.\w+)?)?)/g);
+        for (const m of varMatch) {
+            refs.push(`#${m[1]}`);
+        }
+        // #variable pattern
+        const simpleMatch = expression.matchAll(/#(\w+)(?!\w*\()/g);
+        for (const m of simpleMatch) {
+            const ref = `#${m[1]}`;
+            if (!refs.includes(ref)) {
+                refs.push(ref);
+            }
+        }
+        return refs;
+    }
+}
+//# sourceMappingURL=validation-pipeline.js.map

package/dist/validation/validation-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-pipeline.js","sourceRoot":"","sources":["../../src/validation/validation-pipeline.ts"],"names":[],"mappings":"AAmDA,+DAA+D;AAC/D,qBAAqB;AACrB,+DAA+D;AAE/D;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IACrB,SAAS,CAAuB;IAExC,YAAY,YAAkC,IAAI;QAChD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAEM,YAAY,CAAC,SAAwB;QAC1C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ,CACnB,UAAkB,EAClB,aAA6B;QAE7B,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAwB,EAAE,CAAC;QAEzC,uBAAuB;QACvB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAExD,sBAAsB;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAEhE,0BAA0B;QAC1B,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAExD,yBAAyB;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAErE,MAAM,CAAC,IAAI,CACT,GAAG,UAAU,CAAC,MAAM,EACpB,GAAG,SAAS,CAAC,MAAM,EACnB,GAAG,aAAa,CAAC,MAAM,EACvB,GAAG,YAAY,CAAC,MAAM,CACvB,CAAC;QACF,QAAQ,CAAC,IAAI,CACX,GAAG,UAAU,CAAC,QAAQ,EACtB,GAAG,SAAS,CAAC,QAAQ,EACrB,GAAG,aAAa,CAAC,QAAQ,EACzB,GAAG,YAAY,CAAC,QAAQ,CACzB,CAAC;QAEF,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM;YAC3F,MAAM,EAAE;gBACN,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,aAAa;gBACvB,OAAO,EAAE,YAAY;aACtB;YACD,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,UAAkB;QAC5C,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAwB,EAAE,CAAC;QAEzC,+BAA+B;QAC/B,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,qBAAqB;gBAC9B,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC7C,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,sCAAsC;gBAC/C,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED,0BAA0B;QAC1B,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,kEAAkE;gBAC3E,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED,uCAAuC;QACvC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,2CAA2C;gBACpD,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,0CAA0C;gBACnD,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED,+DAA+D;QAC/D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC3D,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;oBACvB,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;wBACpC,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI,EAAE,SAAS,EAAE,CAAC,IAAI,IAAI,QAAQ,EAAE;4BACpC,OAAO,EAAE,EAAE,CAAC,OAAO;4BACnB,QAAQ,EAAE,EAAE,CAAC,QAAQ;4BACrB,KAAK,EAAE,OAAO;4BACd,WAAW,EAAE,IAAI;yBAClB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,0BAA2B,GAAa,CAAC,OAAO,EAAE;oBAC3D,KAAK,EAAE,OAAO;oBACd,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC3B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,UAAkB,EAAE,aAA6B;QACrE,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAwB,EAAE,CAAC;QAEzC,6EAA6E;QAC7E,oCAAoC;QAEpC,2DAA2D;QAC3D,MAAM,cAAc,GAAG,yCAAyC,CAAC;QACjE,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,+DAA+D;gBACxE,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;QACL,CAAC;QAED,iDAAiD;QACjD,IAAI,aAAa,EAAE,IAAI,EAAE,CAAC;YACxB,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3E,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC7B,2CAA2C;oBAC3C,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,WAAW,SAAS,2BAA2B,CAAC,CAAC;oBACnF,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;wBACpC,QAAQ,CAAC,IAAI,CAAC;4BACZ,IAAI,EAAE,mBAAmB;4BACzB,OAAO,EAAE,kBAAkB,SAAS,wBAAwB;4BAC5D,KAAK,EAAE,MAAM;yBACd,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC3B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,UAAkB;QACzC,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAwB,EAAE,CAAC;QAEzC,kDAAkD;QAClD,MAAM,WAAW,GAAG,4BAA4B,CAAC;QACjD,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,qDAAqD;gBAC9D,KAAK,EAAE,UAAU;aAClB,CAAC,CAAC;QACL,CAAC;QAED,mCAAmC;QACnC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,gDAAgD;gBACzD,KAAK,EAAE,UAAU;aAClB,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC3B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,UAAkB,EAAE,aAA6B;QACvE,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAwB,EAAE,CAAC;QAEzC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,wDAAwD;gBACjE,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC5C,CAAC;QAED,yCAAyC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAEhD,2BAA2B;QAC3B,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,CAAC;oBACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACvB,IAAI,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;wBACnD,QAAQ,CAAC,IAAI,CAAC;4BACZ,IAAI,EAAE,mBAAmB;4BACzB,OAAO,EAAE,UAAU,KAAK,wBAAwB,QAAQ,GAAG;4BAC3D,KAAK,EAAE,SAAS;yBACjB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC7B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;gBACpD,MAAM,UAAU,GAAG,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC;gBACtD,MAAM,UAAU,GAAG,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC;gBACtD,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;oBAC1C,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,iBAAiB;wBACvB,OAAO,EAAE,sBAAsB,GAAG,GAAG;wBACrC,KAAK,EAAE,SAAS;qBACjB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,SAAS,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC5B,IAAI,CAAC,CAAC,QAAQ,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvC,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,kBAAkB;wBACxB,OAAO,EAAE,SAAS,QAAQ,8BAA8B;wBACxD,KAAK,EAAE,SAAS;qBACjB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC3B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,sBAAsB,CAAC,UAAkB;QAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,KAAK,GAA2B,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAEvE,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;iBAAM,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBAClD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE;oBAAE,OAAO,KAAK,CAAC;YAChD,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,UAAkB;QAC1C,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,sBAAsB;QACtB,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC;QACpE,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC;QACzB,CAAC;QAED,oBAAoB;QACpB,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QAC5D,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/package.json

@@ -1,10 +1,39 @@
 {
   "name": "@agentix-e/nl2spel",
-  "version": "0.0.0",
-  "description": "OIDC trusted publishing setup package for @agentix-e/nl2spel",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "version": "1.0.0",
+  "description": "Natural Language → SpEL Expression Generation Engine — Core",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "keywords": ["spel", "nlp", "expression-language", "spring", "nl2code", "agentix"],
+  "license": "MIT",
+  "author": "Agentix-E",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentiX-E/nl2spel.git",
+    "directory": "packages/nl2spel"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }