@uluops/core 0.8.2 → 0.10.0

package/dist/parser/OutputExtractor.d.ts

@@ -1,12 +1,17 @@
 import type { AgentType } from '../types/execution.js';
 import type { ParsedOutput, ExtractionOptions, ExtractionResult } from '../types/parser.js';
 /**
- * Extracts structured output from LLM responses using a 3-strategy fallback:
- * 1. JSON code fence (highest confidence)
+ * Extracts structured output from LLM responses using a 4-strategy fallback:
+ * 0. AI SDK structured output (highest confidence — schema-validated by the SDK)
+ * 1. JSON code fence
  * 2. Inline JSON detection
  * 3. Structured text pattern matching (lowest confidence)
+ *
+ * Normalization of parsed JSON into the unified ParsedOutput type is delegated
+ * to OutputNormalizer, which handles the diversity of LLM output shapes.
  */
 export declare class OutputExtractor {
+    private normalizer;
     private static readonly INLINE_JSON_PATTERN;
     private static readonly STRUCTURED_PATTERNS;
     /**
@@ -25,28 +30,5 @@ export declare class OutputExtractor {
     private extractIssuesFromText;
     private inferPriorityFromContext;
     private inferSeverityFromContext;
-    /** Resolved source objects from common nesting patterns. Reduces parameter passing across resolve methods. */
-    private buildParseSources;
-    private normalizeOutput;
-    private resolveAgentFields;
-    private attachFlatIssues;
-    private asRecord;
-    /**
-     * Scan all top-level object values for one that contains 'score' or 'decision'.
-     * Handles arbitrary wrapper names (validation, validations, validationResults, etc.)
-     * without whitelisting specific field names.
-     */
-    private findWrapperWithScoreOrDecision;
-    private resolveDecisionField;
-    private resolveScoreField;
-    private resolveCategories;
-    private resolveIssuesFlat;
-    private normalizeDecision;
-    private parseCategories;
-    private parseFindings;
-    private parseIssues;
-    private parseArtifacts;
-    private normalizePriority;
-    private normalizeSeverity;
 }
 //# sourceMappingURL=OutputExtractor.d.ts.map

package/dist/parser/OutputExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OutputExtractor.d.ts","sourceRoot":"","sources":["../../src/parser/OutputExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EACV,YAAY,EAGZ,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAG5B;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAyD;IACpG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAazC;IAEF;;OAEG;IACH,OAAO,CACL,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,iBAAsB,GAC9B,YAAY;IAKf;;OAEG;IACH,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB;IAoEnB,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,iBAAiB;IAoDzB,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,yBAAyB;IA0DjC,OAAO,CAAC,qBAAqB;IAwB7B,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,wBAAwB;IAQhC,8GAA8G;IAC9G,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,gBAAgB;IAmCxB,OAAO,CAAC,QAAQ;IAMhB;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IAgBtC,OAAO,CAAC,oBAAoB;IAqC5B,OAAO,CAAC,iBAAiB;IA8DzB,OAAO,CAAC,iBAAiB;IA8EzB,OAAO,CAAC,iBAAiB;IAiDzB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,WAAW;IAmGnB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,iBAAiB;CAQ1B"}
+{"version":3,"file":"OutputExtractor.d.ts","sourceRoot":"","sources":["../../src/parser/OutputExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAI5B;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAA0B;IAE5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAyD;IACpG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAazC;IAEF;;OAEG;IACH,OAAO,CACL,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,iBAAsB,GAC9B,YAAY;IAKf;;OAEG;IACH,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB;IAgFnB,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,iBAAiB;IAoDzB,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,yBAAyB;IA0DjC,OAAO,CAAC,qBAAqB;IAwB7B,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,wBAAwB;CAOjC"}

package/dist/parser/OutputExtractor.js

@@ -1,11 +1,17 @@
 import { ParseError } from '../errors/index.js';
+import { OutputNormalizer } from './OutputNormalizer.js';
 /**
- * Extracts structured output from LLM responses using a 3-strategy fallback:
- * 1. JSON code fence (highest confidence)
+ * Extracts structured output from LLM responses using a 4-strategy fallback:
+ * 0. AI SDK structured output (highest confidence — schema-validated by the SDK)
+ * 1. JSON code fence
  * 2. Inline JSON detection
  * 3. Structured text pattern matching (lowest confidence)
+ *
+ * Normalization of parsed JSON into the unified ParsedOutput type is delegated
+ * to OutputNormalizer, which handles the diversity of LLM output shapes.
  */
 export class OutputExtractor {
+    normalizer = new OutputNormalizer();
     static INLINE_JSON_PATTERN = /\{[\s\S]*?(?:"decision"|"status"|"score")[\s\S]*?\}/;
     static STRUCTURED_PATTERNS = {
         decision: /(?:decision|status|result)\s*[:=]\s*["']?(\w+)["']?/i,
@@ -33,11 +39,22 @@ export class OutputExtractor {
      */
     extractWithMetadata(content, agentType, options = {}) {
         const warnings = [];
+        // ── Extraction strategies (ordered by confidence) ──────────────────────
+        // Confidence values are heuristics encoding relative trust in each method.
+        // They were calibrated against Claude's output patterns and may need
+        // recalibration as new models (GPT, Gemini) are added. The 0.7 threshold
+        // in AgentExecutor gates EXTRACTION_FAILED decisions — any strategy below
+        // that threshold produces results that won't be trusted as real decisions.
+        //
+        // Strategy 1: JSON code fence (0.95) — model explicitly wrapped output
+        // Strategy 2: Whole/inline JSON (0.9/0.75) — found parseable JSON in text
+        // Strategy 3: Structured text (0.5) — regex matched decision/score patterns
+        // Strategy 4: Fallback (0.0) — nothing found, emit ERROR/0 defaults
         // Strategy 1: Try JSON code fence (highest confidence)
         const fenceResult = this.extractFromCodeFence(content, options);
         if (fenceResult) {
             return {
-                output: this.normalizeOutput(fenceResult, agentType),
+                output: this.normalizer.normalizeOutput(fenceResult, agentType),
                 method: 'json_code_fence',
                 confidence: 0.95,
                 warnings,
@@ -47,7 +64,7 @@ export class OutputExtractor {
         const wholeJsonResult = this.extractWholeJson(content);
         if (wholeJsonResult) {
             return {
-                output: this.normalizeOutput(wholeJsonResult, agentType),
+                output: this.normalizer.normalizeOutput(wholeJsonResult, agentType),
                 method: 'inline_json',
                 confidence: 0.9,
                 warnings,
@@ -58,7 +75,7 @@ export class OutputExtractor {
         if (inlineResult) {
             warnings.push('Extracted from inline JSON - consider using code fence for reliability');
             return {
-                output: this.normalizeOutput(inlineResult, agentType),
+                output: this.normalizer.normalizeOutput(inlineResult, agentType),
                 method: 'inline_json',
                 confidence: 0.75,
                 warnings,
@@ -215,7 +232,7 @@ export class OutputExtractor {
         }
         const output = {
             decision: decisionMatch
-                ? this.normalizeDecision(decisionMatch[1] ?? '', agentType)
+                ? this.normalizer.normalizeDecision(decisionMatch[1] ?? '', agentType)
                 : 'UNKNOWN',
         };
         if (scoreMatch?.[1]) {
@@ -291,527 +308,5 @@ export class OutputExtractor {
             return 'low';
         return 'medium';
     }
-    /** Resolved source objects from common nesting patterns. Reduces parameter passing across resolve methods. */
-    buildParseSources(obj) {
-        const result = this.asRecord(obj['result']);
-        const summary = this.asRecord(obj['summary']) ?? this.asRecord(result?.['summary']);
-        const report = this.asRecord(obj['report']);
-        const reportResults = this.asRecord(report?.['results']) ?? this.asRecord(obj['results']);
-        const reportSummary = this.asRecord(report?.['summary']) ?? this.asRecord(reportResults?.['summary']);
-        const validationSummary = this.findWrapperWithScoreOrDecision(obj);
-        return { obj, result, summary, report, reportResults, reportSummary, validationSummary };
-    }
-    normalizeOutput(raw, agentType) {
-        if (!raw || typeof raw !== 'object') {
-            return { decision: 'ERROR' };
-        }
-        const obj = raw;
-        const sources = this.buildParseSources(obj);
-        const output = {
-            decision: this.normalizeDecision(this.resolveDecisionField(sources), agentType),
-            rawJson: raw,
-        };
-        // Resolve score
-        const rawScore = this.resolveScoreField(sources);
-        if (typeof rawScore === 'number') {
-            output.score = rawScore;
-        }
-        else if (typeof rawScore === 'string') {
-            output.score = parseFloat(rawScore);
-        }
-        this.resolveAgentFields(output, sources);
-        if (Array.isArray(obj['artifacts'])) {
-            output.artifacts = this.parseArtifacts(obj['artifacts']);
-        }
-        return output;
-    }
-    resolveAgentFields(output, sources) {
-        const { obj, result, summary, report } = sources;
-        // Resolve maxScore
-        const rawMaxScore = obj['maxScore'] ?? obj['max_score']
-            ?? result?.['max_score'] ?? result?.['maxScore']
-            ?? summary?.['max_score'] ?? summary?.['maxScore']
-            ?? obj['pass_threshold'];
-        if (typeof rawMaxScore === 'number') {
-            output.maxScore = rawMaxScore;
-        }
-        else if (typeof rawMaxScore === 'string') {
-            output.maxScore = parseInt(rawMaxScore, 10);
-        }
-        // Resolve categories
-        output.categories = this.resolveCategories(obj, result, report);
-        // If no score found but categories exist, sum category scores
-        if (output.score === undefined && output.categories && output.categories.length > 0) {
-            output.score = output.categories.reduce((sum, c) => sum + c.score, 0);
-        }
-        // Resolve flat issues and attach to categories
-        this.attachFlatIssues(output, sources);
-    }
-    attachFlatIssues(output, sources) {
-        const flatIssues = this.resolveIssuesFlat(sources.obj, sources.result, sources.report, sources.validationSummary);
-        if (flatIssues.length === 0)
-            return;
-        const issuesFinding = {
-            criterion: 'Extracted findings',
-            pointsEarned: 0,
-            pointsPossible: 0,
-            issues: flatIssues,
-        };
-        if (!output.categories || output.categories.length === 0) {
-            output.categories = [{
-                    name: 'Extracted Issues',
-                    score: output.score ?? 0,
-                    maxScore: output.maxScore ?? 100,
-                    findings: [issuesFinding],
-                }];
-        }
-        else {
-            const emptyCategory = output.categories.find(c => c.findings.length === 0);
-            if (emptyCategory) {
-                emptyCategory.findings.push(issuesFinding);
-            }
-            else {
-                output.categories.push({
-                    name: 'Extracted Issues',
-                    score: output.score ?? 0,
-                    maxScore: output.maxScore ?? 100,
-                    findings: [issuesFinding],
-                });
-            }
-        }
-    }
-    asRecord(value) {
-        return (value && typeof value === 'object' && !Array.isArray(value))
-            ? value
-            : undefined;
-    }
-    /**
-     * Scan all top-level object values for one that contains 'score' or 'decision'.
-     * Handles arbitrary wrapper names (validation, validations, validationResults, etc.)
-     * without whitelisting specific field names.
-     */
-    findWrapperWithScoreOrDecision(obj) {
-        // Skip known non-wrapper fields
-        const skip = new Set(['issues', 'categories', 'recommendations', 'evidence',
-            'reasoning', 'reasoning_trace', 'notes', 'auto_fail_conditions', 'filesReviewed',
-            'files_reviewed', 'artifacts', 'result', 'summary', 'report']);
-        for (const [key, value] of Object.entries(obj)) {
-            if (skip.has(key))
-                continue;
-            const rec = this.asRecord(value);
-            if (!rec)
-                continue;
-            if ('score' in rec || 'score_total' in rec || 'total_score' in rec || 'decision' in rec || 'status' in rec || 'breakdown' in rec || 'score_breakdown' in rec) {
-                return rec;
-            }
-        }
-        return undefined;
-    }
-    resolveDecisionField(ctx) {
-        const { obj } = ctx;
-        const sources = [ctx.obj, ctx.summary, ctx.result, ctx.report, ctx.reportResults, ctx.reportSummary, ctx.validationSummary];
-        // Check each source for decision/final_decision fields
-        for (const source of sources) {
-            if (!source)
-                continue;
-            for (const key of ['decision', 'final_decision']) {
-                const d = source[key];
-                if (typeof d === 'string')
-                    return d;
-                // Handle decision as object: { pass: true, label: "PASS" } or { result: "PASS" }
-                if (d && typeof d === 'object') {
-                    const dObj = d;
-                    if (typeof dObj['result'] === 'string')
-                        return dObj['result'];
-                    if (typeof dObj['label'] === 'string')
-                        return dObj['label'];
-                    if (typeof dObj['value'] === 'string')
-                        return dObj['value'];
-                    if (typeof dObj['status'] === 'string')
-                        return dObj['status'];
-                    if (typeof dObj['pass'] === 'boolean')
-                        return dObj['pass'] ? 'PASS' : 'FAIL';
-                }
-            }
-        }
-        // Fallback to status field
-        for (const source of sources) {
-            if (!source)
-                continue;
-            if (typeof source['status'] === 'string')
-                return source['status'];
-        }
-        // Fallback: check if summary is a string starting with a decision word
-        if (typeof obj['summary'] === 'string') {
-            const summaryFirst = obj['summary'].split(/[\s\-–—]+/)[0]?.toUpperCase();
-            if (summaryFirst && ['PASS', 'FAIL', 'WARN', 'ERROR', 'COMPLETE'].includes(summaryFirst)) {
-                return summaryFirst;
-            }
-        }
-        return 'UNKNOWN';
-    }
-    resolveScoreField(ctx) {
-        const { obj } = ctx;
-        const sources = [ctx.obj, ctx.summary, ctx.result, ctx.report, ctx.reportResults, ctx.reportSummary, ctx.validationSummary];
-        // Check each source for a score value
-        for (const source of sources) {
-            if (!source)
-                continue;
-            for (const scoreKey of ['score', 'total_score', 'score_total']) {
-                const s = source[scoreKey];
-                if (typeof s === 'number')
-                    return s;
-                if (typeof s === 'string' && s.trim() !== '' && !isNaN(Number(s)))
-                    return s;
-                // Handle score as object: { total: 85, ... }
-                if (s && typeof s === 'object') {
-                    const sObj = s;
-                    for (const key of ['total', 'value', 'overall', 'final']) {
-                        if (typeof sObj[key] === 'number')
-                            return sObj[key];
-                        if (typeof sObj[key] === 'string')
-                            return sObj[key];
-                    }
-                }
-            }
-        }
-        // Note: validationSummary (from findWrapperWithScoreOrDecision) is already in the sources loop above.
-        // Check scores object with named sub-scores (gpt-4.1-nano shape: { scores: { "Code Quality": 23, ... } })
-        const scores = this.asRecord(obj['scores']);
-        if (scores) {
-            if (typeof scores['Total'] === 'number')
-                return scores['Total'];
-            if (typeof scores['total'] === 'number')
-                return scores['total'];
-        }
-        // Check breakdown with sub-scores sum (search wrapper objects too)
-        const wrapper = this.findWrapperWithScoreOrDecision(obj);
-        const breakdown = this.asRecord(obj['breakdown'])
-            ?? this.asRecord(obj['score_breakdown'])
-            ?? this.asRecord(wrapper?.['breakdown'])
-            ?? this.asRecord(wrapper?.['score_breakdown']);
-        if (breakdown) {
-            const values = [];
-            for (const v of Object.values(breakdown)) {
-                if (typeof v === 'number') {
-                    values.push(v);
-                    continue;
-                }
-                // Handle { points: N, deductions: N } shape
-                const rec = this.asRecord(v);
-                if (rec && typeof rec['points'] === 'number') {
-                    const deductions = typeof rec['deductions'] === 'number' ? rec['deductions'] : 0;
-                    values.push(rec['points'] - deductions);
-                }
-            }
-            if (values.length > 0)
-                return values.reduce((a, b) => a + b, 0);
-        }
-        // Check criteria with sub-scores sum (gpt-4.1-nano shape)
-        const criteria = this.asRecord(obj['criteria']);
-        if (criteria) {
-            const values = [];
-            for (const v of Object.values(criteria)) {
-                if (typeof v === 'number') {
-                    values.push(v);
-                    continue;
-                }
-                const rec = this.asRecord(v);
-                if (rec && typeof rec['score'] === 'number')
-                    values.push(rec['score']);
-            }
-            if (values.length > 0)
-                return values.reduce((a, b) => a + b, 0);
-        }
-        return undefined;
-    }
-    resolveCategories(obj, result, report) {
-        // Direct categories array
-        for (const source of [obj, result, report]) {
-            if (!source)
-                continue;
-            if (Array.isArray(source['categories'])) {
-                return this.parseCategories(source['categories']);
-            }
-        }
-        // Named scores object → synthetic categories (e.g., { scores: { "Code Quality": 23, ... } })
-        const scores = this.asRecord(obj['scores']) ?? this.asRecord(report?.['scores']);
-        if (scores) {
-            const cats = [];
-            for (const [name, value] of Object.entries(scores)) {
-                if (typeof value === 'number' && name !== 'Total' && name !== 'total' && name !== 'pass_threshold') {
-                    cats.push({ name, score: value, maxScore: 100, findings: [] });
-                }
-            }
-            if (cats.length > 0)
-                return cats;
-        }
-        // Breakdown object → synthetic categories
-        // Search top-level breakdown, score_breakdown, and inside any wrapper object
-        const wrapper = this.findWrapperWithScoreOrDecision(obj);
-        const breakdown = this.asRecord(obj['breakdown'])
-            ?? this.asRecord(obj['score_breakdown'])
-            ?? this.asRecord(wrapper?.['breakdown'])
-            ?? this.asRecord(wrapper?.['score_breakdown']);
-        if (breakdown) {
-            const cats = [];
-            for (const [name, value] of Object.entries(breakdown)) {
-                if (typeof value === 'number') {
-                    cats.push({ name, score: value, maxScore: 100, findings: [] });
-                }
-                else {
-                    // Handle { points: N, deductions: N } shape
-                    const rec = this.asRecord(value);
-                    if (rec && typeof rec['points'] === 'number') {
-                        const points = rec['points'];
-                        const deductions = typeof rec['deductions'] === 'number' ? rec['deductions'] : 0;
-                        cats.push({ name, score: points - deductions, maxScore: 100, findings: [] });
-                    }
-                }
-            }
-            if (cats.length > 0)
-                return cats;
-        }
-        // Criteria object with nested scores → synthetic categories
-        const criteria = this.asRecord(obj['criteria']);
-        if (criteria) {
-            const cats = [];
-            for (const [name, value] of Object.entries(criteria)) {
-                const rec = this.asRecord(value);
-                if (rec && typeof rec['score'] === 'number') {
-                    cats.push({
-                        name,
-                        score: rec['score'],
-                        maxScore: 100,
-                        findings: this.parseIssues(Array.isArray(rec['issues']) ? rec['issues'] : []).map(issue => ({
-                            criterion: issue.title,
-                            pointsEarned: 0,
-                            pointsPossible: 0,
-                            issues: [issue],
-                        })),
-                    });
-                }
-            }
-            if (cats.length > 0)
-                return cats;
-        }
-        return undefined;
-    }
-    resolveIssuesFlat(obj, result, report, wrapper) {
-        const issues = [];
-        // Check multiple issue-like keys across all source objects
-        const issueKeys = ['issues', 'recommendations', 'warnings', 'findings'];
-        for (const source of [obj, result, report, wrapper]) {
-            if (!source)
-                continue;
-            for (const key of issueKeys) {
-                if (Array.isArray(source[key])) {
-                    issues.push(...this.parseIssues(source[key]));
-                    if (issues.length > 0)
-                        return issues;
-                }
-                // Nested: { issues: { items: [...] } } or { issues: { details: [...] } }
-                const nested = this.asRecord(source[key]);
-                if (nested) {
-                    const nestedArray = nested['items'] ?? nested['details'] ?? nested['list'];
-                    if (Array.isArray(nestedArray)) {
-                        issues.push(...this.parseIssues(nestedArray));
-                        if (issues.length > 0)
-                            return issues;
-                    }
-                }
-            }
-        }
-        // issues_found with warnings/suggestions (gpt-5-mini shape)
-        for (const source of [obj, wrapper]) {
-            if (!source)
-                continue;
-            const issuesFound = this.asRecord(source['issues_found']);
-            if (issuesFound) {
-                if (Array.isArray(issuesFound['critical'])) {
-                    issues.push(...this.parseIssues(issuesFound['critical']));
-                }
-                if (Array.isArray(issuesFound['warnings'])) {
-                    issues.push(...this.parseIssues(issuesFound['warnings']));
-                }
-                if (Array.isArray(issuesFound['suggestions'])) {
-                    issues.push(...this.parseIssues(issuesFound['suggestions']));
-                }
-            }
-        }
-        return issues;
-    }
-    normalizeDecision(decision, agentType) {
-        // Strip emojis and non-ASCII symbols before processing
-        const cleaned = decision.replace(/[\u{1F000}-\u{1FFFF}]|[\u{2600}-\u{27BF}]|[\u{FE00}-\u{FE0F}]|[\u{200D}]/gu, '').trim();
-        const upper = cleaned.toUpperCase().trim();
-        // Extract first word for labels like "PASS - Ready for next phase"
-        const firstWord = upper.split(/[\s\-–—]+/)[0] ?? upper;
-        if (agentType === 'validator') {
-            if (['PASS', 'PASSED', 'OK', 'SUCCESS'].includes(firstWord))
-                return 'PASS';
-            if (['WARN', 'WARNING', 'CAUTION'].includes(firstWord))
-                return 'WARN';
-            if (['FAIL', 'FAILED', 'ERROR', 'REJECT'].includes(firstWord))
-                return 'FAIL';
-        }
-        if (agentType === 'executor') {
-            if (['SUCCESS', 'COMPLETE', 'DONE', 'PASS'].includes(firstWord))
-                return 'COMPLETE';
-            if (['PARTIAL', 'INCOMPLETE'].includes(firstWord))
-                return 'PARTIAL';
-            if (['FAIL', 'FAILED', 'ERROR'].includes(firstWord))
-                return 'FAILED';
-        }
-        return upper;
-    }
-    parseCategories(raw) {
-        return raw
-            .filter((item) => typeof item === 'object' && item !== null)
-            .map(item => ({
-            name: String(item['name'] ?? item['category'] ?? 'Unknown'),
-            score: Number(item['score'] ?? item['points'] ?? 0),
-            maxScore: Number(item['maxScore'] ?? item['maxPoints'] ?? item['max_points'] ?? item['total'] ?? 100),
-            findings: this.parseFindings(Array.isArray(item['findings']) ? item['findings'] : []),
-        }));
-    }
-    parseFindings(raw) {
-        return raw
-            .filter((item) => typeof item === 'object' && item !== null)
-            .map(item => ({
-            criterion: String(item['criterion'] ?? item['name'] ?? 'Unknown'),
-            pointsEarned: Number(item['pointsEarned'] ?? item['points_earned'] ?? item['score'] ?? 0),
-            pointsPossible: Number(item['pointsPossible'] ?? item['points_possible'] ?? item['maxScore'] ?? item['maxPoints'] ?? 0),
-            issues: this.parseIssues(Array.isArray(item['issues']) ? item['issues'] : []),
-        }));
-    }
-    parseIssues(raw) {
-        // Flatten grouped issues: [{severity: "CRITICAL", issues: [...]}, ...] → flat array
-        const flatItems = [];
-        for (const item of raw) {
-            if (typeof item !== 'object' || item === null)
-                continue;
-            const rec = item;
-            if (Array.isArray(rec['issues'])) {
-                // This is a group — recurse into the nested issues array, inheriting severity
-                const groupSeverity = rec['severity'];
-                for (const sub of rec['issues']) {
-                    if (typeof sub === 'object' && sub !== null) {
-                        const subRec = sub;
-                        if (groupSeverity && !subRec['severity'])
-                            subRec['severity'] = groupSeverity;
-                        flatItems.push(subRec);
-                    }
-                }
-            }
-            else {
-                flatItems.push(rec);
-            }
-        }
-        return flatItems
-            .map(item => {
-            // Resolve file path and line number from various shapes
-            let filePath = item['filePath']
-                ?? item['file_path']
-                ?? item['file'];
-            let lineNumber = typeof item['lineNumber'] === 'number'
-                ? item['lineNumber']
-                : typeof item['line_number'] === 'number'
-                    ? item['line_number']
-                    : typeof item['line'] === 'number'
-                        ? item['line']
-                        : typeof item['line_start'] === 'number'
-                            ? item['line_start']
-                            : undefined;
-            // Handle line as string: "24-50" or "24"
-            if (lineNumber === undefined && typeof item['line'] === 'string') {
-                const lineMatch = item['line'].match(/^(\d+)/);
-                if (lineMatch)
-                    lineNumber = parseInt(lineMatch[1], 10);
-            }
-            if (lineNumber === undefined && typeof item['line_number'] === 'string') {
-                const lineMatch = item['line_number'].match(/^(\d+)/);
-                if (lineMatch)
-                    lineNumber = parseInt(lineMatch[1], 10);
-            }
-            if (lineNumber === undefined && typeof item['lineNumber'] === 'string') {
-                const lineMatch = item['lineNumber'].match(/^(\d+)/);
-                if (lineMatch)
-                    lineNumber = parseInt(lineMatch[1], 10);
-            }
-            // Handle combined fields: "file_line" or "location" like "src/foo.ts:42-50"
-            for (const combinedKey of ['file_line', 'location']) {
-                if (!filePath && typeof item[combinedKey] === 'string') {
-                    const flMatch = item[combinedKey].match(/^([\w/.@-]+\.\w+):(\d+)/);
-                    if (flMatch) {
-                        filePath = flMatch[1];
-                        lineNumber = lineNumber ?? parseInt(flMatch[2], 10);
-                    }
-                    else if (combinedKey === 'file_line') {
-                        filePath = item[combinedKey];
-                    }
-                }
-            }
-            // Handle locations array: [{ file: "...", line_start: N }]
-            if (!filePath && Array.isArray(item['locations']) && item['locations'].length > 0) {
-                const loc = this.asRecord(item['locations'][0]);
-                if (loc) {
-                    filePath = loc['file'] ?? loc['filePath'];
-                    lineNumber = lineNumber ?? (typeof loc['line_start'] === 'number' ? loc['line_start'] : undefined);
-                }
-            }
-            // Resolve title: prefer explicit title/message, fall back to issue/summary/description/name
-            const hasExplicitTitle = item['title'] !== undefined || item['message'] !== undefined
-                || item['issue'] !== undefined || item['summary'] !== undefined;
-            const title = String(item['title'] ?? item['message'] ?? item['issue'] ?? item['summary']
-                ?? item['name'] ?? item['description'] ?? 'Untitled Issue');
-            // For description: if title consumed 'description', use explanation/suggestion/recommendation instead
-            const detailsStr = typeof item['details'] === 'string' ? item['details'] : undefined;
-            const description = hasExplicitTitle
-                ? String(item['description'] ?? detailsStr ?? item['explanation'] ?? item['suggestion'] ?? item['recommendation'] ?? '')
-                : String(item['explanation'] ?? detailsStr ?? item['suggestion'] ?? item['recommendation'] ?? item['description'] ?? '');
-            return {
-                title,
-                priority: this.normalizePriority(item['priority'] ?? item['type']),
-                severity: this.normalizeSeverity(item['severity']),
-                failureCode: item['failureCode']
-                    ?? item['failure_code']
-                    ?? item['code'],
-                filePath,
-                lineNumber,
-                description,
-            };
-        });
-    }
-    parseArtifacts(raw) {
-        return raw
-            .filter((item) => typeof item === 'object' && item !== null)
-            .map(item => ({
-            name: String(item['name'] ?? 'Untitled'),
-            path: String(item['path'] ?? ''),
-            size: typeof item['size'] === 'number' ? item['size'] : undefined,
-            contentType: item['contentType'] ?? item['content_type'],
-        }));
-    }
-    normalizePriority(value) {
-        const str = String(value ?? 'suggested').toLowerCase();
-        if (['critical', 'high', 'p0'].includes(str))
-            return 'critical';
-        if (['backlog', 'low', 'p2'].includes(str))
-            return 'backlog';
-        return 'suggested';
-    }
-    normalizeSeverity(value) {
-        const str = String(value ?? 'medium').toLowerCase();
-        if (str === 'critical')
-            return 'critical';
-        if (str === 'high')
-            return 'high';
-        if (str === 'low')
-            return 'low';
-        if (['info', 'informational', 'note'].includes(str))
-            return 'info';
-        return 'medium';
-    }
 }
 //# sourceMappingURL=OutputExtractor.js.map