agentplane 0.3.9 → 0.3.11

package/dist/commands/task/finish.js

@@ -1,13 +1,19 @@
+import { resolveBaseBranch } from "@agentplaneorg/core";
 import { mapBackendError } from "../../cli/error-map.js";
+import { exitCodeForError } from "../../cli/exit-codes.js";
 import { infoMessage, invalidValueMessage, successMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
 import { readFile, rm } from "node:fs/promises";
 import path from "node:path";
 import { ensureActionApproved } from "../shared/approval-requirements.js";
 import { ensureReconciledBeforeMutation } from "../shared/reconcile-check.js";
+import { gitCurrentBranch } from "../shared/git-ops.js";
 import { loadCommandContext } from "../shared/task-backend.js";
 import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
+import { applyTaskMutation } from "../shared/task-mutation.js";
+import { collectTaskIncidents, renderIncidentCollectionPlanOutcome } from "../incidents/shared.js";
 import { createTaskCloseCommit, existingCommitInfo, loadTaskForFinish, writeFinishedTasks, } from "./finish-shared.js";
+import { buildStructuredFindingMutationPlan } from "./findings.js";
 import { defaultCommitEmojiForStatus, enforceStatusCommitPolicy, prepareTaskTransitionComment, readCommitInfo, requireStructuredComment, runTaskTransitionCommentCommit, } from "./shared.js";
 async function clearDirectWorkLockIfMatches(opts) {
     const lockPath = path.join(opts.agentplaneDir, "cache", "direct-work.json");
@@ -25,11 +31,68 @@ async function clearDirectWorkLockIfMatches(opts) {
         // best-effort
     }
 }
+async function ensureFinishRunsOnBaseBranch(opts) {
+    if (opts.ctx.config.workflow_mode !== "branch_pr")
+        return;
+    const baseBranch = await resolveBaseBranch({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+        cliBaseOpt: opts.baseBranchOverride ?? null,
+        mode: opts.ctx.config.workflow_mode,
+    });
+    if (!baseBranch) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_USAGE"),
+            code: "E_USAGE",
+            message: "Base branch could not be resolved (use `agentplane branch base set` or --base).",
+        });
+    }
+    const currentBranch = await gitCurrentBranch(opts.ctx.resolvedProject.gitRoot);
+    if (currentBranch === baseBranch)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: `finish must run on base branch ${baseBranch} in branch_pr mode ` +
+            `(current: ${currentBranch}); integrate first or reconcile from the base checkout.`,
+    });
+}
+async function appendFinishStructuredFinding(opts) {
+    await applyTaskMutation({
+        ctx: opts.ctx,
+        taskId: opts.taskId,
+        build: (current) => {
+            const plan = buildStructuredFindingMutationPlan({
+                current,
+                config: opts.ctx.config,
+                observation: opts.finding.observation,
+                impact: opts.finding.impact,
+                resolution: opts.finding.resolution,
+                promote: !opts.finding.localOnly,
+                external: !opts.finding.localOnly,
+                fixability: opts.finding.repoFixable ? "repo-fixable" : null,
+                incidentScope: opts.finding.incidentScope,
+                incidentTags: opts.finding.incidentTags,
+                incidentMatch: opts.finding.incidentMatch,
+                incidentAdvice: opts.finding.incidentAdvice,
+                incidentRule: opts.finding.incidentRule,
+                updatedBy: opts.author,
+            });
+            return plan ? { intents: plan.intents } : null;
+        },
+    });
+}
 export async function cmdFinish(opts) {
     try {
         const ctx = opts.ctx ??
             (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
         await ensureReconciledBeforeMutation({ ctx, command: "finish" });
+        await ensureFinishRunsOnBaseBranch({
+            ctx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            baseBranchOverride: opts.baseBranchOverride,
+        });
         if (opts.force) {
             await ensureActionApproved({
                 action: "force_action",
@@ -139,6 +202,49 @@ export async function cmdFinish(opts) {
         const resultSummary = typeof opts.result === "string" ? opts.result.trim() : "";
         const riskLevel = opts.risk;
         const breaking = opts.breaking === true;
+        const finishFinding = typeof opts.observation === "string" &&
+            typeof opts.impact === "string" &&
+            typeof opts.resolution === "string"
+            ? {
+                observation: opts.observation,
+                impact: opts.impact,
+                resolution: opts.resolution,
+                localOnly: opts.localOnly === true,
+                repoFixable: opts.repoFixable === true,
+                incidentScope: opts.incidentScope,
+                incidentTags: opts.incidentTags ?? [],
+                incidentMatch: opts.incidentMatch ?? [],
+                incidentAdvice: opts.incidentAdvice,
+                incidentRule: opts.incidentRule,
+            }
+            : null;
+        if (finishFinding && opts.taskIds.length !== 1) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "--observation/--impact/--resolution and incident finding options require exactly one task id",
+            });
+        }
+        if (finishFinding && primaryTaskId) {
+            await loadTaskForFinish({
+                ctx,
+                store,
+                useStore,
+                taskId: primaryTaskId,
+                taskCount: opts.taskIds.length,
+                metaTaskId,
+                resultProvided,
+                resultSummary,
+                force: opts.force,
+                capturePrimaryLifecycleMeta: false,
+            });
+            await appendFinishStructuredFinding({
+                ctx,
+                taskId: primaryTaskId,
+                author: opts.author,
+                finding: finishFinding,
+            });
+        }
         let primaryStatusFrom = null;
         let primaryTag = null;
         const loadedTasks = [];
@@ -161,6 +267,15 @@ export async function cmdFinish(opts) {
                 primaryTag = loaded.primaryTag;
             }
         }
+        for (const taskId of opts.taskIds) {
+            const loadedTask = loadedTasks.find((candidate) => candidate.taskId === taskId) ?? null;
+            await collectTaskIncidents({
+                ctx,
+                taskId,
+                task: loadedTask?.task ?? null,
+                write: false,
+            });
+        }
         const tasksMissingCommit = loadedTasks
             .filter(({ task }) => !existingCommitInfo(task))
             .map(({ taskId }) => taskId);
@@ -263,6 +378,20 @@ export async function cmdFinish(opts) {
             breaking,
             taskCommitInfo,
         });
+        const incidentPlans = [];
+        const incidentRegistryPaths = [];
+        for (const taskId of opts.taskIds) {
+            const loadedTask = loadedTasks.find((candidate) => candidate.taskId === taskId) ?? null;
+            const collected = await collectTaskIncidents({
+                ctx,
+                taskId,
+                task: loadedTask?.task ?? null,
+                write: true,
+            });
+            incidentPlans.push(collected.plan);
+            incidentRegistryPaths.push(collected.registryPaths);
+        }
+        const promotedIncidents = incidentPlans.reduce((sum, plan) => sum + plan.promotable.length, 0);
         // tasks.json is export-only; generated via `agentplane task export`.
         if (shouldCloseCommit && primaryTaskId) {
             if (!opts.quiet) {
@@ -276,6 +405,7 @@ export async function cmdFinish(opts) {
                 baseBranchOverride: opts.baseBranchOverride,
                 quiet: opts.quiet,
                 closeUnstageOthers: opts.closeCommit === true && opts.closeUnstageOthers === true,
+                allowPolicy: promotedIncidents > 0,
             });
         }
         if (ctx.config.workflow_mode === "direct") {
@@ -285,6 +415,19 @@ export async function cmdFinish(opts) {
             });
         }
         if (!opts.quiet) {
+            const incidentPlan = incidentPlans[0] ?? {
+                candidates: [],
+                skipped: [],
+                promotable: [],
+                duplicates: [],
+            };
+            process.stdout.write(`${infoMessage(renderIncidentCollectionPlanOutcome(incidentPlan, {
+                wrote: promotedIncidents > 0,
+                context: "finish",
+                promotedIds: incidentPlan.promotable.map((item) => item.entry.id),
+                registryPaths: incidentRegistryPaths[0] ?? [],
+                taskId: opts.taskIds[0] ?? null,
+            }))}\n`);
             process.stdout.write(`${successMessage("finished")}\n`);
         }
         return 0;

package/dist/commands/task/hosted-close-pr.command.d.ts

@@ -0,0 +1,11 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import { type CommandContext } from "../shared/task-backend.js";
+type TaskHostedClosePrParsed = {
+    taskIds: string[];
+    branch: string | null;
+    repo: string | null;
+};
+export declare const taskHostedClosePrSpec: CommandSpec<TaskHostedClosePrParsed>;
+export declare function makeRunTaskHostedClosePrHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskHostedClosePrParsed) => Promise<number>;
+export {};
+//# sourceMappingURL=hosted-close-pr.command.d.ts.map

package/dist/commands/task/hosted-close-pr.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-close-pr.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/hosted-close-pr.command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAQtE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAQnC,KAAK,uBAAuB,GAAG;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAgBF,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,uBAAuB,CAoEtE,CAAC;AAmYF,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAChF,KAAK,UAAU,EAAE,GAAG,uBAAuB,KAAG,OAAO,CAAC,MAAM,CAAC,CAsB5E"}

package/dist/commands/task/hosted-close-pr.command.js

@@ -0,0 +1,414 @@
+import { readFile } from "node:fs/promises";
+import { usageError } from "../../cli/spec/errors.js";
+import { createCliEmitter } from "../../cli/output.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { fileExists } from "../../cli/fs-utils.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+import { loadTaskFromContext, resolveTaskBranchFromContext, } from "../shared/task-backend.js";
+import { parseTaskIdFromCloseBranch } from "../shared/git-worktree.js";
+import { parsePrMeta } from "../shared/pr-meta.js";
+import { resolveDefaultGithubRepo, runGhApiJson } from "../pr/internal/gh-api.js";
+import { resolvePrPaths } from "../pr/internal/pr-paths.js";
+import { resolveBaseBranch } from "@agentplaneorg/core";
+export const taskHostedClosePrSpec = {
+    id: ["task", "hosted-close-pr"],
+    group: "Task",
+    summary: "Open one or more follow-up hosted closure PRs from remote task-close branches.",
+    args: [{ name: "task-id", required: true, variadic: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "branch",
+            valueHint: "<name>",
+            description: "Optional explicit task-close branch name (default: derive from task PR metadata or remote refs).",
+        },
+        {
+            kind: "string",
+            name: "repo",
+            valueHint: "<owner/name>",
+            description: "Optional GitHub owner/repo override (defaults to origin remote).",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane task hosted-close-pr 202604091218-JREJ4K",
+            why: "Open the hosted closure PR after the workflow left a manual handoff comment.",
+        },
+        {
+            cmd: "agentplane task hosted-close-pr 202604091725-CB0Y6S 202604091725-H21SCP",
+            why: "Open multiple pending hosted closure PRs in one batch after a closure-wave merge.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const taskIds = Array.isArray(raw.args["task-id"])
+            ? raw.args["task-id"]
+            : typeof raw.args["task-id"] === "string"
+                ? [raw.args["task-id"]]
+                : [];
+        const normalizedTaskIds = taskIds.map((taskId) => String(taskId).trim()).filter(Boolean);
+        if (normalizedTaskIds.length === 0) {
+            throw usageError({
+                spec: taskHostedClosePrSpec,
+                message: "Invalid value for task-id: empty.",
+            });
+        }
+        if (typeof raw.opts.branch === "string" && raw.opts.branch.trim() === "") {
+            throw usageError({
+                spec: taskHostedClosePrSpec,
+                message: "Invalid value for --branch: empty.",
+            });
+        }
+        if (typeof raw.opts.repo === "string" && raw.opts.repo.trim() === "") {
+            throw usageError({
+                spec: taskHostedClosePrSpec,
+                message: "Invalid value for --repo: empty.",
+            });
+        }
+    },
+    parse: (raw) => ({
+        taskIds: (Array.isArray(raw.args["task-id"])
+            ? raw.args["task-id"]
+            : typeof raw.args["task-id"] === "string"
+                ? [raw.args["task-id"]]
+                : [])
+            .map((taskId) => String(taskId).trim())
+            .filter(Boolean),
+        branch: typeof raw.opts.branch === "string" ? raw.opts.branch : null,
+        repo: typeof raw.opts.repo === "string" ? raw.opts.repo : null,
+    }),
+};
+async function resolveGithubRepo(opts) {
+    const repo = opts.repoOverride?.trim() ?? "";
+    if (repo)
+        return repo;
+    return await resolveDefaultGithubRepo(opts.gitRoot);
+}
+function selectMergedPullRecord(opts) {
+    const merged = opts.pulls.filter((record) => {
+        if (typeof record.merged_at !== "string" || record.merged_at.trim().length === 0)
+            return false;
+        const headRef = record.head?.ref?.trim() ?? "";
+        if (opts.sourceBranch && headRef && headRef !== opts.sourceBranch)
+            return false;
+        const baseRef = record.base?.ref?.trim() ?? "";
+        if (opts.baseBranch && baseRef && baseRef !== opts.baseBranch)
+            return false;
+        return true;
+    });
+    if (merged.length === 0)
+        return null;
+    if (typeof opts.prNumber === "number" && opts.prNumber > 0) {
+        const exact = merged.find((record) => Number(record.number ?? 0) === opts.prNumber);
+        if (exact)
+            return exact;
+    }
+    return ([...merged].toSorted((left, right) => {
+        const leftAt = Date.parse(left.merged_at ?? "");
+        const rightAt = Date.parse(right.merged_at ?? "");
+        return Number.isNaN(rightAt) || Number.isNaN(leftAt) ? 0 : rightAt - leftAt;
+    })[0] ?? null);
+}
+async function resolveHostedCloseMergeRecord(opts) {
+    const owner = opts.repo.split("/")[0]?.trim() ?? "";
+    if (!owner)
+        return null;
+    const query = new URLSearchParams({
+        state: "closed",
+        head: `${owner}:${opts.sourceBranch}`,
+    });
+    if (opts.baseBranch)
+        query.set("base", opts.baseBranch);
+    const records = await runGhApiJson(opts.gitRoot, [
+        `repos/${opts.repo}/pulls?${query.toString()}`,
+    ]);
+    return selectMergedPullRecord({
+        pulls: Array.isArray(records) ? records : [],
+        sourceBranch: opts.sourceBranch,
+        baseBranch: opts.baseBranch,
+        prNumber: opts.prNumber,
+    });
+}
+async function resolveHostedCloseMergeRecordByCommit(opts) {
+    const records = await runGhApiJson(opts.gitRoot, [
+        `repos/${opts.repo}/commits/${opts.mergeCommit}/pulls`,
+    ]);
+    return selectMergedPullRecord({
+        pulls: Array.isArray(records) ? records : [],
+        sourceBranch: opts.sourceBranch,
+        baseBranch: opts.baseBranch,
+        prNumber: opts.prNumber,
+    });
+}
+async function readHostedCloseState(opts) {
+    const task = await loadTaskFromContext({ ctx: opts.ctx, taskId: opts.taskId });
+    const taskBranch = await resolveTaskBranchFromContext({ ctx: opts.ctx, taskId: opts.taskId });
+    const { metaPath, config } = await resolvePrPaths({
+        ctx: opts.ctx,
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride,
+        taskId: opts.taskId,
+    });
+    if (config.workflow_mode !== "branch_pr") {
+        throw new CliError({
+            exitCode: exitCodeForError("E_USAGE"),
+            code: "E_USAGE",
+            message: `Invalid workflow_mode: ${config.workflow_mode} (expected branch_pr)`,
+        });
+    }
+    if (!(await fileExists(metaPath))) {
+        return { meta: null, task, taskBranch };
+    }
+    const meta = parsePrMeta(await readFile(metaPath, "utf8"), opts.taskId);
+    return { meta, task, taskBranch };
+}
+async function listRemoteTaskCloseBranches(opts) {
+    const { stdout } = await execFileAsync("git", ["ls-remote", "--heads", "origin", `task-close/${opts.taskId}/*`], {
+        cwd: opts.gitRoot,
+        env: gitEnv(),
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    return stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .map((line) => line.split(/\s+/, 2)[1] ?? "")
+        .map((ref) => ref.replace(/^refs\/heads\//, ""))
+        .filter((ref) => ref.length > 0);
+}
+function shortSha(value) {
+    return value.trim().slice(0, 12);
+}
+function stripBranchRef(branch) {
+    return branch.startsWith("refs/heads/") ? branch.slice("refs/heads/".length) : branch;
+}
+async function resolveHostedCloseBranch(opts) {
+    const remoteBranches = await listRemoteTaskCloseBranches({
+        gitRoot: opts.gitRoot,
+        taskId: opts.taskId,
+    });
+    const explicitBranch = stripBranchRef(opts.explicitBranch?.trim() ?? "");
+    if (explicitBranch) {
+        const parsedTaskId = parseTaskIdFromCloseBranch(explicitBranch);
+        if (parsedTaskId && parsedTaskId !== opts.taskId) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_VALIDATION"),
+                code: "E_VALIDATION",
+                message: `Branch ${explicitBranch} does not belong to task ${opts.taskId}.`,
+            });
+        }
+        if (!remoteBranches.includes(explicitBranch)) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_VALIDATION"),
+                code: "E_VALIDATION",
+                message: `Remote hosted closure branch not found: ${explicitBranch}.`,
+            });
+        }
+        return explicitBranch;
+    }
+    if (opts.mergeCommit) {
+        const expected = `task-close/${opts.taskId}/${shortSha(opts.mergeCommit)}`;
+        if (remoteBranches.includes(expected))
+            return expected;
+        if (remoteBranches.length === 1)
+            return remoteBranches[0] ?? expected;
+        if (remoteBranches.length > 1) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_VALIDATION"),
+                code: "E_VALIDATION",
+                message: `Multiple remote hosted closure branches match ${opts.taskId}: ${remoteBranches.join(", ")} (use --branch).`,
+            });
+        }
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Remote hosted closure branch not found for ${opts.taskId}: ${expected}.`,
+        });
+    }
+    if (remoteBranches.length === 1)
+        return remoteBranches[0] ?? "";
+    if (remoteBranches.length > 1) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Multiple remote hosted closure branches match ${opts.taskId}: ${remoteBranches.join(", ")} (use --branch).`,
+        });
+    }
+    throw new CliError({
+        exitCode: exitCodeForError("E_VALIDATION"),
+        code: "E_VALIDATION",
+        message: `Could not resolve remote hosted closure branch for ${opts.taskId}.`,
+    });
+}
+function buildHostedClosePrTitle(taskId) {
+    return `📝 ${taskId} task: close after hosted merge`;
+}
+function buildHostedClosePrBody(opts) {
+    const prLine = typeof opts.prNumber === "number" && opts.prNumber > 0
+        ? `Automated closure for merged task PR #${opts.prNumber}.`
+        : "Automated closure for merged task PR.";
+    return [
+        prLine,
+        "",
+        `- task_id: \`${opts.taskId}\``,
+        `- source_branch: \`${opts.sourceBranch}\``,
+        `- merge_sha: \`${opts.mergeSha}\``,
+        "",
+        "This PR contains only tracked task artifacts produced by the hosted branch_pr closure flow.",
+    ].join("\n");
+}
+function normalizeGithubPrLink(prNumber, prUrl, verb) {
+    return prUrl?.trim()
+        ? `${verb} GitHub PR #${prNumber}: ${prUrl.trim()}`
+        : `${verb} GitHub PR #${prNumber}`;
+}
+async function openHostedClosePr(opts) {
+    const output = createCliEmitter();
+    const { meta, task, taskBranch } = await readHostedCloseState({
+        ctx: opts.ctx,
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride,
+        taskId: opts.taskId,
+    });
+    const gitRoot = opts.ctx.resolvedProject.gitRoot;
+    const repo = await resolveGithubRepo({ gitRoot, repoOverride: opts.repo ?? null });
+    const defaultBaseBranch = await resolveBaseBranch({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+        cliBaseOpt: null,
+        mode: opts.ctx.config.workflow_mode,
+    });
+    let sourceBranch = meta?.branch?.trim() ?? taskBranch?.trim() ?? "";
+    let baseBranch = meta?.base?.trim() ?? defaultBaseBranch?.trim() ?? "";
+    let mergedRecord = sourceBranch.length > 0 &&
+        (meta?.status !== "MERGED" || !(meta?.merge_commit?.trim() ?? task.commit?.hash?.trim() ?? ""))
+        ? await resolveHostedCloseMergeRecord({
+            gitRoot,
+            repo,
+            sourceBranch,
+            baseBranch: baseBranch || null,
+            prNumber: typeof meta?.pr_number === "number" ? meta.pr_number : null,
+        })
+        : null;
+    const localMergeCommit = meta?.merge_commit?.trim() ?? task.commit?.hash?.trim() ?? "";
+    if (!mergedRecord && localMergeCommit) {
+        mergedRecord = await resolveHostedCloseMergeRecordByCommit({
+            gitRoot,
+            repo,
+            mergeCommit: localMergeCommit,
+            sourceBranch: sourceBranch || null,
+            baseBranch: baseBranch || null,
+            prNumber: typeof meta?.pr_number === "number" ? meta.pr_number : null,
+        });
+    }
+    if (!sourceBranch) {
+        sourceBranch = mergedRecord?.head?.ref?.trim() ?? "";
+    }
+    if (!baseBranch) {
+        baseBranch = mergedRecord?.base?.ref?.trim() ?? defaultBaseBranch?.trim() ?? "";
+    }
+    const mergeCommit = meta?.merge_commit?.trim() ??
+        task.commit?.hash?.trim() ??
+        mergedRecord?.merge_commit_sha?.trim() ??
+        "";
+    if (!sourceBranch) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Missing hosted close source branch for ${opts.taskId}.`,
+        });
+    }
+    if (!mergeCommit) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Missing hosted close merge commit for ${opts.taskId}.`,
+        });
+    }
+    if (meta?.status !== "MERGED" && !mergedRecord?.merged_at) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_USAGE"),
+            code: "E_USAGE",
+            message: `Task ${opts.taskId} is not in MERGED hosted-close state.`,
+        });
+    }
+    const branch = await resolveHostedCloseBranch({
+        gitRoot,
+        taskId: opts.taskId,
+        explicitBranch: opts.branch ?? null,
+        mergeCommit,
+    });
+    const owner = repo.split("/")[0]?.trim() ?? "";
+    const existingQuery = new URLSearchParams({
+        state: "open",
+        head: `${owner}:${branch}`,
+    });
+    const existing = await runGhApiJson(gitRoot, [
+        `repos/${repo}/pulls?${existingQuery.toString()}`,
+    ]);
+    const existingPr = Array.isArray(existing) ? (existing[0] ?? null) : null;
+    const existingNumber = Number(existingPr?.number ?? 0);
+    if (Number.isInteger(existingNumber) && existingNumber > 0) {
+        output.success("task hosted-close-pr", opts.taskId, normalizeGithubPrLink(existingNumber, existingPr?.html_url ?? null, "linked to"));
+        return 0;
+    }
+    const created = await runGhApiJson(gitRoot, [
+        `repos/${repo}/pulls`,
+        "-X",
+        "POST",
+        "-f",
+        `title=${buildHostedClosePrTitle(opts.taskId)}`,
+        "-f",
+        `body=${buildHostedClosePrBody({
+            taskId: opts.taskId,
+            prNumber: typeof meta?.pr_number === "number"
+                ? meta.pr_number
+                : typeof mergedRecord?.number === "number"
+                    ? mergedRecord.number
+                    : null,
+            sourceBranch,
+            mergeSha: mergeCommit,
+        })}`,
+        "-f",
+        `head=${branch}`,
+        "-f",
+        `base=${baseBranch}`,
+    ]);
+    const createdNumber = Number(created.number ?? 0);
+    if (!Number.isInteger(createdNumber) || createdNumber <= 0) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `GitHub did not return a valid PR number for hosted closure branch ${branch}.`,
+        });
+    }
+    output.success("task hosted-close-pr", opts.taskId, normalizeGithubPrLink(createdNumber, created.html_url ?? null, "created"));
+    return 0;
+}
+export function makeRunTaskHostedClosePrHandler(getCtx) {
+    return async (ctx, p) => {
+        try {
+            const commandCtx = await getCtx("task hosted-close-pr");
+            for (const taskId of p.taskIds) {
+                await openHostedClosePr({
+                    ctx: commandCtx,
+                    cwd: ctx.cwd,
+                    rootOverride: ctx.rootOverride,
+                    taskId,
+                    branch: p.branch,
+                    repo: p.repo,
+                });
+            }
+            return 0;
+        }
+        catch (err) {
+            if (err instanceof CliError)
+                throw err;
+            throw mapBackendError(err, {
+                command: "task hosted-close-pr",
+                root: ctx.rootOverride ?? null,
+            });
+        }
+    };
+}

package/dist/commands/task/hosted-close.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-close.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/hosted-close.command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAStE,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKrF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAqClE,CAAC;AAyIF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC9E,KAAK,UAAU,EAAE,QAAQ,qBAAqB,KAAG,OAAO,CAAC,MAAM,CAAC,CA2B/E"}
+{"version":3,"file":"hosted-close.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/hosted-close.command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAStE,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAMrF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAqClE,CAAC;AAwMF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC9E,KAAK,UAAU,EAAE,QAAQ,qBAAqB,KAAG,OAAO,CAAC,MAAM,CAAC,CA2B/E"}