ai-sdlc 0.2.0 → 0.2.1-alpha.1

package/dist/core/task-progress.js

@@ -0,0 +1,280 @@
+/**
+ * Task progress tracking for resumable implementations
+ *
+ * Persists task-level progress in story files as markdown tables,
+ * enabling orchestrator to resume from last completed task after interruptions.
+ */
+import fs from 'fs';
+import path from 'path';
+import writeFileAtomic from 'write-file-atomic';
+const TASK_PROGRESS_SECTION = '## Task Progress';
+/**
+ * Parse progress table from markdown content
+ *
+ * Expected format:
+ * ## Task Progress
+ *
+ * | Task | Status | Started | Completed |
+ * |------|--------|---------|-----------|
+ * | T1 | completed | 2026-01-16T10:00:00Z | 2026-01-16T10:05:00Z |
+ * | T2 | in_progress | 2026-01-16T10:05:30Z | - |
+ *
+ * @param content - Story file markdown content
+ * @returns Array of TaskProgress objects (empty if section missing or corrupted)
+ */
+export function parseProgressTable(content) {
+    const sectionIndex = content.indexOf(TASK_PROGRESS_SECTION);
+    if (sectionIndex === -1) {
+        return [];
+    }
+    // Find the table rows (skip header and separator)
+    const afterSection = content.slice(sectionIndex);
+    const lines = afterSection.split('\n');
+    const taskProgress = [];
+    let foundTable = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip section header, empty lines, and markdown table separator
+        if (!trimmed || trimmed.startsWith('#') || trimmed.match(/^\|[\s-:|]+\|$/)) {
+            continue;
+        }
+        // Stop at next section
+        if (trimmed.startsWith('##') && !trimmed.includes(TASK_PROGRESS_SECTION)) {
+            break;
+        }
+        // Parse table row
+        if (trimmed.startsWith('|')) {
+            foundTable = true;
+            const cells = trimmed
+                .split('|')
+                .map(cell => cell.trim())
+                .filter(cell => cell.length > 0);
+            // Skip header row
+            if (cells[0] === 'Task' || cells[1] === 'Status') {
+                continue;
+            }
+            // Validate we have at least 4 columns
+            if (cells.length < 4) {
+                console.warn(`[task-progress] Skipping malformed table row: ${trimmed}`);
+                continue;
+            }
+            const [taskId, statusStr, startedStr, completedStr] = cells;
+            // Validate status
+            const validStatuses = ['pending', 'in_progress', 'completed', 'failed'];
+            if (!validStatuses.includes(statusStr)) {
+                console.warn(`[task-progress] Invalid status '${statusStr}' for task ${taskId}, skipping row`);
+                continue;
+            }
+            const progress = {
+                taskId,
+                status: statusStr,
+            };
+            // Parse timestamps (handle "-" as missing)
+            if (startedStr && startedStr !== '-') {
+                progress.startedAt = startedStr;
+            }
+            if (completedStr && completedStr !== '-') {
+                progress.completedAt = completedStr;
+            }
+            // Handle error column if present (5th column)
+            if (cells.length >= 5 && cells[4] && cells[4] !== '-') {
+                progress.error = cells[4];
+            }
+            taskProgress.push(progress);
+        }
+    }
+    if (foundTable && taskProgress.length === 0) {
+        console.warn('[task-progress] Found progress table but no valid task rows, table may be corrupted');
+    }
+    return taskProgress;
+}
+/**
+ * Generate markdown table from TaskProgress array
+ *
+ * @param progress - Array of task progress entries
+ * @returns Markdown table string
+ */
+export function generateProgressTable(progress) {
+    const rows = [];
+    // Header
+    rows.push('| Task | Status | Started | Completed |');
+    rows.push('|------|--------|---------|-----------|');
+    // Task rows
+    for (const task of progress) {
+        const started = task.startedAt || '-';
+        const completed = task.completedAt || '-';
+        rows.push(`| ${task.taskId} | ${task.status} | ${started} | ${completed} |`);
+    }
+    return rows.join('\n');
+}
+/**
+ * Read story file content
+ *
+ * @param storyPath - Absolute path to story.md file
+ * @returns Story file content
+ * @throws Error if file doesn't exist or can't be read
+ */
+export async function readStoryFile(storyPath) {
+    try {
+        return await fs.promises.readFile(storyPath, 'utf-8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Story file not found: ${path.basename(storyPath)}`);
+        }
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            throw new Error(`Permission denied reading story file: ${path.basename(storyPath)}`);
+        }
+        throw new Error(`Failed to read story file: ${error.message}`);
+    }
+}
+/**
+ * Write story file content atomically with retry logic
+ *
+ * @param storyPath - Absolute path to story.md file
+ * @param content - New story content
+ * @throws Error after all retries exhausted
+ */
+export async function writeStoryFile(storyPath, content) {
+    const maxRetries = 3;
+    const retryDelays = [100, 200, 400]; // Exponential backoff
+    // Ensure parent directory exists first (outside retry loop)
+    const storyDir = path.dirname(storyPath);
+    await fs.promises.mkdir(storyDir, { recursive: true });
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        try {
+            // Atomic write
+            await writeFileAtomic(storyPath, content, { encoding: 'utf-8' });
+            return; // Success
+        }
+        catch (error) {
+            const isLastAttempt = attempt === maxRetries - 1;
+            // Don't retry on permission errors - throw immediately
+            if (error.code === 'EACCES' || error.code === 'EPERM') {
+                throw new Error(`Permission denied writing story file: ${path.basename(storyPath)}`);
+            }
+            if (isLastAttempt) {
+                throw new Error(`Failed to write story file after ${maxRetries} attempts`);
+            }
+            // Wait before retry
+            await new Promise(resolve => setTimeout(resolve, retryDelays[attempt]));
+        }
+    }
+}
+/**
+ * Get all task progress entries from story file
+ *
+ * @param storyPath - Absolute path to story.md file
+ * @returns Array of TaskProgress objects (empty if section missing)
+ */
+export async function getTaskProgress(storyPath) {
+    const content = await readStoryFile(storyPath);
+    return parseProgressTable(content);
+}
+/**
+ * Initialize progress tracking for a list of tasks
+ *
+ * Creates "## Task Progress" section with all tasks in 'pending' status.
+ * If section already exists, logs warning and skips initialization.
+ *
+ * @param storyPath - Absolute path to story.md file
+ * @param taskIds - Array of task IDs (e.g., ['T1', 'T2', 'T3'])
+ */
+export async function initializeTaskProgress(storyPath, taskIds) {
+    const content = await readStoryFile(storyPath);
+    // Check if progress section already exists
+    if (content.includes(TASK_PROGRESS_SECTION)) {
+        console.warn('[task-progress] Progress section already exists, skipping initialization');
+        return;
+    }
+    // Create initial progress entries (all pending)
+    const progress = taskIds.map(taskId => ({
+        taskId,
+        status: 'pending',
+    }));
+    const progressTable = generateProgressTable(progress);
+    const progressSection = `\n${TASK_PROGRESS_SECTION}\n\n${progressTable}\n`;
+    // Append to end of file
+    const newContent = content.trimEnd() + '\n' + progressSection;
+    await writeStoryFile(storyPath, newContent);
+}
+/**
+ * Update a specific task's status and timestamps
+ *
+ * Modifies the task row in the progress table and writes back to disk atomically.
+ * Sets timestamps based on status transitions:
+ * - 'in_progress': Sets startedAt (if not already set)
+ * - 'completed' or 'failed': Sets completedAt
+ *
+ * @param storyPath - Absolute path to story.md file
+ * @param taskId - Task ID to update (e.g., 'T1')
+ * @param status - New status
+ * @param error - Optional error message (only used with 'failed' status)
+ * @throws Error if task not found in progress table
+ */
+export async function updateTaskProgress(storyPath, taskId, status, error) {
+    const content = await readStoryFile(storyPath);
+    const progress = parseProgressTable(content);
+    // Find task to update
+    const taskIndex = progress.findIndex(t => t.taskId === taskId);
+    if (taskIndex === -1) {
+        throw new Error(`Task ${taskId} not found in progress table`);
+    }
+    const task = progress[taskIndex];
+    const now = new Date().toISOString();
+    // Update status
+    task.status = status;
+    // Set timestamps based on status transition
+    if (status === 'in_progress' && !task.startedAt) {
+        task.startedAt = now;
+    }
+    if (status === 'completed' || status === 'failed') {
+        task.completedAt = now;
+    }
+    // Store error message if provided
+    if (error) {
+        task.error = error;
+    }
+    // Regenerate table
+    const newTable = generateProgressTable(progress);
+    // Replace progress section in content
+    const sectionIndex = content.indexOf(TASK_PROGRESS_SECTION);
+    if (sectionIndex === -1) {
+        throw new Error('Progress section disappeared during update, this should not happen');
+    }
+    // Find next section or end of file
+    const afterSection = content.slice(sectionIndex + TASK_PROGRESS_SECTION.length);
+    const nextSectionMatch = afterSection.match(/\n## [^#]/);
+    const nextSectionOffset = nextSectionMatch
+        ? sectionIndex + TASK_PROGRESS_SECTION.length + nextSectionMatch.index
+        : content.length;
+    // Rebuild content
+    const beforeSection = content.slice(0, sectionIndex);
+    const afterNextSection = content.slice(nextSectionOffset);
+    const newContent = `${beforeSection}${TASK_PROGRESS_SECTION}\n\n${newTable}\n${afterNextSection}`;
+    await writeStoryFile(storyPath, newContent);
+}
+/**
+ * Get list of task IDs with status 'pending'
+ *
+ * @param storyPath - Absolute path to story.md file
+ * @returns Array of pending task IDs
+ */
+export async function getPendingTasks(storyPath) {
+    const progress = await getTaskProgress(storyPath);
+    return progress
+        .filter(task => task.status === 'pending')
+        .map(task => task.taskId);
+}
+/**
+ * Get the task ID currently in 'in_progress' status
+ *
+ * @param storyPath - Absolute path to story.md file
+ * @returns Task ID or null if no task is in progress
+ */
+export async function getCurrentTask(storyPath) {
+    const progress = await getTaskProgress(storyPath);
+    const currentTask = progress.find(task => task.status === 'in_progress');
+    return currentTask ? currentTask.taskId : null;
+}
+//# sourceMappingURL=task-progress.js.map

package/dist/core/task-progress.js.map

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

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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"}