agentic-engineering-harness 0.4.16

package/dist/core/init.js

@@ -0,0 +1,52 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+function packageRoot() { return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); }
+async function exists(file) { try {
+    await fs.access(file);
+    return true;
+}
+catch {
+    return false;
+} }
+async function copyFileIfMissing(source, destination) { if (await exists(destination))
+    return; await fs.mkdir(path.dirname(destination), { recursive: true }); await fs.copyFile(source, destination); }
+async function copyTree(source, destination) { await fs.mkdir(destination, { recursive: true }); for (const entry of await fs.readdir(source, { withFileTypes: true })) {
+    const src = path.join(source, entry.name);
+    const dst = path.join(destination, entry.name);
+    if (entry.isDirectory())
+        await copyTree(src, dst);
+    else
+        await copyFileIfMissing(src, dst);
+} }
+export async function initializeProject(root) {
+    const pkg = packageRoot();
+    const created = [];
+    const mappings = [["templates/project.yaml", ".harness/project.yaml"], ["templates/toolchain.yaml", ".harness/toolchain.yaml"], ["templates/agents.source.jsonc", ".harness/agents.source.jsonc"], ["templates/AGENTS.md", "AGENTS.md"], ["templates/otel-collector.yaml", ".harness/otel-collector.yaml"]];
+    for (const [src, dst] of mappings) {
+        const target = path.join(root, dst);
+        if (!(await exists(target))) {
+            await copyFileIfMissing(path.join(pkg, src), target);
+            created.push(dst);
+        }
+    }
+    await copyTree(path.join(pkg, "policies", "core"), path.join(root, ".harness", "policies", "core"));
+    await copyTree(path.join(pkg, "skills"), path.join(root, ".harness", "skills"));
+    for (const dir of [".harness/bin", ".harness/contracts", ".harness/seals", ".harness/reports", ".harness/repairs", ".harness/runs", ".harness/telemetry", ".harness/evals/results", ".harness/evals/workspaces", ".harness/provenance", ".harness/generated", ".harness/findings", ".harness/delivery", ".config/mise/conf.d", "specs/changes", "docs/decisions", "evals/corpus", "memory-benchmarks"])
+        await fs.mkdir(path.join(root, dir), { recursive: true });
+    if (await ensureGitignore(root))
+        created.push(".gitignore (AEH generated-state block)");
+    return created;
+}
+async function ensureGitignore(root) {
+    const file = path.join(root, ".gitignore");
+    const marker = "# BEGIN Agentic Engineering Harness generated state";
+    const block = `${marker}\n.harness/bin/\n.harness/toolchain.state.json\n.harness/generated/\n.harness/contracts/\n.harness/seals/\n.harness/reports/\n.harness/repairs/\n.harness/runs/\n.harness/telemetry/\n.harness/findings/\n.harness/evals/\n.harness/provenance/\n.harness/delivery/\n.harness/issues/\n.config/mise/conf.d/aeh.toml\n# END Agentic Engineering Harness generated state`;
+    const current = await fs.readFile(file, "utf8").catch(() => "");
+    if (current.includes(marker))
+        return false;
+    const prefix = current && !current.endsWith("\n") ? `${current}\n` : current;
+    await fs.writeFile(file, `${prefix}${prefix ? "\n" : ""}${block}\n`);
+    return true;
+}
+//# sourceMappingURL=init.js.map

package/dist/core/init.js.map

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

package/dist/core/quick.d.ts

@@ -0,0 +1,20 @@
+import type { HarnessProjectConfig, TaskContract } from "./types.js";
+import { type TriageFlag } from "./triage.js";
+export interface CreateQuickContractInput {
+    title: string;
+    request: string;
+    scope: string[];
+    acceptance: string[];
+    domains?: string[];
+    risk?: "low" | "medium" | "high";
+    flags?: TriageFlag[];
+    profile?: string;
+}
+export declare function createQuickContract(root: string, config: HarnessProjectConfig, taskId: string, input: CreateQuickContractInput): Promise<{
+    file: string;
+    contract: TaskContract;
+}>;
+export declare function validateQuickTaskContract(config: HarnessProjectConfig, contract: TaskContract): {
+    ok: boolean;
+    issues: string[];
+};

package/dist/core/quick.js

@@ -0,0 +1,49 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+import { triageChange } from "./triage.js";
+export async function createQuickContract(root, config, taskId, input) {
+    const decision = triageChange(config, { request: input.request, files: input.scope, domains: input.domains, risk: input.risk, flags: input.flags });
+    if (!decision.quickEligible)
+        throw new Error(`QUICK_MODE_REJECTED: ${decision.reasons.join("; ")}. Create an SDD change instead.`);
+    if (!input.acceptance.length)
+        throw new Error("QUICK_MODE_REJECTED: at least one observable acceptance statement is required.");
+    const contract = {
+        version: 1,
+        mode: "quick",
+        task: { id: taskId, title: input.title },
+        quick: { request: input.request, acceptance: input.acceptance, triage: { mode: decision.mode, reasons: decision.reasons, evaluatedAt: new Date().toISOString() } },
+        git: { baseRef: config.validation?.baseRef ?? "main" },
+        scope: { allowed: [...new Set(input.scope)], forbidden: [], frozen: [] },
+        routing: { intent: "implement", domains: [...new Set(input.domains ?? [])], risk: "low", profile: input.profile },
+        constraints: { breakingApiChanges: false, newDependencies: false, schemaChanges: false, maxFilesChanged: config.workflow?.quick?.maxFiles ?? 5 },
+        repair: { maxAttempts: config.orchestration?.worker?.maxRepairAttempts ?? 2 }
+    };
+    const contractsDir = path.resolve(root, config.sdd?.contractsDir ?? ".harness/contracts");
+    await fs.mkdir(contractsDir, { recursive: true });
+    const file = path.join(contractsDir, `${taskId}.yaml`);
+    await fs.writeFile(file, YAML.stringify(contract));
+    return { file, contract };
+}
+export function validateQuickTaskContract(config, contract) {
+    const issues = [];
+    if (contract.mode !== "quick")
+        return { ok: true, issues };
+    if (!contract.quick?.request?.trim())
+        issues.push("quick.request is required");
+    if (!contract.quick?.acceptance?.length)
+        issues.push("quick.acceptance must contain at least one observable statement");
+    const scope = contract.scope?.allowed ?? [];
+    const evidence = { request: contract.quick?.request ?? "", files: scope, domains: contract.routing?.domains, risk: contract.routing?.risk ?? "low" };
+    const decision = triageChange(config, evidence);
+    if (!decision.quickEligible)
+        issues.push(...decision.reasons.map((reason) => `quick triage no longer qualifies: ${reason}`));
+    if (contract.constraints?.breakingApiChanges !== false)
+        issues.push("quick mode requires breakingApiChanges=false");
+    if (contract.constraints?.newDependencies !== false)
+        issues.push("quick mode requires newDependencies=false");
+    if (contract.constraints?.schemaChanges !== false)
+        issues.push("quick mode requires schemaChanges=false");
+    return { ok: issues.length === 0, issues };
+}
+//# sourceMappingURL=quick.js.map

package/dist/core/quick.js.map

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

package/dist/core/repair.d.ts

@@ -0,0 +1,8 @@
+import type { HarnessProjectConfig, RepairPacket, ValidationReport } from "./types.js";
+import type { FailureType } from "../agents/types.js";
+export declare function createRepairPacket(report: ValidationReport, attempt: number, context?: {
+    failureType?: FailureType;
+    failedAgent?: string;
+    recoveryAction?: string;
+}): RepairPacket;
+export declare function writeRepairPacket(root: string, config: HarnessProjectConfig, packet: RepairPacket): Promise<string>;

package/dist/core/repair.js

@@ -0,0 +1,7 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export function createRepairPacket(report, attempt, context) {
+    return { version: 1, taskId: report.taskId, attempt, createdAt: new Date().toISOString(), failureType: context?.failureType, failedAgent: context?.failedAgent, recoveryAction: context?.recoveryAction, failures: report.checks.filter((check) => check.status === "FAIL").map((check) => ({ id: check.id, category: check.category, message: check.message, details: check.details })) };
+}
+export async function writeRepairPacket(root, config, packet) { const repairsDir = path.resolve(root, config.sdd?.repairsDir ?? ".harness/repairs"); await fs.mkdir(repairsDir, { recursive: true }); const file = path.join(repairsDir, `${packet.taskId}-${packet.attempt}.json`); await fs.writeFile(file, `${JSON.stringify(packet, null, 2)}\n`); return file; }
+//# sourceMappingURL=repair.js.map

package/dist/core/repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.js","sourceRoot":"","sources":["../../src/core/repair.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,UAAU,kBAAkB,CAAC,MAAwB,EAAE,OAAe,EAAE,OAAsF;IAClK,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;AAC7X,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAA4B,EAAE,MAAoB,IAAqB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,UAAU,IAAI,kBAAkB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC"}

package/dist/core/run.d.ts

@@ -0,0 +1,38 @@
+import type { SeverityCounts } from "../agents/qualityConvergence.js";
+import type { HarnessProjectConfig, RunMetrics, TaskContract, ValidationReport, WorkerSession } from "./types.js";
+import { type DeliveryFinalizationResult } from "../delivery/finalize.js";
+export interface TaskRunResult {
+    taskId: string;
+    status: "PASS" | "FAIL";
+    attempts: number;
+    worker: WorkerSession;
+    report: ValidationReport;
+    metrics: RunMetrics;
+    routing?: {
+        profile?: string;
+        ruleIds: string[];
+        agent: string;
+        runtime: string;
+        model: string;
+        nativeAgent?: string;
+        reviewers: string[];
+        validators: string[];
+    };
+    review?: {
+        status: "PASS" | "FAIL";
+        finalState: string;
+        humanRequired: boolean;
+        rounds: number;
+        findings: number;
+        debtScore: number;
+        debtPoints: number;
+        counts: SeverityCounts;
+        convergence: string;
+        leadAccepted?: boolean;
+        reviewerSessions: number;
+    };
+    delivery?: DeliveryFinalizationResult;
+}
+export declare function runTask(root: string, config: HarnessProjectConfig, contract: TaskContract, options?: {
+    profile?: string;
+}): Promise<TaskRunResult>;

package/dist/core/run.js

@@ -0,0 +1,165 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { auditAgentTopology } from "../agents/audit.js";
+import { loadResolvedAgentTopology } from "../agents/config.js";
+import { classifyFailure, formatRecoveryAction, resolveRecoveryStep } from "../agents/recovery.js";
+import { executionSelectionForAgent, selectExecutionForTask, selectFallbackExecution } from "../agents/routing.js";
+import { validateExecutionCapabilities } from "../agents/permissions.js";
+import { runReviewLifecycle } from "../agents/reviewLifecycle.js";
+import { loadTaskContract } from "./config.js";
+import { validateSddChange } from "./sdd.js";
+import { validateQuickTaskContract } from "./quick.js";
+import { sealTask, verifyTaskSeal } from "./seal.js";
+import { verifyTask } from "./verify.js";
+import { createRepairPacket, writeRepairPacket } from "./repair.js";
+import { createWorkerExecutor } from "../workers/factory.js";
+import { snapshotGraph } from "../validators/graphify.js";
+import { runProcess } from "../utils/process.js";
+import { recordEvent } from "../telemetry/events.js";
+import { extractUsageMetrics } from "../metrics/usage.js";
+import { buildRunMetrics, countHumanInterventions } from "../metrics/runMetrics.js";
+import { deliveryWorkspacePath } from "../delivery/handoff.js";
+import { deliveryFinalizationFailure, finalizeAcceptedIssue } from "../delivery/finalize.js";
+import { verifyGithubIssueDrift } from "../issues/intake.js";
+export async function runTask(root, config, contract, options) {
+    const controlRoot = path.resolve(root);
+    const workspaceRoot = path.resolve(await deliveryWorkspacePath(controlRoot, config, contract.task.id) ?? controlRoot);
+    const effectiveContract = workspaceRoot === controlRoot ? contract : await loadTaskContract(workspaceRoot, contract.task.id, config);
+    const startedMs = Date.now();
+    const startedAt = new Date(startedMs).toISOString();
+    const issueDrift = await verifyGithubIssueDrift(controlRoot, config, effectiveContract);
+    if (!issueDrift.ok)
+        throw new Error(issueDrift.message);
+    if (effectiveContract.issue)
+        await recordEvent(controlRoot, config, "harness.issue.drift-check", { taskId: effectiveContract.task.id, issue: effectiveContract.issue.number, repository: effectiveContract.issue.repository, ok: true, contentSha256: effectiveContract.issue.contentSha256 });
+    if (effectiveContract.mode === "quick") {
+        const quick = validateQuickTaskContract(config, effectiveContract);
+        if (!quick.ok)
+            throw new Error(`QuickContract validation failed before delegation:\n${quick.issues.map((item) => `- ${item}`).join("\n")}\nEscalate this change to SDD/spec mode.`);
+    }
+    else {
+        const trace = await validateSddChange(workspaceRoot, effectiveContract.task.id, config);
+        if (!trace.ok)
+            throw new Error(`SDD validation failed before delegation:\n${[...trace.missing, ...trace.issues].map((item) => `- ${item}`).join("\n")}`);
+    }
+    await recordEvent(controlRoot, config, "harness.run.start", { taskId: effectiveContract.task.id, mode: effectiveContract.mode ?? "spec", workspaceRoot: workspaceRoot === controlRoot ? undefined : workspaceRoot, issue: effectiveContract.issue ? { repository: effectiveContract.issue.repository, number: effectiveContract.issue.number } : undefined });
+    if (workspaceRoot === controlRoot)
+        await sealTask(controlRoot, config, effectiveContract);
+    else {
+        const seal = await verifyTaskSeal(workspaceRoot, effectiveContract, config.validation?.requireSeal ?? true);
+        if (seal.status === "FAIL")
+            throw new Error(`Delivery workspace trust check failed before delegation: ${seal.message}`);
+    }
+    const topologyState = await resolveTopology(controlRoot, config, effectiveContract, options?.profile);
+    const topology = topologyState.topology;
+    const route = topologyState.route;
+    let selection = topologyState.selection;
+    await refreshGraphIfConfigured(workspaceRoot, config);
+    const beforeSnapshot = await snapshotGraph(workspaceRoot, config, effectiveContract.task.id, "before");
+    if (!beforeSnapshot && config.codeIntelligence?.required)
+        throw new Error("Code intelligence is required but the Graphify before snapshot could not be created.");
+    let executor = createWorkerExecutor(config, selection);
+    const health = await executor.doctor(workspaceRoot, config, selection);
+    if (!health.ok)
+        throw new Error(`${executor.name} executor unavailable: ${health.message}`);
+    let worker = await executor.start(workspaceRoot, config, effectiveContract, selection);
+    let attempts = 0;
+    let report = withWorkerExecutionCheck(await verifyAfterWorker(workspaceRoot, controlRoot, config, effectiveContract), worker);
+    const firstPassSuccess = report.status === "PASS";
+    const maxRepairs = effectiveContract.repair?.maxAttempts ?? config.orchestration?.worker?.maxRepairAttempts ?? 2;
+    while (report.status === "FAIL" && attempts < maxRepairs) {
+        attempts += 1;
+        const failureType = classifyFailure({ report, worker });
+        const recovery = topology ? resolveRecoveryStep(topology, failureType, attempts) : { action: "same-agent" };
+        const recoveryAction = formatRecoveryAction(recovery, selection?.logicalAgent ?? "legacy-worker");
+        const packet = createRepairPacket(report, attempts, { failureType, failedAgent: selection?.logicalAgent, recoveryAction });
+        if (!packet.failures.length)
+            break;
+        await writeRepairPacket(controlRoot, config, packet);
+        await recordEvent(controlRoot, config, "harness.repair.start", { taskId: effectiveContract.task.id, attempt: attempts, failureType, recoveryAction, failures: packet.failures.length });
+        if (recovery.action === "lead" || recovery.action === "stop")
+            break;
+        if (topology && recovery.action === "agent" && recovery.agent)
+            selection = executionSelectionForAgent(topology, recovery.agent);
+        else if (topology && recovery.action === "reroute") {
+            const fallback = selectFallbackExecution(topology, effectiveContract, selection?.logicalAgent ?? "");
+            if (!fallback)
+                break;
+            selection = fallback;
+        }
+        if (selection) {
+            const transport = selection.transport === "inherit" ? (config.orchestration?.provider ?? "none") : selection.transport;
+            const issues = validateExecutionCapabilities(selection, transport);
+            if (issues.length)
+                throw new Error(`Recovery agent ${selection.logicalAgent} is not executable: ${issues.join("; ")}`);
+        }
+        executor = createWorkerExecutor(config, selection);
+        const recoveryHealth = await executor.doctor(workspaceRoot, config, selection);
+        if (!recoveryHealth.ok)
+            throw new Error(`${executor.name} recovery executor unavailable: ${recoveryHealth.message}`);
+        worker = await executor.repair(workspaceRoot, config, effectiveContract, worker, packet, selection);
+        report = withWorkerExecutionCheck(await verifyAfterWorker(workspaceRoot, controlRoot, config, effectiveContract), worker);
+        await recordEvent(controlRoot, config, "harness.repair.finish", { taskId: effectiveContract.task.id, attempt: attempts, status: report.status, agent: selection?.logicalAgent });
+    }
+    let reviewSummary;
+    if (report.status === "PASS" && topology && route && selection) {
+        const review = await runReviewLifecycle({ root: workspaceRoot, stateRoot: controlRoot, config, contract: effectiveContract, topology, route, implementationSelection: selection, report, revalidate: async () => verifyAfterWorker(workspaceRoot, controlRoot, config, effectiveContract) });
+        report = mergeChecks(withWorkerExecutionCheck(review.report, worker), review.checks);
+        const quality = review.qualityHistory.at(-1);
+        reviewSummary = { status: review.status, finalState: review.finalState, humanRequired: review.humanRequired, rounds: review.rounds, findings: review.findings.outputCount, debtScore: quality.debtScore, debtPoints: quality.debtPoints, counts: quality.counts, convergence: quality.convergence, leadAccepted: review.leadAccepted, reviewerSessions: review.sessions.length };
+        await recordEvent(controlRoot, config, "harness.review.finish", { taskId: effectiveContract.task.id, status: review.status, finalState: review.finalState, humanRequired: review.humanRequired, rounds: review.rounds, findings: review.findings.outputCount, debtScore: quality.debtScore, convergence: quality.convergence, leadAccepted: review.leadAccepted, sessions: review.sessions.length });
+    }
+    let deliverySummary;
+    if (report.status === "PASS") {
+        try {
+            deliverySummary = await finalizeAcceptedIssue(workspaceRoot, config, effectiveContract);
+            if (deliverySummary.status !== "SKIPPED")
+                await recordEvent(controlRoot, config, "harness.delivery.finalize", { taskId: effectiveContract.task.id, status: deliverySummary.status, commitSha: deliverySummary.commitSha, pullRequest: deliverySummary.pullRequest });
+        }
+        catch (error) {
+            deliverySummary = deliveryFinalizationFailure(error);
+            report = mergeChecks(report, [{ id: "delivery.finalization", category: "delivery", status: "FAIL", message: deliverySummary.message, details: { status: deliverySummary.status, humanRequired: deliverySummary.humanRequired } }]);
+            if (reviewSummary && deliverySummary.humanRequired)
+                reviewSummary = { ...reviewSummary, status: "FAIL", finalState: "BLOCKED_EXTERNAL", humanRequired: true };
+            await recordEvent(controlRoot, config, "harness.delivery.finalize", { taskId: effectiveContract.task.id, status: deliverySummary.status, humanRequired: deliverySummary.humanRequired, message: deliverySummary.message });
+        }
+    }
+    worker.metrics = extractUsageMetrics(`${worker.stdout}\n${worker.stderr}`);
+    const metrics = buildRunMetrics({ firstPassSuccess, repairCount: attempts, humanInterventions: await countHumanInterventions(controlRoot, config, effectiveContract.task.id, startedAt), durationMs: Date.now() - startedMs, usage: worker.metrics });
+    const routing = selection ? { profile: selection.profile, ruleIds: route?.ruleIds ?? [], agent: selection.logicalAgent, runtime: selection.runtimeName, model: selection.modelId, nativeAgent: selection.nativeAgent, reviewers: route?.reviewers ?? [], validators: route?.validators ?? [] } : undefined;
+    const result = { taskId: effectiveContract.task.id, status: report.status, attempts, worker, report, metrics, routing, review: reviewSummary, delivery: deliverySummary };
+    const runsDir = path.resolve(controlRoot, config.sdd?.runsDir ?? ".harness/runs");
+    await fs.mkdir(runsDir, { recursive: true });
+    await fs.writeFile(path.join(runsDir, `${effectiveContract.task.id}.json`), `${JSON.stringify(result, null, 2)}\n`);
+    await recordEvent(controlRoot, config, "harness.run.finish", { taskId: effectiveContract.task.id, status: result.status, attempts, mode: effectiveContract.mode ?? "spec", workspaceRoot: workspaceRoot === controlRoot ? undefined : workspaceRoot, agent: selection?.logicalAgent, runtime: selection?.runtimeName, model: selection?.modelId, profile: selection?.profile, reviewStatus: reviewSummary?.status, reviewFinalState: reviewSummary?.finalState, humanRequired: reviewSummary?.humanRequired ?? deliverySummary?.humanRequired, debtScore: reviewSummary?.debtScore, deliveryStatus: deliverySummary?.status, pullRequest: deliverySummary?.pullRequest, durationMs: metrics.durationMs, totalTokens: metrics.usage.totalTokens ?? 0, costUsd: metrics.usage.costUsd ?? 0 });
+    return result;
+}
+async function resolveTopology(root, config, contract, profileOverride) { if (!config.agents)
+    return {}; const explicitProfile = profileOverride ?? contract.routing?.profile; const profile = explicitProfile ?? config.agents.activeProfile; try {
+    const audit = await auditAgentTopology(root, config, profile, { checkGenerated: !explicitProfile });
+    if (!audit.ok)
+        throw new Error(`Agent topology audit failed:\n${audit.checks.filter((check) => check.status === "FAIL").map((check) => `- ${check.id}: ${check.message}`).join("\n")}`);
+    const topology = await loadResolvedAgentTopology(root, config, profile);
+    const { route, selection } = selectExecutionForTask(topology, contract);
+    const transport = selection.transport === "inherit" ? (config.orchestration?.provider ?? "none") : selection.transport;
+    const issues = validateExecutionCapabilities(selection, transport);
+    if (issues.length)
+        throw new Error(`Selected agent ${selection.logicalAgent} is not executable: ${issues.join("; ")}`);
+    await recordEvent(root, config, "harness.agent.route", { taskId: contract.task.id, profile, agent: selection.logicalAgent, runtime: selection.runtimeName, model: selection.modelId, nativeAgent: selection.nativeAgent, transport, ruleIds: route.ruleIds, reviewers: route.reviewers });
+    return { topology, route, selection };
+}
+catch (error) {
+    if (config.agents.required)
+        throw error;
+    await recordEvent(root, config, "harness.agent.topology-fallback", { taskId: contract.task.id, error: String(error) });
+    return {};
+} }
+function withWorkerExecutionCheck(report, worker) { const checks = report.checks.filter((check) => check.id !== "agent.execution"); checks.unshift({ id: "agent.execution", category: "agent-runtime", status: worker.exitCode === 0 ? "PASS" : "FAIL", message: worker.exitCode === 0 ? `Agent ${worker.logicalAgent ?? worker.provider} completed successfully.` : `Agent runtime exited with code ${worker.exitCode}.`, details: worker.exitCode === 0 ? undefined : { stderr: worker.stderr.slice(-4000), stdout: worker.stdout.slice(-4000), logicalAgent: worker.logicalAgent, runtime: worker.runtime, model: worker.model } }); return { ...report, checks, status: checks.some((check) => check.status === "FAIL") ? "FAIL" : "PASS" }; }
+function mergeChecks(report, extra) { const byId = new Map(report.checks.map((check) => [check.id, check])); for (const check of extra)
+    byId.set(check.id, check); const checks = [...byId.values()]; return { ...report, checks, status: checks.some((check) => check.status === "FAIL") ? "FAIL" : "PASS" }; }
+async function verifyAfterWorker(workspaceRoot, controlRoot, config, contract) { await refreshGraphIfConfigured(workspaceRoot, config); const afterSnapshot = await snapshotGraph(workspaceRoot, config, contract.task.id, "after"); if (!afterSnapshot && config.codeIntelligence?.required)
+    throw new Error("Code intelligence is required but the Graphify after snapshot could not be created."); return verifyTask(workspaceRoot, config, contract, { stateRoot: controlRoot, policyRoot: controlRoot }); }
+async function refreshGraphIfConfigured(root, config) { const command = config.codeIntelligence?.refreshCommand; if (!command)
+    return; const result = await runProcess(command, { cwd: root, timeoutMs: 300_000 }); if (result.exitCode !== 0 && config.codeIntelligence?.required)
+    throw new Error(`Code intelligence refresh failed: ${result.stderr || result.stdout}`); }
+//# sourceMappingURL=run.js.map

package/dist/core/run.js.map

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

package/dist/core/sdd.d.ts

@@ -0,0 +1,10 @@
+import type { HarnessProjectConfig, RequirementTrace } from "./types.js";
+export interface SddValidationResult {
+    ok: boolean;
+    missing: string[];
+    issues: string[];
+    requirements: RequirementTrace[];
+}
+export declare function createSddChange(root: string, taskId: string, title: string, config?: HarnessProjectConfig): Promise<string>;
+export declare function validateSddChange(root: string, taskId: string, config?: HarnessProjectConfig): Promise<SddValidationResult>;
+export declare function formatTraceabilityMatrix(requirements: RequirementTrace[]): string;

package/dist/core/sdd.js

@@ -0,0 +1,88 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+import { getCurrentBranch } from "./git.js";
+const requiredArtifacts = ["proposal.md", "spec.md", "design.md", "tasks.yaml", "acceptance.feature"];
+export async function createSddChange(root, taskId, title, config) { const specsDir = config?.sdd?.specsDir ?? "specs"; const dir = path.join(root, specsDir, "changes", taskId); const requirementId = `${taskId}-R1`; const originatingBranch = await getCurrentBranch(root); await fs.mkdir(dir, { recursive: true }); const files = { "proposal.md": `# ${taskId}: ${title}\n\n## Problem\n\nTODO\n\n## Desired outcome\n\nTODO\n\n## Requirements\n\n- ${requirementId} — TODO observable requirement.\n\n## Scope\n\n## Non-goals\n`, "spec.md": `# Specification: ${title}\n\n## Requirements\n\n### ${requirementId}\n\nTODO observable behavior.\n\n## Invariants\n\nTODO\n`, "design.md": `# Design: ${title}\n\n## Current state\n\n## Proposed design\n\n## Requirement mapping\n\n- ${requirementId} — TODO implementation approach.\n\n## Data/API impact\n\n## Risks and trade-offs\n`, "tasks.yaml": `version: 1\ntask: ${taskId}\nitems:\n  - id: 1\n    title: Implement ${requirementId}\n    status: pending\n    requirements:\n      - ${requirementId}\n`, "acceptance.feature": `@${taskId}\nFeature: ${title}\n\n  Rule: TODO business rule\n\n    @${requirementId}\n    Scenario: TODO observable behavior\n      Given TODO\n      When TODO\n      Then TODO\n` }; for (const [name, content] of Object.entries(files))
+    await writeIfMissing(path.join(dir, name), content); const contractsDir = path.join(root, config?.sdd?.contractsDir ?? ".harness/contracts"); await fs.mkdir(contractsDir, { recursive: true }); const contractPath = path.join(contractsDir, `${taskId}.yaml`); const contract = { version: 1, task: { id: taskId, title }, source: { proposal: relative(root, path.join(dir, "proposal.md")), spec: relative(root, path.join(dir, "spec.md")), design: relative(root, path.join(dir, "design.md")), tasks: relative(root, path.join(dir, "tasks.yaml")), acceptance: relative(root, path.join(dir, "acceptance.feature")) }, git: { baseRef: config?.validation?.baseRef ?? "main", ...(originatingBranch ? { originatingBranch } : {}) }, scope: { allowed: ["**"], forbidden: [], frozen: [] }, routing: { intent: "implement", domains: [], risk: "medium" }, requirements: [{ id: requirementId, description: "TODO observable requirement.", validators: ["gherkin"] }], constraints: { breakingApiChanges: false, newDependencies: false, schemaChanges: false }, repair: { maxAttempts: config?.orchestration?.worker?.maxRepairAttempts ?? 2 } }; await writeIfMissing(contractPath, YAML.stringify(contract)); return dir; }
+export async function validateSddChange(root, taskId, config) { const specsDir = config?.sdd?.specsDir ?? "specs"; const dir = path.join(root, specsDir, "changes", taskId); const missing = []; const issues = []; const contents = new Map(); for (const name of requiredArtifacts) {
+    try {
+        const content = await fs.readFile(path.join(dir, name), "utf8");
+        if (!content.trim())
+            missing.push(name);
+        else
+            contents.set(name, content);
+    }
+    catch {
+        missing.push(name);
+    }
+} if (missing.length)
+    return { ok: false, missing, issues, requirements: [] }; const spec = contents.get("spec.md") ?? ""; const proposal = contents.get("proposal.md") ?? ""; const design = contents.get("design.md") ?? ""; const acceptance = contents.get("acceptance.feature") ?? ""; const tasksRaw = contents.get("tasks.yaml") ?? ""; const requirementIds = extractRequirementIds(spec); if (!requirementIds.length)
+    issues.push("spec.md defines no traceable requirement IDs (expected e.g. CHANGE-123-R1 or REQ-001)."); const taskRequirements = extractTaskRequirements(tasksRaw); const contract = await tryLoadContract(root, taskId, config); if (!contract)
+    issues.push(`TaskContract ${taskId}.yaml is missing or unreadable.`); const known = config ? knownValidatorNames(config, contract) : undefined; const traces = requirementIds.map((id) => { const contractRequirement = contract?.requirements?.find((item) => item.id === id); const validators = normalizeValidators(contractRequirement); const trace = { id, proposal: proposal.includes(id), spec: true, design: design.includes(id), acceptance: containsTag(acceptance, id), tasks: taskRequirements.has(id), contract: Boolean(contractRequirement), validators }; for (const field of ["proposal", "design", "acceptance", "tasks", "contract"])
+    if (!trace[field])
+        issues.push(`${id} is not traceable through ${field}.`); if (!validators.length)
+    issues.push(`${id} has no validator declared in the TaskContract.`); if (known)
+    for (const validator of validators) {
+        const name = validator.split(":", 1)[0];
+        if (!known.has(name) && !known.has(validator))
+            issues.push(`${id} references unknown validator '${validator}'.`);
+    } return trace; }); for (const requirement of contract?.requirements ?? [])
+    if (!requirementIds.includes(requirement.id))
+        issues.push(`${requirement.id} exists in the TaskContract but not in spec.md.`); return { ok: missing.length === 0 && issues.length === 0, missing, issues, requirements: traces }; }
+export function formatTraceabilityMatrix(requirements) { const header = ["Requirement", "Proposal", "Spec", "Design", "Acceptance", "Tasks", "Contract", "Validators"].join(" | "); const separator = ["---", "---", "---", "---", "---", "---", "---", "---"].join(" | "); const rows = requirements.map((item) => [item.id, mark(item.proposal), mark(item.spec), mark(item.design), mark(item.acceptance), mark(item.tasks), mark(item.contract), item.validators.join(", ") || "—"].join(" | ")); return [header, separator, ...rows].join("\n"); }
+function extractRequirementIds(markdown) { const matches = markdown.matchAll(/(?:^|\s|[#`*-])((?:[A-Z][A-Z0-9_-]*-R\d+)|(?:REQ-\d+))(?:\b|`)/gm); return [...new Set([...matches].map((match) => match[1]))]; }
+function containsTag(feature, id) { return new RegExp(`(^|\\s)@${escapeRegex(id)}(?=\\s|$)`, "m").test(feature); }
+function extractTaskRequirements(raw) { try {
+    const value = YAML.parse(raw);
+    const ids = new Set();
+    collectRequirementValues(value, ids);
+    return ids;
+}
+catch {
+    return new Set();
+} }
+function collectRequirementValues(value, ids, key) { if (Array.isArray(value)) {
+    for (const item of value)
+        collectRequirementValues(item, ids, key);
+    return;
+} if (!value || typeof value !== "object") {
+    if ((key === "requirement" || key === "requirements") && typeof value === "string")
+        ids.add(value);
+    return;
+} for (const [childKey, child] of Object.entries(value)) {
+    if ((childKey === "requirement" || childKey === "requirements") && typeof child === "string")
+        ids.add(child);
+    if (childKey === "requirements" && Array.isArray(child))
+        for (const item of child)
+            if (typeof item === "string")
+                ids.add(item);
+    collectRequirementValues(child, ids, childKey);
+} }
+async function tryLoadContract(root, taskId, config) { try {
+    const contractsDir = config?.sdd?.contractsDir ?? ".harness/contracts";
+    return YAML.parse(await fs.readFile(path.join(root, contractsDir, `${taskId}.yaml`), "utf8"));
+}
+catch {
+    return undefined;
+} }
+function knownValidatorNames(config, contract) { const names = new Set(["build", "test", "lint", "typecheck", "architecture", "gherkin", "openapi", "graphify", "opengrep", "trivy", "playwright", "pact", "mutation", "property", "command"]); for (const item of config.validation?.commands ?? [])
+    names.add(item.id); for (const item of config.validation?.validators ?? []) {
+    names.add(item.id);
+    names.add(item.adapter);
+} for (const item of contract?.verification?.commands ?? [])
+    names.add(item.id); for (const item of contract?.verification?.validators ?? []) {
+    names.add(item.id);
+    names.add(item.adapter);
+} return names; }
+function normalizeValidators(requirement) { return [...new Set([...(requirement?.validators ?? []), ...(requirement?.validator ? [requirement.validator] : [])])]; }
+function relative(root, file) { return path.relative(root, file).replaceAll("\\", "/"); }
+function mark(value) { return value ? "✓" : "✗"; }
+function escapeRegex(value) { return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"); }
+async function writeIfMissing(file, content) { try {
+    await fs.access(file);
+}
+catch {
+    await fs.writeFile(file, content);
+} }
+//# sourceMappingURL=sdd.js.map

package/dist/core/sdd.js.map

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

package/dist/core/seal.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessProjectConfig, TaskContract, ValidationCheck } from "./types.js";
+export declare function sealTask(root: string, config: HarnessProjectConfig, contract: TaskContract): Promise<string>;
+export declare function verifyTaskSeal(root: string, contract: TaskContract, required?: boolean): Promise<ValidationCheck>;

package/dist/core/seal.js

@@ -0,0 +1,74 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+export async function sealTask(root, config, contract) {
+    const artifacts = await artifactPaths(root, config, contract);
+    const seal = {
+        version: 1,
+        taskId: contract.task.id,
+        createdAt: new Date().toISOString(),
+        artifacts: []
+    };
+    for (const relative of artifacts) {
+        const content = await fs.readFile(path.resolve(root, relative));
+        seal.artifacts.push({ path: relative, sha256: sha256(content) });
+    }
+    const output = sealPath(root, contract.task.id);
+    await fs.mkdir(path.dirname(output), { recursive: true });
+    await fs.writeFile(output, `${JSON.stringify(seal, null, 2)}\n`);
+    return output;
+}
+export async function verifyTaskSeal(root, contract, required = true) {
+    const file = sealPath(root, contract.task.id);
+    let seal;
+    try {
+        seal = JSON.parse(await fs.readFile(file, "utf8"));
+    }
+    catch {
+        return {
+            id: "trust.seal",
+            category: "trust-boundary",
+            status: required ? "FAIL" : "WARN",
+            message: `No valid seal exists for ${contract.task.id}. Run engineering-harness seal ${contract.task.id} before delegation.`
+        };
+    }
+    const mismatches = [];
+    for (const artifact of seal.artifacts) {
+        try {
+            const current = await fs.readFile(path.resolve(root, artifact.path));
+            const actual = sha256(current);
+            if (actual !== artifact.sha256)
+                mismatches.push({ path: artifact.path, expected: artifact.sha256, actual });
+        }
+        catch {
+            mismatches.push({ path: artifact.path, expected: artifact.sha256 });
+        }
+    }
+    return {
+        id: "trust.seal",
+        category: "trust-boundary",
+        status: mismatches.length ? "FAIL" : "PASS",
+        message: mismatches.length ? `Sealed artifacts changed after freeze: ${mismatches.map((x) => x.path).join(", ")}` : "TaskContract and sealed SDD artifacts match their SHA-256 seal.",
+        details: { mismatches, sealedAt: seal.createdAt }
+    };
+}
+async function artifactPaths(root, config, contract) {
+    const contractsDir = config.sdd?.contractsDir ?? ".harness/contracts";
+    const paths = [path.posix.join(contractsDir.replaceAll("\\", "/"), `${contract.task.id}.yaml`)];
+    for (const source of Object.values(contract.source ?? {})) {
+        if (source)
+            paths.push(source.replaceAll("\\", "/"));
+    }
+    const unique = [...new Set(paths)];
+    for (const relative of unique) {
+        await fs.access(path.resolve(root, relative));
+    }
+    return unique;
+}
+function sealPath(root, taskId) {
+    return path.join(root, ".harness", "seals", `${taskId}.json`);
+}
+function sha256(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+//# sourceMappingURL=seal.js.map