agentic-engineering-harness 0.4.16

package/dist/agents/outputContracts.d.ts

@@ -0,0 +1,161 @@
+import { z } from "zod";
+export declare const delegationTaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    summary: z.ZodString;
+    agent: z.ZodString;
+    scope: z.ZodArray<z.ZodString>;
+    dependencies: z.ZodArray<z.ZodString>;
+    acceptance: z.ZodArray<z.ZodString>;
+    risk: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+}, z.core.$strip>;
+export declare const plannerOutputSchema: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        summary: z.ZodString;
+        agent: z.ZodString;
+        scope: z.ZodArray<z.ZodString>;
+        dependencies: z.ZodArray<z.ZodString>;
+        acceptance: z.ZodArray<z.ZodString>;
+        risk: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+    }, z.core.$strip>>;
+    affectedAreas: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    requiredReviewers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    validationGates: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    fallbackRouting: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    outOfScopeImprovements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const implementerOutputSchema: z.ZodObject<{
+    filesChanged: z.ZodArray<z.ZodString>;
+    behaviorImplemented: z.ZodArray<z.ZodString>;
+    decisions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    assumptions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    risks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    validationCommands: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    reviewers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    followUp: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    contractSync: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const findingSchema: z.ZodObject<{
+    id: z.ZodString;
+    severity: z.ZodEnum<{
+        critical: "critical";
+        high: "high";
+        medium: "medium";
+        low: "low";
+        note: "note";
+    }>;
+    category: z.ZodString;
+    location: z.ZodObject<{
+        file: z.ZodString;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    evidence: z.ZodString;
+    impact: z.ZodString;
+    recommendedFix: z.ZodString;
+    suggestedAgent: z.ZodString;
+    exceptionType: z.ZodOptional<z.ZodEnum<{
+        IMPLEMENTATION_DEFECT: "IMPLEMENTATION_DEFECT";
+        SPEC_CONTRADICTION: "SPEC_CONTRADICTION";
+        REQUIRES_PRODUCT_DECISION: "REQUIRES_PRODUCT_DECISION";
+        BLOCKED_EXTERNAL: "BLOCKED_EXTERNAL";
+        SYSTEM_FAILURE: "SYSTEM_FAILURE";
+    }>>;
+}, z.core.$strip>;
+export declare const reviewerOutputSchema: z.ZodObject<{
+    verdict: z.ZodEnum<{
+        PASS: "PASS";
+        FAIL: "FAIL";
+        PASS_WITH_WARNINGS: "PASS_WITH_WARNINGS";
+    }>;
+    findings: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        severity: z.ZodEnum<{
+            critical: "critical";
+            high: "high";
+            medium: "medium";
+            low: "low";
+            note: "note";
+        }>;
+        category: z.ZodString;
+        location: z.ZodObject<{
+            file: z.ZodString;
+            startLine: z.ZodOptional<z.ZodNumber>;
+            endLine: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        evidence: z.ZodString;
+        impact: z.ZodString;
+        recommendedFix: z.ZodString;
+        suggestedAgent: z.ZodString;
+        exceptionType: z.ZodOptional<z.ZodEnum<{
+            IMPLEMENTATION_DEFECT: "IMPLEMENTATION_DEFECT";
+            SPEC_CONTRADICTION: "SPEC_CONTRADICTION";
+            REQUIRES_PRODUCT_DECISION: "REQUIRES_PRODUCT_DECISION";
+            BLOCKED_EXTERNAL: "BLOCKED_EXTERNAL";
+            SYSTEM_FAILURE: "SYSTEM_FAILURE";
+        }>>;
+    }, z.core.$strip>>;
+    finalizationSafety: z.ZodEnum<{
+        SAFE: "SAFE";
+        BLOCKED: "BLOCKED";
+        RISK_KNOWN: "RISK_KNOWN";
+    }>;
+    confidence: z.ZodOptional<z.ZodString>;
+    followUp: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const validatorOutputSchema: z.ZodObject<{
+    verdict: z.ZodEnum<{
+        PASS: "PASS";
+        FAIL: "FAIL";
+        WARN: "WARN";
+    }>;
+    checks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            PASS: "PASS";
+            FAIL: "FAIL";
+            SKIP: "SKIP";
+            WARN: "WARN";
+        }>;
+        evidence: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const recoveryOutputSchema: z.ZodObject<{
+    failureType: z.ZodEnum<{
+        PATCH_CONTEXT_MISMATCH: "PATCH_CONTEXT_MISMATCH";
+        TOOL_FAILURE: "TOOL_FAILURE";
+        MISSING_CONTEXT: "MISSING_CONTEXT";
+        WRONG_AGENT: "WRONG_AGENT";
+        VALIDATION_FAILURE: "VALIDATION_FAILURE";
+        REVIEW_FAILURE: "REVIEW_FAILURE";
+        AMBIGUOUS_OUTPUT: "AMBIGUOUS_OUTPUT";
+        CONFLICTING_RESULTS: "CONFLICTING_RESULTS";
+    }>;
+    rationale: z.ZodString;
+    nextAction: z.ZodString;
+}, z.core.$strip>;
+export declare const orchestratorOutputSchema: z.ZodObject<{
+    summary: z.ZodString;
+    delegatedAgents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    validationStatus: z.ZodOptional<z.ZodString>;
+    unresolved: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    finalizationSafe: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type DelegationTask = z.infer<typeof delegationTaskSchema>;
+export type PlannerOutput = z.infer<typeof plannerOutputSchema>;
+export type NormalizedFinding = z.infer<typeof findingSchema>;
+export type ReviewerOutput = z.infer<typeof reviewerOutputSchema>;
+export declare function validateAgentOutput(contractName: string, value: unknown): {
+    ok: boolean;
+    value?: unknown;
+    issues: string[];
+};
+export declare function knownOutputContracts(): string[];

package/dist/agents/outputContracts.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+const riskSchema = z.enum(["low", "medium", "high"]);
+const exceptionTypeSchema = z.enum(["IMPLEMENTATION_DEFECT", "SPEC_CONTRADICTION", "REQUIRES_PRODUCT_DECISION", "BLOCKED_EXTERNAL", "SYSTEM_FAILURE"]);
+export const delegationTaskSchema = z.object({ id: z.string().min(1), summary: z.string().min(1), agent: z.string().min(1), scope: z.array(z.string()), dependencies: z.array(z.string()), acceptance: z.array(z.string()).min(1), risk: riskSchema });
+export const plannerOutputSchema = z.object({ tasks: z.array(delegationTaskSchema), affectedAreas: z.array(z.string()).default([]), requiredReviewers: z.array(z.string()).default([]), validationGates: z.array(z.string()).default([]), fallbackRouting: z.array(z.string()).default([]), outOfScopeImprovements: z.array(z.string()).default([]) });
+export const implementerOutputSchema = z.object({ filesChanged: z.array(z.string()), behaviorImplemented: z.array(z.string()), decisions: z.array(z.string()).default([]), assumptions: z.array(z.string()).default([]), risks: z.array(z.string()).default([]), validationCommands: z.array(z.string()).default([]), reviewers: z.array(z.string()).default([]), followUp: z.array(z.string()).default([]), contractSync: z.array(z.string()).optional() });
+export const findingSchema = z.object({ id: z.string().min(1), severity: z.enum(["critical", "high", "medium", "low", "note"]), category: z.string().min(1), location: z.object({ file: z.string().min(1), startLine: z.number().int().positive().optional(), endLine: z.number().int().positive().optional() }), evidence: z.string().min(1), impact: z.string().min(1), recommendedFix: z.string().min(1), suggestedAgent: z.string().min(1), exceptionType: exceptionTypeSchema.optional() });
+export const reviewerOutputSchema = z.object({ verdict: z.enum(["PASS", "FAIL", "PASS_WITH_WARNINGS"]), findings: z.array(findingSchema), finalizationSafety: z.enum(["SAFE", "BLOCKED", "RISK_KNOWN"]), confidence: z.string().optional(), followUp: z.array(z.string()).default([]) });
+export const validatorOutputSchema = z.object({ verdict: z.enum(["PASS", "FAIL", "WARN"]), checks: z.array(z.object({ id: z.string(), status: z.enum(["PASS", "FAIL", "WARN", "SKIP"]), evidence: z.string().optional() })) });
+export const recoveryOutputSchema = z.object({ failureType: z.enum(["PATCH_CONTEXT_MISMATCH", "TOOL_FAILURE", "MISSING_CONTEXT", "WRONG_AGENT", "VALIDATION_FAILURE", "REVIEW_FAILURE", "AMBIGUOUS_OUTPUT", "CONFLICTING_RESULTS"]), rationale: z.string(), nextAction: z.string() });
+export const orchestratorOutputSchema = z.object({ summary: z.string(), delegatedAgents: z.array(z.string()).default([]), validationStatus: z.string().optional(), unresolved: z.array(z.string()).default([]), finalizationSafe: z.boolean().optional() });
+const schemas = { planner: plannerOutputSchema, implementer: implementerOutputSchema, reviewer: reviewerOutputSchema, validator: validatorOutputSchema, recovery: recoveryOutputSchema, orchestrator: orchestratorOutputSchema };
+export function validateAgentOutput(contractName, value) { const schema = schemas[contractName]; if (!schema)
+    return { ok: false, issues: [`Unknown agent output contract: ${contractName}`] }; const parsed = schema.safeParse(value); return parsed.success ? { ok: true, value: parsed.data, issues: [] } : { ok: false, issues: parsed.error.issues.map((issue) => `${issue.path.join(".") || "root"}: ${issue.message}`) }; }
+export function knownOutputContracts() { return Object.keys(schemas).sort(); }
+//# sourceMappingURL=outputContracts.js.map

package/dist/agents/outputContracts.js.map

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

package/dist/agents/parallelism.d.ts

@@ -0,0 +1,14 @@
+import type { HarnessProjectConfig } from "../core/types.js";
+import type { DelegationTask } from "./outputContracts.js";
+export interface TaskConflict {
+    a: string;
+    b: string;
+    reasons: string[];
+}
+export interface ParallelismPlan {
+    taskId: string;
+    waves: string[][];
+    conflicts: TaskConflict[];
+    graphUsed: boolean;
+}
+export declare function planParallelism(root: string, config: HarnessProjectConfig, taskId: string, tasks: DelegationTask[]): Promise<ParallelismPlan>;

package/dist/agents/parallelism.js

@@ -0,0 +1,54 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { minimatch } from "minimatch";
+export async function planParallelism(root, config, taskId, tasks) {
+    const graph = await loadBeforeGraph(root, config, taskId);
+    const conflicts = [];
+    for (let i = 0; i < tasks.length; i += 1)
+        for (let j = i + 1; j < tasks.length; j += 1) {
+            const reasons = conflictReasons(tasks[i], tasks[j], graph);
+            if (reasons.length)
+                conflicts.push({ a: tasks[i].id, b: tasks[j].id, reasons });
+        }
+    const waves = [];
+    const remaining = new Map(tasks.map((task) => [task.id, task]));
+    const completed = new Set();
+    while (remaining.size) {
+        const wave = [];
+        for (const task of remaining.values()) {
+            if (!task.dependencies.every((dep) => completed.has(dep)))
+                continue;
+            if (wave.some((other) => conflicts.some((conflict) => ((conflict.a === task.id && conflict.b === other.id) || (conflict.b === task.id && conflict.a === other.id)))))
+                continue;
+            wave.push(task);
+        }
+        if (!wave.length)
+            throw new Error(`Cannot schedule delegation plan: dependency cycle or unresolved dependency among ${[...remaining.keys()].join(", ")}`);
+        waves.push(wave.map((task) => task.id));
+        for (const task of wave) {
+            completed.add(task.id);
+            remaining.delete(task.id);
+        }
+    }
+    return { taskId, waves, conflicts, graphUsed: Boolean(graph) };
+}
+function conflictReasons(a, b, graph) { const reasons = []; if (a.dependencies.includes(b.id) || b.dependencies.includes(a.id))
+    reasons.push("dependency"); if (scopesOverlap(a.scope, b.scope))
+    reasons.push("scope-overlap"); if (graph && shareCommunity(a.scope, b.scope, graph))
+    reasons.push("graphify-community-overlap"); return reasons; }
+function scopesOverlap(a, b) { return a.some((left) => b.some((right) => left === right || minimatch(left, right, { dot: true }) || minimatch(right, left, { dot: true }) || staticPrefix(left).startsWith(staticPrefix(right)) || staticPrefix(right).startsWith(staticPrefix(left)))); }
+function staticPrefix(pattern) { return pattern.split(/[?*\[]/, 1)[0].replace(/\/+$/, ""); }
+function shareCommunity(aScopes, bScopes, graph) { const communities = graph.communities ?? {}; const a = communitiesForScopes(aScopes, graph.nodes ?? [], communities); const b = communitiesForScopes(bScopes, graph.nodes ?? [], communities); return [...a].some((community) => b.has(community)); }
+function communitiesForScopes(scopes, nodes, communities) { const result = new Set(); for (const node of nodes)
+    if (scopes.some((scope) => minimatch(node, scope, { dot: true }) || node.includes(staticPrefix(scope)))) {
+        const community = communities[node];
+        if (community)
+            result.add(community);
+    } return result; }
+async function loadBeforeGraph(root, config, taskId) { const dir = path.resolve(root, config.codeIntelligence?.snapshotDir ?? ".harness/graph"); try {
+    return JSON.parse(await fs.readFile(path.join(dir, taskId, "before.json"), "utf8"));
+}
+catch {
+    return undefined;
+} }
+//# sourceMappingURL=parallelism.js.map

package/dist/agents/parallelism.js.map

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

package/dist/agents/permissions.d.ts

@@ -0,0 +1,5 @@
+import type { HarnessProjectConfig } from "../core/types.js";
+import type { AgentExecutionSelection } from "./types.js";
+export declare function validateExecutionCapabilities(selection: AgentExecutionSelection, transport: string): string[];
+export declare function permissionSummary(selection: AgentExecutionSelection): string;
+export declare function buildOpenCodeRuntimeConfig(selection: AgentExecutionSelection, config?: HarnessProjectConfig): Record<string, unknown>;

package/dist/agents/permissions.js

@@ -0,0 +1,30 @@
+export function validateExecutionCapabilities(selection, transport) { const issues = []; if (selection.nativeAgent && selection.runtimeCapabilities.nativeAgent === false)
+    issues.push(`Runtime ${selection.runtimeName} cannot select native agent ${selection.nativeAgent}.`); if (selection.nativeAgent && transport === "paseo" && selection.runtimeCapabilities.nativeAgentViaPaseo !== true)
+    issues.push(`Agent ${selection.logicalAgent} requires nativeAgent=${selection.nativeAgent}, but runtime ${selection.runtimeName} does not declare nativeAgentViaPaseo. Use transport=direct/podman or configure a Paseo provider that exposes this native agent.`); if (selection.variant && selection.runtimeCapabilities.variantSelection === false)
+    issues.push(`Runtime ${selection.runtimeName} cannot select variant ${selection.variant}.`); if (selection.role === "implementer" && selection.permissions.write === "deny")
+    issues.push(`Implementer ${selection.logicalAgent} denies write permission.`); if ((selection.role === "reviewer" || selection.role === "validator") && selection.permissions.write === "allow")
+    issues.push(`${selection.role} ${selection.logicalAgent} explicitly allows writes; read-only roles should use write=deny unless intentionally mutating.`); if (selection.role === "orchestrator" && selection.permissions.delegate === "deny")
+    issues.push(`Orchestrator ${selection.logicalAgent} denies delegation.`); return issues; }
+export function permissionSummary(selection) { return Object.entries(selection.permissions).map(([key, value]) => `${key}=${value}`).join(", ") || "unspecified"; }
+export function buildOpenCodeRuntimeConfig(selection, config) { const permission = {}; const p = selection.permissions; if (p.read)
+    permission.read = p.read; if (p.write)
+    permission.edit = p.write; if (p.network) {
+    permission.webfetch = p.network;
+    permission.websearch = p.network;
+} if (p.delegate)
+    permission.task = p.delegate; const bash = buildBashPermission(p.shell, p.gitWrite); if (bash)
+    permission.bash = bash; if (selection.skills.length && !selection.skills.includes("*"))
+    permission.skill = Object.fromEntries([["*", "deny"], ...selection.skills.map((skill) => [skill, "allow"])]); const mcp = {}; const tools = {}; const configured = config?.mcp?.servers ?? {}; for (const [name, server] of Object.entries(configured)) {
+    const selected = selection.mcps.includes(name) && server.enabled !== false;
+    tools[`${name}_*`] = selected;
+    if (selected)
+        mcp[name] = toOpenCodeMcp(server);
+} for (const name of selection.mcps)
+    if (!configured[name])
+        tools[`${name}_*`] = true; return { $schema: "https://opencode.ai/config.json", permission, ...(Object.keys(mcp).length ? { mcp } : {}), ...(Object.keys(tools).length ? { tools } : {}) }; }
+function toOpenCodeMcp(server) { if (server.type === "local")
+    return { type: "local", command: server.command, enabled: true, ...(server.environment ? { environment: server.environment } : {}), ...(server.timeoutMs ? { timeout: server.timeoutMs } : {}) }; return { type: "remote", url: server.url, enabled: true, ...(server.headers ? { headers: server.headers } : {}), ...(server.oauth !== undefined ? { oauth: server.oauth } : {}), ...(server.timeoutMs ? { timeout: server.timeoutMs } : {}) }; }
+function buildBashPermission(shell, gitWrite) { if (!gitWrite)
+    return shell; const result = { "*": shell ?? "ask" }; for (const pattern of ["git add *", "git commit *", "git push *", "git tag *", "git checkout *", "git switch *", "git reset *", "git clean *", "git restore *", "git merge *", "git rebase *", "git cherry-pick *"])
+    result[pattern] = gitWrite; return result; }
+//# sourceMappingURL=permissions.js.map

package/dist/agents/permissions.js.map

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

package/dist/agents/qualityConvergence.d.ts

@@ -0,0 +1,44 @@
+import type { HarnessProjectConfig } from "../core/types.js";
+import type { NormalizedFinding } from "./outputContracts.js";
+export type FindingSeverity = NormalizedFinding["severity"];
+export type ConvergenceStatus = "INITIAL" | "CONVERGED" | "IMPROVING" | "STABLE" | "STAGNATING" | "REGRESSING" | "CYCLING";
+export interface SeverityCounts {
+    critical: number;
+    high: number;
+    medium: number;
+    low: number;
+    note: number;
+}
+export interface QualityState {
+    round: number;
+    counts: SeverityCounts;
+    debtPoints: number;
+    debtScore: number;
+    fingerprint: string;
+    findingFingerprints: string[];
+    resolved: string[];
+    persistent: string[];
+    introduced: string[];
+    convergence: ConvergenceStatus;
+    gate: QualityGateResult;
+}
+export interface QualityGateResult {
+    pass: boolean;
+    reasons: string[];
+    counts: SeverityCounts;
+    debtPoints: number;
+    debtScore: number;
+}
+export declare const DEFAULT_SEVERITY_POINTS: Record<FindingSeverity, number>;
+export declare const DEFAULT_FINAL_MAX: SeverityCounts;
+export declare function severityPoints(config: HarnessProjectConfig): Record<FindingSeverity, number>;
+export declare function calculateQuality(findings: NormalizedFinding[], config: HarnessProjectConfig): {
+    counts: SeverityCounts;
+    debtPoints: number;
+    debtScore: number;
+};
+export declare function evaluateFinalQualityGate(findings: NormalizedFinding[], config: HarnessProjectConfig): QualityGateResult;
+export declare function analyzeQualityState(findings: NormalizedFinding[], history: QualityState[], config: HarnessProjectConfig): QualityState;
+export declare function remediationRequired(state: QualityState): boolean;
+export declare function findingFingerprint(finding: NormalizedFinding): string;
+export declare function formatDebtScore(value: number): string;

package/dist/agents/qualityConvergence.js

@@ -0,0 +1,77 @@
+import crypto from "node:crypto";
+export const DEFAULT_SEVERITY_POINTS = { critical: 300, high: 75, medium: 24, low: 3, note: 1 };
+export const DEFAULT_FINAL_MAX = { critical: 0, high: 0, medium: 0, low: 3, note: Number.MAX_SAFE_INTEGER };
+export function severityPoints(config) {
+    return { ...DEFAULT_SEVERITY_POINTS, ...(config.workflow?.reviews?.quality?.severityPoints ?? {}) };
+}
+export function calculateQuality(findings, config) {
+    const counts = { critical: 0, high: 0, medium: 0, low: 0, note: 0 };
+    for (const finding of findings)
+        counts[finding.severity] += 1;
+    const weights = severityPoints(config);
+    const debtPoints = Object.keys(counts).reduce((sum, severity) => sum + counts[severity] * weights[severity], 0);
+    return { counts, debtPoints, debtScore: debtPoints / 3 };
+}
+export function evaluateFinalQualityGate(findings, config) {
+    const { counts, debtPoints, debtScore } = calculateQuality(findings, config);
+    const configured = config.workflow?.reviews?.finalQualityGate?.maxBySeverity ?? {};
+    const max = { ...DEFAULT_FINAL_MAX, ...configured };
+    const maxDebtPoints = config.workflow?.reviews?.finalQualityGate?.maxDebtPoints ?? 9;
+    const reasons = [];
+    for (const severity of ["critical", "high", "medium", "low"]) {
+        if (counts[severity] > max[severity])
+            reasons.push(`${severity}=${counts[severity]} exceeds final maximum ${max[severity]}`);
+    }
+    if (debtPoints > maxDebtPoints)
+        reasons.push(`DebtScore=${formatDebtScore(debtScore)} exceeds final maximum ${formatDebtScore(maxDebtPoints / 3)}`);
+    return { pass: reasons.length === 0, reasons, counts, debtPoints, debtScore };
+}
+export function analyzeQualityState(findings, history, config) {
+    const round = history.length;
+    const findingFingerprints = findings.map(findingFingerprint).sort();
+    const fingerprint = crypto.createHash("sha256").update(findingFingerprints.join("\n")).digest("hex");
+    const current = calculateQuality(findings, config);
+    const gate = evaluateFinalQualityGate(findings, config);
+    const previous = history.at(-1);
+    const previousSet = new Set(previous?.findingFingerprints ?? []);
+    const currentSet = new Set(findingFingerprints);
+    const resolved = [...previousSet].filter((item) => !currentSet.has(item));
+    const persistent = [...currentSet].filter((item) => previousSet.has(item));
+    const introduced = [...currentSet].filter((item) => !previousSet.has(item));
+    const convergence = classifyConvergence({ fingerprint, debtPoints: current.debtPoints, gatePass: gate.pass, history, config });
+    return { round, ...current, fingerprint, findingFingerprints, resolved, persistent, introduced, convergence, gate };
+}
+export function remediationRequired(state) { return !state.gate.pass; }
+function classifyConvergence(input) {
+    if (input.gatePass)
+        return "CONVERGED";
+    const previous = input.history.at(-1);
+    if (!previous)
+        return "INITIAL";
+    const convergence = input.config.workflow?.reviews?.convergence;
+    if (convergence?.regressionDetection !== false && input.debtPoints > previous.debtPoints)
+        return "REGRESSING";
+    if (convergence?.cycleDetection !== false && input.history.some((state) => state.fingerprint === input.fingerprint))
+        return "CYCLING";
+    const minimumImprovement = convergence?.minimumDebtPointImprovement ?? 3;
+    const improvement = previous.debtPoints - input.debtPoints;
+    if (improvement >= minimumImprovement)
+        return "IMPROVING";
+    const window = Math.max(1, convergence?.stagnationWindow ?? 2);
+    const debtSequence = [...input.history.map((state) => state.debtPoints), input.debtPoints].slice(-window);
+    if (debtSequence.length >= window) {
+        let meaningful = false;
+        for (let index = 1; index < debtSequence.length; index += 1)
+            if (debtSequence[index - 1] - debtSequence[index] >= minimumImprovement)
+                meaningful = true;
+        if (!meaningful)
+            return "STAGNATING";
+    }
+    return "STABLE";
+}
+export function findingFingerprint(finding) {
+    const normalized = [finding.category, finding.location.file, finding.location.startLine ?? "", finding.location.endLine ?? "", finding.evidence.toLowerCase().replace(/\s+/g, " ").trim()].join("|");
+    return crypto.createHash("sha256").update(normalized).digest("hex").slice(0, 20);
+}
+export function formatDebtScore(value) { return Number.isInteger(value) ? String(value) : value.toFixed(2).replace(/0+$/, "").replace(/\.$/, ""); }
+//# sourceMappingURL=qualityConvergence.js.map

package/dist/agents/qualityConvergence.js.map

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

package/dist/agents/recovery.d.ts

@@ -0,0 +1,13 @@
+import type { ValidationReport, WorkerSession } from "../core/types.js";
+import type { FailureType, RecoveryStep, ResolvedAgentTopology } from "./types.js";
+export interface FailureEvidence {
+    report?: ValidationReport;
+    worker?: WorkerSession;
+    conflicting?: boolean;
+    wrongAgent?: boolean;
+    missingContext?: boolean;
+    reviewFailure?: boolean;
+}
+export declare function classifyFailure(evidence: FailureEvidence): FailureType;
+export declare function resolveRecoveryStep(topology: ResolvedAgentTopology, failureType: FailureType, attempt: number): RecoveryStep;
+export declare function formatRecoveryAction(step: RecoveryStep, currentAgent: string): string;

package/dist/agents/recovery.js

@@ -0,0 +1,35 @@
+export function classifyFailure(evidence) {
+    if (evidence.conflicting)
+        return "CONFLICTING_RESULTS";
+    if (evidence.wrongAgent)
+        return "WRONG_AGENT";
+    if (evidence.missingContext)
+        return "MISSING_CONTEXT";
+    if (evidence.reviewFailure)
+        return "REVIEW_FAILURE";
+    const output = `${evidence.worker?.stderr ?? ""}\n${evidence.worker?.stdout ?? ""}`.toLowerCase();
+    if (/hunk|patch.*(failed|context)|context.*mismatch|expected lines.*not found/.test(output))
+        return "PATCH_CONTEXT_MISMATCH";
+    if (/timeout|timed out|econnreset|rate limit|\b429\b|\b503\b|tool.*fail/.test(output) || (evidence.worker && evidence.worker.exitCode !== 0))
+        return "TOOL_FAILURE";
+    if (evidence.report?.checks.some((check) => check.status === "FAIL"))
+        return "VALIDATION_FAILURE";
+    if (!output.trim())
+        return "AMBIGUOUS_OUTPUT";
+    return "AMBIGUOUS_OUTPUT";
+}
+export function resolveRecoveryStep(topology, failureType, attempt) {
+    const policy = topology.recovery[failureType] ?? [{ action: "same-agent" }, { action: "lead" }];
+    const index = Math.min(Math.max(attempt - 1, 0), policy.length - 1);
+    return policy[index] ?? { action: "stop" };
+}
+export function formatRecoveryAction(step, currentAgent) {
+    switch (step.action) {
+        case "same-agent": return `retry:${currentAgent}`;
+        case "agent": return `agent:${step.agent ?? "unspecified"}`;
+        case "reroute": return "reroute";
+        case "lead": return "escalate:lead";
+        case "stop": return "stop";
+    }
+}
+//# sourceMappingURL=recovery.js.map

package/dist/agents/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/agents/recovery.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,eAAe,CAAC,QAAyB;IACvD,IAAI,QAAQ,CAAC,WAAW;QAAE,OAAO,qBAAqB,CAAC;IACvD,IAAI,QAAQ,CAAC,UAAU;QAAE,OAAO,aAAa,CAAC;IAC9C,IAAI,QAAQ,CAAC,cAAc;QAAE,OAAO,iBAAiB,CAAC;IACtD,IAAI,QAAQ,CAAC,aAAa;QAAE,OAAO,gBAAgB,CAAC;IACpD,MAAM,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,KAAK,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;IAClG,IAAI,0EAA0E,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,wBAAwB,CAAC;IAC7H,IAAI,oEAAoE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,cAAc,CAAC;IACpK,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAClG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,kBAAkB,CAAC;IAC9C,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAA+B,EAAE,WAAwB,EAAE,OAAe;IAC5G,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChG,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAkB,EAAE,YAAoB;IAC3E,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC,CAAC,OAAO,SAAS,YAAY,EAAE,CAAC;QAClD,KAAK,OAAO,CAAC,CAAC,OAAO,SAAS,IAAI,CAAC,KAAK,IAAI,aAAa,EAAE,CAAC;QAC5D,KAAK,SAAS,CAAC,CAAC,OAAO,SAAS,CAAC;QACjC,KAAK,MAAM,CAAC,CAAC,OAAO,eAAe,CAAC;QACpC,KAAK,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/agents/reviewLifecycle.d.ts

@@ -0,0 +1,30 @@
+import type { AgentExecutionSelection, ResolvedAgentTopology, ResolvedRoute } from "./types.js";
+import { type DedupedFindings } from "./findings.js";
+import { type QualityState } from "./qualityConvergence.js";
+import { type ExceptionDecision } from "./exceptionDetection.js";
+import type { HarnessProjectConfig, TaskContract, ValidationCheck, ValidationReport, WorkerSession } from "../core/types.js";
+export type ReviewFinalState = "ACCEPTED" | "SPEC_CONTRADICTION" | "REQUIRES_PRODUCT_DECISION" | "BLOCKED_EXTERNAL" | "SYSTEM_FAILURE";
+export interface ReviewLifecycleResult {
+    status: "PASS" | "FAIL";
+    finalState: ReviewFinalState;
+    humanRequired: boolean;
+    rounds: number;
+    report: ValidationReport;
+    findings: DedupedFindings;
+    checks: ValidationCheck[];
+    sessions: WorkerSession[];
+    qualityHistory: QualityState[];
+    leadAccepted?: boolean;
+    exception?: ExceptionDecision;
+}
+export declare function runReviewLifecycle(input: {
+    root: string;
+    stateRoot?: string;
+    config: HarnessProjectConfig;
+    contract: TaskContract;
+    topology: ResolvedAgentTopology;
+    route: ResolvedRoute;
+    implementationSelection: AgentExecutionSelection;
+    report: ValidationReport;
+    revalidate: () => Promise<ValidationReport>;
+}): Promise<ReviewLifecycleResult>;