agentplane 0.1.9 → 0.2.0

package/dist/commands/task/set-status.command.js

@@ -0,0 +1,171 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskSetStatus } from "./set-status.js";
+function toStringList(v) {
+    if (typeof v === "string")
+        return [v];
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === "string");
+    return [];
+}
+export const taskSetStatusSpec = {
+    id: ["task", "set-status"],
+    group: "Task",
+    summary: "Change a task status (optionally committing from the comment body).",
+    args: [
+        { name: "task-id", required: true, valueHint: "<task-id>" },
+        { name: "status", required: true, valueHint: "<TODO|DOING|DONE|BLOCKED>" },
+    ],
+    options: [
+        {
+            kind: "string",
+            name: "author",
+            valueHint: "<id>",
+            description: "Optional. Comment/event author (requires --body).",
+        },
+        {
+            kind: "string",
+            name: "body",
+            valueHint: "<text>",
+            description: "Optional. Comment/event body (requires --author).",
+        },
+        {
+            kind: "string",
+            name: "commit",
+            valueHint: "<hash>",
+            description: "Optional. Record an existing commit hash/message into task metadata.",
+        },
+        {
+            kind: "boolean",
+            name: "force",
+            default: false,
+            description: "Allow unsafe transitions (and DONE without using agentplane finish).",
+        },
+        {
+            kind: "boolean",
+            name: "commit-from-comment",
+            default: false,
+            description: "Create a git commit from the provided comment body (requires --body).",
+        },
+        {
+            kind: "string",
+            name: "commit-emoji",
+            valueHint: "<emoji>",
+            description: "Optional. Emoji prefix used for commit-from-comment.",
+        },
+        {
+            kind: "string",
+            name: "commit-allow",
+            valueHint: "<path-prefix>",
+            repeatable: true,
+            description: "Repeatable. Allowlist prefix for commit-from-comment staging.",
+        },
+        {
+            kind: "boolean",
+            name: "commit-auto-allow",
+            default: false,
+            description: "Auto-derive allowlist prefixes from staged paths (commit-from-comment).",
+        },
+        {
+            kind: "boolean",
+            name: "commit-allow-tasks",
+            default: true,
+            description: "Allow committing under .agentplane/tasks when commit-from-comment is used.",
+        },
+        {
+            kind: "boolean",
+            name: "commit-require-clean",
+            default: false,
+            description: "Require a clean working tree before commit-from-comment.",
+        },
+        {
+            kind: "boolean",
+            name: "confirm-status-commit",
+            default: false,
+            description: "Confirm status-commit when status_commit_policy requires confirmation.",
+        },
+        {
+            kind: "boolean",
+            name: "quiet",
+            default: false,
+            description: "Suppress normal output (still prints errors).",
+        },
+    ],
+    examples: [
+        { cmd: "agentplane task set-status 202602030608-F1Q8AB DOING", why: "Mark task as DOING." },
+        {
+            cmd: 'agentplane task set-status 202602030608-F1Q8AB BLOCKED --author CODER --body "Waiting on upstream fix."',
+            why: "Add a status change note.",
+        },
+        {
+            cmd: 'agentplane task set-status 202602030608-F1Q8AB DOING --commit-from-comment --author CODER --body "Start: working on it" --commit-allow packages/agentplane',
+            why: "Create a commit from the comment body (subject to policy and allowlist).",
+        },
+    ],
+    validateRaw: (raw) => {
+        const author = raw.opts.author;
+        const body = raw.opts.body;
+        const hasAuthor = typeof author === "string" && author.trim() !== "";
+        const hasBody = typeof body === "string" && body.trim() !== "";
+        if (hasAuthor !== hasBody) {
+            throw usageError({
+                spec: taskSetStatusSpec,
+                message: "Both --author and --body must be provided together.",
+            });
+        }
+        if (raw.opts["commit-from-comment"] === true && !hasBody) {
+            throw usageError({
+                spec: taskSetStatusSpec,
+                message: "--body is required when using --commit-from-comment.",
+            });
+        }
+        const allow = toStringList(raw.opts["commit-allow"]);
+        if (allow.some((p) => p.trim() === "")) {
+            throw usageError({
+                spec: taskSetStatusSpec,
+                message: "Invalid value for --commit-allow: empty.",
+            });
+        }
+    },
+    parse: (raw) => {
+        const commitAllow = toStringList(raw.opts["commit-allow"]);
+        return {
+            taskId: String(raw.args["task-id"]),
+            status: String(raw.args.status),
+            author: typeof raw.opts.author === "string" ? raw.opts.author : undefined,
+            body: typeof raw.opts.body === "string" ? raw.opts.body : undefined,
+            commit: typeof raw.opts.commit === "string" ? raw.opts.commit : undefined,
+            force: raw.opts.force === true,
+            commitFromComment: raw.opts["commit-from-comment"] === true,
+            commitEmoji: typeof raw.opts["commit-emoji"] === "string" ? raw.opts["commit-emoji"] : undefined,
+            commitAllow,
+            commitAutoAllow: raw.opts["commit-auto-allow"] === true,
+            commitAllowTasks: raw.opts["commit-allow-tasks"] !== false,
+            commitRequireClean: raw.opts["commit-require-clean"] === true,
+            confirmStatusCommit: raw.opts["confirm-status-commit"] === true,
+            quiet: raw.opts.quiet === true,
+        };
+    },
+};
+export function makeRunTaskSetStatusHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskSetStatus({
+            ctx: await getCtx("task set-status"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            status: p.status,
+            author: p.author,
+            body: p.body,
+            commit: p.commit,
+            force: p.force,
+            commitFromComment: p.commitFromComment,
+            commitEmoji: p.commitEmoji,
+            commitAllow: p.commitAllow,
+            commitAutoAllow: p.commitAutoAllow,
+            commitAllowTasks: p.commitAllowTasks,
+            commitRequireClean: p.commitRequireClean,
+            confirmStatusCommit: p.confirmStatusCommit,
+            quiet: p.quiet,
+        });
+    };
+}

package/dist/commands/task/set-status.d.ts

@@ -1,4 +1,6 @@
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function cmdTaskSetStatus(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
     taskId: string;

package/dist/commands/task/set-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set-status.d.ts","sourceRoot":"","sources":["../../../src/commands/task/set-status.ts"],"names":[],"mappings":"AAoBA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,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;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4IlB"}
+{"version":3,"file":"set-status.d.ts","sourceRoot":"","sources":["../../../src/commands/task/set-status.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAcnC,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,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;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkJlB"}

package/dist/commands/task/set-status.js

@@ -3,7 +3,8 @@ import { successMessage, warnMessage } from "../../cli/output.js";
 import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
 import { CliError } from "../../shared/errors.js";
 import { commitFromComment } from "../guard/index.js";
-import { loadBackendTask, resolveDocUpdatedBy } from "../shared/task-backend.js";
+import { listTasksMemo, loadCommandContext, loadTaskFromContext, resolveDocUpdatedBy, } from "../shared/task-backend.js";
+import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
 import { appendTaskEvent, buildDependencyState, defaultCommitEmojiForStatus, enforceStatusCommitPolicy, isTransitionAllowed, normalizeTaskStatus, nowIso, readCommitInfo, } from "./shared.js";
 export async function cmdTaskSetStatus(opts) {
     const nextStatus = normalizeTaskStatus(opts.status);
@@ -22,11 +23,15 @@ export async function cmdTaskSetStatus(opts) {
         });
     }
     try {
-        const { backend, task, config, resolved } = await loadBackendTask({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-            taskId: opts.taskId,
-        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const config = ctx.config;
+        const resolved = ctx.resolvedProject;
+        const useStore = backendIsLocalFileBackend(ctx);
+        const store = useStore ? getTaskStore(ctx) : null;
+        const task = useStore
+            ? await store.get(opts.taskId)
+            : await loadTaskFromContext({ ctx, taskId: opts.taskId });
         if (opts.commitFromComment) {
             enforceStatusCommitPolicy({
                 policy: config.status_commit_policy,
@@ -44,7 +49,7 @@ export async function cmdTaskSetStatus(opts) {
             });
         }
         if (!opts.force && (nextStatus === "DOING" || nextStatus === "DONE")) {
-            const allTasks = await backend.listTasks();
+            const allTasks = await listTasksMemo(ctx);
             const depState = buildDependencyState(allTasks);
             const dep = depState.get(task.id);
             if (dep && (dep.missing.length > 0 || dep.incomplete.length > 0)) {
@@ -96,7 +101,7 @@ export async function cmdTaskSetStatus(opts) {
             const commitInfo = await readCommitInfo(resolved.gitRoot, opts.commit);
             next.commit = { hash: commitInfo.hash, message: commitInfo.message };
         }
-        await backend.writeTask(next);
+        await (useStore ? store.update(opts.taskId, () => next) : ctx.taskBackend.writeTask(next));
         // tasks.json is export-only; generated via `agentplane task export`.
         if (opts.commitFromComment) {
             if (!opts.body) {
@@ -107,6 +112,7 @@ export async function cmdTaskSetStatus(opts) {
                 });
             }
             await commitFromComment({
+                ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: opts.taskId,

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

@@ -1,13 +1,18 @@
 import { execFile } from "node:child_process";
 import { type AgentplaneConfig } from "@agentplaneorg/core";
 import { type TaskData, type TaskEvent } from "../../backends/task-backend.js";
+import type { CommandContext } from "../shared/task-backend.js";
 export { dedupeStrings } from "../../shared/strings.js";
 export declare const execFileAsync: typeof execFile.__promisify__;
 export declare function nowIso(): string;
+export declare const VERIFY_STEPS_PLACEHOLDER = "<!-- TODO: FILL VERIFY STEPS -->";
+export declare function extractDocSection(doc: string, sectionName: string): string | null;
+export declare function isVerifyStepsFilled(sectionText: string | null): boolean;
 export declare function normalizeDependsOnInput(value: string): string[];
 export declare function normalizeTaskStatus(value: string): string;
 export declare function toStringArray(value: unknown): string[];
 export declare function requiresVerify(tags: string[], requiredTags: string[]): boolean;
+export declare function warnIfUnknownOwner(ctx: CommandContext, owner: string): Promise<void>;
 export declare function appendTaskEvent(task: TaskData, event: TaskEvent): TaskEvent[];
 export declare function ensurePlanApprovedIfRequired(task: TaskData, config: AgentplaneConfig): void;
 export declare function ensureVerificationSatisfiedIfRequired(task: TaskData, config: AgentplaneConfig): void;

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

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

package/dist/commands/task/shared.js

@@ -1,6 +1,9 @@
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
+import { readdir } from "node:fs/promises";
+import path from "node:path";
 import { invalidValueForFlag, invalidValueMessage, missingValueMessage, warnMessage, } from "../../cli/output.js";
+import { fileExists } from "../../cli/fs-utils.js";
 import { CliError } from "../../shared/errors.js";
 import { dedupeStrings } from "../../shared/strings.js";
 import { parseGitLogHashSubject } from "../../shared/git-log.js";
@@ -9,6 +12,34 @@ export const execFileAsync = promisify(execFile);
 export function nowIso() {
     return new Date().toISOString();
 }
+export const VERIFY_STEPS_PLACEHOLDER = "<!-- TODO: FILL VERIFY STEPS -->";
+export function extractDocSection(doc, sectionName) {
+    const lines = doc.replaceAll("\r\n", "\n").split("\n");
+    let capturing = false;
+    const out = [];
+    for (const line of lines) {
+        const match = /^##\s+(.*)$/.exec(line.trim());
+        if (match) {
+            if (capturing)
+                break;
+            capturing = (match[1] ?? "").trim() === sectionName;
+            continue;
+        }
+        if (capturing)
+            out.push(line);
+    }
+    if (!capturing)
+        return null;
+    return out.join("\n").trimEnd();
+}
+export function isVerifyStepsFilled(sectionText) {
+    const normalized = (sectionText ?? "").trim();
+    if (!normalized)
+        return false;
+    if (normalized.includes(VERIFY_STEPS_PLACEHOLDER))
+        return false;
+    return true;
+}
 export function normalizeDependsOnInput(value) {
     const trimmed = value.trim();
     if (!trimmed || trimmed === "[]")
@@ -40,6 +71,25 @@ export function requiresVerify(tags, requiredTags) {
         return false;
     return tags.some((tag) => required.has(tag.trim().toLowerCase()));
 }
+export async function warnIfUnknownOwner(ctx, owner) {
+    const trimmed = owner.trim();
+    if (!trimmed)
+        return;
+    const agentsDir = path.join(ctx.resolvedProject.gitRoot, ctx.config.paths.agents_dir);
+    if (!(await fileExists(agentsDir)))
+        return;
+    const entries = await readdir(agentsDir);
+    const ids = entries
+        .filter((name) => name.endsWith(".json"))
+        .map((name) => name.slice(0, -".json".length))
+        .filter((id) => id.trim().length > 0);
+    if (ids.length === 0)
+        return;
+    if (!ids.includes(trimmed)) {
+        process.stderr.write(`${warnMessage(`unknown task owner id: ${trimmed} (not found under ${ctx.config.paths.agents_dir}; ` +
+            `pick an existing agent id or create ${ctx.config.paths.agents_dir}/${trimmed}.json)`)}\n`);
+    }
+}
 export function appendTaskEvent(task, event) {
     const existing = Array.isArray(task.events)
         ? task.events.filter((entry) => !!entry &&

package/dist/commands/task/show.command.d.ts

@@ -0,0 +1,8 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskShowParsed = {
+    taskId: string;
+};
+export declare const taskShowSpec: CommandSpec<TaskShowParsed>;
+export declare function makeRunTaskShowHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskShowParsed) => Promise<number>;
+//# sourceMappingURL=show.command.d.ts.map

package/dist/commands/task/show.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/show.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CAOpD,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACvE,KAAK,UAAU,EAAE,GAAG,cAAc,KAAG,OAAO,CAAC,MAAM,CAAC,CAQnE"}

package/dist/commands/task/show.command.js

@@ -0,0 +1,19 @@
+import { cmdTaskShow } from "./show.js";
+export const taskShowSpec = {
+    id: ["task", "show"],
+    group: "Task",
+    summary: "Print task metadata as JSON (frontmatter shape).",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    examples: [{ cmd: "agentplane task show 202602030608-F1Q8AB", why: "Show task metadata." }],
+    parse: (raw) => ({ taskId: String(raw.args["task-id"]) }),
+};
+export function makeRunTaskShowHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskShow({
+            ctx: await getCtx("task show"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+        });
+    };
+}

package/dist/commands/task/show.d.ts

@@ -1,4 +1,6 @@
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function cmdTaskShow(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
     taskId: string;

package/dist/commands/task/show.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/task/show.ts"],"names":[],"mappings":"AAOA,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB"}
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/task/show.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAEnC,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BlB"}

package/dist/commands/task/show.js

@@ -1,16 +1,14 @@
 import { validateTaskDocMetadata } from "@agentplaneorg/core";
 import { mapBackendError } from "../../cli/error-map.js";
 import { CliError } from "../../shared/errors.js";
-import { loadBackendTask, taskDataToFrontmatter } from "../shared/task-backend.js";
+import { loadCommandContext, loadTaskFromContext, taskDataToFrontmatter, } from "../shared/task-backend.js";
 export async function cmdTaskShow(opts) {
     try {
-        const { task, backendId } = await loadBackendTask({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride,
-            taskId: opts.taskId,
-        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const task = await loadTaskFromContext({ ctx, taskId: opts.taskId });
         const frontmatter = taskDataToFrontmatter(task);
-        if (backendId === "local") {
+        if (ctx.backendId === "local") {
             const metadataErrors = validateTaskDocMetadata(frontmatter);
             if (metadataErrors.length > 0) {
                 throw new CliError({

package/dist/commands/task/start.d.ts

@@ -1,6 +1,6 @@
-export declare const START_USAGE = "Usage: agentplane start <task-id> --author <id> --body <text> [flags]";
-export declare const START_USAGE_EXAMPLE = "agentplane start 202602030608-F1Q8AB --author CODER --body \"Start: ...\"";
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function cmdStart(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
     taskId: string;

package/dist/commands/task/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/task/start.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,WAAW,0EAA0E,CAAC;AACnG,eAAO,MAAM,mBAAmB,8EAC2C,CAAC;AAE5E,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,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,GAAG,OAAO,CAAC,MAAM,CAAC,CAyHlB"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/task/start.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAiBnC,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,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,GAAG,OAAO,CAAC,MAAM,CAAC,CAqKlB"}

package/dist/commands/task/start.js

@@ -3,16 +3,13 @@ import { successMessage, warnMessage } from "../../cli/output.js";
 import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
 import { CliError } from "../../shared/errors.js";
 import { commitFromComment } from "../guard/index.js";
-import { loadCommandContext, loadTaskFromContext } from "../shared/task-backend.js";
-import { appendTaskEvent, buildDependencyState, ensurePlanApprovedIfRequired, enforceStatusCommitPolicy, isTransitionAllowed, nowIso, requireStructuredComment, } from "./shared.js";
-export const START_USAGE = "Usage: agentplane start <task-id> --author <id> --body <text> [flags]";
-export const START_USAGE_EXAMPLE = 'agentplane start 202602030608-F1Q8AB --author CODER --body "Start: ..."';
+import { listTasksMemo, loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
+import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
+import { appendTaskEvent, buildDependencyState, ensurePlanApprovedIfRequired, enforceStatusCommitPolicy, extractDocSection, isVerifyStepsFilled, isTransitionAllowed, nowIso, requiresVerify, requireStructuredComment, toStringArray, } from "./shared.js";
 export async function cmdStart(opts) {
     try {
-        const ctx = await loadCommandContext({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
         if (opts.commitFromComment) {
             enforceStatusCommitPolicy({
                 policy: ctx.config.status_commit_policy,
@@ -23,7 +20,44 @@ export async function cmdStart(opts) {
         }
         const { prefix, min_chars: minChars } = ctx.config.tasks.comments.start;
         requireStructuredComment(opts.body, prefix, minChars);
-        const task = await loadTaskFromContext({ ctx, taskId: opts.taskId });
+        const useStore = backendIsLocalFileBackend(ctx);
+        const store = useStore ? getTaskStore(ctx) : null;
+        const task = useStore
+            ? await store.get(opts.taskId)
+            : await loadTaskFromContext({ ctx, taskId: opts.taskId });
+        if (ctx.config.agents?.approvals?.require_plan !== true) {
+            const enforce = ctx.config.tasks.verify.enforce_on_start_when_no_plan !== false;
+            if (enforce) {
+                const tags = toStringArray(task.tags);
+                const requireStepsTags = ctx.config.tasks.verify.require_steps_for_tags ?? ctx.config.tasks.verify.required_tags;
+                const spikeTag = (ctx.config.tasks.verify.spike_tag ?? "spike").trim().toLowerCase();
+                const verifyRequired = requiresVerify(tags, requireStepsTags);
+                const isSpike = tags.some((tag) => tag.trim().toLowerCase() === spikeTag);
+                const doc = typeof task.doc === "string" ? task.doc : "";
+                if (verifyRequired || isSpike) {
+                    const verifySteps = extractDocSection(doc, "Verify Steps");
+                    if (!isVerifyStepsFilled(verifySteps)) {
+                        throw new CliError({
+                            exitCode: 3,
+                            code: "E_VALIDATION",
+                            message: `${task.id}: cannot start work: ## Verify Steps section is missing/empty/unfilled ` +
+                                "(fill it before starting work when plan approval is disabled)",
+                        });
+                    }
+                }
+                if (isSpike) {
+                    const notes = extractDocSection(doc, "Notes");
+                    if (!notes || notes.trim().length === 0) {
+                        throw new CliError({
+                            exitCode: 3,
+                            code: "E_VALIDATION",
+                            message: `${task.id}: cannot start spike: ## Notes section is missing or empty ` +
+                                "(include Findings/Decision/Next Steps)",
+                        });
+                    }
+                }
+            }
+        }
         ensurePlanApprovedIfRequired(task, ctx.config);
         const currentStatus = String(task.status || "TODO").toUpperCase();
         if (!opts.force && !isTransitionAllowed(currentStatus, "DOING")) {
@@ -34,7 +68,7 @@ export async function cmdStart(opts) {
             });
         }
         if (!opts.force) {
-            const allTasks = await ctx.backend.listTasks();
+            const allTasks = await listTasksMemo(ctx);
             const depState = buildDependencyState(allTasks);
             const dep = depState.get(task.id);
             if (dep && (dep.missing.length > 0 || dep.incomplete.length > 0)) {
@@ -81,10 +115,13 @@ export async function cmdStart(opts) {
             doc_updated_at: at,
             doc_updated_by: opts.author,
         };
-        await ctx.backend.writeTask(nextTask);
+        await (useStore
+            ? store.update(opts.taskId, () => nextTask)
+            : ctx.taskBackend.writeTask(nextTask));
         let commitInfo = null;
         if (opts.commitFromComment) {
             commitInfo = await commitFromComment({
+                ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: opts.taskId,

package/dist/commands/task/update.command.d.ts

@@ -0,0 +1,18 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskUpdateParsed = {
+    taskId: string;
+    title?: string;
+    description?: string;
+    priority?: "low" | "normal" | "med" | "high";
+    owner?: string;
+    tags: string[];
+    replaceTags: boolean;
+    dependsOn: string[];
+    replaceDependsOn: boolean;
+    verify: string[];
+    replaceVerify: boolean;
+};
+export declare const taskUpdateSpec: CommandSpec<TaskUpdateParsed>;
+export declare function makeRunTaskUpdateHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskUpdateParsed) => Promise<number>;
+//# sourceMappingURL=update.command.d.ts.map

package/dist/commands/task/update.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/update.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAQF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAiHxD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACzE,KAAK,UAAU,EAAE,GAAG,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAAC,CAkBrE"}