agentic-engineering-harness 0.8.7 → 0.8.9

package/dist/releases/release-1790907061787-15660-749049ca/delivery/finalize.js

@@ -0,0 +1,400 @@
+import { sha256Canonical } from "../core/digest.js";
+import { computeWorktreeDigest } from "../core/git.js";
+import { handoffTask, githubRequest, inferGithubRepository, loadDeliveryRecord, renderPattern, resolveGithubToken, saveDeliveryRecord } from "./handoff.js";
+import { runExecutable } from "../utils/process.js";
+import { verifySupplyChainGate } from "../provenance/generate.js";
+import { controllerEpochFromEnvironment, currentOperationContext, loadOperation, resolveOperationStateRoot } from "../operations/state.js";
+import { reconcileToolAction } from "../security/actionReconciliation.js";
+import { executeGatedAction } from "../security/gatedAction.js";
+import { controllerActorId } from "../security/toolActionGate.js";
+import { assertWorkspaceMatchesCandidate } from "../candidates/identity.js";
+import { requireAcceptedCurrentOracleV1 } from "../architecture/acceptanceOracle.js";
+export async function finalizeAcceptedIssue(root, config, contract, options = {}) {
+    const candidate = options.candidate;
+    const github = config.delivery?.github;
+    if (!contract.issue)
+        return finalizeAcceptedChange(root, config, contract, options);
+    if (contract.issue.provider !== "github")
+        return skipped("Task is not GitHub issue-derived.", candidate);
+    const handoffRequested = config.workflow?.issueIntake?.autoHandoff !== false;
+    const finalizationRequested = github?.finalizeOnAcceptance === true;
+    if (!github?.enabled || (!handoffRequested && !finalizationRequested))
+        return skipped("GitHub delivery and issue handoff are not enabled.", candidate);
+    const operationContext = currentOperationContext();
+    const operationId = operationContext.id;
+    const controllerEpoch = controllerEpochFromEnvironment();
+    if (!operationId || controllerEpoch === undefined)
+        throw new Error("DELIVERY_AUTHORITY_REQUIRED: accepted delivery must run inside a managed operation with a fenced controller epoch.");
+    const operation = await loadOperation(resolveOperationStateRoot(root), operationId);
+    const boundCandidate = candidate ?? operation.candidateRevision;
+    if (!boundCandidate || !operation.candidateRevision || boundCandidate.identityDigest !== operation.candidateRevision.identityDigest) {
+        throw new Error("DELIVERY_AUTHORITY_REQUIRED: delivery requires the operation's current CandidateRevision.");
+    }
+    await requireAcceptedCurrentOracleV1(resolveOperationStateRoot(root), operation, boundCandidate);
+    await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+    const initialRecord = await loadDeliveryRecord(root, config, contract.task.id);
+    if ((handoffRequested || finalizationRequested) && (!initialRecord?.github?.issueNumber || !initialRecord.github.branch)) {
+        // The controller already provisioned the candidate's internal execution
+        // workspace. Handoff here may create public GitHub resources only after
+        // current acceptance and never provisions a second execution workspace.
+        await handoffTask(root, config, contract.task.id, { createWorkspace: false });
+    }
+    if (!finalizationRequested) {
+        return handoffRequested
+            ? { status: "HANDOFF_ONLY", humanRequired: false, committed: false, pushed: false, candidate: boundCandidate, message: `Accepted issue task ${contract.task.id} has completed its requested handoff.` }
+            : skipped("GitHub finalization and issue handoff are not enabled.", candidate);
+    }
+    const authority = { kind: "controller-authority", operationId, controllerEpoch };
+    const actor = controllerActorId(operationId);
+    const supplyChain = await verifySupplyChainGate(root, config, { candidate: boundCandidate, artifactPath: config.provenance?.artifact ?? "" });
+    if (!supplyChain.ok)
+        throw new Error(`SUPPLY_CHAIN_BLOCKED: ${supplyChain.failures.join("; ")}`);
+    const record = await loadDeliveryRecord(root, config, contract.task.id);
+    const branch = record?.github?.branch;
+    if (!branch)
+        throw new Error(`BLOCKED_EXTERNAL: accepted issue task ${contract.task.id} has no issue-linked delivery branch to finalize.`);
+    const repository = record.github?.repository ?? contract.issue.repository;
+    const base = contract.git?.originatingBranch ?? contract.git?.baseRef ?? config.validation?.baseRef ?? "main";
+    const status = await runExecutable("git", ["status", "--porcelain"], { cwd: root, timeoutMs: 30_000 });
+    if (status.exitCode !== 0)
+        throw new Error(`SYSTEM_FAILURE: cannot inspect final Git state: ${status.stderr || status.stdout}`);
+    let committed = false;
+    let commitSha;
+    if (status.stdout.trim()) {
+        const commitMessage = `${contract.task.id}: ${contract.task.title}`;
+        const contentDigest = await computeWorktreeDigest(root);
+        await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+        const commitGate = await executeGatedAction({
+            root,
+            request: { root, operationId, participantId: actor, candidate: boundCandidate, actionKey: `delivery:${contract.task.id}:commit`, action: "git.commit", payload: { taskId: contract.task.id, message: commitMessage, contentDigest }, authority },
+            execute: async () => {
+                const add = await runExecutable("git", ["add", "-A"], { cwd: root, timeoutMs: 60_000 });
+                if (add.exitCode !== 0)
+                    return { outcome: "FAILED", evidence: { step: "add", exitCode: add.exitCode, stderr: add.stderr.slice(-2000) } };
+                try {
+                    await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+                }
+                catch (error) {
+                    return { outcome: "FAILED", evidence: { step: "candidate-identity", message: String(error) } };
+                }
+                const commit = await commitWithConfiguredOrHarnessIdentity(root, commitMessage);
+                return { outcome: commit.exitCode === 0 ? "SUCCEEDED" : "FAILED", evidence: { step: "commit", exitCode: commit.exitCode, stderr: commit.stderr.slice(-2000) } };
+            },
+            reconcile: (intent) => reconcileToolAction(root, intent, { taskId: contract.task.id, message: commitMessage })
+        });
+        assertDeliveryGateProgress(commitGate, "git.commit");
+        if (commitGate.receipt?.outcome === "FAILED")
+            throw new Error(`SYSTEM_FAILURE: git commit failed during deterministic finalization: ${commitGate.detail}`);
+        committed = true;
+        commitSha = await revParse(root, "HEAD");
+    }
+    else
+        commitSha = await revParse(root, "HEAD");
+    await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+    const baseCommit = await revParse(root, `${base}^{commit}`);
+    const ahead = await runExecutable("git", ["rev-list", "--count", `${baseCommit}..HEAD`], { cwd: root, timeoutMs: 30_000 });
+    if (ahead.exitCode !== 0)
+        throw new Error(`SYSTEM_FAILURE: cannot determine whether ${branch} contains deliverable commits: ${ahead.stderr || ahead.stdout}`);
+    if (Number(ahead.stdout.trim() || "0") === 0)
+        return { status: "NO_CHANGES", humanRequired: false, committed, commitSha, pushed: false, candidate, message: `No commits differ from ${base}; no pull request is required.` };
+    const pushGate = await executeGatedAction({
+        root,
+        request: { root, operationId, participantId: actor, candidate: boundCandidate, actionKey: `delivery:${contract.task.id}:push`, action: "git.push", payload: { remote: "origin", ref: branch, expectedCommit: commitSha }, authority },
+        execute: async () => {
+            await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+            const result = await runExecutable("git", ["push", "origin", `HEAD:${quoteRef(branch)}`], { cwd: root, timeoutMs: 180_000 });
+            return { outcome: result.exitCode === 0 ? "SUCCEEDED" : "FAILED", evidence: { ref: branch, exitCode: result.exitCode, stderr: result.stderr.slice(-2000) } };
+        },
+        reconcile: (intent) => reconcileToolAction(root, intent, { remote: "origin", ref: branch, expectedCommit: commitSha })
+    });
+    assertDeliveryGateProgress(pushGate, "git.push");
+    if (pushGate.receipt?.outcome === "FAILED")
+        throw new Error(`BLOCKED_EXTERNAL: git push failed for ${branch}: ${pushGate.detail}`);
+    if (github.pullRequests === false) {
+        return { status: "FINALIZED", humanRequired: false, committed, commitSha, pushed: true, candidate, message: `Accepted issue task finalized on ${branch} with a push-only delivery policy; pull request creation was not requested by frozen policy.` };
+    }
+    const token = resolveGithubToken(github.tokenEnv);
+    const apiBase = (github.apiBaseUrl ?? "https://api.github.com").replace(/\/$/, "");
+    const owner = repository.split("/")[0];
+    const query = `/repos/${repository}/pulls?state=open&head=${encodeURIComponent(`${owner}:${branch}`)}&base=${encodeURIComponent(base)}`;
+    const prPayload = { repository, head: branch, base, apiBase };
+    let pr;
+    const prGate = await executeGatedAction({
+        root,
+        request: { root, operationId, participantId: actor, candidate: boundCandidate, actionKey: `delivery:${contract.task.id}:pull-request`, action: "github.pull-request.create", payload: prPayload, authority },
+        execute: async () => {
+            await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+            const existing = await githubRequest(apiBase, token, query);
+            if (existing[0]) {
+                pr = existing[0];
+                return { outcome: "SUCCEEDED", evidence: { number: existing[0].number, url: existing[0].html_url, reused: true } };
+            }
+            const created = await githubRequest(apiBase, token, `/repos/${repository}/pulls`, {
+                method: "POST",
+                body: JSON.stringify({ title: `${contract.task.id}: ${contract.task.title}`, head: branch, base, draft: github.pullRequestDraft ?? true, body: buildPullRequestBody(contract) })
+            });
+            pr = created;
+            return { outcome: "SUCCEEDED", evidence: { number: created.number, url: created.html_url } };
+        },
+        reconcile: (intent) => reconcileToolAction(root, intent, prPayload, { token })
+    });
+    assertDeliveryGateProgress(prGate, "github.pull-request.create");
+    if (prGate.receipt?.outcome === "FAILED")
+        throw new Error(`BLOCKED_EXTERNAL: pull request creation failed: ${prGate.detail}`);
+    if (!pr) {
+        const existing = await githubRequest(apiBase, token, query);
+        pr = existing[0];
+    }
+    if (!pr)
+        throw new Error("BLOCKED_EXTERNAL: a pull request receipt exists but no open pull request could be observed.");
+    return { status: "FINALIZED", humanRequired: false, committed, commitSha, pushed: true, candidate, pullRequest: { number: pr.number, url: pr.html_url, draft: pr.draft ?? (github.pullRequestDraft ?? true) }, message: `Accepted issue task finalized on ${branch}; pull request #${pr.number}.` };
+}
+/** Generic no-Issue CHANGE delivery. Every delivery action runs after current acceptance through ToolActionGate. */
+export async function finalizeAcceptedChange(root, config, contract, options = {}) {
+    const candidate = options.candidate;
+    const github = config.delivery?.github;
+    if (currentOperationContext().kind !== "change")
+        return skipped("Generic GitHub delivery is limited to managed CHANGE operations.", candidate);
+    if (github?.enabled !== true || github.finalizeOnAcceptance !== true)
+        return skipped("Generic GitHub CHANGE finalization is not enabled by project policy.", candidate);
+    const context = currentOperationContext();
+    const operationId = context.id;
+    const controllerEpoch = controllerEpochFromEnvironment();
+    if (!operationId || controllerEpoch === undefined)
+        throw new Error("DELIVERY_AUTHORITY_REQUIRED: accepted CHANGE delivery requires a managed operation with a fenced controller epoch.");
+    const stateRoot = resolveOperationStateRoot(root);
+    const operation = await loadOperation(stateRoot, operationId);
+    const boundCandidate = candidate ?? operation.candidateRevision;
+    if (!boundCandidate || !operation.candidateRevision || boundCandidate.identityDigest !== operation.candidateRevision.identityDigest) {
+        throw new Error("DELIVERY_AUTHORITY_REQUIRED: CHANGE delivery requires the operation's current CandidateRevision.");
+    }
+    await requireAcceptedCurrentOracleV1(stateRoot, operation, boundCandidate);
+    await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+    const policyDelivery = operation.resolvedOperationPolicy?.deliveryPolicy;
+    if (!policyDelivery || typeof policyDelivery !== "object" || Array.isArray(policyDelivery))
+        throw new Error("DELIVERY_POLICY_REQUIRED: current frozen operation policy has no delivery policy.");
+    const policy = policyDelivery;
+    const allowedActions = Array.isArray(policy.allowedActions) ? policy.allowedActions.filter((item) => typeof item === "string") : [];
+    const requiredActions = ["git.branch.create", "git.commit", "git.push"];
+    if (requiredActions.some((action) => !allowedActions.includes(action))) {
+        return skipped("Frozen project policy does not configure complete branch/commit/push delivery for non-Issue changes.", boundCandidate);
+    }
+    const allowPullRequest = allowedActions.includes("github.pull-request.create") && policy.pullRequests !== false;
+    const externalEffects = operation.resolvedOperationPolicy?.allowedExternalEffects ?? [];
+    if (!externalEffects.includes("git.push") || (allowPullRequest && !externalEffects.includes("github.pull-request.create"))) {
+        throw new Error("DELIVERY_POLICY_STALE: frozen allowed delivery actions and external effects disagree.");
+    }
+    const supplyChain = await verifySupplyChainGate(root, config, { candidate: boundCandidate, artifactPath: config.provenance?.artifact ?? "" });
+    if (!supplyChain.ok)
+        throw new Error(`SUPPLY_CHAIN_BLOCKED: ${supplyChain.failures.join("; ")}`);
+    const repository = (typeof policy.repository === "string" ? policy.repository : undefined) ?? github.repository ?? await inferGithubRepository(root);
+    if (!/^[^/]+\/[^/]+$/.test(repository))
+        throw new Error("DELIVERY_REPOSITORY_INVALID: delivery repository must be owner/repository.");
+    const base = contract.git?.originatingBranch ?? contract.git?.baseRef ?? config.validation?.baseRef ?? "main";
+    const branchPattern = typeof policy.branchPattern === "string" ? policy.branchPattern : github.branchPattern ?? "feature/{task}-{slug}";
+    const branch = renderPattern(branchPattern, contract);
+    const initialRecord = await loadDeliveryRecord(root, config, contract.task.id);
+    const baseCommit = initialRecord?.github?.branchSha ?? await revParse(root, "HEAD");
+    const branchValidation = await runExecutable("git", ["check-ref-format", "--branch", branch], { cwd: root, timeoutMs: 10_000 });
+    if (branchValidation.exitCode !== 0)
+        throw new Error(`DELIVERY_BRANCH_INVALID: configured branch pattern produced an invalid ref '${branch}'.`);
+    const token = allowPullRequest ? resolveGithubToken(github.tokenEnv) : undefined;
+    const status = await runExecutable("git", ["status", "--porcelain"], { cwd: root, timeoutMs: 30_000 });
+    if (status.exitCode !== 0)
+        throw new Error(`SYSTEM_FAILURE: cannot inspect final Git state: ${status.stderr || status.stdout}`);
+    if (!status.stdout.trim() && (await revParse(root, "HEAD")) === baseCommit) {
+        return { status: "NO_CHANGES", humanRequired: false, committed: false, pushed: false, candidate: boundCandidate, message: "Accepted CHANGE candidate has no Git changes; no branch or pull request was published." };
+    }
+    const actor = controllerActorId(operationId);
+    const authority = { kind: "controller-authority", operationId, controllerEpoch };
+    if (initialRecord?.github?.issueNumber)
+        throw new Error("DELIVERY_RECORD_CONFLICT: a no-Issue CHANGE cannot reuse an Issue-derived delivery record.");
+    const now = new Date().toISOString();
+    const record = initialRecord ?? {
+        version: 1,
+        taskId: contract.task.id,
+        status: "initialized",
+        createdAt: now,
+        updatedAt: now,
+        originatingBranch: base
+    };
+    if (record.github?.branch && record.github.branch !== branch)
+        throw new Error("DELIVERY_RECORD_CONFLICT: existing delivery branch does not match the frozen branch pattern.");
+    const branchBase = record.github?.branchSha ?? baseCommit;
+    record.github = { ...(record.github ?? {}), repository, branch, branchSha: branchBase };
+    record.updatedAt = now;
+    await saveDeliveryRecord(stateRoot, config, record);
+    const branchPayload = { taskId: contract.task.id, branch, expectedCommit: branchBase };
+    let localBranchFailure;
+    const branchGate = await executeGatedAction({
+        root,
+        request: { root, operationId, participantId: actor, candidate: boundCandidate, actionKey: `delivery:${contract.task.id}:local-branch`, action: "git.branch.create", payload: branchPayload, authority },
+        execute: async () => {
+            const existing = await runExecutable("git", ["for-each-ref", "--format=%(objectname)", `refs/heads/${branch}`], { cwd: root, timeoutMs: 15_000 });
+            if (existing.exitCode === 0 && existing.stdout.trim()) {
+                const current = existing.stdout.trim();
+                if (current !== branchBase) {
+                    localBranchFailure = `branch ${branch} already exists at ${current}, expected ${branchBase}`;
+                    return { outcome: "FAILED", evidence: { branch, expectedCommit: branchBase, observedCommit: current, reason: "branch already exists at a different commit" } };
+                }
+            }
+            else if (existing.exitCode === 0) {
+                const created = await runExecutable("git", ["switch", "--create", branch, branchBase], { cwd: root, timeoutMs: 30_000 });
+                if (created.exitCode !== 0) {
+                    localBranchFailure = `git switch --create exited ${created.exitCode}: ${created.stderr || created.stdout}`;
+                    return { outcome: "FAILED", evidence: { branch, expectedCommit: branchBase, exitCode: created.exitCode, stderr: created.stderr.slice(-2000) } };
+                }
+            }
+            else {
+                localBranchFailure = `git show-ref for ${branch} exited ${existing.exitCode}: ${existing.stderr || existing.stdout}`;
+                return { outcome: "FAILED", evidence: { branch, expectedCommit: branchBase, exitCode: existing.exitCode, stderr: existing.stderr.slice(-2000) } };
+            }
+            const switched = await runExecutable("git", ["switch", branch], { cwd: root, timeoutMs: 30_000 });
+            if (switched.exitCode !== 0)
+                localBranchFailure = `git switch ${branch} exited ${switched.exitCode}: ${switched.stderr || switched.stdout}`;
+            return { outcome: switched.exitCode === 0 ? "SUCCEEDED" : "FAILED", evidence: { branch, expectedCommit: branchBase, exitCode: switched.exitCode, stderr: switched.stderr.slice(-2000) } };
+        },
+        reconcile: (intent) => reconcileToolAction(root, intent, branchPayload)
+    });
+    assertDeliveryGateProgress(branchGate, "git.branch.create");
+    if (branchGate.receipt?.outcome === "FAILED")
+        throw new Error(`SYSTEM_FAILURE: gated local branch creation failed: ${localBranchFailure ?? branchGate.detail}`);
+    record.status = "branch-created";
+    record.updatedAt = new Date().toISOString();
+    await saveDeliveryRecord(stateRoot, config, record);
+    const commitMessage = `${contract.task.id}: ${contract.task.title}`;
+    const contentDigest = await computeWorktreeDigest(root);
+    const commitPayload = { taskId: contract.task.id, message: commitMessage, contentDigest };
+    await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+    const commitGate = await executeGatedAction({
+        root,
+        request: { root, operationId, participantId: actor, candidate: boundCandidate, actionKey: `delivery:${contract.task.id}:commit`, action: "git.commit", payload: commitPayload, authority },
+        execute: async () => {
+            const add = await runExecutable("git", ["add", "-A"], { cwd: root, timeoutMs: 60_000 });
+            if (add.exitCode !== 0)
+                return { outcome: "FAILED", evidence: { step: "add", exitCode: add.exitCode, stderr: add.stderr.slice(-2000) } };
+            try {
+                await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+            }
+            catch (error) {
+                return { outcome: "FAILED", evidence: { step: "candidate-identity", message: String(error) } };
+            }
+            const commit = await commitWithConfiguredOrHarnessIdentity(root, commitMessage);
+            return { outcome: commit.exitCode === 0 ? "SUCCEEDED" : "FAILED", evidence: { step: "commit", exitCode: commit.exitCode, stderr: commit.stderr.slice(-2000) } };
+        },
+        reconcile: (intent) => reconcileToolAction(root, intent, { taskId: contract.task.id, message: commitMessage })
+    });
+    assertDeliveryGateProgress(commitGate, "git.commit");
+    if (commitGate.receipt?.outcome === "FAILED")
+        throw new Error(`SYSTEM_FAILURE: gated git commit failed: ${commitGate.detail}`);
+    const commitSha = await revParse(root, "HEAD");
+    await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+    const pushPayload = { remote: "origin", ref: branch, expectedCommit: commitSha };
+    const pushGate = await executeGatedAction({
+        root,
+        request: { root, operationId, participantId: actor, candidate: boundCandidate, actionKey: `delivery:${contract.task.id}:push`, action: "git.push", payload: pushPayload, authority },
+        execute: async () => {
+            await assertWorkspaceMatchesCandidate(root, boundCandidate, operation.candidateRevision);
+            const pushed = await runExecutable("git", ["push", "origin", `HEAD:${quoteRef(branch)}`], { cwd: root, timeoutMs: 180_000 });
+            return { outcome: pushed.exitCode === 0 ? "SUCCEEDED" : "FAILED", evidence: { ref: branch, exitCode: pushed.exitCode, stderr: pushed.stderr.slice(-2000) } };
+        },
+        reconcile: (intent) => reconcileToolAction(root, intent, pushPayload)
+    });
+    assertDeliveryGateProgress(pushGate, "git.push");
+    if (pushGate.receipt?.outcome === "FAILED")
+        throw new Error(`BLOCKED_EXTERNAL: git push failed for ${branch}: ${pushGate.detail}`);
+    let pullRequest;
+    if (allowPullRequest) {
+        const apiBase = (github.apiBaseUrl ?? "https://api.github.com").replace(/\/$/, "");
+        const owner = repository.split("/")[0];
+        const query = `/repos/${repository}/pulls?state=open&head=${encodeURIComponent(`${owner}:${branch}`)}&base=${encodeURIComponent(base)}`;
+        const title = `${contract.task.id}: ${contract.task.title}`;
+        const body = buildChangePullRequestBody(contract);
+        const draft = typeof policy.pullRequestDraft === "boolean" ? policy.pullRequestDraft : github.pullRequestDraft ?? true;
+        const prPayload = { repository, head: branch, base, apiBase, title, bodyDigest: sha256Canonical(body), draft };
+        let observed;
+        const prGate = await executeGatedAction({
+            root,
+            request: { root, operationId, participantId: actor, candidate: boundCandidate, actionKey: `delivery:${contract.task.id}:pull-request`, action: "github.pull-request.create", payload: prPayload, authority },
+            execute: async () => {
+                const existing = await githubRequest(apiBase, token, query);
+                if (existing[0]) {
+                    observed = await githubRequest(apiBase, token, `/repos/${repository}/pulls/${existing[0].number}`, { method: "PATCH", body: JSON.stringify({ title, body, draft, base }) });
+                    return { outcome: "SUCCEEDED", evidence: { number: observed.number, url: observed.html_url, updated: true } };
+                }
+                observed = await githubRequest(apiBase, token, `/repos/${repository}/pulls`, { method: "POST", body: JSON.stringify({ title, head: branch, base, draft, body }) });
+                return { outcome: "SUCCEEDED", evidence: { number: observed.number, url: observed.html_url, created: true } };
+            },
+            reconcile: (intent) => reconcileToolAction(root, intent, prPayload, { token })
+        });
+        assertDeliveryGateProgress(prGate, "github.pull-request.create");
+        if (prGate.receipt?.outcome === "FAILED")
+            throw new Error(`BLOCKED_EXTERNAL: pull request create/update failed: ${prGate.detail}`);
+        if (!observed)
+            observed = (await githubRequest(apiBase, token, query))[0];
+        if (!observed)
+            throw new Error("BLOCKED_EXTERNAL: a pull request receipt exists but no open pull request could be observed.");
+        pullRequest = { number: observed.number, url: observed.html_url, draft: observed.draft ?? draft };
+    }
+    record.status = "ready";
+    record.updatedAt = new Date().toISOString();
+    await saveDeliveryRecord(stateRoot, config, record);
+    return {
+        status: "FINALIZED",
+        humanRequired: false,
+        committed: commitGate.receipt?.outcome === "SUCCEEDED",
+        commitSha,
+        pushed: pushGate.receipt?.outcome === "SUCCEEDED",
+        ...(pullRequest ? { pullRequest } : {}),
+        candidate: boundCandidate,
+        message: pullRequest ? `Accepted CHANGE finalized on ${branch}; pull request #${pullRequest.number}.` : `Accepted CHANGE finalized on ${branch} with push-only policy.`
+    };
+}
+export function buildChangePullRequestBody(contract) {
+    const requirements = (contract.requirements ?? []).map((item) => `- ${item.id}: ${item.description ?? "see sealed TaskContract"}`).join("\n");
+    return [
+        "## Harness delivery",
+        "",
+        `Task: \`${contract.task.id}\``,
+        `Route: \`${contract.routing?.route ?? "unknown"}\` / assurance \`${contract.routing?.assurance ?? "unknown"}\``,
+        "",
+        "Accepted by the current candidate-bound AEH validation, review, and AcceptanceOracle gates before this pull request was created or updated.",
+        "",
+        "## Frozen requirements",
+        requirements || "No explicit TaskContract requirement rows.",
+        ""
+    ].join("\n");
+}
+function assertDeliveryGateProgress(gate, action) {
+    if (gate.status === "HUMAN_REQUIRED" || gate.status === "RECONCILIATION_REQUIRED") {
+        throw new Error(`BLOCKED_EXTERNAL: ${action} has an unresolved durable intent and requires human reconciliation: ${gate.detail}`);
+    }
+}
+export function deliveryFinalizationFailure(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const external = /^BLOCKED_EXTERNAL:/.test(message);
+    const supplyChain = /^SUPPLY_CHAIN_BLOCKED:/.test(message);
+    return { status: external ? "BLOCKED_EXTERNAL" : supplyChain ? "BLOCKED_SUPPLY_CHAIN" : "SYSTEM_FAILURE", humanRequired: external, committed: false, pushed: false, message };
+}
+function buildPullRequestBody(contract) { const issue = contract.issue; return `## Harness delivery\n\nTask: \`${contract.task.id}\`\nSource: ${issue.repository}#${issue.number}\nFrozen issue SHA-256: \`${issue.contentSha256}\`\n\nThe implementation passed the configured deterministic validation, quality convergence and lead-acceptance workflow before this PR was created.\n\nCloses #${issue.number}\n`; }
+function skipped(message, candidate) { return { status: "SKIPPED", humanRequired: false, committed: false, pushed: false, candidate, message }; }
+async function commitWithConfiguredOrHarnessIdentity(root, message) {
+    const name = await runExecutable("git", ["config", "user.name"], { cwd: root, timeoutMs: 10_000 });
+    const email = await runExecutable("git", ["config", "user.email"], { cwd: root, timeoutMs: 10_000 });
+    const args = [
+        ...(name.exitCode === 0 && name.stdout.trim() && email.exitCode === 0 && email.stdout.trim()
+            ? []
+            : ["-c", "user.name=Agentic Engineering Harness", "-c", "user.email=aeh@users.noreply.github.com"]),
+        "commit", "-m", message
+    ];
+    return runExecutable("git", args, { cwd: root, timeoutMs: 120_000 });
+}
+async function revParse(root, ref) {
+    const result = await runExecutable("git", ["rev-parse", "--verify", "--end-of-options", ref], { cwd: root, timeoutMs: 30_000 });
+    if (result.exitCode !== 0)
+        throw new Error(`SYSTEM_FAILURE: git rev-parse ${ref} failed: ${result.stderr || result.stdout}`);
+    return result.stdout.trim();
+}
+function quoteRef(value) { if (!/^[A-Za-z0-9._\/-]+$/.test(value) || value.startsWith("-") || value.startsWith("/") || value.endsWith("/") || value.endsWith(".") || value.includes("..") || value.includes("@{"))
+    throw new Error(`Unsafe git ref: ${value}`); return value; }
+//# sourceMappingURL=finalize.js.map

package/dist/releases/release-1790907061787-15660-749049ca/delivery/finalize.js.map

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

package/dist/releases/release-1790907061787-15660-749049ca/delivery/handoff.d.ts

@@ -0,0 +1,43 @@
+import type { HarnessProjectConfig, TaskContract } from "../core/types.js";
+export interface DeliveryRecord {
+    version: 1;
+    taskId: string;
+    status: "initialized" | "issue-created" | "branch-created" | "workspace-created" | "ready";
+    createdAt: string;
+    updatedAt: string;
+    originatingBranch: string;
+    github?: {
+        repository: string;
+        issueNumber?: number;
+        issueUrl?: string;
+        branch?: string;
+        branchSha?: string;
+    };
+    paseo?: {
+        workspaceId?: string;
+        worktreePath?: string;
+    };
+}
+export declare function handoffTask(root: string, config: HarnessProjectConfig, taskId: string, options?: {
+    createWorkspace?: boolean;
+}): Promise<DeliveryRecord>;
+export declare function handoffSdd(root: string, config: HarnessProjectConfig, taskId: string): Promise<DeliveryRecord>;
+export declare function seedDeliveryRecordFromIssue(root: string, config: HarnessProjectConfig, contract: TaskContract, issue: {
+    repository: string;
+    issueNumber: number;
+    issueUrl: string;
+}): Promise<DeliveryRecord>;
+export declare function assertHandoffReady(root: string, contract: TaskContract): Promise<void>;
+export declare function materializeTaskContext(controlRoot: string, workspaceRoot: string, config: HarnessProjectConfig, contract: TaskContract): Promise<void>;
+export declare function loadDeliveryRecord(root: string, config: HarnessProjectConfig, taskId: string): Promise<DeliveryRecord | undefined>;
+export declare function deliveryWorkspaceId(root: string, config: HarnessProjectConfig, taskId: string): Promise<string | undefined>;
+export declare function deliveryWorkspacePath(root: string, config: HarnessProjectConfig, taskId: string): Promise<string | undefined>;
+export declare function parseGithubRepository(remote: string): string | undefined;
+export declare function renderPattern(pattern: string, contract: TaskContract, issue?: number): string;
+export declare function renderIssueBody(root: string, contract: TaskContract, originatingBranch: string): Promise<string>;
+export declare function inferGithubRepository(root: string): Promise<string>;
+export declare function resolveGithubTokenOptional(preferred?: string): string | undefined;
+export declare function resolveGithubToken(preferred?: string): string;
+export declare function githubRequest<T = unknown>(base: string, token: string | undefined, endpoint: string, init?: RequestInit): Promise<T>;
+export declare function githubRequestMaybe<T>(base: string, token: string | undefined, endpoint: string): Promise<T | undefined>;
+export declare function saveDeliveryRecord(root: string, config: HarnessProjectConfig, record: DeliveryRecord): Promise<void>;