ai-sdlc 0.2.0-alpha.5 → 0.2.0-alpha.50

package/dist/services/error-classifier.d.ts

@@ -0,0 +1,119 @@
+/**
+ * TypeScript Error Classification Service
+ *
+ * Classifies TypeScript compiler errors into two categories:
+ * - Source errors: Root causes in production code (e.g., missing type definitions)
+ * - Cascading errors: Downstream effects caused by source errors (e.g., test file imports failing)
+ *
+ * This enables the implementation agent to prioritize fixing root causes first,
+ * which often resolves multiple cascading errors automatically.
+ */
+/**
+ * Structured representation of a TypeScript compiler error
+ */
+export interface TypeScriptError {
+    /** The file path where the error occurred */
+    filePath: string;
+    /** The line number (1-indexed) where the error occurred */
+    line?: number;
+    /** The column number (1-indexed) where the error occurred */
+    column?: number;
+    /** The TypeScript error code (e.g., "TS2322") */
+    code: string;
+    /** The error message text */
+    message: string;
+}
+/**
+ * Result of classifying and sorting TypeScript errors
+ */
+export interface ClassifiedErrors {
+    /** Source errors that are root causes and should be fixed first */
+    source: TypeScriptError[];
+    /** Cascading errors that may resolve automatically when source errors are fixed */
+    cascading: TypeScriptError[];
+}
+/**
+ * Error classification type
+ */
+export type ErrorClassification = 'source' | 'cascading';
+/**
+ * Parses TypeScript compiler output and extracts structured error information.
+ *
+ * Expected format: `<filePath>(<line>,<col>): error <code>: <message>`
+ * Example: `src/app.tsx(59,12): error TS2322: Type 'string' is not assignable to type 'number'.`
+ *
+ * @param buildOutput - Raw output from TypeScript compiler (tsc)
+ * @returns Array of structured TypeScript errors
+ *
+ * @example
+ * ```typescript
+ * const output = "src/app.tsx(59,12): error TS2322: Type 'string' is not assignable to type 'number'.";
+ * const errors = parseTypeScriptErrors(output);
+ * // errors[0] = { filePath: 'src/app.tsx', line: 59, column: 12, code: 'TS2322', message: '...' }
+ * ```
+ */
+export declare function parseTypeScriptErrors(buildOutput: string): TypeScriptError[];
+/**
+ * Determines if a file path points to a test file.
+ *
+ * Test files are identified by:
+ * - File extension: .test.ts, .test.tsx, .spec.ts, .spec.tsx, .test.js, .test.jsx, .spec.js, .spec.jsx
+ * - Directory patterns: tests/, __tests__/
+ *
+ * @param filePath - The file path to check
+ * @returns true if the file is a test file, false otherwise
+ */
+export declare function isTestFile(filePath: string): boolean;
+/**
+ * Determines if a file path points to a type definition file.
+ *
+ * Type definition files are identified by:
+ * - File extension: .d.ts
+ * - Directory patterns: types/, @types/
+ *
+ * @param filePath - The file path to check
+ * @returns true if the file is a type definition file, false otherwise
+ */
+export declare function isTypeDefinitionFile(filePath: string): boolean;
+/**
+ * Classifies a single TypeScript error as either a source error (root cause)
+ * or a cascading error (downstream effect).
+ *
+ * Classification logic:
+ * 1. Known cascading-only codes (TS2345) → cascading
+ * 2. Known source codes (TS2304, TS2339) in non-test files → source
+ * 3. Context-dependent codes (TS2307, TS2322) → analyze file path
+ * 4. Conservative default → cascading
+ *
+ * @param error - The TypeScript error to classify
+ * @returns 'source' if root cause, 'cascading' if downstream effect
+ *
+ * @example
+ * ```typescript
+ * const error = { code: 'TS2304', filePath: 'src/app.ts', message: 'Cannot find name Foo' };
+ * const classification = classifyError(error); // 'source'
+ * ```
+ */
+export declare function classifyError(error: TypeScriptError): ErrorClassification;
+/**
+ * Classifies and sorts multiple TypeScript errors into source and cascading categories.
+ *
+ * Source errors are prioritized for fixing as they may automatically resolve
+ * multiple cascading errors.
+ *
+ * @param errors - Array of TypeScript errors to classify
+ * @returns Object with separated source and cascading error arrays
+ *
+ * @example
+ * ```typescript
+ * const errors = [
+ *   { code: 'TS2304', filePath: 'src/app.ts', message: '...' },
+ *   { code: 'TS2307', filePath: 'tests/app.test.ts', message: '...' }
+ * ];
+ * const classified = classifyAndSortErrors(errors);
+ * // classified.source = [{ code: 'TS2304', ... }]
+ * // classified.cascading = [{ code: 'TS2307', ... }]
+ * ```
+ */
+export declare function classifyAndSortErrors(errors: TypeScriptError[]): ClassifiedErrors;
+//# sourceMappingURL=error-classifier.d.ts.map

package/dist/services/error-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.d.ts","sourceRoot":"","sources":["../../src/services/error-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,mFAAmF;IACnF,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,EAAE,CAyB5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAmBpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAmB9D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,mBAAmB,CAgCzE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,gBAAgB,CAcjF"}

package/dist/services/error-classifier.js

@@ -0,0 +1,182 @@
+/**
+ * TypeScript Error Classification Service
+ *
+ * Classifies TypeScript compiler errors into two categories:
+ * - Source errors: Root causes in production code (e.g., missing type definitions)
+ * - Cascading errors: Downstream effects caused by source errors (e.g., test file imports failing)
+ *
+ * This enables the implementation agent to prioritize fixing root causes first,
+ * which often resolves multiple cascading errors automatically.
+ */
+/**
+ * Parses TypeScript compiler output and extracts structured error information.
+ *
+ * Expected format: `<filePath>(<line>,<col>): error <code>: <message>`
+ * Example: `src/app.tsx(59,12): error TS2322: Type 'string' is not assignable to type 'number'.`
+ *
+ * @param buildOutput - Raw output from TypeScript compiler (tsc)
+ * @returns Array of structured TypeScript errors
+ *
+ * @example
+ * ```typescript
+ * const output = "src/app.tsx(59,12): error TS2322: Type 'string' is not assignable to type 'number'.";
+ * const errors = parseTypeScriptErrors(output);
+ * // errors[0] = { filePath: 'src/app.tsx', line: 59, column: 12, code: 'TS2322', message: '...' }
+ * ```
+ */
+export function parseTypeScriptErrors(buildOutput) {
+    if (!buildOutput || buildOutput.trim() === '') {
+        return [];
+    }
+    const errors = [];
+    // Regex pattern to match TypeScript error format:
+    // <filePath>(<line>,<col>): error <code>: <message>
+    // Supports both Windows (C:\...) and Unix (/...) paths
+    const tsErrorPattern = /^(.+?)\((\d+),(\d+)\):\s*error\s+(TS\d+):\s*(.+)$/gm;
+    let match;
+    while ((match = tsErrorPattern.exec(buildOutput)) !== null) {
+        const [, filePath, lineStr, colStr, code, message] = match;
+        errors.push({
+            filePath: filePath.trim(),
+            line: parseInt(lineStr, 10),
+            column: parseInt(colStr, 10),
+            code: code.trim(),
+            message: message.trim(),
+        });
+    }
+    return errors;
+}
+/**
+ * Determines if a file path points to a test file.
+ *
+ * Test files are identified by:
+ * - File extension: .test.ts, .test.tsx, .spec.ts, .spec.tsx, .test.js, .test.jsx, .spec.js, .spec.jsx
+ * - Directory patterns: tests/, __tests__/
+ *
+ * @param filePath - The file path to check
+ * @returns true if the file is a test file, false otherwise
+ */
+export function isTestFile(filePath) {
+    // Check for test file extensions
+    if (/\.(test|spec)\.(ts|tsx|js|jsx)$/.test(filePath)) {
+        return true;
+    }
+    // Check for test directories (handle both Windows and Unix path separators)
+    // Also handle paths that start with the directory name (e.g., "tests/app.ts")
+    if (/(^|[\\/])tests?[\\/]/.test(filePath)) {
+        return true;
+    }
+    // Check for __tests__ directory
+    // Also handle paths that start with __tests__ (e.g., "__tests__/app.ts")
+    if (/(^|[\\/])__tests__[\\/]/.test(filePath)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Determines if a file path points to a type definition file.
+ *
+ * Type definition files are identified by:
+ * - File extension: .d.ts
+ * - Directory patterns: types/, @types/
+ *
+ * @param filePath - The file path to check
+ * @returns true if the file is a type definition file, false otherwise
+ */
+export function isTypeDefinitionFile(filePath) {
+    // Check for .d.ts extension
+    if (filePath.endsWith('.d.ts')) {
+        return true;
+    }
+    // Check for types/ directory (handle both Windows and Unix path separators)
+    // Also handle paths that start with types/ (e.g., "types/global.ts")
+    if (/(^|[\\/])types[\\/]/.test(filePath)) {
+        return true;
+    }
+    // Check for @types/ directory
+    // Also handle paths that start with @types/ (e.g., "@types/custom/foo.ts")
+    if (/(^|[\\/])@types[\\/]/.test(filePath)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Classifies a single TypeScript error as either a source error (root cause)
+ * or a cascading error (downstream effect).
+ *
+ * Classification logic:
+ * 1. Known cascading-only codes (TS2345) → cascading
+ * 2. Known source codes (TS2304, TS2339) in non-test files → source
+ * 3. Context-dependent codes (TS2307, TS2322) → analyze file path
+ * 4. Conservative default → cascading
+ *
+ * @param error - The TypeScript error to classify
+ * @returns 'source' if root cause, 'cascading' if downstream effect
+ *
+ * @example
+ * ```typescript
+ * const error = { code: 'TS2304', filePath: 'src/app.ts', message: 'Cannot find name Foo' };
+ * const classification = classifyError(error); // 'source'
+ * ```
+ */
+export function classifyError(error) {
+    const { code, filePath } = error;
+    // Known cascading-only error codes
+    const CASCADING_ONLY_CODES = ['TS2345']; // Argument type mismatch
+    // Known source error codes (when in non-test files)
+    const SOURCE_ERROR_CODES = ['TS2304', 'TS2339']; // Cannot find name, Property does not exist
+    // Priority 1: Known cascading-only codes
+    if (CASCADING_ONLY_CODES.includes(code)) {
+        return 'cascading';
+    }
+    // Priority 2: Known source codes in non-test files
+    if (SOURCE_ERROR_CODES.includes(code) && !isTestFile(filePath)) {
+        return 'source';
+    }
+    // Priority 3: Context-dependent codes need path analysis
+    if (code === 'TS2307') {
+        // Module not found: source in src, cascading in tests
+        return isTestFile(filePath) ? 'cascading' : 'source';
+    }
+    if (code === 'TS2322') {
+        // Type mismatch: source in type definitions, cascading elsewhere
+        return isTypeDefinitionFile(filePath) ? 'source' : 'cascading';
+    }
+    // Priority 4: Conservative default (when uncertain)
+    return 'cascading';
+}
+/**
+ * Classifies and sorts multiple TypeScript errors into source and cascading categories.
+ *
+ * Source errors are prioritized for fixing as they may automatically resolve
+ * multiple cascading errors.
+ *
+ * @param errors - Array of TypeScript errors to classify
+ * @returns Object with separated source and cascading error arrays
+ *
+ * @example
+ * ```typescript
+ * const errors = [
+ *   { code: 'TS2304', filePath: 'src/app.ts', message: '...' },
+ *   { code: 'TS2307', filePath: 'tests/app.test.ts', message: '...' }
+ * ];
+ * const classified = classifyAndSortErrors(errors);
+ * // classified.source = [{ code: 'TS2304', ... }]
+ * // classified.cascading = [{ code: 'TS2307', ... }]
+ * ```
+ */
+export function classifyAndSortErrors(errors) {
+    const source = [];
+    const cascading = [];
+    for (const error of errors) {
+        const classification = classifyError(error);
+        if (classification === 'source') {
+            source.push(error);
+        }
+        else {
+            cascading.push(error);
+        }
+    }
+    return { source, cascading };
+}
+//# sourceMappingURL=error-classifier.js.map

package/dist/services/error-classifier.js.map

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