@trentapps/manager-protocol 1.1.2 → 1.2.0

package/dist/testing/rule-tester.js

@@ -0,0 +1,381 @@
+/**
+ * Enterprise Agent Supervisor - Rule Testing Framework
+ *
+ * Provides utilities for testing individual business rules and verifying their behavior.
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { RulesEngine } from '../engine/RulesEngine.js';
+// ============================================================================
+// RULE TESTER CLASS
+// ============================================================================
+/**
+ * RuleTester class for testing individual business rules
+ */
+export class RuleTester {
+    engine;
+    verbose;
+    constructor(options = {}) {
+        this.engine = new RulesEngine();
+        this.verbose = options.verbose ?? false;
+    }
+    /**
+     * Test a single rule against multiple test cases
+     */
+    testRule(rule, testCases) {
+        const startTime = Date.now();
+        const testCaseResults = [];
+        let passedTests = 0;
+        let failedTests = 0;
+        let skippedTests = 0;
+        // Register only this rule
+        this.engine = new RulesEngine();
+        this.engine.registerRule(rule);
+        // Check if any test has 'only' flag
+        const hasOnlyTests = testCases.some(tc => tc.only);
+        for (const testCase of testCases) {
+            // Skip tests not in the run list (when 'only' is used)
+            if (hasOnlyTests && !testCase.only) {
+                skippedTests++;
+                testCaseResults.push({
+                    testCaseId: testCase.id || uuidv4(),
+                    description: testCase.description,
+                    passed: false,
+                    skipped: true,
+                    failures: [],
+                    durationMs: 0
+                });
+                continue;
+            }
+            if (testCase.skip) {
+                skippedTests++;
+                testCaseResults.push({
+                    testCaseId: testCase.id || uuidv4(),
+                    description: testCase.description,
+                    passed: false,
+                    skipped: true,
+                    failures: [],
+                    durationMs: 0
+                });
+                continue;
+            }
+            const result = this.runTestCase(rule, testCase);
+            testCaseResults.push(result);
+            if (result.passed) {
+                passedTests++;
+            }
+            else {
+                failedTests++;
+                if (this.verbose) {
+                    this.logFailure(rule, testCase, result);
+                }
+            }
+        }
+        return {
+            ruleId: rule.id,
+            ruleName: rule.name,
+            totalTests: testCases.length,
+            passedTests,
+            failedTests,
+            skippedTests,
+            testCaseResults,
+            totalDurationMs: Date.now() - startTime
+        };
+    }
+    /**
+     * Run a single test case
+     */
+    runTestCase(rule, testCase) {
+        const startTime = Date.now();
+        const testCaseId = testCase.id || uuidv4();
+        const failures = [];
+        // Build full action
+        const action = {
+            id: uuidv4(),
+            ...testCase.input.action
+        };
+        // Build context
+        const context = testCase.input.context
+            ? { ...testCase.input.context }
+            : undefined;
+        // Evaluate
+        const result = this.engine.evaluateAction(action, context);
+        // Check if rule matched
+        const ruleMatched = result.appliedRules.includes(rule.id);
+        // Assertion: shouldMatch
+        if (testCase.expectedResult.shouldMatch !== ruleMatched) {
+            failures.push({
+                assertion: 'shouldMatch',
+                expected: testCase.expectedResult.shouldMatch,
+                actual: ruleMatched,
+                message: testCase.expectedResult.shouldMatch
+                    ? `Expected rule '${rule.name}' to match, but it did not`
+                    : `Expected rule '${rule.name}' NOT to match, but it did`
+            });
+        }
+        // Only check other assertions if shouldMatch is correct
+        if (testCase.expectedResult.shouldMatch && ruleMatched) {
+            // Check status
+            if (testCase.expectedResult.status !== undefined) {
+                if (result.status !== testCase.expectedResult.status) {
+                    failures.push({
+                        assertion: 'status',
+                        expected: testCase.expectedResult.status,
+                        actual: result.status,
+                        message: `Expected status '${testCase.expectedResult.status}', got '${result.status}'`
+                    });
+                }
+            }
+            // Check allowed
+            if (testCase.expectedResult.allowed !== undefined) {
+                if (result.allowed !== testCase.expectedResult.allowed) {
+                    failures.push({
+                        assertion: 'allowed',
+                        expected: testCase.expectedResult.allowed,
+                        actual: result.allowed,
+                        message: `Expected allowed=${testCase.expectedResult.allowed}, got ${result.allowed}`
+                    });
+                }
+            }
+            // Check risk level
+            if (testCase.expectedResult.riskLevel !== undefined) {
+                if (result.riskLevel !== testCase.expectedResult.riskLevel) {
+                    failures.push({
+                        assertion: 'riskLevel',
+                        expected: testCase.expectedResult.riskLevel,
+                        actual: result.riskLevel,
+                        message: `Expected risk level '${testCase.expectedResult.riskLevel}', got '${result.riskLevel}'`
+                    });
+                }
+            }
+            // Check risk score range
+            if (testCase.expectedResult.minRiskScore !== undefined) {
+                if (result.riskScore < testCase.expectedResult.minRiskScore) {
+                    failures.push({
+                        assertion: 'minRiskScore',
+                        expected: `>= ${testCase.expectedResult.minRiskScore}`,
+                        actual: result.riskScore,
+                        message: `Expected risk score >= ${testCase.expectedResult.minRiskScore}, got ${result.riskScore}`
+                    });
+                }
+            }
+            if (testCase.expectedResult.maxRiskScore !== undefined) {
+                if (result.riskScore > testCase.expectedResult.maxRiskScore) {
+                    failures.push({
+                        assertion: 'maxRiskScore',
+                        expected: `<= ${testCase.expectedResult.maxRiskScore}`,
+                        actual: result.riskScore,
+                        message: `Expected risk score <= ${testCase.expectedResult.maxRiskScore}, got ${result.riskScore}`
+                    });
+                }
+            }
+            // Check human approval
+            if (testCase.expectedResult.requiresHumanApproval !== undefined) {
+                if (result.requiresHumanApproval !== testCase.expectedResult.requiresHumanApproval) {
+                    failures.push({
+                        assertion: 'requiresHumanApproval',
+                        expected: testCase.expectedResult.requiresHumanApproval,
+                        actual: result.requiresHumanApproval,
+                        message: `Expected requiresHumanApproval=${testCase.expectedResult.requiresHumanApproval}, got ${result.requiresHumanApproval}`
+                    });
+                }
+            }
+            // Check violation count
+            if (testCase.expectedResult.violationCount !== undefined) {
+                if (result.violations.length !== testCase.expectedResult.violationCount) {
+                    failures.push({
+                        assertion: 'violationCount',
+                        expected: testCase.expectedResult.violationCount,
+                        actual: result.violations.length,
+                        message: `Expected ${testCase.expectedResult.violationCount} violations, got ${result.violations.length}`
+                    });
+                }
+            }
+            // Check warning count
+            if (testCase.expectedResult.warningCount !== undefined) {
+                if (result.warnings.length !== testCase.expectedResult.warningCount) {
+                    failures.push({
+                        assertion: 'warningCount',
+                        expected: testCase.expectedResult.warningCount,
+                        actual: result.warnings.length,
+                        message: `Expected ${testCase.expectedResult.warningCount} warnings, got ${result.warnings.length}`
+                    });
+                }
+            }
+            // Check violation messages
+            if (testCase.expectedResult.violationMessages) {
+                for (const expectedMsg of testCase.expectedResult.violationMessages) {
+                    const found = result.violations.some(v => v.message.includes(expectedMsg));
+                    if (!found) {
+                        failures.push({
+                            assertion: 'violationMessage',
+                            expected: expectedMsg,
+                            actual: result.violations.map(v => v.message),
+                            message: `Expected violation message containing '${expectedMsg}' not found`
+                        });
+                    }
+                }
+            }
+            // Check warning messages
+            if (testCase.expectedResult.warningMessages) {
+                for (const expectedMsg of testCase.expectedResult.warningMessages) {
+                    const found = result.warnings.some(w => w.includes(expectedMsg));
+                    if (!found) {
+                        failures.push({
+                            assertion: 'warningMessage',
+                            expected: expectedMsg,
+                            actual: result.warnings,
+                            message: `Expected warning message containing '${expectedMsg}' not found`
+                        });
+                    }
+                }
+            }
+        }
+        return {
+            testCaseId,
+            description: testCase.description,
+            passed: failures.length === 0,
+            skipped: false,
+            actualResult: result,
+            failures,
+            durationMs: Date.now() - startTime
+        };
+    }
+    /**
+     * Log a test failure in verbose mode
+     */
+    logFailure(rule, testCase, result) {
+        console.log(`\n[FAIL] Rule: ${rule.name}`);
+        console.log(`       Test: ${testCase.description}`);
+        for (const failure of result.failures) {
+            console.log(`       - ${failure.message}`);
+            console.log(`         Expected: ${JSON.stringify(failure.expected)}`);
+            console.log(`         Actual:   ${JSON.stringify(failure.actual)}`);
+        }
+    }
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Test a single rule against multiple test cases (convenience function)
+ */
+export function testRule(rule, testCases) {
+    const tester = new RuleTester();
+    return tester.testRule(rule, testCases);
+}
+/**
+ * Create a test case with defaults
+ */
+export function createTestCase(description, action, expectedResult, context) {
+    return {
+        description,
+        input: { action, context },
+        expectedResult
+    };
+}
+/**
+ * Create a test case that expects the rule to match and deny
+ */
+export function expectDeny(description, action, options) {
+    return createTestCase(description, action, {
+        shouldMatch: true,
+        status: 'denied',
+        allowed: false,
+        violationCount: 1,
+        ...options
+    }, options?.context);
+}
+/**
+ * Create a test case that expects the rule to match and require approval
+ */
+export function expectApproval(description, action, options) {
+    return createTestCase(description, action, {
+        shouldMatch: true,
+        status: 'pending_approval',
+        allowed: true,
+        requiresHumanApproval: true,
+        ...options
+    }, options?.context);
+}
+/**
+ * Create a test case that expects the rule to match and warn
+ */
+export function expectWarn(description, action, options) {
+    return createTestCase(description, action, {
+        shouldMatch: true,
+        status: 'requires_review',
+        allowed: true,
+        warningCount: 1,
+        ...options
+    }, options?.context);
+}
+/**
+ * Create a test case that expects the rule NOT to match
+ */
+export function expectNoMatch(description, action, context) {
+    return createTestCase(description, action, { shouldMatch: false }, context);
+}
+/**
+ * Create a test case that expects the rule to match and allow
+ */
+export function expectAllow(description, action, context) {
+    return createTestCase(description, action, {
+        shouldMatch: true,
+        status: 'approved',
+        allowed: true
+    }, context);
+}
+// ============================================================================
+// ASSERTION HELPERS
+// ============================================================================
+/**
+ * Assertion helpers for use with testing frameworks like vitest
+ */
+export const assertions = {
+    /**
+     * Assert that a rule matches the given action
+     */
+    ruleMatches(rule, action, context) {
+        const engine = new RulesEngine();
+        engine.registerRule(rule);
+        const result = engine.evaluateAction(action, context);
+        return result.appliedRules.includes(rule.id);
+    },
+    /**
+     * Assert that a rule denies the given action
+     */
+    ruleDenies(rule, action, context) {
+        const engine = new RulesEngine();
+        engine.registerRule(rule);
+        const result = engine.evaluateAction(action, context);
+        return result.appliedRules.includes(rule.id) && result.status === 'denied';
+    },
+    /**
+     * Assert that a rule requires approval for the given action
+     */
+    ruleRequiresApproval(rule, action, context) {
+        const engine = new RulesEngine();
+        engine.registerRule(rule);
+        const result = engine.evaluateAction(action, context);
+        return result.appliedRules.includes(rule.id) && result.requiresHumanApproval;
+    },
+    /**
+     * Assert that a rule produces a warning for the given action
+     */
+    ruleWarns(rule, action, context) {
+        const engine = new RulesEngine();
+        engine.registerRule(rule);
+        const result = engine.evaluateAction(action, context);
+        return result.appliedRules.includes(rule.id) && result.warnings.length > 0;
+    },
+    /**
+     * Assert that a rule allows the given action
+     */
+    ruleAllows(rule, action, context) {
+        const engine = new RulesEngine();
+        engine.registerRule(rule);
+        const result = engine.evaluateAction(action, context);
+        return result.appliedRules.includes(rule.id) && result.allowed;
+    }
+};
+//# sourceMappingURL=rule-tester.js.map

package/dist/testing/rule-tester.js.map

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

package/dist/testing/rule-validator.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Enterprise Agent Supervisor - Rule Validation Framework
+ *
+ * Provides utilities for validating rule structure, syntax, and detecting conflicts.
+ */
+import type { BusinessRule } from '../types/index.js';
+/**
+ * Result of validating a single rule
+ */
+export interface RuleValidationResult {
+    /** Rule being validated */
+    ruleId: string;
+    /** Whether the rule is valid */
+    isValid: boolean;
+    /** List of validation errors */
+    errors: ValidationError[];
+    /** List of validation warnings */
+    warnings: ValidationWarning[];
+}
+/**
+ * Validation error
+ */
+export interface ValidationError {
+    /** Error code */
+    code: string;
+    /** Error message */
+    message: string;
+    /** Path to the problematic field */
+    path?: string;
+    /** Severity */
+    severity: 'error';
+}
+/**
+ * Validation warning
+ */
+export interface ValidationWarning {
+    /** Warning code */
+    code: string;
+    /** Warning message */
+    message: string;
+    /** Path to the problematic field */
+    path?: string;
+    /** Severity */
+    severity: 'warning';
+}
+/**
+ * Result of checking for rule conflicts
+ */
+export interface ConflictCheckResult {
+    /** Whether conflicts were found */
+    hasConflicts: boolean;
+    /** List of detected conflicts */
+    conflicts: RuleConflict[];
+}
+/**
+ * A conflict between two rules
+ */
+export interface RuleConflict {
+    /** First rule in the conflict */
+    rule1: {
+        id: string;
+        name: string;
+    };
+    /** Second rule in the conflict */
+    rule2: {
+        id: string;
+        name: string;
+    };
+    /** Type of conflict */
+    conflictType: ConflictType;
+    /** Description of the conflict */
+    description: string;
+    /** Suggested resolution */
+    suggestion?: string;
+}
+/**
+ * Types of rule conflicts
+ */
+export type ConflictType = 'contradicting_actions' | 'duplicate_conditions' | 'shadowed_rule' | 'redundant_rule' | 'circular_dependency';
+/**
+ * Result of linting rules
+ */
+export interface LintResult {
+    /** Total issues found */
+    totalIssues: number;
+    /** Critical issues that should be fixed */
+    errors: LintIssue[];
+    /** Non-critical issues that should be reviewed */
+    warnings: LintIssue[];
+    /** Suggestions for improvement */
+    suggestions: LintIssue[];
+}
+/**
+ * A lint issue
+ */
+export interface LintIssue {
+    /** Issue code */
+    code: string;
+    /** Rule ID with the issue */
+    ruleId: string;
+    /** Issue message */
+    message: string;
+    /** Severity */
+    severity: 'error' | 'warning' | 'suggestion';
+    /** How to fix the issue */
+    fix?: string;
+}
+/**
+ * Validate a single business rule
+ */
+export declare function validateRule(rule: unknown): RuleValidationResult;
+/**
+ * Validate an array of conditions
+ */
+export declare function validateConditions(conditions: unknown[]): {
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+};
+/**
+ * Check for conflicts between rules
+ */
+export declare function checkForConflicts(rules: BusinessRule[]): ConflictCheckResult;
+/**
+ * Lint rules for potential issues and best practices
+ */
+export declare function lintRules(rules: BusinessRule[]): LintResult;
+/**
+ * Validate multiple rules at once
+ */
+export declare function validateRules(rules: unknown[]): {
+    valid: RuleValidationResult[];
+    invalid: RuleValidationResult[];
+    summary: {
+        total: number;
+        valid: number;
+        invalid: number;
+        errorCount: number;
+        warningCount: number;
+    };
+};
+//# sourceMappingURL=rule-validator.d.ts.map

package/dist/testing/rule-validator.d.ts.map

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