agentplane 0.1.9 → 0.2.1

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

@@ -0,0 +1,142 @@
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { resolveBaseBranch } from "@agentplaneorg/core";
+import { fileExists } from "../../../../cli/fs-utils.js";
+import { unknownEntityMessage, workflowModeMessage } from "../../../../cli/output.js";
+import { CliError } from "../../../../shared/errors.js";
+import { ensureGitClean } from "../../../guard/index.js";
+import { gitDiffNames, gitShowFile, toGitPath } from "../../../shared/git-diff.js";
+import { gitBranchExists, gitCurrentBranch, gitRevParse } from "../../../shared/git-ops.js";
+import { loadBackendTask, loadCommandContext, } from "../../../shared/task-backend.js";
+import { ensurePlanApprovedIfRequired, ensureVerificationSatisfiedIfRequired, } from "../../../task/shared.js";
+import { resolvePrPaths } from "../../internal/pr-paths.js";
+import { readAndValidatePrArtifacts } from "../artifacts.js";
+import { computeVerifyState } from "../verify.js";
+import { parsePrMeta } from "../../../shared/pr-meta.js";
+export async function prepareIntegrate(opts) {
+    const ctx = opts.ctx ??
+        (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+    const { task } = await loadBackendTask({
+        ctx,
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride,
+        taskId: opts.taskId,
+    });
+    const resolved = ctx.resolvedProject;
+    const loadedConfig = ctx.config;
+    if (loadedConfig.workflow_mode !== "branch_pr") {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: workflowModeMessage(loadedConfig.workflow_mode, "branch_pr"),
+        });
+    }
+    ensurePlanApprovedIfRequired(task, loadedConfig);
+    ensureVerificationSatisfiedIfRequired(task, loadedConfig);
+    await ensureGitClean({ cwd: opts.cwd, rootOverride: opts.rootOverride });
+    if (opts.base?.trim().length === 0) {
+        throw new CliError({ exitCode: 2, code: "E_USAGE", message: "Invalid value for --base." });
+    }
+    const baseBranch = await resolveBaseBranch({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+        cliBaseOpt: opts.base ?? null,
+        mode: loadedConfig.workflow_mode,
+    });
+    if (!baseBranch) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "Base branch could not be resolved (use `agentplane branch base set` or --base).",
+        });
+    }
+    const currentBranch = await gitCurrentBranch(resolved.gitRoot);
+    if (currentBranch !== baseBranch) {
+        throw new CliError({
+            exitCode: 5,
+            code: "E_GIT",
+            message: `integrate must run on base branch ${baseBranch} (current: ${currentBranch})`,
+        });
+    }
+    const { prDir, metaPath, diffstatPath, verifyLogPath } = await resolvePrPaths({
+        ctx,
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride,
+        taskId: opts.taskId,
+    });
+    let meta = null;
+    let branch = (opts.branch ?? "").trim();
+    if (await fileExists(metaPath)) {
+        meta = parsePrMeta(await readFile(metaPath, "utf8"), task.id);
+        if (!branch)
+            branch = (meta.branch ?? "").trim();
+    }
+    if (!branch) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "Branch could not be resolved (use --branch or run `agentplane pr open`).",
+        });
+    }
+    if (!(await gitBranchExists(resolved.gitRoot, branch))) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: unknownEntityMessage("branch", branch),
+        });
+    }
+    const metaSource = meta ??
+        parsePrMeta(await gitShowFile(resolved.gitRoot, branch, toGitPath(path.relative(resolved.gitRoot, metaPath))), task.id);
+    const baseCandidate = opts.base ?? metaSource.base ?? baseBranch;
+    const base = typeof baseCandidate === "string" && baseCandidate.trim().length > 0
+        ? baseCandidate.trim()
+        : baseBranch;
+    const { verifyLogText: verifyLogTextMaybe } = await readAndValidatePrArtifacts({
+        ctx,
+        resolved,
+        prDir,
+        metaPath,
+        branch,
+        taskId: task.id,
+    });
+    // readAndValidatePrArtifacts() throws if verify.log is missing; keep this non-null downstream.
+    const verifyLogText = verifyLogTextMaybe;
+    const changedPaths = await gitDiffNames(resolved.gitRoot, base, branch);
+    const tasksPath = loadedConfig.paths.tasks_path;
+    if (changedPaths.includes(tasksPath)) {
+        throw new CliError({
+            exitCode: 5,
+            code: "E_GIT",
+            message: `Branch ${branch} modifies ${tasksPath} (single-writer violation)`,
+        });
+    }
+    const branchHeadSha = await gitRevParse(resolved.gitRoot, [branch]);
+    const initialVerifyState = computeVerifyState({
+        rawVerify: task.verify,
+        metaLastVerifiedSha: metaSource?.last_verified_sha ?? null,
+        verifyLogText,
+        branchHeadSha,
+        runVerify: opts.runVerify,
+    });
+    return {
+        ctx,
+        resolved,
+        loadedConfig,
+        task,
+        baseBranch,
+        currentBranch,
+        prDir,
+        metaPath,
+        diffstatPath,
+        verifyLogPath,
+        meta,
+        metaSource,
+        branch,
+        base,
+        verifyLogText,
+        branchHeadSha,
+        verifyCommands: initialVerifyState.verifyCommands,
+        alreadyVerifiedSha: initialVerifyState.alreadyVerifiedSha,
+        shouldRunVerify: initialVerifyState.shouldRunVerify,
+    };
+}

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

@@ -0,0 +1,14 @@
+export type IntegrateWorktree = {
+    worktreePath: string | null;
+    tempWorktreePath: string | null;
+    createdTempWorktree: boolean;
+};
+export declare function resolveWorktreeForIntegrate(opts: {
+    gitRoot: string;
+    worktreesDirRel: string;
+    branch: string;
+    taskId: string;
+    mergeStrategy: "squash" | "merge" | "rebase";
+    shouldRunVerify: boolean;
+}): Promise<IntegrateWorktree>;
+//# sourceMappingURL=worktree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../../../../src/commands/pr/integrate/internal/worktree.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,eAAe,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6C7B"}

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

@@ -0,0 +1,51 @@
+import path from "node:path";
+import { mkdir } from "node:fs/promises";
+import { fileExists } from "../../../../cli/fs-utils.js";
+import { CliError } from "../../../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../../../shared/git.js";
+import { findWorktreeForBranch } from "../../../shared/git-worktree.js";
+import { isPathWithin } from "../../../shared/path.js";
+export async function resolveWorktreeForIntegrate(opts) {
+    let tempWorktreePath = null;
+    let createdTempWorktree = false;
+    let worktreePath = await findWorktreeForBranch(opts.gitRoot, opts.branch);
+    if (opts.mergeStrategy === "rebase" && !worktreePath) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "rebase strategy requires an existing worktree for the task branch",
+        });
+    }
+    if (opts.shouldRunVerify && !worktreePath) {
+        const worktreesDir = path.resolve(opts.gitRoot, opts.worktreesDirRel);
+        if (!isPathWithin(opts.gitRoot, worktreesDir)) {
+            throw new CliError({
+                exitCode: 5,
+                code: "E_GIT",
+                message: `worktrees_dir must be inside the repo: ${worktreesDir}`,
+            });
+        }
+        tempWorktreePath = path.join(worktreesDir, `_integrate_tmp_${opts.taskId}`);
+        const tempExists = await fileExists(tempWorktreePath);
+        if (tempExists) {
+            const registered = await findWorktreeForBranch(opts.gitRoot, opts.branch);
+            if (!registered) {
+                throw new CliError({
+                    exitCode: 5,
+                    code: "E_GIT",
+                    message: `Temp worktree path exists but is not registered: ${tempWorktreePath}`,
+                });
+            }
+        }
+        else {
+            await mkdir(worktreesDir, { recursive: true });
+            await execFileAsync("git", ["worktree", "add", tempWorktreePath, opts.branch], {
+                cwd: opts.gitRoot,
+                env: gitEnv(),
+            });
+            createdTempWorktree = true;
+        }
+        worktreePath = tempWorktreePath;
+    }
+    return { worktreePath, tempWorktreePath, createdTempWorktree };
+}

package/dist/commands/pr/integrate/verify.d.ts

@@ -0,0 +1,22 @@
+export declare function computeVerifyState(opts: {
+    rawVerify: unknown;
+    metaLastVerifiedSha: unknown;
+    verifyLogText: string | null;
+    branchHeadSha: string;
+    runVerify: boolean;
+}): {
+    verifyCommands: string[];
+    alreadyVerifiedSha: string | null;
+    shouldRunVerify: boolean;
+};
+export declare function runVerifyCommands(opts: {
+    commands: string[];
+    worktreePath: string;
+    branchHeadSha: string;
+    quiet: boolean;
+    taskId: string;
+}): Promise<{
+    header: string;
+    content: string;
+}[]>;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/integrate/verify.ts"],"names":[],"mappings":"AAaA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,OAAO,CAAC;CAC1B,CAgBA;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CA+BjD"}

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

@@ -0,0 +1,60 @@
+import { extractLastVerifiedSha, runShellCommand } from "../../shared/pr-meta.js";
+import { successMessage } from "../../../cli/output.js";
+import { CliError } from "../../../shared/errors.js";
+function normalizeVerifyCommands(rawVerify) {
+    return Array.isArray(rawVerify)
+        ? rawVerify
+            .filter((item) => typeof item === "string")
+            .map((item) => item.trim())
+            .filter(Boolean)
+        : [];
+}
+export function computeVerifyState(opts) {
+    const verifyCommands = normalizeVerifyCommands(opts.rawVerify);
+    let alreadyVerifiedSha = null;
+    if (verifyCommands.length > 0) {
+        const metaVerified = typeof opts.metaLastVerifiedSha === "string" ? opts.metaLastVerifiedSha : null;
+        if (metaVerified && metaVerified === opts.branchHeadSha) {
+            alreadyVerifiedSha = opts.branchHeadSha;
+        }
+        else if (opts.verifyLogText) {
+            const logSha = extractLastVerifiedSha(opts.verifyLogText);
+            if (logSha && logSha === opts.branchHeadSha)
+                alreadyVerifiedSha = logSha;
+        }
+    }
+    const shouldRunVerify = opts.runVerify || (verifyCommands.length > 0 && alreadyVerifiedSha === null);
+    return { verifyCommands, alreadyVerifiedSha, shouldRunVerify };
+}
+export async function runVerifyCommands(opts) {
+    const verifyEntries = [];
+    for (const command of opts.commands) {
+        if (!opts.quiet) {
+            process.stdout.write(`$ ${command}\n`);
+        }
+        const timestamp = new Date().toISOString();
+        const result = await runShellCommand(command, opts.worktreePath);
+        const shaPrefix = opts.branchHeadSha ? `sha=${opts.branchHeadSha} ` : "";
+        verifyEntries.push({
+            header: `[${timestamp}] ${shaPrefix}$ ${command}`.trimEnd(),
+            content: result.output,
+        });
+        if (result.code !== 0) {
+            throw new CliError({
+                exitCode: result.code || 1,
+                code: "E_IO",
+                message: `Verify command failed: ${command}`,
+            });
+        }
+    }
+    if (opts.branchHeadSha) {
+        verifyEntries.push({
+            header: `[${new Date().toISOString()}] ✅ verified_sha=${opts.branchHeadSha}`,
+            content: "",
+        });
+    }
+    if (!opts.quiet) {
+        process.stdout.write(`${successMessage("verify passed", opts.taskId)}\n`);
+    }
+    return verifyEntries;
+}

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

@@ -0,0 +1,2 @@
+export { cmdIntegrate } from "./integrate/cmd.js";
+//# sourceMappingURL=integrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integrate.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/integrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/commands/pr/integrate.js

@@ -0,0 +1 @@
+export { cmdIntegrate } from "./integrate/cmd.js";

package/dist/commands/pr/internal/pr-paths.d.ts

@@ -0,0 +1,29 @@
+import { type AgentplaneConfig } from "@agentplaneorg/core";
+import type { CommandContext } from "../../shared/task-backend.js";
+export type ResolvedPrPaths = {
+    resolved: {
+        gitRoot: string;
+        agentplaneDir: string;
+    };
+    config: AgentplaneConfig;
+    prDir: string;
+    metaPath: string;
+    diffstatPath: string;
+    verifyLogPath: string;
+    reviewPath: string;
+};
+export declare function resolvePrPaths(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+}): Promise<ResolvedPrPaths>;
+export declare function readPrArtifact(opts: {
+    resolved: {
+        gitRoot: string;
+    };
+    prDir: string;
+    fileName: string;
+    branch: string;
+}): Promise<string | null>;
+//# sourceMappingURL=pr-paths.d.ts.map

package/dist/commands/pr/internal/pr-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-paths.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/pr-paths.ts"],"names":[],"mappings":"AAGA,OAAO,EAA8B,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,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,eAAe,CAAC,CAoB3B;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWzB"}

package/dist/commands/pr/internal/pr-paths.js

@@ -0,0 +1,38 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { loadConfig, resolveProject } from "@agentplaneorg/core";
+import { fileExists } from "../../../cli/fs-utils.js";
+import { gitShowFile, toGitPath } from "../../shared/git-diff.js";
+export async function resolvePrPaths(opts) {
+    const resolved = opts.ctx?.resolvedProject ??
+        (await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+    let config = opts.ctx?.config;
+    if (!config) {
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        config = loaded.config;
+    }
+    const taskDir = path.join(resolved.gitRoot, config.paths.workflow_dir, opts.taskId);
+    const prDir = path.join(taskDir, "pr");
+    return {
+        resolved,
+        config,
+        prDir,
+        metaPath: path.join(prDir, "meta.json"),
+        diffstatPath: path.join(prDir, "diffstat.txt"),
+        verifyLogPath: path.join(prDir, "verify.log"),
+        reviewPath: path.join(prDir, "review.md"),
+    };
+}
+export async function readPrArtifact(opts) {
+    const filePath = path.join(opts.prDir, opts.fileName);
+    if (await fileExists(filePath)) {
+        return await readFile(filePath, "utf8");
+    }
+    const rel = toGitPath(path.relative(opts.resolved.gitRoot, filePath));
+    try {
+        return await gitShowFile(opts.resolved.gitRoot, opts.branch, rel);
+    }
+    catch {
+        return null;
+    }
+}

package/dist/commands/pr/internal/review-template.d.ts

@@ -0,0 +1,9 @@
+export declare function renderPrReviewTemplate(opts: {
+    author: string;
+    createdAt: string;
+    branch: string;
+}): string;
+export declare function updateAutoSummaryBlock(text: string, summary: string): string;
+export declare function appendHandoffNote(review: string, note: string): string;
+export declare function validateReviewContents(review: string, errors: string[]): void;
+//# sourceMappingURL=review-template.d.ts.map

package/dist/commands/pr/internal/review-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-template.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/review-template.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CA0BT;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW5E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQtE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAW7E"}

package/dist/commands/pr/internal/review-template.js

@@ -0,0 +1,62 @@
+export function renderPrReviewTemplate(opts) {
+    return [
+        "# PR Review",
+        "",
+        `Opened by ${opts.author} on ${opts.createdAt}`,
+        `Branch: ${opts.branch}`,
+        "",
+        "## Summary",
+        "",
+        "- ",
+        "",
+        "## Checklist",
+        "",
+        "- [ ] Tests added/updated",
+        "- [ ] Lint/format passes",
+        "- [ ] Verify passed",
+        "- [ ] Docs updated (if needed)",
+        "",
+        "## Handoff Notes",
+        "",
+        "<!-- Add review notes here. -->",
+        "",
+        "<!-- BEGIN AUTO SUMMARY -->",
+        "<!-- END AUTO SUMMARY -->",
+        "",
+    ].join("\n");
+}
+export function updateAutoSummaryBlock(text, summary) {
+    const start = "<!-- BEGIN AUTO SUMMARY -->";
+    const end = "<!-- END AUTO SUMMARY -->";
+    const startIdx = text.indexOf(start);
+    const endIdx = text.indexOf(end);
+    if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) {
+        return `${text.trimEnd()}\n\n${start}\n${summary}\n${end}\n`;
+    }
+    const before = text.slice(0, startIdx + start.length);
+    const after = text.slice(endIdx);
+    return `${before}\n${summary}\n${after}`;
+}
+export function appendHandoffNote(review, note) {
+    const marker = "## Handoff Notes";
+    const idx = review.indexOf(marker);
+    if (idx === -1)
+        return `${review.trimEnd()}\n\n${marker}\n\n- ${note}\n`;
+    const head = review.slice(0, idx + marker.length);
+    const tail = review.slice(idx + marker.length);
+    const trimmedTail = tail.startsWith("\n") ? tail.slice(1) : tail;
+    return `${head}\n\n- ${note}\n${trimmedTail}`;
+}
+export function validateReviewContents(review, errors) {
+    const requiredSections = ["## Summary", "## Checklist", "## Handoff Notes"];
+    for (const section of requiredSections) {
+        if (!review.includes(section))
+            errors.push(`Missing section: ${section}`);
+    }
+    if (!review.includes("<!-- BEGIN AUTO SUMMARY -->")) {
+        errors.push("Missing auto summary start marker");
+    }
+    if (!review.includes("<!-- END AUTO SUMMARY -->")) {
+        errors.push("Missing auto summary end marker");
+    }
+}

package/dist/commands/pr/note.d.ts

@@ -0,0 +1,10 @@
+import { type CommandContext } from "../shared/task-backend.js";
+export declare function cmdPrNote(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    author: string;
+    body: string;
+}): Promise<number>;
+//# sourceMappingURL=note.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"note.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/note.ts"],"names":[],"mappings":"AASA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKpF,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClB"}

package/dist/commands/pr/note.js

@@ -0,0 +1,50 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { atomicWriteFile } from "@agentplaneorg/core";
+import { mapCoreError } from "../../cli/error-map.js";
+import { fileExists } from "../../cli/fs-utils.js";
+import { successMessage, workflowModeMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { loadCommandContext } from "../shared/task-backend.js";
+import { resolvePrPaths } from "./internal/pr-paths.js";
+import { appendHandoffNote } from "./internal/review-template.js";
+export async function cmdPrNote(opts) {
+    try {
+        const author = opts.author.trim();
+        const body = opts.body.trim();
+        if (!author) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: "Invalid value for --author." });
+        }
+        if (!body) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: "Invalid value for --body." });
+        }
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const { config, reviewPath, resolved } = await resolvePrPaths({ ...opts, ctx });
+        if (config.workflow_mode !== "branch_pr") {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: workflowModeMessage(config.workflow_mode, "branch_pr"),
+            });
+        }
+        if (!(await fileExists(reviewPath))) {
+            const relReviewPath = path.relative(resolved.gitRoot, reviewPath);
+            throw new CliError({
+                exitCode: 3,
+                code: "E_VALIDATION",
+                message: `Missing ${relReviewPath} (run \`agentplane pr open\`)`,
+            });
+        }
+        const review = await readFile(reviewPath, "utf8");
+        const updated = appendHandoffNote(review, `${author}: ${body}`);
+        await atomicWriteFile(reviewPath, updated, "utf8");
+        process.stdout.write(`${successMessage("pr note", opts.taskId)}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "pr note", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/pr/open.d.ts

@@ -0,0 +1,10 @@
+import { type CommandContext } from "../shared/task-backend.js";
+export declare function cmdPrOpen(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    author: string;
+    branch?: string;
+}): Promise<number>;
+//# sourceMappingURL=open.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/open.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AASnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsElB"}

package/dist/commands/pr/open.js

@@ -0,0 +1,80 @@
+import { mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { atomicWriteFile } from "@agentplaneorg/core";
+import { mapBackendError } from "../../cli/error-map.js";
+import { fileExists } from "../../cli/fs-utils.js";
+import { successMessage, workflowModeMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { writeJsonStableIfChanged, writeTextIfChanged } from "../../shared/write-if-changed.js";
+import { gitCurrentBranch } from "../shared/git-ops.js";
+import { parsePrMeta } from "../shared/pr-meta.js";
+import { loadBackendTask, loadCommandContext, } from "../shared/task-backend.js";
+import { resolvePrPaths } from "./internal/pr-paths.js";
+import { renderPrReviewTemplate } from "./internal/review-template.js";
+function nowIso() {
+    return new Date().toISOString();
+}
+export async function cmdPrOpen(opts) {
+    try {
+        const author = opts.author.trim();
+        if (!author) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: "Invalid value for --author." });
+        }
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const { task } = await loadBackendTask({
+            ctx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+        });
+        const { resolved, config, prDir, metaPath, diffstatPath, verifyLogPath, reviewPath } = await resolvePrPaths({ ...opts, ctx });
+        if (config.workflow_mode !== "branch_pr") {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: workflowModeMessage(config.workflow_mode, "branch_pr"),
+            });
+        }
+        const branch = (opts.branch ?? (await gitCurrentBranch(resolved.gitRoot))).trim();
+        if (!branch) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "Branch could not be resolved (use --branch).",
+            });
+        }
+        await mkdir(prDir, { recursive: true });
+        const now = nowIso();
+        let meta = null;
+        if (await fileExists(metaPath)) {
+            const raw = await readFile(metaPath, "utf8");
+            meta = parsePrMeta(raw, task.id);
+        }
+        const createdAt = meta?.created_at ?? now;
+        const nextMeta = {
+            schema_version: 1,
+            task_id: task.id,
+            branch,
+            created_at: createdAt,
+            updated_at: now,
+            last_verified_sha: meta?.last_verified_sha ?? null,
+            last_verified_at: meta?.last_verified_at ?? null,
+            verify: meta?.verify ?? { status: "skipped" },
+        };
+        await writeJsonStableIfChanged(metaPath, nextMeta);
+        await writeTextIfChanged(diffstatPath, "");
+        await writeTextIfChanged(verifyLogPath, "");
+        if (!(await fileExists(reviewPath))) {
+            const review = renderPrReviewTemplate({ author, createdAt, branch });
+            await atomicWriteFile(reviewPath, review, "utf8");
+        }
+        process.stdout.write(`${successMessage("pr open", path.relative(resolved.gitRoot, prDir))}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "pr open", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,33 @@
+import type { CommandCtx, CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+type PrGroupParsed = {
+    cmd: string[];
+};
+export declare const prSpec: CommandSpec<PrGroupParsed>;
+export type PrOpenParsed = {
+    taskId: string;
+    author: string;
+    branch: string | null;
+};
+export declare const prOpenSpec: CommandSpec<PrOpenParsed>;
+export type PrUpdateParsed = {
+    taskId: string;
+};
+export declare const prUpdateSpec: CommandSpec<PrUpdateParsed>;
+export type PrCheckParsed = {
+    taskId: string;
+};
+export declare const prCheckSpec: CommandSpec<PrCheckParsed>;
+export type PrNoteParsed = {
+    taskId: string;
+    author: string;
+    body: string;
+};
+export declare const prNoteSpec: CommandSpec<PrNoteParsed>;
+export declare function makeRunPrHandler(getCtx: (cmd: string) => Promise<CommandContext>): CommandHandler<PrGroupParsed>;
+export declare function makeRunPrOpenHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: PrOpenParsed) => Promise<number>;
+export declare function makeRunPrUpdateHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: PrUpdateParsed) => Promise<number>;
+export declare function makeRunPrCheckHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: PrCheckParsed) => Promise<number>;
+export declare function makeRunPrNoteHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: PrNoteParsed) => Promise<number>;
+export {};
+//# sourceMappingURL=pr.command.d.ts.map