agentplane 0.3.23 → 0.3.24

package/dist/commands/guard/impl/commit-refresh.d.ts

@@ -0,0 +1,25 @@
+import { type CommandContext } from "../../shared/task-backend.js";
+type CommitRef = {
+    hash: string;
+    subject: string;
+} | null;
+export declare function resetRebuildableTaskIndexCache(ctx: CommandContext): Promise<void>;
+export declare function formatCommitRef(commit: CommitRef): string;
+export declare function commitRefreshedTaskArtifacts(opts: {
+    ctx: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    sourceMessage: string;
+    quiet: boolean;
+}): Promise<CommitRef>;
+export declare function refreshBranchPrArtifactsForCloseCommit(opts: {
+    ctx: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    quiet: boolean;
+    refreshTaskArtifacts: boolean;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=commit-refresh.d.ts.map

package/dist/commands/guard/impl/commit-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-refresh.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commit-refresh.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKnE,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAE1D,wBAAsB,8BAA8B,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BvF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAGzD;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,SAAS,CAAC,CAgErB;AAED,wBAAsB,sCAAsC,CAAC,IAAI,EAAE;IACjE,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,oBAAoB,EAAE,OAAO,CAAC;CAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhB"}

package/dist/commands/guard/impl/commit-refresh.js

@@ -0,0 +1,116 @@
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { buildTaskArtifactRefreshCommitSubject } from "@agentplaneorg/core/commit";
+import { gitEnv } from "@agentplaneorg/core/git";
+import { execFileAsync } from "@agentplaneorg/core/process";
+import { resolveTaskIndexPath } from "../../../backends/task-index.js";
+import { refreshBranchPrArtifactsAfterTaskCommit } from "../../shared/post-commit-pr-artifacts.js";
+import { isTaskLocalAdvancePath } from "../../shared/task-local-freshness.js";
+import { stageAllowlist } from "./allow.js";
+import { buildGitCommitEnv, resolveCanonicalGitIdentity } from "./env.js";
+import { guardCommitCheck } from "./policy.js";
+export 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 {
+        await rm(cachePath, { force: true });
+    }
+    ctx.git.invalidateStatus();
+}
+export function formatCommitRef(commit) {
+    if (!commit)
+        return "";
+    return `${commit.hash?.slice(0, 12) ?? ""} ${commit.subject ?? ""}`.trim();
+}
+export async function commitRefreshedTaskArtifacts(opts) {
+    const changedPaths = await opts.ctx.git.statusChangedPaths();
+    const taskArtifactPaths = changedPaths.filter((relPath) => isTaskLocalAdvancePath({
+        workflowDir: opts.ctx.config.paths.workflow_dir,
+        taskId: opts.taskId,
+        tasksPath: opts.ctx.config.paths.tasks_path,
+        relPath,
+    }));
+    if (taskArtifactPaths.length === 0)
+        return null;
+    await stageAllowlist({
+        ctx: opts.ctx,
+        allow: [],
+        allowTasks: true,
+        allowPolicy: false,
+        allowConfig: false,
+        allowHooks: false,
+        allowCI: false,
+        tasksPath: opts.ctx.config.paths.tasks_path,
+        workflowDir: opts.ctx.config.paths.workflow_dir,
+        taskId: opts.taskId,
+        allowTaskOnly: true,
+        emptyAllowMessage: "PR artifact refresh produced no task-local files to stage for the follow-up commit.",
+        noMatchMessage: "PR artifact refresh produced changes outside the active task artifact scope; inspect the working tree before retrying the commit flow.",
+    });
+    const message = buildTaskArtifactRefreshCommitSubject({
+        taskId: opts.taskId,
+        baseSubject: opts.sourceMessage,
+    });
+    await guardCommitCheck({
+        ctx: opts.ctx,
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride,
+        baseBranchOverride: null,
+        taskId: opts.taskId,
+        message,
+        allow: [],
+        allowBase: false,
+        allowTasks: true,
+        allowPolicy: false,
+        allowConfig: false,
+        allowHooks: false,
+        allowCI: false,
+        requireClean: true,
+        quiet: opts.quiet,
+    });
+    const env = buildGitCommitEnv({
+        taskId: opts.taskId,
+        allowTasks: true,
+        allowBase: false,
+        allowPolicy: false,
+        allowConfig: false,
+        allowHooks: false,
+        allowCI: false,
+        gitIdentity: await resolveCanonicalGitIdentity(),
+    });
+    await opts.ctx.git.commit({ message, env });
+    return await opts.ctx.git.headHashSubject();
+}
+export async function refreshBranchPrArtifactsForCloseCommit(opts) {
+    if (opts.refreshTaskArtifacts) {
+        await refreshBranchPrArtifactsAfterTaskCommit({
+            ctx: opts.ctx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+            quiet: opts.quiet,
+        });
+    }
+    opts.ctx.git.invalidateStatus();
+}

package/dist/commands/guard/impl/commit-stage.d.ts

@@ -0,0 +1,21 @@
+import { type CommandContext } from "../../shared/task-backend.js";
+export declare function hasExplicitCommitScope(opts: {
+    allow: string[];
+    allowTasks: boolean;
+    allowPolicy: boolean;
+    allowConfig: boolean;
+    allowHooks: boolean;
+    allowCI: boolean;
+}): boolean;
+export declare function stageActiveTaskArtifactsFromAllowTasks(opts: {
+    ctx: CommandContext;
+    taskId: string;
+    allowTasks: boolean;
+}): Promise<string[]>;
+export declare function stageCloseCommitPaths(opts: {
+    ctx: CommandContext;
+    readmeRel: string;
+    taskId: string;
+    allowPolicy: boolean;
+}): Promise<void>;
+//# sourceMappingURL=commit-stage.d.ts.map

package/dist/commands/guard/impl/commit-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-stage.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commit-stage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CASV;AAED,wBAAsB,sCAAsC,CAAC,IAAI,EAAE;IACjE,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBpB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB"}

package/dist/commands/guard/impl/commit-stage.js

@@ -0,0 +1,43 @@
+import { protectedPathKindForFile } from "../../../shared/protected-paths.js";
+import { isTaskLocalAdvancePath } from "../../shared/task-local-freshness.js";
+export function hasExplicitCommitScope(opts) {
+    return (opts.allow.some((prefix) => prefix.trim().length > 0) ||
+        opts.allowTasks ||
+        opts.allowPolicy ||
+        opts.allowConfig ||
+        opts.allowHooks ||
+        opts.allowCI);
+}
+export async function stageActiveTaskArtifactsFromAllowTasks(opts) {
+    if (!opts.allowTasks)
+        return [];
+    const changedPaths = await opts.ctx.git.statusChangedPaths();
+    const taskArtifactPaths = changedPaths.filter((relPath) => isTaskLocalAdvancePath({
+        workflowDir: opts.ctx.config.paths.workflow_dir,
+        taskId: opts.taskId,
+        tasksPath: opts.ctx.config.paths.tasks_path,
+        relPath,
+    }));
+    if (taskArtifactPaths.length === 0)
+        return [];
+    const unique = [...new Set(taskArtifactPaths)].toSorted((a, b) => a.localeCompare(b));
+    await opts.ctx.git.stage(unique);
+    return unique;
+}
+export async function stageCloseCommitPaths(opts) {
+    const stagePaths = new Set([opts.readmeRel]);
+    if (opts.allowPolicy) {
+        const changedPaths = await opts.ctx.git.statusChangedPaths();
+        for (const relPath of changedPaths) {
+            if (protectedPathKindForFile({
+                filePath: relPath,
+                tasksPath: opts.ctx.config.paths.tasks_path,
+                workflowDir: opts.ctx.config.paths.workflow_dir,
+                taskId: opts.taskId,
+            }) === "policy") {
+                stagePaths.add(relPath);
+            }
+        }
+    }
+    await opts.ctx.git.stage([...stagePaths].toSorted((a, b) => a.localeCompare(b)));
+}

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

@@ -1 +1 @@
-{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commit.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AAwLtC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,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,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,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;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,CAAC,CAwIlB"}
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commit.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AAsBtC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,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,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,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;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,CAAC,CAwIlB"}

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

@@ -1,14 +1,8 @@
-import { mkdir, rm, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { buildTaskArtifactRefreshCommitSubject } from "@agentplaneorg/core/commit";
-import { resolveTaskIndexPath } from "../../../backends/task-index.js";
 import { mapCoreError } from "../../../cli/error-map.js";
 import { infoMessage, successMessage } from "../../../cli/output.js";
 import { withDiagnosticContext } from "../../shared/diagnostics.js";
 import { CliError } from "../../../shared/errors.js";
-import { protectedPathKindForFile } from "../../../shared/protected-paths.js";
 import { refreshBranchPrArtifactsAfterTaskCommit } from "../../shared/post-commit-pr-artifacts.js";
-import { isTaskLocalAdvancePath } from "../../shared/task-local-freshness.js";
 import { loadCommandContext, loadTaskFromContext, } from "../../shared/task-backend.js";
 import { execFileAsync } from "@agentplaneorg/core/process";
 import { gitEnv } from "@agentplaneorg/core/git";
@@ -18,141 +12,9 @@ import { resolveIgnoredDirectCloseDirtyPaths } from "./close-dirt.js";
 import { buildCloseCommitMessage, taskReadmePathForTask } from "./close-message.js";
 import { asCommitFailure } from "./commit-diagnostics.js";
 import { buildGitCommitEnv, resolveCanonicalGitIdentity } from "./env.js";
+import { commitRefreshedTaskArtifacts, formatCommitRef, refreshBranchPrArtifactsForCloseCommit, resetRebuildableTaskIndexCache, } from "./commit-refresh.js";
+import { hasExplicitCommitScope, stageActiveTaskArtifactsFromAllowTasks, stageCloseCommitPaths, } from "./commit-stage.js";
 import { guardCommitCheck } from "./policy.js";
-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 {
-        await rm(cachePath, { force: true });
-    }
-    ctx.git.invalidateStatus();
-}
-async function stageCloseCommitPaths(opts) {
-    const stagePaths = new Set([opts.readmeRel]);
-    if (opts.allowPolicy) {
-        const changedPaths = await opts.ctx.git.statusChangedPaths();
-        for (const relPath of changedPaths) {
-            if (protectedPathKindForFile({
-                filePath: relPath,
-                tasksPath: opts.ctx.config.paths.tasks_path,
-                workflowDir: opts.ctx.config.paths.workflow_dir,
-                taskId: opts.taskId,
-            }) === "policy") {
-                stagePaths.add(relPath);
-            }
-        }
-    }
-    await opts.ctx.git.stage([...stagePaths].toSorted((a, b) => a.localeCompare(b)));
-}
-async function commitRefreshedTaskArtifacts(opts) {
-    const changedPaths = await opts.ctx.git.statusChangedPaths();
-    const taskArtifactPaths = changedPaths.filter((relPath) => isTaskLocalAdvancePath({
-        workflowDir: opts.ctx.config.paths.workflow_dir,
-        taskId: opts.taskId,
-        tasksPath: opts.ctx.config.paths.tasks_path,
-        relPath,
-    }));
-    if (taskArtifactPaths.length === 0)
-        return null;
-    await stageAllowlist({
-        ctx: opts.ctx,
-        allow: [],
-        allowTasks: true,
-        allowPolicy: false,
-        allowConfig: false,
-        allowHooks: false,
-        allowCI: false,
-        tasksPath: opts.ctx.config.paths.tasks_path,
-        workflowDir: opts.ctx.config.paths.workflow_dir,
-        taskId: opts.taskId,
-        allowTaskOnly: true,
-        emptyAllowMessage: "PR artifact refresh produced no task-local files to stage for the follow-up commit.",
-        noMatchMessage: "PR artifact refresh produced changes outside the active task artifact scope; inspect the working tree before retrying the commit flow.",
-    });
-    const message = buildTaskArtifactRefreshCommitSubject({
-        taskId: opts.taskId,
-        baseSubject: opts.sourceMessage,
-    });
-    await guardCommitCheck({
-        ctx: opts.ctx,
-        cwd: opts.cwd,
-        rootOverride: opts.rootOverride,
-        baseBranchOverride: null,
-        taskId: opts.taskId,
-        message,
-        allow: [],
-        allowBase: false,
-        allowTasks: true,
-        allowPolicy: false,
-        allowConfig: false,
-        allowHooks: false,
-        allowCI: false,
-        requireClean: true,
-        quiet: opts.quiet,
-    });
-    const env = buildGitCommitEnv({
-        taskId: opts.taskId,
-        allowTasks: true,
-        allowBase: false,
-        allowPolicy: false,
-        allowConfig: false,
-        allowHooks: false,
-        allowCI: false,
-        gitIdentity: await resolveCanonicalGitIdentity(),
-    });
-    await opts.ctx.git.commit({ message, env });
-    return await opts.ctx.git.headHashSubject();
-}
-function hasExplicitCommitScope(opts) {
-    return (opts.allow.some((prefix) => prefix.trim().length > 0) ||
-        opts.allowTasks ||
-        opts.allowPolicy ||
-        opts.allowConfig ||
-        opts.allowHooks ||
-        opts.allowCI);
-}
-function formatCommitRef(commit) {
-    if (!commit)
-        return "";
-    return `${commit.hash?.slice(0, 12) ?? ""} ${commit.subject ?? ""}`.trim();
-}
-async function stageActiveTaskArtifactsFromAllowTasks(opts) {
-    if (!opts.allowTasks)
-        return [];
-    const changedPaths = await opts.ctx.git.statusChangedPaths();
-    const taskArtifactPaths = changedPaths.filter((relPath) => isTaskLocalAdvancePath({
-        workflowDir: opts.ctx.config.paths.workflow_dir,
-        taskId: opts.taskId,
-        tasksPath: opts.ctx.config.paths.tasks_path,
-        relPath,
-    }));
-    if (taskArtifactPaths.length === 0)
-        return [];
-    const unique = [...new Set(taskArtifactPaths)].toSorted((a, b) => a.localeCompare(b));
-    await opts.ctx.git.stage(unique);
-    return unique;
-}
 export async function cmdCommit(opts) {
     try {
         const ctx = opts.ctx ??
@@ -321,16 +183,14 @@ async function cmdCloseCommit(opts) {
         return 0;
     }
     if (opts.closeStageTaskArtifacts === true) {
-        if (opts.closeRefreshTaskArtifacts !== false) {
-            await refreshBranchPrArtifactsAfterTaskCommit({
-                ctx: opts.ctx,
-                cwd: opts.cwd,
-                rootOverride: opts.rootOverride,
-                taskId: opts.taskId,
-                quiet: opts.quiet,
-            });
-        }
-        opts.ctx.git.invalidateStatus();
+        await refreshBranchPrArtifactsForCloseCommit({
+            ctx: opts.ctx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+            quiet: opts.quiet,
+            refreshTaskArtifacts: opts.closeRefreshTaskArtifacts !== false,
+        });
     }
     await (opts.closeStageTaskArtifacts === true
         ? stageAllowlist({

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

@@ -1,30 +1,5 @@
-import type { PlanChange, ReleaseVersionPlan } from "./apply.types.js";
-export declare function fileExists(p: string): Promise<boolean>;
-export declare function readJsonFile<T>(p: string): Promise<T>;
-export declare function parseVersionPlan(raw: unknown): ReleaseVersionPlan;
-export declare function findLatestPlanDir(gitRoot: string): Promise<string>;
-export declare function readPackageVersion(pkgJsonPath: string): Promise<string>;
-export declare function readCoreDependencyVersion(pkgJsonPath: string): Promise<string>;
-export declare function readRecipesDependencyVersion(pkgJsonPath: string): Promise<string>;
-export declare function readAgentplaneDependencyVersion(pkgJsonPath: string): Promise<string>;
-export declare function readOptionalAgentplaneDependencyVersion(pkgJsonPath: string): Promise<string | null>;
-export declare function validateReleaseNotes(notesPath: string, minBullets: number): Promise<void>;
-type ReleaseCommandLabel = "release apply" | "release candidate";
-export declare function ensureCleanTrackedTree(gitRoot: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function ensureTagDoesNotExist(gitRoot: string, tag: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function ensureRemoteExists(gitRoot: string, remote: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function ensureRemoteTagDoesNotExist(gitRoot: string, remote: string, tag: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function ensureNpmVersionsAvailable(gitRoot: string, version: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function runReleasePrepublishGate(gitRoot: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function loadReleasePlan(opts: {
-    gitRoot: string;
-    planOverride?: string;
-}): Promise<{
-    planDir: string;
-    versionJsonPath: string;
-    plan: ReleaseVersionPlan;
-    changes: PlanChange[];
-    minBullets: number;
-}>;
-export {};
+export { fileExists, findLatestPlanDir, loadReleasePlan, parseVersionPlan, readJsonFile, } from "./apply.preflight.plan.js";
+export { readAgentplaneDependencyVersion, readCoreDependencyVersion, readOptionalAgentplaneDependencyVersion, readPackageVersion, readRecipesDependencyVersion, validateReleaseNotes, } from "./apply.preflight.package.js";
+export { ensureCleanTrackedTree, ensureRemoteExists, ensureRemoteTagDoesNotExist, ensureTagDoesNotExist, releasePushDescription, type ReleaseCommandLabel, } from "./apply.preflight.git.js";
+export { ensureNpmVersionsAvailable, runReleasePrepublishGate } from "./apply.preflight.publish.js";
 //# sourceMappingURL=apply.preflight.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"apply.preflight.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5D;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3D;AAaD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAuBjE;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBxE;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7E;AAoBD,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpF;AAED,wBAAsB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvF;AAED,wBAAsB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;AAED,wBAAsB,uCAAuC,CAC3D,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/F;AAED,KAAK,mBAAmB,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAQjE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAyDf;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAuCf;AAgBD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAwBD"}
+{"version":3,"file":"apply.preflight.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,uCAAuC,EACvC,kBAAkB,EAClB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/commands/release/apply.preflight.git.d.ts

@@ -0,0 +1,7 @@
+export type ReleaseCommandLabel = "release apply" | "release candidate";
+export declare function releasePushDescription(commandLabel: ReleaseCommandLabel): string;
+export declare function ensureCleanTrackedTree(gitRoot: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function ensureTagDoesNotExist(gitRoot: string, tag: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function ensureRemoteExists(gitRoot: string, remote: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function ensureRemoteTagDoesNotExist(gitRoot: string, remote: string, tag: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+//# sourceMappingURL=apply.preflight.git.d.ts.map

package/dist/commands/release/apply.preflight.git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.preflight.git.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.git.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAExE,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,mBAAmB,GAAG,MAAM,CAIhF;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAyDf"}

package/dist/commands/release/apply.preflight.git.js

@@ -0,0 +1,138 @@
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { withDiagnosticContext } from "../shared/diagnostics.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync } from "@agentplaneorg/core/process";
+import { gitEnv } from "@agentplaneorg/core/git";
+export function releasePushDescription(commandLabel) {
+    return commandLabel === "release candidate"
+        ? "preparing or pushing the release candidate branch"
+        : "pushing the release tag";
+}
+export async function ensureCleanTrackedTree(gitRoot, commandLabel = "release apply") {
+    const { stdout } = await execFileAsync("git", ["status", "--short", "--untracked-files=no"], {
+        cwd: gitRoot,
+        env: gitEnv(),
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    const dirty = String(stdout ?? "")
+        .split(/\r?\n/u)
+        .map((line) => line.trimEnd())
+        .filter((line) => line.length > 0);
+    if (dirty.length === 0)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: `${commandLabel} requires a clean tracked working tree.\n` +
+            `Found tracked changes:\n${dirty.map((line) => `  ${line}`).join("\n")}`,
+        context: withDiagnosticContext({ command: commandLabel }, {
+            state: `${commandLabel} cannot start from a dirty tracked tree`,
+            likelyCause: "the release flow needs to create one deterministic version-bump commit and tag, but tracked edits already exist in the workspace",
+            nextAction: {
+                command: "git status --short --untracked-files=no",
+                reason: `inspect or clear tracked changes before rerunning \`agentplane ${commandLabel}\``,
+                reasonCode: "release_dirty_tree",
+            },
+        }),
+    });
+}
+export async function ensureTagDoesNotExist(gitRoot, tag, commandLabel = "release apply") {
+    try {
+        await execFileAsync("git", ["rev-parse", "-q", "--verify", `refs/tags/${tag}`], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        throw new CliError({
+            exitCode: exitCodeForError("E_GIT"),
+            code: "E_GIT",
+            message: `Tag already exists: ${tag}`,
+            context: withDiagnosticContext({ command: commandLabel }, {
+                state: "the target release tag already exists locally",
+                likelyCause: "the release version was already applied earlier, or a previous release attempt created the tag before failing later in the flow",
+                nextAction: {
+                    command: `git show --stat --oneline ${tag}`,
+                    reason: "inspect the existing tag before deciding whether to reuse it or plan a new version",
+                    reasonCode: "release_tag_exists",
+                },
+            }),
+        });
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code !== 1)
+            throw err;
+    }
+}
+export async function ensureRemoteExists(gitRoot, remote, commandLabel = "release apply") {
+    try {
+        await execFileAsync("git", ["remote", "get-url", remote], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+    }
+    catch (err) {
+        const details = String(err?.stderr ??
+            err?.message ??
+            "").trim();
+        throw new CliError({
+            exitCode: exitCodeForError("E_GIT"),
+            code: "E_GIT",
+            message: `Git remote is not configured: ${remote}` + (details ? `\n\n${details}` : ""),
+            context: withDiagnosticContext({ command: commandLabel }, {
+                state: "the configured release remote does not exist locally",
+                likelyCause: "release apply was asked to push, but the selected git remote is missing or misconfigured in this checkout",
+                nextAction: {
+                    command: "git remote -v",
+                    reason: `inspect configured remotes before rerunning ${commandLabel} with --push`,
+                    reasonCode: "release_remote_missing",
+                },
+            }),
+        });
+    }
+}
+export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag, commandLabel = "release apply") {
+    let stdout = "";
+    try {
+        const out = await execFileAsync("git", ["ls-remote", "--tags", remote, `refs/tags/${tag}`], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        stdout = String(out.stdout ?? "").trim();
+    }
+    catch (err) {
+        const details = String(err?.stderr ??
+            err?.message ??
+            "").trim();
+        throw new CliError({
+            exitCode: exitCodeForError("E_GIT"),
+            code: "E_GIT",
+            message: `Failed to inspect remote tag state for ${remote}/${tag}.` +
+                (details ? `\n\n${details}` : ""),
+            context: withDiagnosticContext({ command: commandLabel }, {
+                state: `${commandLabel} could not verify the remote tag state`,
+                likelyCause: "the remote is configured, but git could not query it for the target release tag before the release started",
+                nextAction: {
+                    command: `git ls-remote --tags ${remote} refs/tags/${tag}`,
+                    reason: "inspect remote tag visibility before retrying the release push path",
+                    reasonCode: "release_remote_tag_check_failed",
+                },
+            }),
+        });
+    }
+    if (!stdout)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: `Remote tag already exists: ${remote}/${tag}`,
+        context: withDiagnosticContext({ command: commandLabel }, {
+            state: "the target release tag already exists on the remote",
+            likelyCause: "a previous release or partial push already published this tag upstream, so pushing the same version again would drift the local release state",
+            nextAction: {
+                command: `git ls-remote --tags ${remote} refs/tags/${tag}`,
+                reason: "inspect the existing remote tag before deciding whether to recover or bump to a new version",
+                reasonCode: "release_remote_tag_exists",
+            },
+        }),
+    });
+}