@oddessentials/odd-ai-reviewers 1.0.0

package/dist/cli/signals.js

@@ -0,0 +1,223 @@
+/**
+ * Signal Handling Module
+ *
+ * Provides graceful shutdown handling for SIGINT (Ctrl+C) and SIGTERM signals.
+ * Ensures partial results are reported when execution is interrupted.
+ *
+ * @module cli/signals
+ */
+// =============================================================================
+// State
+// =============================================================================
+let shutdownState = {
+    triggered: false,
+};
+let registeredCleanup;
+let registeredOptions = {};
+// Track registered handlers for cleanup
+let sigintHandler;
+let sigtermHandler;
+// =============================================================================
+// Core Functions
+// =============================================================================
+/**
+ * Check if shutdown has been triggered
+ *
+ * Use this in long-running loops to check if the user has requested shutdown.
+ *
+ * @returns true if shutdown has been triggered
+ */
+export function isShutdownTriggered() {
+    return shutdownState.triggered;
+}
+/**
+ * Get the current shutdown state
+ *
+ * @returns Current shutdown state object
+ */
+export function getShutdownState() {
+    return { ...shutdownState };
+}
+/**
+ * Reset shutdown state
+ *
+ * Primarily used for testing. Clears the shutdown state and removes handlers.
+ */
+export function resetShutdownState() {
+    shutdownState = { triggered: false };
+    removeSignalHandlers();
+}
+/**
+ * Remove registered signal handlers
+ *
+ * Called during reset or when handlers need to be replaced.
+ */
+function removeSignalHandlers() {
+    if (sigintHandler) {
+        process.removeListener('SIGINT', sigintHandler);
+        sigintHandler = undefined;
+    }
+    if (sigtermHandler) {
+        process.removeListener('SIGTERM', sigtermHandler);
+        sigtermHandler = undefined;
+    }
+    registeredCleanup = undefined;
+    registeredOptions = {};
+}
+/**
+ * Create a signal handler for the given signal type
+ *
+ * @param signal - The signal type
+ * @returns Signal handler function
+ */
+function createSignalHandler(signal) {
+    return async () => {
+        const logger = registeredOptions.logger ?? console;
+        // Prevent multiple shutdown triggers
+        if (shutdownState.triggered) {
+            logger.warn('\nForce quit requested. Exiting immediately.');
+            process.exit(130); // 128 + 2 (SIGINT)
+        }
+        // Mark shutdown as triggered
+        shutdownState = {
+            triggered: true,
+            signal,
+            timestamp: Date.now(),
+        };
+        if (signal === 'SIGINT') {
+            // User pressed Ctrl+C
+            if (registeredOptions.showPartialResultsMessage !== false) {
+                logger.log('\n\nReceived interrupt signal. Shutting down gracefully...');
+            }
+        }
+        else {
+            // SIGTERM - typically from process manager
+            logger.log('\nReceived termination signal. Shutting down...');
+        }
+        // Run cleanup if registered
+        if (registeredCleanup) {
+            try {
+                await registeredCleanup();
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn(`Cleanup error: ${errorMsg}`);
+            }
+        }
+        // Exit with appropriate code if exitOnSignal is true (default)
+        // 128 + signal number: SIGINT = 2, SIGTERM = 15
+        if (registeredOptions.exitOnSignal !== false) {
+            const exitCode = signal === 'SIGINT' ? 130 : 143;
+            process.exit(exitCode);
+        }
+        // When exitOnSignal is false, the main function is responsible for checking
+        // isShutdownTriggered() and handling graceful exit
+    };
+}
+/**
+ * Setup signal handlers for graceful shutdown
+ *
+ * Registers handlers for SIGINT (Ctrl+C) and SIGTERM that:
+ * 1. Set the shutdown state
+ * 2. Call the optional cleanup function
+ * 3. Exit with appropriate code (130 for SIGINT, 143 for SIGTERM)
+ *
+ * On second SIGINT (force quit), exits immediately without cleanup.
+ *
+ * @param options - Signal handler options
+ *
+ * @example
+ * ```typescript
+ * setupSignalHandlers({
+ *   cleanup: async () => {
+ *     // Report partial results
+ *     await reportPartialResults();
+ *   },
+ *   showPartialResultsMessage: true,
+ * });
+ * ```
+ */
+export function setupSignalHandlers(options = {}) {
+    // Remove existing handlers first
+    removeSignalHandlers();
+    // Store options and cleanup function
+    registeredCleanup = options.cleanup;
+    registeredOptions = options;
+    // Reset shutdown state
+    shutdownState = { triggered: false };
+    // Create and register handlers
+    sigintHandler = createSignalHandler('SIGINT');
+    sigtermHandler = createSignalHandler('SIGTERM');
+    process.on('SIGINT', sigintHandler);
+    process.on('SIGTERM', sigtermHandler);
+}
+/**
+ * Legacy function signature for backward compatibility
+ *
+ * @param cleanup - Cleanup function to call during shutdown
+ */
+export function setupSignalHandlersLegacy(cleanup) {
+    setupSignalHandlers({ cleanup });
+}
+let partialResultsContext;
+/**
+ * Set the partial results context for progress tracking
+ *
+ * Call this when starting agent execution to enable accurate
+ * completion percentage in shutdown messages.
+ *
+ * @param context - Partial results tracking context
+ */
+export function setPartialResultsContext(context) {
+    partialResultsContext = context;
+}
+/**
+ * Update the partial results context
+ *
+ * Call this after each agent completes to update progress.
+ *
+ * @param update - Partial update to apply
+ */
+export function updatePartialResultsContext(update) {
+    if (partialResultsContext) {
+        partialResultsContext = { ...partialResultsContext, ...update };
+    }
+}
+/**
+ * Get the current partial results context
+ *
+ * @returns Current context or undefined if not set
+ */
+export function getPartialResultsContext() {
+    return partialResultsContext ? { ...partialResultsContext } : undefined;
+}
+/**
+ * Clear the partial results context
+ *
+ * Call this after execution completes normally.
+ */
+export function clearPartialResultsContext() {
+    partialResultsContext = undefined;
+}
+/**
+ * Format a shutdown message with partial results information
+ *
+ * @param context - Partial results context
+ * @returns Formatted message lines
+ */
+export function formatPartialResultsMessage(context) {
+    const lines = [];
+    const completionPercent = context.totalAgents > 0 ? Math.round((context.completedAgents / context.totalAgents) * 100) : 0;
+    lines.push(`📊 SUMMARY [interrupted at ${completionPercent}%]`);
+    lines.push('');
+    if (context.completedAgentNames.length > 0) {
+        const completedList = context.completedAgentNames.map((name) => `${name} ✓`).join(', ');
+        lines.push(`Agents: ${context.completedAgents}/${context.totalAgents} completed`);
+        lines.push(`  (${completedList}${context.currentAgent ? `, ${context.currentAgent} ✗ interrupted` : ''})`);
+    }
+    else {
+        lines.push(`Agents: 0/${context.totalAgents} completed (interrupted before any completed)`);
+    }
+    return lines;
+}
+//# sourceMappingURL=signals.js.map

package/dist/cli/signals.js.map

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

package/dist/cli/validation-report.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Validation Report Module
+ *
+ * Feature 015: Config Wizard & Validation
+ * Converts PreflightResult to structured ValidationReport with severity categorization.
+ * Provides formatted console output for validation results.
+ *
+ * Exit code semantics (per spec FR-015):
+ * - Exit 1: Errors present (validation failed)
+ * - Exit 0: Warnings only (validation passed with notes)
+ * - Exit 0: Success (validation passed)
+ *
+ * @module validation-report
+ * @see {@link ../../../specs/015-config-wizard-validate/spec.md} Feature specification
+ */
+import type { PreflightResult } from '../phases/preflight.js';
+import type { ResolvedConfigTuple } from '../config/providers.js';
+/**
+ * Structured validation report with severity categorization.
+ *
+ * Categorizes preflight check messages into three severity levels:
+ * - **errors**: Critical issues that prevent execution (exit 1)
+ * - **warnings**: Non-blocking issues that should be reviewed (exit 0)
+ * - **info**: Informational messages for context (exit 0)
+ *
+ * @example
+ * ```typescript
+ * const report: ValidationReport = {
+ *   errors: ['Missing OPENAI_API_KEY'],
+ *   warnings: ['WARNING: Legacy key format detected'],
+ *   info: [],
+ *   resolved: { provider: 'openai', model: 'gpt-4o', ... },
+ *   valid: false,
+ * };
+ * ```
+ */
+export interface ValidationReport {
+    /** Errors that block execution (exit code 1) */
+    errors: string[];
+    /** Warnings that should be reviewed but don't block (exit code 0) */
+    warnings: string[];
+    /** Informational messages for context (exit code 0) */
+    info: string[];
+    /** Resolved configuration tuple on success (provider, model, key source) */
+    resolved?: ResolvedConfigTuple;
+    /** Overall validation status - true if no errors (warnings allowed) */
+    valid: boolean;
+}
+/**
+ * Convert PreflightResult to ValidationReport with severity categorization.
+ *
+ * Categorizes messages based on source:
+ * - result.errors → errors array
+ * - result.warnings → warnings array
+ *
+ * The `valid` field is true only when there are no errors (warnings are allowed).
+ *
+ * @param result - PreflightResult from runPreflightChecks()
+ * @returns ValidationReport with categorized messages and resolved config tuple
+ *
+ * @example
+ * ```typescript
+ * const preflight = runPreflightChecks(config, context, env);
+ * const report = formatValidationReport(preflight);
+ *
+ * if (report.valid) {
+ *   console.log('Config is valid');
+ * } else {
+ *   console.log(`${report.errors.length} errors found`);
+ * }
+ * ```
+ */
+export declare function formatValidationReport(result: PreflightResult): ValidationReport;
+/**
+ * Print validation report to console with formatted output.
+ *
+ * Output format and destinations:
+ * - Errors: "✗ ERROR: <message>" → stderr
+ * - Warnings: "⚠ WARNING: <message>" → stderr
+ * - Success: "✓ Configuration valid" → stdout
+ * - Resolved tuple details (provider, model, key source) → stdout
+ *
+ * When validation fails (errors present), shows error count in summary.
+ * When validation passes with warnings, shows "(with warnings)" suffix.
+ *
+ * @param report - ValidationReport to print
+ *
+ * @example
+ * ```typescript
+ * const report = formatValidationReport(preflightResult);
+ * printValidationReport(report);
+ *
+ * // Output on success:
+ * // ✓ Configuration valid
+ * //   Provider: openai
+ * //   Model: gpt-4o
+ * //   Key source: OPENAI_API_KEY
+ * //   Config source: .ai-review.yml
+ *
+ * // Output on failure:
+ * // ✗ ERROR: Missing OPENAI_API_KEY
+ * // Validation failed with 1 error(s).
+ * ```
+ */
+export declare function printValidationReport(report: ValidationReport): void;
+//# sourceMappingURL=validation-report.d.ts.map

package/dist/cli/validation-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-report.d.ts","sourceRoot":"","sources":["../../src/cli/validation-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uDAAuD;IACvD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,uEAAuE;IACvE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAWhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA4BpE"}

package/dist/cli/validation-report.js

@@ -0,0 +1,108 @@
+/**
+ * Validation Report Module
+ *
+ * Feature 015: Config Wizard & Validation
+ * Converts PreflightResult to structured ValidationReport with severity categorization.
+ * Provides formatted console output for validation results.
+ *
+ * Exit code semantics (per spec FR-015):
+ * - Exit 1: Errors present (validation failed)
+ * - Exit 0: Warnings only (validation passed with notes)
+ * - Exit 0: Success (validation passed)
+ *
+ * @module validation-report
+ * @see {@link ../../../specs/015-config-wizard-validate/spec.md} Feature specification
+ */
+/**
+ * Convert PreflightResult to ValidationReport with severity categorization.
+ *
+ * Categorizes messages based on source:
+ * - result.errors → errors array
+ * - result.warnings → warnings array
+ *
+ * The `valid` field is true only when there are no errors (warnings are allowed).
+ *
+ * @param result - PreflightResult from runPreflightChecks()
+ * @returns ValidationReport with categorized messages and resolved config tuple
+ *
+ * @example
+ * ```typescript
+ * const preflight = runPreflightChecks(config, context, env);
+ * const report = formatValidationReport(preflight);
+ *
+ * if (report.valid) {
+ *   console.log('Config is valid');
+ * } else {
+ *   console.log(`${report.errors.length} errors found`);
+ * }
+ * ```
+ */
+export function formatValidationReport(result) {
+    const errors = [...result.errors];
+    const warnings = result.warnings ? [...result.warnings] : [];
+    return {
+        errors,
+        warnings,
+        info: [],
+        resolved: result.resolved,
+        valid: errors.length === 0,
+    };
+}
+/**
+ * Print validation report to console with formatted output.
+ *
+ * Output format and destinations:
+ * - Errors: "✗ ERROR: <message>" → stderr
+ * - Warnings: "⚠ WARNING: <message>" → stderr
+ * - Success: "✓ Configuration valid" → stdout
+ * - Resolved tuple details (provider, model, key source) → stdout
+ *
+ * When validation fails (errors present), shows error count in summary.
+ * When validation passes with warnings, shows "(with warnings)" suffix.
+ *
+ * @param report - ValidationReport to print
+ *
+ * @example
+ * ```typescript
+ * const report = formatValidationReport(preflightResult);
+ * printValidationReport(report);
+ *
+ * // Output on success:
+ * // ✓ Configuration valid
+ * //   Provider: openai
+ * //   Model: gpt-4o
+ * //   Key source: OPENAI_API_KEY
+ * //   Config source: .ai-review.yml
+ *
+ * // Output on failure:
+ * // ✗ ERROR: Missing OPENAI_API_KEY
+ * // Validation failed with 1 error(s).
+ * ```
+ */
+export function printValidationReport(report) {
+    // Print errors to stderr
+    for (const err of report.errors) {
+        console.error(`✗ ERROR: ${err}`);
+    }
+    // Print warnings to stderr
+    for (const warn of report.warnings) {
+        console.error(`⚠ WARNING: ${warn}`);
+    }
+    // Print status and resolved tuple
+    if (report.valid) {
+        const status = report.warnings.length > 0
+            ? '✓ Configuration valid (with warnings)'
+            : '✓ Configuration valid';
+        console.log(status);
+        if (report.resolved) {
+            console.log(`  Provider: ${report.resolved.provider ?? 'none'}`);
+            console.log(`  Model: ${report.resolved.model}`);
+            console.log(`  Key source: ${report.resolved.keySource ?? '(not set)'}`);
+            console.log(`  Config source: ${report.resolved.configSource}`);
+        }
+    }
+    else {
+        console.error(`\nValidation failed with ${report.errors.length} error(s).`);
+    }
+}
+//# sourceMappingURL=validation-report.js.map

package/dist/cli/validation-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-report.js","sourceRoot":"","sources":["../../src/cli/validation-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAqCH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAuB;IAC5D,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7D,OAAO;QACL,MAAM;QACN,QAAQ;QACR,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAwB;IAC5D,yBAAyB;IACzB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,2BAA2B;IAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,kCAAkC;IAClC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,MAAM,GACV,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YACxB,CAAC,CAAC,uCAAuC;YACzC,CAAC,CAAC,uBAAuB,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,QAAQ,CAAC,SAAS,IAAI,WAAW,EAAE,CAAC,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,4BAA4B,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Config Module
+ *
+ * Re-exports from schemas and providers for clean imports.
+ */
+export { ConfigSchema, PassSchema, LimitsSchema, ModelsSchema, AgentSchema, ProviderSchema, type Config, type Pass, type Limits, type Models, type AgentId, type Provider, } from './schemas.js';
+export { type LlmProvider, type ResolvedConfigTuple, RESOLVED_CONFIG_SCHEMA_VERSION, RESOLVED_CONFIG_RESOLUTION_VERSION, isCompletionsOnlyModel, inferProviderFromModel, resolveEffectiveModel, resolveProvider, resolveKeySource, resolveConfigSource, buildResolvedConfigTuple, } from './providers.js';
+export { type ProviderDetectionResult, type ZeroConfigResult, type NoCredentialsResult, type GenerateZeroConfigResult, ZERO_CONFIG_LIMITS, ZERO_CONFIG_PASS_NAME, detectProvider, detectProviderWithDetails, generateZeroConfigDefaults, isZeroConfigSuccess, formatZeroConfigMessage, getZeroConfigDescription, } from './zero-config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,OAAO,EACZ,KAAK,QAAQ,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,8BAA8B,EAC9B,kCAAkC,EAClC,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,12 @@
+/**
+ * Config Module
+ *
+ * Re-exports from schemas and providers for clean imports.
+ */
+// Re-export all schemas and types
+export { ConfigSchema, PassSchema, LimitsSchema, ModelsSchema, AgentSchema, ProviderSchema, } from './schemas.js';
+// Re-export provider types and functions
+export { RESOLVED_CONFIG_SCHEMA_VERSION, RESOLVED_CONFIG_RESOLUTION_VERSION, isCompletionsOnlyModel, inferProviderFromModel, resolveEffectiveModel, resolveProvider, resolveKeySource, resolveConfigSource, buildResolvedConfigTuple, } from './providers.js';
+// Re-export zero-config types and functions
+export { ZERO_CONFIG_LIMITS, ZERO_CONFIG_PASS_NAME, detectProvider, detectProviderWithDetails, generateZeroConfigDefaults, isZeroConfigSuccess, formatZeroConfigMessage, getZeroConfigDescription, } from './zero-config.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kCAAkC;AAClC,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,GAOf,MAAM,cAAc,CAAC;AAEtB,yCAAyC;AACzC,OAAO,EAGL,8BAA8B,EAC9B,kCAAkC,EAClC,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,4CAA4C;AAC5C,OAAO,EAKL,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/config/mitigation-config.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Mitigation Configuration Parser
+ *
+ * Parses and validates custom mitigation pattern configuration.
+ * Implements:
+ * - T052: Config parser using Zod schemas
+ * - T053: Pattern validation ensuring declarative/side-effect-free per FR-015
+ * - T054: Pattern override support (confidence, deprecated)
+ * - T055: Pattern disable list support
+ * - FR-016: Validate patterns at configuration time with clear error messages
+ */
+import { type MitigationPattern, type PatternOverride, type ControlFlowConfig } from '../agents/control_flow/types.js';
+/**
+ * Result of pattern validation.
+ */
+export interface PatternValidationResult {
+    valid: boolean;
+    errors: PatternValidationError[];
+    warnings: PatternValidationWarning[];
+}
+/**
+ * Pattern validation error.
+ */
+export interface PatternValidationError {
+    code: string;
+    path: string[];
+    message: string;
+}
+/**
+ * Pattern validation warning.
+ */
+export interface PatternValidationWarning {
+    code: string;
+    path: string[];
+    message: string;
+}
+/**
+ * Result of config parsing.
+ */
+export interface ConfigParseResult {
+    success: boolean;
+    config?: ControlFlowConfig;
+    errors: PatternValidationError[];
+    warnings: PatternValidationWarning[];
+}
+/**
+ * Validate that a pattern is declarative and side-effect-free per FR-015.
+ *
+ * Patterns must only contain:
+ * - Function name matching (exact or regex)
+ * - Parameter constraints
+ * - Return value assertions
+ * - Module specifications
+ *
+ * No executable code, callbacks, or side effects are allowed.
+ */
+export declare function validatePatternIsDeclarative(pattern: MitigationPattern): PatternValidationResult;
+/**
+ * Validate a pattern override.
+ */
+export declare function validatePatternOverride(override: PatternOverride): PatternValidationResult;
+/**
+ * Parse and validate a control flow configuration.
+ *
+ * This function:
+ * 1. Parses the config using Zod schema
+ * 2. Validates each custom pattern is declarative (FR-015)
+ * 3. Validates pattern overrides
+ * 4. Checks for conflicts and issues
+ */
+export declare function parseControlFlowConfig(rawConfig: unknown): ConfigParseResult;
+/**
+ * Apply pattern overrides to a set of patterns.
+ *
+ * Returns a new array with overrides applied.
+ */
+export declare function applyPatternOverrides(patterns: MitigationPattern[], overrides: PatternOverride[]): MitigationPattern[];
+/**
+ * Filter out disabled patterns.
+ */
+export declare function filterDisabledPatterns(patterns: MitigationPattern[], disabledIds: string[]): MitigationPattern[];
+/**
+ * Get effective patterns after applying overrides and filtering disabled.
+ */
+export declare function getEffectivePatterns(builtInPatterns: MitigationPattern[], customPatterns: MitigationPattern[], overrides: PatternOverride[], disabledIds: string[]): MitigationPattern[];
+/**
+ * Format validation errors for display.
+ */
+export declare function formatValidationErrors(errors: PatternValidationError[]): string;
+/**
+ * Format validation warnings for display.
+ */
+export declare function formatValidationWarnings(warnings: PatternValidationWarning[]): string;
+//# sourceMappingURL=mitigation-config.d.ts.map

package/dist/config/mitigation-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mitigation-config.d.ts","sourceRoot":"","sources":["../../src/config/mitigation-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AAMzC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAwCD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,iBAAiB,GAAG,uBAAuB,CAyHhG;AAwBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,uBAAuB,CAmC1F;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,OAAO,GAAG,iBAAiB,CA+I5E;AAMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,SAAS,EAAE,eAAe,EAAE,GAC3B,iBAAiB,EAAE,CAmBrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,WAAW,EAAE,MAAM,EAAE,GACpB,iBAAiB,EAAE,CAGrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,iBAAiB,EAAE,EACpC,cAAc,EAAE,iBAAiB,EAAE,EACnC,SAAS,EAAE,eAAe,EAAE,EAC5B,WAAW,EAAE,MAAM,EAAE,GACpB,iBAAiB,EAAE,CAYrB;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,CAM/E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,wBAAwB,EAAE,GAAG,MAAM,CAMrF"}