agentplane 0.3.21 → 0.3.23

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

@@ -1,12 +1,21 @@
 import { resolveProject } from "@agentplaneorg/core/project";
 import { runProcessSync } from "@agentplaneorg/core/process";
+import fs from "node:fs";
 import path from "node:path";
 import { fileExists } from "../../cli/fs-utils.js";
-import { CliError } from "../../shared/errors.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");
 }
+class HookFailure extends Error {
+    details;
+    constructor(message, details = []) {
+        super(message);
+        this.details = details;
+        this.name = "HookFailure";
+    }
+}
 export async function resolvePrePushHookScriptPath(gitRoot, opts = {}) {
     const repoScriptPath = path.join(gitRoot, "scripts", "run-pre-push-hook.mjs");
     if (await fileExists(repoScriptPath))
@@ -16,6 +25,230 @@ export async function resolvePrePushHookScriptPath(gitRoot, opts = {}) {
         return bundledScriptPath;
     return null;
 }
+function parsePrePushStdin(rawStdin) {
+    return rawStdin
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((line) => {
+        const [localRef = "", localSha = "", remoteRef = "", remoteSha = ""] = line.split(/\s+/);
+        return { localRef, localSha, remoteRef, remoteSha };
+    });
+}
+function isAllZeroSha(value) {
+    return /^[0]+$/.test(value);
+}
+function isBranchRef(ref) {
+    return ref.startsWith("refs/heads/");
+}
+function runHookCommand(gitRoot, command, args) {
+    const result = runProcessSync({
+        command,
+        args,
+        cwd: gitRoot,
+        env: withPreferredRuntimePath(process.env),
+        stdout: "inherit",
+        stderr: "inherit",
+        reject: false,
+    });
+    return result.exitCode ?? (result.signal ? 1 : 0);
+}
+function runHookCommandWithEnv(gitRoot, command, args, env) {
+    const result = runProcessSync({
+        command,
+        args,
+        cwd: gitRoot,
+        env,
+        stdout: "inherit",
+        stderr: "inherit",
+        reject: false,
+    });
+    return result.exitCode ?? (result.signal ? 1 : 0);
+}
+function readGitText(gitRoot, args) {
+    const result = runProcessSync({
+        command: "git",
+        args,
+        cwd: gitRoot,
+        encoding: "utf8",
+        reject: false,
+    });
+    if (result.exitCode !== 0)
+        return "";
+    return String(result.stdout ?? "").trim();
+}
+function readPackageScripts(gitRoot) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(path.join(gitRoot, "package.json"), "utf8"));
+        if (!parsed.scripts || typeof parsed.scripts !== "object" || Array.isArray(parsed.scripts)) {
+            return {};
+        }
+        const scripts = {};
+        for (const [name, value] of Object.entries(parsed.scripts)) {
+            if (typeof value === "string")
+                scripts[name] = value;
+        }
+        return scripts;
+    }
+    catch {
+        return {};
+    }
+}
+function hasProjectScript(scripts, name) {
+    return Object.hasOwn(scripts, name);
+}
+function runOptionalProjectScript(gitRoot, scripts, name, opts = {}) {
+    if (!hasProjectScript(scripts, name)) {
+        process.stdout.write(`Skipping ${name}: package.json script is not defined.\n`);
+        return { exitCode: 0, skipped: true };
+    }
+    if (opts.heading)
+        process.stdout.write(opts.heading);
+    const exitCode = opts.env
+        ? runHookCommandWithEnv(gitRoot, "bun", ["run", name], opts.env)
+        : runHookCommand(gitRoot, "bun", ["run", name]);
+    return { exitCode, skipped: false };
+}
+function trackedChangesShort(gitRoot) {
+    return readGitText(gitRoot, ["status", "--short", "--untracked-files=no"]);
+}
+function fail(message, details = []) {
+    throw new HookFailure(message, details);
+}
+function failIfTrackedChanges(gitRoot, message) {
+    const changes = trackedChangesShort(gitRoot);
+    if (!changes)
+        return;
+    fail(message, [changes]);
+}
+function gitRefExists(gitRoot, ref) {
+    return readGitText(gitRoot, ["rev-parse", "--verify", "--quiet", ref]).length > 0;
+}
+function hasReleaseTagPush(updates) {
+    return updates.some((update) => update.remoteRef.startsWith("refs/tags/"));
+}
+function isDeleteOnlyPush(updates) {
+    return (updates.length > 0 &&
+        updates.every((update) => isBranchRef(update.remoteRef) && isAllZeroSha(update.localSha) && Boolean(update.remoteSha)));
+}
+function resolveDefaultBaseRef(gitRoot) {
+    const remoteHead = readGitText(gitRoot, [
+        "symbolic-ref",
+        "--quiet",
+        "--short",
+        "refs/remotes/origin/HEAD",
+    ]);
+    if (remoteHead)
+        return remoteHead;
+    if (gitRefExists(gitRoot, "origin/main"))
+        return "origin/main";
+    if (gitRefExists(gitRoot, "main"))
+        return "main";
+    return null;
+}
+function selectBranchDiffRange(updates, opts = {}) {
+    const branchUpdates = updates.filter((update) => isBranchRef(update.localRef) && isBranchRef(update.remoteRef));
+    if (branchUpdates.length !== 1)
+        return null;
+    const [update] = branchUpdates;
+    if (!update?.localSha || !update.remoteSha)
+        return null;
+    if (isAllZeroSha(update.localSha))
+        return null;
+    if (isAllZeroSha(update.remoteSha)) {
+        const fallbackRef = typeof opts.newBranchFallbackRef === "string" ? opts.newBranchFallbackRef.trim() : "";
+        return fallbackRef ? { from: fallbackRef, to: update.localSha } : null;
+    }
+    return { from: update.remoteSha, to: update.localSha };
+}
+function readChangedFilesForRange(gitRoot, range) {
+    if (!range)
+        return [];
+    const output = readGitText(gitRoot, ["diff", "--name-only", `${range.from}..${range.to}`]);
+    return output
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+}
+function fileExistsSync(filePath) {
+    try {
+        return fs.statSync(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function isTruthyHookEnv(name) {
+    return (String(process.env[name] ?? "")
+        .trim()
+        .toLowerCase() === "1");
+}
+function runInternalPrePushHook(gitRoot, stdin) {
+    try {
+        const updates = parsePrePushStdin(stdin);
+        const envRelease = isTruthyHookEnv("AGENTPLANE_HOOKS_RELEASE");
+        const envFull = isTruthyHookEnv("AGENTPLANE_HOOKS_FULL");
+        const isReleasePush = envRelease || envFull || hasReleaseTagPush(updates);
+        if (!isReleasePush && isDeleteOnlyPush(updates)) {
+            process.stdout.write("Skipping pre-push checks for delete-only remote branch cleanup.\n");
+            return 0;
+        }
+        const mode = isReleasePush ? "release" : "standard";
+        process.stdout.write(`Running pre-push checks in ${mode} mode.\n`);
+        const ciScript = envFull ? "ci:local:full" : "ci:local:fast";
+        const scripts = readPackageScripts(gitRoot);
+        const changedFiles = readChangedFilesForRange(gitRoot, selectBranchDiffRange(updates, {
+            newBranchFallbackRef: resolveDefaultBaseRef(gitRoot),
+        }));
+        const ciEnv = changedFiles.length > 0
+            ? { ...process.env, AGENTPLANE_FAST_CHANGED_FILES: changedFiles.join("\n") }
+            : process.env;
+        const formatResult = runOptionalProjectScript(gitRoot, scripts, "format:check", {
+            heading: "\n== Format (check) ==\n",
+        });
+        if (formatResult.exitCode !== 0) {
+            failIfTrackedChanges(gitRoot, "pre-push blocked: format:check changed tracked files unexpectedly. Revert or commit those changes and push again.");
+            fail("pre-push blocked: formatting check failed. Run `bun run format`, review the diff, commit it, and push again.");
+        }
+        if (!formatResult.skipped) {
+            failIfTrackedChanges(gitRoot, "pre-push blocked: format:check changed tracked files unexpectedly. Revert or commit those changes and push again.");
+        }
+        const ciResult = runOptionalProjectScript(gitRoot, scripts, ciScript, { env: ciEnv });
+        if (!ciResult.skipped) {
+            failIfTrackedChanges(gitRoot, `pre-push blocked: ${ciScript} changed tracked files. Commit or revert those changes and push again.`);
+        }
+        if (ciResult.exitCode !== 0) {
+            fail(`pre-push blocked: ${ciScript} failed. Fix the reported checks and push again.`);
+        }
+        if (isReleasePush) {
+            const releaseNotesScript = path.join(gitRoot, "scripts", "check-release-notes.mjs");
+            if (fileExistsSync(releaseNotesScript)) {
+                const notesExitCode = runHookCommand(gitRoot, resolvePreferredNodeExecutable(process.env), [
+                    "scripts/check-release-notes.mjs",
+                ]);
+                if (notesExitCode !== 0)
+                    return notesExitCode;
+            }
+            else {
+                process.stdout.write("Skipping release notes check: scripts/check-release-notes.mjs is not defined.\n");
+            }
+            return runOptionalProjectScript(gitRoot, scripts, "release:prepublish").exitCode;
+        }
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof HookFailure) {
+            process.stderr.write(`\n${error.message}\n`);
+            for (const detail of error.details) {
+                if (!detail)
+                    continue;
+                process.stderr.write(`${detail}\n`);
+            }
+            return 1;
+        }
+        throw error;
+    }
+}
 async function readHookStdinUtf8(timeoutMs = 25) {
     if (process.stdin.isTTY)
         return "";
@@ -59,19 +292,10 @@ export async function runPrePushHook(opts) {
         cwd: opts.cwd,
         rootOverride: opts.rootOverride ?? null,
     });
+    const stdin = await readHookStdinUtf8();
     const scriptPath = await resolvePrePushHookScriptPath(resolved.gitRoot);
     if (!scriptPath) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: [
-                "Missing pre-push hook script: scripts/run-pre-push-hook.mjs",
-                "The pre-push hook needs a repository-local script or an installed CLI bundle that ships the fallback.",
-                "Fix:",
-                "  1) Restore scripts/run-pre-push-hook.mjs in this repository, or",
-                "  2) Run `agentplane hooks uninstall` if this repository should not use the agentplane pre-push gate.",
-            ].join("\n"),
-        });
+        return runInternalPrePushHook(resolved.gitRoot, stdin);
     }
     const result = runProcessSync({
         command: "node",
@@ -79,7 +303,7 @@ export async function runPrePushHook(opts) {
         cwd: resolved.gitRoot,
         env: process.env,
         encoding: "utf8",
-        input: await readHookStdinUtf8(),
+        input: stdin,
         stdin: "pipe",
         stdout: "inherit",
         stderr: "inherit",

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/commands/task/derive.command.js

@@ -55,7 +55,7 @@ export const taskDeriveSpec = {
     ],
     examples: [
         {
-            cmd: 'agentplane task derive 202602070101-ABCD --title "Implement X" --description "Do the thing" --owner CODER --tag code --verify "bun test"',
+            cmd: 'agentplane task derive 202602070101-ABCD --title "Implement X" --description "Do the thing" --owner CODER --tag code --verify "bun run test:project -- cli-core"',
             why: "Create an implementation task derived from a spike with seeded verify steps.",
         },
     ],

package/dist/commands/task/finish-execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finish-execute.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish-execute.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAmBhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE5E,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,mBAAmB,CAAC;CAC3B,GAAG,OAAO,CAAC,MAAM,CAAC,CAuGlB"}
+{"version":3,"file":"finish-execute.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish-execute.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAmBhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE5E,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,mBAAmB,CAAC;CAC3B,GAAG,OAAO,CAAC,MAAM,CAAC,CA6GlB"}

package/dist/commands/task/finish-execute.js

@@ -22,7 +22,14 @@ export async function executeFinishPlan(opts) {
         throw new CliError({
             exitCode: 2,
             code: "E_USAGE",
-            message: "finish requires --commit <hash> or existing task commit metadata on every task; implicit HEAD fallback was removed.",
+            message: [
+                "finish requires --commit <hash> or existing task commit metadata on every task; implicit HEAD fallback was removed.",
+                `tasks_missing_commit=${tasksMissingCommit.join(", ")}`,
+                "Fix:",
+                "  1) Select the implementation commit explicitly: git log --oneline --decorate -n 10",
+                '  2) Re-run finish with: agentplane finish <task-id> --author <ROLE> --body "Verified: ..." --result "..." --commit <hash>',
+                "  3) If the implementation is still unstaged, use --commit-from-comment with explicit --commit-allow <path-prefix> instead of relying on HEAD.",
+            ].join("\n"),
         });
     }
     if (options.commitFromComment || plan.statusCommitRequested) {

package/dist/commands/task/shared/transitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AASnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAGlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAOnE,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAc3F;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAmBN;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAKP;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAKxF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAgB7F;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG;IACF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CASA;AAED,wBAAsB,kCAAkC,CAAC,IAAI,EAAE;IAC7D,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,iBAAiB,CAAC,CAAC;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ9B;AAED,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuC/D;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5F;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAKP;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMlE"}
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AASnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAGlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAOnE,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAc3F;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAmBN;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAKP;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAKxF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAyB7F;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG;IACF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CASA;AAED,wBAAsB,kCAAkC,CAAC,IAAI,EAAE;IAC7D,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,iBAAiB,CAAC,CAAC;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ9B;AAED,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuC/D;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5F;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAKP;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMlE"}

package/dist/commands/task/shared/transitions.js

@@ -60,14 +60,23 @@ export function requireStructuredComment(body, prefix, minChars) {
         throw new CliError({
             exitCode: 2,
             code: "E_USAGE",
-            message: `Comment body must start with ${prefix}`,
+            message: [
+                `Comment body must start with ${prefix}`,
+                `actual_start=${JSON.stringify(normalized.slice(0, Math.max(prefix.length, 1)))}`,
+                `actual_length=${normalized.length}; minimum_length=${minChars}`,
+                `Fix: pass --body "${prefix} <specific verification or start note at least ${minChars} characters long>"`,
+            ].join("\n"),
         });
     }
     if (normalized.length < minChars) {
         throw new CliError({
             exitCode: 2,
             code: "E_USAGE",
-            message: `Comment body must be at least ${minChars} characters`,
+            message: [
+                `Comment body must be at least ${minChars} characters`,
+                `actual_length=${normalized.length}; minimum_length=${minChars}; required_prefix=${prefix}`,
+                `Fix: expand --body "${prefix} <specific verification or start note at least ${minChars} characters long>"`,
+            ].join("\n"),
         });
     }
 }

package/dist/commands/task/verify-command-shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify-command-shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-command-shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEjF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAAS,UAAU,EA+D5C,CAAC;AAEX,eAAO,MAAM,mBAAmB,EAAE,SAAS,UAAU,EAwC3C,CAAC;AAEX,wBAAgB,kCAAkC,CAAC,OAAO,EACxD,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,IAAI,CAQN;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EACjD,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,EAAE,IAAI,GAAG,MAAM,GAClB,IAAI,CAKN;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAC9C,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,IAAI,CA+BN;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EACjD,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,IAAI,CAkCN;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,GAAG,kBAAkB,CAuB3E"}
+{"version":3,"file":"verify-command-shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-command-shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEjF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAAS,UAAU,EA+D5C,CAAC;AAEX,eAAO,MAAM,mBAAmB,EAAE,SAAS,UAAU,EAwC3C,CAAC;AAEX,wBAAgB,kCAAkC,CAAC,OAAO,EACxD,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,IAAI,CAQN;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EACjD,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,EAAE,IAAI,GAAG,MAAM,GAClB,IAAI,CAKN;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAC9C,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,IAAI,CA+BN;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EACjD,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,IAAI,CAyCN;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,GAAG,kBAAkB,CAuB3E"}

package/dist/commands/task/verify-command-shared.js

@@ -151,6 +151,13 @@ export function validateVerifyNoteSource(raw, spec, opts) {
     }
 }
 export function validateVerifyFindingSource(raw, spec, opts) {
+    if (raw.opts["local-only"] === true && raw.opts["repo-fixable"] === true) {
+        throw usageError({
+            spec,
+            command: opts?.command,
+            message: "--local-only cannot be combined with --repo-fixable.",
+        });
+    }
     const hasFindingField = [
         raw.opts.observation,
         raw.opts.impact,
@@ -162,8 +169,7 @@ export function validateVerifyFindingSource(raw, spec, opts) {
     const hasFindingCollections = Array.isArray(raw.opts["incident-tag"]) && raw.opts["incident-tag"].length > 0
         ? true
         : Array.isArray(raw.opts["incident-match"]) && raw.opts["incident-match"].length > 0;
-    const hasFindingToggle = raw.opts["local-only"] === true || raw.opts["repo-fixable"] === true;
-    if (!hasFindingField && !hasFindingCollections && !hasFindingToggle)
+    if (!hasFindingField && !hasFindingCollections)
         return;
     const observation = raw.opts.observation;
     const impact = raw.opts.impact;

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";