agentplane 0.3.12 → 0.3.14

package/dist/commands/pr/internal/sync-open-step.js

@@ -0,0 +1,128 @@
+import { fileExists } from "../../../cli/fs-utils.js";
+import { writeJsonStableIfChanged, writeTextIfChanged } from "../../../shared/write-if-changed.js";
+import { buildObservedGithubPrMeta, buildOpenedPrMeta } from "../../shared/pr-meta.js";
+import { buildGithubPrTitle, renderGithubPrBody, renderPrAutoSummary, renderPrReviewDocument, } from "./review-template.js";
+import { computePrDiffstat } from "./sync-branch.js";
+import { formatGithubPrLink, shouldPersistObservedGithubPrMeta, tryCreateGithubPr, tryLookupExistingGithubPrByBranch, } from "./sync-github.js";
+export async function runPrOpenSync(common, opts) {
+    const diffstat = common.baseBranch
+        ? await computePrDiffstat({
+            gitRoot: common.resolved.gitRoot,
+            baseBranch: common.baseBranch,
+            branch: common.branch,
+            prDir: common.prDir,
+        })
+        : "";
+    const renderedSummaryHeadSha = common.artifactRefresh
+        ? common.renderedHeadSha
+        : (common.renderedHeadSha ?? common.headSha);
+    let nextMeta = buildOpenedPrMeta({
+        taskId: common.task.id,
+        branch: common.branch,
+        at: common.now,
+        previousMeta: common.existingMeta,
+        base: common.baseBranch,
+        headSha: common.renderedHeadSha,
+    });
+    const linkedExistingOutcome = typeof nextMeta.pr_number === "number" && nextMeta.pr_number > 0
+        ? {
+            action: "linked-existing",
+            message: formatGithubPrLink(nextMeta.pr_number, nextMeta.pr_url ?? null, "linked to"),
+        }
+        : null;
+    let openOutcome;
+    const githubTitle = buildGithubPrTitle(common.task);
+    const githubBody = renderGithubPrBody({
+        task: common.task,
+        handoffNotes: common.handoffNotes,
+        autoSummary: renderPrAutoSummary({
+            updatedAt: common.renderUpdatedAt,
+            branch: common.branch,
+            headSha: renderedSummaryHeadSha ?? null,
+            diffstat,
+        }),
+    });
+    const observedGithubPr = await tryLookupExistingGithubPrByBranch({
+        gitRoot: common.resolved.gitRoot,
+        branch: common.branch,
+        baseBranch: common.baseBranch,
+    });
+    if (observedGithubPr) {
+        if (shouldPersistObservedGithubPrMeta(observedGithubPr)) {
+            nextMeta = buildObservedGithubPrMeta({
+                meta: nextMeta,
+                observed: observedGithubPr,
+                at: common.now,
+            });
+        }
+        openOutcome = {
+            action: "linked-existing",
+            message: formatGithubPrLink(observedGithubPr.prNumber, observedGithubPr.prUrl, "linked to"),
+        };
+    }
+    else if (opts.remoteMode === "sync-only") {
+        openOutcome = linkedExistingOutcome ?? {
+            action: "sync-only",
+            message: "local PR artifacts synced; remote PR creation skipped (--sync-only)",
+        };
+    }
+    else {
+        const createdGithubPr = await tryCreateGithubPr({
+            gitRoot: common.resolved.gitRoot,
+            branch: common.branch,
+            baseBranch: common.baseBranch,
+            title: githubTitle,
+            body: githubBody,
+        });
+        if (createdGithubPr.observed) {
+            if (shouldPersistObservedGithubPrMeta(createdGithubPr.observed)) {
+                nextMeta = buildObservedGithubPrMeta({
+                    meta: nextMeta,
+                    observed: createdGithubPr.observed,
+                    at: common.now,
+                });
+            }
+            openOutcome = {
+                action: "created",
+                message: formatGithubPrLink(createdGithubPr.observed.prNumber, createdGithubPr.observed.prUrl, "created"),
+            };
+        }
+        else {
+            openOutcome = linkedExistingOutcome ?? {
+                action: "staged",
+                message: `local PR artifacts synced; remote PR creation staged (${createdGithubPr.stagedReason ?? "remote creation unavailable"})`,
+            };
+        }
+    }
+    const nextAutoSummary = renderPrAutoSummary({
+        updatedAt: common.renderUpdatedAt,
+        branch: common.branch,
+        headSha: renderedSummaryHeadSha ?? null,
+        diffstat,
+    });
+    const nextReview = renderPrReviewDocument({
+        task: common.task,
+        author: opts.author,
+        createdAt: common.createdAt,
+        branch: common.branch,
+        handoffNotes: common.handoffNotes,
+        autoSummary: nextAutoSummary,
+    });
+    const nextGithubBody = renderGithubPrBody({
+        task: common.task,
+        handoffNotes: common.handoffNotes,
+        autoSummary: nextAutoSummary,
+    });
+    await writeJsonStableIfChanged(common.metaPath, nextMeta);
+    await writeTextIfChanged(common.diffstatPath, diffstat ? `${diffstat}\n` : "");
+    if (!(await fileExists(common.notesPath))) {
+        await writeTextIfChanged(common.notesPath, "");
+    }
+    if (!(await fileExists(common.verifyLogPath))) {
+        await writeTextIfChanged(common.verifyLogPath, "");
+    }
+    await writeTextIfChanged(common.reviewPath, nextReview);
+    await writeTextIfChanged(common.githubTitlePath, `${githubTitle}\n`);
+    await writeTextIfChanged(common.githubBodyPath, nextGithubBody);
+    return { meta: nextMeta, openOutcome };
+}

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

@@ -0,0 +1,7 @@
+export declare function nowIso(): string;
+export declare function readTextIfExists(filePath: string): Promise<string | null>;
+export declare function restoreIncidentRegistryIfNeeded(opts: {
+    gitRoot: string;
+    previousText: string | null;
+}): Promise<void>;
+//# sourceMappingURL=sync-support.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-support.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync-support.ts"],"names":[],"mappings":"AAMA,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ/E;AAED,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB"}

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

@@ -0,0 +1,29 @@
+import { readFile, rm } from "node:fs/promises";
+import path from "node:path";
+import { INCIDENTS_POLICY_PATH } from "../../incidents/shared.js";
+import { writeTextIfChanged } from "../../../shared/write-if-changed.js";
+export function nowIso() {
+    return new Date().toISOString();
+}
+export async function readTextIfExists(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+export async function restoreIncidentRegistryIfNeeded(opts) {
+    const incidentsPath = path.join(opts.gitRoot, INCIDENTS_POLICY_PATH);
+    const nextText = await readTextIfExists(incidentsPath);
+    if (nextText === opts.previousText)
+        return;
+    if (opts.previousText === null) {
+        await rm(incidentsPath, { force: true });
+        return;
+    }
+    await writeTextIfChanged(incidentsPath, opts.previousText);
+}

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

@@ -0,0 +1,6 @@
+import { type PrMeta } from "../../shared/pr-meta.js";
+import type { PrSyncCommonState } from "./sync-model.js";
+export declare function runPrUpdateSync(common: PrSyncCommonState): Promise<{
+    meta: PrMeta;
+}>;
+//# sourceMappingURL=sync-update-step.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-update-step.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync-update-step.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,MAAM,EACZ,MAAM,yBAAyB,CAAC;AAYjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,wBAAsB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA6D1F"}

package/dist/commands/pr/internal/sync-update-step.js

@@ -0,0 +1,68 @@
+import { CliError } from "../../../shared/errors.js";
+import { exitCodeForError } from "../../../cli/exit-codes.js";
+import { writeJsonStableIfChanged, writeTextIfChanged } from "../../../shared/write-if-changed.js";
+import { buildObservedGithubPrMeta, buildUpdatedPrMeta, } from "../../shared/pr-meta.js";
+import { buildGithubPrTitle, renderGithubPrBody, renderPrAutoSummary, renderPrReviewDocument, } from "./review-template.js";
+import { computePrDiffstat } from "./sync-branch.js";
+import { shouldPersistObservedGithubPrMeta, tryLookupExistingGithubPrByBranch, } from "./sync-github.js";
+export async function runPrUpdateSync(common) {
+    if (!common.baseBranch) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_USAGE"),
+            code: "E_USAGE",
+            message: "Base branch could not be resolved (use `agentplane branch base set`).",
+        });
+    }
+    const diffstat = await computePrDiffstat({
+        gitRoot: common.resolved.gitRoot,
+        baseBranch: common.baseBranch,
+        branch: common.branch,
+        prDir: common.prDir,
+    });
+    let nextMeta = buildUpdatedPrMeta({
+        meta: common.existingMeta,
+        branch: common.branch,
+        at: common.now,
+        base: common.baseBranch,
+        headSha: common.renderedHeadSha,
+    });
+    const observedGithubPr = await tryLookupExistingGithubPrByBranch({
+        gitRoot: common.resolved.gitRoot,
+        branch: common.branch,
+        baseBranch: common.baseBranch,
+    });
+    if (shouldPersistObservedGithubPrMeta(observedGithubPr)) {
+        nextMeta = buildObservedGithubPrMeta({
+            meta: nextMeta,
+            observed: observedGithubPr,
+            at: common.now,
+        });
+    }
+    const nextAutoSummary = renderPrAutoSummary({
+        updatedAt: nextMeta.updated_at,
+        branch: common.branch,
+        headSha: common.artifactRefresh
+            ? (nextMeta.head_sha ?? common.renderedHeadSha ?? null)
+            : (nextMeta.head_sha ?? common.renderedHeadSha ?? common.headSha ?? null),
+        diffstat,
+    });
+    const nextReview = renderPrReviewDocument({
+        task: common.task,
+        createdAt: common.createdAt,
+        branch: common.branch,
+        handoffNotes: common.handoffNotes,
+        autoSummary: nextAutoSummary,
+    });
+    const githubTitle = buildGithubPrTitle(common.task);
+    const githubBody = renderGithubPrBody({
+        task: common.task,
+        handoffNotes: common.handoffNotes,
+        autoSummary: nextAutoSummary,
+    });
+    await writeTextIfChanged(common.diffstatPath, diffstat ? `${diffstat}\n` : "");
+    await writeTextIfChanged(common.reviewPath, nextReview);
+    await writeTextIfChanged(common.githubTitlePath, `${githubTitle}\n`);
+    await writeTextIfChanged(common.githubBodyPath, githubBody);
+    await writeJsonStableIfChanged(common.metaPath, nextMeta);
+    return { meta: nextMeta };
+}

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

@@ -1,11 +1,8 @@
 import { type PrMeta } from "../../shared/pr-meta.js";
 import { type CommandContext } from "../../shared/task-backend.js";
-export type PrRemoteMode = "auto" | "sync-only";
-export type PrOpenOutcome = {
-    action: "linked-existing" | "created" | "sync-only" | "staged";
-    message: string;
-};
+import type { PrOpenOutcome, PrRemoteMode } from "./sync-model.js";
 type PrSyncMode = "open" | "update";
+export type { PrOpenOutcome, PrRemoteMode } from "./sync-model.js";
 export declare function ensurePrArtifactsSynced(opts: {
     ctx?: CommandContext;
     cwd: string;
@@ -37,5 +34,4 @@ export declare function syncPrArtifacts(opts: {
     };
     openOutcome?: PrOpenOutcome;
 }>;
-export {};
 //# sourceMappingURL=sync.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync.ts"],"names":[],"mappings":"AAqBA,OAAO,EAML,KAAK,MAAM,EACZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AAoFtC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAySF,KAAK,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAmCpC,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,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,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,GAAG,IAAI,CAAC,CAmDR;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B,GAAG,OAAO,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC,CA4TD"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync.ts"],"names":[],"mappings":"AAYA,OAAO,EAAyC,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAE7F,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AAQtC,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAGb,MAAM,iBAAiB,CAAC;AAKzB,KAAK,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA+EnE,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,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,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,GAAG,IAAI,CAAC,CAmDR;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B,GAAG,OAAO,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC,CAkHD"}