agentplane 0.3.11 → 0.3.13

package/dist/commands/scenario/execute.command.js

@@ -10,14 +10,14 @@ import { cmdTaskStartReady } from "../task/start-ready.js";
 import { CliError } from "../../shared/errors.js";
 const output = createCliEmitter();
 export const scenarioExecuteSpec = {
-    id: ["scenario", "execute"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "execute"],
+    group: "Recipes",
     summary: "Materialize a recipe-backed task and execute it through the shared runner flow.",
     description: "Resolves a recipe scenario, materializes a task from its explicit task_template, and executes the shared runner with recipe context bundled alongside the created task.",
     args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
     examples: [
         {
-            cmd: "agentplane scenario execute viewer:demo",
+            cmd: "agentplane recipes scenario execute viewer:demo",
             why: "Create a task from the scenario template and execute it through the configured runner.",
         },
     ],
@@ -27,7 +27,7 @@ export const scenarioExecuteSpec = {
         if (!recipeId || !scenarioId) {
             throw usageError({
                 spec: scenarioExecuteSpec,
-                command: "scenario execute",
+                command: "recipes scenario execute",
                 message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
             });
         }

package/dist/commands/scenario/impl/commands.js

@@ -187,7 +187,7 @@ export async function cmdScenarioListParsed(opts) {
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        throw mapCoreError(err, { command: "scenario list", root: opts.rootOverride ?? null });
+        throw mapCoreError(err, { command: "recipes scenario list", root: opts.rootOverride ?? null });
     }
 }
 export async function cmdScenarioInfoParsed(opts) {
@@ -225,7 +225,7 @@ export async function cmdScenarioInfoParsed(opts) {
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        throw mapCoreError(err, { command: "scenario info", root: opts.rootOverride ?? null });
+        throw mapCoreError(err, { command: "recipes scenario info", root: opts.rootOverride ?? null });
     }
 }
 export async function executeRecipeTool(opts) {
@@ -297,13 +297,13 @@ export async function cmdScenarioRunParsed(opts) {
             ...validationChecks,
         ]);
         output.line("Status: preview only; no task created and no runner executed.");
-        output.line(`Next: use \`agentplane scenario execute ${selection.recipe_id}:${selection.scenario_id}\` ` +
+        output.line(`Next: use \`agentplane recipes scenario execute ${selection.recipe_id}:${selection.scenario_id}\` ` +
             "to materialize and run this scenario.");
         return 0;
     }
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        throw mapCoreError(err, { command: "scenario run", root: opts.rootOverride ?? null });
+        throw mapCoreError(err, { command: "recipes scenario run", root: opts.rootOverride ?? null });
     }
 }

package/dist/commands/scenario/info.command.js

@@ -1,13 +1,13 @@
 import { usageError } from "../../cli/spec/errors.js";
 import { cmdScenarioInfoParsed } from "../scenario.js";
 export const scenarioInfoSpec = {
-    id: ["scenario", "info"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "info"],
+    group: "Recipes",
     summary: "Show manifest-backed scenario details and normalized run profile.",
     args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
     examples: [
         {
-            cmd: "agentplane scenario info viewer:demo",
+            cmd: "agentplane recipes scenario info viewer:demo",
             why: "Inspect resolver-backed scenario metadata before execution.",
         },
     ],
@@ -17,7 +17,7 @@ export const scenarioInfoSpec = {
         if (!recipeId || !scenarioId) {
             throw usageError({
                 spec: scenarioInfoSpec,
-                command: "scenario info",
+                command: "recipes scenario info",
                 message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
             });
         }

package/dist/commands/scenario/list.command.js

@@ -1,9 +1,9 @@
 import { cmdScenarioListParsed } from "../scenario.js";
 export const scenarioListSpec = {
-    id: ["scenario", "list"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "list"],
+    group: "Recipes",
     summary: "List resolver-backed scenario descriptors from installed recipes.",
     parse: () => ({}),
-    examples: [{ cmd: "agentplane scenario list", why: "List available recipe scenarios." }],
+    examples: [{ cmd: "agentplane recipes scenario list", why: "List available recipe scenarios." }],
 };
 export const runScenarioList = (ctx) => cmdScenarioListParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });

package/dist/commands/scenario/run.command.js

@@ -1,14 +1,14 @@
 import { usageError } from "../../cli/spec/errors.js";
 import { cmdScenarioRunParsed } from "../scenario.js";
 export const scenarioRunSpec = {
-    id: ["scenario", "run"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "run"],
+    group: "Recipes",
     summary: "Preview a validated scenario plan without creating a task or running a runner.",
     args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
     examples: [
         {
-            cmd: "agentplane scenario run viewer:demo",
-            why: "Validate a scenario and inspect the preview plan before `scenario execute`.",
+            cmd: "agentplane recipes scenario run viewer:demo",
+            why: "Validate a scenario and inspect the preview plan before `recipes scenario execute`.",
         },
     ],
     parse: (raw) => {
@@ -17,7 +17,7 @@ export const scenarioRunSpec = {
         if (!recipeId || !scenarioId) {
             throw usageError({
                 spec: scenarioRunSpec,
-                command: "scenario run",
+                command: "recipes scenario run",
                 message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
             });
         }

package/dist/commands/scenario/scenario.command.js

@@ -1,9 +1,9 @@
 import { loadDirectSubcommandNames, parseGroupCommand, throwGroupCommandUsage, } from "../../cli/group-command.js";
 export const scenarioSpec = {
-    id: ["scenario"],
-    group: "Scenario",
+    id: ["recipes", "scenario"],
+    group: "Recipes",
     summary: "Recipe scenario commands.",
-    synopsis: ["agentplane scenario <subcommand> [options]"],
+    synopsis: ["agentplane recipes scenario <subcommand> [options]"],
     args: [{ name: "subcommand", required: false, variadic: true, valueHint: "<subcommand>" }],
     parse: (raw) => parseGroupCommand(raw, "subcommand"),
 };
@@ -11,9 +11,9 @@ export const runScenario = async (_ctx, p) => {
     throwGroupCommandUsage({
         spec: scenarioSpec,
         cmd: p.cmd,
-        subcommands: await loadDirectSubcommandNames(["scenario"]),
-        command: "scenario",
-        missingMessage: "Missing scenario subcommand.",
-        unknownMessage: (subcommand) => `Unknown scenario subcommand: ${subcommand}.`,
+        subcommands: await loadDirectSubcommandNames(["recipes", "scenario"]),
+        command: "recipes scenario",
+        missingMessage: "Missing recipes scenario subcommand.",
+        unknownMessage: (subcommand) => `Unknown recipes scenario subcommand: ${subcommand}.`,
     });
 };

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

@@ -0,0 +1,12 @@
+export type MergedBranchCleanupResult = {
+    removedBranch: boolean;
+    removedWorktree: boolean;
+    worktreePath: string | null;
+    skippedReason: "outside_repo" | "current_worktree" | null;
+};
+export declare function cleanupMergedLocalBranch(opts: {
+    gitRoot: string;
+    branch: string;
+    worktreePathHint?: string | null;
+}): Promise<MergedBranchCleanupResult>;
+//# sourceMappingURL=merged-branch-cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merged-branch-cleanup.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/merged-branch-cleanup.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,cAAc,GAAG,kBAAkB,GAAG,IAAI,CAAC;CAC3D,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA4CrC"}

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

@@ -0,0 +1,46 @@
+import { execFileAsync, gitEnv } from "./git.js";
+import { gitBranchExists } from "./git-ops.js";
+import { findWorktreeForBranch } from "./git-worktree.js";
+import { isPathWithin, resolvePathFallback } from "./path.js";
+export async function cleanupMergedLocalBranch(opts) {
+    const repoRoot = await resolvePathFallback(opts.gitRoot);
+    const discoveredWorktree = await findWorktreeForBranch(opts.gitRoot, opts.branch);
+    const rawWorktreePath = discoveredWorktree ?? opts.worktreePathHint ?? null;
+    const worktreePath = rawWorktreePath ? await resolvePathFallback(rawWorktreePath) : null;
+    if (worktreePath) {
+        if (!isPathWithin(repoRoot, worktreePath)) {
+            return {
+                removedBranch: false,
+                removedWorktree: false,
+                worktreePath,
+                skippedReason: "outside_repo",
+            };
+        }
+        if (worktreePath === repoRoot) {
+            return {
+                removedBranch: false,
+                removedWorktree: false,
+                worktreePath,
+                skippedReason: "current_worktree",
+            };
+        }
+        await execFileAsync("git", ["worktree", "remove", "--force", worktreePath], {
+            cwd: opts.gitRoot,
+            env: gitEnv(),
+        });
+    }
+    let removedBranch = false;
+    if (await gitBranchExists(opts.gitRoot, opts.branch)) {
+        await execFileAsync("git", ["branch", "-D", opts.branch], {
+            cwd: opts.gitRoot,
+            env: gitEnv(),
+        });
+        removedBranch = true;
+    }
+    return {
+        removedBranch,
+        removedWorktree: Boolean(worktreePath),
+        worktreePath,
+        skippedReason: null,
+    };
+}

package/dist/commands/shared/post-commit-pr-artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-commit-pr-artifacts.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/post-commit-pr-artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,wBAAsB,uCAAuC,CAAC,IAAI,EAAE;IAClE,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB"}
+{"version":3,"file":"post-commit-pr-artifacts.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/post-commit-pr-artifacts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA2BhE,wBAAsB,uCAAuC,CAAC,IAAI,EAAE;IAClE,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB"}

package/dist/commands/shared/post-commit-pr-artifacts.js

@@ -1,10 +1,45 @@
 import { warnMessage } from "../../cli/output.js";
 import { normalizeGhTransportError } from "../shared/gh-transport.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
 import { ensurePrArtifactsSynced } from "../pr/internal/sync.js";
+import { isTaskLocalOnlyAdvance } from "./task-local-freshness.js";
+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));
+}
+async function resolveHeadParent(gitRoot) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD^"], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        const parent = stdout.trim();
+        return parent.length > 0 ? parent : null;
+    }
+    catch (err) {
+        if (!isUnknownRevisionError(err))
+            throw err;
+        return null;
+    }
+}
 export async function refreshBranchPrArtifactsAfterTaskCommit(opts) {
     if (opts.ctx.config.workflow_mode !== "branch_pr")
         return;
     try {
+        const gitRoot = opts.ctx.resolvedProject.gitRoot;
+        const headParent = await resolveHeadParent(gitRoot);
+        if (await isTaskLocalOnlyAdvance({
+            gitRoot,
+            workflowDir: opts.ctx.config.paths.workflow_dir,
+            tasksPath: opts.ctx.config.paths.tasks_path,
+            taskId: opts.taskId,
+            fromRef: headParent,
+            toRef: "HEAD",
+        })) {
+            return;
+        }
         await ensurePrArtifactsSynced({
             ctx: opts.ctx,
             cwd: opts.cwd,

package/dist/commands/shared/task-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared/task-backend.js

@@ -1,10 +1,11 @@
+import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { resolveTaskDocUpdatedBy, parseTaskReadme, taskDocToSectionMap, validateTaskReadmeFrontmatter, withTaskReadmeFrontmatterDefaults, } from "@agentplaneorg/core";
 import { CliError } from "../../shared/errors.js";
 import { loadTaskBackend, taskRecordToData, toTaskSummary, } from "../../backends/task-backend.js";
 import { gitShowFile, toGitPath } from "./git-diff.js";
 import { GitContext } from "./git-context.js";
-import { gitListTaskBranches, parseTaskIdFromBranch } from "./git-worktree.js";
+import { findWorktreeForBranch, gitListTaskBranches, parseTaskIdFromBranch, } from "./git-worktree.js";
 function normalizeDocUpdatedBy(value) {
     const trimmed = value?.trim() ?? "";
     if (!trimmed)
@@ -131,14 +132,45 @@ export async function loadTaskFromBranchSnapshot(opts) {
         : await resolveTaskBranchFromContext({ ctx: opts.ctx, taskId: opts.taskId });
     if (!branch)
         return null;
+    const liveWorktreePath = await findWorktreeForBranch(opts.ctx.resolvedProject.gitRoot, branch);
+    if (liveWorktreePath) {
+        const liveReadmePath = path.join(liveWorktreePath, path.relative(opts.ctx.resolvedProject.gitRoot, opts.readmePath));
+        try {
+            const liveText = await readFile(liveReadmePath, "utf8");
+            const parsed = parseTaskReadme(liveText);
+            const frontmatter = validateTaskReadmeFrontmatter(withTaskReadmeFrontmatterDefaults({
+                ...parsed.frontmatter,
+                id: typeof parsed.frontmatter.id === "string" && parsed.frontmatter.id.trim().length > 0
+                    ? parsed.frontmatter.id
+                    : opts.taskId,
+            }));
+            return taskRecordToData({
+                id: opts.taskId,
+                frontmatter: frontmatter,
+                body: parsed.body,
+                readmePath: opts.readmePath,
+            });
+        }
+        catch {
+            // Fall back to the committed branch snapshot when the live worktree lacks the README.
+        }
+    }
     const relReadmePath = toGitPath(path.relative(opts.ctx.resolvedProject.gitRoot, opts.readmePath));
+    const refsToTry = [branch, branch.startsWith("origin/") ? null : `origin/${branch}`].filter((ref) => Boolean(ref && ref.trim().length > 0));
     let text = "";
-    try {
-        text = await gitShowFile(opts.ctx.resolvedProject.gitRoot, branch, relReadmePath);
+    let loaded = false;
+    for (const ref of refsToTry) {
+        try {
+            text = await gitShowFile(opts.ctx.resolvedProject.gitRoot, ref, relReadmePath);
+            loaded = true;
+            break;
+        }
+        catch {
+            // Try the next candidate ref.
+        }
     }
-    catch {
+    if (!loaded)
         return null;
-    }
     const parsed = parseTaskReadme(text);
     const frontmatter = validateTaskReadmeFrontmatter(withTaskReadmeFrontmatterDefaults({
         ...parsed.frontmatter,

package/dist/commands/shared/task-handoff.d.ts

@@ -1,4 +1,4 @@
-import { type TaskHandoff, type TaskHandoffRunnerNextAction, type TaskHandoffRunnerState } from "@agentplaneorg/core";
+import { type TaskHandoff, type TaskHandoffRoute, type TaskHandoffRunnerNextAction, type TaskHandoffRunnerState } from "@agentplaneorg/core";
 import type { CommandContext } from "./task-backend.js";
 export type TaskHandoffArtifact = TaskHandoff;
 export type TaskHandoffRunnerHint = TaskHandoffRunnerState;
@@ -46,6 +46,7 @@ export declare function buildTaskHandoffArtifact(opts: {
     workspace_root?: string | null;
     pr_branch?: string | null;
     runner?: TaskHandoffRunnerHint | undefined;
+    route?: TaskHandoffRoute | undefined;
     next_actions?: string[] | undefined;
     risks?: string[] | undefined;
     open_questions?: string[] | undefined;

package/dist/commands/shared/task-handoff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-handoff.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-handoff.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-handoff.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-handoff.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared/task-handoff.js

@@ -14,6 +14,20 @@ function normalizeStringList(values) {
     const normalized = values.map((value) => value.trim()).filter((value) => value.length > 0);
     return normalized.length > 0 ? normalized : undefined;
 }
+function normalizeRoute(route) {
+    if (!route)
+        return undefined;
+    return {
+        kind: route.kind,
+        status: route.status ?? undefined,
+        local_mutation: route.local_mutation ?? undefined,
+        finalize_via: route.finalize_via ?? undefined,
+        pr_number: typeof route.pr_number === "number" && route.pr_number > 0 ? route.pr_number : null,
+        pr_url: trimOrNull(route.pr_url) ?? undefined,
+        handoff_show_command: trimOrNull(route.handoff_show_command) ?? undefined,
+        base_pull_command: trimOrNull(route.base_pull_command) ?? undefined,
+    };
+}
 export function resolveTaskHandoffPaths(opts) {
     const handoff_dir = path.join(opts.git_root, opts.workflow_dir, opts.task_id, "handoff");
     return {
@@ -96,6 +110,7 @@ export function buildTaskHandoffArtifact(opts) {
         workspace_root: trimOrNull(opts.workspace_root),
         pr_branch: trimOrNull(opts.pr_branch),
         runner: opts.runner,
+        route: normalizeRoute(opts.route),
         next_actions: normalizeStringList(opts.next_actions),
         risks: normalizeStringList(opts.risks),
         open_questions: normalizeStringList(opts.open_questions),

package/dist/commands/shared/task-local-freshness.d.ts

@@ -1,12 +1,14 @@
 export declare function isTaskLocalAdvancePath(opts: {
     workflowDir: string;
     taskId: string;
+    tasksPath?: string;
     relPath: string;
 }): boolean;
 export declare function isTaskLocalOnlyAdvance(opts: {
     gitRoot: string;
     workflowDir: string;
     taskId: string;
+    tasksPath?: string;
     fromRef: string | null;
     toRef: string;
 }): Promise<boolean>;

package/dist/commands/shared/task-local-freshness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-local-freshness.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-local-freshness.ts"],"names":[],"mappings":"AAQA,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAEV;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,OAAO,CAAC,CAenB"}
+{"version":3,"file":"task-local-freshness.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-local-freshness.ts"],"names":[],"mappings":"AAQA,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAOV;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBnB"}

package/dist/commands/shared/task-local-freshness.js

@@ -4,7 +4,12 @@ function taskRootPrefix(workflowDir, taskId) {
     return `${toGitPath(path.join(workflowDir, taskId))}/`;
 }
 export function isTaskLocalAdvancePath(opts) {
-    return opts.relPath.startsWith(taskRootPrefix(opts.workflowDir, opts.taskId));
+    const normalizedRelPath = toGitPath(opts.relPath);
+    if (normalizedRelPath.startsWith(taskRootPrefix(opts.workflowDir, opts.taskId))) {
+        return true;
+    }
+    const normalizedTasksPath = opts.tasksPath ? toGitPath(opts.tasksPath) : null;
+    return normalizedTasksPath !== null && normalizedRelPath === normalizedTasksPath;
 }
 export async function isTaskLocalOnlyAdvance(opts) {
     if (!opts.fromRef || opts.fromRef === opts.toRef) {
@@ -15,6 +20,7 @@ export async function isTaskLocalOnlyAdvance(opts) {
         changedPaths.every((relPath) => isTaskLocalAdvancePath({
             workflowDir: opts.workflowDir,
             taskId: opts.taskId,
+            tasksPath: opts.tasksPath,
             relPath,
         })));
 }

package/dist/commands/task/finish-shared.d.ts

@@ -57,5 +57,6 @@ export declare function createTaskCloseCommit(opts: {
     quiet: boolean;
     closeUnstageOthers?: boolean;
     allowPolicy?: boolean;
+    closeRefreshTaskArtifacts?: boolean;
 }): Promise<void>;
 //# sourceMappingURL=finish-shared.d.ts.map

package/dist/commands/task/finish-shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finish-shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish-shared.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG/D,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAA6B,YAAY,EAAmB,MAAM,yBAAyB,CAAC;AAWnG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AA0CF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,GAAG,IAAI,CAK5E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,IAAI,CAyCP;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GAAG,IAAI,CAAC;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,2BAA2B,EAAE,OAAO,CAAC;CACtC,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,gBAAgB,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC,CAuDD;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,cAAc,CAAC;IACpB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC3C,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEhB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhB"}
+{"version":3,"file":"finish-shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish-shared.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG/D,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAA6B,YAAY,EAAmB,MAAM,yBAAyB,CAAC;AAWnG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AA0CF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,GAAG,IAAI,CAK5E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,IAAI,CAyCP;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GAAG,IAAI,CAAC;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,2BAA2B,EAAE,OAAO,CAAC;CACtC,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,gBAAgB,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC,CAuDD;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,cAAc,CAAC;IACpB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC3C,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEhB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB"}

package/dist/commands/task/finish-shared.js

@@ -234,5 +234,6 @@ export async function createTaskCloseCommit(opts) {
         closeUnstageOthers: opts.closeUnstageOthers === true,
         closeCheckOnly: false,
         closeStageTaskArtifacts: opts.ctx.config.workflow_mode === "branch_pr",
+        closeRefreshTaskArtifacts: opts.closeRefreshTaskArtifacts,
     });
 }

package/dist/commands/task/handoff-show.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handoff-show.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/handoff-show.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAOtE,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAiBlE,CAAC;AAIF,eAAO,MAAM,kBAAkB,GAAU,KAAK,UAAU,EAAE,QAAQ,qBAAqB,oBAsDtF,CAAC"}
+{"version":3,"file":"handoff-show.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/handoff-show.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAOtE,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAiBlE,CAAC;AAIF,eAAO,MAAM,kBAAkB,GAAU,KAAK,UAAU,EAAE,QAAQ,qBAAqB,oBA2EtF,CAAC"}

package/dist/commands/task/handoff-show.command.js

@@ -52,6 +52,30 @@ export const runTaskHandoffShow = async (ctx, parsed) => {
         entries.push({ label: "head_sha", value: handoff.head_sha });
     if (handoff.pr_branch)
         entries.push({ label: "pr_branch", value: handoff.pr_branch });
+    if (handoff.route?.kind)
+        entries.push({ label: "route_kind", value: handoff.route.kind });
+    if (handoff.route?.status)
+        entries.push({ label: "route_status", value: handoff.route.status });
+    if (handoff.route?.local_mutation) {
+        entries.push({ label: "route_local_mutation", value: handoff.route.local_mutation });
+    }
+    if (handoff.route?.finalize_via) {
+        entries.push({ label: "route_finalize_via", value: handoff.route.finalize_via });
+    }
+    if (typeof handoff.route?.pr_number === "number") {
+        entries.push({ label: "route_pr_number", value: String(handoff.route.pr_number) });
+    }
+    if (handoff.route?.pr_url)
+        entries.push({ label: "route_pr_url", value: handoff.route.pr_url });
+    if (handoff.route?.handoff_show_command) {
+        entries.push({
+            label: "route_handoff_show_command",
+            value: handoff.route.handoff_show_command,
+        });
+    }
+    if (handoff.route?.base_pull_command) {
+        entries.push({ label: "route_base_pull_command", value: handoff.route.base_pull_command });
+    }
     if (handoff.runner?.run_id) {
         entries.push({ label: "run_id", value: handoff.runner.run_id }, { label: "runner_status", value: handoff.runner.status ?? "unknown" }, { label: "runner_next_action", value: handoff.runner.next_action ?? "none" });
         if (handoff.runner.next_command) {

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

@@ -1 +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"}
+{"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;AAStE,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;AA4aF,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

@@ -6,6 +6,7 @@ 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 { cleanupMergedLocalBranch } from "../shared/merged-branch-cleanup.js";
 import { loadTaskFromContext, resolveTaskBranchFromContext, } from "../shared/task-backend.js";
 import { parseTaskIdFromCloseBranch } from "../shared/git-worktree.js";
 import { parsePrMeta } from "../shared/pr-meta.js";
@@ -263,6 +264,35 @@ function normalizeGithubPrLink(prNumber, prUrl, verb) {
         ? `${verb} GitHub PR #${prNumber}: ${prUrl.trim()}`
         : `${verb} GitHub PR #${prNumber}`;
 }
+async function maybeCleanupMergedTaskBranch(opts) {
+    try {
+        const cleanup = await cleanupMergedLocalBranch({
+            gitRoot: opts.gitRoot,
+            branch: opts.branch,
+        });
+        if (!cleanup.removedBranch && !cleanup.removedWorktree) {
+            if (cleanup.skippedReason === "current_worktree") {
+                opts.output.info(`local merged branch cleanup skipped: ${opts.branch} is the current checkout`);
+            }
+            else if (cleanup.skippedReason === "outside_repo") {
+                opts.output.info(`local merged branch cleanup skipped: ${opts.branch} is attached to a worktree outside the current checkout root`);
+            }
+            return;
+        }
+        const details = [];
+        if (cleanup.removedWorktree && cleanup.worktreePath) {
+            details.push(`removed worktree ${cleanup.worktreePath}`);
+        }
+        if (cleanup.removedBranch) {
+            details.push(`deleted branch ${opts.branch}`);
+        }
+        opts.output.info(`local merged branch cleanup: ${details.join("; ")}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        opts.output.warn(`local merged branch cleanup failed for ${opts.branch}: ${message}`);
+    }
+}
 async function openHostedClosePr(opts) {
     const output = createCliEmitter();
     const { meta, task, taskBranch } = await readHostedCloseState({
@@ -339,6 +369,11 @@ async function openHostedClosePr(opts) {
         explicitBranch: opts.branch ?? null,
         mergeCommit,
     });
+    await maybeCleanupMergedTaskBranch({
+        output,
+        gitRoot,
+        branch: sourceBranch,
+    });
     const owner = repo.split("/")[0]?.trim() ?? "";
     const existingQuery = new URLSearchParams({
         state: "open",

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;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"}
+{"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;AAOrF,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;AAmYF,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"}