agentplane 0.3.7 → 0.3.9

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

@@ -1,3 +1,6 @@
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveTaskIndexPath } from "../../../backends/task-index.js";
 import { mapCoreError } from "../../../cli/error-map.js";
 import { infoMessage, successMessage } from "../../../cli/output.js";
 import { stripAnsi } from "../../../cli/shared/ansi.js";
@@ -25,6 +28,37 @@ const FORMATTER_SIGNAL_PATTERNS = [
     /Run Prettier with --write/i,
 ];
 const ESLINT_SIGNAL_PATTERNS = [/\bESLint\b/i, /\b[0-9]+\s+problems?\b/i];
+async function resetRebuildableTaskIndexCache(ctx) {
+    const gitRoot = path.resolve(ctx.resolvedProject.gitRoot);
+    const workflowDirAbs = path.resolve(gitRoot, ctx.config.paths.workflow_dir);
+    const cachePath = path.resolve(resolveTaskIndexPath(workflowDirAbs));
+    const relativeCachePath = path.relative(gitRoot, cachePath);
+    if (!relativeCachePath || relativeCachePath.startsWith(".."))
+        return;
+    try {
+        await execFileAsync("git", ["ls-files", "--error-unmatch", "--", relativeCachePath], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        const gitPath = relativeCachePath.split(path.sep).join("/");
+        const cacheBlob = await execFileAsync("git", ["show", `HEAD:${gitPath}`], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        await mkdir(path.dirname(cachePath), { recursive: true });
+        await writeFile(cachePath, cacheBlob.stdout, "utf8");
+        await execFileAsync("git", ["restore", "--staged", "--", relativeCachePath], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+    }
+    catch {
+        // The task index is a rebuildable cache. If it is absent from HEAD here, remove it so
+        // deterministic close commits only see canonical task artifacts.
+        await rm(cachePath, { force: true });
+    }
+    ctx.git.invalidateStatus();
+}
 function readText(value) {
     if (typeof value === "string")
         return value;
@@ -242,6 +276,7 @@ export async function cmdCommit(opts) {
         if (opts.close) {
             if (!opts.closeCheckOnly) {
                 await ensureReconciledBeforeMutation({ ctx, command: "commit" });
+                await resetRebuildableTaskIndexCache(ctx);
             }
             // Make the close commit deterministic: start from a clean index unless --unstage-others is used.
             let staged = await ctx.git.statusStagedPaths();
@@ -261,7 +296,7 @@ export async function cmdCommit(opts) {
                     message: "Staged files exist (close commit requires an empty index; rerun with --unstage-others to auto-unstage).",
                     context: withDiagnosticContext({ command: "commit" }, {
                         state: "close commit cannot run with a non-empty git index",
-                        likelyCause: "deterministic close commits only stage the task README, but other staged files are already in the index",
+                        likelyCause: "deterministic close commits only stage the active task artifact scope, but other staged files are already in the index",
                         nextAction: {
                             command: "git restore --staged -- .",
                             reason: "clear the current index before rerunning the close commit flow",
@@ -290,18 +325,30 @@ export async function cmdCommit(opts) {
                 }
                 return 0;
             }
-            await ctx.git.stage([readmeRel]);
+            await (opts.closeStageTaskArtifacts === true
+                ? stageAllowlist({
+                    ctx,
+                    allow: [],
+                    allowTasks: true,
+                    tasksPath: ctx.config.paths.tasks_path,
+                    workflowDir: ctx.config.paths.workflow_dir,
+                    taskId: opts.taskId,
+                    allowTaskOnly: true,
+                    emptyAllowMessage: "No changed task artifacts to stage for the deterministic close commit.",
+                    noMatchMessage: "No changed files matched the active task artifact scope for the deterministic close commit.",
+                })
+                : ctx.git.stage([readmeRel]));
             // Close commits should not require manual --allow flags:
-            // the command stages exactly one task README under workflow_dir.
-            const allow = [ctx.config.paths.workflow_dir];
+            // the command stages only the active task artifact scope.
             await guardCommitCheck({
                 ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
+                baseBranchOverride: opts.baseBranchOverride ?? null,
                 taskId: opts.taskId,
                 message: msg.subject,
-                allow,
-                allowBase: false,
+                allow: [],
+                allowBase: opts.allowBase,
                 allowTasks: true,
                 allowPolicy: false,
                 allowConfig: false,
@@ -313,7 +360,7 @@ export async function cmdCommit(opts) {
             const env = buildGitCommitEnv({
                 taskId: opts.taskId,
                 allowTasks: true,
-                allowBase: false,
+                allowBase: opts.allowBase,
                 allowPolicy: false,
                 allowConfig: false,
                 allowHooks: false,
@@ -367,6 +414,7 @@ export async function cmdCommit(opts) {
             ctx,
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,
+            baseBranchOverride: opts.baseBranchOverride ?? null,
             taskId: opts.taskId,
             message: opts.message,
             allow: opts.allow,

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

@@ -3,6 +3,7 @@ export type GuardCommitOptions = {
     ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
+    baseBranchOverride?: string | null;
     taskId: string;
     message: string;
     allow: string[];

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

@@ -1 +1 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/policy.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEvF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,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;CAChB,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4C9E"}
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/policy.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEvF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,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,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,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;CAChB,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C9E"}

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

@@ -9,13 +9,16 @@ export async function guardCommitCheck(opts) {
     const staged = await ctx.git.statusStagedPaths();
     const unstagedTrackedPaths = opts.requireClean ? await ctx.git.statusUnstagedTrackedPaths() : [];
     const inBranchPr = ctx.config.workflow_mode === "branch_pr";
+    const explicitBaseBranch = opts.baseBranchOverride?.trim();
     const baseBranch = inBranchPr
-        ? await resolveBaseBranch({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-            cliBaseOpt: null,
-            mode: ctx.config.workflow_mode,
-        })
+        ? explicitBaseBranch && explicitBaseBranch.length > 0
+            ? explicitBaseBranch
+            : await resolveBaseBranch({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride ?? null,
+                cliBaseOpt: null,
+                mode: ctx.config.workflow_mode,
+            })
         : null;
     const currentBranch = inBranchPr
         ? await gitCurrentBranch(ctx.resolvedProject.gitRoot)

package/dist/commands/hooks/hooks.command.d.ts

@@ -1,5 +1,5 @@
 import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
-export type HooksGroupParsed = Record<string, never>;
-export declare const hooksSpec: CommandSpec<HooksGroupParsed>;
-export declare const runHooks: CommandHandler<HooksGroupParsed>;
+import { type GroupCommandParsed } from "../../cli/group-command.js";
+export declare const hooksSpec: CommandSpec<GroupCommandParsed>;
+export declare const runHooks: CommandHandler<GroupCommandParsed>;
 //# sourceMappingURL=hooks.command.d.ts.map

package/dist/commands/hooks/hooks.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.command.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/hooks.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAErD,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,gBAAgB,CAYnD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,cAAc,CAAC,gBAAgB,CAGrD,CAAC"}
+{"version":3,"file":"hooks.command.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/hooks.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,kBAAkB,CAOrD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,cAAc,CAAC,kBAAkB,CAMvD,CAAC"}

package/dist/commands/hooks/hooks.command.js

@@ -1,18 +1,16 @@
-import { usageError } from "../../cli/spec/errors.js";
+import { loadDirectSubcommandNames, parseGroupCommand, throwGroupCommandUsage, } from "../../cli/group-command.js";
 export const hooksSpec = {
     id: ["hooks"],
     group: "Hooks",
     summary: "Manage and run git hooks installed by agentplane.",
     synopsis: ["agentplane hooks <command> [args] [options]"],
-    validateRaw: (raw) => {
-        if (raw.extra.length > 0) {
-            throw usageError({ spec: hooksSpec, message: `Unknown subcommand: ${raw.extra[0]}` });
-        }
-        throw usageError({ spec: hooksSpec, message: "Missing subcommand." });
-    },
-    parse: () => ({}),
+    args: [{ name: "cmd", required: false, variadic: true, valueHint: "<command>" }],
+    parse: (raw) => parseGroupCommand(raw),
 };
-export const runHooks = () => {
-    // Unreachable (validateRaw always throws).
-    return Promise.resolve(2);
+export const runHooks = async (_ctx, p) => {
+    throwGroupCommandUsage({
+        spec: hooksSpec,
+        cmd: p.cmd,
+        subcommands: await loadDirectSubcommandNames(["hooks"]),
+    });
 };

package/dist/commands/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,UAAU,mDAAoD,CAAC;AA8G5E,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsGlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,UAAU,mDAAoD,CAAC;AAkH5E,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsGlB"}

package/dist/commands/hooks/index.js

@@ -71,17 +71,21 @@ function shimScriptText() {
         "set -e",
         'SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"',
         'REPO_ROOT="$(dirname "$(dirname "$SCRIPT_DIR")")"',
+        'ENV_BIN="${AGENTPLANE_HOOK_RUNNER:-}"',
+        'if [ -n "$ENV_BIN" ] && command -v node >/dev/null 2>&1 && [ -f "$ENV_BIN" ]; then',
+        '  exec node "$ENV_BIN" "$@"',
+        "fi",
         'LOCAL_BIN="$REPO_ROOT/packages/agentplane/bin/agentplane.js"',
         'if command -v node >/dev/null 2>&1 && [ -f "$LOCAL_BIN" ]; then',
         '  exec node "$LOCAL_BIN" "$@"',
         "fi",
-        "if command -v npx >/dev/null 2>&1; then",
-        '  exec npx --yes agentplane "$@"',
-        "fi",
         "if command -v agentplane >/dev/null 2>&1; then",
         '  exec agentplane "$@"',
         "fi",
-        'echo "agentplane shim: runner not found (need node+npx or agentplane in PATH)." >&2',
+        "if command -v npx >/dev/null 2>&1; then",
+        '  exec npx --yes agentplane "$@"',
+        "fi",
+        'echo "agentplane shim: runner not found (need env runner, repo-local source, agentplane in PATH, or node+npx)." >&2',
         "  exit 127",
         "",
     ].join("\n");

package/dist/commands/pr/check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/check.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAKnC,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwElB"}
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/check.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAsDnC,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgHlB"}

package/dist/commands/pr/check.js

@@ -3,14 +3,52 @@ import path from "node:path";
 import { mapBackendError } from "../../cli/error-map.js";
 import { exitCodeForError } from "../../cli/exit-codes.js";
 import { fileExists } from "../../cli/fs-utils.js";
-import { successMessage, workflowModeMessage } from "../../cli/output.js";
+import { createCliEmitter, workflowModeMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
 import { parsePrMeta } from "../shared/pr-meta.js";
+import { gitListTaskBranches, parseTaskIdFromBranch } from "../shared/git-worktree.js";
 import { loadBackendTask, loadCommandContext, } from "../shared/task-backend.js";
-import { resolvePrPaths } from "./internal/pr-paths.js";
+import { readPrArtifact, resolvePrPaths } from "./internal/pr-paths.js";
 import { validateReviewContents } from "./internal/review-template.js";
+async function resolveArtifactBranch(opts) {
+    const prefix = opts.ctx.config.branch.task_prefix;
+    const branches = await gitListTaskBranches(opts.resolved.gitRoot, prefix);
+    const matches = branches.filter((branch) => parseTaskIdFromBranch(prefix, branch) === opts.taskId);
+    if (matches.length === 1)
+        return matches[0] ?? null;
+    if (matches.length > 1) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Multiple task branches match ${opts.taskId}: ${matches.join(", ")}`,
+        });
+    }
+    return null;
+}
+async function readPrArtifactWithOptionalBranch(opts) {
+    const localPath = path.join(opts.prDir, opts.fileName);
+    if (await fileExists(localPath)) {
+        return await readFile(localPath, "utf8");
+    }
+    if (opts.branchCache.value === undefined) {
+        opts.branchCache.value = await resolveArtifactBranch({
+            ctx: opts.ctx,
+            resolved: opts.resolved,
+            taskId: opts.taskId,
+        });
+    }
+    if (!opts.branchCache.value)
+        return null;
+    return await readPrArtifact({
+        resolved: opts.resolved,
+        prDir: opts.prDir,
+        fileName: opts.fileName,
+        branch: opts.branchCache.value,
+    });
+}
 export async function cmdPrCheck(opts) {
     try {
+        const output = createCliEmitter();
         const ctx = opts.ctx ??
             (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
         const { task } = await loadBackendTask({
@@ -33,29 +71,63 @@ export async function cmdPrCheck(opts) {
         const relDiffstatPath = path.relative(resolved.gitRoot, diffstatPath);
         const relVerifyLogPath = path.relative(resolved.gitRoot, verifyLogPath);
         const relReviewPath = path.relative(resolved.gitRoot, reviewPath);
-        if (!(await fileExists(prDir)))
-            errors.push(`Missing PR directory: ${relPrDir}`);
-        if (!(await fileExists(metaPath)))
-            errors.push(`Missing ${relMetaPath}`);
-        if (!(await fileExists(diffstatPath)))
-            errors.push(`Missing ${relDiffstatPath}`);
-        if (!(await fileExists(verifyLogPath)))
-            errors.push(`Missing ${relVerifyLogPath}`);
-        if (!(await fileExists(reviewPath)))
-            errors.push(`Missing ${relReviewPath}`);
+        const branchCache = {};
         let meta = null;
-        if (await fileExists(metaPath)) {
+        const metaText = await readPrArtifactWithOptionalBranch({
+            ctx,
+            resolved,
+            prDir,
+            fileName: "meta.json",
+            taskId: task.id,
+            branchCache,
+        });
+        if (metaText) {
             try {
-                meta = parsePrMeta(await readFile(metaPath, "utf8"), task.id);
+                meta = parsePrMeta(metaText, task.id);
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);
                 errors.push(message);
             }
         }
-        if (await fileExists(reviewPath)) {
-            const review = await readFile(reviewPath, "utf8");
-            validateReviewContents(review, errors);
+        else {
+            errors.push(`Missing PR directory: ${relPrDir}`, `Missing ${relMetaPath}`);
+        }
+        const diffstatText = await readPrArtifactWithOptionalBranch({
+            ctx,
+            resolved,
+            prDir,
+            fileName: "diffstat.txt",
+            taskId: task.id,
+            branchCache,
+        });
+        if (diffstatText === null) {
+            errors.push(`Missing ${relDiffstatPath}`);
+        }
+        const verifyLogText = await readPrArtifactWithOptionalBranch({
+            ctx,
+            resolved,
+            prDir,
+            fileName: "verify.log",
+            taskId: task.id,
+            branchCache,
+        });
+        if (verifyLogText === null) {
+            errors.push(`Missing ${relVerifyLogPath}`);
+        }
+        const reviewText = await readPrArtifactWithOptionalBranch({
+            ctx,
+            resolved,
+            prDir,
+            fileName: "review.md",
+            taskId: task.id,
+            branchCache,
+        });
+        if (reviewText) {
+            validateReviewContents(reviewText, errors);
+        }
+        else {
+            errors.push(`Missing ${relReviewPath}`);
         }
         if (task.verify && task.verify.length > 0) {
             if (meta?.verify?.status !== "pass") {
@@ -72,7 +144,7 @@ export async function cmdPrCheck(opts) {
                 message: errors.join("\n"),
             });
         }
-        process.stdout.write(`${successMessage("pr check", path.relative(resolved.gitRoot, prDir))}\n`);
+        output.success("pr check", path.relative(resolved.gitRoot, prDir));
         return 0;
     }
     catch (err) {

package/dist/commands/pr/integrate/cmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cmd.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/integrate/cmd.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQnE,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqKlB"}
+{"version":3,"file":"cmd.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/integrate/cmd.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQnE,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgMlB"}

package/dist/commands/pr/integrate/cmd.js

@@ -1,6 +1,8 @@
+import path from "node:path";
 import { mapBackendError } from "../../../cli/error-map.js";
-import { successMessage } from "../../../cli/output.js";
+import { createCliEmitter } from "../../../cli/output.js";
 import { CliError } from "../../../shared/errors.js";
+import { cleanupIntegratedBranch } from "./internal/cleanup.js";
 import { execFileAsync, gitEnv } from "../../shared/git.js";
 import { gitRevParse } from "../../shared/git-ops.js";
 import { finalizeIntegrate } from "./internal/finalize.js";
@@ -11,6 +13,7 @@ import { runVerifyCommands } from "./verify.js";
 export async function cmdIntegrate(opts) {
     let tempWorktreePath = null;
     let createdTempWorktree = false;
+    const output = createCliEmitter();
     try {
         const prepared = await prepareIntegrate({
             ctx: opts.ctx,
@@ -26,9 +29,10 @@ export async function cmdIntegrate(opts) {
         let alreadyVerifiedSha = prepared.alreadyVerifiedSha;
         let shouldRunVerify = prepared.shouldRunVerify;
         let branchHeadSha = prepared.branchHeadSha;
+        const changedPaths = prepared.changedPaths;
         if (opts.dryRun) {
             if (!opts.quiet) {
-                process.stdout.write(`${successMessage("integrate dry-run", task.id, `base=${base} branch=${branch} verify=${shouldRunVerify ? "yes" : "no"}`)}\n`);
+                output.success("integrate dry-run", task.id, `base=${base} branch=${branch} verify=${shouldRunVerify ? "yes" : "no"}`);
             }
             return 0;
         }
@@ -70,11 +74,19 @@ export async function cmdIntegrate(opts) {
                 branch,
                 headBeforeMerge,
                 taskId: task.id,
+                workflowDir: loadedConfig.paths.workflow_dir,
+                changedPaths,
                 genericTokens: loadedConfig.commit.generic_tokens,
             });
         }
         else if (opts.mergeStrategy === "merge") {
-            mergeHash = await runMergeCommit({ gitRoot: resolved.gitRoot, branch, taskId: task.id });
+            mergeHash = await runMergeCommit({
+                gitRoot: resolved.gitRoot,
+                branch,
+                taskId: task.id,
+                workflowDir: loadedConfig.paths.workflow_dir,
+                changedPaths,
+            });
         }
         else {
             if (!worktreePath) {
@@ -99,6 +111,8 @@ export async function cmdIntegrate(opts) {
                 shouldRunVerify,
                 quiet: opts.quiet,
                 taskId: task.id,
+                workflowDir: loadedConfig.paths.workflow_dir,
+                changedPaths,
             });
             mergeHash = rebaseRes.mergeHash;
             branchHeadSha = rebaseRes.branchHeadSha;
@@ -107,6 +121,8 @@ export async function cmdIntegrate(opts) {
             verifyEntries.push(...rebaseRes.verifyEntries);
         }
         await finalizeIntegrate({
+            ctx: prepared.ctx,
+            task,
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,
             gitRoot: resolved.gitRoot,
@@ -127,6 +143,18 @@ export async function cmdIntegrate(opts) {
             shouldRunVerify,
             quiet: opts.quiet,
         });
+        const cleanup = await cleanupIntegratedBranch({
+            gitRoot: resolved.gitRoot,
+            branch,
+            worktreePathHint: worktreePath,
+        });
+        if (cleanup.removedWorktree &&
+            cleanup.worktreePath &&
+            tempWorktreePath &&
+            path.resolve(cleanup.worktreePath) === path.resolve(tempWorktreePath)) {
+            tempWorktreePath = null;
+            createdTempWorktree = false;
+        }
         return 0;
     }
     catch (err) {

package/dist/commands/pr/integrate/internal/cleanup.d.ts

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

package/dist/commands/pr/integrate/internal/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../../../src/commands/pr/integrate/internal/cleanup.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,sBAAsB,GAAG;IACnC,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,uBAAuB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA4ClC"}

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

@@ -0,0 +1,46 @@
+import { execFileAsync, gitEnv } from "../../../shared/git.js";
+import { gitBranchExists } from "../../../shared/git-ops.js";
+import { findWorktreeForBranch } from "../../../shared/git-worktree.js";
+import { isPathWithin, resolvePathFallback } from "../../../shared/path.js";
+export async function cleanupIntegratedBranch(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/pr/integrate/internal/finalize.d.ts

@@ -1,4 +1,8 @@
+import type { TaskData } from "../../../../backends/task-backend.js";
+import type { CommandContext } from "../../../shared/task-backend.js";
 export declare function finalizeIntegrate(opts: {
+    ctx: CommandContext;
+    task: TaskData;
     cwd: string;
     rootOverride?: string;
     gitRoot: string;

package/dist/commands/pr/integrate/internal/finalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../../../../src/commands/pr/integrate/internal/finalize.ts"],"names":[],"mappings":"AAmBA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAE3B,aAAa,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,OAAO,CAAC;IAEzB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFhB"}
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../../../../src/commands/pr/integrate/internal/finalize.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAiBrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAMtE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAE3B,aAAa,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,OAAO,CAAC;IAEzB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2EhB"}