harness-engineering-agent 0.1.0

package/dist/controller/contracts.d.ts

@@ -0,0 +1,65 @@
+import type { Report, Requirement, Run, RunId } from "../domain/index.js";
+import type { SessionAdapter } from "../session/index.js";
+import type { RunStore } from "../store/index.js";
+import type { VerificationRunner } from "../verification/index.js";
+import type { GitWorktreeAdapter, WorkspaceAdapter, WorkspacePolicy } from "../workspace/index.js";
+export type ControllerClock = {
+    readonly now: () => Date;
+};
+export type ControllerIdSource = {
+    readonly createRunId: () => RunId;
+    readonly createEventId: (label: string) => string;
+    readonly createMessageId: (label: string) => string;
+    readonly createEvidenceId: (label: string) => string;
+    readonly createFailureId: (label: string) => string;
+    readonly createAgentResultId: (label: string) => string;
+};
+export type RequirementInput = Omit<Requirement, "schemaVersion">;
+export declare const RUN_BUDGET_KINDS: readonly ["intake", "planner", "task", "repair", "overall"];
+export type RunBudgetKind = (typeof RUN_BUDGET_KINDS)[number];
+export type RunActor = {
+    readonly id: string;
+    readonly type: "user";
+};
+export type PauseRunInput = {
+    readonly runId: RunId;
+    readonly actor: RunActor;
+    readonly reason: string;
+};
+export type AnswerRunInput = {
+    readonly runId: RunId;
+    readonly questionId: string;
+    readonly answer: string;
+    readonly actor: RunActor;
+};
+export type WaiveRunInput = {
+    readonly runId: RunId;
+    readonly requirementId: string;
+    readonly actor: RunActor;
+    readonly reason: string;
+    readonly residualRisk: string;
+};
+export type CreateRunControllerOptions = {
+    readonly store: RunStore;
+    readonly sessionAdapter: SessionAdapter;
+    readonly verificationRunner: VerificationRunner;
+    readonly clock: ControllerClock;
+    readonly ids: ControllerIdSource;
+    readonly workingDirectory: string;
+    readonly maxRunAttempts: number;
+    readonly workspacePolicy?: WorkspacePolicy;
+    readonly workspaceAdapter?: WorkspaceAdapter;
+    readonly workspaceAdapterFactory?: (workingDirectory: string) => WorkspaceAdapter;
+    readonly worktreeAdapter?: GitWorktreeAdapter;
+};
+export interface RunController {
+    start(input: RequirementInput): Promise<Run>;
+    status(runId: RunId): Promise<Run>;
+    pause(input: PauseRunInput): Promise<Run>;
+    answer(input: AnswerRunInput): Promise<Run>;
+    resume(runId: RunId): Promise<Run>;
+    cancel(runId: RunId): Promise<Run>;
+    waive(input: WaiveRunInput): Promise<Run>;
+    report(runId: RunId): Promise<Report>;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/controller/contracts.d.ts.map

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

package/dist/controller/contracts.js

@@ -0,0 +1,2 @@
+export const RUN_BUDGET_KINDS = ["intake", "planner", "task", "repair", "overall"];
+//# sourceMappingURL=contracts.js.map

package/dist/controller/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/controller/contracts.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAA"}

package/dist/controller/errors.d.ts

@@ -0,0 +1,23 @@
+export declare class GraphValidationError extends Error {
+    readonly issues: readonly string[];
+    readonly name = "GraphValidationError";
+    constructor(issues: readonly string[]);
+}
+export declare class AgentRunFailedError extends Error {
+    readonly role: string;
+    readonly message: string;
+    readonly name = "AgentRunFailedError";
+    constructor(role: string, message: string);
+}
+export declare class AgentOutputParseError extends Error {
+    readonly role: string;
+    readonly reason: string;
+    readonly name = "AgentOutputParseError";
+    constructor(role: string, reason: string, options?: ErrorOptions);
+}
+export declare class RunCancellationError extends Error {
+    readonly runId: string;
+    readonly name = "RunCancellationError";
+    constructor(runId: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/controller/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/controller/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAGjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;IAF9C,QAAQ,CAAC,IAAI,0BAAyB;gBAEjB,MAAM,EAAE,SAAS,MAAM,EAAE;CAG/C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAI1C,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM;IAJ1B,QAAQ,CAAC,IAAI,yBAAwB;gBAG1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAI5C,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;IAJzB,QAAQ,CAAC,IAAI,2BAA0B;gBAG5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,YAAY;CAIzB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAGjC,QAAQ,CAAC,KAAK,EAAE,MAAM;IAFlC,QAAQ,CAAC,IAAI,0BAAyB;gBAEjB,KAAK,EAAE,MAAM;CAGnC"}

package/dist/controller/errors.js

@@ -0,0 +1,37 @@
+export class GraphValidationError extends Error {
+    issues;
+    name = "GraphValidationError";
+    constructor(issues) {
+        super(`task graph rejected: ${issues.join("; ")}`);
+        this.issues = issues;
+    }
+}
+export class AgentRunFailedError extends Error {
+    role;
+    message;
+    name = "AgentRunFailedError";
+    constructor(role, message) {
+        super(`${role} agent failed: ${message}`);
+        this.role = role;
+        this.message = message;
+    }
+}
+export class AgentOutputParseError extends Error {
+    role;
+    reason;
+    name = "AgentOutputParseError";
+    constructor(role, reason, options) {
+        super(`${role} agent returned invalid JSON: ${reason}`, options);
+        this.role = role;
+        this.reason = reason;
+    }
+}
+export class RunCancellationError extends Error {
+    runId;
+    name = "RunCancellationError";
+    constructor(runId) {
+        super(`run ${runId} was cancelled`);
+        this.runId = runId;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/controller/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/controller/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAGxB;IAFZ,IAAI,GAAG,sBAAsB,CAAA;IAEtC,YAAqB,MAAyB;QAC5C,KAAK,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAD/B,WAAM,GAAN,MAAM,CAAmB;IAE9C,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAIjC;IACA;IAJF,IAAI,GAAG,qBAAqB,CAAA;IAErC,YACW,IAAY,EACZ,OAAe;QAExB,KAAK,CAAC,GAAG,IAAI,kBAAkB,OAAO,EAAE,CAAC,CAAA;QAHhC,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAQ;IAG1B,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAInC;IACA;IAJF,IAAI,GAAG,uBAAuB,CAAA;IAEvC,YACW,IAAY,EACZ,MAAc,EACvB,OAAsB;QAEtB,KAAK,CAAC,GAAG,IAAI,iCAAiC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAA;QAJvD,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAQ;IAIzB,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAGxB;IAFZ,IAAI,GAAG,sBAAsB,CAAA;IAEtC,YAAqB,KAAa;QAChC,KAAK,CAAC,OAAO,KAAK,gBAAgB,CAAC,CAAA;QADhB,UAAK,GAAL,KAAK,CAAQ;IAElC,CAAC;CACF"}

package/dist/controller/evidence-factory.d.ts

@@ -0,0 +1,15 @@
+import { type Evidence, type RunId, type Task } from "../domain/index.js";
+import { type VerificationRunRecord } from "../verification/index.js";
+import type { ControllerIdSource } from "./contracts.js";
+export declare const createEvidence: (input: {
+    readonly ids: ControllerIdSource;
+    readonly runId: RunId;
+    readonly task: Task;
+    readonly record: VerificationRunRecord;
+    readonly label: string;
+    readonly kind?: Evidence["kind"];
+    readonly summary?: string;
+    readonly changedPaths?: readonly string[];
+    readonly acceptanceCriterionIds?: readonly string[];
+}) => Evidence;
+//# sourceMappingURL=evidence-factory.d.ts.map

package/dist/controller/evidence-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-factory.d.ts","sourceRoot":"","sources":["../../src/controller/evidence-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EAEb,KAAK,KAAK,EAEV,KAAK,IAAI,EACV,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAA+B,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAClG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,eAAO,MAAM,cAAc,GAAI,OAAO;IACpC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACpD,KAAG,QACmF,CAAA"}

package/dist/controller/evidence-factory.js

@@ -0,0 +1,38 @@
+import { EvidenceSchema, redactEvidenceSummary, } from "../domain/index.js";
+import { VerificationExecutionStatus } from "../verification/index.js";
+export const createEvidence = (input) => createEvidenceFromSummary(input, input.summary ?? input.record.output.stdout.summary);
+const createEvidenceFromSummary = (input, rawSummary) => {
+    const sanitized = redactEvidenceSummary(rawSummary);
+    return EvidenceSchema.parse({
+        schemaVersion: "1.0.0",
+        evidenceId: input.ids.createEvidenceId(input.label),
+        taskId: input.task.taskId,
+        runId: input.runId,
+        kind: input.kind ?? "verification",
+        summary: sanitized.summary,
+        summaryDigest: sanitized.summaryDigest,
+        redaction: sanitized.redaction,
+        verificationCommand: input.record.command,
+        changedPaths: input.changedPaths ?? [],
+        outcome: {
+            status: createOutcomeStatus(input.record),
+            exitCode: input.record.exitCode,
+            durationMs: input.record.durationMs,
+            outputDigest: input.record.output.stdout.digest,
+            outputRef: input.record.output.stdout.reference,
+        },
+        relatedRequirementIds: input.task.requirementIds,
+        relatedTaskIds: [input.task.taskId],
+        acceptanceCriterionIds: input.acceptanceCriterionIds ?? [],
+    });
+};
+const createOutcomeStatus = (record) => {
+    switch (record.status) {
+        case VerificationExecutionStatus.passed:
+            return "passed";
+        case VerificationExecutionStatus.failed:
+        case VerificationExecutionStatus.timedOut:
+            return "failed";
+    }
+};
+//# sourceMappingURL=evidence-factory.js.map

package/dist/controller/evidence-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-factory.js","sourceRoot":"","sources":["../../src/controller/evidence-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EAEd,qBAAqB,GAEtB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,2BAA2B,EAA8B,MAAM,0BAA0B,CAAA;AAGlG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAU9B,EAAY,EAAE,CACb,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAEvF,MAAM,yBAAyB,GAAG,CAChC,KAA2C,EAC3C,UAAkB,EACR,EAAE;IACZ,MAAM,SAAS,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAA;IACnD,OAAO,cAAc,CAAC,KAAK,CAAC;QAC1B,aAAa,EAAE,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC;QACnD,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;QACzB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,cAAc;QAClC,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;QACzC,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;QACtC,OAAO,EAAE;YACP,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC;YACzC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ;YAC/B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;YACnC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM;YAC/C,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS;SAChD;QACD,qBAAqB,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc;QAChD,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QACnC,sBAAsB,EAAE,KAAK,CAAC,sBAAsB,IAAI,EAAE;KAC3D,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAAC,MAA6B,EAAuB,EAAE;IACjF,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,2BAA2B,CAAC,MAAM;YACrC,OAAO,QAAQ,CAAA;QACjB,KAAK,2BAA2B,CAAC,MAAM,CAAC;QACxC,KAAK,2BAA2B,CAAC,QAAQ;YACvC,OAAO,QAAQ,CAAA;IACnB,CAAC;AACH,CAAC,CAAA"}

package/dist/controller/failure-analysis.d.ts

@@ -0,0 +1,36 @@
+import { AgentResultSchema, type Evidence, type Failure, type Task } from "../domain/index.js";
+import type { CreateRunControllerOptions } from "./contracts.js";
+import type { PlannedRun } from "./run-state.js";
+import type { FailureAnalyzerOutput } from "./task-agent-schemas.js";
+type FailureAnalysisContext = {
+    readonly options: CreateRunControllerOptions;
+    readonly run: PlannedRun;
+    readonly task: Task;
+    readonly attempt: number;
+    readonly sourceFailure: Failure;
+    readonly evidence: readonly Evidence[];
+    readonly analysis: FailureAnalyzerOutput;
+};
+export type FailureAnalysisResolution = {
+    readonly nextStatus: "executing";
+    readonly taskStatus: "failed";
+    readonly failure: Failure;
+    readonly result: ReturnType<typeof AgentResultSchema.parse>;
+    readonly eventType: "task.repair.requested";
+    readonly eventPayload: {
+        readonly taskId: Task["taskId"];
+        readonly attempt: number;
+        readonly action: "repair";
+        readonly failureId: Failure["failureId"];
+    };
+} | {
+    readonly nextStatus: "clarification_required" | "evidence_gap" | "paused" | "failed";
+    readonly taskStatus: "blocked" | "paused" | "failed";
+    readonly failure: Failure;
+    readonly result: ReturnType<typeof AgentResultSchema.parse>;
+    readonly eventType: "task.clarification.required" | "task.blocked" | "task.failed";
+    readonly eventPayload: Record<string, string | number | readonly string[]>;
+};
+export declare const resolveFailureAnalysis: (context: FailureAnalysisContext) => FailureAnalysisResolution;
+export {};
+//# sourceMappingURL=failure-analysis.d.ts.map

package/dist/controller/failure-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-analysis.d.ts","sourceRoot":"","sources":["../../src/controller/failure-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAC9F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAOhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAEpE,KAAK,sBAAsB,GAAG;IAC5B,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAA;IAC5C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,yBAAyB,GACjC;IACE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAA;IAChC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAC3D,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAA;IAC3C,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;QACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;KACzC,CAAA;CACF,GACD;IACE,QAAQ,CAAC,UAAU,EAAE,wBAAwB,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACpF,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAC3D,QAAQ,CAAC,SAAS,EAAE,6BAA6B,GAAG,cAAc,GAAG,aAAa,CAAA;IAClF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAA;CAC3E,CAAA;AAEL,eAAO,MAAM,sBAAsB,GACjC,SAAS,sBAAsB,KAC9B,yBAuLF,CAAA"}

package/dist/controller/failure-analysis.js

@@ -0,0 +1,175 @@
+import { AgentResultSchema } from "../domain/index.js";
+import { createContextGapFailure, createDependencyBlockedFailure, createImplementationFailure, createRequirementAmbiguityFailure, } from "./failure-factory.js";
+export const resolveFailureAnalysis = (context) => {
+    const evidenceIds = context.evidence.map((item) => item.evidenceId);
+    const resultId = context.options.ids.createAgentResultId(`failure-analyzer-${context.task.taskId}-${context.attempt}`);
+    switch (context.analysis.action) {
+        case "repair": {
+            const failure = createImplementationFailure({
+                failureId: context.options.ids.createFailureId(`${context.task.taskId}-${context.attempt}-repair`),
+                runId: context.run.runId,
+                taskId: context.task.taskId,
+                summary: context.analysis.summary,
+                detail: context.sourceFailure.detail,
+                recoveryPlan: "Prepare a bounded repair task after explicit controller approval.",
+                ...(evidenceIds[0] === undefined ? {} : { failingEvidenceId: evidenceIds[0] }),
+            });
+            const result = AgentResultSchema.parse({
+                schemaVersion: "1.0.0",
+                resultId,
+                runId: context.run.runId,
+                taskId: context.task.taskId,
+                role: "failure-analyzer",
+                status: "failed",
+                summary: context.analysis.summary,
+                evidenceIds,
+                failureId: failure.failureId,
+            });
+            return {
+                nextStatus: "executing",
+                taskStatus: "failed",
+                failure,
+                result,
+                eventType: "task.repair.requested",
+                eventPayload: {
+                    taskId: context.task.taskId,
+                    attempt: context.attempt,
+                    action: "repair",
+                    failureId: failure.failureId,
+                },
+            };
+        }
+        case "clarify": {
+            if (context.analysis.category === "context-gap") {
+                const failure = createContextGapFailure({
+                    failureId: context.options.ids.createFailureId(`${context.task.taskId}-${context.attempt}-context-gap`),
+                    runId: context.run.runId,
+                    taskId: context.task.taskId,
+                    relatedEvidenceIds: evidenceIds,
+                    summary: context.analysis.summary,
+                    detail: context.sourceFailure.detail,
+                    recoveryPlan: "Collect the missing context before retrying the task.",
+                    missingContext: context.analysis.missingContext,
+                });
+                const result = AgentResultSchema.parse({
+                    schemaVersion: "1.0.0",
+                    resultId,
+                    runId: context.run.runId,
+                    taskId: context.task.taskId,
+                    role: "failure-analyzer",
+                    status: "evidence_gap",
+                    summary: context.analysis.summary,
+                    evidenceIds,
+                    missingEvidenceKinds: ["artifact-summary"],
+                });
+                return {
+                    nextStatus: "evidence_gap",
+                    taskStatus: "blocked",
+                    failure,
+                    result,
+                    eventType: "task.clarification.required",
+                    eventPayload: {
+                        taskId: context.task.taskId,
+                        attempt: context.attempt,
+                        missingContext: context.analysis.missingContext,
+                    },
+                };
+            }
+            const questionId = `question-${context.run.runId}-${context.task.taskId}-${context.attempt}`;
+            const failure = createRequirementAmbiguityFailure({
+                failureId: context.options.ids.createFailureId(`${context.task.taskId}-${context.attempt}-requirement-ambiguity`),
+                runId: context.run.runId,
+                taskId: context.task.taskId,
+                relatedEvidenceIds: evidenceIds,
+                summary: context.analysis.summary,
+                detail: context.sourceFailure.detail,
+                recoveryPlan: "Answer the blocking requirement question before continuing.",
+                blockingQuestionId: questionId,
+            });
+            const result = AgentResultSchema.parse({
+                schemaVersion: "1.0.0",
+                resultId,
+                runId: context.run.runId,
+                taskId: context.task.taskId,
+                role: "failure-analyzer",
+                status: "blocked",
+                summary: context.analysis.summary,
+                evidenceIds,
+                blockingReason: questionId,
+            });
+            return {
+                nextStatus: "clarification_required",
+                taskStatus: "blocked",
+                failure,
+                result,
+                eventType: "task.clarification.required",
+                eventPayload: {
+                    taskId: context.task.taskId,
+                    attempt: context.attempt,
+                    blockingQuestionId: questionId,
+                },
+            };
+        }
+        case "wait": {
+            const failure = createDependencyBlockedFailure({
+                failureId: context.options.ids.createFailureId(`${context.task.taskId}-${context.attempt}-dependency-blocked`),
+                runId: context.run.runId,
+                taskId: context.task.taskId,
+                relatedEvidenceIds: evidenceIds,
+                summary: context.analysis.summary,
+                detail: context.sourceFailure.detail,
+                recoveryPlan: "Wait until the blocking dependency becomes available.",
+                blockedDependency: context.analysis.blockedDependency,
+            });
+            const result = AgentResultSchema.parse({
+                schemaVersion: "1.0.0",
+                resultId,
+                runId: context.run.runId,
+                taskId: context.task.taskId,
+                role: "failure-analyzer",
+                status: "blocked",
+                summary: context.analysis.summary,
+                evidenceIds,
+                blockingReason: context.analysis.blockedDependency,
+            });
+            return {
+                nextStatus: "paused",
+                taskStatus: "paused",
+                failure,
+                result,
+                eventType: "task.blocked",
+                eventPayload: {
+                    taskId: context.task.taskId,
+                    attempt: context.attempt,
+                    blockedDependency: context.analysis.blockedDependency,
+                },
+            };
+        }
+        case "terminate": {
+            const result = AgentResultSchema.parse({
+                schemaVersion: "1.0.0",
+                resultId,
+                runId: context.run.runId,
+                taskId: context.task.taskId,
+                role: "failure-analyzer",
+                status: "failed",
+                summary: context.analysis.summary,
+                evidenceIds,
+                failureId: context.sourceFailure.failureId,
+            });
+            return {
+                nextStatus: "failed",
+                taskStatus: "failed",
+                failure: context.sourceFailure,
+                result,
+                eventType: "task.failed",
+                eventPayload: {
+                    taskId: context.task.taskId,
+                    attempt: context.attempt,
+                    failureId: context.sourceFailure.failureId,
+                },
+            };
+        }
+    }
+};
+//# sourceMappingURL=failure-analysis.js.map

package/dist/controller/failure-analysis.js.map

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

package/dist/controller/failure-factory.d.ts

@@ -0,0 +1,85 @@
+import { type Failure, type RunId, type TaskId } from "../domain/index.js";
+export declare const createModelFailure: (input: {
+    readonly failureId: string;
+    readonly runId: RunId;
+    readonly taskId: TaskId;
+    readonly provider: string;
+    readonly summary: string;
+    readonly detail: string;
+    readonly recoveryPlan: string;
+}) => Failure;
+export declare const createImplementationFailure: (input: {
+    readonly failureId: string;
+    readonly runId: RunId;
+    readonly taskId: TaskId;
+    readonly failingEvidenceId?: string;
+    readonly rootCauseFingerprint?: string;
+    readonly summary: string;
+    readonly detail: string;
+    readonly recoveryPlan: string;
+}) => Failure;
+export declare const createVerificationEnvironmentFailure: (input: {
+    readonly failureId: string;
+    readonly runId: RunId;
+    readonly taskId: TaskId;
+    readonly commandName: string;
+    readonly detail: string;
+}) => Failure;
+export declare const createAcceptanceFailure: (input: {
+    readonly failureId: string;
+    readonly runId: RunId;
+    readonly taskId: TaskId;
+    readonly failingEvidenceId: string;
+    readonly summary: string;
+    readonly detail: string;
+    readonly recoveryPlan: string;
+}) => Failure;
+export declare const createContextGapFailure: (input: {
+    readonly failureId: string;
+    readonly runId: RunId;
+    readonly taskId: TaskId;
+    readonly relatedEvidenceIds: readonly string[];
+    readonly summary: string;
+    readonly detail: string;
+    readonly recoveryPlan: string;
+    readonly missingContext: readonly string[];
+}) => Failure;
+export declare const createRequirementAmbiguityFailure: (input: {
+    readonly failureId: string;
+    readonly runId: RunId;
+    readonly taskId: TaskId;
+    readonly relatedEvidenceIds: readonly string[];
+    readonly summary: string;
+    readonly detail: string;
+    readonly recoveryPlan: string;
+    readonly blockingQuestionId: string;
+}) => Failure;
+export declare const createDependencyBlockedFailure: (input: {
+    readonly failureId: string;
+    readonly runId: RunId;
+    readonly taskId: TaskId;
+    readonly relatedEvidenceIds: readonly string[];
+    readonly summary: string;
+    readonly detail: string;
+    readonly recoveryPlan: string;
+    readonly blockedDependency: string;
+}) => Failure;
+export declare const createScopeDriftFailure: (input: {
+    readonly failureId: string;
+    readonly runId: RunId;
+    readonly taskId: TaskId;
+    readonly driftedPaths: readonly string[];
+    readonly summary: string;
+    readonly detail: string;
+    readonly recoveryPlan: string;
+}) => Failure;
+export declare const createMergeConflictFailure: (input: {
+    readonly failureId: string;
+    readonly runId: RunId;
+    readonly taskId: TaskId;
+    readonly conflictingPaths: readonly string[];
+    readonly summary: string;
+    readonly detail: string;
+    readonly recoveryPlan: string;
+}) => Failure;
+//# sourceMappingURL=failure-factory.d.ts.map

package/dist/controller/failure-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-factory.d.ts","sourceRoot":"","sources":["../../src/controller/failure-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAiB,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEzF,eAAO,MAAM,kBAAkB,GAAI,OAAO;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,KAAG,OAaA,CAAA;AAEJ,eAAO,MAAM,2BAA2B,GAAI,OAAO;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,KAAG,OAkBA,CAAA;AAEJ,eAAO,MAAM,oCAAoC,GAAI,OAAO;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,KAAG,OAcA,CAAA;AAEJ,eAAO,MAAM,uBAAuB,GAAI,OAAO;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,KAAG,OAaA,CAAA;AAEJ,eAAO,MAAM,uBAAuB,GAAI,OAAO;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3C,KAAG,OAaA,CAAA;AAEJ,eAAO,MAAM,iCAAiC,GAAI,OAAO;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACpC,KAAG,OAaA,CAAA;AAEJ,eAAO,MAAM,8BAA8B,GAAI,OAAO;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CACnC,KAAG,OAaA,CAAA;AAEJ,eAAO,MAAM,uBAAuB,GAAI,OAAO;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,KAAG,OAaA,CAAA;AAEJ,eAAO,MAAM,0BAA0B,GAAI,OAAO;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,KAAG,OAaA,CAAA"}