agentplane 0.1.8 → 0.2.0

package/dist/backends/task-index.js

@@ -1,6 +1,6 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { atomicWriteFile } from "@agentplaneorg/core";
+import { writeJsonStableIfChanged } from "../shared/write-if-changed.js";
 export const TASK_INDEX_SCHEMA_VERSION = 1;
 const TASK_INDEX_FILENAME = "tasks-index.v1.json";
 export function resolveTaskIndexPath(tasksDir) {
@@ -70,7 +70,7 @@ export async function loadTaskIndex(indexPath) {
     return { schema_version: TASK_INDEX_SCHEMA_VERSION, tasks };
 }
 export async function saveTaskIndex(indexPath, index) {
-    await atomicWriteFile(indexPath, `${JSON.stringify(index, null, 2)}\n`, "utf8");
+    await writeJsonStableIfChanged(indexPath, index);
 }
 export function buildTaskIndexEntry(task, readmePath, mtimeMs) {
     return {

package/dist/cli/archive.d.ts

@@ -8,8 +8,6 @@ export declare function detectArchiveType(filePath: string): ArchiveType | null;
 export declare function extractArchive(opts: {
     archivePath: string;
     destDir: string;
-    usage: string;
-    example?: string;
 }): Promise<void>;
 export declare function validateArchiveEntries(entries: string[], symlinks: string[]): ArchiveEntryIssue[];
 export {};

package/dist/cli/archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/cli/archive.ts"],"names":[],"mappings":"AAYA,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK,CAAC;AAOjC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAU9B;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAKtE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,CA2BjG"}
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/cli/archive.ts"],"names":[],"mappings":"AAWA,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK,CAAC;AAOjC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAU9B;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAKtE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,CA2BjG"}

package/dist/cli/archive.js

@@ -4,7 +4,6 @@ import path from "node:path";
 import yauzl from "yauzl";
 import { CliError } from "../shared/errors.js";
 import { exitCodeForError } from "./exit-codes.js";
-import { usageMessage } from "./output.js";
 const execFileAsync = promisify(execFile);
 export async function validateArchive(archivePath, type) {
     if (type === "zip") {
@@ -31,7 +30,7 @@ export async function extractArchive(opts) {
         throw new CliError({
             exitCode: 2,
             code: "E_USAGE",
-            message: usageMessage(opts.usage, opts.example),
+            message: `Unsupported archive type: ${opts.archivePath} (expected .tar.gz, .tgz, or .zip)`,
         });
     }
     const issues = await validateArchive(opts.archivePath, archiveType);

package/dist/cli/command-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-guide.d.ts","sourceRoot":"","sources":["../../src/cli/command-guide.ts"],"names":[],"mappings":"AA6KA,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CA4EzC"}
+{"version":3,"file":"command-guide.d.ts","sourceRoot":"","sources":["../../src/cli/command-guide.ts"],"names":[],"mappings":"AA+LA,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CA2EzC"}

package/dist/cli/command-guide.js

@@ -3,9 +3,13 @@ const CHEAT_SHEET_ROWS = [
         operation: "PLANNER: list/show tasks",
         command: "`agentplane task list` / `agentplane task show <task-id>`",
     },
+    {
+        operation: "PLANNER: set/approve/reject plan",
+        command: '`agentplane task plan set <task-id> --text "..." --updated-by <id>` / `agentplane task plan approve <task-id> --by <id> --note "OK"`',
+    },
     {
         operation: "PLANNER: create task (auto ID)",
-        command: '`agentplane task new --title "..." --description "..." --priority med --owner CODER --tag <tag>`',
+        command: '`agentplane task new --title "..." --description "..." --priority med --owner CODER --tag <tag> [--depends-on <task-id|json>]`',
     },
     {
         operation: "PLANNER: add/update task",
@@ -15,6 +19,10 @@ const CHEAT_SHEET_ROWS = [
         operation: "PLANNER: scaffold artifact",
         command: "`agentplane task scaffold <task-id>`",
     },
+    {
+        operation: "PLANNER: derive implementation from spike",
+        command: '`agentplane task derive <spike-id> --title "..." --description "..." --priority med --owner CODER --tag code`',
+    },
     {
         operation: "Config: show/set",
         command: "`agentplane config show` / `agentplane config set <key> <value>`",
@@ -35,6 +43,10 @@ const CHEAT_SHEET_ROWS = [
         operation: "CODER/TESTER: verify task",
         command: '`agentplane verify <task-id> --ok|--rework --by <id> --note "..."` (record-only; appends to README)',
     },
+    {
+        operation: "CODER/TESTER: print Verify Steps",
+        command: "`agentplane task verify-show <task-id>`",
+    },
     {
         operation: "REVIEWER: check PR artifacts",
         command: "`agentplane pr check <task-id>`",
@@ -45,11 +57,11 @@ const CHEAT_SHEET_ROWS = [
     },
     {
         operation: "INTEGRATOR: finish task(s)",
-        command: '`agentplane finish <task-id> [<task-id> ...] --commit <git-rev> --author INTEGRATOR --body "Verified: ..."`',
+        command: '`agentplane finish <task-id> [<task-id> ...] --commit <git-rev> --author INTEGRATOR --body "Verified: ..." [--result "<one line>"]`',
     },
     {
         operation: "INTEGRATOR: commit closure",
-        command: '`agentplane commit <task-id> -m "<emoji> <suffix> close: <detailed changelog ...>" --auto-allow --allow-tasks --require-clean`',
+        command: "`agentplane commit <task-id> --close`",
     },
 ];
 const ROLE_GUIDES = [
@@ -59,6 +71,7 @@ const ROLE_GUIDES = [
             "- Plan intake: `agentplane task list` / `agentplane task show <task-id>`",
             '- After plan approval (unless the user opts out): `agentplane task new --title "..." --description "..." --priority med --owner ORCHESTRATOR --depends-on "[]" --tag <tag>`',
             "- Optional scaffold: `agentplane task scaffold <task-id>`",
+            "- Two-stage verification: `## Verify Steps` is the ex-ante contract; `agentplane verify ...` appends an ex-post entry into `## Verification`.",
         ],
     },
     {
@@ -68,29 +81,33 @@ const ROLE_GUIDES = [
             '- Create tasks: `agentplane task new --title "..." --description "..." --priority med --owner <ROLE> --depends-on "[]" --tag <tag>` (tags are required; use `task add` only for imported IDs)',
             '- Update tasks: `agentplane task update <task-id> --title "..." --description "..." --priority med --owner <ROLE> --depends-on <task-id>`',
             "- Scaffold artifacts: `agentplane task scaffold <task-id>`",
+            '- Plan lifecycle: `agentplane task plan set <task-id> --text "..." --updated-by <ROLE>` -> `agentplane task plan approve <task-id> --by <id>`',
+            "- Verify Steps discipline: if a task has verify-required tags (default: code/backend/frontend), fill `## Verify Steps` before plan approval.",
             '- Task docs (when planning needs it): `agentplane task doc set <task-id> --section Summary --text "..."`',
         ],
     },
     {
         role: "CODER",
         lines: [
-            "- direct mode: work in the current checkout; optional `agentplane work start <task-id> --agent <ROLE> --slug <slug>` only scaffolds docs",
+            "- direct mode: work in the current checkout; `agentplane work start <task-id> --agent <ROLE> --slug <slug>` creates/checks out `task/<task-id>/<slug>` in-place (no worktree). Use `agentplane task scaffold <task-id>` for docs without switching branches.",
             "- branch_pr: `agentplane work start <task-id> --agent <ROLE> --slug <slug> --worktree`",
             '- Status updates: `agentplane start <task-id> --author <ROLE> --body "Start: ..."` / `agentplane block <task-id> --author <ROLE> --body "Blocked: ..."`',
+            "- Verify Steps: `agentplane task verify-show <task-id>` (use as the verification contract before recording results).",
             '- Verify: `agentplane verify <task-id> --ok|--rework --by <ROLE> --note "..."`',
             '- PR artifacts (branch_pr): `agentplane pr open <task-id> --branch task/<task-id>/<slug> --author <ROLE>` / `agentplane pr update <task-id>` / `agentplane pr note <task-id> --author <ROLE> --body "..."`',
-            '- Commit: `agentplane guard commit <task-id> -m "<emoji> <suffix> ..."` / `agentplane commit <task-id> -m "<emoji> <suffix> ..." --allow <path-prefix>`',
+            '- Commit: `agentplane guard commit <task-id> -m "<emoji> <suffix> <scope>: <summary>"` / `agentplane commit <task-id> -m "<emoji> <suffix> <scope>: <summary>" --allow <path-prefix>` / close: `agentplane commit <task-id> --close`',
         ],
     },
     {
         role: "TESTER",
         lines: [
-            "- direct mode: work in the current checkout; optional `agentplane work start <task-id> --agent <ROLE> --slug <slug>` only scaffolds docs",
+            "- direct mode: work in the current checkout; `agentplane work start <task-id> --agent <ROLE> --slug <slug>` creates/checks out `task/<task-id>/<slug>` in-place (no worktree). Use `agentplane task scaffold <task-id>` for docs without switching branches.",
             "- branch_pr: `agentplane work start <task-id> --agent <ROLE> --slug <slug> --worktree`",
             '- Status updates: `agentplane start <task-id> --author <ROLE> --body "Start: ..."` / `agentplane block <task-id> --author <ROLE> --body "Blocked: ..."`',
+            "- Verify Steps: `agentplane task verify-show <task-id>` (treat as the verification contract).",
             '- Verify: `agentplane verify <task-id> --ok|--rework --by <ROLE> --note "..."`',
             '- PR artifacts (branch_pr): `agentplane pr open <task-id> --branch task/<task-id>/<slug> --author <ROLE>` / `agentplane pr update <task-id>` / `agentplane pr note <task-id> --author <ROLE> --body "..."`',
-            '- Commit: `agentplane guard commit <task-id> -m "<emoji> <suffix> ..."` / `agentplane commit <task-id> -m "<emoji> <suffix> ..." --allow <path-prefix>`',
+            '- Commit: `agentplane guard commit <task-id> -m "<emoji> <suffix> <scope>: <summary>"` / `agentplane commit <task-id> -m "<emoji> <suffix> <scope>: <summary>" --allow <path-prefix>` / close: `agentplane commit <task-id> --close`',
         ],
     },
     {
@@ -98,7 +115,7 @@ const ROLE_GUIDES = [
         lines: [
             '- Task docs: `agentplane task doc set <task-id> --section Summary --text "..."` (repeat per section or use `--file`)',
             '- PR notes: `agentplane pr note <task-id> --author DOCS --body "..."`',
-            '- Commit: `agentplane guard commit <task-id> -m "<emoji> <suffix> ..."` / `agentplane commit <task-id> -m "<emoji> <suffix> ..." --allow <path-prefix>`',
+            '- Commit: `agentplane guard commit <task-id> -m "<emoji> <suffix> <scope>: <summary>"` / `agentplane commit <task-id> -m "<emoji> <suffix> <scope>: <summary>" --allow <path-prefix>` / close: `agentplane commit <task-id> --close`',
         ],
     },
     {
@@ -120,7 +137,7 @@ const ROLE_GUIDES = [
         role: "CREATOR",
         lines: [
             '- Task bookkeeping: `agentplane task update <task-id> ...` / `agentplane start <task-id> --author CREATOR --body "Start: ..."`',
-            '- Commits: `agentplane guard commit <task-id> -m "<emoji> <suffix> ..."` / `agentplane commit <task-id> -m "<emoji> <suffix> ..." --allow <path-prefix>`',
+            '- Commits: `agentplane guard commit <task-id> -m "<emoji> <suffix> <scope>: <summary>"` / `agentplane commit <task-id> -m "<emoji> <suffix> <scope>: <summary>" --allow <path-prefix>`',
         ],
     },
     {
@@ -235,11 +252,10 @@ export function renderQuickstart() {
         "",
         "## Commit message format",
         "",
-        "Use: `<emoji> <suffix> <detailed changelog ...>`.",
+        "Use: `<emoji> <suffix> <scope>: <summary>`.",
         "",
         "Notes:",
         "- `suffix` is the task ID segment after the last dash.",
-        "- For batch commits, include every task suffix in the subject.",
-        "- When using comment-driven flags, the subject is auto-built as `<emoji> <suffix> <formatted comment>` from your status/finish body.",
+        "- When using comment-driven flags, the subject is auto-built as `<emoji> <suffix> <scope>: <summary>`, and the body is auto-built from your status/finish comment.",
     ].join("\n");
 }

package/dist/cli/parse/lifecycle.d.ts

@@ -0,0 +1,64 @@
+export type UsageStrings = {
+    usage: string;
+    example: string;
+};
+export type ParsedStart = {
+    taskId: string;
+    author: string;
+    body: string;
+    commitFromComment: boolean;
+    commitEmoji: string | undefined;
+    commitAllow: string[];
+    commitAutoAllow: boolean;
+    commitAllowTasks: boolean;
+    commitRequireClean: boolean;
+    confirmStatusCommit: boolean;
+    force: boolean;
+    quiet: boolean;
+};
+export type ParsedBlock = ParsedStart;
+export type ParsedVerify = {
+    taskId: string;
+    args: string[];
+};
+export type ParsedFinish = {
+    taskIds: string[];
+    author: string;
+    body: string;
+    commit: string | undefined;
+    force: boolean;
+    commitFromComment: boolean;
+    commitEmoji: string | undefined;
+    commitAllow: string[];
+    commitAutoAllow: boolean;
+    commitAllowTasks: boolean;
+    commitRequireClean: boolean;
+    statusCommit: boolean;
+    statusCommitEmoji: string | undefined;
+    statusCommitAllow: string[];
+    statusCommitAutoAllow: boolean;
+    statusCommitRequireClean: boolean;
+    confirmStatusCommit: boolean;
+    quiet: boolean;
+};
+export declare function parseStart(opts: {
+    taskIdToken: string | undefined;
+    args: string[];
+    usage: UsageStrings;
+}): ParsedStart;
+export declare function parseBlock(opts: {
+    taskIdToken: string | undefined;
+    args: string[];
+    usage: UsageStrings;
+}): ParsedBlock;
+export declare function parseVerify(opts: {
+    taskIdToken: string | undefined;
+    args: string[];
+    usage: UsageStrings;
+}): ParsedVerify;
+export declare function parseFinish(opts: {
+    commandToken: string | undefined;
+    args: string[];
+    usage: UsageStrings;
+}): ParsedFinish;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/cli/parse/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/cli/parse/lifecycle.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAEtC,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AA8GF,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,WAAW,CAEd;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,WAAW,CAEd;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,YAAY,CAGf;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,YAAY,CA2Jf"}

package/dist/cli/parse/lifecycle.js

@@ -0,0 +1,280 @@
+import { CliError } from "../../shared/errors.js";
+import { usageMessage } from "../output.js";
+function usageError(u) {
+    return new CliError({ exitCode: 2, code: "E_USAGE", message: usageMessage(u.usage, u.example) });
+}
+function requireTaskId(taskIdToken, u) {
+    if (!taskIdToken || taskIdToken.startsWith("-"))
+        throw usageError(u);
+    return taskIdToken;
+}
+function parseLifecycleLike(opts) {
+    const taskId = requireTaskId(opts.taskIdToken, opts.usage);
+    let author = "";
+    let body = "";
+    let commitFromComment = false;
+    let commitEmoji;
+    const commitAllow = [];
+    let commitAutoAllow = false;
+    let commitAllowTasks = true;
+    let commitRequireClean = false;
+    let confirmStatusCommit = false;
+    let force = false;
+    let quiet = false;
+    for (let i = 0; i < opts.args.length; i++) {
+        const arg = opts.args[i];
+        if (!arg)
+            continue;
+        if (arg === "--author") {
+            const next = opts.args[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            author = next;
+            i++;
+            continue;
+        }
+        if (arg === "--body") {
+            const next = opts.args[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            body = next;
+            i++;
+            continue;
+        }
+        if (arg === "--commit-from-comment") {
+            commitFromComment = true;
+            continue;
+        }
+        if (arg === "--commit-emoji") {
+            const next = opts.args[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            commitEmoji = next;
+            i++;
+            continue;
+        }
+        if (arg === "--commit-allow") {
+            const next = opts.args[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            commitAllow.push(next);
+            i++;
+            continue;
+        }
+        if (arg === "--commit-auto-allow") {
+            commitAutoAllow = true;
+            continue;
+        }
+        if (arg === "--commit-allow-tasks") {
+            commitAllowTasks = true;
+            continue;
+        }
+        if (arg === "--commit-require-clean") {
+            commitRequireClean = true;
+            continue;
+        }
+        if (arg === "--confirm-status-commit") {
+            confirmStatusCommit = true;
+            continue;
+        }
+        if (arg === "--force") {
+            force = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            quiet = true;
+            continue;
+        }
+        if (arg.startsWith("--"))
+            throw usageError(opts.usage);
+    }
+    if (!author || !body)
+        throw usageError(opts.usage);
+    return {
+        taskId,
+        author,
+        body,
+        commitFromComment,
+        commitEmoji,
+        commitAllow,
+        commitAutoAllow,
+        commitAllowTasks,
+        commitRequireClean,
+        confirmStatusCommit,
+        force,
+        quiet,
+    };
+}
+export function parseStart(opts) {
+    return parseLifecycleLike(opts);
+}
+export function parseBlock(opts) {
+    return parseLifecycleLike(opts);
+}
+export function parseVerify(opts) {
+    const taskId = requireTaskId(opts.taskIdToken, opts.usage);
+    return { taskId, args: opts.args };
+}
+export function parseFinish(opts) {
+    let finishArgs = opts.args;
+    const taskIds = [];
+    if (opts.commandToken && !opts.commandToken.startsWith("--")) {
+        taskIds.push(opts.commandToken);
+    }
+    else if (opts.commandToken?.startsWith("-")) {
+        finishArgs = [opts.commandToken, ...opts.args];
+    }
+    let argIndex = 0;
+    while (argIndex < finishArgs.length) {
+        const arg = finishArgs[argIndex];
+        if (!arg || arg.startsWith("--"))
+            break;
+        taskIds.push(arg);
+        argIndex += 1;
+    }
+    const flagArgs = finishArgs.slice(argIndex);
+    if (taskIds.length === 0)
+        throw usageError(opts.usage);
+    let author = "";
+    let body = "";
+    let commit;
+    let force = false;
+    let commitFromComment = false;
+    let commitEmoji;
+    const commitAllow = [];
+    let commitAutoAllow = false;
+    let commitAllowTasks = true;
+    let commitRequireClean = false;
+    let statusCommit = false;
+    let statusCommitEmoji;
+    const statusCommitAllow = [];
+    let statusCommitAutoAllow = false;
+    let statusCommitRequireClean = false;
+    let confirmStatusCommit = false;
+    let quiet = false;
+    for (let i = 0; i < flagArgs.length; i++) {
+        const arg = flagArgs[i];
+        if (!arg)
+            continue;
+        if (arg === "--author") {
+            const next = flagArgs[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            author = next;
+            i++;
+            continue;
+        }
+        if (arg === "--body") {
+            const next = flagArgs[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            body = next;
+            i++;
+            continue;
+        }
+        if (arg === "--commit") {
+            const next = flagArgs[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            commit = next;
+            i++;
+            continue;
+        }
+        if (arg === "--force") {
+            force = true;
+            continue;
+        }
+        if (arg === "--commit-from-comment") {
+            commitFromComment = true;
+            continue;
+        }
+        if (arg === "--commit-emoji") {
+            const next = flagArgs[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            commitEmoji = next;
+            i++;
+            continue;
+        }
+        if (arg === "--commit-allow") {
+            const next = flagArgs[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            commitAllow.push(next);
+            i++;
+            continue;
+        }
+        if (arg === "--commit-auto-allow") {
+            commitAutoAllow = true;
+            continue;
+        }
+        if (arg === "--commit-allow-tasks") {
+            commitAllowTasks = true;
+            continue;
+        }
+        if (arg === "--commit-require-clean") {
+            commitRequireClean = true;
+            continue;
+        }
+        if (arg === "--status-commit") {
+            statusCommit = true;
+            continue;
+        }
+        if (arg === "--status-commit-emoji") {
+            const next = flagArgs[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            statusCommitEmoji = next;
+            i++;
+            continue;
+        }
+        if (arg === "--status-commit-allow") {
+            const next = flagArgs[i + 1];
+            if (!next)
+                throw usageError(opts.usage);
+            statusCommitAllow.push(next);
+            i++;
+            continue;
+        }
+        if (arg === "--status-commit-auto-allow") {
+            statusCommitAutoAllow = true;
+            continue;
+        }
+        if (arg === "--status-commit-require-clean") {
+            statusCommitRequireClean = true;
+            continue;
+        }
+        if (arg === "--confirm-status-commit") {
+            confirmStatusCommit = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            quiet = true;
+            continue;
+        }
+        if (arg.startsWith("--"))
+            throw usageError(opts.usage);
+    }
+    if (!author || !body)
+        throw usageError(opts.usage);
+    return {
+        taskIds,
+        author,
+        body,
+        commit,
+        force,
+        commitFromComment,
+        commitEmoji,
+        commitAllow,
+        commitAutoAllow,
+        commitAllowTasks,
+        commitRequireClean,
+        statusCommit,
+        statusCommitEmoji,
+        statusCommitAllow,
+        statusCommitAutoAllow,
+        statusCommitRequireClean,
+        confirmStatusCommit,
+        quiet,
+    };
+}

package/dist/cli/run-cli/command-catalog.d.ts

@@ -0,0 +1,16 @@
+import type { CommandHandler, CommandSpec } from "../spec/spec.js";
+import type { HelpJson } from "../spec/help-render.js";
+import type { CommandContext } from "../../commands/shared/task-backend.js";
+export type RunDeps = {
+    getCtx: (commandForErrorContext: string) => Promise<CommandContext>;
+    getHelpJsonForDocs: () => readonly HelpJson[];
+};
+export type CommandEntry = {
+    spec: CommandSpec<unknown>;
+    load: (deps: RunDeps) => Promise<CommandHandler<unknown>>;
+    needsProject: boolean;
+    needsConfig: boolean;
+    needsTaskContext: boolean;
+};
+export declare const COMMANDS: readonly [CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry];
+//# sourceMappingURL=command-catalog.d.ts.map

package/dist/cli/run-cli/command-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AA4FvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,kBAAkB,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAgBF,eAAO,MAAM,QAAQ,mqCA+UuB,CAAC"}