agentplane 0.3.15 → 0.3.17

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

@@ -1,7 +1,7 @@
 import { readFile, readdir } from "node:fs/promises";
 import path from "node:path";
 import { exitCodeForError } from "../../cli/exit-codes.js";
-import { withDiagnosticContext } from "../../shared/diagnostics.js";
+import { withDiagnosticContext } from "../shared/diagnostics.js";
 import { CliError } from "../../shared/errors.js";
 import { execFileAsync, gitEnv } from "../shared/git.js";
 export async function fileExists(p) {
@@ -102,6 +102,12 @@ export async function readRecipesDependencyVersion(pkgJsonPath) {
 export async function readAgentplaneDependencyVersion(pkgJsonPath) {
     return await readDependencyVersion(pkgJsonPath, "agentplane");
 }
+export async function readOptionalAgentplaneDependencyVersion(pkgJsonPath) {
+    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    const value = raw.dependencies?.agentplane;
+    const version = typeof value === "string" ? value.trim() : "";
+    return version || null;
+}
 export async function validateReleaseNotes(notesPath, minBullets) {
     const content = await readFile(notesPath, "utf8");
     if (!/release\s+notes/i.test(content)) {
@@ -127,7 +133,12 @@ export async function validateReleaseNotes(notesPath, minBullets) {
         });
     }
 }
-export async function ensureCleanTrackedTree(gitRoot) {
+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(),
@@ -142,20 +153,20 @@ export async function ensureCleanTrackedTree(gitRoot) {
     throw new CliError({
         exitCode: exitCodeForError("E_GIT"),
         code: "E_GIT",
-        message: "Release apply requires a clean tracked working tree.\n" +
+        message: `${commandLabel} requires a clean tracked working tree.\n` +
             `Found tracked changes:\n${dirty.map((line) => `  ${line}`).join("\n")}`,
-        context: withDiagnosticContext({ command: "release apply" }, {
-            state: "release apply cannot start from a dirty tracked tree",
+        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 release apply`",
+                reason: `inspect or clear tracked changes before rerunning \`agentplane ${commandLabel}\``,
                 reasonCode: "release_dirty_tree",
             },
         }),
     });
 }
-export async function ensureTagDoesNotExist(gitRoot, tag) {
+export async function ensureTagDoesNotExist(gitRoot, tag, commandLabel = "release apply") {
     try {
         await execFileAsync("git", ["rev-parse", "-q", "--verify", `refs/tags/${tag}`], {
             cwd: gitRoot,
@@ -165,7 +176,7 @@ export async function ensureTagDoesNotExist(gitRoot, tag) {
             exitCode: exitCodeForError("E_GIT"),
             code: "E_GIT",
             message: `Tag already exists: ${tag}`,
-            context: withDiagnosticContext({ command: "release apply" }, {
+            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: {
@@ -182,7 +193,7 @@ export async function ensureTagDoesNotExist(gitRoot, tag) {
             throw err;
     }
 }
-export async function ensureRemoteExists(gitRoot, remote) {
+export async function ensureRemoteExists(gitRoot, remote, commandLabel = "release apply") {
     try {
         await execFileAsync("git", ["remote", "get-url", remote], {
             cwd: gitRoot,
@@ -197,19 +208,19 @@ export async function ensureRemoteExists(gitRoot, remote) {
             exitCode: exitCodeForError("E_GIT"),
             code: "E_GIT",
             message: `Git remote is not configured: ${remote}` + (details ? `\n\n${details}` : ""),
-            context: withDiagnosticContext({ command: "release apply" }, {
+            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 release apply with --push",
+                    reason: `inspect configured remotes before rerunning ${commandLabel} with --push`,
                     reasonCode: "release_remote_missing",
                 },
             }),
         });
     }
 }
-export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag) {
+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}`], {
@@ -227,8 +238,8 @@ export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag) {
             code: "E_GIT",
             message: `Failed to inspect remote tag state for ${remote}/${tag}.` +
                 (details ? `\n\n${details}` : ""),
-            context: withDiagnosticContext({ command: "release apply" }, {
-                state: "release apply could not verify the remote tag state",
+            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}`,
@@ -244,7 +255,7 @@ export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag) {
         exitCode: exitCodeForError("E_GIT"),
         code: "E_GIT",
         message: `Remote tag already exists: ${remote}/${tag}`,
-        context: withDiagnosticContext({ command: "release apply" }, {
+        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: {
@@ -255,7 +266,7 @@ export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag) {
         }),
     });
 }
-export async function ensureNpmVersionsAvailable(gitRoot, version) {
+export async function ensureNpmVersionsAvailable(gitRoot, version, commandLabel = "release apply") {
     const scriptPath = path.join(gitRoot, "scripts", "check-npm-version-availability.mjs");
     try {
         await execFileAsync("node", [scriptPath, "--version", version], {
@@ -272,7 +283,7 @@ export async function ensureNpmVersionsAvailable(gitRoot, version) {
             message: `Pre-publish npm check failed for version ${version}. ` +
                 "Ensure this version is not already published for @agentplaneorg/core and agentplane." +
                 (details ? `\n\n${details}` : ""),
-            context: withDiagnosticContext({ command: "release apply" }, {
+            context: withDiagnosticContext({ command: commandLabel }, {
                 state: "the target npm version is not publishable",
                 likelyCause: "that version is already burned in npm history for one of the published packages, even if it is no longer the current dist-tag",
                 nextAction: {
@@ -284,40 +295,49 @@ export async function ensureNpmVersionsAvailable(gitRoot, version) {
         });
     }
 }
-export async function runReleasePrepublishGate(gitRoot) {
-    try {
-        await execFileAsync("bun", ["run", "release:prepublish"], {
-            cwd: gitRoot,
-            env: {
-                ...process.env,
-                GIT_AUTHOR_NAME: process.env.GIT_AUTHOR_NAME ?? "agentplane-release",
-                GIT_AUTHOR_EMAIL: process.env.GIT_AUTHOR_EMAIL ?? "agentplane-release@example.com",
-                GIT_COMMITTER_NAME: process.env.GIT_COMMITTER_NAME ?? "agentplane-release",
-                GIT_COMMITTER_EMAIL: process.env.GIT_COMMITTER_EMAIL ?? "agentplane-release@example.com",
-            },
-            maxBuffer: 200 * 1024 * 1024,
-        });
-    }
-    catch (err) {
-        const details = String(err?.stderr ??
-            err?.stdout ??
-            err?.message ??
-            "").trim();
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: "Release prepublish gate failed. `agentplane release apply --push` requires a successful local `bun run release:prepublish` run before pushing the release tag." +
-                (details ? `\n\n${details}` : ""),
-            context: withDiagnosticContext({ command: "release apply" }, {
-                state: "release prepublish validation failed before pushing the release",
-                likelyCause: "one of the local publish gates rejected the current repository state, so the release cannot be pushed safely yet",
-                nextAction: {
-                    command: "bun run release:prepublish",
-                    reason: "rerun the exact local publish gate and fix the reported failure before retrying release apply",
-                    reasonCode: "release_prepublish_failed",
-                },
-            }),
-        });
+async function runReleasePrepublishPhase(gitRoot, phase) {
+    await execFileAsync("bun", ["run", `release:prepublish:${phase}`], {
+        cwd: gitRoot,
+        env: {
+            ...process.env,
+            GIT_AUTHOR_NAME: process.env.GIT_AUTHOR_NAME ?? "agentplane-release",
+            GIT_AUTHOR_EMAIL: process.env.GIT_AUTHOR_EMAIL ?? "agentplane-release@example.com",
+            GIT_COMMITTER_NAME: process.env.GIT_COMMITTER_NAME ?? "agentplane-release",
+            GIT_COMMITTER_EMAIL: process.env.GIT_COMMITTER_EMAIL ?? "agentplane-release@example.com",
+        },
+        maxBuffer: 200 * 1024 * 1024,
+    });
+}
+export async function runReleasePrepublishGate(gitRoot, commandLabel = "release apply") {
+    for (const phase of ["fast", "heavy"]) {
+        try {
+            await runReleasePrepublishPhase(gitRoot, phase);
+        }
+        catch (err) {
+            const details = String(err?.stderr ??
+                err?.stdout ??
+                err?.message ??
+                "").trim();
+            throw new CliError({
+                exitCode: exitCodeForError("E_VALIDATION"),
+                code: "E_VALIDATION",
+                message: `Release prepublish ${phase} phase failed. \`agentplane ${commandLabel} --push\` requires a successful local \`bun run release:prepublish:${phase}\` run before ${releasePushDescription(commandLabel)}.` +
+                    (details ? `\n\n${details}` : ""),
+                context: withDiagnosticContext({ command: commandLabel }, {
+                    state: `release prepublish ${phase} validation failed before ${releasePushDescription(commandLabel)}`,
+                    likelyCause: phase === "fast"
+                        ? "a lightweight publish-readiness check rejected the current release payload before the expensive validation route started"
+                        : "the expensive release validation route rejected the current repository state after the fast publish-readiness checks passed",
+                    nextAction: {
+                        command: `bun run release:prepublish:${phase}`,
+                        reason: phase === "fast"
+                            ? `rerun the fast prepublish phase to fix the exact payload or packaging problem before retrying ${commandLabel}`
+                            : `rerun the heavy prepublish phase to inspect and fix the expensive validation failure before retrying ${commandLabel}`,
+                        reasonCode: `release_prepublish_${phase}_failed`,
+                    },
+                }),
+            });
+        }
     }
 }
 export async function loadReleasePlan(opts) {

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

@@ -1,7 +1,7 @@
 import type { CommandHandler, CommandSpec } from "../cli/spec/spec.js";
 import { type GroupCommandParsed } from "../cli/group-command.js";
-import { type RepoCliVersionExpectation } from "../shared/repo-cli-version.js";
-import { type RuntimeSourceInfo } from "../shared/runtime-source.js";
+import { type RepoCliVersionExpectation } from "../runtime/shared/repo-cli-version.js";
+import { type RuntimeSourceInfo } from "../runtime/shared/runtime-source.js";
 export type FrameworkDevWorkflow = {
     available: boolean;
     bootstrapCommand: string;

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.command.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,+BAA+B,CAAC;AASvC,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAIrC,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACtD,YAAY,EAAE,oBAAoB,CAAC;IACnC,kBAAkB,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,kBAAkB,CAQvD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CAoBhE,CAAC;AAMF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,oBAAoB,CAkCzF;AAgBD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,kBAAkB,EAAE,yBAAyB,GAC5C,MAAM,CA+CR;AAyBD,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,kBAAkB,CAQzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CAkBlE,CAAC"}
+{"version":3,"file":"runtime.command.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,uCAAuC,CAAC;AAS/C,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,qCAAqC,CAAC;AAI7C,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACtD,YAAY,EAAE,oBAAoB,CAAC;IACnC,kBAAkB,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,kBAAkB,CAQvD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CAoBhE,CAAC;AAMF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,oBAAoB,CAkCzF;AAgBD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,kBAAkB,EAAE,yBAAyB,GAC5C,MAAM,CA+CR;AAyBD,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,kBAAkB,CAQzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CAkBlE,CAAC"}

package/dist/commands/runtime.command.js

@@ -1,9 +1,9 @@
 import { loadConfig, resolveProject } from "@agentplaneorg/core";
 import { createCliEmitter } from "../cli/output.js";
 import { loadDirectSubcommandNames, parseGroupCommand, throwGroupCommandUsage, } from "../cli/group-command.js";
-import { evaluateRepoCliVersionExpectation, } from "../shared/repo-cli-version.js";
+import { evaluateRepoCliVersionExpectation, } from "../runtime/shared/repo-cli-version.js";
 import { FRAMEWORK_DEV_BOOTSTRAP_COMMAND, FRAMEWORK_DEV_FORCE_GLOBAL_EXAMPLE, FRAMEWORK_DEV_GLOBAL_VERIFY_COMMAND, FRAMEWORK_DEV_MANUAL_REPAIR_COMMANDS, FRAMEWORK_DEV_REINSTALL_SCRIPT, FRAMEWORK_DEV_REPO_LOCAL_VERIFY_COMMAND, } from "../../bin/framework-dev-contract.js";
-import { describeRuntimeMode, resolveRuntimeSourceInfo, } from "../shared/runtime-source.js";
+import { describeRuntimeMode, resolveRuntimeSourceInfo, } from "../runtime/shared/runtime-source.js";
 const output = createCliEmitter();
 export const runtimeSpec = {
     id: ["runtime"],

package/dist/commands/scenario/impl/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/scenario/impl/commands.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAwB,MAAM,qBAAqB,CAAC;AAkB3E,KAAK,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AA2KF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,GACb,oBAAoB,CAQtB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA2ChE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC;CACvD,GAAG,OAAO,CAAC,MAAM,CAAC,CAuClB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/scenario/impl/commands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAoC,MAAM,qBAAqB,CAAC;AAiBvF,KAAK,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AA0MF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,GACb,oBAAoB,CAGtB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA6ChE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC;CACvD,GAAG,OAAO,CAAC,MAAM,CAAC,CAuClB"}

package/dist/commands/scenario/impl/commands.js

@@ -1,15 +1,39 @@
-import { execFile } from "node:child_process";
 import path from "node:path";
-import { promisify } from "node:util";
-import { resolveProject } from "@agentplaneorg/core";
+import { resolveProject, runProcess } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../cli/error-map.js";
 import { exitCodeForError } from "../../../cli/exit-codes.js";
 import { fileExists } from "../../../cli/fs-utils.js";
 import { createCliEmitter, emptyStateMessage } from "../../../cli/output.js";
 import { CliError } from "../../../shared/errors.js";
 import { listResolvedRecipeScenarios, readProjectInstalledRecipes, readScenarioDefinition, resolveRecipeScenarioSelection, } from "../../recipes.js";
-const execFileAsync = promisify(execFile);
 const output = createCliEmitter();
+const SCENARIO_SELECTION_ERROR_RULES = [
+    {
+        startsWith: ["No recipe scenario matches"],
+        exitCode: exitCodeForError("E_IO"),
+        code: "E_IO",
+        message: (_message) => "",
+    },
+    {
+        startsWith: ["Scenario definition not found"],
+        exitCode: exitCodeForError("E_IO"),
+        code: "E_IO",
+    },
+    {
+        startsWith: [
+            "Scenario selection is ambiguous",
+            "Missing required field: scenario.",
+            "Invalid field scenario.",
+            "Scenario definition id mismatch:",
+        ],
+        exitCode: exitCodeForError("E_VALIDATION"),
+        code: "E_VALIDATION",
+    },
+];
+const RECIPE_TOOL_INVOCATIONS = {
+    node: (entrypoint) => ({ command: "node", args: [entrypoint] }),
+    bash: (entrypoint) => ({ command: "bash", args: [entrypoint] }),
+};
 function buildScenarioNotFoundError(recipeId, scenarioId) {
     return new CliError({
         exitCode: exitCodeForError("E_IO"),
@@ -17,6 +41,22 @@ function buildScenarioNotFoundError(recipeId, scenarioId) {
         message: `Scenario not found: ${recipeId}:${scenarioId}`,
     });
 }
+function mapScenarioSelectionError(recipeId, scenarioId, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    for (const rule of SCENARIO_SELECTION_ERROR_RULES) {
+        if (!rule.startsWith.some((prefix) => message.startsWith(prefix)))
+            continue;
+        if (message.startsWith("No recipe scenario matches")) {
+            return buildScenarioNotFoundError(recipeId, scenarioId);
+        }
+        return new CliError({
+            exitCode: rule.exitCode,
+            code: rule.code,
+            message: rule.message ? rule.message(message) : message,
+        });
+    }
+    return null;
+}
 async function resolveScenarioForCli(opts) {
     const installed = await readProjectInstalledRecipes(opts.project);
     const entry = installed.recipes.find((recipe) => recipe.id === opts.recipeId);
@@ -39,33 +79,9 @@ async function resolveScenarioForCli(opts) {
         return { entry, selection };
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        if (message.startsWith("No recipe scenario matches")) {
-            throw buildScenarioNotFoundError(opts.recipeId, opts.scenarioId);
-        }
-        if (message.startsWith("Scenario definition not found")) {
-            throw new CliError({
-                exitCode: exitCodeForError("E_IO"),
-                code: "E_IO",
-                message,
-            });
-        }
-        if (message.startsWith("Scenario selection is ambiguous")) {
-            throw new CliError({
-                exitCode: exitCodeForError("E_VALIDATION"),
-                code: "E_VALIDATION",
-                message,
-            });
-        }
-        if (message.startsWith("Missing required field: scenario.") ||
-            message.startsWith("Invalid field scenario.") ||
-            message.startsWith("Scenario definition id mismatch:")) {
-            throw new CliError({
-                exitCode: exitCodeForError("E_VALIDATION"),
-                code: "E_VALIDATION",
-                message,
-            });
-        }
+        const mapped = mapScenarioSelectionError(opts.recipeId, opts.scenarioId, error);
+        if (mapped)
+            throw mapped;
         throw error;
     }
 }
@@ -155,13 +171,8 @@ function assertScenarioCompatibility(selection) {
     });
 }
 export function resolveRecipeToolInvocation(runtime, entrypoint, args) {
-    if (runtime === "node") {
-        return { command: "node", args: [entrypoint, ...args] };
-    }
-    return {
-        command: "bash",
-        args: [entrypoint, ...args],
-    };
+    const invocation = RECIPE_TOOL_INVOCATIONS[runtime](entrypoint);
+    return { command: invocation.command, args: [...invocation.args, ...args] };
 }
 export async function cmdScenarioListParsed(opts) {
     try {
@@ -231,7 +242,9 @@ export async function cmdScenarioInfoParsed(opts) {
 export async function executeRecipeTool(opts) {
     const { command, args } = resolveRecipeToolInvocation(opts.runtime, opts.entrypoint, opts.args);
     try {
-        const { stdout, stderr } = await execFileAsync(command, args, {
+        const { stdout, stderr } = await runProcess({
+            command,
+            args,
             cwd: opts.cwd,
             env: opts.env,
         });

package/dist/commands/scenario/impl/report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../../src/commands/scenario/impl/report.ts"],"names":[],"mappings":"AAYA,KAAK,qBAAqB,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AA4BF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAmBnD;AASD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAwB/F;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,EAAE,CAU5F;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,QAAQ,EAAE,0BAA0B,CAAC;IACrC,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../../src/commands/scenario/impl/report.ts"],"names":[],"mappings":"AAQA,KAAK,qBAAqB,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AA4BF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAmBnD;AASD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAwB/F;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,EAAE,CAU5F;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,QAAQ,EAAE,0BAA0B,CAAC;IACrC,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB"}

package/dist/commands/scenario/impl/report.js

@@ -1,9 +1,6 @@
-import { execFile } from "node:child_process";
 import path from "node:path";
-import { promisify } from "node:util";
-import { atomicWriteFile } from "@agentplaneorg/core";
+import { atomicWriteFile, runProcess } from "@agentplaneorg/core";
 import { dedupeStrings } from "../../../shared/strings.js";
-const execFileAsync = promisify(execFile);
 const SCENARIO_REPORT_NAME = "report.json";
 const SENSITIVE_ARG_FLAGS = new Set([
     "--token",
@@ -48,9 +45,9 @@ function isNotGitRepoError(err) {
 export async function getGitDiffSummary(cwd) {
     try {
         const [diff, staged, status] = await Promise.all([
-            execFileAsync("git", ["diff", "--stat"], { cwd }),
-            execFileAsync("git", ["diff", "--stat", "--staged"], { cwd }),
-            execFileAsync("git", ["status", "--porcelain"], { cwd }),
+            runProcess({ command: "git", args: ["diff", "--stat"], cwd }),
+            runProcess({ command: "git", args: ["diff", "--stat", "--staged"], cwd }),
+            runProcess({ command: "git", args: ["status", "--porcelain"], cwd }),
         ]);
         const diffStat = String(diff.stdout).trim();
         const stagedStat = String(staged.stdout).trim();

package/dist/commands/shared/allow-prefix-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allow-prefix-policy.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/allow-prefix-policy.ts"],"names":[],"mappings":"AAEA,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEtE;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKnE"}

package/dist/{shared → commands/shared}/allow-prefix-policy.js

@@ -1,4 +1,4 @@
-import { normalizeGitPathPrefix } from "./git-path.js";
+import { normalizeGitPathPrefix } from "../../shared/git-path.js";
 export function findRepoWideAllowPrefixes(prefixes) {
     return prefixes.filter((prefix) => normalizeGitPathPrefix(prefix) === ".");
 }

package/dist/commands/shared/comment-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-format.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/comment-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlE;AAiCD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAwB3F;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgBzF"}

package/dist/commands/shared/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAMvD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,uBAAuB,GAAG,SAAS,EAC5C,UAAU,EAAE,cAAc,GACzB,uBAAuB,CAiBzB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,uBAAuB,GAAG,SAAS,GAC3C,OAAO,CAAC,cAAc,CAAC,CAqBzB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,MAAM,CAaT"}

package/dist/commands/shared/git-context.d.ts

@@ -1,28 +1,2 @@
-export declare class GitContext {
-    readonly gitRoot: string;
-    private memo;
-    constructor(opts: {
-        gitRoot: string;
-    });
-    private statusPorcelainZ;
-    statusChangedPaths(): Promise<string[]>;
-    statusStagedPaths(): Promise<string[]>;
-    statusUntrackedPaths(): Promise<string[]>;
-    statusUnstagedTrackedPaths(): Promise<string[]>;
-    invalidateStatus(): void;
-    headCommit(): Promise<string>;
-    stage(paths: string[]): Promise<void>;
-    commit(opts: {
-        message: string;
-        body?: string;
-        env?: NodeJS.ProcessEnv;
-    }): Promise<void>;
-    commitAmendNoEdit(opts?: {
-        env?: NodeJS.ProcessEnv;
-    }): Promise<void>;
-    headHashSubject(): Promise<{
-        hash: string;
-        subject: string;
-    }>;
-}
+export { GitContext } from "@agentplaneorg/core";
 //# sourceMappingURL=git-context.d.ts.map

package/dist/commands/shared/git-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-context.ts"],"names":[],"mappings":"AAyEA,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,IAAI,CAGL;gBAEK,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;YAIvB,gBAAgB;IAmBxB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtC,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzC,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrD,gBAAgB,IAAI,IAAI;IAIxB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAWvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxF,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,eAAe,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAWpE"}
+{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/commands/shared/git-context.js

@@ -1,156 +1 @@
-import { execFileAsync, gitEnv } from "./git.js";
-function uniqSorted(paths) {
-    return [...new Set(paths)].toSorted((a, b) => a.localeCompare(b));
-}
-function parsePorcelainV1Z(output) {
-    const text = Buffer.isBuffer(output) ? output.toString("utf8") : output;
-    const parts = text.split("\0").filter((p) => p.length > 0);
-    const changed = [];
-    const staged = [];
-    const unstagedTracked = [];
-    const untracked = [];
-    for (let i = 0; i < parts.length; i++) {
-        const entry = parts[i] ?? "";
-        if (entry.length < 3)
-            continue;
-        const x = entry[0] ?? " ";
-        const y = entry[1] ?? " ";
-        // Porcelain v1: `XY <path>` (or `XY <orig>` NUL `<path>` for renames/copies).
-        if (entry[2] !== " ")
-            continue;
-        const pathA = entry.slice(3);
-        if (!pathA)
-            continue;
-        if (x === "!" && y === "!") {
-            // Ignored file (`!!`): not a "changed path" for guard/staging semantics.
-            continue;
-        }
-        const isUntracked = x === "?" && y === "?";
-        if (isUntracked) {
-            changed.push(pathA);
-            untracked.push(pathA);
-            continue;
-        }
-        const isRenameOrCopy = x === "R" || x === "C";
-        if (isRenameOrCopy) {
-            const pathB = parts[i + 1] ?? "";
-            if (pathB) {
-                // Include both sides so allowlist staging can cover renames across prefixes.
-                changed.push(pathA, pathB);
-                staged.push(pathA, pathB);
-            }
-            else {
-                changed.push(pathA);
-                staged.push(pathA);
-            }
-            i++;
-            continue;
-        }
-        changed.push(pathA);
-        if (x !== " ")
-            staged.push(pathA);
-        if (y !== " ")
-            unstagedTracked.push(pathA);
-    }
-    return {
-        changedPaths: uniqSorted(changed),
-        stagedPaths: uniqSorted(staged),
-        unstagedTrackedPaths: uniqSorted(unstagedTracked),
-        untrackedPaths: uniqSorted(untracked),
-    };
-}
-export class GitContext {
-    gitRoot;
-    memo = {};
-    constructor(opts) {
-        this.gitRoot = opts.gitRoot;
-    }
-    async statusPorcelainZ() {
-        this.memo.status ??= (async () => {
-            // `--untracked-files=all` is required so allowlist staging can match individual files
-            // under untracked directories (tests + real-world "new task" flows).
-            const { stdout } = await execFileAsync("git", ["status", "--porcelain", "-z", "--untracked-files=all"], {
-                cwd: this.gitRoot,
-                env: gitEnv(),
-                encoding: "buffer",
-                maxBuffer: 10 * 1024 * 1024,
-            });
-            return parsePorcelainV1Z(stdout);
-        })();
-        return await this.memo.status;
-    }
-    async statusChangedPaths() {
-        const status = await this.statusPorcelainZ();
-        return status.changedPaths;
-    }
-    async statusStagedPaths() {
-        const status = await this.statusPorcelainZ();
-        return status.stagedPaths;
-    }
-    async statusUntrackedPaths() {
-        const status = await this.statusPorcelainZ();
-        return status.untrackedPaths;
-    }
-    async statusUnstagedTrackedPaths() {
-        const status = await this.statusPorcelainZ();
-        return status.unstagedTrackedPaths;
-    }
-    invalidateStatus() {
-        this.memo.status = undefined;
-    }
-    headCommit() {
-        this.memo.headCommit ??= (async () => {
-            const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD"], {
-                cwd: this.gitRoot,
-                env: gitEnv(),
-            });
-            return String(stdout).trim();
-        })();
-        return this.memo.headCommit;
-    }
-    async stage(paths) {
-        const unique = uniqSorted(paths.map((p) => p.trim()).filter(Boolean));
-        if (unique.length === 0)
-            return;
-        await execFileAsync("git", ["add", "-A", "--", ...unique], {
-            cwd: this.gitRoot,
-            env: gitEnv(),
-        });
-        this.invalidateStatus();
-    }
-    async commit(opts) {
-        const args = ["commit", "-m", opts.message];
-        if (opts.body)
-            args.push("-m", opts.body);
-        await execFileAsync("git", args, {
-            cwd: this.gitRoot,
-            env: opts.env ?? gitEnv(),
-            // Commit hooks can produce large output (lint/test logs).
-            maxBuffer: 50 * 1024 * 1024,
-        });
-        // Invalidate memoized values: commit updates HEAD and working tree state.
-        this.memo.status = undefined;
-        this.memo.headCommit = undefined;
-    }
-    async commitAmendNoEdit(opts) {
-        await execFileAsync("git", ["commit", "--amend", "--no-edit"], {
-            cwd: this.gitRoot,
-            env: opts?.env ?? gitEnv(),
-            // Amend triggers hooks too; keep buffer aligned with regular commit.
-            maxBuffer: 50 * 1024 * 1024,
-        });
-        this.memo.status = undefined;
-        this.memo.headCommit = undefined;
-    }
-    async headHashSubject() {
-        const { stdout } = await execFileAsync("git", ["log", "-1", "--pretty=%H%x00%s"], {
-            cwd: this.gitRoot,
-            env: gitEnv(),
-            encoding: "buffer",
-            maxBuffer: 1024 * 1024,
-        });
-        const text = Buffer.isBuffer(stdout) ? stdout.toString("utf8") : String(stdout);
-        const [hash = "", subject = ""] = text.split("\0", 2);
-        return { hash: hash.trim(), subject: subject.trim() };
-    }
-}
+export { GitContext } from "@agentplaneorg/core";