agentplane 0.2.6 → 0.2.13

package/dist/commands/finish.spec.js

@@ -0,0 +1,193 @@
+import { usageError } from "../cli/spec/errors.js";
+import { toStringList } from "../cli/spec/parse-utils.js";
+export const finishSpec = {
+    id: ["finish"],
+    group: "Lifecycle",
+    summary: "Mark task(s) as DONE and record a structured Verified comment.",
+    args: [
+        {
+            name: "task-id",
+            required: true,
+            variadic: true,
+            valueHint: "<task-id>",
+            description: "One or more existing task ids.",
+        },
+    ],
+    options: [
+        {
+            kind: "string",
+            name: "author",
+            valueHint: "<id>",
+            required: true,
+            description: "Comment author id (e.g. INTEGRATOR).",
+        },
+        {
+            kind: "string",
+            name: "body",
+            valueHint: "<text>",
+            required: true,
+            description: "Structured comment body (must match the configured Verified: prefix).",
+        },
+        {
+            kind: "string",
+            name: "result",
+            valueHint: "<one-line>",
+            description: "One-line result summary stored in task metadata (required for non-spike tasks when finishing a single task).",
+        },
+        {
+            kind: "string",
+            name: "risk",
+            valueHint: "<low|med|high>",
+            choices: ["low", "med", "high"],
+            description: "Optional. Risk level stored in task metadata.",
+        },
+        {
+            kind: "boolean",
+            name: "breaking",
+            default: false,
+            description: "Optional. Mark the change as breaking in task metadata.",
+        },
+        {
+            kind: "string",
+            name: "commit",
+            valueHint: "<hash>",
+            description: "Commit hash to record on the task (optional).",
+        },
+        { kind: "boolean", name: "force", default: false, description: "Force finish despite gates." },
+        {
+            kind: "boolean",
+            name: "commit-from-comment",
+            default: false,
+            description: "Create a commit using the comment body (requires exactly one task id).",
+        },
+        {
+            kind: "string",
+            name: "commit-emoji",
+            valueHint: "<emoji>",
+            description: "Override the commit emoji (used with --commit-from-comment).",
+        },
+        {
+            kind: "string",
+            name: "commit-allow",
+            valueHint: "<path-prefix>",
+            repeatable: true,
+            description: "Repeatable. Allowlist path prefixes to stage for the commit (used with --commit-from-comment).",
+        },
+        {
+            kind: "boolean",
+            name: "commit-auto-allow",
+            default: false,
+            description: "Auto-allow inferred allowlist paths if none are provided (used with --commit-from-comment).",
+        },
+        {
+            kind: "boolean",
+            name: "commit-allow-tasks",
+            default: true,
+            hidden: true,
+            description: "Deprecated. Tasks are always allowed for status commits.",
+            deprecated: "no-op",
+        },
+        {
+            kind: "boolean",
+            name: "commit-require-clean",
+            default: false,
+            description: "Require a clean working tree for the commit (used with --commit-from-comment).",
+        },
+        {
+            kind: "boolean",
+            name: "status-commit",
+            default: false,
+            description: "Create a separate status commit (requires exactly one task id).",
+        },
+        {
+            kind: "string",
+            name: "status-commit-emoji",
+            valueHint: "<emoji>",
+            description: "Override the status commit emoji (used with --status-commit).",
+        },
+        {
+            kind: "string",
+            name: "status-commit-allow",
+            valueHint: "<path-prefix>",
+            repeatable: true,
+            description: "Repeatable. Allowlist path prefixes to stage for the status commit (used with --status-commit).",
+        },
+        {
+            kind: "boolean",
+            name: "status-commit-auto-allow",
+            default: false,
+            description: "Auto-allow inferred allowlist paths if none are provided (used with --status-commit).",
+        },
+        {
+            kind: "boolean",
+            name: "status-commit-require-clean",
+            default: false,
+            description: "Require a clean working tree for the status commit (used with --status-commit).",
+        },
+        {
+            kind: "boolean",
+            name: "confirm-status-commit",
+            default: false,
+            description: "Confirm status commit creation when status_commit_policy=confirm (used with --commit-from-comment or --status-commit).",
+        },
+        { kind: "boolean", name: "quiet", default: false, description: "Suppress output." },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane finish 202602030608-F1Q8AB --author INTEGRATOR --body "Verified: all checks passed" --commit abcdef123456',
+            why: "Finish a task and record commit metadata.",
+        },
+        {
+            cmd: 'agentplane finish 202602030608-F1Q8AB --author INTEGRATOR --body "Verified: all checks passed" --commit-from-comment --commit-allow packages/agentplane/src',
+            why: "Finish and create a commit from the comment (single-task only).",
+        },
+    ],
+    validateRaw: (raw) => {
+        const ids = raw.args["task-id"];
+        const taskIds = Array.isArray(ids) ? ids : [];
+        const commitFromComment = raw.opts["commit-from-comment"] === true;
+        const statusCommit = raw.opts["status-commit"] === true;
+        if ((commitFromComment || statusCommit) && taskIds.length !== 1) {
+            throw usageError({
+                spec: finishSpec,
+                command: "finish",
+                message: "--commit-from-comment/--status-commit requires exactly one task id",
+            });
+        }
+        const hasMeta = typeof raw.opts.result === "string" ||
+            typeof raw.opts.risk === "string" ||
+            raw.opts.breaking === true;
+        if (hasMeta && taskIds.length !== 1) {
+            throw usageError({
+                spec: finishSpec,
+                command: "finish",
+                message: "--result/--risk/--breaking requires exactly one task id",
+            });
+        }
+    },
+    parse: (raw) => ({
+        taskIds: Array.isArray(raw.args["task-id"])
+            ? raw.args["task-id"].filter((x) => typeof x === "string")
+            : [],
+        author: raw.opts.author,
+        body: raw.opts.body,
+        result: raw.opts.result,
+        risk: raw.opts.risk,
+        breaking: raw.opts.breaking === true,
+        commit: raw.opts.commit,
+        force: raw.opts.force === true,
+        commitFromComment: raw.opts["commit-from-comment"] === true,
+        commitEmoji: raw.opts["commit-emoji"],
+        commitAllow: toStringList(raw.opts["commit-allow"]),
+        commitAutoAllow: raw.opts["commit-auto-allow"] === true,
+        commitAllowTasks: raw.opts["commit-allow-tasks"] !== false,
+        commitRequireClean: raw.opts["commit-require-clean"] === true,
+        statusCommit: raw.opts["status-commit"] === true,
+        statusCommitEmoji: raw.opts["status-commit-emoji"],
+        statusCommitAllow: toStringList(raw.opts["status-commit-allow"]),
+        statusCommitAutoAllow: raw.opts["status-commit-auto-allow"] === true,
+        statusCommitRequireClean: raw.opts["status-commit-require-clean"] === true,
+        confirmStatusCommit: raw.opts["confirm-status-commit"] === true,
+        quiet: raw.opts.quiet === true,
+    }),
+};

package/dist/commands/recipes/install.command.d.ts

@@ -1,12 +1,3 @@
-import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
-import { type RecipeConflictMode, type RecipeInstallSource } from "../recipes.js";
-export type RecipesInstallParsed = {
-    source: RecipeInstallSource;
-    index?: string;
-    refresh: boolean;
-    yes: boolean;
-    onConflict: RecipeConflictMode;
-};
-export declare const recipesInstallSpec: CommandSpec<RecipesInstallParsed>;
-export declare const runRecipesInstall: CommandHandler<RecipesInstallParsed>;
+export { recipesInstallSpec, type RecipesInstallParsed } from "./install.spec.js";
+export { runRecipesInstall } from "./install.run.js";
 //# sourceMappingURL=install.command.d.ts.map

package/dist/commands/recipes/install.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/install.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAItF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpG,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,kBAAkB,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CA4IhE,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CAkB7D,CAAC"}
+{"version":3,"file":"install.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/install.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/commands/recipes/install.command.js

@@ -1,161 +1,2 @@
-import { usageError } from "../../cli/spec/errors.js";
-import { CliError } from "../../shared/errors.js";
-import { cmdRecipeInstall } from "../recipes.js";
-export const recipesInstallSpec = {
-    id: ["recipes", "install"],
-    group: "Recipes",
-    summary: "Install a recipe from remote index, local archive, or URL.",
-    synopsis: [
-        "agentplane recipes install <id|path|url> [--index <path|url>] [--refresh] [--yes] [--on-conflict <fail|rename|overwrite>]",
-        "agentplane recipes install --name <id> [--index <path|url>] [--refresh] [--yes] [--on-conflict <fail|rename|overwrite>]",
-        "agentplane recipes install --path <path> [--yes] [--on-conflict <fail|rename|overwrite>]",
-        "agentplane recipes install --url <url> [--yes] [--on-conflict <fail|rename|overwrite>]",
-    ],
-    args: [
-        {
-            name: "source",
-            required: false,
-            valueHint: "<id|path|url>",
-            description: "Auto mode: URL if http(s); else PATH if file exists; else NAME (remote index id).",
-        },
-    ],
-    options: [
-        {
-            kind: "string",
-            name: "name",
-            valueHint: "<id>",
-            description: "Install from remote index by recipe id.",
-        },
-        {
-            kind: "string",
-            name: "path",
-            valueHint: "<path>",
-            description: "Install from local recipe archive path.",
-        },
-        {
-            kind: "string",
-            name: "url",
-            valueHint: "<url>",
-            description: "Install from recipe archive URL.",
-        },
-        {
-            kind: "string",
-            name: "index",
-            valueHint: "<path|url>",
-            description: "Override recipes index location (used when installing by name / auto-name).",
-        },
-        {
-            kind: "boolean",
-            name: "refresh",
-            default: false,
-            description: "Refresh remote index cache before installing.",
-        },
-        {
-            kind: "boolean",
-            name: "yes",
-            default: false,
-            description: "Auto-approve network prompts when allowed by config.",
-        },
-        {
-            kind: "string",
-            name: "on-conflict",
-            valueHint: "<fail|rename|overwrite>",
-            choices: ["fail", "rename", "overwrite"],
-            default: "fail",
-            description: "How to handle conflicts when applying recipe agents.",
-        },
-    ],
-    validateRaw: (raw) => {
-        const explicit = [raw.opts.name, raw.opts.path, raw.opts.url].filter(Boolean).length;
-        const hasPositional = Boolean(raw.args.source);
-        if (explicit + (hasPositional ? 1 : 0) !== 1) {
-            throw usageError({
-                spec: recipesInstallSpec,
-                message: "Exactly one source is required: <source> OR --name OR --path OR --url",
-                command: "recipes install",
-            });
-        }
-    },
-    parse: (raw) => {
-        const onConflict = (raw.opts["on-conflict"] ?? "fail");
-        const refresh = raw.opts.refresh === true;
-        const yes = raw.opts.yes === true;
-        const index = typeof raw.opts.index === "string" ? raw.opts.index : undefined;
-        if (raw.opts.name) {
-            return {
-                source: { type: "name", value: raw.opts.name },
-                index,
-                refresh,
-                yes,
-                onConflict,
-            };
-        }
-        if (raw.opts.path) {
-            return {
-                source: { type: "path", value: raw.opts.path },
-                index,
-                refresh,
-                yes,
-                onConflict,
-            };
-        }
-        if (raw.opts.url) {
-            return {
-                source: { type: "url", value: raw.opts.url },
-                index,
-                refresh,
-                yes,
-                onConflict,
-            };
-        }
-        const source = raw.args.source;
-        if (typeof source !== "string") {
-            throw usageError({
-                spec: recipesInstallSpec,
-                command: "recipes install",
-                message: "Missing source argument",
-            });
-        }
-        return {
-            source: { type: "auto", value: source },
-            index,
-            refresh,
-            yes,
-            onConflict,
-        };
-    },
-    examples: [
-        { cmd: "agentplane recipes install viewer", why: "Auto: install by id from remote index." },
-        {
-            cmd: "agentplane recipes install --name viewer --refresh",
-            why: "Install by id, forcing index refresh.",
-        },
-        {
-            cmd: "agentplane recipes install viewer --on-conflict overwrite",
-            why: "Apply recipe agents, overwriting conflicts.",
-        },
-    ],
-    notes: [
-        "Auto mode resolution matches v0.1.9: URL if http(s); else PATH if file exists; else NAME (remote index).",
-        "Network operations may require approval; use --yes to auto-approve when allowed by config.",
-    ],
-};
-export const runRecipesInstall = (ctx, p) => (async () => {
-    try {
-        return await cmdRecipeInstall({
-            cwd: ctx.cwd,
-            rootOverride: ctx.rootOverride,
-            ...p,
-        });
-    }
-    catch (err) {
-        if (err instanceof CliError && err.code === "E_USAGE") {
-            throw usageError({
-                spec: recipesInstallSpec,
-                command: "recipes install",
-                message: err.message,
-            });
-        }
-        throw err;
-    }
-})();
+export { recipesInstallSpec } from "./install.spec.js";
+export { runRecipesInstall } from "./install.run.js";

package/dist/commands/recipes/install.run.d.ts

@@ -0,0 +1,4 @@
+import type { CommandHandler } from "../../cli/spec/spec.js";
+import type { RecipesInstallParsed } from "./install.spec.js";
+export declare const runRecipesInstall: CommandHandler<RecipesInstallParsed>;
+//# sourceMappingURL=install.run.d.ts.map

package/dist/commands/recipes/install.run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.run.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/install.run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAKzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CAkB7D,CAAC"}

package/dist/commands/recipes/install.run.js

@@ -0,0 +1,23 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { CliError } from "../../shared/errors.js";
+import { cmdRecipeInstall } from "../recipes.js";
+import { recipesInstallSpec } from "./install.spec.js";
+export const runRecipesInstall = (ctx, p) => (async () => {
+    try {
+        return await cmdRecipeInstall({
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            ...p,
+        });
+    }
+    catch (err) {
+        if (err instanceof CliError && err.code === "E_USAGE") {
+            throw usageError({
+                spec: recipesInstallSpec,
+                command: "recipes install",
+                message: err.message,
+            });
+        }
+        throw err;
+    }
+})();

package/dist/commands/recipes/install.spec.d.ts

@@ -0,0 +1,11 @@
+import type { CommandSpec } from "../../cli/spec/spec.js";
+import type { RecipeConflictMode, RecipeInstallSource } from "../recipes.js";
+export type RecipesInstallParsed = {
+    source: RecipeInstallSource;
+    index?: string;
+    refresh: boolean;
+    yes: boolean;
+    onConflict: RecipeConflictMode;
+};
+export declare const recipesInstallSpec: CommandSpec<RecipesInstallParsed>;
+//# sourceMappingURL=install.spec.d.ts.map

package/dist/commands/recipes/install.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/install.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,kBAAkB,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CA4IhE,CAAC"}

package/dist/commands/recipes/install.spec.js

@@ -0,0 +1,140 @@
+import { usageError } from "../../cli/spec/errors.js";
+export const recipesInstallSpec = {
+    id: ["recipes", "install"],
+    group: "Recipes",
+    summary: "Install a recipe from remote index, local archive, or URL.",
+    synopsis: [
+        "agentplane recipes install <id|path|url> [--index <path|url>] [--refresh] [--yes] [--on-conflict <fail|rename|overwrite>]",
+        "agentplane recipes install --name <id> [--index <path|url>] [--refresh] [--yes] [--on-conflict <fail|rename|overwrite>]",
+        "agentplane recipes install --path <path> [--yes] [--on-conflict <fail|rename|overwrite>]",
+        "agentplane recipes install --url <url> [--yes] [--on-conflict <fail|rename|overwrite>]",
+    ],
+    args: [
+        {
+            name: "source",
+            required: false,
+            valueHint: "<id|path|url>",
+            description: "Auto mode: URL if http(s); else PATH if file exists; else NAME (remote index id).",
+        },
+    ],
+    options: [
+        {
+            kind: "string",
+            name: "name",
+            valueHint: "<id>",
+            description: "Install from remote index by recipe id.",
+        },
+        {
+            kind: "string",
+            name: "path",
+            valueHint: "<path>",
+            description: "Install from local recipe archive path.",
+        },
+        {
+            kind: "string",
+            name: "url",
+            valueHint: "<url>",
+            description: "Install from recipe archive URL.",
+        },
+        {
+            kind: "string",
+            name: "index",
+            valueHint: "<path|url>",
+            description: "Override recipes index location (used when installing by name / auto-name).",
+        },
+        {
+            kind: "boolean",
+            name: "refresh",
+            default: false,
+            description: "Refresh remote index cache before installing.",
+        },
+        {
+            kind: "boolean",
+            name: "yes",
+            default: false,
+            description: "Auto-approve network prompts when allowed by config.",
+        },
+        {
+            kind: "string",
+            name: "on-conflict",
+            valueHint: "<fail|rename|overwrite>",
+            choices: ["fail", "rename", "overwrite"],
+            default: "fail",
+            description: "How to handle conflicts when applying recipe agents.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const explicit = [raw.opts.name, raw.opts.path, raw.opts.url].filter(Boolean).length;
+        const hasPositional = Boolean(raw.args.source);
+        if (explicit + (hasPositional ? 1 : 0) !== 1) {
+            throw usageError({
+                spec: recipesInstallSpec,
+                message: "Exactly one source is required: <source> OR --name OR --path OR --url",
+                command: "recipes install",
+            });
+        }
+    },
+    parse: (raw) => {
+        const onConflict = (raw.opts["on-conflict"] ?? "fail");
+        const refresh = raw.opts.refresh === true;
+        const yes = raw.opts.yes === true;
+        const index = typeof raw.opts.index === "string" ? raw.opts.index : undefined;
+        if (raw.opts.name) {
+            return {
+                source: { type: "name", value: raw.opts.name },
+                index,
+                refresh,
+                yes,
+                onConflict,
+            };
+        }
+        if (raw.opts.path) {
+            return {
+                source: { type: "path", value: raw.opts.path },
+                index,
+                refresh,
+                yes,
+                onConflict,
+            };
+        }
+        if (raw.opts.url) {
+            return {
+                source: { type: "url", value: raw.opts.url },
+                index,
+                refresh,
+                yes,
+                onConflict,
+            };
+        }
+        const source = raw.args.source;
+        if (typeof source !== "string") {
+            throw usageError({
+                spec: recipesInstallSpec,
+                command: "recipes install",
+                message: "Missing source argument",
+            });
+        }
+        return {
+            source: { type: "auto", value: source },
+            index,
+            refresh,
+            yes,
+            onConflict,
+        };
+    },
+    examples: [
+        { cmd: "agentplane recipes install viewer", why: "Auto: install by id from remote index." },
+        {
+            cmd: "agentplane recipes install --name viewer --refresh",
+            why: "Install by id, forcing index refresh.",
+        },
+        {
+            cmd: "agentplane recipes install viewer --on-conflict overwrite",
+            why: "Apply recipe agents, overwriting conflicts.",
+        },
+    ],
+    notes: [
+        "Auto mode resolution matches v0.1.9: URL if http(s); else PATH if file exists; else NAME (remote index).",
+        "Network operations may require approval; use --yes to auto-approve when allowed by config.",
+    ],
+};

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

@@ -0,0 +1,11 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+export type ReleaseApplyFlags = {
+    plan?: string;
+    yes: boolean;
+    push: boolean;
+    remote: string;
+};
+export type ReleaseApplyParsed = ReleaseApplyFlags;
+export declare const releaseApplySpec: CommandSpec<ReleaseApplyParsed>;
+export declare const runReleaseApply: CommandHandler<ReleaseApplyParsed>;
+//# sourceMappingURL=apply.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAS1E,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;AA0KnD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAwE5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CA+H9D,CAAC"}