agentplane 0.3.12 → 0.3.14

package/dist/commands/pr/integrate/internal/prepare.js

@@ -4,6 +4,7 @@ import { resolveBaseBranch } from "@agentplaneorg/core";
 import { fileExists } from "../../../../cli/fs-utils.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { unknownEntityMessage, workflowModeMessage } from "../../../../cli/output.js";
+import { withDiagnosticContext } from "../../../../shared/diagnostics.js";
 import { CliError } from "../../../../shared/errors.js";
 import { ensureGitClean } from "../../../guard/index.js";
 import { gitDiffNames } from "../../../shared/git-diff.js";
@@ -52,13 +53,6 @@ export async function prepareIntegrate(opts) {
         });
     }
     const currentBranch = await gitCurrentBranch(resolved.gitRoot);
-    if (currentBranch !== baseBranch) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_GIT"),
-            code: "E_GIT",
-            message: `integrate must run on base branch ${baseBranch} (current: ${currentBranch})`,
-        });
-    }
     const { prDir, metaPath, diffstatPath, verifyLogPath } = await resolvePrPaths({
         ctx,
         cwd: opts.cwd,
@@ -92,6 +86,43 @@ export async function prepareIntegrate(opts) {
             message: unknownEntityMessage("branch", branch),
         });
     }
+    if (currentBranch !== baseBranch) {
+        if (currentBranch === branch) {
+            const baseWorktreePath = await findWorktreeForBranch(resolved.gitRoot, baseBranch);
+            const rerunCommand = baseWorktreePath && baseWorktreePath.trim().length > 0
+                ? `agentplane integrate ${opts.taskId} --branch ${branch} --root ${baseWorktreePath}`
+                : `git checkout ${baseBranch} && agentplane integrate ${opts.taskId} --branch ${branch}`;
+            throw new CliError({
+                exitCode: exitCodeForError("E_GIT"),
+                code: "E_GIT",
+                message: `integrate must run from the ${baseBranch} base checkout, not from task branch ${branch}. ` +
+                    `Rerun it against the base checkout after leaving this task worktree.`,
+                context: withDiagnosticContext({
+                    command: "integrate",
+                    task_id: opts.taskId,
+                    branch,
+                    base_branch: baseBranch,
+                    current_branch: currentBranch,
+                    ...(baseWorktreePath ? { base_worktree_path: baseWorktreePath } : {}),
+                    reason_code: "integrate_base_checkout_required",
+                }, {
+                    state: `integrate was invoked from task branch ${branch} instead of base branch ${baseBranch}`,
+                    likelyCause: "the operator is inside the task worktree, but branch_pr integrate is only valid from the registered base checkout",
+                    hint: "Use the base checkout/worktree for the resolved base branch, not the task branch worktree, when running integrate.",
+                    nextAction: {
+                        command: rerunCommand,
+                        reason: "rerun integrate against the base checkout route",
+                        reasonCode: "integrate_base_checkout_required",
+                    },
+                }),
+            });
+        }
+        throw new CliError({
+            exitCode: exitCodeForError("E_GIT"),
+            code: "E_GIT",
+            message: `integrate must run on base branch ${baseBranch} (current: ${currentBranch})`,
+        });
+    }
     await ensureCommittedPrArtifactsOnBranch({
         resolved,
         prDir,

package/dist/commands/pr/internal/auto-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/auto-commit.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AA6BnE,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CA8CnB"}
+{"version":3,"file":"auto-commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/auto-commit.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAiCnE,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CA+CnB"}

package/dist/commands/pr/internal/auto-commit.js

@@ -1,14 +1,19 @@
 import path from "node:path";
 import { extractTaskSuffix } from "@agentplaneorg/core";
-import { buildGitCommitEnv } from "../../guard/impl/env.js";
+import { buildGitCommitEnv, resolveCanonicalGitIdentity } from "../../guard/impl/env.js";
 import { toGitPath } from "../../shared/git-diff.js";
 import { execFileAsync, gitEnv } from "../../shared/git.js";
 import { gitCurrentBranch } from "../../shared/git-ops.js";
 function taskPrDirPrefix(workflowDir, taskId) {
     return `${toGitPath(path.join(workflowDir, taskId, "pr"))}/`;
 }
-function isTaskPrArtifactPath(opts) {
-    return toGitPath(opts.relPath).startsWith(taskPrDirPrefix(opts.workflowDir, opts.taskId));
+function taskReadmePath(workflowDir, taskId) {
+    return toGitPath(path.join(workflowDir, taskId, "README.md"));
+}
+function isTaskPacketPath(opts) {
+    const normalized = toGitPath(opts.relPath);
+    return (normalized === taskReadmePath(opts.workflowDir, opts.taskId) ||
+        normalized.startsWith(taskPrDirPrefix(opts.workflowDir, opts.taskId)));
 }
 async function readCachedPaths(gitRoot) {
     const { stdout } = await execFileAsync("git", ["diff", "--cached", "--name-only", "--relative"], {
@@ -31,22 +36,22 @@ export async function maybeAutoCommitTaskPrArtifacts(opts) {
     if (!currentBranch || currentBranch !== opts.branch.trim())
         return false;
     const changedPaths = await opts.ctx.git.statusChangedPaths();
-    const prArtifactPaths = changedPaths.filter((relPath) => isTaskPrArtifactPath({
+    const taskPacketPaths = changedPaths.filter((relPath) => isTaskPacketPath({
         workflowDir: opts.ctx.config.paths.workflow_dir,
         taskId: opts.taskId,
         relPath,
     }));
-    if (prArtifactPaths.length === 0)
+    if (taskPacketPaths.length === 0)
         return false;
     const cachedPaths = await readCachedPaths(opts.ctx.resolvedProject.gitRoot);
-    if (cachedPaths.some((relPath) => !isTaskPrArtifactPath({
+    if (cachedPaths.some((relPath) => !isTaskPacketPath({
         workflowDir: opts.ctx.config.paths.workflow_dir,
         taskId: opts.taskId,
         relPath,
     }))) {
         return false;
     }
-    await opts.ctx.git.stage(prArtifactPaths);
+    await opts.ctx.git.stage(taskPacketPaths);
     await opts.ctx.git.commit({
         message: taskPrArtifactRefreshMessage(opts.taskId),
         env: buildGitCommitEnv({
@@ -57,6 +62,7 @@ export async function maybeAutoCommitTaskPrArtifacts(opts) {
             allowConfig: false,
             allowHooks: false,
             allowCI: false,
+            gitIdentity: await resolveCanonicalGitIdentity(),
         }),
     });
     opts.ctx.git.invalidateStatus();

package/dist/commands/pr/internal/sync-branch.d.ts

@@ -0,0 +1,36 @@
+export type ResolvedPrSyncBranch = {
+    branch: string | null;
+    source: "explicit" | "meta" | "current" | "none";
+};
+export declare function isUnknownRevisionError(err: unknown): boolean;
+export declare function taskPrArtifactRefreshMessage(taskId: string): string;
+export declare function resolveBranchHeadSha(opts: {
+    gitRoot: string;
+    branch: string;
+}): Promise<string | null>;
+export declare function resolveRenderableBranchHead(opts: {
+    gitRoot: string;
+    taskId: string;
+    branch: string;
+}): Promise<{
+    headSha: string | null;
+    artifactRefresh: boolean;
+}>;
+export declare function resolvePrDiffBaseRef(opts: {
+    gitRoot: string;
+    baseBranch: string;
+}): Promise<string>;
+export declare function computePrDiffstat(opts: {
+    gitRoot: string;
+    baseBranch: string;
+    branch: string;
+    prDir: string;
+}): Promise<string>;
+export declare function resolvePrSyncBranch(opts: {
+    gitRoot: string;
+    metaPath: string;
+    taskId: string;
+    branch?: string;
+}): Promise<ResolvedPrSyncBranch>;
+export declare function currentBranchMatchesTask(taskPrefix: string, branch: string, taskId: string): boolean;
+//# sourceMappingURL=sync-branch.d.ts.map

package/dist/commands/pr/internal/sync-branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-branch.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync-branch.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;CAClD,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAO5D;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWzB;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAwBhE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAclB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqBhC;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAET"}

package/dist/commands/pr/internal/sync-branch.js

@@ -0,0 +1,113 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { extractTaskSuffix } from "@agentplaneorg/core";
+import { fileExists } from "../../../cli/fs-utils.js";
+import { execFileAsync, gitEnv } from "../../shared/git.js";
+import { gitBranchUpstream, gitCurrentBranch } from "../../shared/git-ops.js";
+import { parseTaskIdFromBranch } from "../../shared/git-worktree.js";
+import { gitDiffStat } from "../../shared/git-diff.js";
+import { parsePrMeta } from "../../shared/pr-meta.js";
+export function isUnknownRevisionError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return (/unknown revision or path not in the working tree/i.test(message) ||
+        /bad revision/i.test(message) ||
+        /ambiguous argument/i.test(message));
+}
+export function taskPrArtifactRefreshMessage(taskId) {
+    return `📝 ${extractTaskSuffix(taskId)} task: refresh PR artifacts`;
+}
+export async function resolveBranchHeadSha(opts) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", opts.branch], {
+            cwd: opts.gitRoot,
+            env: gitEnv(),
+        });
+        return stdout.trim() || null;
+    }
+    catch (err) {
+        if (!isUnknownRevisionError(err))
+            throw err;
+        return null;
+    }
+}
+export async function resolveRenderableBranchHead(opts) {
+    const branchHeadSha = await resolveBranchHeadSha({
+        gitRoot: opts.gitRoot,
+        branch: opts.branch,
+    });
+    if (!branchHeadSha)
+        return { headSha: null, artifactRefresh: false };
+    try {
+        const { stdout: subjectStdout } = await execFileAsync("git", ["log", "-1", "--pretty=%s", branchHeadSha], {
+            cwd: opts.gitRoot,
+            env: gitEnv(),
+        });
+        const subject = subjectStdout.trim();
+        return {
+            headSha: branchHeadSha,
+            artifactRefresh: subject === taskPrArtifactRefreshMessage(opts.taskId),
+        };
+    }
+    catch {
+        return { headSha: branchHeadSha, artifactRefresh: false };
+    }
+}
+export async function resolvePrDiffBaseRef(opts) {
+    const upstreamRef = await gitBranchUpstream(opts.gitRoot, opts.baseBranch);
+    const candidate = upstreamRef?.trim() ?? "";
+    if (!candidate)
+        return opts.baseBranch;
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--verify", candidate], {
+            cwd: opts.gitRoot,
+            env: gitEnv(),
+        });
+        return stdout.trim() ? candidate : opts.baseBranch;
+    }
+    catch (err) {
+        if (!isUnknownRevisionError(err))
+            throw err;
+        return opts.baseBranch;
+    }
+}
+export async function computePrDiffstat(opts) {
+    const diffBaseRef = await resolvePrDiffBaseRef({
+        gitRoot: opts.gitRoot,
+        baseBranch: opts.baseBranch,
+    });
+    const taskDir = path.dirname(opts.prDir);
+    try {
+        return await gitDiffStat(opts.gitRoot, diffBaseRef, opts.branch, {
+            excludePaths: [
+                path.relative(opts.gitRoot, opts.prDir),
+                path.relative(opts.gitRoot, path.join(taskDir, "README.md")),
+            ],
+        });
+    }
+    catch (err) {
+        if (!isUnknownRevisionError(err))
+            throw err;
+        return "";
+    }
+}
+export async function resolvePrSyncBranch(opts) {
+    const explicitBranch = opts.branch?.trim() ?? "";
+    if (explicitBranch) {
+        return { branch: explicitBranch, source: "explicit" };
+    }
+    if (await fileExists(opts.metaPath)) {
+        const metaBranch = parsePrMeta(await readFile(opts.metaPath, "utf8"), opts.taskId).branch?.trim() ?? "";
+        if (metaBranch) {
+            return { branch: metaBranch, source: "meta" };
+        }
+    }
+    const currentBranchValue = await gitCurrentBranch(opts.gitRoot);
+    const currentBranch = currentBranchValue.trim();
+    if (currentBranch) {
+        return { branch: currentBranch, source: "current" };
+    }
+    return { branch: null, source: "none" };
+}
+export function currentBranchMatchesTask(taskPrefix, branch, taskId) {
+    return parseTaskIdFromBranch(taskPrefix, branch) === taskId;
+}

package/dist/commands/pr/internal/sync-github.d.ts

@@ -0,0 +1,28 @@
+export type ObservedGithubPr = {
+    prNumber: number;
+    prUrl: string | null;
+    status: "OPEN" | "CLOSED" | "MERGED";
+    mergedAt: string | null;
+    mergeCommit: string | null;
+    base: string | null;
+    headSha: string | null;
+};
+export declare function tryLookupExistingGithubPrByBranch(opts: {
+    gitRoot: string;
+    branch: string;
+    baseBranch?: string | null;
+}): Promise<ObservedGithubPr | null>;
+export declare function formatGithubPrLink(prNumber: number, prUrl: string | null, verb: "linked to" | "created"): string;
+export declare function shouldPersistObservedGithubPrMeta(observed: ObservedGithubPr | null): boolean;
+export declare function formatUnpublishedRemoteHeadReason(branch: string): string;
+export declare function tryCreateGithubPr(opts: {
+    gitRoot: string;
+    branch: string;
+    baseBranch: string | null;
+    title: string;
+    body: string;
+}): Promise<{
+    observed: ObservedGithubPr | null;
+    stagedReason: string | null;
+}>;
+//# sourceMappingURL=sync-github.d.ts.map

package/dist/commands/pr/internal/sync-github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-github.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync-github.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAqDF,wBAAsB,iCAAiC,CAAC,IAAI,EAAE;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAmCnC;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,WAAW,GAAG,SAAS,GAC5B,MAAM,CAIR;AAED,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAG5F;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxE;AAqCD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC;IACV,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC,CA8CD"}

package/dist/commands/pr/internal/sync-github.js

@@ -0,0 +1,178 @@
+import { execFileAsync } from "../../shared/git.js";
+import { isTransientGhTransportError, normalizeGhTransportError, withGhTransportRetry, } from "../../shared/gh-transport.js";
+import { ghEnv } from "./gh-api.js";
+function parseGithubRepoFromRemoteUrl(remoteUrl) {
+    const trimmed = remoteUrl.trim();
+    if (!trimmed)
+        return null;
+    const httpsMatch = /^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/.exec(trimmed);
+    if (httpsMatch)
+        return `${httpsMatch[1]}/${httpsMatch[2]}`;
+    const sshMatch = /^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/.exec(trimmed);
+    if (sshMatch)
+        return `${sshMatch[1]}/${sshMatch[2]}`;
+    return null;
+}
+async function resolveGithubRepoFromOrigin(gitRoot) {
+    try {
+        const { stdout } = await execFileAsync("git", ["remote", "get-url", "origin"], {
+            cwd: gitRoot,
+            env: process.env,
+        });
+        return parseGithubRepoFromRemoteUrl(stdout);
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeObservedGithubPr(record) {
+    const number = Number(record.number);
+    if (!Number.isInteger(number) || number <= 0)
+        return null;
+    const state = record.state?.trim().toLowerCase() ?? "";
+    const mergedAt = record.merged_at?.trim() ?? null;
+    const status = mergedAt && mergedAt.length > 0
+        ? "MERGED"
+        : state === "open"
+            ? "OPEN"
+            : state === "closed"
+                ? "CLOSED"
+                : null;
+    if (!status)
+        return null;
+    const prUrl = record.html_url?.trim() ?? null;
+    const mergeCommit = record.merge_commit_sha?.trim() ?? null;
+    const base = record.base?.ref?.trim() ?? null;
+    const headSha = record.head?.sha?.trim() ?? null;
+    return {
+        prNumber: number,
+        prUrl,
+        status,
+        mergedAt,
+        mergeCommit,
+        base,
+        headSha,
+    };
+}
+export async function tryLookupExistingGithubPrByBranch(opts) {
+    const repo = await resolveGithubRepoFromOrigin(opts.gitRoot);
+    if (!repo)
+        return null;
+    const owner = repo.split("/")[0]?.trim() ?? "";
+    if (!owner)
+        return null;
+    const query = new URLSearchParams({ state: "all", head: `${owner}:${opts.branch}` });
+    const baseBranch = opts.baseBranch?.trim() ?? "";
+    if (baseBranch)
+        query.set("base", baseBranch);
+    const endpoint = `repos/${repo}/pulls?${query.toString()}`;
+    try {
+        const { stdout } = await withGhTransportRetry(() => execFileAsync("gh", ["api", endpoint], {
+            cwd: opts.gitRoot,
+            env: ghEnv(),
+            maxBuffer: 10 * 1024 * 1024,
+        }), { label: `running gh api ${endpoint}` });
+        const parsed = JSON.parse(stdout);
+        if (!Array.isArray(parsed) || parsed.length === 0)
+            return null;
+        for (const record of parsed) {
+            const observed = normalizeObservedGithubPr(record);
+            if (observed)
+                return observed;
+        }
+        return null;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        const message = normalizeGhTransportError(err);
+        if (message.trim().length > 0)
+            return null;
+        return null;
+    }
+}
+export function formatGithubPrLink(prNumber, prUrl, verb) {
+    return prUrl?.trim()
+        ? `${verb} GitHub PR #${prNumber}: ${prUrl.trim()}`
+        : `${verb} GitHub PR #${prNumber}`;
+}
+export function shouldPersistObservedGithubPrMeta(observed) {
+    if (!observed)
+        return false;
+    return observed.status === "MERGED";
+}
+export function formatUnpublishedRemoteHeadReason(branch) {
+    return (`task branch ${branch} is not yet published on origin; push it with ` +
+        `\`git push -u origin ${branch}\` and rerun \`agentplane pr open\``);
+}
+function isMissingRemoteHeadCreateError(err) {
+    const text = normalizeGhTransportError(err);
+    if (!/\b422\b/i.test(text))
+        return false;
+    return (/head sha/i.test(text) ||
+        /head ref/i.test(text) ||
+        /head.*must be a branch/i.test(text) ||
+        /head.*not found/i.test(text) ||
+        /field["']?\s*:\s*["']head["']/i.test(text) ||
+        /field\s+head\b/i.test(text) ||
+        /no commits between/i.test(text));
+}
+function summarizeGithubPrCreateFailure(err) {
+    const text = normalizeGhTransportError(err);
+    if (err?.code === "ENOENT") {
+        return "gh CLI is unavailable";
+    }
+    if (/authentication required/i.test(text) ||
+        /not logged into github/i.test(text) ||
+        /bad credentials/i.test(text) ||
+        /permission denied/i.test(text) ||
+        /\b401\b/i.test(text) ||
+        /\b403\b/i.test(text)) {
+        return "GitHub auth or permissions unavailable";
+    }
+    if (isTransientGhTransportError(err)) {
+        return "GitHub transport failed; retry `agentplane pr open`";
+    }
+    return "GitHub PR creation failed";
+}
+export async function tryCreateGithubPr(opts) {
+    const repo = await resolveGithubRepoFromOrigin(opts.gitRoot);
+    if (!repo) {
+        return { observed: null, stagedReason: "GitHub origin repo unavailable" };
+    }
+    const baseBranch = opts.baseBranch?.trim() ?? "";
+    if (!baseBranch) {
+        return { observed: null, stagedReason: "base branch unresolved" };
+    }
+    try {
+        const { stdout } = await withGhTransportRetry(() => execFileAsync("gh", [
+            "api",
+            `repos/${repo}/pulls`,
+            "-X",
+            "POST",
+            "-f",
+            `title=${opts.title}`,
+            "-f",
+            `body=${opts.body}`,
+            "-f",
+            `head=${opts.branch}`,
+            "-f",
+            `base=${baseBranch}`,
+        ], {
+            cwd: opts.gitRoot,
+            env: ghEnv(),
+            maxBuffer: 10 * 1024 * 1024,
+        }), { label: `running gh api repos/${repo}/pulls` });
+        return {
+            observed: normalizeObservedGithubPr(JSON.parse(stdout)),
+            stagedReason: null,
+        };
+    }
+    catch (err) {
+        if (isMissingRemoteHeadCreateError(err)) {
+            return { observed: null, stagedReason: formatUnpublishedRemoteHeadReason(opts.branch) };
+        }
+        return { observed: null, stagedReason: summarizeGithubPrCreateFailure(err) };
+    }
+}

package/dist/commands/pr/internal/sync-model.d.ts

@@ -0,0 +1,36 @@
+import type { TaskData } from "../../../backends/task-backend.js";
+import type { PrMeta } from "../../shared/pr-meta.js";
+import type { readPrHandoffNotes } from "./note-store.js";
+export type PrRemoteMode = "auto" | "sync-only";
+export type PrOpenOutcome = {
+    action: "linked-existing" | "created" | "sync-only" | "staged";
+    message: string;
+};
+export type PrSyncResolved = {
+    gitRoot: string;
+};
+export type PrSyncCommonState = {
+    task: TaskData;
+    resolved: PrSyncResolved;
+    workflowDir: string;
+    tasksPath: string;
+    prDir: string;
+    metaPath: string;
+    diffstatPath: string;
+    notesPath: string;
+    verifyLogPath: string;
+    reviewPath: string;
+    githubTitlePath: string;
+    githubBodyPath: string;
+    existingMeta: PrMeta | null;
+    handoffNotes: Awaited<ReturnType<typeof readPrHandoffNotes>>;
+    now: string;
+    createdAt: string;
+    branch: string;
+    baseBranch: string | null;
+    headSha: string | null;
+    artifactRefresh: boolean;
+    renderedHeadSha: string | undefined;
+    renderUpdatedAt: string;
+};
+//# sourceMappingURL=sync-model.d.ts.map

package/dist/commands/pr/internal/sync-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-model.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC"}

package/dist/commands/pr/internal/sync-model.js

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

package/dist/commands/pr/internal/sync-open-step.d.ts

@@ -0,0 +1,10 @@
+import { type PrMeta } from "../../shared/pr-meta.js";
+import type { PrOpenOutcome, PrRemoteMode, PrSyncCommonState } from "./sync-model.js";
+export declare function runPrOpenSync(common: PrSyncCommonState, opts: {
+    author?: string;
+    remoteMode: PrRemoteMode;
+}): Promise<{
+    meta: PrMeta;
+    openOutcome?: PrOpenOutcome;
+}>;
+//# sourceMappingURL=sync-open-step.d.ts.map

package/dist/commands/pr/internal/sync-open-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-open-step.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync-open-step.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgD,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAcpG,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,wBAAsB,aAAa,CACjC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,YAAY,CAAA;CAAE,GAClD,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC,CA2HD"}