agentplane 0.3.13 → 0.3.15

package/dist/commands/branch/cleanup-merged.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup-merged.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/cleanup-merged.ts"],"names":[],"mappings":"AAqBA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAgInC,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CA8JlB"}
+{"version":3,"file":"cleanup-merged.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/cleanup-merged.ts"],"names":[],"mappings":"AAsBA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAgInC,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyJlB"}

package/dist/commands/branch/cleanup-merged.js

@@ -8,6 +8,7 @@ import { ensureGitClean } from "../guard/index.js";
 import { execFileAsync, gitEnv } from "../shared/git.js";
 import { gitDiffNames } from "../shared/git-diff.js";
 import { gitBranchExists, gitCurrentBranch, gitIsAncestor } from "../shared/git-ops.js";
+import { cleanupMergedLocalBranch } from "../shared/merged-branch-cleanup.js";
 import { findWorktreeForBranch, gitListBranchesByPrefixes, parseTaskIdFromCloseBranch, parseTaskIdFromBranch, } from "../shared/git-worktree.js";
 import { isPathWithin, resolvePathFallback } from "../shared/path.js";
 import { parsePrMeta } from "../shared/pr-meta.js";
@@ -216,15 +217,10 @@ export async function cmdCleanupMerged(opts) {
                 const taskDir = path.join(resolved.gitRoot, config.paths.workflow_dir, item.taskId);
                 await archivePrArtifacts(taskDir);
             }
-            if (worktreePath) {
-                await execFileAsync("git", ["worktree", "remove", "--force", worktreePath], {
-                    cwd: resolved.gitRoot,
-                    env: gitEnv(),
-                });
-            }
-            await execFileAsync("git", ["branch", "-D", item.branch], {
-                cwd: resolved.gitRoot,
-                env: gitEnv(),
+            await cleanupMergedLocalBranch({
+                gitRoot: resolved.gitRoot,
+                branch: item.branch,
+                worktreePathHint: worktreePath,
             });
             if (opts.deleteRemoteBranches) {
                 deletedRemoteBranches += (await deleteRemoteBranchIfPresent(resolved.gitRoot, item.branch))

package/dist/commands/branch/work-start.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"work-start.command.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAGtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,eAAe,CAkDtD,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAClE,cAAc,CAAC,eAAe,CAAC,CA4BjC"}
+{"version":3,"file":"work-start.command.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAGtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,eAAe,CAmDtD,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAClE,cAAc,CAAC,eAAe,CAAC,CA4BjC"}

package/dist/commands/branch/work-start.command.js

@@ -42,6 +42,7 @@ export const workStartSpec = {
     notes: [
         "When workflow_mode=direct, agentplane does not create task branches; it records a single active task for the workspace.",
         "When workflow_mode=branch_pr, --worktree is required and the command must be run on the base branch.",
+        "After branch_pr work starts, run owner-scoped task commands from the created worktree so task README/PR artifacts stay attached to one checkout.",
     ],
     parse: (raw) => ({
         taskId: raw.args["task-id"],

package/dist/commands/commit.spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commit.spec.d.ts","sourceRoot":"","sources":["../../src/commands/commit.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAwLhD,CAAC"}
+{"version":3,"file":"commit.spec.d.ts","sourceRoot":"","sources":["../../src/commands/commit.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CA0LhD,CAAC"}

package/dist/commands/commit.spec.js

@@ -104,6 +104,8 @@ export const commitSpec = {
         },
     ],
     notes: [
+        "Repository-managed task commits use the canonical subject format `<emoji> <suffix> <scope>: <summary>`; non-task commits use `<emoji> <scope>: <summary>`.",
+        "Repository-managed commit paths resolve author/committer identity from global git `user.name` and `user.email` before falling back to ambient git env.",
         "Protected path-scoped overrides can stand alone without a duplicate explicit prefix: `--allow-tasks`, `--allow-policy`, `--allow-config`, `--allow-hooks`, and `--allow-ci` each admit their own path family.",
         "Top-level `agentplane commit` can auto-stage those protected path scopes when the git index starts empty.",
         "`--allow-base` is different: it only overrides base-branch protection and never selects file paths by itself.",

package/dist/commands/doctor/branch-pr.d.ts

@@ -1,4 +1,4 @@
-import type { CommandContext } from "../shared/task-backend.js";
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function checkBranchPrShippedTaskDrift(ctx?: CommandContext): Promise<string[]>;
 export declare function checkBranchPrDoneTaskOpenPrDrift(ctx?: CommandContext): Promise<string[]>;
 //# sourceMappingURL=branch-pr.d.ts.map

package/dist/commands/doctor/branch-pr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"branch-pr.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/branch-pr.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAMhE,wBAAsB,6BAA6B,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuC3F;AAED,wBAAsB,gCAAgC,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkC9F"}
+{"version":3,"file":"branch-pr.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/branch-pr.ts"],"names":[],"mappings":"AAKA,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAM3F,wBAAsB,6BAA6B,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyC3F;AAED,wBAAsB,gCAAgC,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoC9F"}

package/dist/commands/doctor/branch-pr.js

@@ -1,10 +1,12 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { renderDiagnosticFinding } from "../../shared/diagnostics.js";
+import { backendUsesLocalTaskStore } from "../shared/task-backend.js";
 import { findDoneBranchPrTasksWithOpenPrArtifacts, findLocallyShippedBranchPrTasks, } from "../task/hosted-merge-sync.js";
 export async function checkBranchPrShippedTaskDrift(ctx) {
-    if (ctx?.backendId !== "local" || ctx.config.workflow_mode !== "branch_pr")
+    if (!ctx || !backendUsesLocalTaskStore(ctx) || ctx.config.workflow_mode !== "branch_pr") {
         return [];
+    }
     let tasks = [];
     try {
         tasks = await ctx.taskBackend.listTasks();
@@ -38,8 +40,9 @@ export async function checkBranchPrShippedTaskDrift(ctx) {
     ];
 }
 export async function checkBranchPrDoneTaskOpenPrDrift(ctx) {
-    if (ctx?.backendId !== "local" || ctx.config.workflow_mode !== "branch_pr")
+    if (!ctx || !backendUsesLocalTaskStore(ctx) || ctx.config.workflow_mode !== "branch_pr") {
         return [];
+    }
     const tasks = await readDoneTaskSnapshot(ctx);
     if (tasks.length === 0)
         return [];

package/dist/commands/guard/impl/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commands.ts"],"names":[],"mappings":"AAaA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQvF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA8SxE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,CAAC,CAsPlB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commands.ts"],"names":[],"mappings":"AAaA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQvF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA+SxE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,CAAC,CAwPlB"}

package/dist/commands/guard/impl/commands.js

@@ -15,7 +15,7 @@ import { execFileAsync, gitEnv } from "../../shared/git.js";
 import { ensureReconciledBeforeMutation } from "../../shared/reconcile-check.js";
 import { stageAllowlist, suggestAllowPrefixes } from "./allow.js";
 import { buildCloseCommitMessage, taskReadmePathForTask } from "./close-message.js";
-import { buildGitCommitEnv } from "./env.js";
+import { buildGitCommitEnv, resolveCanonicalGitIdentity } from "./env.js";
 import { guardCommitCheck } from "./policy.js";
 const COMMIT_FAILURE_SIGNAL_PATTERNS = [
     /Code style issues found/i,
@@ -167,6 +167,7 @@ async function commitRefreshedTaskArtifacts(opts) {
         allowConfig: false,
         allowHooks: false,
         allowCI: false,
+        gitIdentity: await resolveCanonicalGitIdentity(),
     });
     await opts.ctx.git.commit({ message, env });
     return true;
@@ -442,6 +443,7 @@ export async function cmdCommit(opts) {
                 allowHooks: false,
                 allowCI: false,
                 allowStaleDist: true,
+                gitIdentity: await resolveCanonicalGitIdentity(),
             });
             await ctx.git.commit({ message: msg.subject, body: msg.body, env });
             if (!opts.quiet) {
@@ -512,6 +514,7 @@ export async function cmdCommit(opts) {
             allowConfig: opts.allowConfig,
             allowHooks: opts.allowHooks,
             allowCI: opts.allowCI,
+            gitIdentity: await resolveCanonicalGitIdentity(),
         });
         await ctx.git.commit({ message: opts.message, env });
         await refreshBranchPrArtifactsAfterTaskCommit({

package/dist/commands/guard/impl/comment-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comment-commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/comment-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAQ/E,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAiEvF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA2F/D"}
+{"version":3,"file":"comment-commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/comment-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAQ/E,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAiEvF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA4F/D"}

package/dist/commands/guard/impl/comment-commit.js

@@ -3,7 +3,7 @@ import { invalidValueMessage, successMessage } from "../../../cli/output.js";
 import { CliError } from "../../../shared/errors.js";
 import { formatCommentBodyForCommit, normalizeCommentBodyForCommit, } from "../../../shared/comment-format.js";
 import { loadCommandContext } from "../../shared/task-backend.js";
-import { buildGitCommitEnv } from "./env.js";
+import { buildGitCommitEnv, resolveCanonicalGitIdentity } from "./env.js";
 import { stageAllowlist } from "./allow.js";
 import { guardCommitCheck } from "./policy.js";
 function deriveCommitMessageFromComment(opts) {
@@ -116,6 +116,7 @@ export async function commitFromComment(opts) {
         allowConfig: false,
         allowHooks: false,
         allowCI: false,
+        gitIdentity: await resolveCanonicalGitIdentity(),
     });
     await ctx.git.commit({ message, body, env });
     const { hash, subject } = await ctx.git.headHashSubject();

package/dist/commands/guard/impl/env.d.ts

@@ -1,3 +1,8 @@
+export type CanonicalGitIdentity = {
+    name: string;
+    email: string;
+};
+export declare function resolveCanonicalGitIdentity(): Promise<CanonicalGitIdentity | null>;
 export declare function buildGitCommitEnv(opts: {
     taskId: string;
     agentId?: string;
@@ -9,5 +14,6 @@ export declare function buildGitCommitEnv(opts: {
     allowHooks: boolean;
     allowCI: boolean;
     allowStaleDist?: boolean;
+    gitIdentity?: CanonicalGitIdentity | null;
 }): NodeJS.ProcessEnv;
 //# sourceMappingURL=env.d.ts.map

package/dist/commands/guard/impl/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/env.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,MAAM,CAAC,UAAU,CAcpB"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/env.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAiBF,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAkBxF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC3C,GAAG,MAAM,CAAC,UAAU,CAsBpB"}

package/dist/commands/guard/impl/env.js

@@ -1,6 +1,47 @@
+import { execFileAsync } from "../../shared/git.js";
+let canonicalGitIdentityPromise = null;
+async function readGitConfigValue(key) {
+    try {
+        const { stdout } = await execFileAsync("git", ["config", "--global", "--get", key], {
+            cwd: process.cwd(),
+            env: process.env,
+        });
+        const trimmed = stdout.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function resolveCanonicalGitIdentity() {
+    canonicalGitIdentityPromise ??= (async () => {
+        const globalName = await readGitConfigValue("user.name");
+        const globalEmail = await readGitConfigValue("user.email");
+        const name = globalName ??
+            process.env.GIT_AUTHOR_NAME?.trim() ??
+            process.env.GIT_COMMITTER_NAME?.trim() ??
+            null;
+        const email = globalEmail ??
+            process.env.GIT_AUTHOR_EMAIL?.trim() ??
+            process.env.GIT_COMMITTER_EMAIL?.trim() ??
+            null;
+        if (!name || !email)
+            return null;
+        return { name, email };
+    })();
+    return await canonicalGitIdentityPromise;
+}
 export function buildGitCommitEnv(opts) {
     return {
         ...process.env,
+        ...(opts.gitIdentity
+            ? {
+                GIT_AUTHOR_NAME: opts.gitIdentity.name,
+                GIT_AUTHOR_EMAIL: opts.gitIdentity.email,
+                GIT_COMMITTER_NAME: opts.gitIdentity.name,
+                GIT_COMMITTER_EMAIL: opts.gitIdentity.email,
+            }
+            : null),
         AGENTPLANE_TASK_ID: opts.taskId,
         ...(opts.agentId ? { AGENTPLANE_AGENT_ID: opts.agentId } : null),
         ...(opts.statusTo ? { AGENTPLANE_STATUS_TO: opts.statusTo } : null),

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;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,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,6 +1,6 @@
 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";
@@ -62,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) };
+    }
+}