dartmind 17.0.0

package/dist/errors/ErrorSurface.js

@@ -0,0 +1,352 @@
+/**
+ * FlutterAI V16 - ErrorSurface
+ * Issue 10.1: No Silent Failures
+ *
+ * Every error MUST surface with:
+ * - Unique error code (FAI-{CATEGORY}-{NUMBER})
+ * - Human-readable message
+ * - Technical details (for logs)
+ * - Suggested fix (for user)
+ * - Severity level
+ *
+ * @module errors/ErrorSurface
+ * @version 16.0.0
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+const CATEGORY_PREFIXES = {
+    SECURITY: 'SEC',
+    VALIDATION: 'VAL',
+    NETWORK: 'NET',
+    INTERNAL: 'INT',
+    USER_INPUT: 'USR',
+    GATE_FAILURE: 'GAT',
+    FILE_SYSTEM: 'FSY',
+    PACKAGE: 'PKG',
+    ANALYSIS: 'ANL',
+};
+// Error code registry - prevents duplicate codes
+const ERROR_CODES = new Map();
+// ============================================================================
+// ErrorSurface Class
+// ============================================================================
+export class ErrorSurface {
+    /**
+     * Create a properly formatted FlutterAI error
+     */
+    static create(params) {
+        // Format error code if not already in FAI- format
+        let fullCode = params.code;
+        if (!params.code.startsWith('FAI-')) {
+            fullCode = `FAI-${CATEGORY_PREFIXES[params.category]}-${params.code.padStart(3, '0')}`;
+        }
+        // Register code to detect duplicates (warn in development)
+        if (ERROR_CODES.has(fullCode) && ERROR_CODES.get(fullCode) !== params.message) {
+            console.warn(`Error code ${fullCode} registered with different message`);
+        }
+        ERROR_CODES.set(fullCode, params.message);
+        return {
+            code: fullCode,
+            category: params.category,
+            severity: params.severity,
+            message: params.message,
+            technicalDetails: params.technicalDetails,
+            suggestedFix: params.suggestedFix,
+            cause: params.cause,
+            context: params.context,
+            timestamp: new Date(),
+            stack: new Error().stack,
+        };
+    }
+    /**
+     * Chain errors (preserve cause chain)
+     */
+    static chain(error, cause) {
+        return {
+            ...error,
+            cause,
+            technicalDetails: error.technicalDetails
+                ? `${error.technicalDetails}\nCaused by: ${cause.message}`
+                : `Caused by: ${cause.message}`,
+        };
+    }
+    /**
+     * Format error for display
+     */
+    static format(error, verbose = false) {
+        const lines = [`[${error.code}] ${error.message}`];
+        if (error.suggestedFix) {
+            lines.push(`Fix: ${error.suggestedFix}`);
+        }
+        if (verbose && error.technicalDetails) {
+            lines.push(`Details: ${error.technicalDetails}`);
+        }
+        if (verbose && error.context) {
+            lines.push(`Context: ${JSON.stringify(error.context, null, 2)}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format error for logging (includes all details)
+     */
+    static formatForLog(error) {
+        return JSON.stringify({
+            ...error,
+            timestamp: error.timestamp.toISOString(),
+            cause: error.cause
+                ? {
+                    message: error.cause.message,
+                    stack: error.cause instanceof Error ? error.cause.stack : undefined,
+                }
+                : undefined,
+        }, null, 2);
+    }
+    /**
+     * MUST surface - throws if error would be swallowed
+     * Use this to wrap operations that must not fail silently
+     */
+    static mustSurface(error) {
+        // Log the error
+        console.error(ErrorSurface.formatForLog(error));
+        // Create a proper Error that will propagate
+        const err = new Error(ErrorSurface.format(error, true));
+        err.name = `FlutterAIError:${error.code}`;
+        err.surfacedError = error;
+        throw err;
+    }
+    /**
+     * Wrap an async operation to ensure errors surface
+     */
+    static async wrapAsync(operation, errorContext) {
+        try {
+            return await operation();
+        }
+        catch (err) {
+            const surfacedErr = ErrorSurface.create({
+                ...errorContext,
+                cause: err instanceof Error ? err : new Error(String(err)),
+                technicalDetails: err instanceof Error ? err.message : String(err),
+            });
+            ErrorSurface.mustSurface(surfacedErr);
+        }
+    }
+    /**
+     * Check if an error is a SurfacedError
+     */
+    static isSurfacedError(err) {
+        return (typeof err === 'object' &&
+            err !== null &&
+            'code' in err &&
+            'category' in err &&
+            'severity' in err &&
+            typeof err.code === 'string' &&
+            err.code.startsWith('FAI-'));
+    }
+    /**
+     * Extract SurfacedError from thrown Error
+     */
+    static extract(err) {
+        if (err.surfacedError) {
+            return err.surfacedError;
+        }
+        return null;
+    }
+    /**
+     * Convert unknown error to SurfacedError
+     */
+    static fromUnknown(err, context) {
+        if (ErrorSurface.isSurfacedError(err)) {
+            return err;
+        }
+        if (err instanceof Error && err.surfacedError) {
+            return err.surfacedError;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        return ErrorSurface.create({
+            code: '001',
+            category: 'INTERNAL',
+            severity: 'HIGH',
+            message: context ? `${context}: ${message}` : message,
+            technicalDetails: err instanceof Error ? err.stack : undefined,
+            cause: err instanceof Error ? err : undefined,
+        });
+    }
+}
+// ============================================================================
+// Pre-defined Error Factories
+// ============================================================================
+export const Errors = {
+    // Security errors (FAI-SEC-xxx)
+    secretDetected: (details) => ErrorSurface.create({
+        code: '001',
+        category: 'SECURITY',
+        severity: 'CRITICAL',
+        message: 'Secret or sensitive data detected in input',
+        technicalDetails: details,
+        suggestedFix: 'Remove API keys, passwords, and tokens from your input',
+    }),
+    injectionDetected: (threatScore) => ErrorSurface.create({
+        code: '002',
+        category: 'SECURITY',
+        severity: 'CRITICAL',
+        message: 'Potential prompt injection attack detected',
+        technicalDetails: `Threat score: ${threatScore}`,
+        suggestedFix: 'Rephrase your request without instruction override attempts',
+    }),
+    piiDetected: (types) => ErrorSurface.create({
+        code: '003',
+        category: 'SECURITY',
+        severity: 'HIGH',
+        message: 'PII (personally identifiable information) detected',
+        technicalDetails: `PII types: ${types.join(', ')}`,
+        suggestedFix: 'Remove personal information or use the masking feature',
+    }),
+    contextElevationDenied: (reason) => ErrorSurface.create({
+        code: '005',
+        category: 'SECURITY',
+        severity: 'HIGH',
+        message: 'Context elevation denied',
+        technicalDetails: reason,
+        suggestedFix: 'Provide a valid reason for elevation',
+    }),
+    // Gate errors (FAI-GAT-xxx)
+    gateFailed: (gateId, reason) => ErrorSurface.create({
+        code: '001',
+        category: 'GATE_FAILURE',
+        severity: 'HIGH',
+        message: `Safety gate ${gateId} failed`,
+        technicalDetails: reason,
+        suggestedFix: 'Review the gate failure reason and adjust your request',
+    }),
+    gateTimeout: (gateId, timeoutMs) => ErrorSurface.create({
+        code: '002',
+        category: 'GATE_FAILURE',
+        severity: 'MEDIUM',
+        message: `Safety gate ${gateId} timed out`,
+        technicalDetails: `Timeout after ${timeoutMs}ms`,
+        suggestedFix: 'Try again - the operation may have been temporarily slow',
+    }),
+    gateBypassAttempted: (gateId) => ErrorSurface.create({
+        code: '003',
+        category: 'GATE_FAILURE',
+        severity: 'CRITICAL',
+        message: `Gate bypass attempted for ${gateId}`,
+        technicalDetails: 'Gate bypass is not allowed',
+        suggestedFix: 'All safety gates must pass - bypass is not possible',
+    }),
+    outputBlocked: (failedGates) => ErrorSurface.create({
+        code: '004',
+        category: 'GATE_FAILURE',
+        severity: 'CRITICAL',
+        message: 'Cannot produce output - safety gates failed',
+        technicalDetails: `Failed gates: ${failedGates.join(', ')}`,
+        suggestedFix: 'Address the gate failures before proceeding',
+    }),
+    // Validation errors (FAI-VAL-xxx)
+    invalidInput: (field, reason) => ErrorSurface.create({
+        code: '001',
+        category: 'VALIDATION',
+        severity: 'MEDIUM',
+        message: `Invalid input: ${field}`,
+        technicalDetails: reason,
+        suggestedFix: `Please provide a valid ${field}`,
+    }),
+    missingRequired: (field) => ErrorSurface.create({
+        code: '002',
+        category: 'VALIDATION',
+        severity: 'MEDIUM',
+        message: `Missing required field: ${field}`,
+        suggestedFix: `Please provide the ${field} field`,
+    }),
+    // Package errors (FAI-PKG-xxx)
+    packageNotFound: (packageName) => ErrorSurface.create({
+        code: '001',
+        category: 'PACKAGE',
+        severity: 'HIGH',
+        message: `Package '${packageName}' not found on pub.dev`,
+        suggestedFix: 'Check the package name spelling or search pub.dev for alternatives',
+    }),
+    packageHallucinated: (packageName) => ErrorSurface.create({
+        code: '002',
+        category: 'PACKAGE',
+        severity: 'CRITICAL',
+        message: `Package '${packageName}' does not exist - AI hallucination prevented`,
+        suggestedFix: 'This package was incorrectly suggested. Search pub.dev for real alternatives.',
+    }),
+    packageVulnerable: (packageName, vulnerability) => ErrorSurface.create({
+        code: '006',
+        category: 'PACKAGE',
+        severity: 'HIGH',
+        message: `Package '${packageName}' has a security vulnerability`,
+        technicalDetails: vulnerability,
+        suggestedFix: 'Update to a patched version or use an alternative package',
+    }),
+    // File system errors (FAI-FSY-xxx)
+    fileNotFound: (path) => ErrorSurface.create({
+        code: '001',
+        category: 'FILE_SYSTEM',
+        severity: 'MEDIUM',
+        message: `File not found: ${path}`,
+        suggestedFix: 'Check that the file path is correct',
+    }),
+    fileWriteFailed: (path, reason) => ErrorSurface.create({
+        code: '002',
+        category: 'FILE_SYSTEM',
+        severity: 'HIGH',
+        message: `Failed to write file: ${path}`,
+        technicalDetails: reason,
+        suggestedFix: 'Check file permissions and disk space',
+    }),
+    atomicWriteFailed: (path, reason) => ErrorSurface.create({
+        code: '005',
+        category: 'FILE_SYSTEM',
+        severity: 'HIGH',
+        message: `Atomic write failed: ${path}`,
+        technicalDetails: reason,
+        suggestedFix: 'Operation was rolled back safely. Check the error and retry.',
+    }),
+    // Analysis errors (FAI-ANL-xxx)
+    dartAnalyzerFailed: (reason) => ErrorSurface.create({
+        code: '001',
+        category: 'ANALYSIS',
+        severity: 'HIGH',
+        message: 'Dart analyzer failed',
+        technicalDetails: reason,
+        suggestedFix: 'Fix the syntax errors in the generated code',
+    }),
+    // Network errors (FAI-NET-xxx)
+    connectionFailed: (service) => ErrorSurface.create({
+        code: '001',
+        category: 'NETWORK',
+        severity: 'MEDIUM',
+        message: `Connection to ${service} failed`,
+        suggestedFix: 'Check your network connection and try again',
+    }),
+    rateLimited: (service, retryAfter) => ErrorSurface.create({
+        code: '003',
+        category: 'NETWORK',
+        severity: 'MEDIUM',
+        message: `Rate limited by ${service}`,
+        technicalDetails: retryAfter ? `Retry after ${retryAfter}s` : undefined,
+        suggestedFix: 'Wait a moment and try again',
+    }),
+    // Internal errors (FAI-INT-xxx)
+    unexpected: (message, details) => ErrorSurface.create({
+        code: '001',
+        category: 'INTERNAL',
+        severity: 'HIGH',
+        message,
+        technicalDetails: details,
+        suggestedFix: 'This is an unexpected error. Please report it if it persists.',
+    }),
+    configurationError: (message) => ErrorSurface.create({
+        code: '002',
+        category: 'INTERNAL',
+        severity: 'HIGH',
+        message: `Configuration error: ${message}`,
+        suggestedFix: 'Check your configuration settings',
+    }),
+};
+export default ErrorSurface;
+//# sourceMappingURL=ErrorSurface.js.map

package/dist/errors/ErrorSurface.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * FlutterAI V16 - Errors Module
+ * Issue 10.1: No Silent Failures
+ *
+ * @module errors
+ * @version 16.0.0
+ */
+export { ErrorSurface, Errors, type ErrorCategory, type ErrorSeverity, type SurfacedError, } from './ErrorSurface.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,MAAM,EACN,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,9 @@
+/**
+ * FlutterAI V16 - Errors Module
+ * Issue 10.1: No Silent Failures
+ *
+ * @module errors
+ * @version 16.0.0
+ */
+export { ErrorSurface, Errors, } from './ErrorSurface.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,MAAM,GAIP,MAAM,mBAAmB,CAAC"}

package/dist/gates/AccessibilityGate.d.ts

@@ -0,0 +1,119 @@
+/**
+ * FlutterAI v10 - AccessibilityGate
+ *
+ * Validates Flutter/Dart code for accessibility (a11y) compliance.
+ * Ensures widgets have proper semantic labels, contrast ratios,
+ * touch targets, and screen reader support.
+ *
+ * @module gates/AccessibilityGate
+ */
+import { EventEmitter } from 'events';
+export type A11yIssueType = 'missing_semantic_label' | 'missing_tooltip' | 'small_touch_target' | 'low_contrast' | 'missing_alt_text' | 'non_descriptive_text' | 'missing_focus_order' | 'inaccessible_gesture' | 'missing_live_region' | 'hardcoded_text' | 'missing_exclude_semantics';
+export type A11ySeverity = 'error' | 'warning' | 'info';
+export interface A11yIssue {
+    /** Type of issue */
+    type: A11yIssueType;
+    /** Severity level */
+    severity: A11ySeverity;
+    /** Line number */
+    line: number;
+    /** Column number */
+    column: number;
+    /** Code snippet */
+    code: string;
+    /** Issue message */
+    message: string;
+    /** WCAG guideline reference */
+    wcagRef?: string;
+    /** Suggested fix */
+    suggestion: string;
+}
+export interface A11yGateConfig {
+    /** Minimum touch target size in logical pixels */
+    minTouchTarget: number;
+    /** Minimum contrast ratio for normal text */
+    minContrastRatio: number;
+    /** Minimum contrast ratio for large text */
+    minLargeTextContrastRatio: number;
+    /** Check for semantic labels */
+    checkSemanticLabels: boolean;
+    /** Check for tooltips on icon buttons */
+    checkTooltips: boolean;
+    /** Check touch target sizes */
+    checkTouchTargets: boolean;
+    /** Check for hardcoded strings */
+    checkHardcodedText: boolean;
+    /** Check for focus management */
+    checkFocusManagement: boolean;
+    /** Treat warnings as errors */
+    strictMode: boolean;
+}
+export interface A11yGateResult {
+    /** Whether validation passed */
+    passed: boolean;
+    /** Issues found */
+    issues: A11yIssue[];
+    /** Error count */
+    errorCount: number;
+    /** Warning count */
+    warningCount: number;
+    /** Info count */
+    infoCount: number;
+    /** Score (0-100) */
+    score: number;
+}
+export interface A11yGateStats {
+    /** Total validations */
+    totalValidations: number;
+    /** Passed validations */
+    passedCount: number;
+    /** Failed validations */
+    failedCount: number;
+    /** Issues by type */
+    issuesByType: Map<A11yIssueType, number>;
+    /** Average score */
+    averageScore: number;
+}
+export declare class AccessibilityGate extends EventEmitter {
+    private config;
+    private stats;
+    private totalScoreSum;
+    constructor(config?: Partial<A11yGateConfig>);
+    /**
+     * Validate Dart/Flutter code for accessibility
+     */
+    validate(code: string, filePath?: string): A11yGateResult;
+    /**
+     * Check if a pattern type should be run
+     */
+    private shouldCheck;
+    /**
+     * Check focus management patterns
+     */
+    private checkFocusManagement;
+    /**
+     * Get line and column from position
+     */
+    private getPosition;
+    /**
+     * Calculate accessibility score
+     */
+    private calculateScore;
+    /**
+     * Get statistics
+     */
+    getStats(): A11yGateStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Get health status
+     */
+    getHealth(): {
+        healthy: boolean;
+        message: string;
+    };
+}
+export default AccessibilityGate;
+//# sourceMappingURL=AccessibilityGate.d.ts.map

package/dist/gates/AccessibilityGate.d.ts.map

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