@avi770/testteam 1.2.0

package/dist/core/cli.js

@@ -0,0 +1,197 @@
+import { validateConfig } from './config';
+import { Orchestrator } from './orchestrator';
+import { registerAllAgents } from '../agents/registry';
+import { runInitWizard } from './init';
+import { determineExitCode, writeCISummary, detectCIEnvironment } from './ci-output';
+import * as path from 'path';
+const PHASES = ['alpha', 'beta', 'uat', 'release'];
+function printUsage() {
+    console.log(`
+Usage: testteam [options]
+
+Options:
+  init                                   Initialize TestTeam in current directory
+  --phase <alpha|beta|uat|release|all>   Phase to run (required unless --dry-run)
+  --dry-run                              Show dispatch plan without executing
+  --agent <id>                           Run a single agent by ID
+  --config <path>                        Path to config file (default: testteam.config.ts)
+  --help                                 Show this help message
+`.trim());
+}
+export function parseArgs(argv) {
+    const args = argv.slice(2); // skip node + script path
+    let phase = null;
+    let dryRun = false;
+    let agent = null;
+    let configPath = 'testteam.config.ts';
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--phase': {
+                const value = args[++i];
+                if (!value || (!PHASES.includes(value) && value !== 'all')) {
+                    throw new Error(`Invalid phase: ${value}. Must be one of: ${PHASES.join(', ')}, all`);
+                }
+                phase = value;
+                break;
+            }
+            case '--dry-run':
+                dryRun = true;
+                break;
+            case '--agent': {
+                const value = args[++i];
+                const parsed = Number(value);
+                if (!value || isNaN(parsed) || parsed < 1) {
+                    throw new Error(`Invalid agent ID: ${value}. Must be a positive integer.`);
+                }
+                agent = parsed;
+                break;
+            }
+            case '--config':
+                configPath = args[++i];
+                if (!configPath) {
+                    throw new Error('--config requires a path argument');
+                }
+                break;
+            case '--help':
+                printUsage();
+                process.exit(0);
+                break;
+            default:
+                throw new Error(`Unknown argument: ${arg}`);
+        }
+    }
+    return { phase, dryRun, agent, configPath };
+}
+async function loadConfig(configPath) {
+    const absolutePath = path.resolve(configPath);
+    // On Windows, dynamic import requires file:// URLs
+    const fileUrl = new URL(`file:///${absolutePath.replace(/\\/g, '/')}`).href;
+    const module = await import(fileUrl);
+    const raw = module.default ?? module.config;
+    if (!raw) {
+        throw new Error(`Config file does not export a default or named 'config': ${absolutePath}`);
+    }
+    return raw;
+}
+export async function main(argv = process.argv) {
+    // Handle init command before normal arg parsing
+    const rawArgs = argv.slice(2);
+    if (rawArgs.includes('init') || rawArgs.includes('--init')) {
+        return runInitWizard();
+    }
+    if (argv.length <= 2) {
+        printUsage();
+        return 1;
+    }
+    let parsed;
+    try {
+        parsed = parseArgs(argv);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        printUsage();
+        return 1;
+    }
+    const { phase, dryRun, configPath } = parsed;
+    if (!dryRun && !phase) {
+        console.error('--phase is required unless using --dry-run');
+        printUsage();
+        return 1;
+    }
+    // Load and validate config
+    let rawConfig;
+    try {
+        rawConfig = await loadConfig(configPath);
+    }
+    catch (error) {
+        console.error(`Failed to load config: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+    const config = validateConfig(rawConfig);
+    // Shared run directory so all phases write results to the same location.
+    // This ensures the Reporter (Agent 10, release phase) can read results
+    // from prior phases (alpha, beta, uat).
+    const sharedRunDir = path.join(process.cwd(), '.run', `run-${Date.now()}`);
+    if (dryRun) {
+        const targetPhases = phase === 'all' || !phase
+            ? [...PHASES]
+            : [phase];
+        for (const p of targetPhases) {
+            const phaseOrchestrator = new Orchestrator(config, sharedRunDir);
+            registerAllAgents(phaseOrchestrator, config, p, sharedRunDir);
+            const plan = phaseOrchestrator.dryRun(p);
+            console.log(`\nPhase: ${p}`);
+            for (const entry of plan) {
+                console.log(`  Agent ${entry.agentId}: ${entry.status}`);
+            }
+        }
+        return 0;
+    }
+    // Run mode — create a fresh orchestrator per phase to avoid agent instance
+    // conflicts (GAP-023: registerAgent uses Map.set which overwrites).
+    const targetPhases = phase === 'all'
+        ? [...PHASES]
+        : [phase];
+    const collectedGates = [];
+    const collectedResults = new Map();
+    let hadError = false;
+    for (const p of targetPhases) {
+        console.log(`\nRunning phase: ${p}`);
+        try {
+            const phaseOrchestrator = new Orchestrator(config, sharedRunDir);
+            registerAllAgents(phaseOrchestrator, config, p, sharedRunDir);
+            const result = await phaseOrchestrator.runPhase(p);
+            if (result.skippedAgents.length > 0) {
+                console.log(`  Skipped agents: ${result.skippedAgents.join(', ')}`);
+            }
+            const resultCount = Object.keys(result.agentResults).length;
+            console.log(`  Completed ${resultCount} agent(s)`);
+            if (result.gate.passed) {
+                console.log(`  Gate: PASSED`);
+            }
+            else {
+                console.log(`  Gate: FAILED (blocking agents: ${result.gate.failedBlockingAgents.join(', ')})`);
+            }
+            collectedGates.push(result.gate);
+            // Merge agent results for CI summary
+            for (const [agentId, agentResult] of Object.entries(result.agentResults)) {
+                collectedResults.set(Number(agentId), agentResult);
+            }
+        }
+        catch (error) {
+            console.error(`  Phase ${p} error: ${error instanceof Error ? error.message : String(error)}`);
+            hadError = true;
+        }
+    }
+    // Determine structured exit code:
+    // - 0: All gates passed, no advisory failures
+    // - 1: Blocking agent failures (or runtime errors)
+    // - 2: Advisory warnings only
+    const exitCode = hadError
+        ? 1
+        : determineExitCode(collectedGates);
+    // Write CI summary if running in a CI environment
+    const ciEnv = detectCIEnvironment();
+    if (ciEnv !== 'none') {
+        const runState = {
+            runId: path.basename(sharedRunDir),
+            startedAt: new Date().toISOString(),
+            currentPhase: targetPhases[targetPhases.length - 1],
+            phaseAttempt: 1,
+            agentResults: collectedResults,
+            gateResults: collectedGates,
+            totalCost: 0,
+        };
+        writeCISummary(runState);
+    }
+    return exitCode;
+}
+// Direct execution — works with both tsx and node
+const isDirectExecution = typeof process !== 'undefined' &&
+    process.argv[1] &&
+    (process.argv[1].includes('cli.ts') || process.argv[1].includes('cli.js'));
+if (isDirectExecution) {
+    main().then((code) => process.exit(code));
+}
+//# sourceMappingURL=cli.js.map

package/dist/core/cli.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,111 @@
+export interface WorkflowStep {
+    action: 'navigate' | 'click' | 'fill-form' | 'wait' | 'verify';
+    target: string;
+    verify?: string;
+    data?: string;
+    timeout?: number;
+    contains?: string;
+}
+export interface ModuleConfig {
+    id: string;
+    route: string;
+    sidebarIcon: boolean;
+}
+export interface CredentialEntry {
+    email: string;
+    password: string;
+}
+export interface RoleEntry {
+    name: string;
+    email: string;
+}
+export interface AuthConfig {
+    loginUrl?: string;
+    credentials?: Record<string, CredentialEntry>;
+    roles?: RoleEntry[];
+}
+export interface EnvironmentConfig {
+    baseUrl: string;
+    seed?: boolean;
+}
+export interface PortalConfig {
+    name: string;
+    queryParam: string | null;
+}
+export interface IntegrationConfig {
+    name: string;
+    [key: string]: unknown;
+}
+export interface WorkerConfig {
+    name: string;
+    [key: string]: unknown;
+}
+export interface WorkflowConfig {
+    name: string;
+    steps: WorkflowStep[];
+}
+export interface AccuracyConfig {
+    enabled: boolean;
+    decimalPrecision: number;
+    currencySymbol: string;
+    timezone: string;
+}
+export interface TenancyConfig {
+    enabled: boolean;
+    isolationField: string;
+    testFirms: string[];
+}
+export interface CostBudgetConfig {
+    maxPerRun: number;
+    maxPerAgent: number;
+    alertThreshold: number;
+    onExceeded: 'abort' | 'alert-continue' | 'skip-remaining';
+}
+export interface AgentClassificationConfig {
+    blocking: number[];
+    advisory: number[];
+}
+export interface CoverageThresholds {
+    lines: number;
+    functions: number;
+    branches: number;
+    statements: number;
+}
+export interface LighthouseThresholds {
+    accessibility: number;
+    performance: number;
+    bestPractices: number;
+    seo: number;
+}
+export interface ThresholdsConfig {
+    unitCoverage: CoverageThresholds;
+    lighthouse: LighthouseThresholds;
+    apiResponseTime: number;
+    bundleSizeLimit: number;
+    maxConsoleErrors: number;
+}
+export interface TestTeamConfig {
+    schemaVersion: number;
+    name: string;
+    /** Absolute path to the target project root (where package.json, prisma/, apps/ live) */
+    projectRoot?: string;
+    auth: AuthConfig;
+    modules: ModuleConfig[];
+    environments: Record<string, EnvironmentConfig>;
+    portals: PortalConfig[];
+    breakpoints: number[];
+    integrations: IntegrationConfig[];
+    workers: WorkerConfig[];
+    workflows: WorkflowConfig[];
+    accuracy: AccuracyConfig;
+    tenancy: TenancyConfig;
+    costBudget: CostBudgetConfig;
+    agentClassification: AgentClassificationConfig;
+    thresholds: ThresholdsConfig;
+    disabledAgents: number[];
+}
+export interface ValidatedConfig extends TestTeamConfig {
+    disabledAgentSet: Set<number>;
+}
+export declare function validateConfig(raw: TestTeamConfig): ValidatedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

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

package/dist/core/config.js

@@ -0,0 +1,42 @@
+export function validateConfig(raw) {
+    if (raw.schemaVersion === undefined || raw.schemaVersion === null) {
+        throw new Error('schemaVersion is required');
+    }
+    if (!raw.name) {
+        throw new Error('name is required');
+    }
+    if (raw.modules !== undefined && !Array.isArray(raw.modules)) {
+        throw new Error('modules must be an array');
+    }
+    if (raw.modules !== undefined && Array.isArray(raw.modules) && raw.modules.length === 0) {
+        throw new Error('modules must contain at least one module');
+    }
+    if (!raw.auth) {
+        throw new Error('auth is required');
+    }
+    const disabledAgentSet = new Set(raw.disabledAgents ?? []);
+    // Warn on empty credential passwords and empty emails
+    if (raw.auth.credentials) {
+        const entries = Object.entries(raw.auth.credentials);
+        let allPasswordsEmpty = entries.length > 0;
+        for (const [role, entry] of entries) {
+            if (entry.password === '') {
+                console.warn(`[TestTeam] Warning: credential "${role}" has an empty password. Set a real password in your config.`);
+            }
+            else {
+                allPasswordsEmpty = false;
+            }
+            if (entry.email === '') {
+                console.warn(`[TestTeam] Warning: credential "${role}" has an empty email. Set TF_${role.toUpperCase()}_EMAIL in your environment.`);
+            }
+        }
+        if (allPasswordsEmpty && entries.length > 0) {
+            throw new Error('All credentials have empty passwords. At least one credential must have a non-empty password.');
+        }
+    }
+    return {
+        ...raw,
+        disabledAgentSet,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../core/config.ts"],"names":[],"mappings":"AAgIA,MAAM,UAAU,cAAc,CAAC,GAAmB;IAChD,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,GAAG,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IAEnE,sDAAsD;IACtD,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrD,IAAI,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAE3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,mCAAmC,IAAI,8DAA8D,CAAC,CAAC;YACtH,CAAC;iBAAM,CAAC;gBACN,iBAAiB,GAAG,KAAK,CAAC;YAC5B,CAAC;YAED,IAAI,KAAK,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,mCAAmC,IAAI,gCAAgC,IAAI,CAAC,WAAW,EAAE,6BAA6B,CAAC,CAAC;YACvI,CAAC;QACH,CAAC;QAED,IAAI,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;QACnH,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,GAAG;QACN,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/core/cost-tracker.d.ts

@@ -0,0 +1,22 @@
+export interface CostBudget {
+    maxPerRun: number;
+    maxPerAgent: number;
+    alertThreshold: number;
+    onExceeded: 'abort' | 'alert-continue' | 'skip-remaining';
+}
+export interface BudgetCheckResult {
+    status: 'ok' | 'alert' | 'exceeded';
+    totalCost: number;
+    budgetRemaining: number;
+}
+export declare class CostTracker {
+    private readonly budget;
+    private readonly agentCosts;
+    constructor(budget: CostBudget);
+    trackCost(agentId: string, amount: number): void;
+    getTotalCost(): number;
+    getAgentCost(agentId: string): number;
+    checkBudget(): BudgetCheckResult;
+    isAgentOverBudget(agentId: string): boolean;
+}
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/core/cost-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../core/cost-tracker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;CAC3D;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,UAAU,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;gBAEjD,MAAM,EAAE,UAAU;IAI9B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhD,YAAY,IAAI,MAAM;IAQtB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIrC,WAAW,IAAI,iBAAiB;IAiBhC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAG5C"}

package/dist/core/cost-tracker.js

@@ -0,0 +1,41 @@
+export class CostTracker {
+    budget;
+    agentCosts = new Map();
+    constructor(budget) {
+        this.budget = budget;
+    }
+    trackCost(agentId, amount) {
+        const current = this.agentCosts.get(agentId) ?? 0;
+        this.agentCosts.set(agentId, current + amount);
+    }
+    getTotalCost() {
+        let total = 0;
+        for (const cost of this.agentCosts.values()) {
+            total += cost;
+        }
+        return total;
+    }
+    getAgentCost(agentId) {
+        return this.agentCosts.get(agentId) ?? 0;
+    }
+    checkBudget() {
+        const totalCost = this.getTotalCost();
+        const budgetRemaining = this.budget.maxPerRun - totalCost;
+        const alertLimit = this.budget.maxPerRun * this.budget.alertThreshold;
+        let status;
+        if (totalCost >= this.budget.maxPerRun) {
+            status = 'exceeded';
+        }
+        else if (totalCost >= alertLimit) {
+            status = 'alert';
+        }
+        else {
+            status = 'ok';
+        }
+        return { status, totalCost, budgetRemaining };
+    }
+    isAgentOverBudget(agentId) {
+        return this.getAgentCost(agentId) >= this.budget.maxPerAgent;
+    }
+}
+//# sourceMappingURL=cost-tracker.js.map

package/dist/core/cost-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.js","sourceRoot":"","sources":["../../core/cost-tracker.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,WAAW;IACL,MAAM,CAAa;IACnB,UAAU,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE7D,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,OAAe,EAAE,MAAc;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,YAAY;QACV,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5C,KAAK,IAAI,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,WAAW;QACT,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QAEtE,IAAI,MAAmC,CAAC;QACxC,IAAI,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,GAAG,UAAU,CAAC;QACtB,CAAC;aAAM,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,GAAG,OAAO,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;IAChD,CAAC;IAED,iBAAiB,CAAC,OAAe;QAC/B,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IAC/D,CAAC;CACF"}

package/dist/core/evidence.d.ts

@@ -0,0 +1,28 @@
+import type { AgentResult, Finding, Phase } from './types';
+/**
+ * Creates the canonical `.run/{runId}/` directory structure.
+ * Safe to call multiple times — uses `{ recursive: true }`.
+ */
+export declare function initRunDirectory(runDir: string): Promise<void>;
+/**
+ * Writes an AgentResult as JSON to `agent-results/{agentId}.json`.
+ * Creates the parent directory lazily if it does not yet exist.
+ */
+export declare function writeAgentResult(runDir: string, agentId: number, result: AgentResult): Promise<void>;
+/**
+ * Reads an AgentResult from `agent-results/{agentId}.json`.
+ * Returns `null` when the file does not exist.
+ */
+export declare function readAgentResult(runDir: string, agentId: number): Promise<AgentResult | null>;
+/**
+ * Writes a Finding as JSON to the appropriate subdirectory.
+ * Creates the target directory lazily if it does not yet exist.
+ */
+export declare function writeFinding(runDir: string, finding: Finding): Promise<void>;
+/**
+ * Moves all files currently in `agent-results/` to
+ * `archive/attempt-{attempt}/` and empties the source directory.
+ * Is a no-op when `agent-results/` is empty or does not exist.
+ */
+export declare function archivePhaseResults(runDir: string, phase: Phase, attempt: number): Promise<void>;
+//# sourceMappingURL=evidence.d.ts.map

package/dist/core/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../core/evidence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAe,KAAK,EAAE,MAAM,SAAS,CAAC;AAWxE;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAW7B;AAgBD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlF;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/core/evidence.js

@@ -0,0 +1,95 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+const SUBDIRS = [
+    'agent-results',
+    'findings/test-bugs',
+    'findings/code-bugs',
+    'evidence/screenshots',
+    'evidence/logs',
+    'evidence/reports',
+];
+/**
+ * Creates the canonical `.run/{runId}/` directory structure.
+ * Safe to call multiple times — uses `{ recursive: true }`.
+ */
+export async function initRunDirectory(runDir) {
+    for (const subdir of SUBDIRS) {
+        await fs.mkdir(path.join(runDir, subdir), { recursive: true });
+    }
+}
+/**
+ * Writes an AgentResult as JSON to `agent-results/{agentId}.json`.
+ * Creates the parent directory lazily if it does not yet exist.
+ */
+export async function writeAgentResult(runDir, agentId, result) {
+    const dir = path.join(runDir, 'agent-results');
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(path.join(dir, `${agentId}.json`), JSON.stringify(result, null, 2), 'utf-8');
+}
+/**
+ * Reads an AgentResult from `agent-results/{agentId}.json`.
+ * Returns `null` when the file does not exist.
+ */
+export async function readAgentResult(runDir, agentId) {
+    const filePath = path.join(runDir, 'agent-results', `${agentId}.json`);
+    try {
+        const raw = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        if (isNodeError(err) && err.code === 'ENOENT') {
+            return null;
+        }
+        throw err;
+    }
+}
+/**
+ * Determines the findings subdirectory for a given FindingType.
+ *
+ * - `test-bug`            → `findings/test-bugs/`
+ * - `code-bug-*`          → `findings/code-bugs/`
+ * - `infra-issue`         → `findings/code-bugs/`
+ */
+function findingSubdir(type) {
+    if (type === 'test-bug') {
+        return 'findings/test-bugs';
+    }
+    return 'findings/code-bugs';
+}
+/**
+ * Writes a Finding as JSON to the appropriate subdirectory.
+ * Creates the target directory lazily if it does not yet exist.
+ */
+export async function writeFinding(runDir, finding) {
+    const dir = path.join(runDir, findingSubdir(finding.type));
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(path.join(dir, `${finding.id}.json`), JSON.stringify(finding, null, 2), 'utf-8');
+}
+/**
+ * Moves all files currently in `agent-results/` to
+ * `archive/attempt-{attempt}/` and empties the source directory.
+ * Is a no-op when `agent-results/` is empty or does not exist.
+ */
+export async function archivePhaseResults(runDir, phase, attempt) {
+    const sourceDir = path.join(runDir, 'agent-results');
+    let entries;
+    try {
+        entries = await fs.readdir(sourceDir);
+    }
+    catch (err) {
+        if (isNodeError(err) && err.code === 'ENOENT') {
+            return;
+        }
+        throw err;
+    }
+    if (entries.length === 0) {
+        return;
+    }
+    const destDir = path.join(runDir, 'archive', `${phase}-attempt-${attempt}`);
+    await fs.mkdir(destDir, { recursive: true });
+    await Promise.all(entries.map((entry) => fs.rename(path.join(sourceDir, entry), path.join(destDir, entry))));
+}
+function isNodeError(err) {
+    return err instanceof Error && 'code' in err;
+}
+//# sourceMappingURL=evidence.js.map

package/dist/core/evidence.js.map

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

package/dist/core/fix-loop.d.ts

@@ -0,0 +1,29 @@
+import type { Finding, FindingType, Phase } from './types';
+/**
+ * Classifies a finding based on its file location and description keywords.
+ *
+ * Priority order:
+ * 1. Test file with unchanged source → test-bug
+ * 2. Security keyword in description → code-bug-security
+ * 3. Cosmetic keyword in description → code-bug-cosmetic
+ * 4. Fallback → code-bug-logic
+ */
+export declare function classifyFinding(finding: Finding, changedFiles: string[]): FindingType;
+/**
+ * Determines whether a finding should be automatically committed without human intervention.
+ *
+ * UAT phase never auto-commits regardless of finding type.
+ * Test bugs always auto-commit (routed to the Healer agent).
+ * Cosmetic bugs auto-commit in alpha and beta only.
+ * Logic and security bugs never auto-commit (require human gates).
+ */
+export declare function shouldAutoCommit(findingType: FindingType, phase: Phase): boolean;
+/**
+ * Determines whether a finding requires human review before any action is taken.
+ *
+ * Security and logic bugs always require human review.
+ * UAT phase requires human review for all finding types.
+ * Cosmetic bugs and test bugs in alpha/beta do not require human review.
+ */
+export declare function shouldRequireHumanReview(findingType: FindingType, phase: Phase): boolean;
+//# sourceMappingURL=fix-loop.d.ts.map

package/dist/core/fix-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-loop.d.ts","sourceRoot":"","sources":["../../core/fix-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAc3D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,WAAW,CAgBrF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAgBhF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAUxF"}