@tiic-tech/openworkflow 0.1.1 → 0.1.2

package/dist/core/src/git/draftPrPilot.js

@@ -0,0 +1,196 @@
+import { execFile } from "node:child_process";
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { createHash } from "node:crypto";
+import { promisify } from "node:util";
+import { planRemoteReadonly } from "./remoteReadonlyPlanner.js";
+import { dumpYaml } from "../contracts/yaml.js";
+const execFileAsync = promisify(execFile);
+export async function pilotDraftPr(options) {
+    const remotePlan = await planRemoteReadonly(options);
+    const target = {
+        remote: remotePlan.targetIdentity.remote,
+        base: remotePlan.targetIdentity.base,
+        branch: remotePlan.targetIdentity.branch,
+        branchMatchesCurrent: remotePlan.targetIdentity.branchMatchesCurrent,
+        branchOwnsPlan: remotePlan.targetIdentity.branchOwnsPlan,
+    };
+    const prSummaryPath = remotePlan.localState.prSummaryPath;
+    const prSummary = remotePlan.localState.prSummaryExists ? await readFile(join(options.root, prSummaryPath), "utf8") : "";
+    const managedBody = prSummary ? managedPrBody(remotePlan.planId, prSummary) : null;
+    const bodyDigest = managedBody ? digest(managedBody) : null;
+    const existingPr = remotePlan.prState.items[0];
+    const title = options.title ?? `OpenWorkflow ${remotePlan.planId}`;
+    const preview = managedBody ? previewCommand(existingPr, target.branch, target.base, title) : null;
+    const operationKind = preview ? draftPrOperation(existingPr) : "none";
+    const approvalEvidence = options.approvalEvidence?.trim() || null;
+    const auditEvidencePath = options.auditEvidencePath ?? defaultAuditEvidencePath(options.queuePath);
+    const blockers = [
+        ...remotePlan.blockers,
+        ...(!remotePlan.remoteState.branchHead ? [`remote branch head is required before draft PR pilot: ${target.remote}/${target.branch}`] : []),
+        ...(!managedBody ? [`PR-ready summary body is required: ${prSummaryPath}`] : []),
+        ...(!options.dryRun && !options.allowDraftPr ? ["draft PR mutation requires --allow-draft-pr together with --write"] : []),
+        ...(!options.dryRun && !approvalEvidence ? ["draft PR mutation requires --approval-evidence naming explicit operation-level approval"] : []),
+    ];
+    if (blockers.length > 0 || options.dryRun) {
+        const outcome = blockers.length > 0 ? "blocked" : options.dryRun ? "preview" : "no-op";
+        return {
+            ok: blockers.length === 0,
+            mode: "draft-pr-pilot",
+            mutation_performed: false,
+            remotePlanOk: remotePlan.ok,
+            blockers,
+            warnings: [
+                ...remotePlan.warnings,
+                ...(options.dryRun ? ["draft-pr pilot dry-run did not create or edit a PR"] : []),
+            ],
+            target,
+            branchIdentity: remotePlan.targetIdentity.branchIdentity,
+            bodyDigest,
+            managedBodyPreview: managedBody,
+            preview,
+            operation: {
+                kind: operationKind,
+                outcome,
+                approvalEvidence,
+                auditEvidencePath: null,
+                targetPr: existingPrTarget(existingPr),
+            },
+            prUrl: null,
+            rollbackPlan: rollbackPlan(existingPr),
+        };
+    }
+    await ensurePathInsideRoot(options.root, auditEvidencePath);
+    const prUrl = await runGhPrMutation(options.root, preview, managedBody);
+    const operationOutcome = operationKind === "edit" ? "edited" : operationKind === "create" ? "created" : "no-op";
+    await writeDraftPrAuditEvidence(options.root, auditEvidencePath, {
+        schema_version: "0.1.0",
+        contract_type: "audit",
+        artifact_type: "draft_pr_operation_evidence",
+        plan_id: remotePlan.planId,
+        queue_path: options.queuePath,
+        operation_kind: operationKind,
+        target: {
+            remote: target.remote,
+            branch: target.branch,
+            base: target.base,
+            pr_url: prUrl ?? stringValue(existingPr?.url),
+            pr_number: existingPr?.number ? String(existingPr.number) : null,
+        },
+        body_digest: bodyDigest,
+        approval_source: approvalEvidence,
+        timestamp: new Date().toISOString(),
+        result: {
+            mutation_performed: true,
+            outcome: operationOutcome,
+            pr_url: prUrl,
+        },
+        rollback_guidance: rollbackPlan(existingPr),
+    });
+    return {
+        ok: true,
+        mode: "draft-pr-pilot",
+        mutation_performed: true,
+        remotePlanOk: remotePlan.ok,
+        blockers: [],
+        warnings: remotePlan.warnings,
+        target,
+        branchIdentity: remotePlan.targetIdentity.branchIdentity,
+        bodyDigest,
+        managedBodyPreview: managedBody,
+        preview,
+        operation: {
+            kind: operationKind,
+            outcome: operationOutcome,
+            approvalEvidence,
+            auditEvidencePath,
+            targetPr: prUrl ?? existingPrTarget(existingPr),
+        },
+        prUrl,
+        rollbackPlan: rollbackPlan(existingPr),
+    };
+}
+function previewCommand(existingPr, branch, base, title) {
+    if (existingPr?.number) {
+        return {
+            command: "gh",
+            args: ["pr", "edit", String(existingPr.number), "--title", title, "--body-file", "<managed-body-file>"],
+        };
+    }
+    return {
+        command: "gh",
+        args: ["pr", "create", "--draft", "--base", base, "--head", branch, "--title", title, "--body-file", "<managed-body-file>"],
+    };
+}
+function draftPrOperation(existingPr) {
+    return existingPr?.number ? "edit" : "create";
+}
+async function runGhPrMutation(root, preview, managedBody) {
+    if (!preview || !managedBody) {
+        return null;
+    }
+    const tempRoot = await mkdtemp(join(tmpdir(), "openworkflow-draft-pr-"));
+    const bodyPath = join(tempRoot, "body.md");
+    try {
+        await writeFile(bodyPath, managedBody, "utf8");
+        const args = preview.args.map((arg) => arg === "<managed-body-file>" ? bodyPath : arg);
+        const { stdout } = await execFileAsync(preview.command, args, { cwd: root });
+        return stdout.trim().split("\n").find((line) => line.startsWith("http")) ?? null;
+    }
+    finally {
+        await rm(tempRoot, { recursive: true, force: true });
+    }
+}
+async function writeDraftPrAuditEvidence(root, path, evidence) {
+    const outputPath = await ensurePathInsideRoot(root, path);
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, dumpYaml(evidence), "utf8");
+}
+async function ensurePathInsideRoot(root, path) {
+    const rootPath = resolve(root);
+    const outputPath = resolve(rootPath, path);
+    const relativePath = relative(rootPath, outputPath);
+    if (!relativePath || relativePath.startsWith("..") || isAbsolute(relativePath)) {
+        throw new Error(`draft PR audit evidence path escapes root: ${path}`);
+    }
+    await mkdir(dirname(outputPath), { recursive: true });
+    return outputPath;
+}
+function managedPrBody(planId, summary) {
+    const content = summary.trim();
+    const contentDigest = digest(content);
+    return [
+        `<!-- openworkflow:managed:start plan=${planId} digest=${contentDigest} -->`,
+        content,
+        "<!-- openworkflow:managed:end -->",
+        "",
+    ].join("\n");
+}
+function digest(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+function defaultAuditEvidencePath(queuePath) {
+    const parts = queuePath.split("/");
+    parts[parts.length - 1] = "DRAFT_PR_OPERATION_EVIDENCE.yaml";
+    return parts.join("/");
+}
+function existingPrTarget(existingPr) {
+    return stringValue(existingPr?.url) ?? (existingPr?.number ? `PR #${String(existingPr.number)}` : null);
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function rollbackPlan(existingPr) {
+    if (existingPr?.number) {
+        return [
+            `restore the previous managed PR body section for PR #${String(existingPr.number)}`,
+            "if restore is unsafe, leave a follow-up comment and stop for human review",
+        ];
+    }
+    return [
+        "close the draft PR if it was created with the wrong branch, base, or body",
+        "do not merge or mark ready for review from the pilot",
+    ];
+}
+//# sourceMappingURL=draftPrPilot.js.map

package/dist/core/src/git/draftPrPilot.js.map

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

package/dist/core/src/git/localEvidenceReader.d.ts

@@ -0,0 +1,21 @@
+export interface LocalGitCommitEvidence {
+    candidate_id: string;
+    selected_change_id: string | null;
+    hash: string;
+    role: "legacy" | "primary" | "evidence" | "head";
+    evidence_path: string | null;
+    source: "completion_evidence" | "local_commit_evidence";
+}
+export interface LocalGitValidationEvidence {
+    candidate_id: string;
+    selected_change_id: string | null;
+    value: string;
+    evidence_path: string | null;
+    source: "queue_validation" | "completion_evidence" | "local_commit_evidence";
+}
+export interface LocalGitEvidenceReport {
+    commitEvidence: LocalGitCommitEvidence[];
+    validationEvidence: LocalGitValidationEvidence[];
+    warnings: string[];
+}
+export declare function readLocalGitEvidence(root: string, queue: Record<string, unknown>): Promise<LocalGitEvidenceReport>;

package/dist/core/src/git/localEvidenceReader.js

@@ -0,0 +1,142 @@
+import { readFile } from "node:fs/promises";
+import { parseYaml } from "../contracts/yaml.js";
+import { resolveLocalReference } from "../fs/index.js";
+export async function readLocalGitEvidence(root, queue) {
+    const commitEvidence = [];
+    const validationEvidence = [];
+    const warnings = [];
+    const seenCommits = new Set();
+    const seenValidation = new Set();
+    const addCommit = (item) => {
+        const key = `${item.candidate_id}\0${item.selected_change_id ?? ""}\0${item.hash}\0${item.role}\0${item.evidence_path ?? ""}`;
+        if (!seenCommits.has(key)) {
+            seenCommits.add(key);
+            commitEvidence.push(item);
+        }
+    };
+    const addValidation = (item) => {
+        const key = `${item.candidate_id}\0${item.selected_change_id ?? ""}\0${item.value}\0${item.evidence_path ?? ""}`;
+        if (!seenValidation.has(key)) {
+            seenValidation.add(key);
+            validationEvidence.push(item);
+        }
+    };
+    for (const item of array(record(queue.validation).commands_run)) {
+        const value = String(item).trim();
+        if (value.length > 0) {
+            addValidation({
+                candidate_id: "queue",
+                selected_change_id: null,
+                value,
+                evidence_path: null,
+                source: "queue_validation",
+            });
+        }
+    }
+    for (const candidate of array(queue.changes).map(record)) {
+        const candidateId = stringValue(candidate.id) ?? "unknown";
+        const selectedChangeId = stringValue(record(candidate.selection).selected_change_id);
+        for (const rawEvidence of array(record(candidate.completion).evidence).map(String)) {
+            const evidence = rawEvidence.trim();
+            if (evidence.startsWith("commit:")) {
+                const hash = evidence.replace(/^commit:\s*/, "").trim();
+                if (hash.length > 0) {
+                    addCommit({
+                        candidate_id: candidateId,
+                        selected_change_id: selectedChangeId,
+                        hash,
+                        role: "legacy",
+                        evidence_path: null,
+                        source: "completion_evidence",
+                    });
+                }
+                continue;
+            }
+            if (evidence.startsWith("validation:")) {
+                const value = evidence.replace(/^validation:\s*/, "").trim();
+                if (value.length > 0) {
+                    addValidation({
+                        candidate_id: candidateId,
+                        selected_change_id: selectedChangeId,
+                        value,
+                        evidence_path: null,
+                        source: "completion_evidence",
+                    });
+                }
+                continue;
+            }
+            if (!evidence.endsWith("LOCAL_COMMIT_EVIDENCE.yaml")) {
+                continue;
+            }
+            const localEvidence = await readLocalCommitEvidence(root, evidence);
+            warnings.push(...localEvidence.warnings.map((warning) => `${candidateId}: ${warning}`));
+            if (!localEvidence.record) {
+                continue;
+            }
+            const evidenceSelectedChangeId = stringValue(localEvidence.record.selected_change_id) ?? selectedChangeId;
+            addCommitFields(addCommit, candidateId, evidenceSelectedChangeId, evidence, localEvidence.record);
+            for (const item of array(localEvidence.record.validation_evidence)) {
+                const value = String(item).trim();
+                if (value.length > 0) {
+                    addValidation({
+                        candidate_id: candidateId,
+                        selected_change_id: evidenceSelectedChangeId,
+                        value,
+                        evidence_path: evidence,
+                        source: "local_commit_evidence",
+                    });
+                }
+            }
+        }
+    }
+    return { commitEvidence, validationEvidence, warnings };
+}
+async function readLocalCommitEvidence(root, evidencePath) {
+    const resolution = resolveLocalReference(root, evidencePath);
+    if (resolution.kind !== "local") {
+        return { record: null, warnings: [`commit evidence path is not a repo-local file: ${evidencePath}`] };
+    }
+    if (!resolution.exists) {
+        return { record: null, warnings: [`commit evidence path does not exist: ${evidencePath}`] };
+    }
+    try {
+        const parsed = record(parseYaml(await readFile(resolution.path, "utf8")));
+        if (stringValue(parsed.planning_artifact_type) !== "implementation_evidence") {
+            return { record: null, warnings: [`commit evidence path is not implementation_evidence: ${evidencePath}`] };
+        }
+        return { record: parsed, warnings: [] };
+    }
+    catch (error) {
+        return { record: null, warnings: [`could not read commit evidence ${evidencePath}: ${error instanceof Error ? error.message : String(error)}`] };
+    }
+}
+function addCommitFields(addCommit, candidateId, selectedChangeId, evidencePath, evidence) {
+    const fields = [
+        { key: "primary_commit", role: "primary" },
+        { key: "evidence_commit", role: "evidence" },
+        { key: "head_commit", role: "head" },
+    ];
+    for (const field of fields) {
+        const hash = stringValue(evidence[field.key]);
+        if (hash) {
+            addCommit({
+                candidate_id: candidateId,
+                selected_change_id: selectedChangeId,
+                hash,
+                role: field.role,
+                evidence_path: evidencePath,
+                source: "local_commit_evidence",
+            });
+        }
+    }
+}
+function record(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function array(value) {
+    return Array.isArray(value) ? value : [];
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+//# sourceMappingURL=localEvidenceReader.js.map

package/dist/core/src/git/localEvidenceReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localEvidenceReader.js","sourceRoot":"","sources":["../../../../packages/core/src/git/localEvidenceReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAyBvD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAA8B;IACrF,MAAM,cAAc,GAA6B,EAAE,CAAC;IACpD,MAAM,kBAAkB,GAAiC,EAAE,CAAC;IAC5D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC,MAAM,SAAS,GAAG,CAAC,IAA4B,EAAQ,EAAE;QACvD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,kBAAkB,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;QAC9H,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;IACF,MAAM,aAAa,GAAG,CAAC,IAAgC,EAAQ,EAAE;QAC/D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,kBAAkB,IAAI,EAAE,KAAK,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;QACjH,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;QAChE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,aAAa,CAAC;gBACZ,YAAY,EAAE,OAAO;gBACrB,kBAAkB,EAAE,IAAI;gBACxB,KAAK;gBACL,aAAa,EAAE,IAAI;gBACnB,MAAM,EAAE,kBAAkB;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC;QAC3D,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;QACrF,KAAK,MAAM,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACnF,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;YACpC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,SAAS,CAAC;wBACR,YAAY,EAAE,WAAW;wBACzB,kBAAkB,EAAE,gBAAgB;wBACpC,IAAI;wBACJ,IAAI,EAAE,QAAQ;wBACd,aAAa,EAAE,IAAI;wBACnB,MAAM,EAAE,qBAAqB;qBAC9B,CAAC,CAAC;gBACL,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC7D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,aAAa,CAAC;wBACZ,YAAY,EAAE,WAAW;wBACzB,kBAAkB,EAAE,gBAAgB;wBACpC,KAAK;wBACL,aAAa,EAAE,IAAI;wBACnB,MAAM,EAAE,qBAAqB;qBAC9B,CAAC,CAAC;gBACL,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,CAAC;gBACrD,SAAS;YACX,CAAC;YACD,MAAM,aAAa,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACpE,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,WAAW,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;YACxF,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;gBAC1B,SAAS;YACX,CAAC;YACD,MAAM,wBAAwB,GAAG,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,gBAAgB,CAAC;YAC1G,eAAe,CAAC,SAAS,EAAE,WAAW,EAAE,wBAAwB,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;YAClG,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBACnE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,aAAa,CAAC;wBACZ,YAAY,EAAE,WAAW;wBACzB,kBAAkB,EAAE,wBAAwB;wBAC5C,KAAK;wBACL,aAAa,EAAE,QAAQ;wBACvB,MAAM,EAAE,uBAAuB;qBAChC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,IAAY,EAAE,YAAoB;IACvE,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC7D,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,kDAAkD,YAAY,EAAE,CAAC,EAAE,CAAC;IACxG,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,wCAAwC,YAAY,EAAE,CAAC,EAAE,CAAC;IAC9F,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1E,IAAI,WAAW,CAAC,MAAM,CAAC,sBAAsB,CAAC,KAAK,yBAAyB,EAAE,CAAC;YAC7E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,wDAAwD,YAAY,EAAE,CAAC,EAAE,CAAC;QAC9G,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,kCAAkC,YAAY,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACnJ,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,SAAiD,EACjD,WAAmB,EACnB,gBAA+B,EAC/B,YAAoB,EACpB,QAAiC;IAEjC,MAAM,MAAM,GAAiE;QAC3E,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC1C,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,EAAE;QAC5C,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE;KACrC,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC;gBACR,YAAY,EAAE,WAAW;gBACzB,kBAAkB,EAAE,gBAAgB;gBACpC,IAAI;gBACJ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,aAAa,EAAE,YAAY;gBAC3B,MAAM,EAAE,uBAAuB;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7G,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC"}

package/dist/core/src/git/localGitAutomation.d.ts

@@ -0,0 +1,68 @@
+import { type BranchIdentityAssessment, type BranchIdentityException } from "./branchIdentity.js";
+export type LocalFeatBranchAction = "already_on_branch" | "checkout_existing_branch" | "create_branch";
+export type SelectedChangeCommitAction = "commit_selected_change";
+export interface LocalGitCommandPreview {
+    command: "git";
+    args: string[];
+}
+export interface EnsureLocalFeatBranchOptions {
+    root: string;
+    planId?: string;
+    branchBoundary: string;
+    dryRun?: boolean;
+    branchIdentityException?: BranchIdentityException | null;
+}
+export interface EnsureLocalFeatBranchResult {
+    ok: boolean;
+    dryRun: boolean;
+    branchBoundary: string;
+    currentBranch: string | null;
+    branchMatchesCurrent: boolean | null;
+    branchOwnsPlan: boolean | null;
+    branchIdentity: BranchIdentityAssessment | null;
+    dirtyPaths: string[];
+    action: LocalFeatBranchAction | null;
+    preview: LocalGitCommandPreview | null;
+    errors: string[];
+    warnings: string[];
+}
+export interface CommitSelectedChangeOptions {
+    root: string;
+    planId: string;
+    candidateId: string;
+    selectedChangeId: string;
+    branchBoundary?: string;
+    allowedPaths: string[];
+    validationEvidence: string[];
+    commitMessage: string;
+    dryRun?: boolean;
+    evidencePath?: string;
+    commitEvidence?: boolean;
+    requireEvidenceBackfill?: boolean;
+    queuePath?: string;
+    selectedChangePath?: string;
+    branchIdentityException?: BranchIdentityException | null;
+}
+export interface CommitSelectedChangeResult {
+    ok: boolean;
+    dryRun: boolean;
+    planId: string;
+    candidateId: string;
+    selectedChangeId: string;
+    currentBranch: string | null;
+    dirtyPaths: string[];
+    includedPaths: string[];
+    unrelatedDirtyPaths: string[];
+    validationEvidence: string[];
+    action: SelectedChangeCommitAction | null;
+    preview: LocalGitCommandPreview | null;
+    primaryCommit: string | null;
+    evidenceCommit: string | null;
+    headCommit: string | null;
+    evidencePath: string | null;
+    evidenceBackfilledPaths: string[];
+    errors: string[];
+    warnings: string[];
+}
+export declare function ensureLocalFeatBranch(options: EnsureLocalFeatBranchOptions): Promise<EnsureLocalFeatBranchResult>;
+export declare function commitSelectedChange(options: CommitSelectedChangeOptions): Promise<CommitSelectedChangeResult>;