agentplane 0.3.24 → 0.3.27

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

@@ -1,288 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { resolveBaseBranch, gitEnv, parseTaskIdFromCloseBranch } from "@agentplaneorg/core/git";
-import { normalizeTaskStatus } from "@agentplaneorg/core/tasks";
-import { exitCodeForError } from "../../cli/exit-codes.js";
-import { fileExists } from "../../cli/fs-utils.js";
-import { CliError } from "../../shared/errors.js";
-import { resolveDefaultGithubRepo, runGhApiJson } from "../pr/internal/gh-api.js";
-import { resolvePrPaths } from "../pr/internal/pr-paths.js";
-import { execFileAsync } from "@agentplaneorg/core/process";
-import { parsePrMeta } from "../shared/pr-meta.js";
-import { loadTaskFromContext, resolveTaskBranchFromContext, } from "../shared/task-backend.js";
-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 opts.ctx.taskBackend.getTask(opts.taskId)) ??
-        (await loadTaskFromContext({
-            ctx: opts.ctx,
-            taskId: opts.taskId,
-            preferBranchSnapshot: false,
-        }));
-    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);
-}
-export function shortHostedCloseSha(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}/${shortHostedCloseSha(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}.`,
-    });
-}
-export async function precheckHostedClosePr(opts) {
-    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() ?? "";
-    const localMergeCommit = meta?.merge_commit?.trim() ?? task.commit?.hash?.trim() ?? "";
-    const canonicalCloseAlreadyPresent = meta?.status === "MERGED" &&
-        sourceBranch.length > 0 &&
-        localMergeCommit.length > 0 &&
-        normalizeTaskStatus(task.status) === "DONE" &&
-        (task.commit?.hash?.trim() ?? "") === localMergeCommit;
-    if (canonicalCloseAlreadyPresent) {
-        return {
-            kind: "skip",
-            outcome: {
-                kind: "canonical-already-present",
-                taskId: opts.taskId,
-                baseBranch,
-                mergeCommit: localMergeCommit,
-            },
-        };
-    }
-    const prNumber = typeof meta?.pr_number === "number" ? meta.pr_number : null;
-    let mergedRecord = sourceBranch.length > 0 && (meta?.status !== "MERGED" || !localMergeCommit)
-        ? await resolveHostedCloseMergeRecord({
-            gitRoot,
-            repo,
-            sourceBranch,
-            baseBranch: baseBranch || null,
-            prNumber,
-        })
-        : null;
-    if (!mergedRecord && localMergeCommit) {
-        mergedRecord = await resolveHostedCloseMergeRecordByCommit({
-            gitRoot,
-            repo,
-            mergeCommit: localMergeCommit,
-            sourceBranch: sourceBranch || null,
-            baseBranch: baseBranch || null,
-            prNumber,
-        });
-    }
-    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 closeBranch = await resolveHostedCloseBranch({
-        gitRoot,
-        taskId: opts.taskId,
-        explicitBranch: opts.branch ?? null,
-        mergeCommit,
-    });
-    return {
-        kind: "ready",
-        plan: {
-            taskId: opts.taskId,
-            gitRoot,
-            workflowDir: opts.ctx.config.paths.workflow_dir,
-            repo,
-            sourceBranch,
-            baseBranch,
-            mergeCommit,
-            closeBranch,
-            sourcePrNumber: typeof meta?.pr_number === "number"
-                ? meta.pr_number
-                : typeof mergedRecord?.number === "number"
-                    ? mergedRecord.number
-                    : null,
-        },
-    };
-}

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

@@ -1,4 +0,0 @@
-import type { HostedClosePrExecutionResult, HostedClosePrOutcome } from "./hosted-close-pr.types.js";
-export declare function reportHostedClosePrOutcome(outcome: HostedClosePrOutcome): void;
-export declare function reportHostedClosePrExecutionResult(result: HostedClosePrExecutionResult): void;
-//# sourceMappingURL=hosted-close-pr.report.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hosted-close-pr.report.d.ts","sourceRoot":"","sources":["../../../src/commands/task/hosted-close-pr.report.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,4BAA4B,EAE5B,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAoBpC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAE9E;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAyC7F"}

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

@@ -1,42 +0,0 @@
-import { createCliEmitter } from "../../cli/output.js";
-import { shortHostedCloseSha } from "./hosted-close-pr.precheck.js";
-function normalizeGithubPrLink(prNumber, prUrl, verb) {
-    return prUrl?.trim()
-        ? `${verb} GitHub PR #${prNumber}: ${prUrl.trim()}`
-        : `${verb} GitHub PR #${prNumber}`;
-}
-function reportNotice(output, notice) {
-    if (notice.level === "warn") {
-        output.warn(notice.message);
-        return;
-    }
-    output.info(notice.message);
-}
-export function reportHostedClosePrOutcome(outcome) {
-    reportHostedClosePrExecutionResult({ notices: [], outcome });
-}
-export function reportHostedClosePrExecutionResult(result) {
-    const output = createCliEmitter();
-    for (const notice of result.notices) {
-        reportNotice(output, notice);
-    }
-    switch (result.outcome.kind) {
-        case "canonical-already-present": {
-            output.info(`hosted-close-pr skipped: ${result.outcome.taskId} is already closed on ${result.outcome.baseBranch || "the base branch"} for merge ${shortHostedCloseSha(result.outcome.mergeCommit)}`);
-            return;
-        }
-        case "base-already-recorded": {
-            output.info(`hosted close already recorded on ${result.outcome.baseBranch}; no follow-up PR needed`);
-            output.success("task hosted-close-pr", result.outcome.taskId, `hosted close already recorded on ${result.outcome.baseBranch}; skipped follow-up PR`);
-            return;
-        }
-        case "existing-pr": {
-            output.success("task hosted-close-pr", result.outcome.taskId, normalizeGithubPrLink(result.outcome.prNumber, result.outcome.prUrl, "linked to"));
-            return;
-        }
-        case "created-pr": {
-            output.success("task hosted-close-pr", result.outcome.taskId, normalizeGithubPrLink(result.outcome.prNumber, result.outcome.prUrl, "created"));
-            return;
-        }
-    }
-}

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

@@ -1,75 +0,0 @@
-import type { CommandContext } from "../shared/task-backend.js";
-export type TaskHostedClosePrParsed = {
-    taskIds: string[];
-    branch: string | null;
-    repo: string | null;
-};
-export type GithubPullRequestRecord = {
-    number?: number;
-    html_url?: string | null;
-    state?: string | null;
-    merged_at?: string | null;
-    merge_commit_sha?: string | null;
-    head?: {
-        ref?: string | null;
-    } | null;
-    base?: {
-        ref?: string | null;
-    } | null;
-};
-export type HostedClosePrPrecheckOptions = {
-    ctx: CommandContext;
-    cwd: string;
-    rootOverride?: string;
-    taskId: string;
-    branch?: string | null;
-    repo?: string | null;
-};
-export type HostedClosePrPlan = {
-    taskId: string;
-    gitRoot: string;
-    workflowDir: string;
-    repo: string;
-    sourceBranch: string;
-    baseBranch: string;
-    mergeCommit: string;
-    closeBranch: string;
-    sourcePrNumber: number | null;
-};
-export type HostedClosePrOutcome = {
-    kind: "canonical-already-present";
-    taskId: string;
-    baseBranch: string;
-    mergeCommit: string;
-} | {
-    kind: "base-already-recorded";
-    taskId: string;
-    baseBranch: string;
-} | {
-    kind: "existing-pr";
-    taskId: string;
-    prNumber: number;
-    prUrl: string | null;
-} | {
-    kind: "created-pr";
-    taskId: string;
-    closeBranch: string;
-    prNumber: number;
-    prUrl: string | null;
-};
-export type HostedClosePrPrecheckResult = {
-    kind: "skip";
-    outcome: HostedClosePrOutcome;
-} | {
-    kind: "ready";
-    plan: HostedClosePrPlan;
-};
-export type HostedClosePrNotice = {
-    level: "info" | "warn";
-    message: string;
-};
-export type HostedClosePrExecutionResult = {
-    notices: HostedClosePrNotice[];
-    outcome: HostedClosePrOutcome;
-};
-//# sourceMappingURL=hosted-close-pr.types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hosted-close-pr.types.d.ts","sourceRoot":"","sources":["../../../src/commands/task/hosted-close-pr.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,GAAG,IAAI,CAAC;IACT,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,GAAG,IAAI,CAAC;CACV,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAE,2BAA2B,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEN,MAAM,MAAM,2BAA2B,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,OAAO,EAAE,oBAAoB,CAAC;CAC/B,CAAC"}

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

@@ -1 +0,0 @@
-export {};

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

@@ -1,6 +0,0 @@
-import type { CommandCtx } from "../../cli/spec/spec.js";
-import { type CommandContext } from "../shared/task-backend.js";
-import type { TaskHostedCloseParsed } from "./hosted-close.spec.js";
-export { taskHostedCloseSpec } from "./hosted-close.spec.js";
-export declare function makeRunTaskHostedCloseHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, parsed: TaskHostedCloseParsed) => Promise<number>;
-//# sourceMappingURL=hosted-close.command.d.ts.map

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

@@ -1 +0,0 @@
-{"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,MAAM,wBAAwB,CAAC;AAQzD,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAMrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAyZ7D,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"}