@vibe-validate/extractors 0.12.0

package/README.md

@@ -0,0 +1,121 @@
+# @vibe-validate/extractors
+
+LLM-optimized error extractors for validation output.
+
+## Features
+
+- **Intelligent Error Extraction**: Automatically detects tool type and applies appropriate extractor
+- **Token-Efficient Output**: Limits errors to first 10, removes noise, focuses on actionable info
+- **Actionable Guidance**: Provides tool-specific fixing suggestions
+- **Zero Dependencies**: Pure TypeScript implementation
+
+## Supported Extractors
+
+- **TypeScript (tsc)**: Parses `file(line,col): error TSxxxx: message` format
+- **ESLint**: Parses `file:line:col - severity message [rule]` format
+- **Vitest/Jest**: Extracts test hierarchy, assertion errors, expected vs actual
+- **OpenAPI**: Filters validation errors from specification validators
+- **Generic**: Fallback for unknown tools (removes npm noise)
+
+## Installation
+
+```bash
+npm install @vibe-validate/extractors
+```
+
+## Usage
+
+### Smart Extractor (Recommended)
+
+Auto-detects tool type from step name:
+
+```typescript
+import { extractByStepName } from '@vibe-validate/extractors';
+
+const result = extractByStepName('TypeScript Type Checking', tscOutput);
+
+console.log(result.summary);      // "3 type error(s), 0 warning(s)"
+console.log(result.guidance);     // "Type mismatch - check variable/parameter types"
+console.log(result.cleanOutput);  // Clean, formatted error list
+console.log(result.errors);       // Structured error array
+```
+
+### Direct Extractor Usage
+
+For explicit control:
+
+```typescript
+import {
+  extractTypeScriptErrors,
+  extractESLintErrors,
+  extractVitestErrors,
+  formatOpenAPIErrors,
+  formatGenericErrors
+} from '@vibe-validate/extractors';
+
+const result = extractTypeScriptErrors(tscOutput);
+```
+
+### Utilities
+
+```typescript
+import { stripAnsiCodes, extractErrorLines } from '@vibe-validate/extractors';
+
+const clean = stripAnsiCodes(colorfulOutput);
+const errorLines = extractErrorLines(verboseOutput);
+```
+
+## API
+
+### `extractByStepName(stepName: string, output: string): ErrorExtractorResult`
+
+Smart extractor with auto-detection.
+
+**Detection rules:**
+- TypeScript: Step name contains "TypeScript" or "typecheck"
+- ESLint: Step name contains "ESLint" or "lint"
+- Vitest/Jest: Step name contains "test" (but not "OpenAPI")
+- OpenAPI: Step name contains "OpenAPI"
+- Generic: Fallback for unknown types
+
+### Type Definitions
+
+```typescript
+interface FormattedError {
+  file: string;
+  line?: number;
+  column?: number;
+  message: string;
+  code?: string;
+  severity?: 'error' | 'warning';
+  context?: string;
+}
+
+interface ErrorExtractorResult {
+  errors: FormattedError[];        // First 10 errors (structured)
+  summary: string;                 // Human-readable summary
+  totalCount: number;              // Total error count
+  guidance?: string;               // Actionable fixing guidance
+  cleanOutput: string;             // Clean formatted output for YAML/JSON
+}
+```
+
+## Why LLM-Optimized?
+
+1. **Token Efficiency**: Limits output to first 10 errors (most relevant)
+2. **Noise Removal**: Strips ANSI codes, npm headers, stack traces
+3. **Structured Data**: Provides parseable error objects with file:line:col
+4. **Actionable Guidance**: Suggests specific fixes based on error codes
+5. **Clean Embedding**: `cleanOutput` ready for YAML/JSON state files
+
+## Design Philosophy
+
+**Agent-First**: Designed for consumption by AI assistants (Claude Code, Cursor, etc.), not just humans.
+
+**Deterministic**: Same input always produces same output (no timestamps, no randomness).
+
+**Minimal**: Zero runtime dependencies, pure TypeScript.
+
+## License
+
+MIT

package/dist/eslint-extractor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ESLint Error Extractor
+ *
+ * Parses and formats ESLint error output for LLM consumption.
+ *
+ * @package @vibe-validate/extractors
+ */
+import type { ErrorExtractorResult } from './types.js';
+/**
+ * Format ESLint errors
+ *
+ * Parses ESLint output format: `file:line:col - severity message [rule-name]`
+ *
+ * @param output - Raw ESLint command output
+ * @returns Structured error information with ESLint-specific guidance
+ *
+ * @example
+ * ```typescript
+ * const result = extractESLintErrors(eslintOutput);
+ * console.log(result.summary); // "5 ESLint error(s), 2 warning(s)"
+ * console.log(result.guidance); // "Remove or prefix unused variables with underscore"
+ * ```
+ */
+export declare function extractESLintErrors(output: string): ErrorExtractorResult;
+//# sourceMappingURL=eslint-extractor.d.ts.map

package/dist/eslint-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint-extractor.d.ts","sourceRoot":"","sources":["../src/eslint-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAkB,MAAM,YAAY,CAAC;AA+CvE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAiExE"}

package/dist/eslint-extractor.js

@@ -0,0 +1,143 @@
+/**
+ * ESLint Error Extractor
+ *
+ * Parses and formats ESLint error output for LLM consumption.
+ *
+ * @package @vibe-validate/extractors
+ */
+/**
+ * Deduplicate ESLint errors by file:line:column
+ *
+ * When multiple rules report the same error at the same location,
+ * prefer @typescript-eslint/* rules over base ESLint rules.
+ *
+ * @param errors - Array of parsed ESLint errors
+ * @returns Deduplicated array of errors
+ */
+function deduplicateESLintErrors(errors) {
+    // Group errors by file:line:column
+    const errorMap = new Map();
+    for (const error of errors) {
+        const key = `${error.file}:${error.line}:${error.column}`;
+        if (!errorMap.has(key)) {
+            errorMap.set(key, []);
+        }
+        const locationErrors = errorMap.get(key);
+        if (locationErrors) {
+            locationErrors.push(error);
+        }
+    }
+    // For each location, pick the best error
+    const deduplicated = [];
+    for (const [_key, locationErrors] of errorMap) {
+        if (locationErrors.length === 1) {
+            deduplicated.push(locationErrors[0]);
+            continue;
+        }
+        // Prefer @typescript-eslint/* rules over base ESLint rules
+        const typescriptEslintError = locationErrors.find(e => e.code?.startsWith('@typescript-eslint/'));
+        if (typescriptEslintError) {
+            deduplicated.push(typescriptEslintError);
+        }
+        else {
+            // No typescript-eslint rule, just take the first one
+            deduplicated.push(locationErrors[0]);
+        }
+    }
+    return deduplicated;
+}
+/**
+ * Format ESLint errors
+ *
+ * Parses ESLint output format: `file:line:col - severity message [rule-name]`
+ *
+ * @param output - Raw ESLint command output
+ * @returns Structured error information with ESLint-specific guidance
+ *
+ * @example
+ * ```typescript
+ * const result = extractESLintErrors(eslintOutput);
+ * console.log(result.summary); // "5 ESLint error(s), 2 warning(s)"
+ * console.log(result.guidance); // "Remove or prefix unused variables with underscore"
+ * ```
+ */
+export function extractESLintErrors(output) {
+    const errors = [];
+    const lines = output.split('\n');
+    let currentFile = '';
+    for (const line of lines) {
+        // Try modern format first: file:line:col: severity message [rule-name]
+        const modernMatch = line.match(/^(.+?):(\d+):(\d+):\s+(error|warning)\s+(.+?)\s+(\S+)$/);
+        if (modernMatch) {
+            const ruleMessage = modernMatch[5].trim();
+            const ruleName = modernMatch[6].replace(/[[\]]/g, ''); // Remove brackets if present
+            errors.push({
+                file: modernMatch[1].trim(),
+                line: parseInt(modernMatch[2]),
+                column: parseInt(modernMatch[3]),
+                severity: modernMatch[4],
+                message: `${ruleMessage} (${ruleName})`,
+                code: ruleName
+            });
+            continue;
+        }
+        // Stylish format: spaces + line:col + spaces + severity + spaces + message + spaces + rule
+        const stylishMatch = line.match(/^\s+(\d+):(\d+)\s+(error|warning)\s+(.+?)\s+(\S+)\s*$/);
+        if (stylishMatch && currentFile) {
+            const ruleMessage = stylishMatch[4].trim();
+            const ruleName = stylishMatch[5];
+            errors.push({
+                file: currentFile,
+                line: parseInt(stylishMatch[1]),
+                column: parseInt(stylishMatch[2]),
+                severity: stylishMatch[3],
+                message: `${ruleMessage} (${ruleName})`,
+                code: ruleName
+            });
+            continue;
+        }
+        // Check if this is a file path line for stylish format (no colons, just a path)
+        if (line && !line.includes(':') && !line.startsWith(' ') && !line.startsWith('\t') && (line.includes('/') || line.includes('\\'))) {
+            // Potential file path for stylish format
+            currentFile = line.trim();
+            continue;
+        }
+    }
+    // Deduplicate errors (prefer @typescript-eslint/* rules over base ESLint rules)
+    const deduplicatedErrors = deduplicateESLintErrors(errors);
+    const errorCount = deduplicatedErrors.filter(e => e.severity === 'error').length;
+    const warningCount = deduplicatedErrors.filter(e => e.severity === 'warning').length;
+    // Build clean output (limit to first 10 for token efficiency)
+    const cleanOutput = deduplicatedErrors
+        .slice(0, 10)
+        .map(e => `${e.file}:${e.line}:${e.column} - ${e.message} [${e.code}]`)
+        .join('\n');
+    return {
+        errors: deduplicatedErrors.slice(0, 10),
+        summary: `${errorCount} ESLint error(s), ${warningCount} warning(s)`,
+        totalCount: deduplicatedErrors.length,
+        guidance: getESLintGuidance(deduplicatedErrors),
+        cleanOutput
+    };
+}
+/**
+ * Generate ESLint-specific guidance based on rule violations
+ *
+ * @param errors - Parsed ESLint errors
+ * @returns Actionable guidance string
+ */
+function getESLintGuidance(errors) {
+    const rules = new Set(errors.map(e => e.code));
+    const guidance = [];
+    if (rules.has('@typescript-eslint/no-unused-vars')) {
+        guidance.push('Remove or prefix unused variables with underscore');
+    }
+    if (rules.has('no-console')) {
+        guidance.push('Replace console.log with logger');
+    }
+    if (guidance.length === 0) {
+        return 'Fix ESLint errors - run with --fix to auto-fix some issues';
+    }
+    return guidance.join('. ');
+}
+//# sourceMappingURL=eslint-extractor.js.map

package/dist/eslint-extractor.js.map

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

package/dist/generic-extractor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generic Error Extractor
+ *
+ * Fallback extractor for unknown validation step types.
+ * Removes npm noise and extracts meaningful error lines.
+ *
+ * @package @vibe-validate/extractors
+ */
+import type { ErrorExtractorResult } from './types.js';
+/**
+ * Generic error extractor (fallback)
+ *
+ * Cleans up command output by:
+ * - Removing npm script headers
+ * - Filtering out npm error lines
+ * - Limiting output to 20 lines for token efficiency
+ *
+ * @param output - Raw command output
+ * @param stepName - Name of validation step (for context)
+ * @returns Structured error information
+ *
+ * @example
+ * ```typescript
+ * const result = extractGenericErrors(buildOutput, 'Build');
+ * console.log(result.summary); // "Build failed - see output"
+ * ```
+ */
+export declare function extractGenericErrors(output: string, stepName: string): ErrorExtractorResult;
+//# sourceMappingURL=generic-extractor.d.ts.map

package/dist/generic-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-extractor.d.ts","sourceRoot":"","sources":["../src/generic-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAqB3F"}

package/dist/generic-extractor.js

@@ -0,0 +1,51 @@
+/**
+ * Generic Error Extractor
+ *
+ * Fallback extractor for unknown validation step types.
+ * Removes npm noise and extracts meaningful error lines.
+ *
+ * @package @vibe-validate/extractors
+ */
+/**
+ * Generic error extractor (fallback)
+ *
+ * Cleans up command output by:
+ * - Removing npm script headers
+ * - Filtering out npm error lines
+ * - Limiting output to 20 lines for token efficiency
+ *
+ * @param output - Raw command output
+ * @param stepName - Name of validation step (for context)
+ * @returns Structured error information
+ *
+ * @example
+ * ```typescript
+ * const result = extractGenericErrors(buildOutput, 'Build');
+ * console.log(result.summary); // "Build failed - see output"
+ * ```
+ */
+export function extractGenericErrors(output, stepName) {
+    // Remove npm script headers and noise
+    const cleaned = output
+        .split('\n')
+        .filter(line => {
+        // Remove npm script noise
+        if (line.startsWith('>'))
+            return false;
+        if (line.includes('npm ERR!'))
+            return false;
+        if (line.trim() === '')
+            return false;
+        return true;
+    })
+        .slice(0, 20) // Limit to 20 lines for token efficiency
+        .join('\n');
+    return {
+        errors: [],
+        summary: `${stepName} failed - see output`,
+        totalCount: 1,
+        guidance: 'Review the output above and fix the errors',
+        cleanOutput: cleaned
+    };
+}
+//# sourceMappingURL=generic-extractor.js.map

package/dist/generic-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-extractor.js","sourceRoot":"","sources":["../src/generic-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,QAAgB;IACnE,sCAAsC;IACtC,MAAM,OAAO,GAAG,MAAM;SACnB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,IAAI,CAAC,EAAE;QACb,0BAA0B;QAC1B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAE,yCAAyC;SACvD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,GAAG,QAAQ,sBAAsB;QAC1C,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,4CAA4C;QACtD,WAAW,EAAE,OAAO;KACrB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @vibe-validate/extractors
+ *
+ * LLM-optimized error extractors for validation output.
+ *
+ * Provides intelligent error parsing and formatting for common development tools:
+ * - TypeScript (tsc)
+ * - ESLint
+ * - Vitest/Jest
+ * - OpenAPI validators
+ * - Generic fallback
+ *
+ * @example
+ * ```typescript
+ * import { extractByStepName } from '@vibe-validate/extractors';
+ *
+ * const result = extractByStepName('TypeScript Type Checking', tscOutput);
+ * console.log(result.summary); // "3 type error(s), 0 warning(s)"
+ * console.log(result.guidance); // "Type mismatch - check variable/parameter types"
+ * console.log(result.cleanOutput); // Clean, formatted error list
+ * ```
+ *
+ * @package @vibe-validate/extractors
+ * @version 0.1.0
+ */
+export type { FormattedError, ErrorExtractorResult, ErrorExtractor } from './types.js';
+export { extractTypeScriptErrors } from './typescript-extractor.js';
+export { extractESLintErrors } from './eslint-extractor.js';
+export { extractVitestErrors } from './vitest-extractor.js';
+export { extractOpenAPIErrors } from './openapi-extractor.js';
+export { extractGenericErrors } from './generic-extractor.js';
+export { extractByStepName } from './smart-extractor.js';
+export { stripAnsiCodes, extractErrorLines } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * @vibe-validate/extractors
+ *
+ * LLM-optimized error extractors for validation output.
+ *
+ * Provides intelligent error parsing and formatting for common development tools:
+ * - TypeScript (tsc)
+ * - ESLint
+ * - Vitest/Jest
+ * - OpenAPI validators
+ * - Generic fallback
+ *
+ * @example
+ * ```typescript
+ * import { extractByStepName } from '@vibe-validate/extractors';
+ *
+ * const result = extractByStepName('TypeScript Type Checking', tscOutput);
+ * console.log(result.summary); // "3 type error(s), 0 warning(s)"
+ * console.log(result.guidance); // "Type mismatch - check variable/parameter types"
+ * console.log(result.cleanOutput); // Clean, formatted error list
+ * ```
+ *
+ * @package @vibe-validate/extractors
+ * @version 0.1.0
+ */
+// Individual extractors (for direct use)
+export { extractTypeScriptErrors } from './typescript-extractor.js';
+export { extractESLintErrors } from './eslint-extractor.js';
+export { extractVitestErrors } from './vitest-extractor.js';
+export { extractOpenAPIErrors } from './openapi-extractor.js';
+export { extractGenericErrors } from './generic-extractor.js';
+// Smart extractor (auto-detection - recommended)
+export { extractByStepName } from './smart-extractor.js';
+// Utilities
+export { stripAnsiCodes, extractErrorLines } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AASH,yCAAyC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,iDAAiD;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/openapi-extractor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * OpenAPI Error Extractor
+ *
+ * Parses and formats OpenAPI specification validation errors for LLM consumption.
+ *
+ * @package @vibe-validate/extractors
+ */
+import type { ErrorExtractorResult } from './types.js';
+/**
+ * Format OpenAPI validation errors
+ *
+ * Extracts error lines from OpenAPI validator output (like Redocly CLI).
+ *
+ * @param output - Raw OpenAPI validator output
+ * @returns Structured error information with OpenAPI-specific guidance
+ *
+ * @example
+ * ```typescript
+ * const result = extractOpenAPIErrors(validatorOutput);
+ * console.log(result.summary); // "5 OpenAPI validation error(s)"
+ * console.log(result.guidance); // "Check openapi.yaml against OpenAPI 3.1 specification"
+ * ```
+ */
+export declare function extractOpenAPIErrors(output: string): ErrorExtractorResult;
+//# sourceMappingURL=openapi-extractor.d.ts.map

package/dist/openapi-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-extractor.d.ts","sourceRoot":"","sources":["../src/openapi-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAezE"}

package/dist/openapi-extractor.js

@@ -0,0 +1,37 @@
+/**
+ * OpenAPI Error Extractor
+ *
+ * Parses and formats OpenAPI specification validation errors for LLM consumption.
+ *
+ * @package @vibe-validate/extractors
+ */
+/**
+ * Format OpenAPI validation errors
+ *
+ * Extracts error lines from OpenAPI validator output (like Redocly CLI).
+ *
+ * @param output - Raw OpenAPI validator output
+ * @returns Structured error information with OpenAPI-specific guidance
+ *
+ * @example
+ * ```typescript
+ * const result = extractOpenAPIErrors(validatorOutput);
+ * console.log(result.summary); // "5 OpenAPI validation error(s)"
+ * console.log(result.guidance); // "Check openapi.yaml against OpenAPI 3.1 specification"
+ * ```
+ */
+export function extractOpenAPIErrors(output) {
+    // OpenAPI errors typically include location in schema
+    const lines = output.split('\n')
+        .filter(line => line.includes('error') || line.includes('Error'))
+        .slice(0, 10);
+    const cleanOutput = lines.join('\n');
+    return {
+        errors: [],
+        summary: `${lines.length} OpenAPI validation error(s)`,
+        totalCount: lines.length,
+        guidance: 'Check openapi.yaml against OpenAPI 3.1 specification',
+        cleanOutput
+    };
+}
+//# sourceMappingURL=openapi-extractor.js.map

package/dist/openapi-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-extractor.js","sourceRoot":"","sources":["../src/openapi-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,sDAAsD;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;SAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SAChE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAErC,OAAO;QACL,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,8BAA8B;QACtD,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,QAAQ,EAAE,sDAAsD;QAChE,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/smart-extractor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Smart Error Extractor
+ *
+ * Auto-detects validation step type and applies appropriate extractor.
+ *
+ * @package @vibe-validate/extractors
+ */
+import type { ErrorExtractorResult } from './types.js';
+/**
+ * Smart extractor - detects step type and applies appropriate formatting
+ *
+ * Auto-detection rules:
+ * - TypeScript: Step name contains "TypeScript" or "typecheck"
+ * - ESLint: Step name contains "ESLint" or "lint"
+ * - Vitest/Jest: Step name contains "test" (but not "OpenAPI")
+ * - OpenAPI: Step name contains "OpenAPI"
+ * - Generic: Fallback for unknown step types
+ *
+ * @param stepName - Name of validation step (used for detection)
+ * @param output - Raw command output
+ * @returns Structured error information from appropriate extractor
+ *
+ * @example
+ * ```typescript
+ * const result = extractByStepName('TypeScript Type Checking', tscOutput);
+ * // Uses extractTypeScriptErrors automatically
+ *
+ * const result2 = extractByStepName('ESLint', eslintOutput);
+ * // Uses extractESLintErrors automatically
+ * ```
+ */
+export declare function extractByStepName(stepName: string, output: string): ErrorExtractorResult;
+//# sourceMappingURL=smart-extractor.d.ts.map

package/dist/smart-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-extractor.d.ts","sourceRoot":"","sources":["../src/smart-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAOvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAoBxF"}

package/dist/smart-extractor.js

@@ -0,0 +1,52 @@
+/**
+ * Smart Error Extractor
+ *
+ * Auto-detects validation step type and applies appropriate extractor.
+ *
+ * @package @vibe-validate/extractors
+ */
+import { extractTypeScriptErrors } from './typescript-extractor.js';
+import { extractESLintErrors } from './eslint-extractor.js';
+import { extractVitestErrors } from './vitest-extractor.js';
+import { extractOpenAPIErrors } from './openapi-extractor.js';
+import { extractGenericErrors } from './generic-extractor.js';
+/**
+ * Smart extractor - detects step type and applies appropriate formatting
+ *
+ * Auto-detection rules:
+ * - TypeScript: Step name contains "TypeScript" or "typecheck"
+ * - ESLint: Step name contains "ESLint" or "lint"
+ * - Vitest/Jest: Step name contains "test" (but not "OpenAPI")
+ * - OpenAPI: Step name contains "OpenAPI"
+ * - Generic: Fallback for unknown step types
+ *
+ * @param stepName - Name of validation step (used for detection)
+ * @param output - Raw command output
+ * @returns Structured error information from appropriate extractor
+ *
+ * @example
+ * ```typescript
+ * const result = extractByStepName('TypeScript Type Checking', tscOutput);
+ * // Uses extractTypeScriptErrors automatically
+ *
+ * const result2 = extractByStepName('ESLint', eslintOutput);
+ * // Uses extractESLintErrors automatically
+ * ```
+ */
+export function extractByStepName(stepName, output) {
+    const lowerStepName = stepName.toLowerCase();
+    if (lowerStepName.includes('typescript') || lowerStepName.includes('typecheck') || lowerStepName.includes('tsc')) {
+        return extractTypeScriptErrors(output);
+    }
+    if (lowerStepName.includes('eslint') || lowerStepName.includes('lint')) {
+        return extractESLintErrors(output);
+    }
+    if (lowerStepName.includes('test') && !lowerStepName.includes('openapi')) {
+        return extractVitestErrors(output);
+    }
+    if (lowerStepName.includes('openapi')) {
+        return extractOpenAPIErrors(output);
+    }
+    return extractGenericErrors(output, stepName);
+}
+//# sourceMappingURL=smart-extractor.js.map

package/dist/smart-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-extractor.js","sourceRoot":"","sources":["../src/smart-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,MAAc;IAChE,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAE7C,IAAI,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACjH,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACvE,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACzE,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC"}