@agentix-e/nl2spel 0.0.0 → 1.0.0

package/dist/__tests__/validation-pipeline.test.js

@@ -0,0 +1,262 @@
+import { describe, it, expect } from 'vitest';
+import { ValidationPipeline } from '../validation/validation-pipeline.js';
+function createSchema() {
+    return {
+        root: {
+            name: 'order',
+            type: 'Order',
+            fields: {
+                amount: { type: 'number', description: '订单金额' },
+                status: { type: 'string', description: '订单状态' },
+                remark: { type: 'string', description: '备注' },
+                paid: { type: 'boolean', description: '是否支付' },
+                items: { type: 'array', isCollection: true, elementType: 'object' },
+                tags: { type: 'array', isCollection: true, elementType: 'string' },
+            },
+            methods: {},
+        },
+        variables: { user: { type: 'object' } },
+        beans: { discountService: { type: 'DiscountService' } },
+        types: { Admin: { className: 'com.example.Admin' } },
+        functions: {},
+    };
+}
+class MockEvaluator {
+    validExpressions;
+    constructor(validExpressions = []) {
+        this.validExpressions = new Set(validExpressions);
+    }
+    async parse(expression) {
+        if (this.validExpressions.has(expression)) {
+            return { valid: true, errors: [] };
+        }
+        return {
+            valid: false,
+            errors: [
+                {
+                    message: `Syntax error in: ${expression}`,
+                    position: 0,
+                    code: 'SYNTAX',
+                },
+            ],
+        };
+    }
+    getContextSchema() {
+        return createSchema();
+    }
+}
+describe('ValidationPipeline', () => {
+    const pipeline = new ValidationPipeline();
+    const schema = createSchema();
+    // ===== VL-G07: Parse Check =====
+    describe('VL-G07: Parse Check', () => {
+        it('should pass valid expressions', async () => {
+            const result = await pipeline.validate('#order.amount > 1000', schema);
+            expect(result.stages.parse.passed).toBe(true);
+        });
+        it('should fail empty expression', async () => {
+            const result = await pipeline.validate('', schema);
+            expect(result.stages.parse.passed).toBe(false);
+            expect(result.errors.some(e => e.code === 'PARSE-EMPTY')).toBe(true);
+        });
+        it('should detect JS === operator', async () => {
+            const result = await pipeline.validate('#order.amount === 1000', schema);
+            expect(result.errors.some(e => e.code === 'PARSE-JS_OPERATOR')).toBe(true);
+        });
+        it('should detect JS !== operator', async () => {
+            const result = await pipeline.validate("#order.status !== 'done'", schema);
+            expect(result.errors.some(e => e.code === 'PARSE-JS_OPERATOR')).toBe(true);
+        });
+        it('should detect JS && operator', async () => {
+            const result = await pipeline.validate('#order.amount > 100 && #order.paid', schema);
+            expect(result.errors.some(e => e.code === 'PARSE-JS_LOGIC')).toBe(true);
+        });
+        it('should detect JS || operator', async () => {
+            const result = await pipeline.validate('#order.vip || #order.admin', schema);
+            expect(result.errors.some(e => e.code === 'PARSE-JS_LOGIC')).toBe(true);
+        });
+        it('should detect unbalanced parentheses', async () => {
+            const result = await pipeline.validate('(#order.amount > 100', schema);
+            expect(result.errors.some(e => e.code === 'PARSE-UNBALANCED_PARENS')).toBe(true);
+        });
+        it('should pass balanced complex expressions', async () => {
+            const result = await pipeline.validate("(#order.amount > 100) and (#order.status == 'done')", schema);
+            expect(result.stages.parse.passed).toBe(true);
+        });
+        it('should pass balanced brackets', async () => {
+            const result = await pipeline.validate('#order.items.?[#this.amount > 100]', schema);
+            expect(result.stages.parse.passed).toBe(true);
+        });
+    });
+    // ===== VL-G08: Type Check =====
+    describe('VL-G08: Type Check', () => {
+        it('should pass valid type operations', async () => {
+            const result = await pipeline.validate('#order.amount > 100', schema);
+            expect(result.stages.type.passed).toBe(true);
+        });
+        it('should warn on string-number comparison', async () => {
+            const result = await pipeline.validate("'hello' > 100", schema);
+            expect(result.stages.type.warnings.length).toBeGreaterThan(0);
+        });
+        it('should warn on boolean-number comparison', async () => {
+            const result = await pipeline.validate('#order.paid > 5', schema);
+            expect(result.stages.type.warnings.length).toBeGreaterThan(0);
+        });
+    });
+    // ===== VL-G09: Semantic Check =====
+    describe('VL-G09: Semantic Check', () => {
+        it('should pass semantically valid expressions', async () => {
+            const result = await pipeline.validate('#order.amount > 100', schema);
+            expect(result.stages.semantic.passed).toBe(true);
+        });
+        it('should warn on self-comparison', async () => {
+            const result = await pipeline.validate('#order.amount == #order.amount', schema);
+            expect(result.stages.semantic.warnings.length).toBeGreaterThan(0);
+        });
+        it('should warn on double negation', async () => {
+            const result = await pipeline.validate('!!#order.paid', schema);
+            expect(result.stages.semantic.warnings.length).toBeGreaterThan(0);
+        });
+        it('should pass valid negation', async () => {
+            const result = await pipeline.validate('!#order.paid', schema);
+            expect(result.stages.semantic.passed).toBe(true);
+        });
+    });
+    // ===== VL-G10: Context Check =====
+    describe('VL-G10: Context Check', () => {
+        it('should pass context-valid expressions', async () => {
+            const result = await pipeline.validate('#order.amount > 100', schema);
+            expect(result.stages.context.passed).toBe(true);
+        });
+        it('should warn on unknown field', async () => {
+            const result = await pipeline.validate('#order.unknown > 100', schema);
+            expect(result.stages.context.warnings.length).toBeGreaterThan(0);
+        });
+        it('should warn on unknown bean reference', async () => {
+            const result = await pipeline.validate('@unknownService', schema);
+            expect(result.stages.context.warnings.length).toBeGreaterThan(0);
+        });
+        it('should warn without ContextSchema', async () => {
+            const result = await pipeline.validate('#order.amount > 100');
+            expect(result.stages.context.warnings.some(w => w.code === 'CTX-NO_SCHEMA')).toBe(true);
+        });
+        it('should pass known bean reference', async () => {
+            // @discountService is in the schema
+            const result = await pipeline.validate('@discountService', schema);
+            expect(result.valid).toBe(true);
+        });
+        it('should detect unknown variable', async () => {
+            const result = await pipeline.validate('#unknown > 100', schema);
+            expect(result.stages.context.warnings.length).toBeGreaterThan(0);
+        });
+    });
+    // ===== VL-G11: Full Validation Flow =====
+    describe('VL-G11: Full Validation Flow', () => {
+        it('should validate a correct expression fully', async () => {
+            const result = await pipeline.validate("#order.amount > 1000 and #order.tags.contains('VIP')", schema);
+            expect(result.valid).toBe(true);
+            expect(result.errors).toHaveLength(0);
+        });
+        it('should collect all errors from all stages', async () => {
+            const result = await pipeline.validate('#order.amount === 1000 && #order.unknown > 100', schema);
+            expect(result.errors.length).toBeGreaterThan(1);
+            expect(result.valid).toBe(false);
+        });
+        it('should mark errors as requiring LLM re-generation', async () => {
+            const result = await pipeline.validate('#order.amount === 1000', schema);
+            const parseErrors = result.errors.filter(e => e.stage === 'parse');
+            expect(parseErrors.some(e => e.requiresLLM)).toBe(true);
+        });
+    });
+    // ===== VL-G12: Custom Evaluator =====
+    describe('VL-G12: Custom SpelEvaluator', () => {
+        it('should use provided evaluator for parse validation', async () => {
+            const evaluator = new MockEvaluator(['#order.amount > 1000']);
+            const pipeline = new ValidationPipeline(evaluator);
+            const result = await pipeline.validate('#order.amount > 1000', schema);
+            expect(result.stages.parse.passed).toBe(true);
+        });
+        it('should report parse errors from evaluator', async () => {
+            const evaluator = new MockEvaluator();
+            const pipeline = new ValidationPipeline(evaluator);
+            const result = await pipeline.validate('#invalid expression!', schema);
+            expect(result.stages.parse.passed).toBe(false);
+            expect(result.stages.parse.errors.length).toBeGreaterThan(0);
+        });
+        it('should set evaluator after construction', async () => {
+            const pipeline = new ValidationPipeline();
+            pipeline.setEvaluator(new MockEvaluator(['#order.amount > 1000']));
+            const result = await pipeline.validate('#order.amount > 1000', schema);
+            expect(result.stages.parse.passed).toBe(true);
+        });
+    });
+    // ===== Edge Cases & Integration =====
+    describe('edge cases', () => {
+        it('should fail expression that is whitespace only after trim', async () => {
+            const result = await pipeline.validate('   ', schema);
+            expect(result.stages.parse.passed).toBe(false);
+            expect(result.errors.some(e => e.code === 'PARSE-EMPTY')).toBe(true);
+        });
+        it('should detect unbalanced curly braces', async () => {
+            const result = await pipeline.validate('#order.amount > 100}', schema);
+            expect(result.stages.parse.passed).toBe(false);
+            expect(result.errors.some(e => e.code === 'PARSE-UNBALANCED_PARENS')).toBe(true);
+        });
+        it('should handle instanceof with unknown type in ContextSchema', async () => {
+            // T() type validation is not part of the context check, so it should pass
+            const result = await pipeline.validate('#order instanceof T(com.example.Unknown)', schema);
+            expect(result.stages.parse.passed).toBe(true);
+        });
+        it('should recognize declared function reference in expression', async () => {
+            const schemaWithFunc = {
+                ...schema,
+                functions: {
+                    calculateDiscount: {
+                        returnType: 'number',
+                        params: [{ name: 'price', type: 'number' }],
+                    },
+                },
+            };
+            const result = await pipeline.validate('#calculateDiscount(100)', schemaWithFunc);
+            // The context check recognizes #calculateDiscount, which is in functions
+            expect(result.stages.context.passed).toBe(true);
+        });
+        it('should pass all four stages simultaneously', async () => {
+            const result = await pipeline.validate("#order.amount > 100 and #order.status == 'active'", schema);
+            expect(result.stages.parse.passed).toBe(true);
+            expect(result.stages.type.passed).toBe(true);
+            expect(result.stages.semantic.passed).toBe(true);
+            expect(result.stages.context.passed).toBe(true);
+            expect(result.valid).toBe(true);
+            expect(result.errors).toHaveLength(0);
+            expect(result.warnings).toHaveLength(0);
+        });
+        it('should collect multiple warnings from different stages', async () => {
+            const result = await pipeline.validate("'hello' > 100 and #order.paid == #order.paid", schema);
+            // Type stage: string-number comparison
+            expect(result.stages.type.warnings.some(w => w.code === 'TYPE-STR_NUM_CMP')).toBe(true);
+            // Semantic stage: self-comparison
+            expect(result.stages.semantic.warnings.some(w => w.code === 'SEM-SELF_COMPARE')).toBe(true);
+            // Total warnings should be at least 2
+            expect(result.warnings.length).toBeGreaterThanOrEqual(2);
+        });
+        it('should handle evaluator that throws an error during parse', async () => {
+            class ThrowingEvaluator {
+                async parse(_expression) {
+                    throw new Error('Parser engine failure');
+                }
+                getContextSchema() {
+                    return null;
+                }
+            }
+            const evaluator = new ThrowingEvaluator();
+            const pipeline = new ValidationPipeline(evaluator);
+            const result = await pipeline.validate('#anything', createSchema());
+            expect(result.stages.parse.passed).toBe(false);
+            expect(result.stages.parse.errors.length).toBeGreaterThan(0);
+            expect(result.errors.some(e => e.code === 'PARSE-EXCEPTION')).toBe(true);
+            expect(result.errors.some(e => e.message.includes('Parser engine failure'))).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=validation-pipeline.test.js.map

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

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

package/dist/context/context-extractor.d.ts

@@ -0,0 +1,82 @@
+import type { ContextSchema } from '../SpelEvaluator.js';
+/**
+ * ContextExtractor — builds a ContextSchema from plain data structures.
+ *
+ * Decoupled from any concrete SpEL implementation, accepts only:
+ *   - rootObject: any object (for extracting property types)
+ *   - variables: Record<string, { type: string; value?: unknown }>
+ *   - beans: string[]
+ *   - types: string[]
+ */
+export declare class ContextExtractor {
+    /**
+     * Extract ContextSchema from plain data structures (no spel-ts dependency)
+     */
+    extract(context: {
+        rootObject?: unknown;
+        rootName?: string;
+        variables?: Record<string, {
+            type: string;
+            value?: unknown;
+            description?: string;
+            nullable?: boolean;
+        }>;
+        beans?: Array<{
+            name: string;
+            type: string;
+            description?: string;
+            singleton?: boolean;
+        }>;
+        types?: Array<{
+            name: string;
+            className?: string;
+            description?: string;
+        }>;
+        functions?: Array<{
+            name: string;
+            returnType: string;
+            params: Array<{
+                name: string;
+                type: string;
+            }>;
+            description?: string;
+        }>;
+    }): ContextSchema;
+    /**
+     * Extract root object schema
+     */
+    private extractRoot;
+    /**
+     * Extract object fields
+     */
+    private extractFields;
+    /**
+     * Infer SpEL type
+     */
+    private inferSpelType;
+    /**
+     * Generate field description
+     */
+    private generateDescription;
+    /**
+     * Safely get example value
+     */
+    private safeExample;
+    /**
+     * Extract variables
+     */
+    private extractVariables;
+    /**
+     * Extract beans
+     */
+    private extractBeans;
+    /**
+     * Extract types
+     */
+    private extractTypes;
+    /**
+     * Extract functions
+     */
+    private extractFunctions;
+}
+//# sourceMappingURL=context-extractor.d.ts.map

package/dist/context/context-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-extractor.d.ts","sourceRoot":"","sources":["../../src/context/context-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE;QACtB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAChB,MAAM,EACN;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAC5E,CAAC;QACF,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACzF,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1E,SAAS,CAAC,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,EAAE,MAAM,CAAC;YACnB,MAAM,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC,CAAC;KACJ,GAAG,aAAa;IAYjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAoBzB"}

package/dist/context/context-extractor.js

@@ -0,0 +1,166 @@
+/**
+ * ContextExtractor — builds a ContextSchema from plain data structures.
+ *
+ * Decoupled from any concrete SpEL implementation, accepts only:
+ *   - rootObject: any object (for extracting property types)
+ *   - variables: Record<string, { type: string; value?: unknown }>
+ *   - beans: string[]
+ *   - types: string[]
+ */
+export class ContextExtractor {
+    /**
+     * Extract ContextSchema from plain data structures (no spel-ts dependency)
+     */
+    extract(context) {
+        const schema = {
+            root: this.extractRoot(context),
+            variables: this.extractVariables(context),
+            beans: this.extractBeans(context),
+            types: this.extractTypes(context),
+            functions: this.extractFunctions(context),
+        };
+        return schema;
+    }
+    /**
+     * Extract root object schema
+     */
+    extractRoot(context) {
+        const { rootObject, rootName } = context;
+        if (rootObject === null || rootObject === undefined)
+            return null;
+        const name = rootName ?? 'root';
+        const type = typeof rootObject === 'object'
+            ? (rootObject?.constructor?.name ?? 'Object')
+            : typeof rootObject;
+        const fields = this.extractFields(rootObject);
+        return { name, type, fields, methods: {} };
+    }
+    /**
+     * Extract object fields
+     */
+    extractFields(obj) {
+        if (obj === null || obj === undefined || typeof obj !== 'object') {
+            return {};
+        }
+        const fields = {};
+        for (const key of Object.keys(obj)) {
+            try {
+                const value = obj[key];
+                const fieldType = this.inferSpelType(value);
+                fields[key] = {
+                    type: fieldType,
+                    description: this.generateDescription(key, fieldType),
+                    isCollection: Array.isArray(value),
+                    elementType: Array.isArray(value) && value.length > 0 ? typeof value[0] : undefined,
+                    nullable: value === null,
+                    example: this.safeExample(value),
+                };
+            }
+            catch {
+                // Skip inaccessible properties
+            }
+        }
+        return fields;
+    }
+    /**
+     * Infer SpEL type
+     */
+    inferSpelType(value) {
+        if (value === null || value === undefined)
+            return 'string';
+        if (typeof value === 'string')
+            return 'string';
+        if (typeof value === 'number')
+            return 'number';
+        if (typeof value === 'boolean')
+            return 'boolean';
+        if (value instanceof Date)
+            return 'date';
+        if (Array.isArray(value))
+            return 'array';
+        if (typeof value === 'object')
+            return 'object';
+        return 'string';
+    }
+    /**
+     * Generate field description
+     */
+    generateDescription(key, type) {
+        return `Field '${key}' of type ${type}`;
+    }
+    /**
+     * Safely get example value
+     */
+    safeExample(value) {
+        if (value === null)
+            return null;
+        if (typeof value === 'object')
+            return undefined;
+        return value;
+    }
+    /**
+     * Extract variables
+     */
+    extractVariables(context) {
+        const variables = {};
+        if (!context.variables)
+            return variables;
+        for (const [name, vdef] of Object.entries(context.variables)) {
+            variables[name] = {
+                type: vdef.type,
+                description: vdef.description ?? `Variable '#${name}'`,
+                nullable: vdef.nullable ?? false,
+                value: vdef.value,
+            };
+        }
+        return variables;
+    }
+    /**
+     * Extract beans
+     */
+    extractBeans(context) {
+        const beans = {};
+        if (!context.beans)
+            return beans;
+        for (const bdef of context.beans) {
+            beans[bdef.name] = {
+                type: bdef.type,
+                description: bdef.description,
+                singleton: bdef.singleton,
+            };
+        }
+        return beans;
+    }
+    /**
+     * Extract types
+     */
+    extractTypes(context) {
+        const types = {};
+        if (!context.types)
+            return types;
+        for (const tdef of context.types) {
+            types[tdef.name] = {
+                className: tdef.className,
+                description: tdef.description,
+            };
+        }
+        return types;
+    }
+    /**
+     * Extract functions
+     */
+    extractFunctions(context) {
+        const functions = {};
+        if (!context.functions)
+            return functions;
+        for (const fdef of context.functions) {
+            functions[fdef.name] = {
+                returnType: fdef.returnType,
+                params: fdef.params,
+                description: fdef.description,
+            };
+        }
+        return functions;
+    }
+}
+//# sourceMappingURL=context-extractor.js.map

package/dist/context/context-extractor.js.map

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

package/dist/context/schema-formatter.d.ts

@@ -0,0 +1,20 @@
+import type { ContextSchema } from '../SpelEvaluator.js';
+/**
+ * SchemaFormatter — formats ContextSchema into readable text.
+ *
+ * Two formats:
+ * 1. formatForLLM(): optimized for LLM prompts (compact, key info first)
+ * 2. formatForHuman(): human-readable format (complete, indent-friendly)
+ */
+export declare class SchemaFormatter {
+    /**
+     * LLM-optimized format — compact, injected into the User part of the prompt
+     */
+    formatForLLM(schema: ContextSchema): string;
+    /**
+     * Human-readable format
+     */
+    formatForHuman(schema: ContextSchema): string;
+    private formatFieldForLLM;
+}
+//# sourceMappingURL=schema-formatter.d.ts.map

package/dist/context/schema-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-formatter.d.ts","sourceRoot":"","sources":["../../src/context/schema-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAEtE;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IA2DlD;;OAEG;IACI,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IA6BpD,OAAO,CAAC,iBAAiB;CAqB1B"}