agentplane 0.2.6 → 0.2.13

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

@@ -0,0 +1,343 @@
+import { readFile, writeFile, readdir } from "node:fs/promises";
+import path from "node:path";
+import { resolveProject } from "@agentplaneorg/core";
+import { usageError } from "../../cli/spec/errors.js";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+import { GitContext } from "../shared/git-context.js";
+async function fileExists(p) {
+    try {
+        await readFile(p, "utf8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readJsonFile(p) {
+    return JSON.parse(await readFile(p, "utf8"));
+}
+function assertNonEmptyString(value, label) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Invalid ${label} (expected non-empty string).`,
+        });
+    }
+    return value.trim();
+}
+function parseVersionPlan(raw) {
+    if (!raw || typeof raw !== "object") {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Invalid version.json (expected object).",
+        });
+    }
+    const obj = raw;
+    const bumpRaw = assertNonEmptyString(obj.bump, "bump");
+    if (bumpRaw !== "patch" && bumpRaw !== "minor" && bumpRaw !== "major") {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Invalid bump in version.json: ${bumpRaw}`,
+        });
+    }
+    const prevTagVal = obj.prevTag;
+    const prevTag = prevTagVal === null ? null : typeof prevTagVal === "string" ? prevTagVal : null;
+    const prevVersion = assertNonEmptyString(obj.prevVersion, "prevVersion");
+    const nextTag = assertNonEmptyString(obj.nextTag, "nextTag");
+    const nextVersion = assertNonEmptyString(obj.nextVersion, "nextVersion");
+    return { prevTag, prevVersion, nextTag, nextVersion, bump: bumpRaw };
+}
+async function findLatestPlanDir(gitRoot) {
+    const base = path.join(gitRoot, ".agentplane", ".release", "plan");
+    const runNames = await readdir(base);
+    const runs = runNames
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .toSorted();
+    const latest = runs.at(-1);
+    if (!latest) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: "No release plan runs found under .agentplane/.release/plan/. Run `agentplane release plan` first.",
+        });
+    }
+    return path.join(base, latest);
+}
+async function readPackageVersion(pkgJsonPath) {
+    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    const version = typeof raw.version === "string" ? raw.version.trim() : "";
+    if (!version) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Missing package.json version: ${pkgJsonPath}`,
+        });
+    }
+    return version;
+}
+async function replacePackageVersionInFile(pkgJsonPath, nextVersion) {
+    const text = await readFile(pkgJsonPath, "utf8");
+    const replaced = text.replace(/"version"\s*:\s*"[^"]*"/u, `"version": "${nextVersion}"`);
+    if (replaced === text) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Failed to update version in ${pkgJsonPath} (missing "version" field).`,
+        });
+    }
+    await writeFile(pkgJsonPath, replaced, "utf8");
+}
+function cleanHookEnv() {
+    const env = { ...gitEnv() };
+    delete env.AGENTPLANE_TASK_ID;
+    delete env.AGENTPLANE_STATUS_TO;
+    delete env.AGENTPLANE_AGENT_ID;
+    return env;
+}
+async function validateReleaseNotes(notesPath) {
+    const content = await readFile(notesPath, "utf8");
+    if (!/release\s+notes/i.test(content)) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Release notes must include a "Release Notes" heading in ${notesPath}.`,
+        });
+    }
+    const bulletCount = content.split(/\r?\n/u).filter((line) => /^\s*[-*]\s+\S+/u.test(line)).length;
+    if (bulletCount < 3) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Release notes must include at least 3 bullet points in ${notesPath}.`,
+        });
+    }
+    if (/[\u0400-\u04FF]/u.test(content)) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Release notes must be written in English (no Cyrillic) in ${notesPath}.`,
+        });
+    }
+}
+async function maybeUpdateBunLockfile(gitRoot) {
+    // GitHub publish uses `bun install --frozen-lockfile`, which will fail if the lockfile
+    // needs regeneration after bumping workspace package versions.
+    const bunLockPath = path.join(gitRoot, "bun.lock");
+    const rootPkgPath = path.join(gitRoot, "package.json");
+    if (!(await fileExists(bunLockPath)))
+        return;
+    if (!(await fileExists(rootPkgPath)))
+        return;
+    try {
+        await execFileAsync("bun", ["install", "--ignore-scripts"], {
+            cwd: gitRoot,
+            env: process.env,
+            maxBuffer: 50 * 1024 * 1024,
+        });
+    }
+    catch (err) {
+        const e = err;
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: "Failed to update bun.lock via `bun install --ignore-scripts`.\n" +
+                "Fix:\n" +
+                "  1) Run `bun install --ignore-scripts` manually\n" +
+                "  2) Re-run `agentplane release apply`\n" +
+                (e?.message ? `\nDetails:\n${e.message}` : ""),
+        });
+    }
+}
+export const releaseApplySpec = {
+    id: ["release", "apply"],
+    group: "Release",
+    summary: "Apply a prepared release: bump versions, validate notes, commit, and tag.",
+    description: "Applies a release plan generated by `agentplane release plan`. This command does not author release notes; it expects a DOCS agent to have written docs/releases/vX.Y.Z.md. By default it applies a patch bump; minor/major bumps require explicit approval.",
+    options: [
+        {
+            kind: "string",
+            name: "plan",
+            valueHint: "<path>",
+            description: "Path to a release plan directory (defaults to the latest under .agentplane/.release/plan/).",
+        },
+        {
+            kind: "boolean",
+            name: "push",
+            default: false,
+            description: "Push the release commit and tag to the remote (requires --yes).",
+        },
+        {
+            kind: "string",
+            name: "remote",
+            valueHint: "<name>",
+            description: "Git remote to push to (default: origin).",
+        },
+        {
+            kind: "boolean",
+            name: "yes",
+            default: false,
+            description: "Approve minor/major bumps and allow pushing. Patch bumps can be applied without this flag.",
+        },
+    ],
+    parse: (raw) => {
+        return {
+            plan: raw.opts.plan,
+            push: raw.opts.push === true,
+            remote: raw.opts.remote ?? "origin",
+            yes: raw.opts.yes === true,
+        };
+    },
+    validate: (p) => {
+        if (p.push && p.yes !== true) {
+            throw usageError({
+                spec: releaseApplySpec,
+                command: "release apply",
+                message: "Option --push requires explicit approval. Re-run with --yes.",
+            });
+        }
+        if (!p.remote.trim()) {
+            throw usageError({
+                spec: releaseApplySpec,
+                command: "release apply",
+                message: "Option --remote must be non-empty.",
+            });
+        }
+    },
+    examples: [
+        {
+            cmd: "agentplane release apply",
+            why: "Apply the latest release plan (expects docs/releases/vX.Y.Z.md to exist).",
+        },
+        {
+            cmd: "agentplane release apply --plan .agentplane/.release/plan/<runId>",
+            why: "Apply a specific release plan directory.",
+        },
+        {
+            cmd: "agentplane release apply --push --yes",
+            why: "Apply and push the release commit+tag to the remote.",
+        },
+    ],
+};
+export const runReleaseApply = async (ctx, flags) => {
+    const resolved = await resolveProject({ cwd: ctx.cwd, rootOverride: ctx.rootOverride ?? null });
+    const gitRoot = resolved.gitRoot;
+    const planDir = flags.plan ? path.resolve(gitRoot, flags.plan) : await findLatestPlanDir(gitRoot);
+    const versionJsonPath = path.join(planDir, "version.json");
+    if (!(await fileExists(versionJsonPath))) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: `Missing version.json in plan dir: ${path.relative(gitRoot, versionJsonPath)}`,
+        });
+    }
+    const plan = parseVersionPlan(await readJsonFile(versionJsonPath));
+    if ((plan.bump === "minor" || plan.bump === "major") && flags.yes !== true) {
+        throw usageError({
+            spec: releaseApplySpec,
+            command: "release apply",
+            message: `Bump '${plan.bump}' requires explicit approval. Re-run with --yes.`,
+        });
+    }
+    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(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(gitRoot, notesPath)}\n` +
+                "Write this file using a DOCS agent before applying the release.",
+        });
+    }
+    await validateReleaseNotes(notesPath);
+    const corePkgPath = path.join(gitRoot, "packages", "core", "package.json");
+    const agentplanePkgPath = path.join(gitRoot, "packages", "agentplane", "package.json");
+    const [coreVersion, agentplaneVersion] = await Promise.all([
+        readPackageVersion(corePkgPath),
+        readPackageVersion(agentplanePkgPath),
+    ]);
+    if (coreVersion !== agentplaneVersion) {
+        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}`,
+        });
+    }
+    const git = new GitContext({ gitRoot });
+    if (coreVersion === plan.prevVersion) {
+        await Promise.all([
+            replacePackageVersionInFile(corePkgPath, plan.nextVersion),
+            replacePackageVersionInFile(agentplanePkgPath, plan.nextVersion),
+        ]);
+    }
+    else if (coreVersion !== plan.nextVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Current version does not match plan. ` +
+                `current=${coreVersion} expected_prev=${plan.prevVersion} expected_next=${plan.nextVersion}\n` +
+                "Re-run `agentplane release plan` to generate a fresh plan for this repo state.",
+        });
+    }
+    await maybeUpdateBunLockfile(gitRoot);
+    const stagePaths = [
+        "packages/core/package.json",
+        "packages/agentplane/package.json",
+        path.relative(gitRoot, notesPath),
+    ];
+    if (await fileExists(path.join(gitRoot, "bun.lock"))) {
+        stagePaths.push("bun.lock");
+    }
+    await git.stage(stagePaths);
+    const staged = await git.statusStagedPaths();
+    if (staged.length === 0) {
+        process.stdout.write("No changes to commit.\n");
+    }
+    else {
+        const subject = `✨ release: ${plan.nextTag}`;
+        await git.commit({ message: subject, env: cleanHookEnv() });
+    }
+    // Create tag (idempotency: refuse to overwrite).
+    try {
+        await execFileAsync("git", ["rev-parse", "-q", "--verify", `refs/tags/${plan.nextTag}`], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        throw new CliError({
+            exitCode: exitCodeForError("E_GIT"),
+            code: "E_GIT",
+            message: `Tag already exists: ${plan.nextTag}`,
+        });
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code !== 1)
+            throw err;
+    }
+    await execFileAsync("git", ["tag", plan.nextTag], { cwd: gitRoot, env: gitEnv() });
+    process.stdout.write(`Release tag created: ${plan.nextTag}\n`);
+    if (flags.push) {
+        await execFileAsync("git", ["push", flags.remote, "HEAD"], { cwd: gitRoot, env: gitEnv() });
+        await execFileAsync("git", ["push", flags.remote, plan.nextTag], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        process.stdout.write(`Pushed: ${flags.remote} HEAD + ${plan.nextTag}\n`);
+    }
+    else {
+        process.stdout.write(`Next: git push <remote> HEAD && git push <remote> ${plan.nextTag}\n`);
+    }
+    return 0;
+};

package/dist/commands/release/plan.command.d.ts

@@ -0,0 +1,12 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+type BumpKind = "patch" | "minor" | "major";
+export type ReleasePlanFlags = {
+    bump: BumpKind;
+    since?: string;
+    yes: boolean;
+};
+export type ReleasePlanParsed = ReleasePlanFlags;
+export declare const releasePlanSpec: CommandSpec<ReleasePlanParsed>;
+export declare const runReleasePlan: CommandHandler<ReleasePlanParsed>;
+export {};
+//# sourceMappingURL=plan.command.d.ts.map

package/dist/commands/release/plan.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/plan.command.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAM1E,KAAK,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAmHjD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CA4E1D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CAyD5D,CAAC"}

package/dist/commands/release/plan.command.js

@@ -0,0 +1,206 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveProject } from "@agentplaneorg/core";
+import { usageError } from "../../cli/spec/errors.js";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+function parseSemver(version) {
+    const m = /^(\d+)\.(\d+)\.(\d+)$/u.exec(version.trim());
+    if (!m)
+        return null;
+    const major = Number(m[1]);
+    const minor = Number(m[2]);
+    const patch = Number(m[3]);
+    if (![major, minor, patch].every((n) => Number.isInteger(n) && n >= 0))
+        return null;
+    return { major, minor, patch };
+}
+function bumpVersion(version, bump) {
+    const parsed = parseSemver(version);
+    if (!parsed) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Invalid version (expected X.Y.Z): ${version}`,
+        });
+    }
+    if (bump === "patch")
+        return `${parsed.major}.${parsed.minor}.${parsed.patch + 1}`;
+    if (bump === "minor")
+        return `${parsed.major}.${parsed.minor + 1}.0`;
+    return `${parsed.major + 1}.0.0`;
+}
+async function readPackageVersion(pkgJsonPath) {
+    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    const version = typeof raw.version === "string" ? raw.version.trim() : "";
+    if (!version) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Missing package.json version: ${pkgJsonPath}`,
+        });
+    }
+    return version;
+}
+async function getLatestSemverTag(gitRoot) {
+    try {
+        const { stdout } = await execFileAsync("git", ["describe", "--tags", "--abbrev=0", "--match", "v[0-9]*.[0-9]*.[0-9]*"], { cwd: gitRoot, env: gitEnv() });
+        const tag = String(stdout ?? "").trim();
+        return tag || null;
+    }
+    catch {
+        return null;
+    }
+}
+async function listChanges(gitRoot, sinceRef) {
+    const range = sinceRef ? `${sinceRef}..HEAD` : "HEAD";
+    const { stdout } = await execFileAsync("git", ["log", "--no-merges", "--pretty=format:%H%x00%aI%x00%s", range], { cwd: gitRoot, env: gitEnv(), maxBuffer: 10 * 1024 * 1024 });
+    const text = String(stdout ?? "");
+    const lines = text.split("\n").filter((l) => l.length > 0);
+    const out = [];
+    for (const line of lines) {
+        const parts = line.split("\0");
+        const hash = (parts[0] ?? "").trim();
+        const authorDateIso = (parts[1] ?? "").trim();
+        const subject = (parts[2] ?? "").trim();
+        if (!hash || !authorDateIso || !subject)
+            continue;
+        out.push({ hash, authorDateIso, subject });
+    }
+    return out;
+}
+function changesMarkdown(changes) {
+    if (changes.length === 0)
+        return "_No commits found in the selected range._\n";
+    return (changes
+        .map((c) => `- ${c.subject} (${c.hash.slice(0, 7)})`)
+        .join("\n")
+        .trim() + "\n");
+}
+function releaseInstructions(opts) {
+    return (`# Release plan\n\n` +
+        `## Target\n\n` +
+        `- Tag: \`${opts.nextTag}\`\n` +
+        (opts.prevTag
+            ? `- Since: \`${opts.prevTag}\`\n`
+            : "- Since: (no previous semver tag found)\n") +
+        `- Bump: \`${opts.bump}\`\n\n` +
+        `## Agent task: write release notes\n\n` +
+        `Write English release notes as \`docs/releases/${opts.nextTag}.md\`.\n\n` +
+        `Rules:\n` +
+        `- Use human-readable bullets focused on outcomes and user-facing improvements.\n` +
+        `- Minimum: 3 bullet points.\n` +
+        `- Do not include Cyrillic.\n` +
+        `- Use \`docs/releases/TEMPLATE.md\` as the structure.\n\n` +
+        `Inputs:\n` +
+        `- \`changes.md\` and \`changes.json\` in this directory.\n`);
+}
+export const releasePlanSpec = {
+    id: ["release", "plan"],
+    group: "Release",
+    summary: "Generate an agent-assisted release plan (changes list + next patch version).",
+    description: "Generates a structured changes list since the last semver tag and writes a plan directory under .agentplane/.release/. This plan is intended for a DOCS agent to author release notes. By default, only patch bumps are allowed without explicit approval.",
+    options: [
+        {
+            kind: "boolean",
+            name: "patch",
+            default: false,
+            description: "Bump patch version (default).",
+        },
+        {
+            kind: "boolean",
+            name: "minor",
+            default: false,
+            description: "Bump minor version (requires --yes).",
+        },
+        {
+            kind: "boolean",
+            name: "major",
+            default: false,
+            description: "Bump major version (requires --yes).",
+        },
+        {
+            kind: "string",
+            name: "since",
+            valueHint: "<tag>",
+            description: "Override the starting tag/ref (defaults to the latest vX.Y.Z tag).",
+        },
+        {
+            kind: "boolean",
+            name: "yes",
+            default: false,
+            description: "Approve minor/major version bumps (required for --minor/--major).",
+        },
+    ],
+    validateRaw: (raw) => {
+        const count = [
+            raw.opts.patch === true,
+            raw.opts.minor === true,
+            raw.opts.major === true,
+        ].filter(Boolean).length;
+        if (count > 1) {
+            throw usageError({
+                spec: releasePlanSpec,
+                command: "release plan",
+                message: "Options --patch/--minor/--major are mutually exclusive.",
+            });
+        }
+    },
+    parse: (raw) => {
+        const bump = raw.opts.major === true ? "major" : raw.opts.minor === true ? "minor" : "patch";
+        return { bump, since: raw.opts.since, yes: raw.opts.yes === true };
+    },
+    validate: (p) => {
+        if ((p.bump === "minor" || p.bump === "major") && p.yes !== true) {
+            throw usageError({
+                spec: releasePlanSpec,
+                command: "release plan",
+                message: `Bump '${p.bump}' requires explicit approval. Re-run with --yes.`,
+            });
+        }
+    },
+    examples: [
+        {
+            cmd: "agentplane release plan",
+            why: "Generate a plan for the next patch release and hand it to a DOCS agent to write release notes.",
+        },
+        {
+            cmd: "agentplane release plan --minor --yes",
+            why: "Generate a plan for the next minor release (explicit approval required).",
+        },
+    ],
+};
+export const runReleasePlan = async (ctx, flags) => {
+    const resolved = await resolveProject({ cwd: ctx.cwd, rootOverride: ctx.rootOverride ?? null });
+    const gitRoot = resolved.gitRoot;
+    const corePkgPath = path.join(gitRoot, "packages", "core", "package.json");
+    const agentplanePkgPath = path.join(gitRoot, "packages", "agentplane", "package.json");
+    const [coreVersion, agentplaneVersion] = await Promise.all([
+        readPackageVersion(corePkgPath),
+        readPackageVersion(agentplanePkgPath),
+    ]);
+    if (coreVersion !== agentplaneVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Package versions must match before release planning. ` +
+                `packages/core=${coreVersion} packages/agentplane=${agentplaneVersion}`,
+        });
+    }
+    const prevTag = flags.since ?? (await getLatestSemverTag(gitRoot));
+    const nextVersion = bumpVersion(coreVersion, flags.bump);
+    const nextTag = `v${nextVersion}`;
+    const changes = await listChanges(gitRoot, prevTag);
+    const runId = new Date().toISOString().replaceAll(":", "-").replaceAll(".", "-");
+    const baseDir = path.join(gitRoot, ".agentplane", ".release", "plan", runId);
+    await mkdir(baseDir, { recursive: true });
+    await writeFile(path.join(baseDir, "version.json"), JSON.stringify({ prevTag, prevVersion: coreVersion, nextTag, nextVersion, bump: flags.bump }, null, 2) + "\n", "utf8");
+    await writeFile(path.join(baseDir, "changes.json"), JSON.stringify(changes, null, 2) + "\n", "utf8");
+    await writeFile(path.join(baseDir, "changes.md"), changesMarkdown(changes), "utf8");
+    await writeFile(path.join(baseDir, "instructions.md"), releaseInstructions({ nextTag, prevTag, bump: flags.bump }), "utf8");
+    process.stdout.write(`Release plan written: ${path.relative(gitRoot, baseDir)}\n`);
+    process.stdout.write(`Next tag: ${nextTag}\n`);
+    process.stdout.write(`Hint: Create a DOCS task to write docs/releases/${nextTag}.md based on this plan.\n`);
+    return 0;
+};

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

@@ -0,0 +1,5 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+export type ReleaseGroupParsed = Record<string, never>;
+export declare const releaseSpec: CommandSpec<ReleaseGroupParsed>;
+export declare const runRelease: CommandHandler<ReleaseGroupParsed>;
+//# sourceMappingURL=release.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"release.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/release.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEvD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,kBAAkB,CAYvD,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,kBAAkB,CAGzD,CAAC"}

package/dist/commands/release/release.command.js

@@ -0,0 +1,18 @@
+import { usageError } from "../../cli/spec/errors.js";
+export const releaseSpec = {
+    id: ["release"],
+    group: "Release",
+    summary: "Prepare a release (agent-assisted notes + version bump workflow).",
+    synopsis: ["agentplane release <command> [args] [options]"],
+    validateRaw: (raw) => {
+        if (raw.extra.length > 0) {
+            throw usageError({ spec: releaseSpec, message: `Unknown subcommand: ${raw.extra[0]}` });
+        }
+        throw usageError({ spec: releaseSpec, message: "Missing subcommand." });
+    },
+    parse: () => ({}),
+};
+export const runRelease = () => {
+    // Unreachable (validateRaw always throws).
+    return Promise.resolve(2);
+};

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

@@ -15,6 +15,9 @@ export declare class GitContext {
         body?: string;
         env?: NodeJS.ProcessEnv;
     }): Promise<void>;
+    commitAmendNoEdit(opts?: {
+        env?: NodeJS.ProcessEnv;
+    }): Promise<void>;
     headHashSubject(): Promise<{
         hash: string;
         subject: string;

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

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

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

@@ -126,6 +126,16 @@ export class GitContext {
         this.memo.status = undefined;
         this.memo.headCommit = undefined;
     }
+    async commitAmendNoEdit(opts) {
+        await execFileAsync("git", ["commit", "--amend", "--no-edit"], {
+            cwd: this.gitRoot,
+            env: opts?.env ?? gitEnv(),
+            // Amend triggers hooks too; keep buffer aligned with regular commit.
+            maxBuffer: 50 * 1024 * 1024,
+        });
+        this.memo.status = undefined;
+        this.memo.headCommit = undefined;
+    }
     async headHashSubject() {
         const { stdout } = await execFileAsync("git", ["log", "-1", "--pretty=%H%x00%s"], {
             cwd: this.gitRoot,

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

@@ -4,6 +4,7 @@ export type CommandMemo = {
     taskList?: Promise<TaskData[]>;
     changedPaths?: Promise<string[]>;
     headCommit?: Promise<string>;
+    agentIds?: Promise<string[]>;
 };
 export type CommandContext = {
     resolvedProject: Awaited<ReturnType<typeof loadTaskBackend>>["resolved"];

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":"AAGA,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACzE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,UAAU,CAAC;IAEhB,IAAI,EAAE,WAAW,CAAC;IAGlB,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC5C,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CACxC,CAAC;AASF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+B7E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,cAAc,CAAC,CAgB1B;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAepB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC5C,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC,CAaD;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAG5E"}
+{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACzE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,UAAU,CAAC;IAEhB,IAAI,EAAE,WAAW,CAAC;IAGlB,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC5C,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CACxC,CAAC;AASF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+B7E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,cAAc,CAAC,CAgB1B;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAepB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC5C,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC,CAaD;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAG5E"}