agentic-engineering-harness 0.4.16

package/dist/core/seal.js.map

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

package/dist/core/triage.d.ts

@@ -0,0 +1,22 @@
+import type { HarnessProjectConfig, TaskMode } from "./types.js";
+export type TriageFlag = "architecture" | "security" | "authentication" | "authorization" | "schema" | "migration" | "public-api" | "breaking-change" | "new-dependency" | "cross-module" | "ambiguous";
+export interface TriageEvidence {
+    request: string;
+    files?: string[];
+    domains?: string[];
+    risk?: "low" | "medium" | "high";
+    flags?: TriageFlag[];
+}
+export interface TriageDecision {
+    mode: TaskMode;
+    quickEligible: boolean;
+    reasons: string[];
+    evidence: Required<Pick<TriageEvidence, "request">> & {
+        files: string[];
+        domains: string[];
+        risk: "low" | "medium" | "high";
+        flags: TriageFlag[];
+    };
+}
+export declare function triageChange(config: HarnessProjectConfig, input: TriageEvidence): TriageDecision;
+export declare function formatTriageDecision(decision: TriageDecision): string;

package/dist/core/triage.js

@@ -0,0 +1,38 @@
+const defaultDisallowedDomains = ["security", "auth", "authentication", "authorization", "architecture", "database", "schema", "migration", "api-contract", "multi-tenancy"];
+const hazardousRequestPatterns = [
+    [/\b(auth|authentication|authorization|permission|tenant|security)\b/i, "request touches a security/auth boundary"],
+    [/\b(migration|schema|database|table|column)\b/i, "request may alter persistent schema/data boundaries"],
+    [/\b(public\s+api|breaking\s+change|backward\s+compat)/i, "request may alter a public compatibility contract"],
+    [/\b(add|new|upgrade|replace)\s+(a\s+)?dependenc(y|ies)|\bpackage\s+(upgrade|change)\b/i, "request may change dependency policy"],
+    [/\barchitecture|architectural|cross[- ]module|large\s+refactor\b/i, "request may require an architectural decision"]
+];
+export function triageChange(config, input) {
+    const files = [...new Set(input.files ?? [])];
+    const domains = [...new Set(input.domains ?? [])];
+    const risk = input.risk ?? "low";
+    const flags = [...new Set(input.flags ?? [])];
+    const reasons = [];
+    const maxFiles = config.workflow?.quick?.maxFiles ?? 5;
+    const disallowed = config.workflow?.quick?.disallowedDomains ?? defaultDisallowedDomains;
+    if (!files.length)
+        reasons.push("quick mode requires an explicit bounded file scope");
+    const nonConcrete = files.filter((file) => /[*?\[\]{}]/.test(file));
+    if (nonConcrete.length)
+        reasons.push(`quick mode requires concrete file paths, not wildcard scope: ${nonConcrete.join(", ")}`);
+    if (files.length > maxFiles)
+        reasons.push(`scope contains ${files.length} files/patterns; quick limit is ${maxFiles}`);
+    if (risk !== "low")
+        reasons.push(`risk is ${risk}; quick mode requires low risk`);
+    if (flags.length)
+        reasons.push(`explicit escalation flags: ${flags.join(", ")}`);
+    const blockedDomains = domains.filter((domain) => disallowed.some((pattern) => domain.toLowerCase().includes(pattern.toLowerCase()) || pattern.toLowerCase().includes(domain.toLowerCase())));
+    if (blockedDomains.length)
+        reasons.push(`domains require SDD: ${blockedDomains.join(", ")}`);
+    for (const [pattern, reason] of hazardousRequestPatterns)
+        if (pattern.test(input.request))
+            reasons.push(reason);
+    const quickEligible = reasons.length === 0;
+    return { mode: quickEligible ? "quick" : "spec", quickEligible, reasons: quickEligible ? ["bounded low-risk change with no SDD escalation signals"] : reasons, evidence: { request: input.request, files, domains, risk, flags } };
+}
+export function formatTriageDecision(decision) { return `${decision.mode.toUpperCase()} — ${decision.reasons.join("; ")}`; }
+//# sourceMappingURL=triage.js.map

package/dist/core/triage.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,354 @@
+export type CheckStatus = "PASS" | "FAIL" | "SKIP" | "WARN";
+export type TaskMode = "spec" | "quick";
+export type ReviewSeverity = "critical" | "high" | "medium" | "low" | "note";
+export type ValidatorAdapter = "command" | "gherkin" | "graphify" | "opengrep" | "trivy" | "playwright" | "openapi" | "pact" | "mutation" | "property" | string;
+export interface ValidationCommand {
+    id: string;
+    command: string;
+    required?: boolean;
+    timeoutSeconds?: number;
+    workingDirectory?: string;
+}
+export interface ValidatorSpec {
+    id: string;
+    adapter: ValidatorAdapter;
+    command?: string;
+    required?: boolean;
+    timeoutSeconds?: number;
+    workingDirectory?: string;
+    options?: Record<string, unknown>;
+}
+export interface UsageMetrics {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    costUsd?: number;
+}
+export interface RunMetrics {
+    firstPassSuccess: boolean;
+    repairCount: number;
+    humanInterventions: number;
+    durationMs: number;
+    usage: UsageMetrics;
+}
+export interface ReviewEscalationStage {
+    name: string;
+    action?: "remediate" | "diagnose" | "replan";
+    agent?: string;
+    model?: string;
+}
+export interface McpServerConfig {
+    description?: string;
+    type: "local" | "remote";
+    command?: string[];
+    url?: string;
+    environment?: Record<string, string>;
+    headers?: Record<string, string>;
+    oauth?: boolean;
+    enabled?: boolean;
+    timeoutMs?: number;
+    codemode?: boolean;
+}
+export interface HarnessProjectConfig {
+    version: 1;
+    project: {
+        name: string;
+    };
+    agents?: {
+        configPath?: string;
+        generatedPath?: string;
+        activeProfile?: string;
+        required?: boolean;
+        findingsDir?: string;
+    };
+    workflow?: {
+        quick?: {
+            maxFiles?: number;
+            disallowedDomains?: string[];
+        };
+        issueIntake?: {
+            enabled?: boolean;
+            snapshotDir?: string;
+            verifyDriftOnRun?: boolean;
+            requireOpen?: boolean;
+            plannerAgent?: string;
+            autoHandoff?: boolean;
+        };
+        reviews?: {
+            enabled?: boolean;
+            reviewQuick?: boolean;
+            leadAcceptance?: boolean;
+            leadAcceptanceQuick?: boolean;
+            /** @deprecated Accepted for old project files but ignored by the convergence engine. */
+            maxRemediationRounds?: number;
+            /** @deprecated Accepted for old project files but superseded by finalQualityGate. */
+            blockingSeverities?: ReviewSeverity[];
+            quality?: {
+                severityPoints?: Partial<Record<ReviewSeverity, number>>;
+            };
+            convergence?: {
+                minimumDebtPointImprovement?: number;
+                stagnationWindow?: number;
+                cycleDetection?: boolean;
+                regressionDetection?: boolean;
+            };
+            finalQualityGate?: {
+                maxBySeverity?: Partial<Record<ReviewSeverity, number>>;
+                maxDebtPoints?: number;
+            };
+            escalation?: {
+                stages?: ReviewEscalationStage[];
+                criticalStartStage?: number;
+                replanResumeStage?: number;
+            };
+        };
+    };
+    orchestration?: {
+        provider: "paseo" | "podman" | "none" | string;
+        required?: boolean;
+        worker?: {
+            provider?: string;
+            model?: string;
+            maxRepairAttempts?: number;
+            timeoutSeconds?: number;
+            titlePrefix?: string;
+        };
+    };
+    toolchain?: {
+        configPath?: string;
+        lockPath?: string;
+        statePath?: string;
+        generatedMisePath?: string;
+    };
+    mcp?: {
+        servers?: Record<string, McpServerConfig>;
+    };
+    delivery?: {
+        stateDir?: string;
+        github?: {
+            enabled?: boolean;
+            tokenEnv?: string;
+            repository?: string;
+            apiBaseUrl?: string;
+            assignTokenOwner?: boolean;
+            labels?: string[];
+            branchPattern?: string;
+            finalizeOnAcceptance?: boolean;
+            pullRequestDraft?: boolean;
+        };
+        paseo?: {
+            enabled?: boolean;
+            createWorkspace?: boolean;
+            autoUseWorkspace?: boolean;
+            worktreeSlugPattern?: string;
+        };
+    };
+    memory?: {
+        provider: "engram" | "none" | string;
+        required?: boolean;
+        benchmark?: {
+            casesDir?: string;
+            resultsDir?: string;
+            providers?: Array<{
+                name: string;
+                command: string;
+                timeoutSeconds?: number;
+            }>;
+        };
+    };
+    codeIntelligence?: {
+        provider: "graphify" | "none" | string;
+        required?: boolean;
+        graphPath?: string;
+        snapshotDir?: string;
+        refreshCommand?: string;
+    };
+    sdd?: {
+        specsDir?: string;
+        contractsDir?: string;
+        reportsDir?: string;
+        repairsDir?: string;
+        runsDir?: string;
+    };
+    validation?: {
+        baseRef?: string;
+        commands?: ValidationCommand[];
+        validators?: ValidatorSpec[];
+        frozenPaths?: string[];
+        requireSeal?: boolean;
+        opa?: {
+            enabled?: boolean;
+            policyDirs?: string[];
+        };
+    };
+    security?: {
+        sandbox?: {
+            provider?: "podman" | "docker" | "none" | string;
+            required?: boolean;
+            image?: string;
+            network?: boolean;
+            extraArgs?: string[];
+        };
+        tools?: string[];
+    };
+    telemetry?: {
+        enabled?: boolean;
+        required?: boolean;
+        localEventsFile?: string;
+        exporter?: "none" | "otlp-http-json" | string;
+        endpoint?: string;
+        headers?: Record<string, string>;
+        serviceName?: string;
+    };
+    evals?: {
+        corpusDir?: string;
+        resultsDir?: string;
+        workspacesDir?: string;
+    };
+    provenance?: {
+        outputDir?: string;
+        buildType?: string;
+        cosignKey?: string;
+    };
+}
+export interface TaskRequirement {
+    id: string;
+    description?: string;
+    validator?: string;
+    validators?: string[];
+}
+export interface QuickTaskMetadata {
+    request: string;
+    acceptance: string[];
+    triage: {
+        mode: TaskMode;
+        reasons: string[];
+        evaluatedAt: string;
+    };
+}
+export interface TaskIssueMetadata {
+    provider: "github";
+    repository: string;
+    number: number;
+    url: string;
+    state: string;
+    fetchedAt: string;
+    updatedAt: string;
+    contentSha256: string;
+    snapshotPath: string;
+}
+export interface TaskContract {
+    version: 1;
+    mode?: TaskMode;
+    task: {
+        id: string;
+        title: string;
+    };
+    quick?: QuickTaskMetadata;
+    source?: {
+        proposal?: string;
+        spec?: string;
+        design?: string;
+        tasks?: string;
+        acceptance?: string;
+        issue?: string;
+    };
+    issue?: TaskIssueMetadata;
+    git?: {
+        baseRef?: string;
+        originatingBranch?: string;
+    };
+    scope?: {
+        allowed?: string[];
+        forbidden?: string[];
+        frozen?: string[];
+    };
+    routing?: {
+        intent?: string;
+        domains?: string[];
+        risk?: "low" | "medium" | "high";
+        agent?: string;
+        reviewers?: string[];
+        profile?: string;
+    };
+    requirements?: TaskRequirement[];
+    constraints?: {
+        breakingApiChanges?: boolean;
+        newDependencies?: boolean;
+        schemaChanges?: boolean;
+        maxFilesChanged?: number;
+        maxLinesAdded?: number;
+        maxLinesDeleted?: number;
+    };
+    impact?: {
+        forbiddenEdges?: string[];
+        forbiddenNodes?: string[];
+        allowedCommunities?: string[];
+    };
+    repair?: {
+        maxAttempts?: number;
+    };
+    verification?: {
+        commands?: ValidationCommand[];
+        validators?: ValidatorSpec[];
+    };
+}
+export interface ValidationCheck {
+    id: string;
+    category: string;
+    status: CheckStatus;
+    message: string;
+    durationMs?: number;
+    details?: Record<string, unknown>;
+}
+export interface ValidationReport {
+    version: 1;
+    taskId: string;
+    status: "PASS" | "FAIL";
+    startedAt: string;
+    finishedAt: string;
+    checks: ValidationCheck[];
+    changedFiles: string[];
+    metadata: {
+        project: string;
+        baseRef: string;
+    };
+}
+export interface RequirementTrace {
+    id: string;
+    proposal: boolean;
+    spec: boolean;
+    design: boolean;
+    acceptance: boolean;
+    tasks: boolean;
+    contract: boolean;
+    validators: string[];
+}
+export interface RepairPacket {
+    version: 1;
+    taskId: string;
+    attempt: number;
+    createdAt: string;
+    failureType?: string;
+    failedAgent?: string;
+    recoveryAction?: string;
+    failures: Array<{
+        id: string;
+        category: string;
+        message: string;
+        details?: Record<string, unknown>;
+    }>;
+}
+export interface WorkerSession {
+    id?: string;
+    provider: string;
+    model?: string;
+    logicalAgent?: string;
+    nativeAgent?: string;
+    runtime?: string;
+    profile?: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    metrics?: UsageMetrics;
+}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/core/verify.d.ts

@@ -0,0 +1,6 @@
+import type { HarnessProjectConfig, TaskContract, ValidationReport } from "./types.js";
+export interface VerifyTaskOptions {
+    stateRoot?: string;
+    policyRoot?: string;
+}
+export declare function verifyTask(root: string, config: HarnessProjectConfig, contract: TaskContract, options?: VerifyTaskOptions): Promise<ValidationReport>;

package/dist/core/verify.js

@@ -0,0 +1,51 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { loadTaskContract } from "./config.js";
+import { getChangedFiles, getDiffStats } from "./git.js";
+import { deliveryWorkspacePath } from "../delivery/handoff.js";
+import { validateDiffScope } from "../validators/diffScope.js";
+import { validateDiffBudget } from "../validators/constraints.js";
+import { runValidationCommand } from "../validators/commands.js";
+import { recordEvent } from "../telemetry/events.js";
+import { runOpaPolicies } from "../validators/opa.js";
+import { verifyTaskSeal } from "./seal.js";
+import { runConfiguredValidators } from "../validators/registry.js";
+import { collectPolicyEvidence } from "../validators/evidence.js";
+export async function verifyTask(root, config, contract, options = {}) {
+    const executionRoot = path.resolve(root);
+    if (!options.stateRoot) {
+        const deliveryRoot = await deliveryWorkspacePath(executionRoot, config, contract.task.id);
+        if (deliveryRoot && path.resolve(deliveryRoot) !== executionRoot) {
+            const workspaceContract = await loadTaskContract(deliveryRoot, contract.task.id, config);
+            return verifyTask(deliveryRoot, config, workspaceContract, { stateRoot: executionRoot, policyRoot: executionRoot });
+        }
+    }
+    const stateRoot = path.resolve(options.stateRoot ?? executionRoot);
+    const policyRoot = path.resolve(options.policyRoot ?? stateRoot);
+    const startedAt = new Date().toISOString();
+    const baseRef = contract.git?.baseRef ?? config.validation?.baseRef ?? "HEAD";
+    await recordEvent(stateRoot, config, "harness.verify.start", { taskId: contract.task.id, baseRef, workspaceRoot: executionRoot === stateRoot ? undefined : executionRoot });
+    const changedFiles = await getChangedFiles(executionRoot, baseRef);
+    const stats = await getDiffStats(executionRoot, baseRef);
+    const checks = [];
+    checks.push(await verifyTaskSeal(executionRoot, contract, config.validation?.requireSeal ?? true));
+    const scopeChecks = validateDiffScope(changedFiles, contract, config.validation?.frozenPaths ?? []);
+    checks.push(...scopeChecks);
+    checks.push(...validateDiffBudget(contract, stats));
+    const frozenChanged = (scopeChecks.find((c) => c.id === "diff.frozen-paths")?.details?.frozenChanged ?? []);
+    const evidence = collectPolicyEvidence(changedFiles);
+    checks.push(await runOpaPolicies(executionRoot, config, contract, changedFiles, frozenChanged, evidence, policyRoot));
+    const commands = [...(config.validation?.commands ?? []), ...(contract.verification?.commands ?? [])];
+    for (const command of commands)
+        checks.push(await runValidationCommand(executionRoot, command));
+    checks.push(...await runConfiguredValidators(executionRoot, config, contract, baseRef, changedFiles));
+    const status = checks.some((check) => check.status === "FAIL") ? "FAIL" : "PASS";
+    const report = { version: 1, taskId: contract.task.id, status, startedAt, finishedAt: new Date().toISOString(), checks, changedFiles, metadata: { project: config.project.name, baseRef } };
+    const reportsDir = config.sdd?.reportsDir ?? ".harness/reports";
+    const output = path.join(stateRoot, reportsDir, `${contract.task.id}.json`);
+    await fs.mkdir(path.dirname(output), { recursive: true });
+    await fs.writeFile(output, `${JSON.stringify(report, null, 2)}\n`);
+    await recordEvent(stateRoot, config, "harness.verify.finish", { taskId: contract.task.id, status, checks: checks.length });
+    return report;
+}
+//# sourceMappingURL=verify.js.map

package/dist/core/verify.js.map

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

package/dist/delivery/finalize.d.ts

@@ -0,0 +1,17 @@
+import type { HarnessProjectConfig, TaskContract } from "../core/types.js";
+export type DeliveryFinalizationStatus = "SKIPPED" | "NO_CHANGES" | "FINALIZED" | "BLOCKED_EXTERNAL" | "SYSTEM_FAILURE";
+export interface DeliveryFinalizationResult {
+    status: DeliveryFinalizationStatus;
+    humanRequired: boolean;
+    committed: boolean;
+    commitSha?: string;
+    pushed: boolean;
+    pullRequest?: {
+        number: number;
+        url: string;
+        draft: boolean;
+    };
+    message: string;
+}
+export declare function finalizeAcceptedIssue(root: string, config: HarnessProjectConfig, contract: TaskContract): Promise<DeliveryFinalizationResult>;
+export declare function deliveryFinalizationFailure(error: unknown): DeliveryFinalizationResult;

package/dist/delivery/finalize.js

@@ -0,0 +1,71 @@
+import { getCurrentBranch } from "../core/git.js";
+import { githubRequest, loadDeliveryRecord, resolveGithubToken } from "./handoff.js";
+import { runProcess } from "../utils/process.js";
+export async function finalizeAcceptedIssue(root, config, contract) {
+    const github = config.delivery?.github;
+    if (!contract.issue || contract.issue.provider !== "github")
+        return skipped("Task is not issue-derived.");
+    if (!github?.enabled || github.finalizeOnAcceptance !== true)
+        return skipped("GitHub finalization is not enabled.");
+    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 current = await getCurrentBranch(root);
+    if (current && current !== branch)
+        throw new Error(`SYSTEM_FAILURE: refusing to finalize ${contract.task.id}; workspace branch is '${current}' but delivery branch is '${branch}'. Enable the isolated delivery workspace or run from the issue branch.`);
+    const status = await runProcess("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 add = await runProcess("git add -A", { cwd: root, timeoutMs: 60_000 });
+        if (add.exitCode !== 0)
+            throw new Error(`SYSTEM_FAILURE: git add failed during deterministic finalization: ${add.stderr || add.stdout}`);
+        const commit = await commitWithConfiguredOrHarnessIdentity(root, `${contract.task.id}: ${contract.task.title}`);
+        if (commit.exitCode !== 0)
+            throw new Error(`SYSTEM_FAILURE: git commit failed during deterministic finalization: ${commit.stderr || commit.stdout}`);
+        committed = true;
+        commitSha = await revParse(root, "HEAD");
+    }
+    else
+        commitSha = await revParse(root, "HEAD");
+    const ahead = await runProcess(`git rev-list --count ${quote(`${base}..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, message: `No commits differ from ${base}; no pull request is required.` };
+    const push = await runProcess(`git push origin HEAD:${quoteRef(branch)}`, { cwd: root, timeoutMs: 180_000 });
+    if (push.exitCode !== 0)
+        throw new Error(`BLOCKED_EXTERNAL: git push failed for ${branch}: ${push.stderr || push.stdout}`);
+    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 existing = await githubRequest(apiBase, token, query);
+    let pr = existing[0];
+    if (!pr) {
+        pr = 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) })
+        });
+    }
+    return { status: "FINALIZED", humanRequired: false, committed, commitSha, pushed: true, 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}.` };
+}
+export function deliveryFinalizationFailure(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const external = /^BLOCKED_EXTERNAL:/.test(message);
+    return { status: external ? "BLOCKED_EXTERNAL" : "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) { return { status: "SKIPPED", humanRequired: false, committed: false, pushed: false, message }; }
+async function commitWithConfiguredOrHarnessIdentity(root, message) { const name = await runProcess("git config user.name", { cwd: root, timeoutMs: 10_000 }); const email = await runProcess("git config user.email", { cwd: root, timeoutMs: 10_000 }); const identity = name.exitCode === 0 && name.stdout.trim() && email.exitCode === 0 && email.stdout.trim() ? "" : `-c user.name=${quote("Agentic Engineering Harness")} -c user.email=${quote("aeh@users.noreply.github.com")}`; return runProcess(`git ${identity} commit -m ${quote(message)}`, { cwd: root, timeoutMs: 120_000 }); }
+async function revParse(root, ref) { const result = await runProcess(`git rev-parse ${quote(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 quote(value) { return `'${value.replaceAll("'", "'\\''")}'`; }
+function quoteRef(value) { if (!/^[A-Za-z0-9._\/-]+$/.test(value))
+    throw new Error(`Unsafe git ref: ${value}`); return value; }
+//# sourceMappingURL=finalize.js.map

package/dist/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/delivery/handoff.d.ts

@@ -0,0 +1,39 @@
+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): 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>;