agentic-qe 1.8.3 → 1.9.0

package/dist/constitution/evaluators/base.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Base Evaluator Interface
+ *
+ * Defines the contract for all clause evaluators in the constitution framework.
+ * Evaluators analyze code/data against constitution rules and return evaluation results.
+ *
+ * @module constitution/evaluators/base
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluatorFactory = exports.BaseEvaluator = void 0;
+/**
+ * Abstract base class for evaluators
+ */
+class BaseEvaluator {
+    async initialize(config) {
+        this.config = config;
+    }
+    async dispose() {
+        // Base implementation does nothing
+    }
+    /**
+     * Helper to compare values using operator
+     * @param actual - Actual value
+     * @param operator - Comparison operator
+     * @param expected - Expected value
+     * @returns True if comparison passes
+     */
+    compareValues(actual, operator, expected) {
+        switch (operator) {
+            case 'equals':
+                return actual === expected;
+            case 'not_equals':
+                return actual !== expected;
+            case 'greater_than':
+                return typeof actual === 'number' && typeof expected === 'number'
+                    ? actual > expected
+                    : false;
+            case 'less_than':
+                return typeof actual === 'number' && typeof expected === 'number'
+                    ? actual < expected
+                    : false;
+            case 'greater_than_or_equal':
+                return typeof actual === 'number' && typeof expected === 'number'
+                    ? actual >= expected
+                    : false;
+            case 'less_than_or_equal':
+                return typeof actual === 'number' && typeof expected === 'number'
+                    ? actual <= expected
+                    : false;
+            case 'contains':
+                return typeof actual === 'string' && typeof expected === 'string'
+                    ? actual.includes(expected)
+                    : Array.isArray(actual)
+                        ? actual.includes(expected)
+                        : false;
+            case 'not_contains':
+                return typeof actual === 'string' && typeof expected === 'string'
+                    ? !actual.includes(expected)
+                    : Array.isArray(actual)
+                        ? !actual.includes(expected)
+                        : true;
+            case 'matches':
+                if (typeof actual === 'string' && typeof expected === 'string') {
+                    try {
+                        const regex = new RegExp(expected);
+                        return regex.test(actual);
+                    }
+                    catch {
+                        return false;
+                    }
+                }
+                return false;
+            case 'in':
+                return Array.isArray(expected)
+                    ? expected.includes(actual)
+                    : false;
+            case 'not_in':
+                return Array.isArray(expected)
+                    ? !expected.includes(actual)
+                    : true;
+            case 'exists':
+                return actual !== null && actual !== undefined;
+            case 'not_exists':
+                return actual === null || actual === undefined;
+            default:
+                return false;
+        }
+    }
+    /**
+     * Create a check result
+     * @param passed - Whether check passed
+     * @param field - Field checked
+     * @param actual - Actual value
+     * @param expected - Expected value
+     * @param operator - Operator used
+     * @param message - Optional message
+     * @returns Check result
+     */
+    createResult(passed, field, actual, expected, operator, message) {
+        return {
+            passed,
+            actualValue: actual,
+            expectedValue: expected,
+            operator,
+            field,
+            message,
+        };
+    }
+}
+exports.BaseEvaluator = BaseEvaluator;
+/**
+ * Factory for creating evaluators
+ */
+class EvaluatorFactory {
+    /**
+     * Register an evaluator type
+     * @param type - Check type
+     * @param factory - Factory function to create evaluator
+     */
+    static register(type, factory) {
+        this.evaluators.set(type, factory);
+    }
+    /**
+     * Create an evaluator for the given type
+     * @param type - Check type
+     * @returns Evaluator instance or null if not found
+     */
+    static create(type) {
+        const factory = this.evaluators.get(type);
+        return factory ? factory() : null;
+    }
+    /**
+     * Get all registered evaluator types
+     * @returns Array of check types
+     */
+    static getTypes() {
+        return Array.from(this.evaluators.keys());
+    }
+}
+exports.EvaluatorFactory = EvaluatorFactory;
+EvaluatorFactory.evaluators = new Map();
+//# sourceMappingURL=base.js.map

package/dist/constitution/evaluators/base.js.map

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

package/dist/constitution/evaluators/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Constitution Evaluators
+ *
+ * Exports all evaluator types and factory for creating evaluators.
+ * Provides a unified interface for evaluating constitution rules.
+ *
+ * @module constitution/evaluators
+ * @version 1.0.0
+ */
+export * from './base';
+export { ASTEvaluator } from './ast-evaluator';
+export { MetricEvaluator } from './metric-evaluator';
+export { PatternEvaluator, CustomPatternEvaluator } from './pattern-evaluator';
+export { SemanticEvaluator } from './semantic-evaluator';
+/**
+ * Register all built-in evaluators
+ */
+export declare function registerBuiltInEvaluators(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/constitution/evaluators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/constitution/evaluators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAQzD;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAKhD"}

package/dist/constitution/evaluators/index.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Constitution Evaluators
+ *
+ * Exports all evaluator types and factory for creating evaluators.
+ * Provides a unified interface for evaluating constitution rules.
+ *
+ * @module constitution/evaluators
+ * @version 1.0.0
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticEvaluator = exports.CustomPatternEvaluator = exports.PatternEvaluator = exports.MetricEvaluator = exports.ASTEvaluator = void 0;
+exports.registerBuiltInEvaluators = registerBuiltInEvaluators;
+__exportStar(require("./base"), exports);
+var ast_evaluator_1 = require("./ast-evaluator");
+Object.defineProperty(exports, "ASTEvaluator", { enumerable: true, get: function () { return ast_evaluator_1.ASTEvaluator; } });
+var metric_evaluator_1 = require("./metric-evaluator");
+Object.defineProperty(exports, "MetricEvaluator", { enumerable: true, get: function () { return metric_evaluator_1.MetricEvaluator; } });
+var pattern_evaluator_1 = require("./pattern-evaluator");
+Object.defineProperty(exports, "PatternEvaluator", { enumerable: true, get: function () { return pattern_evaluator_1.PatternEvaluator; } });
+Object.defineProperty(exports, "CustomPatternEvaluator", { enumerable: true, get: function () { return pattern_evaluator_1.CustomPatternEvaluator; } });
+var semantic_evaluator_1 = require("./semantic-evaluator");
+Object.defineProperty(exports, "SemanticEvaluator", { enumerable: true, get: function () { return semantic_evaluator_1.SemanticEvaluator; } });
+const base_1 = require("./base");
+const ast_evaluator_2 = require("./ast-evaluator");
+const metric_evaluator_2 = require("./metric-evaluator");
+const pattern_evaluator_2 = require("./pattern-evaluator");
+const semantic_evaluator_2 = require("./semantic-evaluator");
+/**
+ * Register all built-in evaluators
+ */
+function registerBuiltInEvaluators() {
+    base_1.EvaluatorFactory.register('ast', () => new ast_evaluator_2.ASTEvaluator());
+    base_1.EvaluatorFactory.register('metric', () => new metric_evaluator_2.MetricEvaluator());
+    base_1.EvaluatorFactory.register('pattern', () => new pattern_evaluator_2.PatternEvaluator());
+    base_1.EvaluatorFactory.register('semantic', () => new semantic_evaluator_2.SemanticEvaluator());
+}
+/**
+ * Initialize evaluator factory with all built-in evaluators
+ */
+registerBuiltInEvaluators();
+//# sourceMappingURL=index.js.map

package/dist/constitution/evaluators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constitution/evaluators/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;AAiBH,8DAKC;AApBD,yCAAuB;AACvB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,yDAA+E;AAAtE,qHAAA,gBAAgB,OAAA;AAAE,2HAAA,sBAAsB,OAAA;AACjD,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAE1B,iCAA0C;AAC1C,mDAA+C;AAC/C,yDAAqD;AACrD,2DAAuD;AACvD,6DAAyD;AAEzD;;GAEG;AACH,SAAgB,yBAAyB;IACvC,uBAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,4BAAY,EAAE,CAAC,CAAC;IAC3D,uBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,kCAAe,EAAE,CAAC,CAAC;IACjE,uBAAgB,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,oCAAgB,EAAE,CAAC,CAAC;IACnE,uBAAgB,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,sCAAiB,EAAE,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,yBAAyB,EAAE,CAAC"}

package/dist/constitution/evaluators/metric-evaluator.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Metric Evaluator
+ *
+ * Calculates and evaluates quantitative quality metrics.
+ * Supports metrics like test coverage, maintainability index, technical debt ratio.
+ * Can work with pre-calculated metrics or compute them on demand.
+ *
+ * @module constitution/evaluators/metric-evaluator
+ * @version 1.0.0
+ */
+import type { RuleCondition } from '../schema';
+import { BaseEvaluator, type CheckResult, type EvaluationContext } from './base';
+/**
+ * Metric Evaluator for quantitative quality metrics
+ */
+export declare class MetricEvaluator extends BaseEvaluator {
+    readonly type: "metric";
+    canHandle(condition: RuleCondition): boolean;
+    evaluate(condition: RuleCondition, context: EvaluationContext): Promise<CheckResult>;
+    /**
+     * Get metrics from context or calculate them
+     * @param context - Evaluation context
+     * @returns Quality metrics
+     */
+    private getMetrics;
+    /**
+     * Convert context metrics to quality metrics
+     * @param metrics - Context metrics
+     * @returns Quality metrics
+     */
+    private convertMetrics;
+    /**
+     * Calculate metrics from source code
+     * @param sourceCode - Source code to analyze
+     * @param data - Additional context data
+     * @returns Calculated metrics
+     */
+    private calculateMetrics;
+    /**
+     * Estimate cyclomatic complexity (simple heuristic)
+     * @param code - Source code
+     * @returns Estimated complexity
+     */
+    private estimateComplexity;
+    /**
+     * Estimate code duplication (simple heuristic)
+     * @param code - Source code
+     * @returns Estimated duplication percentage
+     */
+    private estimateDuplication;
+    /**
+     * Get metric value by field name
+     * @param field - Field name
+     * @param metrics - Calculated metrics
+     * @returns Metric value
+     */
+    private getMetricValue;
+}
+//# sourceMappingURL=metric-evaluator.d.ts.map

package/dist/constitution/evaluators/metric-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-evaluator.d.ts","sourceRoot":"","sources":["../../../src/constitution/evaluators/metric-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAwDjF;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAChD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,SAAS,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO;IAItC,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IA0C1F;;;;OAIG;YACW,UAAU;IAexB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAmBtB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAkCvB"}

package/dist/constitution/evaluators/metric-evaluator.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Metric Evaluator
+ *
+ * Calculates and evaluates quantitative quality metrics.
+ * Supports metrics like test coverage, maintainability index, technical debt ratio.
+ * Can work with pre-calculated metrics or compute them on demand.
+ *
+ * @module constitution/evaluators/metric-evaluator
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricEvaluator = void 0;
+const base_1 = require("./base");
+/**
+ * Fields that metric evaluator can check
+ */
+const METRIC_FIELDS = new Set([
+    'quality_score',
+    'coverage',
+    'maintainability_index',
+    'technical_debt_ratio',
+    'security_score',
+    'doc_coverage',
+    'duplication_percentage',
+    'automation_percentage',
+    'defect_detection_rate',
+    'mean_time_to_detection',
+    'result_variance',
+    'execution_time',
+    'vulnerability_count',
+    'code_smell_count',
+]);
+/**
+ * Metric Evaluator for quantitative quality metrics
+ */
+class MetricEvaluator extends base_1.BaseEvaluator {
+    constructor() {
+        super(...arguments);
+        this.type = 'metric';
+    }
+    canHandle(condition) {
+        return METRIC_FIELDS.has(condition.field);
+    }
+    async evaluate(condition, context) {
+        try {
+            // Get metrics from context or calculate them
+            const metrics = await this.getMetrics(context);
+            // Get the requested metric value
+            const actualValue = this.getMetricValue(condition.field, metrics);
+            // Handle missing metrics
+            if (actualValue === undefined || actualValue === null) {
+                return this.createResult(false, condition.field, null, condition.value, condition.operator, `Metric '${condition.field}' not available in context`);
+            }
+            // Compare against expected value
+            const passed = this.compareValues(actualValue, condition.operator, condition.value);
+            return this.createResult(passed, condition.field, actualValue, condition.value, condition.operator);
+        }
+        catch (error) {
+            return this.createResult(false, condition.field, null, condition.value, condition.operator, `Metric evaluation failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get metrics from context or calculate them
+     * @param context - Evaluation context
+     * @returns Quality metrics
+     */
+    async getMetrics(context) {
+        // If metrics are pre-calculated in context, use them
+        if (context.metrics) {
+            return this.convertMetrics(context.metrics);
+        }
+        // Otherwise, calculate metrics from source code
+        if (context.sourceCode) {
+            return this.calculateMetrics(context.sourceCode, context.data || {});
+        }
+        // If neither is available, return empty metrics
+        return {};
+    }
+    /**
+     * Convert context metrics to quality metrics
+     * @param metrics - Context metrics
+     * @returns Quality metrics
+     */
+    convertMetrics(metrics) {
+        return {
+            qualityScore: metrics.quality_score ?? metrics.qualityScore,
+            coverage: metrics.coverage,
+            maintainabilityIndex: metrics.maintainability_index ?? metrics.maintainabilityIndex,
+            technicalDebtRatio: metrics.technical_debt_ratio ?? metrics.technicalDebtRatio,
+            securityScore: metrics.security_score ?? metrics.securityScore,
+            docCoverage: metrics.doc_coverage ?? metrics.docCoverage,
+            duplicationPercentage: metrics.duplication_percentage ?? metrics.duplicationPercentage,
+            automationPercentage: metrics.automation_percentage ?? metrics.automationPercentage,
+            defectDetectionRate: metrics.defect_detection_rate ?? metrics.defectDetectionRate,
+            meanTimeToDetection: metrics.mean_time_to_detection ?? metrics.meanTimeToDetection,
+            resultVariance: metrics.result_variance ?? metrics.resultVariance,
+            executionTime: metrics.execution_time ?? metrics.executionTime,
+            vulnerabilityCount: metrics.vulnerability_count ?? metrics.vulnerabilityCount,
+            codeSmellCount: metrics.code_smell_count ?? metrics.codeSmellCount,
+        };
+    }
+    /**
+     * Calculate metrics from source code
+     * @param sourceCode - Source code to analyze
+     * @param data - Additional context data
+     * @returns Calculated metrics
+     */
+    calculateMetrics(sourceCode, data) {
+        const metrics = {};
+        // Calculate maintainability index
+        // Formula: MI = 171 - 5.2 * ln(HV) - 0.23 * CC - 16.2 * ln(LOC)
+        // Where: HV = Halstead Volume, CC = Cyclomatic Complexity, LOC = Lines of Code
+        const lines = sourceCode.split('\n').length;
+        const estimatedComplexity = this.estimateComplexity(sourceCode);
+        // Simplified maintainability index calculation
+        metrics.maintainabilityIndex = Math.max(0, Math.min(100, 171 - 5.2 * Math.log(lines * 10) - 0.23 * estimatedComplexity - 16.2 * Math.log(lines)));
+        // Calculate documentation coverage (simple heuristic: comment ratio)
+        const commentLines = (sourceCode.match(/\/\/.+|\/\*[\s\S]*?\*\//g) || []).length;
+        metrics.docCoverage = Math.min(100, (commentLines / lines) * 300); // 1 comment per 3 lines = 100%
+        // Calculate duplication (simple heuristic: repeated lines)
+        metrics.duplicationPercentage = this.estimateDuplication(sourceCode);
+        // Use data from context if available
+        if (data.coverage !== undefined)
+            metrics.coverage = Number(data.coverage);
+        if (data.securityScore !== undefined)
+            metrics.securityScore = Number(data.securityScore);
+        if (data.vulnerabilityCount !== undefined)
+            metrics.vulnerabilityCount = Number(data.vulnerabilityCount);
+        return metrics;
+    }
+    /**
+     * Estimate cyclomatic complexity (simple heuristic)
+     * @param code - Source code
+     * @returns Estimated complexity
+     */
+    estimateComplexity(code) {
+        const controlFlowKeywords = /\b(if|else|switch|case|for|while|do|catch|&&|\|\||\?)\b/g;
+        const matches = code.match(controlFlowKeywords);
+        return (matches?.length || 0) + 1;
+    }
+    /**
+     * Estimate code duplication (simple heuristic)
+     * @param code - Source code
+     * @returns Estimated duplication percentage
+     */
+    estimateDuplication(code) {
+        const lines = code.split('\n').filter(line => line.trim().length > 0);
+        const uniqueLines = new Set(lines);
+        const duplicatedLines = lines.length - uniqueLines.size;
+        return lines.length > 0 ? (duplicatedLines / lines.length) * 100 : 0;
+    }
+    /**
+     * Get metric value by field name
+     * @param field - Field name
+     * @param metrics - Calculated metrics
+     * @returns Metric value
+     */
+    getMetricValue(field, metrics) {
+        switch (field) {
+            case 'quality_score':
+                return metrics.qualityScore;
+            case 'coverage':
+                return metrics.coverage;
+            case 'maintainability_index':
+                return metrics.maintainabilityIndex;
+            case 'technical_debt_ratio':
+                return metrics.technicalDebtRatio;
+            case 'security_score':
+                return metrics.securityScore;
+            case 'doc_coverage':
+                return metrics.docCoverage;
+            case 'duplication_percentage':
+                return metrics.duplicationPercentage;
+            case 'automation_percentage':
+                return metrics.automationPercentage;
+            case 'defect_detection_rate':
+                return metrics.defectDetectionRate;
+            case 'mean_time_to_detection':
+                return metrics.meanTimeToDetection;
+            case 'result_variance':
+                return metrics.resultVariance;
+            case 'execution_time':
+                return metrics.executionTime;
+            case 'vulnerability_count':
+                return metrics.vulnerabilityCount;
+            case 'code_smell_count':
+                return metrics.codeSmellCount;
+            default:
+                return undefined;
+        }
+    }
+}
+exports.MetricEvaluator = MetricEvaluator;
+//# sourceMappingURL=metric-evaluator.js.map

package/dist/constitution/evaluators/metric-evaluator.js.map

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

package/dist/constitution/evaluators/pattern-evaluator.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Pattern Evaluator
+ *
+ * Uses regex patterns to detect code issues like:
+ * - Hardcoded secrets (API keys, passwords, tokens)
+ * - SQL injection vulnerabilities
+ * - XSS vulnerabilities
+ * - Other security and quality patterns
+ *
+ * @module constitution/evaluators/pattern-evaluator
+ * @version 1.0.0
+ */
+import type { RuleCondition } from '../schema';
+import { BaseEvaluator, type CheckResult, type EvaluationContext } from './base';
+/**
+ * Pattern Evaluator for regex-based code analysis
+ */
+export declare class PatternEvaluator extends BaseEvaluator {
+    readonly type: "pattern";
+    canHandle(condition: RuleCondition): boolean;
+    evaluate(condition: RuleCondition, context: EvaluationContext): Promise<CheckResult>;
+    /**
+     * Detect patterns in source code
+     * @param field - Field to check
+     * @param sourceCode - Source code to analyze
+     * @returns Array of pattern matches
+     */
+    private detectPatterns;
+    /**
+     * Get patterns for a specific field
+     * @param field - Field name
+     * @returns Array of regex patterns
+     */
+    private getPatternsForField;
+    /**
+     * Get actual value based on field type
+     * @param field - Field name
+     * @param matches - Pattern matches
+     * @returns Actual value for comparison
+     */
+    private getActualValue;
+    /**
+     * Get context lines around a match
+     * @param lines - All source lines
+     * @param lineIndex - Index of matched line
+     * @param contextLines - Number of context lines
+     * @returns Context string
+     */
+    private getContext;
+}
+/**
+ * Custom pattern evaluator for user-defined patterns
+ */
+export declare class CustomPatternEvaluator extends BaseEvaluator {
+    readonly type: "pattern";
+    private customPatterns;
+    /**
+     * Register a custom pattern
+     * @param field - Field name
+     * @param patterns - Regex patterns
+     */
+    registerPattern(field: string, patterns: RegExp[]): void;
+    canHandle(condition: RuleCondition): boolean;
+    evaluate(condition: RuleCondition, context: EvaluationContext): Promise<CheckResult>;
+}
+//# sourceMappingURL=pattern-evaluator.d.ts.map

package/dist/constitution/evaluators/pattern-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-evaluator.d.ts","sourceRoot":"","sources":["../../../src/constitution/evaluators/pattern-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AA0EjF;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IAEnC,SAAS,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO;IAItC,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAmD1F;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAwBtB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;CAKnB;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,OAAO,CAAC,cAAc,CAA+B;IAErD;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxD,SAAS,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO;IAItC,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;CAmC3F"}