agentplane 0.3.10 → 0.3.12

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

@@ -6,5 +6,6 @@ export declare function cmdPrOpen(opts: {
     taskId: string;
     author: string;
     branch?: string;
+    syncOnly?: boolean;
 }): Promise<number>;
 //# sourceMappingURL=open.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/open.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,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,CA4BlB"}
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/open.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAkBpF,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;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2ClB"}

package/dist/commands/pr/open.js

@@ -3,7 +3,19 @@ import { mapBackendError } from "../../cli/error-map.js";
 import { exitCodeForError } from "../../cli/exit-codes.js";
 import { createCliEmitter } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
+import { loadCommandContext } from "../shared/task-backend.js";
+import { maybeAutoCommitTaskPrArtifacts } from "./internal/auto-commit.js";
 import { syncPrArtifacts } from "./internal/sync.js";
+function prOpenOutcomeDetails(meta, openOutcome) {
+    if (openOutcome)
+        return openOutcome.message;
+    if (typeof meta.pr_number === "number" && meta.pr_number > 0) {
+        return meta.pr_url?.trim()
+            ? `linked to GitHub PR #${meta.pr_number}: ${meta.pr_url.trim()}`
+            : `linked to GitHub PR #${meta.pr_number}`;
+    }
+    return "local PR artifacts synced; remote PR creation staged";
+}
 export async function cmdPrOpen(opts) {
     try {
         const output = createCliEmitter();
@@ -15,7 +27,7 @@ export async function cmdPrOpen(opts) {
                 message: "Invalid value for --author.",
             });
         }
-        const { prDir, resolved } = await syncPrArtifacts({
+        const { meta, prDir, resolved, openOutcome } = await syncPrArtifacts({
             ctx: opts.ctx,
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,
@@ -23,8 +35,18 @@ export async function cmdPrOpen(opts) {
             mode: "open",
             author,
             branch: opts.branch,
+            remoteMode: opts.syncOnly ? "sync-only" : "auto",
         });
-        output.success("pr open", path.relative(resolved.gitRoot, prDir));
+        const commandCtx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        if (meta.branch) {
+            await maybeAutoCommitTaskPrArtifacts({
+                ctx: commandCtx,
+                taskId: opts.taskId,
+                branch: meta.branch,
+            });
+        }
+        output.success("pr open", path.relative(resolved.gitRoot, prDir), prOpenOutcomeDetails(meta, openOutcome ?? null));
         return 0;
     }
     catch (err) {

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

@@ -7,6 +7,7 @@ export type PrOpenParsed = {
     taskId: string;
     author: string;
     branch: string | null;
+    syncOnly: boolean;
 };
 export declare const prOpenSpec: CommandSpec<PrOpenParsed>;
 export type PrUpdateParsed = {
@@ -22,11 +23,25 @@ export type PrNoteParsed = {
     author: string;
     body: string;
 };
+export type PrCloseParsed = {
+    prNumber: number;
+    repo?: string;
+    comment?: string;
+    deleteRemoteBranch: boolean;
+};
+export type PrCloseSupersededParsed = {
+    taskId: string;
+    deleteRemoteBranch: boolean;
+};
 export declare const prNoteSpec: CommandSpec<PrNoteParsed>;
+export declare const prCloseSpec: CommandSpec<PrCloseParsed>;
+export declare const prCloseSupersededSpec: CommandSpec<PrCloseSupersededParsed>;
 export declare function makeRunPrHandler(_getCtx: (cmd: string) => Promise<CommandContext>): CommandHandler<GroupCommandParsed>;
 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 declare function makeRunPrCloseHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: PrCloseParsed) => Promise<number>;
+export declare function makeRunPrCloseSupersededHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: PrCloseSupersededParsed) => Promise<number>;
 export {};
 //# sourceMappingURL=pr.command.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pr.command.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/pr.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,KAAK,aAAa,GAAG,kBAAkB,CAAC;AAExC,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,aAAa,CAoB7C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAErF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAgChD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CAOpD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAOlD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CA0ChD,CAAC;AAWF,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAChD,cAAc,CAAC,kBAAkB,CAAC,CAEpC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACrE,KAAK,UAAU,EAAE,GAAG,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,CAUjE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACvE,KAAK,UAAU,EAAE,GAAG,cAAc,KAAG,OAAO,CAAC,MAAM,CAAC,CAQnE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACtE,KAAK,UAAU,EAAE,GAAG,aAAa,KAAG,OAAO,CAAC,MAAM,CAAC,CAQlE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACrE,KAAK,UAAU,EAAE,GAAG,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,CAUjE"}
+{"version":3,"file":"pr.command.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/pr.command.ts"],"names":[],"mappings":"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"}

package/dist/commands/pr/pr.command.js

@@ -1,11 +1,13 @@
 import { loadDirectSubcommandNames, parseGroupCommand, throwGroupCommandUsage, } from "../../cli/group-command.js";
 import { usageError } from "../../cli/spec/errors.js";
-import { cmdPrCheck, cmdPrNote, cmdPrOpen, cmdPrUpdate } from "./index.js";
+import { cmdPrCheck, cmdPrClose, cmdPrCloseSuperseded, cmdPrNote, cmdPrOpen, cmdPrUpdate, } from "./index.js";
 export const prSpec = {
     id: ["pr"],
     group: "PR",
     summary: "Manage local PR review and GitHub publication artifacts for a task (branch_pr workflow).",
-    synopsis: ["agentplane pr <open|update|check|note> <task-id> [options]"],
+    synopsis: [
+        "agentplane pr <open|update|check|note|close|close-superseded> <task-id|pr-number> [options]",
+    ],
     args: [{ name: "cmd", required: false, variadic: true, valueHint: "<cmd>" }],
     examples: [
         { cmd: "agentplane pr open 202602030608-F1Q8AB --author CODER", why: "Create PR artifacts." },
@@ -18,6 +20,14 @@ export const prSpec = {
             cmd: 'agentplane pr note 202602030608-F1Q8AB --author REVIEWER --body "Looks good"',
             why: "Append a handoff note.",
         },
+        {
+            cmd: 'agentplane pr close 123 --comment "Superseded by #456" --delete-remote-branch',
+            why: "Close a stale GitHub PR through REST and optionally delete its remote head branch.",
+        },
+        {
+            cmd: "agentplane pr close-superseded 202604072308-A1XE27 --delete-remote-branch",
+            why: "Close a superseded task PR from task artifacts after protected-main closure.",
+        },
     ],
     parse: (raw) => parseGroupCommand(raw),
 };
@@ -40,6 +50,12 @@ export const prOpenSpec = {
             valueHint: "<name>",
             description: "Branch name (default: current branch).",
         },
+        {
+            kind: "boolean",
+            name: "sync-only",
+            default: false,
+            description: "Only write local PR artifacts; do not create a remote GitHub PR.",
+        },
     ],
     examples: [{ cmd: "agentplane pr open 202602030608-F1Q8AB --author CODER", why: "Open." }],
     validateRaw: (raw) => {
@@ -52,6 +68,7 @@ export const prOpenSpec = {
         taskId: String(raw.args["task-id"]),
         author: String(raw.opts.author),
         branch: typeof raw.opts.branch === "string" ? raw.opts.branch : null,
+        syncOnly: Boolean(raw.opts["sync-only"]),
     }),
 };
 export const prUpdateSpec = {
@@ -113,6 +130,80 @@ export const prNoteSpec = {
         body: String(raw.opts.body),
     }),
 };
+export const prCloseSpec = {
+    id: ["pr", "close"],
+    group: "PR",
+    summary: "Close a GitHub PR through REST with optional remote head-branch deletion.",
+    args: [{ name: "pr-number", required: true, valueHint: "<pr-number>" }],
+    options: [
+        {
+            kind: "string",
+            name: "repo",
+            valueHint: "<owner/name>",
+            description: "Optional. GitHub owner/repo override (defaults to origin remote).",
+        },
+        {
+            kind: "string",
+            name: "comment",
+            valueHint: "<text>",
+            description: "Optional. Add a close comment before closing the PR.",
+        },
+        {
+            kind: "boolean",
+            name: "delete-remote-branch",
+            default: false,
+            description: "Delete the remote head branch after a successful close when it belongs to the target repo.",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane pr close 123 --comment "Superseded by #456" --delete-remote-branch',
+            why: "Close a stale PR and remove its remote head branch when it belongs to the same repo.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const prNumber = Number.parseInt(String(raw.args["pr-number"] ?? ""), 10);
+        if (!Number.isInteger(prNumber) || prNumber <= 0) {
+            throw usageError({ spec: prCloseSpec, message: "Invalid value for <pr-number>." });
+        }
+        if (typeof raw.opts.repo === "string" && raw.opts.repo.trim() === "") {
+            throw usageError({ spec: prCloseSpec, message: "Invalid value for --repo: empty." });
+        }
+        if (typeof raw.opts.comment === "string" && raw.opts.comment.trim() === "") {
+            throw usageError({ spec: prCloseSpec, message: "Invalid value for --comment: empty." });
+        }
+    },
+    parse: (raw) => ({
+        prNumber: Number.parseInt(String(raw.args["pr-number"]), 10),
+        repo: typeof raw.opts.repo === "string" ? raw.opts.repo : undefined,
+        comment: typeof raw.opts.comment === "string" ? raw.opts.comment : undefined,
+        deleteRemoteBranch: raw.opts["delete-remote-branch"] === true,
+    }),
+};
+export const prCloseSupersededSpec = {
+    id: ["pr", "close-superseded"],
+    group: "PR",
+    summary: "Close a superseded task PR using task artifacts.",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "boolean",
+            name: "delete-remote-branch",
+            default: false,
+            description: "Delete the remote head branch after a successful close when it belongs to the task repo.",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane pr close-superseded 202604072308-A1XE27 --delete-remote-branch",
+            why: "Repair a stale task PR after the task has already been merged to main.",
+        },
+    ],
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        deleteRemoteBranch: raw.opts["delete-remote-branch"] === true,
+    }),
+};
 async function runPrRootGroup(_ctx, p) {
     throwGroupCommandUsage({
         spec: prSpec,
@@ -133,6 +224,7 @@ export function makeRunPrOpenHandler(getCtx) {
             taskId: p.taskId,
             author: p.author,
             branch: p.branch ?? undefined,
+            syncOnly: p.syncOnly,
         });
     };
 }
@@ -168,3 +260,27 @@ export function makeRunPrNoteHandler(getCtx) {
         });
     };
 }
+export function makeRunPrCloseHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdPrClose({
+            ctx: await getCtx("pr close"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            prNumber: p.prNumber,
+            repo: p.repo,
+            comment: p.comment,
+            deleteRemoteBranch: p.deleteRemoteBranch,
+        });
+    };
+}
+export function makeRunPrCloseSupersededHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdPrCloseSuperseded({
+            ctx: await getCtx("pr close-superseded"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            deleteRemoteBranch: p.deleteRemoteBranch,
+        });
+    };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/update.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,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,CAiBlB"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/update.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAqEnC,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,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,CAsClB"}

package/dist/commands/pr/update.js

@@ -1,18 +1,87 @@
+import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { mapBackendError } from "../../cli/error-map.js";
 import { createCliEmitter } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
+import { gitRevParse } from "../shared/git-ops.js";
+import { loadBackendTask, loadCommandContext, } from "../shared/task-backend.js";
+import { maybeAutoCommitTaskPrArtifacts } from "./internal/auto-commit.js";
+import { assessPrArtifactFreshness } from "./internal/freshness.js";
 import { syncPrArtifacts } from "./internal/sync.js";
+async function readTextIfExists(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+async function warnOnStaleVerifyAfterUpdate(opts) {
+    const branch = opts.meta.branch?.trim() ?? "";
+    if (!branch)
+        return;
+    const ctx = opts.ctx ??
+        (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+    const { config, task } = await loadBackendTask({
+        ctx,
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride,
+        taskId: opts.taskId,
+    });
+    const requiresVerify = Boolean(task.verify && task.verify.length > 0);
+    if (!requiresVerify)
+        return;
+    const branchHeadSha = await gitRevParse(opts.resolved.gitRoot, [`${branch}^{commit}`]);
+    const verifyLogText = await readTextIfExists(path.join(opts.prDir, "verify.log"));
+    const freshness = await assessPrArtifactFreshness({
+        gitRoot: opts.resolved.gitRoot,
+        workflowDir: path.join(opts.resolved.gitRoot, config.paths.workflow_dir),
+        tasksPath: config.paths.tasks_path,
+        taskId: opts.taskId,
+        branchHeadSha,
+        metaHeadSha: opts.meta.head_sha ?? null,
+        metaLastVerifiedSha: opts.meta.last_verified_sha ?? null,
+        metaVerifyStatus: opts.meta.verify?.status ?? null,
+        taskVerificationState: task.verification?.state ?? null,
+        verifyLogText,
+        requiresVerify,
+    });
+    if (opts.meta.last_verified_sha && !freshness.verifyFresh) {
+        opts.output.warn(`Verify state stale: last_verified_sha=${opts.meta.last_verified_sha} current_head=${branchHeadSha}; run \`agentplane verify ${opts.taskId} --ok --by <ROLE> --note "Verified: ..."\` before integrating`);
+    }
+}
 export async function cmdPrUpdate(opts) {
     try {
         const output = createCliEmitter();
-        const { prDir, resolved } = await syncPrArtifacts({
-            ctx: opts.ctx,
+        const commandCtx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const { meta, prDir, resolved } = await syncPrArtifacts({
+            ctx: commandCtx,
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,
             taskId: opts.taskId,
             mode: "update",
         });
+        if (meta.branch) {
+            await maybeAutoCommitTaskPrArtifacts({
+                ctx: commandCtx,
+                taskId: opts.taskId,
+                branch: meta.branch,
+            });
+        }
+        await warnOnStaleVerifyAfterUpdate({
+            output,
+            ctx: commandCtx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+            prDir,
+            resolved,
+            meta,
+        });
         output.success("pr update", path.relative(resolved.gitRoot, prDir));
         return 0;
     }

package/dist/commands/release/apply.command.d.ts

@@ -1,6 +1,8 @@
 import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
 import type { ReleaseApplyParsed } from "./apply.types.js";
 export declare const releaseApplySpec: CommandSpec<ReleaseApplyParsed>;
+export declare const releaseCandidateSpec: CommandSpec<ReleaseApplyParsed>;
 export declare const runReleaseApply: CommandHandler<ReleaseApplyParsed>;
-export { pushReleaseRefs } from "./apply.reporting.js";
+export declare const runReleaseCandidate: CommandHandler<ReleaseApplyParsed>;
+export { pushReleaseCandidateBranch, pushReleaseRefs } from "./apply.reporting.js";
 //# sourceMappingURL=apply.command.d.ts.map

package/dist/commands/release/apply.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.command.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA8B1E,OAAO,KAAK,EAAE,kBAAkB,EAA0C,MAAM,kBAAkB,CAAC;AAkOnG,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAiF5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAmF9D,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.command.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAoC1E,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,kBAAkB,CAAC;AA8c1B,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CA0E5D,CAAC;AAgCF,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,kBAAkB,CAuChE,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAwF9D,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,kBAAkB,CAwFlE,CAAC;AAEF,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}