agentplane 0.3.23 → 0.3.26

package/dist/commands/cleanup/merged.command.js

@@ -1,95 +0,0 @@
-import { loadDirectSubcommandNames, parseGroupCommand, throwGroupCommandUsage, } from "../../cli/group-command.js";
-import { usageError } from "../../cli/spec/errors.js";
-import { cmdCleanupMerged } from "../branch/index.js";
-export const cleanupSpec = {
-    id: ["cleanup"],
-    group: "Branch",
-    summary: "Clean up local branches/worktrees.",
-    synopsis: ["agentplane cleanup <merged> [options]"],
-    args: [{ name: "cmd", required: false, variadic: true, valueHint: "<cmd>" }],
-    examples: [
-        { cmd: "agentplane cleanup merged --yes", why: "Delete merged task branches/worktrees." },
-    ],
-    parse: (raw) => parseGroupCommand(raw),
-};
-export const cleanupMergedSpec = {
-    id: ["cleanup", "merged"],
-    group: "Branch",
-    summary: "Delete merged task branches/worktrees (branch_pr workflow).",
-    options: [
-        { kind: "string", name: "base", valueHint: "<name>", description: "Base branch override." },
-        { kind: "boolean", name: "yes", default: false, description: "Confirm deletions." },
-        {
-            kind: "boolean",
-            name: "archive",
-            default: false,
-            description: "Archive PR artifacts before deletion.",
-        },
-        {
-            kind: "boolean",
-            name: "delete-remote-branches",
-            default: false,
-            description: "Also delete matching remote task branches on origin.",
-        },
-        {
-            kind: "boolean",
-            name: "fetch",
-            default: false,
-            description: "Fetch and prune origin before candidate resolution.",
-        },
-        { kind: "boolean", name: "quiet", default: false, description: "Reduce output noise." },
-    ],
-    examples: [
-        { cmd: "agentplane cleanup merged", why: "List candidates without deleting." },
-        {
-            cmd: "agentplane cleanup merged --yes --archive",
-            why: "Delete candidates and archive PR artifacts.",
-        },
-        {
-            cmd: "agentplane cleanup merged --yes --delete-remote-branches",
-            why: "Delete candidates and matching remote task branches on origin.",
-        },
-        {
-            cmd: "agentplane cleanup merged --fetch",
-            why: "Refresh origin before evaluating cleanup candidates.",
-        },
-    ],
-    validateRaw: (raw) => {
-        const base = typeof raw.opts.base === "string" ? raw.opts.base.trim() : "";
-        if (raw.opts.base !== undefined && !base) {
-            throw usageError({ spec: cleanupMergedSpec, message: "Invalid value for --base: empty." });
-        }
-    },
-    parse: (raw) => ({
-        base: typeof raw.opts.base === "string" ? raw.opts.base : null,
-        yes: raw.opts.yes === true,
-        archive: raw.opts.archive === true,
-        deleteRemoteBranches: raw.opts["delete-remote-branches"] === true,
-        fetch: raw.opts.fetch === true,
-        quiet: raw.opts.quiet === true,
-    }),
-};
-export const runCleanup = async (_ctx, p) => {
-    throwGroupCommandUsage({
-        spec: cleanupSpec,
-        cmd: p.cmd,
-        subcommands: await loadDirectSubcommandNames(["cleanup"]),
-        command: "cleanup",
-        contextCommand: "cleanup",
-    });
-};
-export function makeRunCleanupMergedHandler(getCtx) {
-    return async (ctx, p) => {
-        return await cmdCleanupMerged({
-            ctx: await getCtx("cleanup merged"),
-            cwd: ctx.cwd,
-            rootOverride: ctx.rootOverride,
-            base: p.base ?? undefined,
-            yes: p.yes,
-            archive: p.archive,
-            deleteRemoteBranches: p.deleteRemoteBranches,
-            fetch: p.fetch,
-            quiet: p.quiet,
-        });
-    };
-}

package/dist/commands/codex/plugin-install.d.ts

@@ -1,26 +0,0 @@
-export declare const AGENTPLANE_CODEX_HOME_ENV = "AGENTPLANE_CODEX_HOME";
-export type CodexPluginInstallScope = "user" | "repo";
-export type CodexPluginInstallResult = {
-    scope: CodexPluginInstallScope;
-    installRoot: string;
-    pluginRoot: string;
-    manifestPath: string;
-    marketplacePath: string;
-    copiedAssets: string[];
-};
-type JsonObject = Record<string, unknown>;
-export declare function buildCodexPluginManifest(version?: string): JsonObject;
-export declare function resolveCodexInstallRoot(opts: {
-    scope: CodexPluginInstallScope;
-    repoRoot?: string;
-    env?: NodeJS.ProcessEnv;
-}): string;
-export declare function resolveCodexPluginRoot(installRoot: string): string;
-export declare function resolveCodexMarketplacePath(installRoot: string): string;
-export declare function installBundledCodexPlugin(opts: {
-    scope: CodexPluginInstallScope;
-    installRoot: string;
-    version?: string;
-}): Promise<CodexPluginInstallResult>;
-export {};
-//# sourceMappingURL=plugin-install.d.ts.map

package/dist/commands/codex/plugin-install.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-install.d.ts","sourceRoot":"","sources":["../../../src/commands/codex/plugin-install.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAEjE,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAwG1C,wBAAgB,wBAAwB,CAAC,OAAO,SAAe,GAAG,UAAU,CA8B3E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,KAAK,EAAE,uBAAuB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,MAAM,CAiBT;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,KAAK,EAAE,uBAAuB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAyCpC"}

package/dist/commands/codex/plugin-install.js

@@ -1,210 +0,0 @@
-import { copyFile, mkdir, readFile } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { CliError } from "../../shared/errors.js";
-import { getVersion } from "../../meta/version.js";
-import { writeJsonStableIfChanged, writeTextIfChanged } from "../../shared/write-if-changed.js";
-import { resolveAgentplaneAssetDirUrl } from "../../shared/package-paths.js";
-const PLUGIN_NAME = "agentplane";
-const DEFAULT_MARKETPLACE_NAME = "agentplane-local-marketplace";
-const DEFAULT_MARKETPLACE_DISPLAY_NAME = "AgentPlane Local Plugins";
-const ASSET_ROOT_URL = resolveAgentplaneAssetDirUrl("codex-plugin");
-const TEXT_ASSETS = [
-    {
-        source: new URL("skills/agentplane/SKILL.md", ASSET_ROOT_URL),
-        relativePath: "skills/agentplane/SKILL.md",
-    },
-];
-const BINARY_ASSETS = [
-    {
-        source: new URL("assets/icon.svg", ASSET_ROOT_URL),
-        relativePath: "assets/icon.svg",
-    },
-    {
-        source: new URL("assets/logo.svg", ASSET_ROOT_URL),
-        relativePath: "assets/logo.svg",
-    },
-    {
-        source: new URL("assets/header.png", ASSET_ROOT_URL),
-        relativePath: "assets/header.png",
-    },
-];
-export const AGENTPLANE_CODEX_HOME_ENV = "AGENTPLANE_CODEX_HOME";
-function isJsonObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function invalidMarketplaceError(message) {
-    return new CliError({
-        exitCode: 3,
-        code: "E_VALIDATION",
-        message,
-    });
-}
-async function readTextIfExists(filePath) {
-    try {
-        return await readFile(filePath, "utf8");
-    }
-    catch (err) {
-        const code = err?.code;
-        if (code === "ENOENT")
-            return null;
-        throw err;
-    }
-}
-function defaultMarketplaceDocument() {
-    return {
-        name: DEFAULT_MARKETPLACE_NAME,
-        interface: {
-            displayName: DEFAULT_MARKETPLACE_DISPLAY_NAME,
-        },
-        plugins: [],
-    };
-}
-function parseMarketplaceDocument(text) {
-    if (text === null)
-        return defaultMarketplaceDocument();
-    let parsed;
-    try {
-        parsed = JSON.parse(text);
-    }
-    catch (err) {
-        throw invalidMarketplaceError(`Invalid Codex marketplace JSON: ${err instanceof Error ? err.message : "unknown parse error"}`);
-    }
-    if (!isJsonObject(parsed)) {
-        throw invalidMarketplaceError("Invalid Codex marketplace JSON: expected a top-level object.");
-    }
-    if ("plugins" in parsed && !Array.isArray(parsed.plugins)) {
-        throw invalidMarketplaceError("Invalid Codex marketplace JSON: `plugins` must be an array.");
-    }
-    if ("interface" in parsed && parsed.interface !== undefined && !isJsonObject(parsed.interface)) {
-        throw invalidMarketplaceError("Invalid Codex marketplace JSON: `interface` must be an object when present.");
-    }
-    return parsed;
-}
-function marketplaceEntry() {
-    return {
-        name: PLUGIN_NAME,
-        source: {
-            source: "local",
-            path: `./plugins/${PLUGIN_NAME}`,
-        },
-        policy: {
-            installation: "AVAILABLE",
-            authentication: "ON_INSTALL",
-        },
-        category: "Productivity",
-    };
-}
-function upsertMarketplaceDocument(text) {
-    const document = parseMarketplaceDocument(text);
-    const interfaceObject = isJsonObject(document.interface) ? { ...document.interface } : {};
-    if (typeof document.name !== "string" || document.name.trim().length === 0) {
-        document.name = DEFAULT_MARKETPLACE_NAME;
-    }
-    if (typeof interfaceObject.displayName !== "string" ||
-        interfaceObject.displayName.trim().length === 0) {
-        interfaceObject.displayName = DEFAULT_MARKETPLACE_DISPLAY_NAME;
-    }
-    const plugins = Array.isArray(document.plugins) ? document.plugins : [];
-    const nextEntry = marketplaceEntry();
-    const existingIndex = plugins.findIndex((entry) => isJsonObject(entry) && entry.name === PLUGIN_NAME);
-    if (existingIndex === -1) {
-        plugins.push(nextEntry);
-    }
-    else {
-        plugins.splice(existingIndex, 1, nextEntry);
-    }
-    return {
-        ...document,
-        interface: interfaceObject,
-        plugins,
-    };
-}
-export function buildCodexPluginManifest(version = getVersion()) {
-    return {
-        name: PLUGIN_NAME,
-        version,
-        description: "Bundle AgentPlane workflow guidance for the Codex plugins UI.",
-        homepage: "https://github.com/basilisk-labs/agentplane",
-        repository: "https://github.com/basilisk-labs/agentplane",
-        license: "MIT",
-        keywords: ["agentplane", "codex", "workflow", "tasks", "git"],
-        skills: "./skills/",
-        interface: {
-            displayName: "AgentPlane",
-            shortDescription: "Governed git-native workflow guidance for Codex",
-            longDescription: "Install AgentPlane into Codex through a local marketplace and give Codex explicit task, planning, verification, and branch_pr workflow guidance.",
-            developerName: "basilisk-labs",
-            category: "Productivity",
-            capabilities: ["Read", "Write"],
-            websiteURL: "https://github.com/basilisk-labs/agentplane",
-            defaultPrompt: [
-                "Use AgentPlane to initialize a governed workflow in this repository.",
-                "Use AgentPlane to create a task, approve the plan, and start work in branch_pr mode.",
-                "Use AgentPlane to verify the active task and record evidence before finish.",
-            ],
-            brandColor: "#111827",
-            composerIcon: "./assets/icon.svg",
-            logo: "./assets/logo.svg",
-            screenshots: ["./assets/header.png"],
-        },
-    };
-}
-export function resolveCodexInstallRoot(opts) {
-    if (opts.scope === "repo") {
-        const repoRoot = opts.repoRoot?.trim();
-        if (!repoRoot) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: "Repo scope requires a resolved repository root.",
-            });
-        }
-        return path.resolve(repoRoot);
-    }
-    const env = opts.env ?? process.env;
-    const overridden = env[AGENTPLANE_CODEX_HOME_ENV]?.trim();
-    if (overridden)
-        return path.resolve(overridden);
-    return os.homedir();
-}
-export function resolveCodexPluginRoot(installRoot) {
-    return path.join(installRoot, "plugins", PLUGIN_NAME);
-}
-export function resolveCodexMarketplacePath(installRoot) {
-    return path.join(installRoot, ".agents", "plugins", "marketplace.json");
-}
-export async function installBundledCodexPlugin(opts) {
-    const installRoot = path.resolve(opts.installRoot);
-    const pluginRoot = resolveCodexPluginRoot(installRoot);
-    const manifestPath = path.join(pluginRoot, ".codex-plugin", "plugin.json");
-    const marketplacePath = resolveCodexMarketplacePath(installRoot);
-    await mkdir(path.dirname(manifestPath), { recursive: true });
-    await mkdir(path.dirname(marketplacePath), { recursive: true });
-    await writeJsonStableIfChanged(manifestPath, buildCodexPluginManifest(opts.version ?? getVersion()));
-    const copiedAssets = [];
-    for (const asset of TEXT_ASSETS) {
-        const targetPath = path.join(pluginRoot, asset.relativePath);
-        await mkdir(path.dirname(targetPath), { recursive: true });
-        const contents = await readFile(asset.source, "utf8");
-        await writeTextIfChanged(targetPath, contents);
-        copiedAssets.push(targetPath);
-    }
-    for (const asset of BINARY_ASSETS) {
-        const targetPath = path.join(pluginRoot, asset.relativePath);
-        await mkdir(path.dirname(targetPath), { recursive: true });
-        await copyFile(fileURLToPath(asset.source), targetPath);
-        copiedAssets.push(targetPath);
-    }
-    const nextMarketplace = upsertMarketplaceDocument(await readTextIfExists(marketplacePath));
-    await writeJsonStableIfChanged(marketplacePath, nextMarketplace);
-    return {
-        scope: opts.scope,
-        installRoot,
-        pluginRoot,
-        manifestPath,
-        marketplacePath,
-        copiedAssets,
-    };
-}

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

@@ -1,6 +0,0 @@
-import type { CommandCtx } from "../cli/spec/spec.js";
-import type { CommandContext } from "./shared/task-backend.js";
-import type { CommitParsed } from "./commit.spec.js";
-export { commitSpec } from "./commit.spec.js";
-export declare function makeRunCommitHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: CommitParsed) => Promise<number>;
-//# sourceMappingURL=commit.command.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"commit.command.d.ts","sourceRoot":"","sources":["../../src/commands/commit.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACrE,KAAK,UAAU,EAAE,GAAG,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,CAsBjE"}

package/dist/commands/commit.command.js

@@ -1,26 +0,0 @@
-import { cmdCommit } from "./guard/impl/commit.js";
-export { commitSpec } from "./commit.spec.js";
-export function makeRunCommitHandler(getCtx) {
-    return async (ctx, p) => {
-        return await cmdCommit({
-            ctx: await getCtx("commit"),
-            cwd: ctx.cwd,
-            rootOverride: ctx.rootOverride,
-            taskId: p.taskId,
-            message: p.message ?? "",
-            close: p.close,
-            allow: p.allow,
-            autoAllow: p.autoAllow,
-            allowTasks: p.allowTasks,
-            allowBase: p.allowBase,
-            allowPolicy: p.allowPolicy,
-            allowConfig: p.allowConfig,
-            allowHooks: p.allowHooks,
-            allowCI: p.allowCI,
-            requireClean: p.requireClean,
-            quiet: p.quiet,
-            closeUnstageOthers: p.closeUnstageOthers,
-            closeCheckOnly: p.closeCheckOnly,
-        });
-    };
-}

package/dist/commands/commit.spec.d.ts

@@ -1,20 +0,0 @@
-import type { CommandSpec } from "../cli/spec/spec.js";
-export type CommitParsed = {
-    taskId: string;
-    message?: string;
-    close: boolean;
-    allow: string[];
-    autoAllow: boolean;
-    allowTasks: boolean;
-    allowBase: boolean;
-    allowPolicy: boolean;
-    allowConfig: boolean;
-    allowHooks: boolean;
-    allowCI: boolean;
-    requireClean: boolean;
-    quiet: boolean;
-    closeUnstageOthers: boolean;
-    closeCheckOnly: boolean;
-};
-export declare const commitSpec: CommandSpec<CommitParsed>;
-//# sourceMappingURL=commit.spec.d.ts.map

package/dist/commands/commit.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commit.spec.d.ts","sourceRoot":"","sources":["../../src/commands/commit.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CA0LhD,CAAC"}

package/dist/commands/commit.spec.js

@@ -1,183 +0,0 @@
-import { usageError } from "../cli/spec/errors.js";
-import { findRepoWideAllowPrefixes, repoWideAllowPrefixMessage, } from "./shared/allow-prefix-policy.js";
-export const commitSpec = {
-    id: ["commit"],
-    group: "Guard",
-    summary: "Create a git commit after validating policy and allowlist; if the index is empty, stage matching allowlist paths first.",
-    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
-    options: [
-        {
-            kind: "string",
-            name: "message",
-            short: "m",
-            valueHint: "<message>",
-            description: "Commit subject (must follow policy). Required unless --close is used.",
-        },
-        {
-            kind: "boolean",
-            name: "close",
-            default: false,
-            description: "Generate a deterministic close commit message from task snapshot + verification + recorded implementation commit; stages only the task README.",
-        },
-        {
-            kind: "boolean",
-            name: "unstage-others",
-            default: false,
-            description: "With --close: unstage any currently staged paths before staging the task README.",
-        },
-        {
-            kind: "boolean",
-            name: "check-only",
-            default: false,
-            description: "With --close: run preflight checks and print the planned close commit subject without creating a commit.",
-        },
-        {
-            kind: "string",
-            name: "allow",
-            valueHint: "<path-prefix>",
-            repeatable: true,
-            description: "Repeatable. Allowed path prefix (git-path). Use minimal prefixes; repo-wide '.' is rejected (tip: `agentplane guard suggest-allow --format args`).",
-        },
-        {
-            kind: "boolean",
-            name: "auto-allow",
-            default: false,
-            description: "Deprecated. Disabled for safety; pass explicit --allow prefixes.",
-            deprecated: "disabled",
-        },
-        {
-            kind: "boolean",
-            name: "allow-tasks",
-            default: false,
-            description: "Allow the tasks export snapshot plus artifacts under the active task subtree; standalone path scope.",
-        },
-        {
-            kind: "boolean",
-            name: "allow-base",
-            default: false,
-            description: "Allow base branch edits; branch override only, not a path allowlist.",
-        },
-        {
-            kind: "boolean",
-            name: "allow-policy",
-            default: false,
-            description: "Allow policy edits (e.g. AGENTS.md); standalone path scope.",
-        },
-        {
-            kind: "boolean",
-            name: "allow-config",
-            default: false,
-            description: "Allow config edits; standalone path scope.",
-        },
-        {
-            kind: "boolean",
-            name: "allow-hooks",
-            default: false,
-            description: "Allow hooks edits; standalone path scope.",
-        },
-        {
-            kind: "boolean",
-            name: "allow-ci",
-            default: false,
-            description: "Allow CI workflow edits; standalone path scope.",
-        },
-        {
-            kind: "boolean",
-            name: "require-clean",
-            default: false,
-            description: "Fail if tracked files have unstaged changes (untracked is ignored).",
-        },
-        { kind: "boolean", name: "quiet", default: false, description: "Reduce output noise." },
-    ],
-    examples: [
-        {
-            cmd: 'agentplane commit 202602030608-F1Q8AB -m "✨ F1Q8AB task: implement allowlist guard" --allow packages/agentplane',
-            why: "Create a commit after validating allowlist and subject policy.",
-        },
-        {
-            cmd: 'agentplane commit 202602030608-F1Q8AB -m "✨ F1Q8AB task: update publish workflow" --allow-ci',
-            why: "Commit CI-only changes without a redundant explicit workflow path prefix.",
-        },
-        {
-            cmd: "agentplane commit 202602030608-F1Q8AB --close",
-            why: "Create a close commit for the task README using a deterministic message builder.",
-        },
-    ],
-    notes: [
-        "Repository-managed task commits use the canonical subject format `<emoji> <suffix> <scope>: <summary>`; non-task commits use `<emoji> <scope>: <summary>`.",
-        "Repository-managed commit paths resolve author/committer identity from global git `user.name` and `user.email` before falling back to ambient git env.",
-        "Protected path-scoped overrides can stand alone without a duplicate explicit prefix: `--allow-tasks`, `--allow-policy`, `--allow-config`, `--allow-hooks`, and `--allow-ci` each admit their own path family.",
-        "Top-level `agentplane commit` can auto-stage those protected path scopes when the git index starts empty.",
-        "`--allow-base` is different: it only overrides base-branch protection and never selects file paths by itself.",
-    ],
-    validateRaw: (raw) => {
-        const close = raw.opts.close === true;
-        const msg = typeof raw.opts.message === "string" ? raw.opts.message.trim() : "";
-        if (!close && !msg) {
-            throw usageError({
-                spec: commitSpec,
-                message: "Missing required --message (or use --close).",
-            });
-        }
-        if (raw.opts.message !== undefined && !msg) {
-            throw usageError({ spec: commitSpec, message: "Invalid value for --message: empty." });
-        }
-        if (close && raw.opts.message !== undefined) {
-            throw usageError({
-                spec: commitSpec,
-                message: "Use either --message or --close (not both).",
-            });
-        }
-        if (!close && raw.opts["unstage-others"] === true) {
-            throw usageError({
-                spec: commitSpec,
-                message: "--unstage-others requires --close.",
-            });
-        }
-        if (!close && raw.opts["check-only"] === true) {
-            throw usageError({
-                spec: commitSpec,
-                message: "--check-only requires --close.",
-            });
-        }
-        const allow = raw.opts.allow;
-        if (Array.isArray(allow) && allow.some((s) => typeof s === "string" && s.trim() === "")) {
-            throw usageError({ spec: commitSpec, message: "Invalid value for --allow: empty." });
-        }
-        const allowList = Array.isArray(allow)
-            ? allow
-            : typeof allow === "string"
-                ? [allow]
-                : [];
-        if (findRepoWideAllowPrefixes(allowList).length > 0) {
-            throw usageError({ spec: commitSpec, message: repoWideAllowPrefixMessage("--allow") });
-        }
-        if (raw.opts["auto-allow"] === true) {
-            throw usageError({
-                spec: commitSpec,
-                message: "--auto-allow is disabled; pass explicit --allow <path-prefix>.",
-            });
-        }
-    },
-    parse: (raw) => ({
-        taskId: String(raw.args["task-id"]),
-        message: typeof raw.opts.message === "string" ? String(raw.opts.message) : undefined,
-        close: raw.opts.close === true,
-        allow: Array.isArray(raw.opts.allow)
-            ? raw.opts.allow
-            : typeof raw.opts.allow === "string"
-                ? [raw.opts.allow]
-                : [],
-        autoAllow: raw.opts["auto-allow"] === true,
-        allowTasks: raw.opts["allow-tasks"] === true,
-        allowBase: raw.opts["allow-base"] === true,
-        allowPolicy: raw.opts["allow-policy"] === true,
-        allowConfig: raw.opts["allow-config"] === true,
-        allowHooks: raw.opts["allow-hooks"] === true,
-        allowCI: raw.opts["allow-ci"] === true,
-        requireClean: raw.opts["require-clean"] === true,
-        quiet: raw.opts.quiet === true,
-        closeUnstageOthers: raw.opts["unstage-others"] === true,
-        closeCheckOnly: raw.opts["check-only"] === true,
-    }),
-};

package/dist/commands/docs/cli.command.d.ts

@@ -1,9 +0,0 @@
-import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
-import { type HelpJson } from "../../cli/spec/help-render.js";
-export type DocsCliParsed = {
-    out: string;
-};
-export declare const docsCliSpec: CommandSpec<DocsCliParsed>;
-export declare function makeRunDocsCliHandler(getHelpJson: () => readonly HelpJson[]): (ctx: CommandCtx, p: DocsCliParsed) => Promise<number>;
-export declare function makeHelpJsonFromSpecs(specs: readonly CommandSpec<unknown>[]): HelpJson[];
-//# sourceMappingURL=cli.command.d.ts.map

package/dist/commands/docs/cli.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.command.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/cli.command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAGrF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAqBlD,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,SAAS,QAAQ,EAAE,IAC5D,KAAK,UAAU,EAAE,GAAG,aAAa,KAAG,OAAO,CAAC,MAAM,CAAC,CAmBlE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,EAAE,CAExF"}

package/dist/commands/docs/cli.command.js

@@ -1,51 +0,0 @@
-import { mkdir } from "node:fs/promises";
-import path from "node:path";
-import { usageError } from "../../cli/spec/errors.js";
-import { renderCliDocsMdx } from "../../cli/spec/docs-render.js";
-import { renderCommandHelpJson } from "../../cli/spec/help-render.js";
-import { writeTextIfChanged } from "../../shared/write-if-changed.js";
-export const docsCliSpec = {
-    id: ["docs", "cli"],
-    group: "Docs",
-    summary: "Generate an MDX CLI reference from the current command spec catalog.",
-    options: [
-        {
-            kind: "string",
-            name: "out",
-            valueHint: "<path>",
-            required: true,
-            description: "Output path. If relative, it is resolved against the current working directory.",
-        },
-    ],
-    examples: [
-        {
-            cmd: "agentplane docs cli --out docs/user/cli-reference.generated.mdx",
-            why: "Generate docs.",
-        },
-    ],
-    parse: (raw) => ({ out: raw.opts.out }),
-};
-export function makeRunDocsCliHandler(getHelpJson) {
-    return async (ctx, p) => {
-        let list;
-        try {
-            list = getHelpJson();
-        }
-        catch (err) {
-            throw usageError({
-                spec: docsCliSpec,
-                command: "docs cli",
-                message: `Failed to read command specs for docs generation: ${err instanceof Error ? err.message : String(err)}`,
-            });
-        }
-        const mdx = renderCliDocsMdx(list);
-        const outPath = path.resolve(ctx.cwd, p.out);
-        await mkdir(path.dirname(outPath), { recursive: true });
-        await writeTextIfChanged(outPath, mdx);
-        process.stdout.write(`${outPath}\n`);
-        return 0;
-    };
-}
-export function makeHelpJsonFromSpecs(specs) {
-    return specs.map((s) => renderCommandHelpJson(s));
-}

package/dist/commands/doctor/archive.d.ts

@@ -1,4 +0,0 @@
-export declare function checkDoneTaskCommitInvariants(repoRoot: string, opts?: {
-    fullArchive?: boolean;
-}): Promise<string[]>;
-//# sourceMappingURL=archive.d.ts.map

package/dist/commands/doctor/archive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/archive.ts"],"names":[],"mappings":"AA+IA,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,OAAO,CAAC,MAAM,EAAE,CAAC,CA0FnB"}