@avi770/testteam 1.2.0

package/dist/agents/08-a11y-guardian.js

@@ -0,0 +1,176 @@
+import { execFile } from 'child_process';
+import { BaseAgent } from './base-agent';
+import { login, navigateToSection, waitForSectionLoad } from '../helpers/navigation';
+import { captureScreenshot } from '../helpers/screenshot';
+import { resolveEnvironment } from '../helpers/env-resolver';
+function execFilePromise(file, args) {
+    return new Promise((resolve, reject) => {
+        execFile(file, args, { shell: true }, (error, stdout, stderr) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve({ stdout: stdout ?? '', stderr: stderr ?? '' });
+        });
+    });
+}
+/** Map axe-core impact values to FindingSeverity. */
+export function mapAxeImpact(impact) {
+    switch ((impact ?? '').toLowerCase()) {
+        case 'critical': return 'critical';
+        case 'serious': return 'high';
+        case 'moderate': return 'medium';
+        case 'minor': return 'low';
+        default: return 'low';
+    }
+}
+export class A11yGuardianAgent extends BaseAgent {
+    agentId = 8;
+    agentName = 'A11y Guardian';
+    async preFlight() {
+        await execFilePromise('npx', ['playwright', '--version']);
+    }
+    async execute() {
+        const findings = [];
+        const { env } = await resolveEnvironment(this.config, this.phase);
+        if (!env) {
+            findings.push({
+                id: `${this.agentId}-no-env`,
+                type: 'infra-issue',
+                severity: 'critical',
+                agentId: this.agentId,
+                module: 'a11y-guardian',
+                description: 'No environment configured — cannot perform accessibility scan',
+            });
+            return findings;
+        }
+        const rawLoginUrl = this.config.auth.loginUrl ?? '/login';
+        const loginUrl = rawLoginUrl.startsWith('http') ? rawLoginUrl : `${env.baseUrl}${rawLoginUrl}`;
+        const credentials = this.config.auth.credentials?.['admin'] ??
+            Object.values(this.config.auth.credentials ?? {})[0];
+        if (!credentials) {
+            findings.push({
+                id: `${this.agentId}-no-credentials`,
+                type: 'infra-issue',
+                severity: 'critical',
+                agentId: this.agentId,
+                module: 'a11y-guardian',
+                description: 'No credentials configured — cannot log in for accessibility scan',
+            });
+            return findings;
+        }
+        const { chromium } = await import('playwright');
+        const { AxeBuilder } = await import('@axe-core/playwright');
+        let browser = null;
+        let page = null;
+        try {
+            browser = await chromium.launch({ headless: true });
+            page = await browser.newPage();
+            try {
+                await login(page, credentials, loginUrl);
+            }
+            catch (loginError) {
+                findings.push({
+                    id: `${this.agentId}-login-failed`,
+                    type: 'infra-issue',
+                    severity: 'medium',
+                    agentId: this.agentId,
+                    module: 'auth',
+                    description: `Login failed (will scan anonymously): ${loginError instanceof Error ? loginError.message.split('\n')[0] : String(loginError)}`,
+                });
+                // Navigate to baseUrl so anonymous scanning can proceed
+                await page.goto(env.baseUrl, { waitUntil: 'networkidle', timeout: 10000 }).catch(() => { });
+            }
+            for (const module of this.config.modules) {
+                try {
+                    await navigateToSection(page, module.id, this.config);
+                    await waitForSectionLoad(page);
+                }
+                catch (navErr) {
+                    findings.push({
+                        id: `${this.agentId}-nav-${module.id}`,
+                        type: 'infra-issue',
+                        severity: 'high',
+                        agentId: this.agentId,
+                        module: module.id,
+                        description: `[A11y] Navigation to module "${module.id}" failed: ${navErr instanceof Error ? navErr.message : String(navErr)}`,
+                    });
+                    continue;
+                }
+                const screenshotPath = await captureScreenshot(page, `a11y-${module.id}`, this.runDir);
+                this.addEvidence({
+                    type: 'screenshot',
+                    path: screenshotPath,
+                    description: `A11y scan screenshot for module "${module.id}"`,
+                });
+                let axeResults;
+                try {
+                    axeResults = await new AxeBuilder({ page }).analyze();
+                }
+                catch (axeErr) {
+                    findings.push({
+                        id: `${this.agentId}-axe-error-${module.id}`,
+                        type: 'infra-issue',
+                        severity: 'medium',
+                        agentId: this.agentId,
+                        module: module.id,
+                        description: `[A11y] axe-core scan failed for module "${module.id}": ${axeErr instanceof Error ? axeErr.message : String(axeErr)}`,
+                    });
+                    continue;
+                }
+                for (const violation of axeResults.violations) {
+                    const severity = mapAxeImpact(violation.impact ?? null);
+                    const nodeCount = violation.nodes.length;
+                    findings.push({
+                        id: `${this.agentId}-axe-${module.id}-${violation.id}`,
+                        type: 'code-bug-logic',
+                        severity,
+                        agentId: this.agentId,
+                        module: module.id,
+                        description: `[A11y] ${violation.description} (rule: ${violation.id}, ${nodeCount} node${nodeCount !== 1 ? 's' : ''})`,
+                        screenshot: screenshotPath,
+                        suggestedFix: violation.help,
+                    });
+                }
+            }
+            // Optional: Lighthouse CI
+            await this.runLighthouseIfAvailable();
+            // Optional: Pa11y CI
+            await this.runPa11yIfAvailable();
+        }
+        finally {
+            if (page)
+                await page.close().catch(() => undefined);
+            if (browser)
+                await browser.close().catch(() => undefined);
+        }
+        return findings;
+    }
+    async runLighthouseIfAvailable() {
+        try {
+            await execFilePromise('npx', ['lhci', 'autorun']);
+            this.addEvidence({
+                type: 'report',
+                path: 'lhci-report',
+                description: 'Lighthouse CI accessibility report',
+            });
+        }
+        catch {
+            // Lighthouse not available or failed — non-fatal, skip silently
+        }
+    }
+    async runPa11yIfAvailable() {
+        try {
+            await execFilePromise('npx', ['pa11y-ci']);
+            this.addEvidence({
+                type: 'report',
+                path: 'pa11y-report',
+                description: 'Pa11y CI accessibility report',
+            });
+        }
+        catch {
+            // Pa11y not available or failed — non-fatal, skip silently
+        }
+    }
+}
+//# sourceMappingURL=08-a11y-guardian.js.map

package/dist/agents/08-a11y-guardian.js.map

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

package/dist/agents/09-healer.d.ts

@@ -0,0 +1,33 @@
+import { BaseAgent } from './base-agent';
+import type { Finding } from '../core/types';
+/** Describes the root-cause category of a test-bug finding. */
+type FixStrategy = 'selector' | 'timing' | 'data' | 'unknown';
+/**
+ * Classifies a test-bug finding into one of three fix strategies based on
+ * keywords in the description.
+ *
+ * - selector: element-locator problems (element not found, stale selector, …)
+ * - timing:   race-condition / timeout problems
+ * - data:     seed / fixture / data mismatch problems
+ * - unknown:  fallback when no keyword matches
+ */
+export declare function classifyFixStrategy(finding: Finding): FixStrategy;
+/**
+ * Generates a suggested fix string given a FixStrategy and the original
+ * finding.  The generated suggestion intentionally uses plain English so it
+ * can be reviewed by a developer or fed to a downstream AI patch agent.
+ */
+export declare function generateFixSuggestion(finding: Finding, strategy: FixStrategy): string;
+export declare class HealerAgent extends BaseAgent {
+    readonly agentId = 9;
+    readonly agentName = "Healer";
+    /** Attempt tracking for the current run (finding id → attempt count). */
+    private readonly attemptMap;
+    /** Set to true when there are no findings to process — makes execute() a no-op. */
+    private noFindings;
+    protected preFlight(): Promise<void>;
+    protected execute(): Promise<Finding[]>;
+    private getOrCreateAttemptRecord;
+}
+export {};
+//# sourceMappingURL=09-healer.d.ts.map

package/dist/agents/09-healer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"09-healer.d.ts","sourceRoot":"","sources":["../../agents/09-healer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAK7C,+DAA+D;AAC/D,KAAK,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAQ9D;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAkCjE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM,CAiCrF;AAED,qBAAa,WAAY,SAAQ,SAAS;IACxC,QAAQ,CAAC,OAAO,KAAK;IACrB,QAAQ,CAAC,SAAS,YAAY;IAE9B,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAE/D,mFAAmF;IACnF,OAAO,CAAC,UAAU,CAAS;cAEX,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;cAmB1B,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IA4E7C,OAAO,CAAC,wBAAwB;CAOjC"}

package/dist/agents/09-healer.js

@@ -0,0 +1,167 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { BaseAgent } from './base-agent';
+import { validateCodeQuality } from '../helpers/quality-gate';
+/** Maximum number of fix attempts per finding before escalation. */
+const MAX_ATTEMPTS = 3;
+/**
+ * Classifies a test-bug finding into one of three fix strategies based on
+ * keywords in the description.
+ *
+ * - selector: element-locator problems (element not found, stale selector, …)
+ * - timing:   race-condition / timeout problems
+ * - data:     seed / fixture / data mismatch problems
+ * - unknown:  fallback when no keyword matches
+ */
+export function classifyFixStrategy(finding) {
+    const lower = finding.description.toLowerCase();
+    if (lower.includes('selector') ||
+        lower.includes('element not found') ||
+        lower.includes('locator') ||
+        lower.includes('stale') ||
+        lower.includes('no such element')) {
+        return 'selector';
+    }
+    if (lower.includes('timeout') ||
+        lower.includes('timing') ||
+        lower.includes('race') ||
+        lower.includes('wait') ||
+        lower.includes('timed out')) {
+        return 'timing';
+    }
+    if (lower.includes('seed') ||
+        lower.includes('fixture') ||
+        lower.includes('data') ||
+        lower.includes('expected value') ||
+        lower.includes('mismatch')) {
+        return 'data';
+    }
+    return 'unknown';
+}
+/**
+ * Generates a suggested fix string given a FixStrategy and the original
+ * finding.  The generated suggestion intentionally uses plain English so it
+ * can be reviewed by a developer or fed to a downstream AI patch agent.
+ */
+export function generateFixSuggestion(finding, strategy) {
+    switch (strategy) {
+        case 'selector':
+            return (`[Healer] Selector fix for "${finding.module}": ` +
+                `Update the element selector/locator — the target element may have changed its ` +
+                `data-testid, class, or role attribute. ` +
+                `Suggested action: inspect the current DOM and replace the stale selector with ` +
+                `a stable data-testid attribute (e.g. data-testid="<component>-<action>").`);
+        case 'timing':
+            return (`[Healer] Timing fix for "${finding.module}": ` +
+                `Add an explicit wait before the failing assertion. ` +
+                `Suggested action: replace hard sleeps with \`waitFor\` / \`waitForSelector\` ` +
+                `or increase the relevant timeout in the test configuration.`);
+        case 'data':
+            return (`[Healer] Data fix for "${finding.module}": ` +
+                `Update the test seed or fixture so the expected values match the current schema. ` +
+                `Suggested action: re-run \`pnpm seed:test\` to refresh test data, or update ` +
+                `the fixture file to reflect the current data model.`);
+        default:
+            return (`[Healer] Unknown strategy for "${finding.module}": ` +
+                `Manual investigation required — no known fix pattern matched the description.`);
+    }
+}
+export class HealerAgent extends BaseAgent {
+    agentId = 9;
+    agentName = 'Healer';
+    /** Attempt tracking for the current run (finding id → attempt count). */
+    attemptMap = new Map();
+    /** Set to true when there are no findings to process — makes execute() a no-op. */
+    noFindings = false;
+    async preFlight() {
+        const testBugsDir = path.join(this.runDir, 'findings', 'test-bugs');
+        let entries;
+        try {
+            entries = await fs.readdir(testBugsDir);
+        }
+        catch (err) {
+            if (isNodeError(err) && err.code === 'ENOENT') {
+                this.noFindings = true;
+                return;
+            }
+            throw err;
+        }
+        const jsonFiles = entries.filter((e) => e.endsWith('.json'));
+        if (jsonFiles.length === 0) {
+            this.noFindings = true;
+        }
+    }
+    async execute() {
+        if (this.noFindings) {
+            return [];
+        }
+        const testBugsDir = path.join(this.runDir, 'findings', 'test-bugs');
+        let entries;
+        try {
+            entries = await fs.readdir(testBugsDir);
+        }
+        catch {
+            return [];
+        }
+        const jsonFiles = entries.filter((e) => e.endsWith('.json'));
+        const unresolvedFindings = [];
+        for (const filename of jsonFiles) {
+            const filePath = path.join(testBugsDir, filename);
+            let finding;
+            try {
+                const raw = await fs.readFile(filePath, 'utf-8');
+                finding = JSON.parse(raw);
+            }
+            catch {
+                continue;
+            }
+            const record = this.getOrCreateAttemptRecord(finding.id);
+            if (record.attempts >= MAX_ATTEMPTS) {
+                unresolvedFindings.push({
+                    ...finding,
+                    suggestedFix: `[Healer] Escalated after ${MAX_ATTEMPTS} attempts — requires manual investigation.`,
+                });
+                continue;
+            }
+            record.attempts += 1;
+            const strategy = classifyFixStrategy(finding);
+            const suggestion = generateFixSuggestion(finding, strategy);
+            // Run quality gate on any embedded test code in suggestedFix (if present)
+            const qualityViolations = validateCodeQuality(suggestion, `healer-fix-${finding.id}.ts`);
+            const hasErrors = qualityViolations.some((v) => v.severity === 'error');
+            if (hasErrors) {
+                // The fix suggestion itself has quality errors — escalate
+                unresolvedFindings.push({
+                    ...finding,
+                    suggestedFix: `[Healer] Generated fix failed quality gate (attempt ${record.attempts}/${MAX_ATTEMPTS}): ` +
+                        qualityViolations.map((v) => v.message).join('; '),
+                });
+                continue;
+            }
+            const resolvedFinding = {
+                ...finding,
+                suggestedFix: suggestion,
+            };
+            this.addEvidence({
+                type: 'log',
+                path: filePath,
+                description: `Healer processed test-bug "${finding.id}" with strategy "${strategy}" (attempt ${record.attempts})`,
+            });
+            // Write updated finding back to disk
+            await fs.writeFile(filePath, JSON.stringify(resolvedFinding, null, 2), 'utf-8');
+        }
+        return unresolvedFindings;
+    }
+    getOrCreateAttemptRecord(findingId) {
+        const existing = this.attemptMap.get(findingId);
+        if (existing)
+            return existing;
+        const record = { findingId, attempts: 0 };
+        this.attemptMap.set(findingId, record);
+        return record;
+    }
+}
+function isNodeError(err) {
+    return err instanceof Error && 'code' in err;
+}
+//# sourceMappingURL=09-healer.js.map

package/dist/agents/09-healer.js.map

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

package/dist/agents/10-reporter.d.ts

@@ -0,0 +1,26 @@
+import { BaseAgent } from './base-agent';
+import type { AgentResult, Finding } from '../core/types';
+/** Release-gate recommendation. */
+export type ReleaseRecommendation = 'GO' | 'CONDITIONAL GO' | 'NO-GO';
+/**
+ * Determines the release recommendation based on the severity of all findings
+ * across every agent result.
+ *
+ * - NO-GO:          any critical finding
+ * - CONDITIONAL GO: 0 critical findings, at least one high finding
+ * - GO:             0 critical and 0 high findings
+ */
+export declare function determineRecommendation(results: AgentResult[]): ReleaseRecommendation;
+/**
+ * Builds the full markdown report string from the collected agent results.
+ */
+export declare function buildMarkdownReport(results: AgentResult[], runId: string, recommendation: ReleaseRecommendation): string;
+export declare class ReporterAgent extends BaseAgent {
+    readonly agentId = 10;
+    readonly agentName = "Reporter";
+    /** When true, execute() returns a single informational finding instead of a full report. */
+    private noPriorResults;
+    protected preFlight(): Promise<void>;
+    protected execute(): Promise<Finding[]>;
+}
+//# sourceMappingURL=10-reporter.d.ts.map

package/dist/agents/10-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"10-reporter.d.ts","sourceRoot":"","sources":["../../agents/10-reporter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAA0B,MAAM,eAAe,CAAC;AAKlF,mCAAmC;AACnC,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAUtE;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,qBAAqB,CAQrF;AAsDD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,qBAAqB,GACpC,MAAM,CA8DR;AAED,qBAAa,aAAc,SAAQ,SAAS;IAC1C,QAAQ,CAAC,OAAO,MAAM;IACtB,QAAQ,CAAC,SAAS,cAAc;IAEhC,4FAA4F;IAC5F,OAAO,CAAC,cAAc,CAAS;cAEf,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;cAqB1B,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAgE9C"}

package/dist/agents/10-reporter.js

@@ -0,0 +1,215 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { BaseAgent } from './base-agent';
+import { readAgentResult } from '../core/evidence';
+/** Agent IDs whose results are pulled into the consolidated report. */
+const KNOWN_AGENT_IDS = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23];
+/**
+ * Determines the release recommendation based on the severity of all findings
+ * across every agent result.
+ *
+ * - NO-GO:          any critical finding
+ * - CONDITIONAL GO: 0 critical findings, at least one high finding
+ * - GO:             0 critical and 0 high findings
+ */
+export function determineRecommendation(results) {
+    const allFindings = results.flatMap((r) => r.findings);
+    const hasCritical = allFindings.some((f) => f.severity === 'critical');
+    const hasHigh = allFindings.some((f) => f.severity === 'high');
+    if (hasCritical)
+        return 'NO-GO';
+    if (hasHigh)
+        return 'CONDITIONAL GO';
+    return 'GO';
+}
+/**
+ * Aggregates agent results by phase.
+ */
+function aggregateByPhase(results) {
+    const map = new Map();
+    for (const result of results) {
+        const phase = result.phase;
+        const existing = map.get(phase) ?? {
+            phase,
+            passCount: 0,
+            failCount: 0,
+            findings: [],
+        };
+        if (result.status === 'passed') {
+            existing.passCount += 1;
+        }
+        else {
+            existing.failCount += 1;
+        }
+        existing.findings.push(...result.findings);
+        map.set(phase, existing);
+    }
+    return map;
+}
+function severityEmoji(severity) {
+    switch (severity) {
+        case 'critical': return 'CRITICAL';
+        case 'high': return 'HIGH';
+        case 'medium': return 'MEDIUM';
+        case 'low': return 'LOW';
+        case 'info': return 'INFO';
+    }
+}
+function formatFindingLine(f) {
+    const loc = f.file ? ` (${f.file}${f.line ? `:${f.line}` : ''})` : '';
+    return `- [${severityEmoji(f.severity)}] Agent ${f.agentId} | ${f.module}${loc}: ${f.description}`;
+}
+/**
+ * Extracts a summary string from the agent result with the given ID, or returns
+ * a placeholder when that result is not present in the collection.
+ */
+function agentSummaryLine(results, agentId, label) {
+    const result = results.find((r) => r.agentId === agentId);
+    if (!result)
+        return `${label}: not run`;
+    return `${label}: ${result.summary}`;
+}
+/**
+ * Builds the full markdown report string from the collected agent results.
+ */
+export function buildMarkdownReport(results, runId, recommendation) {
+    const phaseMap = aggregateByPhase(results);
+    const phases = ['alpha', 'beta', 'uat', 'release'];
+    const lines = [];
+    lines.push(`# TestTeam — Release Report`);
+    lines.push(`**Run ID:** ${runId}`);
+    lines.push(`**Generated:** ${new Date().toISOString()}`);
+    lines.push(`**Recommendation:** ${recommendation}`);
+    lines.push('');
+    // Phase summaries
+    lines.push('## Phase Summaries');
+    for (const phase of phases) {
+        const summary = phaseMap.get(phase);
+        if (!summary) {
+            lines.push(`### ${phase.toUpperCase()}`);
+            lines.push('No agents ran in this phase.');
+            lines.push('');
+            continue;
+        }
+        lines.push(`### ${phase.toUpperCase()}`);
+        lines.push(`- Pass: ${summary.passCount}`);
+        lines.push(`- Fail: ${summary.failCount}`);
+        lines.push(`- Total findings: ${summary.findings.length}`);
+        lines.push('');
+    }
+    // Specialist summaries
+    lines.push('## Specialist Summaries');
+    lines.push(agentSummaryLine(results, 4, 'Coverage (Agent 4)'));
+    lines.push(agentSummaryLine(results, 7, 'Security (Agent 7)'));
+    lines.push(agentSummaryLine(results, 8, 'Accessibility (Agent 8)'));
+    lines.push(agentSummaryLine(results, 13, 'Performance (Agent 13)'));
+    lines.push(agentSummaryLine(results, 14, 'Data Integrity (Agent 14)'));
+    lines.push('');
+    // All findings by severity
+    const allFindings = results.flatMap((r) => r.findings);
+    const severities = ['critical', 'high', 'medium', 'low'];
+    lines.push('## Findings by Severity');
+    for (const sev of severities) {
+        const group = allFindings.filter((f) => f.severity === sev);
+        if (group.length === 0)
+            continue;
+        lines.push(`### ${sev.toUpperCase()} (${group.length})`);
+        for (const f of group) {
+            lines.push(formatFindingLine(f));
+        }
+        lines.push('');
+    }
+    if (allFindings.length === 0) {
+        lines.push('No findings — all agents passed.');
+        lines.push('');
+    }
+    lines.push(`---`);
+    lines.push(`_Generated by TestTeam Reporter (Agent 10)_`);
+    return lines.join('\n');
+}
+export class ReporterAgent extends BaseAgent {
+    agentId = 10;
+    agentName = 'Reporter';
+    /** When true, execute() returns a single informational finding instead of a full report. */
+    noPriorResults = false;
+    async preFlight() {
+        const agentResultsDir = path.join(this.runDir, 'agent-results');
+        let entries;
+        try {
+            entries = await fs.readdir(agentResultsDir);
+        }
+        catch (err) {
+            if (isNodeError(err) && err.code === 'ENOENT') {
+                // Directory missing — gracefully degrade instead of throwing
+                this.noPriorResults = true;
+                return;
+            }
+            throw err;
+        }
+        const jsonFiles = entries.filter((e) => e.endsWith('.json'));
+        if (jsonFiles.length === 0) {
+            // Empty directory — gracefully degrade instead of throwing
+            this.noPriorResults = true;
+        }
+    }
+    async execute() {
+        if (this.noPriorResults) {
+            return [{
+                    id: `${this.agentId}-no-results`,
+                    type: 'infra-issue',
+                    severity: 'low',
+                    agentId: this.agentId,
+                    module: 'reporter',
+                    description: 'No agent results to report — agent-results directory is empty or missing',
+                }];
+        }
+        // Read all available agent results
+        const results = [];
+        for (const agentId of KNOWN_AGENT_IDS) {
+            const result = await readAgentResult(this.runDir, agentId);
+            if (result) {
+                results.push(result);
+            }
+        }
+        // Also read any extra result files not in the known-IDs list
+        const agentResultsDir = path.join(this.runDir, 'agent-results');
+        try {
+            const entries = await fs.readdir(agentResultsDir);
+            for (const entry of entries) {
+                if (!entry.endsWith('.json'))
+                    continue;
+                const idStr = entry.replace('.json', '');
+                const id = parseInt(idStr, 10);
+                if (isNaN(id) || KNOWN_AGENT_IDS.includes(id))
+                    continue;
+                const raw = await fs.readFile(path.join(agentResultsDir, entry), 'utf-8');
+                results.push(JSON.parse(raw));
+            }
+        }
+        catch {
+            // Ignore read errors for extra files
+        }
+        const recommendation = determineRecommendation(results);
+        // Use run directory name as run ID
+        const runId = path.basename(this.runDir);
+        const date = new Date().toISOString().slice(0, 10);
+        const reportFilename = `${date}-${runId}.md`;
+        const reportsDir = path.join(path.dirname(path.dirname(this.runDir)), // go up from .run/<runId> to project root
+        'testteam', 'reports');
+        await fs.mkdir(reportsDir, { recursive: true });
+        const reportPath = path.join(reportsDir, reportFilename);
+        const markdownContent = buildMarkdownReport(results, runId, recommendation);
+        await fs.writeFile(reportPath, markdownContent, 'utf-8');
+        this.addEvidence({
+            type: 'report',
+            path: reportPath,
+            description: `Consolidated release report — recommendation: ${recommendation}`,
+        });
+        // Reporter does not generate new findings — it only aggregates
+        return [];
+    }
+}
+function isNodeError(err) {
+    return err instanceof Error && 'code' in err;
+}
+//# sourceMappingURL=10-reporter.js.map