agentplane 0.3.22 → 0.3.23

package/dist/commands/hooks/install.d.ts

@@ -1,3 +1,7 @@
+export declare function collectHooksInstallConflicts(opts: {
+    gitRoot: string;
+    agentplaneDir: string;
+}): Promise<string[]>;
 export declare function cmdHooksInstall(opts: {
     cwd: string;
     rootOverride?: string;

package/dist/commands/hooks/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/install.ts"],"names":[],"mappings":"AAgGA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/install.ts"],"names":[],"mappings":"AA+CA,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBpB;AAmDD,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB"}

package/dist/commands/hooks/install.js

@@ -32,6 +32,25 @@ function resolveInstalledHookRunnerPath() {
     const activeBin = String(process.env.AGENTPLANE_RUNTIME_ACTIVE_BIN ?? "").trim();
     return activeBin || resolveAgentplaneBinPath();
 }
+export async function collectHooksInstallConflicts(opts) {
+    const hooksDir = await resolveGitHooksDir(opts.gitRoot);
+    const conflicts = [];
+    const shimPath = path.join(opts.agentplaneDir, "bin", "agentplane");
+    if (await fileExists(shimPath)) {
+        const managed = await fileIsManaged(shimPath, SHIM_MARKER);
+        if (!managed)
+            conflicts.push(shimPath);
+    }
+    for (const hook of HOOK_NAMES) {
+        const hookPath = path.join(hooksDir, hook);
+        if (!(await fileExists(hookPath)))
+            continue;
+        const managed = await fileIsManaged(hookPath, HOOK_MARKER);
+        if (!managed)
+            conflicts.push(hookPath);
+    }
+    return conflicts;
+}
 function shimScriptText(installedRunnerPath) {
     return [
         "#!/usr/bin/env sh",

package/dist/commands/hooks/run.pre-push.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.pre-push.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/run.pre-push.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAyBhD,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AA+TD,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB3E"}
+{"version":3,"file":"run.pre-push.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/run.pre-push.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAyBhD,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAiUD,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB3E"}

package/dist/commands/hooks/run.pre-push.js

@@ -4,6 +4,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { fileExists } from "../../cli/fs-utils.js";
 import { resolveAgentplaneRepoScriptPath } from "../../shared/package-paths.js";
+import { resolvePreferredNodeExecutable, withPreferredRuntimePath, } from "../../shared/runtime-env.js";
 function resolveBundledPrePushHookScriptPath() {
     return resolveAgentplaneRepoScriptPath("run-pre-push-hook.mjs");
 }
@@ -45,7 +46,7 @@ function runHookCommand(gitRoot, command, args) {
         command,
         args,
         cwd: gitRoot,
-        env: process.env,
+        env: withPreferredRuntimePath(process.env),
         stdout: "inherit",
         stderr: "inherit",
         reject: false,
@@ -222,7 +223,9 @@ function runInternalPrePushHook(gitRoot, stdin) {
         if (isReleasePush) {
             const releaseNotesScript = path.join(gitRoot, "scripts", "check-release-notes.mjs");
             if (fileExistsSync(releaseNotesScript)) {
-                const notesExitCode = runHookCommand(gitRoot, "node", ["scripts/check-release-notes.mjs"]);
+                const notesExitCode = runHookCommand(gitRoot, resolvePreferredNodeExecutable(process.env), [
+                    "scripts/check-release-notes.mjs",
+                ]);
                 if (notesExitCode !== 0)
                     return notesExitCode;
             }

package/dist/commands/recipes/impl/installed-recipes.d.ts

@@ -1,5 +1,9 @@
 import { type InstalledRecipesFile } from "@agentplaneorg/recipes";
+type ValidateInstalledRecipesFileOptions = {
+    dropInvalidEntries?: boolean;
+};
 export declare function readInstalledRecipesFile(filePath: string): Promise<InstalledRecipesFile>;
-export declare function readAndMigrateInstalledRecipesFile(filePath: string): Promise<InstalledRecipesFile>;
+export declare function readAndMigrateInstalledRecipesFile(filePath: string, opts?: ValidateInstalledRecipesFileOptions): Promise<InstalledRecipesFile>;
 export declare function writeInstalledRecipesFile(filePath: string, file: InstalledRecipesFile): Promise<void>;
+export {};
 //# sourceMappingURL=installed-recipes.d.ts.map

package/dist/commands/recipes/impl/installed-recipes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installed-recipes.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/installed-recipes.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAgDhC,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAS9F;AAED,wBAAsB,kCAAkC,CACtD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAc/B;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAOf"}
+{"version":3,"file":"installed-recipes.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/installed-recipes.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAMhC,KAAK,mCAAmC,GAAG;IACzC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAgEF,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAS9F;AAED,wBAAsB,kCAAkC,CACtD,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,mCAAmC,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAc/B;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/commands/recipes/impl/installed-recipes.js

@@ -5,7 +5,39 @@ import { normalizeRecipeTags, validateRecipeManifest, } from "@agentplaneorg/rec
 import { invalidFieldMessage } from "../../../cli/output.js";
 import { isRecord } from "../../../shared/guards.js";
 import { writeJsonStableIfChanged } from "../../../shared/write-if-changed.js";
-function validateInstalledRecipesFile(raw) {
+function normalizeInstalledRecipeEntry(entry, opts) {
+    if (!isRecord(entry)) {
+        if (opts?.dropInvalidEntries)
+            return null;
+        throw new Error(invalidFieldMessage("recipes.json.recipes[]", "object"));
+    }
+    let manifest;
+    try {
+        manifest = validateRecipeManifest(entry.manifest);
+    }
+    catch (error) {
+        if (opts?.dropInvalidEntries)
+            return null;
+        throw error;
+    }
+    const id = typeof entry.id === "string" ? entry.id.trim() : manifest.id;
+    const version = typeof entry.version === "string" ? entry.version.trim() : manifest.version;
+    const source = typeof entry.source === "string" ? entry.source.trim() : "";
+    const installedAt = typeof entry.installed_at === "string" ? entry.installed_at.trim() : "";
+    if (!id || !version || !source || !installedAt) {
+        if (opts?.dropInvalidEntries)
+            return null;
+        throw new Error(invalidFieldMessage("recipes.json.recipes[]", "id, version, source, installed_at"));
+    }
+    if (id !== manifest.id || version !== manifest.version) {
+        if (opts?.dropInvalidEntries)
+            return null;
+        throw new Error(invalidFieldMessage("recipes.json.recipes[]", "id/version match manifest"));
+    }
+    const tags = normalizeRecipeTags(entry.tags ?? manifest.tags ?? []);
+    return { id, version, source, installed_at: installedAt, tags, manifest };
+}
+function validateInstalledRecipesFile(raw, opts) {
     if (!isRecord(raw))
         throw new Error(invalidFieldMessage("recipes.json", "object"));
     if (raw.schema_version !== 1)
@@ -13,22 +45,9 @@ function validateInstalledRecipesFile(raw) {
     if (!Array.isArray(raw.recipes))
         throw new Error(invalidFieldMessage("recipes.json.recipes", "array"));
     const updatedAt = typeof raw.updated_at === "string" ? raw.updated_at : "";
-    const recipes = raw.recipes
-        .filter((entry) => isRecord(entry))
-        .map((entry) => {
-        const manifest = validateRecipeManifest(entry.manifest);
-        const id = typeof entry.id === "string" ? entry.id.trim() : manifest.id;
-        const version = typeof entry.version === "string" ? entry.version.trim() : manifest.version;
-        const source = typeof entry.source === "string" ? entry.source.trim() : "";
-        const installedAt = typeof entry.installed_at === "string" ? entry.installed_at.trim() : "";
-        if (!id || !version || !source || !installedAt) {
-            throw new Error(invalidFieldMessage("recipes.json.recipes[]", "id, version, source, installed_at"));
-        }
-        if (id !== manifest.id || version !== manifest.version) {
-            throw new Error(invalidFieldMessage("recipes.json.recipes[]", "id/version match manifest"));
-        }
-        const tags = normalizeRecipeTags(entry.tags ?? manifest.tags ?? []);
-        return { id, version, source, installed_at: installedAt, tags, manifest };
+    const recipes = raw.recipes.flatMap((entry) => {
+        const normalized = normalizeInstalledRecipeEntry(entry, opts);
+        return normalized ? [normalized] : [];
     });
     return { schema_version: 1, updated_at: updatedAt, recipes };
 }
@@ -54,10 +73,10 @@ export async function readInstalledRecipesFile(filePath) {
         throw err;
     }
 }
-export async function readAndMigrateInstalledRecipesFile(filePath) {
+export async function readAndMigrateInstalledRecipesFile(filePath, opts) {
     try {
         const raw = JSON.parse(await readFile(filePath, "utf8"));
-        const normalized = sortInstalledRecipes(validateInstalledRecipesFile(raw));
+        const normalized = sortInstalledRecipes(validateInstalledRecipesFile(raw, opts));
         if (installedRecipesNeedMigration(raw, normalized)) {
             await mkdir(path.dirname(filePath), { recursive: true });
             await writeJsonStableIfChanged(filePath, normalized);

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

@@ -1 +1 @@
-{"version":3,"file":"apply.mutation.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.mutation.ts"],"names":[],"mappings":"AASA,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,gCAAgC,CACpD,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED,wBAAsB,8BAA8B,CAClD,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAgB,YAAY,IAAI,MAAM,CAAC,UAAU,CAOhD"}
+{"version":3,"file":"apply.mutation.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.mutation.ts"],"names":[],"mappings":"AAaA,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,gCAAgC,CACpD,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED,wBAAsB,8BAA8B,CAClD,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAgB,YAAY,IAAI,MAAM,CAAC,UAAU,CAOhD"}

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

@@ -3,6 +3,7 @@ import { readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { exitCodeForError } from "../../cli/exit-codes.js";
 import { CliError } from "../../shared/errors.js";
+import { resolvePreferredNodeExecutable, withPreferredRuntimePath, } from "../../shared/runtime-env.js";
 import { execFileAsync } from "@agentplaneorg/core/process";
 import { gitEnv } from "@agentplaneorg/core/git";
 export async function replacePackageVersionInFile(pkgJsonPath, nextVersion) {
@@ -75,7 +76,7 @@ export async function maybeUpdateBunLockfile(gitRoot, fileExists) {
     try {
         await execFileAsync("bun", ["install", "--ignore-scripts"], {
             cwd: gitRoot,
-            env: process.env,
+            env: withPreferredRuntimePath(process.env),
             maxBuffer: 50 * 1024 * 1024,
         });
     }
@@ -97,9 +98,9 @@ export async function maybeRefreshGeneratedReference(gitRoot, fileExists) {
     if (!(await fileExists(scriptPath)))
         return false;
     try {
-        await execFileAsync("node", [scriptPath], {
+        await execFileAsync(resolvePreferredNodeExecutable(process.env), [scriptPath], {
             cwd: gitRoot,
-            env: process.env,
+            env: withPreferredRuntimePath(process.env),
             maxBuffer: 20 * 1024 * 1024,
         });
     }
@@ -132,5 +133,5 @@ export function cleanHookEnv() {
     delete env.AGENTPLANE_STATUS_TO;
     delete env.AGENTPLANE_AGENT_ID;
     env.AGENTPLANE_ALLOW_CONFIG = "1";
-    return env;
+    return withPreferredRuntimePath(env);
 }

package/dist/commands/release/apply.pipeline/mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../../../src/commands/release/apply.pipeline/mutation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAU,UAAU,EAAyB,MAAM,yBAAyB,CAAC;AAYpF,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA6DlC;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAgBjC"}
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../../../src/commands/release/apply.pipeline/mutation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAU,UAAU,EAAyB,MAAM,yBAAyB,CAAC;AAYpF,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAuElC;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAgBjC"}

package/dist/commands/release/apply.pipeline/mutation.js

@@ -14,9 +14,14 @@ export async function applyReleaseMutation(opts) {
     ]);
     const shouldUpdateTestkitAgentplaneDependency = (await fileExists(opts.testkitPkgPath)) &&
         (await packageDependencyExists(opts.testkitPkgPath, "agentplane"));
+    const shouldUpdateTestkitCoreDependency = (await fileExists(opts.testkitPkgPath)) &&
+        (await packageDependencyExists(opts.testkitPkgPath, "@agentplaneorg/core"));
     if (shouldUpdateTestkitAgentplaneDependency) {
         await replacePackageDependencyVersion(opts.testkitPkgPath, "agentplane", opts.nextVersion);
     }
+    if (shouldUpdateTestkitCoreDependency) {
+        await replacePackageDependencyVersion(opts.testkitPkgPath, "@agentplaneorg/core", opts.nextVersion);
+    }
     const expectedCliVersionPersisted = await maybePersistExpectedCliVersion(opts.agentplaneDir, opts.nextVersion);
     await maybeUpdateBunLockfile(opts.gitRoot, fileExists);
     const generatedReferenceExists = await maybeRefreshGeneratedReference(opts.gitRoot, fileExists);
@@ -26,7 +31,7 @@ export async function applyReleaseMutation(opts) {
         "packages/recipes/package.json",
         path.relative(opts.gitRoot, opts.notesPath),
     ];
-    if (shouldUpdateTestkitAgentplaneDependency) {
+    if (shouldUpdateTestkitAgentplaneDependency || shouldUpdateTestkitCoreDependency) {
         stagePaths.push("packages/testkit/package.json");
     }
     if (expectedCliVersionPersisted) {

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":"AASA,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,CAmCf;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,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"}

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

@@ -3,6 +3,7 @@ import path from "node:path";
 import { exitCodeForError } from "../../cli/exit-codes.js";
 import { withDiagnosticContext } from "../shared/diagnostics.js";
 import { CliError } from "../../shared/errors.js";
+import { resolvePreferredNodeExecutable, withPreferredRuntimePath, } from "../../shared/runtime-env.js";
 import { execFileAsync } from "@agentplaneorg/core/process";
 import { gitEnv } from "@agentplaneorg/core/git";
 export async function fileExists(p) {
@@ -270,9 +271,9 @@ export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag, commandL
 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], {
+        await execFileAsync(resolvePreferredNodeExecutable(process.env), [scriptPath, "--version", version], {
             cwd: gitRoot,
-            env: process.env,
+            env: withPreferredRuntimePath(process.env),
             maxBuffer: 10 * 1024 * 1024,
         });
     }
@@ -299,13 +300,13 @@ export async function ensureNpmVersionsAvailable(gitRoot, version, commandLabel
 async function runReleasePrepublishPhase(gitRoot, phase) {
     await execFileAsync("bun", ["run", `release:prepublish:${phase}`], {
         cwd: gitRoot,
-        env: {
+        env: withPreferredRuntimePath({
             ...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,
     });
 }

package/dist/runtime/prompt-modules/index.d.ts

@@ -0,0 +1,3 @@
+export { PROMPT_MODULE_CONTRACT_SCHEMA_VERSION, type PromptModule, type PromptModuleAddress, type PromptModuleConflictPolicy, type PromptModuleContentKind, type PromptModuleContractSchemaVersion, type PromptModuleDependency, type PromptModuleGraph, type PromptModuleGraphNode, type PromptModuleLoadCondition, type PromptModuleMergeMode, type PromptModuleMergePolicy, type PromptModuleMutability, type PromptModuleNamespace, type PromptModuleOwner, type PromptModuleProvenance, type PromptModuleReference, type PromptModuleSlot, type PromptModuleSourceKind, type PromptModuleSurface, type PromptModuleTarget, } from "./model.js";
+export type { PromptModuleAddMutation, PromptModuleBindMutation, PromptModuleBinding, PromptModuleBindingKind, PromptModuleDisableMutation, PromptModuleMutation, PromptModuleMutationBase, PromptModuleMutationSet, PromptModuleMutationSource, PromptModuleMutationWhen, PromptModulePatchMutation, PromptModuleReplaceMutation, PromptModuleSelector, PromptModuleStructuredPatch, PromptModuleValidator, PromptModuleValidatorMutation, PromptModuleValidatorPhase, } from "./mutations.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/prompt-modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/prompt-modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,EACrC,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC"}

package/dist/runtime/prompt-modules/index.js

@@ -0,0 +1 @@
+export { PROMPT_MODULE_CONTRACT_SCHEMA_VERSION, } from "./model.js";

package/dist/runtime/prompt-modules/model.d.ts

@@ -0,0 +1,89 @@
+export declare const PROMPT_MODULE_CONTRACT_SCHEMA_VERSION: 1;
+export type PromptModuleContractSchemaVersion = typeof PROMPT_MODULE_CONTRACT_SCHEMA_VERSION;
+export type PromptModuleNamespace = "framework" | "project" | "runtime" | `recipe.${string}`;
+export type PromptModuleSurface = "gateway" | "policy" | "agent_profile" | "runner" | "validator" | "template";
+export type PromptModuleTarget = "AGENTS.md" | "CLAUDE.md" | ".agentplane/policy" | ".agentplane/agents" | "runner.bundle" | "recipe.manifest" | "generated.artifact";
+export type PromptModuleSlot = "frontmatter" | "purpose" | "startup" | "commands" | "load_rules" | "source_of_truth" | "hard_constraint" | "body" | "example" | "identity" | "inputs" | "outputs" | "permissions" | "workflow" | "cli_notes" | "context" | "schema" | "check" | "partial" | "file";
+export type PromptModuleAddress = {
+    /**
+     * Canonical stable address, for example
+     * `framework/gateway/AGENTS.md/load_rules/base`.
+     */
+    value: string;
+    namespace: PromptModuleNamespace;
+    surface: PromptModuleSurface;
+    target: PromptModuleTarget;
+    slot: PromptModuleSlot;
+    name: string;
+};
+export type PromptModuleOwner = {
+    kind: "framework";
+    package_name: "agentplane";
+    version?: string;
+} | {
+    kind: "project";
+    project_root?: string;
+} | {
+    kind: "recipe";
+    recipe_id: string;
+    version?: string;
+} | {
+    kind: "runtime";
+    adapter_id?: string;
+};
+export type PromptModuleContentKind = "markdown" | "json" | "text" | "typescript" | "command";
+export type PromptModuleMutability = "locked" | "replaceable" | "extendable" | "append_only";
+export type PromptModuleMergeMode = "pick_one" | "replace" | "prepend" | "append" | "merge_object" | "union_by_id";
+export type PromptModuleConflictPolicy = "error" | "highest_precedence" | "last_writer_wins" | "keep_all";
+export type PromptModuleMergePolicy = {
+    mode: PromptModuleMergeMode;
+    conflict: PromptModuleConflictPolicy;
+    precedence?: number;
+};
+export type PromptModuleLoadCondition = {
+    workflow_modes?: ("direct" | "branch_pr")[];
+    policy_gateways?: ("codex" | "claude")[];
+    roles?: string[];
+    commands?: string[];
+    task_tags_any?: string[];
+    repo_types?: string[];
+    recipe_ids?: string[];
+};
+export type PromptModuleSourceKind = "framework_builtin" | "project_file" | "recipe_asset" | "generated" | "runtime";
+export type PromptModuleProvenance = {
+    source_kind: PromptModuleSourceKind;
+    source_ref: string;
+    recipe_id?: string;
+    recipe_version?: string;
+    generated_by?: string;
+    content_hash?: string;
+};
+export type PromptModuleDependency = {
+    address: string;
+    required: boolean;
+};
+export type PromptModule<TContent = string | Record<string, unknown>> = {
+    schema_version: PromptModuleContractSchemaVersion;
+    address: PromptModuleAddress;
+    owner: PromptModuleOwner;
+    title: string;
+    summary?: string;
+    content_kind: PromptModuleContentKind;
+    content: TContent;
+    mutability: PromptModuleMutability;
+    merge: PromptModuleMergePolicy;
+    load?: PromptModuleLoadCondition;
+    dependencies?: PromptModuleDependency[];
+    provenance: PromptModuleProvenance;
+};
+export type PromptModuleReference = Pick<PromptModule, "address" | "owner" | "provenance">;
+export type PromptModuleGraphNode = {
+    module: PromptModule;
+    replaces?: string[];
+    extends?: string[];
+};
+export type PromptModuleGraph = {
+    schema_version: PromptModuleContractSchemaVersion;
+    nodes: PromptModuleGraphNode[];
+};
+//# sourceMappingURL=model.d.ts.map

package/dist/runtime/prompt-modules/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/runtime/prompt-modules/model.ts"],"names":[],"mappings":"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"}

package/dist/runtime/prompt-modules/model.js

@@ -0,0 +1 @@
+export const PROMPT_MODULE_CONTRACT_SCHEMA_VERSION = 1;

package/dist/runtime/prompt-modules/mutations.d.ts

@@ -0,0 +1,103 @@
+import type { PromptModule, PromptModuleAddress, PromptModuleDependency, PromptModuleLoadCondition, PromptModuleMergePolicy, PromptModuleMutability, PromptModuleOwner, PromptModuleProvenance, PromptModuleSlot, PromptModuleSurface, PromptModuleTarget } from "./model.js";
+export type PromptModuleSelector = {
+    address?: string;
+    namespace?: PromptModuleAddress["namespace"];
+    surface?: PromptModuleSurface;
+    target?: PromptModuleTarget;
+    slot?: PromptModuleSlot;
+    owner?: PromptModuleOwner["kind"];
+    recipe_id?: string;
+};
+export type PromptModuleMutationWhen = PromptModuleLoadCondition & {
+    module_present?: string[];
+    module_absent?: string[];
+};
+export type PromptModuleMutationSource = {
+    owner: PromptModuleOwner;
+    provenance: PromptModuleProvenance;
+};
+export type PromptModuleStructuredPatch<TContent = string | Record<string, unknown>> = {
+    title?: string;
+    summary?: string | null;
+    content?: TContent;
+    mutability?: PromptModuleMutability;
+    merge?: PromptModuleMergePolicy;
+    load?: PromptModuleLoadCondition | null;
+    dependencies?: PromptModuleDependency[] | null;
+    provenance?: PromptModuleProvenance;
+};
+export type PromptModuleBindingKind = "extends" | "replaces" | "requires" | "feeds" | "validates";
+export type PromptModuleBinding = {
+    id: string;
+    kind: PromptModuleBindingKind;
+    from: string;
+    to: string;
+    order?: number;
+    required?: boolean;
+    when?: PromptModuleMutationWhen;
+};
+export type PromptModuleValidatorPhase = "resolve" | "compile" | "emit" | "doctor";
+export type PromptModuleValidator = {
+    id: string;
+    phase: PromptModuleValidatorPhase;
+    kind: "required_module";
+    target: PromptModuleSelector;
+    required: true;
+    when?: PromptModuleMutationWhen;
+} | {
+    id: string;
+    phase: PromptModuleValidatorPhase;
+    kind: "forbidden_module";
+    target: PromptModuleSelector;
+    required: true;
+    when?: PromptModuleMutationWhen;
+} | {
+    id: string;
+    phase: PromptModuleValidatorPhase;
+    kind: "required_command";
+    command: string;
+    required: boolean;
+    when?: PromptModuleMutationWhen;
+};
+export type PromptModuleMutationBase = {
+    id: string;
+    source: PromptModuleMutationSource;
+    when?: PromptModuleMutationWhen;
+    reason?: string;
+};
+export type PromptModuleAddMutation = PromptModuleMutationBase & {
+    op: "add_module";
+    module: PromptModule;
+};
+export type PromptModuleReplaceMutation = PromptModuleMutationBase & {
+    op: "replace_module";
+    target: PromptModuleSelector;
+    module: PromptModule;
+};
+export type PromptModulePatchMutation<TContent = string | Record<string, unknown>> = PromptModuleMutationBase & {
+    op: "patch_module";
+    target: PromptModuleSelector;
+    patch: PromptModuleStructuredPatch<TContent>;
+};
+export type PromptModuleDisableMutation = PromptModuleMutationBase & {
+    op: "disable_module";
+    target: PromptModuleSelector;
+};
+export type PromptModuleBindMutation = PromptModuleMutationBase & {
+    op: "bind_module";
+    binding: PromptModuleBinding;
+};
+export type PromptModuleValidatorMutation = PromptModuleMutationBase & ({
+    op: "add_validator";
+    validator: PromptModuleValidator;
+} | {
+    op: "disable_validator";
+    validator_id: string;
+});
+export type PromptModuleMutation = PromptModuleAddMutation | PromptModuleReplaceMutation | PromptModulePatchMutation | PromptModuleDisableMutation | PromptModuleBindMutation | PromptModuleValidatorMutation;
+export type PromptModuleMutationSet = {
+    schema_version: 1;
+    recipe_id?: string;
+    mutations: PromptModuleMutation[];
+};
+//# sourceMappingURL=mutations.d.ts.map

package/dist/runtime/prompt-modules/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/runtime/prompt-modules/mutations.ts"],"names":[],"mappings":"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"}

package/dist/runtime/prompt-modules/mutations.js

@@ -0,0 +1 @@
+export {};

package/dist/shared/runtime-env.d.ts

@@ -0,0 +1,3 @@
+export declare function withPreferredRuntimePath(baseEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function resolvePreferredNodeExecutable(baseEnv?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=runtime-env.d.ts.map

package/dist/shared/runtime-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-env.d.ts","sourceRoot":"","sources":["../../src/shared/runtime-env.ts"],"names":[],"mappings":"AAUA,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,MAAM,CAAC,UAAwB,GACvC,MAAM,CAAC,UAAU,CA0BnB;AA8BD,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAe/F"}

package/dist/shared/runtime-env.js

@@ -0,0 +1,73 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+function pushUnique(entries, value) {
+    const trimmed = value.trim();
+    if (!trimmed || entries.includes(trimmed))
+        return;
+    entries.push(trimmed);
+}
+export function withPreferredRuntimePath(baseEnv = process.env) {
+    const env = { ...baseEnv };
+    const pathEntries = String(baseEnv.PATH ?? "")
+        .split(path.delimiter)
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    const preferredEntries = [];
+    pushUnique(preferredEntries, path.dirname(resolvePreferredNodeExecutable(baseEnv)));
+    const bunInstallDir = String(baseEnv.BUN_INSTALL ?? "").trim();
+    if (bunInstallDir) {
+        pushUnique(preferredEntries, path.join(bunInstallDir, "bin"));
+    }
+    const homeDir = String(baseEnv.HOME ?? os.homedir() ?? "").trim();
+    if (homeDir) {
+        pushUnique(preferredEntries, path.join(homeDir, ".bun", "bin"));
+    }
+    for (const entry of pathEntries) {
+        pushUnique(preferredEntries, entry);
+    }
+    env.PATH = preferredEntries.join(path.delimiter);
+    return env;
+}
+function isExecutableFile(filePath) {
+    try {
+        return fs.statSync(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function readLatestNvmNodeBin(homeDir) {
+    const versionsDir = path.join(homeDir, ".nvm", "versions", "node");
+    let entries = [];
+    try {
+        entries = fs.readdirSync(versionsDir);
+    }
+    catch {
+        return null;
+    }
+    const latest = entries
+        .map((entry) => entry.trim())
+        .filter(Boolean)
+        .toSorted()
+        .at(-1);
+    if (!latest)
+        return null;
+    const candidate = path.join(versionsDir, latest, "bin", "node");
+    return isExecutableFile(candidate) ? candidate : null;
+}
+export function resolvePreferredNodeExecutable(baseEnv = process.env) {
+    const homeDir = String(baseEnv.HOME ?? os.homedir() ?? "").trim();
+    const candidates = [
+        path.join(String(baseEnv.NVM_BIN ?? "").trim(), "node"),
+        path.join(String(baseEnv.VOLTA_HOME ?? "").trim(), "bin", "node"),
+        homeDir ? readLatestNvmNodeBin(homeDir) : null,
+        process.execPath,
+    ];
+    for (const candidate of candidates) {
+        if (typeof candidate === "string" && candidate.trim() && isExecutableFile(candidate)) {
+            return candidate;
+        }
+    }
+    return process.execPath;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentplane",
-  "version": "0.3.22",
+  "version": "0.3.23",
   "description": "Agent Plane CLI for task workflows, recipes, and project automation.",
   "keywords": [
     "agentplane",
@@ -56,8 +56,8 @@
     "prepublishOnly": "node ../../scripts/enforce-github-publish.mjs && npm run prepack"
   },
   "dependencies": {
-    "@agentplaneorg/core": "0.3.22",
-    "@agentplaneorg/recipes": "0.3.22",
+    "@agentplaneorg/core": "0.3.23",
+    "@agentplaneorg/recipes": "0.3.23",
     "@clack/prompts": "^1.2.0",
     "yauzl": "^2.10.0",
     "zod": "^3",