agentplane 0.3.13 → 0.3.15

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

@@ -0,0 +1,371 @@
+import path from "node:path";
+import { extractTaskSuffix, loadConfig, resolveProject, } from "@agentplaneorg/core";
+import { createCliEmitter, emitCommandResult } from "../../cli/output.js";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { usageError } from "../../cli/spec/errors.js";
+import { withDiagnosticContext } from "../../shared/diagnostics.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+import { GitContext } from "../shared/git-context.js";
+import { ensureActionApproved } from "../shared/approval-requirements.js";
+import { ensureNetworkApproved } from "../shared/network-approval.js";
+import { runOperatorPipeline } from "../shared/operator-pipeline.js";
+import { parseTaskIdFromBranch } from "../shared/git-worktree.js";
+import { cleanHookEnv, maybePersistExpectedCliVersion, maybeRefreshGeneratedReference, maybeUpdateBunLockfile, replaceAgentplanePackageMetadata, replacePackageDependencyVersion, replacePackageVersionInFile, } from "./apply.mutation.js";
+import { ensureCleanTrackedTree, ensureNpmVersionsAvailable, ensureRemoteExists, ensureRemoteTagDoesNotExist, ensureTagDoesNotExist, fileExists, loadReleasePlan, readAgentplaneDependencyVersion, readCoreDependencyVersion, readPackageVersion, readRecipesDependencyVersion, runReleasePrepublishGate, validateReleaseNotes, } from "./apply.preflight.js";
+import { pushReleaseCandidateBranch, pushReleaseRefs, writeReleaseApplyReport, } from "./apply.reporting.js";
+const output = createCliEmitter();
+function emitReleaseLine(text) {
+    emitCommandResult(output, { kind: "line", text });
+}
+async function resolveReleasePlanInputs(opts) {
+    const { planDir, plan, minBullets } = await loadReleasePlan({
+        gitRoot: opts.gitRoot,
+        planOverride: opts.planOverride,
+    });
+    if (!/^v\d+\.\d+\.\d+$/u.test(plan.nextTag)) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Invalid nextTag in version.json (expected vX.Y.Z): ${plan.nextTag}`,
+        });
+    }
+    const notesPath = path.join(opts.gitRoot, "docs", "releases", `${plan.nextTag}.md`);
+    if (!(await fileExists(notesPath))) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: `Missing release notes: ${path.relative(opts.gitRoot, notesPath)}\n` +
+                "Write this file using a DOCS agent before applying the release.",
+        });
+    }
+    await validateReleaseNotes(notesPath, minBullets);
+    return { planDir, plan, notesPath };
+}
+async function ensureReleasePlanMatchesRepoState(opts) {
+    const [coreVersion, agentplaneVersion, recipesVersion, coreDependencyVersion, recipesDependencyVersion,] = await Promise.all([
+        readPackageVersion(opts.corePkgPath),
+        readPackageVersion(opts.agentplanePkgPath),
+        readPackageVersion(opts.recipesPkgPath),
+        readCoreDependencyVersion(opts.agentplanePkgPath),
+        readRecipesDependencyVersion(opts.agentplanePkgPath),
+    ]);
+    if (coreVersion !== agentplaneVersion || coreVersion !== recipesVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Package versions must match before applying a release. ` +
+                `packages/core=${coreVersion} packages/agentplane=${agentplaneVersion} packages/recipes=${recipesVersion}`,
+        });
+    }
+    if (coreDependencyVersion !== coreVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Release dependency parity check failed before apply. " +
+                `packages/agentplane dependency @agentplaneorg/core=${coreDependencyVersion} ` +
+                `must match packages/core version ${coreVersion}.`,
+        });
+    }
+    if (recipesDependencyVersion !== coreVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Release dependency parity check failed before apply. " +
+                `packages/agentplane dependency @agentplaneorg/recipes=${recipesDependencyVersion} ` +
+                `must match packages/recipes version ${coreVersion}.`,
+        });
+    }
+    if (await fileExists(opts.testkitPkgPath)) {
+        const testkitAgentplaneDependencyVersion = await readAgentplaneDependencyVersion(opts.testkitPkgPath);
+        if (testkitAgentplaneDependencyVersion !== agentplaneVersion) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_VALIDATION"),
+                code: "E_VALIDATION",
+                message: "Release dependency parity check failed before apply. " +
+                    `packages/testkit dependency agentplane=${testkitAgentplaneDependencyVersion} ` +
+                    `must match packages/agentplane version ${agentplaneVersion}.`,
+            });
+        }
+    }
+    await ensureCleanTrackedTree(opts.gitRoot);
+    await ensureTagDoesNotExist(opts.gitRoot, opts.plan.nextTag);
+    if (coreVersion !== opts.plan.prevVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Current version does not match the release-plan baseline. ` +
+                `current=${coreVersion} expected_prev=${opts.plan.prevVersion} expected_next=${opts.plan.nextVersion}\n` +
+                "Re-run `agentplane release plan` to generate a fresh plan for this repo state.",
+            context: withDiagnosticContext({ command: "release apply" }, {
+                state: "the repository version no longer matches the prepared release-plan baseline",
+                likelyCause: "package versions changed after the plan was generated, so continuing would apply the release over a partially drifted local state",
+                nextAction: {
+                    command: "agentplane release plan",
+                    reason: "generate a fresh release plan from the current repository state before applying the release",
+                    reasonCode: "release_plan_drifted",
+                },
+            }),
+        });
+    }
+}
+async function runPushPreflight(opts) {
+    const loaded = await loadConfig(opts.agentplaneDir);
+    const pushReason = opts.route.kind === "release_candidate"
+        ? `${opts.commandLabel} will push current branch ${opts.route.current_branch} to ${opts.remote} as a release candidate for ${opts.nextTag}; final publication remains gated on merge to ${opts.route.base_branch}`
+        : `${opts.commandLabel} will push HEAD and ${opts.nextTag} to ${opts.remote}`;
+    await ensureNetworkApproved({
+        action: opts.route.kind === "release_candidate" ? "release_candidate" : "release_apply",
+        config: loaded.config,
+        yes: opts.yes,
+        reason: `${opts.commandLabel} validates npm version availability and pushes over network`,
+        interactive: Boolean(process.stdin.isTTY),
+    });
+    await ensureActionApproved({
+        action: "git_push",
+        config: loaded.config,
+        yes: opts.yes,
+        reason: pushReason,
+        interactive: Boolean(process.stdin.isTTY),
+    });
+    await ensureRemoteExists(opts.gitRoot, opts.remote);
+    await ensureRemoteTagDoesNotExist(opts.gitRoot, opts.remote, opts.nextTag);
+    await ensureNpmVersionsAvailable(opts.gitRoot, opts.nextVersion);
+    await runReleasePrepublishGate(opts.gitRoot);
+    return true;
+}
+async function applyReleaseMutation(opts) {
+    let releaseCommit = null;
+    await Promise.all([
+        replacePackageVersionInFile(opts.corePkgPath, opts.nextVersion),
+        replacePackageVersionInFile(opts.recipesPkgPath, opts.nextVersion),
+        replaceAgentplanePackageMetadata(opts.agentplanePkgPath, opts.nextVersion),
+    ]);
+    if (await fileExists(opts.testkitPkgPath)) {
+        await replacePackageDependencyVersion(opts.testkitPkgPath, "agentplane", opts.nextVersion);
+    }
+    const expectedCliVersionPersisted = await maybePersistExpectedCliVersion(opts.agentplaneDir, opts.nextVersion);
+    await maybeUpdateBunLockfile(opts.gitRoot, fileExists);
+    const generatedReferenceExists = await maybeRefreshGeneratedReference(opts.gitRoot, fileExists);
+    const stagePaths = [
+        "packages/core/package.json",
+        "packages/agentplane/package.json",
+        "packages/recipes/package.json",
+        path.relative(opts.gitRoot, opts.notesPath),
+    ];
+    if (await fileExists(opts.testkitPkgPath)) {
+        stagePaths.push("packages/testkit/package.json");
+    }
+    if (expectedCliVersionPersisted) {
+        stagePaths.push(".agentplane/config.json");
+    }
+    if (generatedReferenceExists) {
+        stagePaths.push("docs/reference/generated-reference.mdx");
+    }
+    if (await fileExists(path.join(opts.gitRoot, "bun.lock"))) {
+        stagePaths.push("bun.lock");
+    }
+    await opts.git.stage(stagePaths);
+    const staged = await opts.git.statusStagedPaths();
+    if (staged.length === 0) {
+        emitReleaseLine("No changes to commit.");
+        return { releaseCommit };
+    }
+    const taskId = opts.route.kind === "release_candidate"
+        ? parseTaskIdFromBranch(opts.taskBranchPrefix, opts.route.current_branch)
+        : null;
+    const subject = taskId
+        ? `✨ ${extractTaskSuffix(taskId)} release: publish ${opts.nextTag}`
+        : `✨ release: publish ${opts.nextTag}`;
+    await opts.git.commit({ message: subject, env: cleanHookEnv() });
+    const { stdout: headHash } = await execFileAsync("git", ["rev-parse", "HEAD"], {
+        cwd: opts.gitRoot,
+        env: gitEnv(),
+    });
+    releaseCommit = { hash: String(headHash ?? "").trim(), subject };
+    return { releaseCommit };
+}
+async function finalizeReleaseApply(opts) {
+    const tagCreated = opts.route.kind === "direct_release";
+    const pushedRefs = [];
+    if (tagCreated) {
+        await execFileAsync("git", ["tag", opts.plan.nextTag], {
+            cwd: opts.gitRoot,
+            env: gitEnv(),
+        });
+        emitReleaseLine(`Release tag created: ${opts.plan.nextTag}`);
+    }
+    else {
+        emitReleaseLine(`Release candidate prepared on ${opts.route.current_branch}; skipped local tag creation for ${opts.plan.nextTag} because final publication is deferred until merge to ${opts.route.base_branch}.`);
+    }
+    if (opts.push) {
+        if (opts.route.kind === "release_candidate") {
+            await pushReleaseCandidateBranch(opts.gitRoot, opts.remote);
+            pushedRefs.push("HEAD");
+            emitReleaseLine(`Pushed: ${opts.remote} ${opts.route.current_branch} (release candidate branch only; no tag pushed)`);
+        }
+        else {
+            await pushReleaseRefs(opts.gitRoot, opts.remote, opts.plan.nextTag);
+            pushedRefs.push("HEAD", opts.plan.nextTag);
+            emitReleaseLine(`Pushed: ${opts.remote} HEAD + ${opts.plan.nextTag}`);
+        }
+    }
+    else if (opts.route.kind === "release_candidate") {
+        emitReleaseLine(`Next: git push <remote> HEAD  # merge ${opts.route.current_branch} into ${opts.route.base_branch} before publishing ${opts.plan.nextTag}`);
+    }
+    else {
+        emitReleaseLine(`Next: git push <remote> HEAD && git push <remote> ${opts.plan.nextTag}`);
+    }
+    const reportPath = await writeReleaseApplyReport(opts.gitRoot, {
+        applied_at: new Date().toISOString(),
+        plan_dir: path.relative(opts.gitRoot, opts.planDir),
+        notes_path: path.relative(opts.gitRoot, opts.notesPath),
+        prev_version: opts.plan.prevVersion,
+        next_version: opts.plan.nextVersion,
+        prev_tag: opts.plan.prevTag,
+        next_tag: opts.plan.nextTag,
+        bump: opts.plan.bump,
+        checks: {
+            clean_tracked_tree: true,
+            tag_absent: true,
+            notes_validated: true,
+            npm_version_available_checked: opts.npmVersionChecked,
+        },
+        commit: opts.releaseCommit,
+        route: opts.route,
+        tag: {
+            name: opts.plan.nextTag,
+            created: tagCreated,
+            pushed: tagCreated && opts.push,
+        },
+        push: {
+            requested: opts.push,
+            remote: opts.remote,
+            performed: pushedRefs.length > 0,
+            refs: pushedRefs,
+        },
+    });
+    emitReleaseLine(`Release report: ${path.relative(opts.gitRoot, reportPath)}`);
+    return 0;
+}
+async function buildReleaseCommandState(opts) {
+    const resolved = await resolveProject({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+    });
+    const gitRoot = resolved.gitRoot;
+    const { planDir, plan, notesPath } = await resolveReleasePlanInputs({
+        gitRoot,
+        planOverride: opts.planOverride,
+    });
+    const loaded = await loadConfig(resolved.agentplaneDir);
+    return {
+        resolved,
+        gitRoot,
+        planDir,
+        plan,
+        notesPath,
+        taskBranchPrefix: loaded.config.branch.task_prefix,
+        route: await opts.routeResolver({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+            gitRoot,
+            agentplaneDir: resolved.agentplaneDir,
+        }),
+        corePkgPath: path.join(gitRoot, "packages", "core", "package.json"),
+        agentplanePkgPath: path.join(gitRoot, "packages", "agentplane", "package.json"),
+        recipesPkgPath: path.join(gitRoot, "packages", "recipes", "package.json"),
+        testkitPkgPath: path.join(gitRoot, "packages", "testkit", "package.json"),
+        npmVersionChecked: false,
+    };
+}
+function assertReleaseBumpApproved(opts) {
+    if ((opts.plan.bump === "minor" || opts.plan.bump === "major") && opts.flags.yes !== true) {
+        throw usageError({
+            spec: opts.spec,
+            command: opts.commandLabel,
+            message: `Bump '${opts.plan.bump}' requires explicit approval. Re-run with --yes.`,
+        });
+    }
+}
+async function runReleaseCommandPreflight(opts) {
+    assertReleaseBumpApproved({
+        flags: opts.flags,
+        plan: opts.state.plan,
+        spec: opts.spec,
+        commandLabel: opts.commandLabel,
+    });
+    await ensureReleasePlanMatchesRepoState({
+        gitRoot: opts.state.gitRoot,
+        plan: opts.state.plan,
+        corePkgPath: opts.state.corePkgPath,
+        agentplanePkgPath: opts.state.agentplanePkgPath,
+        recipesPkgPath: opts.state.recipesPkgPath,
+        testkitPkgPath: opts.state.testkitPkgPath,
+    });
+    if (opts.flags.push) {
+        opts.state.npmVersionChecked = await runPushPreflight({
+            agentplaneDir: opts.state.resolved.agentplaneDir,
+            gitRoot: opts.state.gitRoot,
+            remote: opts.flags.remote,
+            nextTag: opts.state.plan.nextTag,
+            nextVersion: opts.state.plan.nextVersion,
+            route: opts.state.route,
+            yes: opts.flags.yes,
+            commandLabel: `${opts.commandLabel} --push`,
+        });
+    }
+}
+async function runReleaseCommandExecute(state) {
+    const git = new GitContext({ gitRoot: state.gitRoot });
+    return await applyReleaseMutation({
+        agentplaneDir: state.resolved.agentplaneDir,
+        gitRoot: state.gitRoot,
+        git,
+        notesPath: state.notesPath,
+        corePkgPath: state.corePkgPath,
+        agentplanePkgPath: state.agentplanePkgPath,
+        recipesPkgPath: state.recipesPkgPath,
+        testkitPkgPath: state.testkitPkgPath,
+        nextTag: state.plan.nextTag,
+        nextVersion: state.plan.nextVersion,
+        route: state.route,
+        taskBranchPrefix: state.taskBranchPrefix,
+    });
+}
+async function runReleaseCommandFinalize(opts) {
+    return await finalizeReleaseApply({
+        gitRoot: opts.state.gitRoot,
+        planDir: opts.state.planDir,
+        notesPath: opts.state.notesPath,
+        plan: opts.state.plan,
+        npmVersionChecked: opts.state.npmVersionChecked,
+        releaseCommit: opts.mutation.releaseCommit,
+        route: opts.state.route,
+        push: opts.flags.push,
+        remote: opts.flags.remote,
+    });
+}
+export async function runReleaseCommandPipeline(opts) {
+    return await runOperatorPipeline({
+        init: async () => await buildReleaseCommandState({
+            cwd: opts.ctx.cwd,
+            rootOverride: opts.ctx.rootOverride ?? null,
+            planOverride: opts.flags.plan,
+            routeResolver: opts.routeResolver,
+        }),
+        preflight: async (state) => await runReleaseCommandPreflight({
+            state,
+            flags: opts.flags,
+            spec: opts.spec,
+            commandLabel: opts.commandLabel,
+        }),
+        execute: async (state) => await runReleaseCommandExecute(state),
+        finalize: async (state, mutation) => await runReleaseCommandFinalize({
+            state,
+            mutation,
+            flags: opts.flags,
+        }),
+    });
+}
+export { pushReleaseCandidateBranch, pushReleaseRefs } from "./apply.reporting.js";

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

@@ -5,6 +5,8 @@ export declare function parseVersionPlan(raw: unknown): ReleaseVersionPlan;
 export declare function findLatestPlanDir(gitRoot: string): Promise<string>;
 export declare function readPackageVersion(pkgJsonPath: string): Promise<string>;
 export declare function readCoreDependencyVersion(pkgJsonPath: string): Promise<string>;
+export declare function readRecipesDependencyVersion(pkgJsonPath: string): Promise<string>;
+export declare function readAgentplaneDependencyVersion(pkgJsonPath: string): Promise<string>;
 export declare function validateReleaseNotes(notesPath: string, minBullets: number): Promise<void>;
 export declare function ensureCleanTrackedTree(gitRoot: string): Promise<void>;
 export declare function ensureTagDoesNotExist(gitRoot: string, tag: string): Promise<void>;

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":"AAQA,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;AAED,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBpF;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/F;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC3E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BvF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BvF;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAyDf;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChG;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7E;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":"AAQA,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,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/F;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC3E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BvF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BvF;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAyDf;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChG;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7E;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

@@ -79,20 +79,29 @@ export async function readPackageVersion(pkgJsonPath) {
     }
     return version;
 }
-export async function readCoreDependencyVersion(pkgJsonPath) {
+async function readDependencyVersion(pkgJsonPath, dependencyName) {
     const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
-    const value = raw.dependencies?.["@agentplaneorg/core"];
+    const value = raw.dependencies?.[dependencyName];
     const version = typeof value === "string" ? value.trim() : "";
     if (!version) {
         throw new CliError({
             exitCode: exitCodeForError("E_VALIDATION"),
             code: "E_VALIDATION",
-            message: `Missing dependency @agentplaneorg/core in ${pkgJsonPath}. ` +
-                "Release parity requires packages/agentplane to pin @agentplaneorg/core to the same version.",
+            message: `Missing dependency ${dependencyName} in ${pkgJsonPath}. ` +
+                `Release parity requires packages/agentplane to pin ${dependencyName} to the same version.`,
         });
     }
     return version;
 }
+export async function readCoreDependencyVersion(pkgJsonPath) {
+    return await readDependencyVersion(pkgJsonPath, "@agentplaneorg/core");
+}
+export async function readRecipesDependencyVersion(pkgJsonPath) {
+    return await readDependencyVersion(pkgJsonPath, "@agentplaneorg/recipes");
+}
+export async function readAgentplaneDependencyVersion(pkgJsonPath) {
+    return await readDependencyVersion(pkgJsonPath, "agentplane");
+}
 export async function validateReleaseNotes(notesPath, minBullets) {
     const content = await readFile(notesPath, "utf8");
     if (!/release\s+notes/i.test(content)) {

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

@@ -1,3 +1,4 @@
+import type { ResolvedProject } from "@agentplaneorg/core";
 export type BumpKind = "patch" | "minor" | "major";
 export type ReleaseApplyFlags = {
     plan?: string;
@@ -56,4 +57,30 @@ export type ReleaseApplyReport = {
         refs: string[];
     };
 };
+export type ReleaseCommandState = {
+    resolved: ResolvedProject;
+    gitRoot: string;
+    planDir: string;
+    plan: ReleaseVersionPlan;
+    notesPath: string;
+    taskBranchPrefix: string;
+    route: ReleaseApplyRoute;
+    corePkgPath: string;
+    agentplanePkgPath: string;
+    recipesPkgPath: string;
+    testkitPkgPath: string;
+    npmVersionChecked: boolean;
+};
+export type ReleaseCommandMutation = {
+    releaseCommit: {
+        hash: string;
+        subject: string;
+    } | null;
+};
+export type ReleaseCommandRouteResolver = (opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    gitRoot: string;
+    agentplaneDir: string;
+}) => Promise<ReleaseApplyRoute>;
 //# sourceMappingURL=apply.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"apply.types.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;IAC7C,aAAa,EAAE,QAAQ,GAAG,WAAW,CAAC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE;QACN,kBAAkB,EAAE,IAAI,CAAC;QACzB,UAAU,EAAE,IAAI,CAAC;QACjB,eAAe,EAAE,IAAI,CAAC;QACtB,6BAA6B,EAAE,OAAO,CAAC;KACxC,CAAC;IACF,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,KAAK,EAAE,iBAAiB,CAAC;IACzB,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IACzD,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAClF,CAAC"}
+{"version":3,"file":"apply.types.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.types.ts"],"names":[],"mappings":"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"}

package/dist/commands/release.test-helpers.d.ts

@@ -3,7 +3,9 @@ export declare function writeReleaseNotes(root: string, version: string, body?:
 export declare function seedReleaseWorkspace(root: string, opts?: {
     coreVersion?: string;
     cliVersion?: string;
+    recipesVersion?: string;
     dependencyVersion?: string;
+    recipesDependencyVersion?: string;
     extraDependencies?: Record<string, string>;
     extraWorkspacePackages?: {
         relDir: string;
@@ -19,7 +21,9 @@ export declare function initReleaseWorkspace(opts?: {
     prefix?: string;
     coreVersion?: string;
     cliVersion?: string;
+    recipesVersion?: string;
     dependencyVersion?: string;
+    recipesDependencyVersion?: string;
     extraDependencies?: Record<string, string>;
     extraWorkspacePackages?: {
         relDir: string;

package/dist/commands/release.test-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"release.test-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/release.test-helpers.ts"],"names":[],"mappings":"AAIA,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,SAAc,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,sBAAsB,CAAC,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,oBAAoB,CACxC,IAAI,GAAE;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,sBAAsB,CAAC,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,MAAM,CAAC,CAIjB"}
+{"version":3,"file":"release.test-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/release.test-helpers.ts"],"names":[],"mappings":"AAIA,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,SAAc,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,sBAAsB,CAAC,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED,wBAAsB,oBAAoB,CACxC,IAAI,GAAE;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,sBAAsB,CAAC,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/commands/release.test-helpers.js

@@ -14,9 +14,12 @@ export async function writeReleaseNotes(root, version, body = "# Notes\n") {
 export async function seedReleaseWorkspace(root, opts = {}) {
     const coreVersion = opts.coreVersion ?? "1.2.3";
     const cliVersion = opts.cliVersion ?? coreVersion;
+    const recipesVersion = opts.recipesVersion ?? cliVersion;
     const dependencyVersion = opts.dependencyVersion ?? coreVersion;
+    const recipesDependencyVersion = opts.recipesDependencyVersion ?? recipesVersion;
     const dependencies = {
         "@agentplaneorg/core": dependencyVersion,
+        "@agentplaneorg/recipes": recipesDependencyVersion,
     };
     if (opts.extraDependencies) {
         Object.assign(dependencies, opts.extraDependencies);
@@ -30,6 +33,10 @@ export async function seedReleaseWorkspace(root, opts = {}) {
         version: cliVersion,
         dependencies,
     });
+    await writePackageJson(root, "packages/recipes", {
+        name: "@agentplaneorg/recipes",
+        version: recipesVersion,
+    });
     for (const pkg of opts.extraWorkspacePackages ?? []) {
         await writePackageJson(root, pkg.relDir, {
             name: pkg.name,

package/dist/commands/shared/reconcile-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconcile-check.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/reconcile-check.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAuG3B,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDhB"}
+{"version":3,"file":"reconcile-check.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/reconcile-check.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAuG3B,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDhB"}

package/dist/commands/shared/reconcile-check.js

@@ -2,7 +2,7 @@ import { exitCodeForError } from "../../cli/exit-codes.js";
 import { withDiagnosticContext } from "../../shared/diagnostics.js";
 import { CliError } from "../../shared/errors.js";
 import path from "node:path";
-import { listTaskSummariesMemo, loadTaskFromBranchSnapshot, } from "./task-backend.js";
+import { backendUsesLocalTaskStore, listTaskSummariesMemo, loadTaskFromBranchSnapshot, } from "./task-backend.js";
 function compactError(err) {
     if (err instanceof Error) {
         const text = err.message.trim();
@@ -135,7 +135,7 @@ export async function ensureReconciledBeforeMutation(opts) {
     });
 }
 async function filterWarningsResolvedFromTaskBranch(ctx, warnings) {
-    if (warnings.length === 0 || ctx.backendId !== "local") {
+    if (warnings.length === 0 || !backendUsesLocalTaskStore(ctx)) {
         return warnings;
     }
     const kept = [];

package/dist/commands/shared/task-backend.d.ts

@@ -1,6 +1,6 @@
 import { type AgentplaneConfig, type ResolvedProject } from "@agentplaneorg/core";
 import type { ResolvedHarnessContract } from "../../runtime/harness/index.js";
-import { loadTaskBackend, type TaskBackend, type TaskData, type TaskSummary } from "../../backends/task-backend.js";
+import { loadTaskBackend, type TaskBackendCapabilities, type TaskBackend, type TaskData, type TaskSummary } from "../../backends/task-backend.js";
 import { GitContext } from "./git-context.js";
 export type CommandMemo = {
     taskProjection?: Promise<TaskSummary[]>;
@@ -20,6 +20,11 @@ export type CommandContext = {
 };
 export declare function resolveDocUpdatedBy(task: TaskData, author?: string): string;
 export declare function taskDataToFrontmatter(task: TaskData): Record<string, unknown>;
+export declare function getTaskBackendCapabilities(ctx: CommandContext): TaskBackendCapabilities;
+export declare function backendHasLocalCanonicalSource(ctx: CommandContext): boolean;
+export declare function backendWritesTaskReadmes(ctx: CommandContext): boolean;
+export declare function backendSupportsTaskBranchSnapshots(ctx: CommandContext): boolean;
+export declare function backendUsesLocalTaskStore(ctx: CommandContext): boolean;
 export declare function loadCommandContext(opts: {
     cwd: string;
     rootOverride?: string | null;

package/dist/commands/shared/task-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared/task-backend.js

@@ -61,6 +61,38 @@ export function taskDataToFrontmatter(task) {
         dirty: task.dirty,
     };
 }
+export function getTaskBackendCapabilities(ctx) {
+    const capabilities = ctx.taskBackend?.capabilities;
+    if (capabilities)
+        return capabilities;
+    const isLocal = ctx.backendId === "local";
+    return {
+        canonical_source: isLocal ? "local" : "remote",
+        projection: isLocal ? "canonical" : "cache",
+        projection_read_mode: "native",
+        reads_from_projection_by_default: !isLocal,
+        writes_task_readmes: isLocal,
+        supports_task_revisions: isLocal,
+        supports_revision_guarded_writes: isLocal,
+        may_access_network_on_read: !isLocal,
+        may_access_network_on_write: !isLocal,
+        supports_projection_refresh: !isLocal,
+        supports_push_sync: !isLocal,
+        supports_snapshot_export: true,
+    };
+}
+export function backendHasLocalCanonicalSource(ctx) {
+    return getTaskBackendCapabilities(ctx).canonical_source === "local";
+}
+export function backendWritesTaskReadmes(ctx) {
+    return getTaskBackendCapabilities(ctx).writes_task_readmes === true;
+}
+export function backendSupportsTaskBranchSnapshots(ctx) {
+    return backendHasLocalCanonicalSource(ctx) && backendWritesTaskReadmes(ctx);
+}
+export function backendUsesLocalTaskStore(ctx) {
+    return backendSupportsTaskBranchSnapshots(ctx);
+}
 export async function loadCommandContext(opts) {
     const backendLoaded = await loadTaskBackend({
         cwd: opts.cwd,
@@ -106,7 +138,7 @@ export async function loadTaskFromContext(opts) {
     });
 }
 export async function resolveTaskBranchFromContext(opts) {
-    if (opts.ctx.backendId !== "local") {
+    if (!backendSupportsTaskBranchSnapshots(opts.ctx)) {
         return null;
     }
     const prefix = opts.ctx.config.branch.task_prefix;
@@ -124,7 +156,7 @@ export async function resolveTaskBranchFromContext(opts) {
     return null;
 }
 export async function loadTaskFromBranchSnapshot(opts) {
-    if (opts.ctx.backendId !== "local") {
+    if (!backendSupportsTaskBranchSnapshots(opts.ctx)) {
         return null;
     }
     const branch = typeof opts.branch === "string" && opts.branch.trim().length > 0

package/dist/commands/shared/task-mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-mutation.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-mutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAA6C,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAGL,YAAY,EACZ,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,OAAO,IAAI;IAChD,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,IAAI,EAAE;IAC3D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC9E,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChF,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IACxF,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAC,CA8DjF;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,IAAI,EAAE;IAC/D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,EAAE,KAChB,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;CACzF,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAQzD"}
+{"version":3,"file":"task-mutation.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-mutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,YAAY,EACZ,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,OAAO,IAAI;IAChD,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,IAAI,EAAE;IAC3D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC9E,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChF,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IACxF,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAC,CA8DjF;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,IAAI,EAAE;IAC/D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,EAAE,KAChB,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;CACzF,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAQzD"}