agentplane 0.3.7 → 0.3.9

package/dist/commands/task/shared/docs.js

@@ -1,3 +1,4 @@
+import { normalizeDocSectionName } from "@agentplaneorg/core";
 import { CliError } from "../../../shared/errors.js";
 import { dedupeStrings } from "../../../shared/strings.js";
 export function nowIso() {
@@ -89,6 +90,18 @@ export function extractTaskObservationSection(doc, version) {
     const fallback = primary === "Findings" ? "Notes" : "Findings";
     return extractDocSection(doc, primary) ?? extractDocSection(doc, fallback);
 }
+export function resolveWritableDocSections(opts) {
+    const required = new Set(opts.requiredSections.map((section) => normalizeDocSectionName(section)));
+    const target = normalizeDocSectionName(opts.targetSection);
+    const ordered = opts.allowedSections.filter((section) => {
+        const key = normalizeDocSectionName(section);
+        return required.has(key) || key === target;
+    });
+    if (target && !ordered.some((section) => normalizeDocSectionName(section) === target)) {
+        ordered.push(opts.targetSection);
+    }
+    return ordered;
+}
 const DOC_PLACEHOLDER_RE = /<!--\s*TODO\b/i;
 const DOC_SECTIONS_AUTO_MANAGED = new Set(["verification"]);
 const DOC_SECTIONS_CONDITIONAL = new Set(["verify steps", "notes"]);

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

@@ -1,4 +1,5 @@
-import type { TaskData } from "../../../backends/task-backend.js";
+import type { TaskSummary } from "../../../backends/task-backend.js";
+import { type DependencyState } from "./dependencies.js";
 export type TaskListFilters = {
     status: string[];
     owner: string[];
@@ -16,5 +17,18 @@ export declare function handleTaskListWarnings(opts: {
     };
     strictRead?: boolean;
 }): void;
-export declare function taskTextBlob(task: TaskData): string;
+export type QueryTaskProjectionResult = {
+    depState: Map<string, DependencyState>;
+    filtered: TaskSummary[];
+    items: TaskSummary[];
+};
+export declare function queryTaskProjection(opts: {
+    tasks: TaskSummary[];
+    filters: TaskListFilters;
+    defaultStatuses?: string[];
+    match?: (task: TaskSummary) => boolean;
+    readyOnly?: boolean;
+    limitOrder?: "before-sort" | "after-sort";
+}): QueryTaskProjectionResult;
+export declare function taskTextBlob(task: TaskSummary): string;
 //# sourceMappingURL=listing.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"listing.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/listing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAIlE,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,eAAe,CAkFjB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE;QAAE,mBAAmB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAA;KAAE,CAAC;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,IAAI,CAcP;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAiBnD"}
+{"version":3,"file":"listing.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/listing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAGrE,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG/E,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,eAAe,CAkFjB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE;QAAE,mBAAmB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAA;KAAE,CAAC;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,IAAI,CAcP;AAgDD,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;CAC3C,GAAG,yBAAyB,CAuB5B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAiBtD"}

package/dist/commands/task/shared/listing.js

@@ -1,6 +1,8 @@
 import { invalidValueForFlag, missingValueMessage, warnMessage } from "../../../cli/output.js";
 import { exitCodeForError } from "../../../cli/exit-codes.js";
 import { CliError } from "../../../shared/errors.js";
+import { dedupeStrings } from "../../../shared/strings.js";
+import { buildDependencyState } from "./dependencies.js";
 import { toStringArray } from "./tags.js";
 export function parseTaskListFilters(args, opts) {
     const out = { status: [], owner: [], tag: [], quiet: false, strictRead: false };
@@ -102,6 +104,60 @@ export function handleTaskListWarnings(opts) {
     }
     process.stderr.write(`${warnMessage(message)}\n`);
 }
+function filterTaskProjectionByStatus(tasks, filters, defaultStatuses) {
+    const statuses = filters.status.length > 0
+        ? filters.status
+        : (defaultStatuses ?? []).filter((status) => status.trim().length > 0);
+    if (statuses.length === 0) {
+        return tasks;
+    }
+    const wanted = new Set(statuses.map((status) => status.trim().toUpperCase()));
+    return tasks.filter((task) => wanted.has(String(task.status || "TODO").toUpperCase()));
+}
+function filterTaskProjectionByOwner(tasks, filters) {
+    if (filters.owner.length === 0) {
+        return tasks;
+    }
+    const wanted = new Set(filters.owner.map((owner) => owner.trim().toUpperCase()));
+    return tasks.filter((task) => wanted.has(String(task.owner || "").toUpperCase()));
+}
+function filterTaskProjectionByTag(tasks, filters) {
+    if (filters.tag.length === 0) {
+        return tasks;
+    }
+    const wanted = new Set(filters.tag.map((tag) => tag.trim()).filter(Boolean));
+    return tasks.filter((task) => {
+        const tags = dedupeStrings(toStringArray(task.tags));
+        return tags.some((tag) => wanted.has(tag));
+    });
+}
+function applyProjectionLimit(items, limit) {
+    return limit !== undefined && limit >= 0 ? items.slice(0, limit) : items;
+}
+function sortTaskProjection(tasks) {
+    return tasks.toSorted((a, b) => a.id.localeCompare(b.id));
+}
+export function queryTaskProjection(opts) {
+    const depState = buildDependencyState(opts.tasks);
+    let filtered = filterTaskProjectionByStatus(opts.tasks, opts.filters, opts.defaultStatuses);
+    filtered = filterTaskProjectionByOwner(filtered, opts.filters);
+    filtered = filterTaskProjectionByTag(filtered, opts.filters);
+    if (opts.match) {
+        filtered = filtered.filter((task) => opts.match?.(task) ?? false);
+    }
+    let queried = filtered;
+    if (opts.readyOnly) {
+        queried = queried.filter((task) => {
+            const dep = depState.get(task.id);
+            return !dep || (dep.missing.length === 0 && dep.incomplete.length === 0);
+        });
+    }
+    const limitOrder = opts.limitOrder ?? "after-sort";
+    const items = limitOrder === "before-sort"
+        ? sortTaskProjection(applyProjectionLimit(queried, opts.filters.limit))
+        : applyProjectionLimit(sortTaskProjection(queried), opts.filters.limit);
+    return { depState, filtered, items };
+}
 export function taskTextBlob(task) {
     const parts = [];
     for (const key of ["id", "title", "description", "status", "priority", "owner"]) {

package/dist/commands/task/shared/transition-command.d.ts

@@ -0,0 +1,15 @@
+import type { TaskData } from "../../../backends/task-backend.js";
+import type { CommandContext } from "../../shared/task-backend.js";
+import { type ExecuteTaskStatusTransitionRequest, type TaskStatusTransitionExecution } from "./workflow-transition-service.js";
+type TaskStatusTransitionCommandRequest = Omit<ExecuteTaskStatusTransitionRequest, "task" | "backend" | "config">;
+export declare function applyTaskStatusTransitionCommand(opts: {
+    ctx: CommandContext;
+    taskId: string;
+    quiet: boolean;
+    build: (current: TaskData) => TaskStatusTransitionCommandRequest | Promise<TaskStatusTransitionCommandRequest>;
+}): Promise<{
+    execution: TaskStatusTransitionExecution;
+    primaryTag: string;
+}>;
+export {};
+//# sourceMappingURL=transition-command.d.ts.map

package/dist/commands/task/shared/transition-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-command.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/transition-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAGlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,EAGL,KAAK,kCAAkC,EACvC,KAAK,6BAA6B,EACnC,MAAM,kCAAkC,CAAC;AAE1C,KAAK,kCAAkC,GAAG,IAAI,CAC5C,kCAAkC,EAClC,MAAM,GAAG,SAAS,GAAG,QAAQ,CAC9B,CAAC;AAEF,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,KACd,kCAAkC,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAAC;CACvF,GAAG,OAAO,CAAC;IACV,SAAS,EAAE,6BAA6B,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAwCD"}

package/dist/commands/task/shared/transition-command.js

@@ -0,0 +1,43 @@
+import { CliError } from "../../../shared/errors.js";
+import { applyTaskMutation } from "../../shared/task-mutation.js";
+import { emitTransitionWarnings } from "./transitions.js";
+import { resolvePrimaryTag, toStringArray } from "./tags.js";
+import { executeTaskStatusTransitionRequest, readDeferredTaskTransitionWarnings, } from "./workflow-transition-service.js";
+export async function applyTaskStatusTransitionCommand(opts) {
+    let execution = null;
+    let primaryTag = "meta";
+    let deferredWarnings = [];
+    try {
+        await applyTaskMutation({
+            ctx: opts.ctx,
+            taskId: opts.taskId,
+            build: async (current) => {
+                const request = await opts.build(current);
+                execution = await executeTaskStatusTransitionRequest({
+                    ...request,
+                    task: current,
+                    backend: opts.ctx.taskBackend,
+                    config: opts.ctx.config,
+                });
+                primaryTag = resolvePrimaryTag(toStringArray(current.tags), opts.ctx).primary;
+                deferredWarnings = execution.deferredWarnings;
+                return { intents: execution.intents };
+            },
+        });
+    }
+    catch (error) {
+        emitTransitionWarnings(readDeferredTaskTransitionWarnings(error).length > 0
+            ? readDeferredTaskTransitionWarnings(error)
+            : deferredWarnings, opts.quiet);
+        throw error;
+    }
+    emitTransitionWarnings(deferredWarnings, opts.quiet);
+    if (!execution) {
+        throw new CliError({
+            exitCode: 4,
+            code: "E_IO",
+            message: `Task transition produced no execution state: ${opts.taskId}`,
+        });
+    }
+    return { execution, primaryTag };
+}

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

@@ -1,5 +1,6 @@
 import type { AgentplaneConfig } from "@agentplaneorg/core";
 import type { TaskData, TaskEvent } from "../../../backends/task-backend.js";
+import type { CommandContext } from "../../shared/task-backend.js";
 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;
@@ -18,6 +19,7 @@ export declare function ensureCommentCommitAllowed(opts: {
     statusFrom: string;
     statusTo: string;
 }): void;
+export declare function emitTransitionWarnings(warnings: readonly string[], quiet: boolean): void;
 export declare function resolveCommentCommitWarning(opts: {
     enabled: boolean;
     config: AgentplaneConfig;
@@ -28,6 +30,43 @@ export declare function resolveCommentCommitWarning(opts: {
     statusTo: string;
 }): string | null;
 export declare function requireStructuredComment(body: string, prefix: string, minChars: number): void;
+export declare function prepareTaskTransitionComment(opts: {
+    body?: string;
+    enabled: boolean;
+    config: AgentplaneConfig;
+}): {
+    formattedComment: string | null;
+    commentBody: string | undefined;
+};
+export declare function resolveTaskTransitionExecutorAgent(opts: {
+    ctx: Pick<CommandContext, "config" | "resolvedProject">;
+    taskId: string;
+    author?: string;
+}): Promise<string | undefined>;
+export declare function runTaskTransitionCommentCommit(opts: {
+    ctx: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    primaryTag: string;
+    author?: string;
+    statusFrom?: string;
+    statusTo?: string;
+    commentBody: string;
+    formattedComment: string | null;
+    emoji: string;
+    allow: string[];
+    autoAllow: boolean;
+    allowTasks: boolean;
+    requireClean: boolean;
+    quiet: boolean;
+    progressMessage?: string;
+    resolveExecutorAgent?: boolean;
+}): Promise<{
+    hash: string;
+    message: string;
+    staged: string[];
+}>;
 export declare function readHeadCommit(cwd: string): Promise<{
     hash: string;
     message: string;

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

@@ -1 +1 @@
-{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/transitions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAK7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,CAW7E;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAc3F;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAkBN;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO1E;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,IAAI,CAUP;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAKP;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,GAAG,IAAI,CAmBhB;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAgB7F;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5F;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAKP;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACrD,MAAM,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,GAAG,IAAI,CA2BhB;AAUD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3F;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMlE"}
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/transitions.ts"],"names":[],"mappings":"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"}

package/dist/commands/task/shared/transitions.js

@@ -1,8 +1,11 @@
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import { warnMessage } from "../../../cli/output.js";
+import { infoMessage, warnMessage } from "../../../cli/output.js";
+import { formatCommentBodyForCommit } from "../../../shared/comment-format.js";
+import { readDirectWorkLock } from "../../../shared/direct-work-lock.js";
 import { CliError } from "../../../shared/errors.js";
 import { parseGitLogHashSubject } from "../../../shared/git-log.js";
+import { commitFromComment } from "../../guard/index.js";
 import { requiresVerificationByPrimary, toStringArray } from "./tags.js";
 const execFileAsync = promisify(execFile);
 export function appendTaskEvent(task, event) {
@@ -76,6 +79,13 @@ export function ensureCommentCommitAllowed(opts) {
         process.stderr.write(`${warnMessage(warning)}\n`);
     }
 }
+export function emitTransitionWarnings(warnings, quiet) {
+    if (quiet)
+        return;
+    for (const warning of new Set(warnings.filter((item) => item.trim().length > 0))) {
+        process.stderr.write(`${warnMessage(warning)}\n`);
+    }
+}
 export function resolveCommentCommitWarning(opts) {
     if (!opts.enabled)
         return null;
@@ -113,6 +123,57 @@ export function requireStructuredComment(body, prefix, minChars) {
         });
     }
 }
+export function prepareTaskTransitionComment(opts) {
+    if (typeof opts.body !== "string") {
+        return { formattedComment: null, commentBody: undefined };
+    }
+    const formattedComment = opts.enabled ? formatCommentBodyForCommit(opts.body, opts.config) : null;
+    return {
+        formattedComment,
+        commentBody: formattedComment ?? opts.body,
+    };
+}
+export async function resolveTaskTransitionExecutorAgent(opts) {
+    const author = opts.author?.trim() ?? "";
+    if (opts.ctx.config.workflow_mode !== "direct") {
+        return author || undefined;
+    }
+    const lock = await readDirectWorkLock(opts.ctx.resolvedProject.agentplaneDir);
+    const lockAgent = lock?.task_id === opts.taskId ? (lock.agent?.trim() ?? "") : "";
+    return lockAgent || author || undefined;
+}
+export async function runTaskTransitionCommentCommit(opts) {
+    if (opts.progressMessage && !opts.quiet) {
+        process.stdout.write(`${infoMessage(opts.progressMessage)}\n`);
+    }
+    const executorAgent = opts.resolveExecutorAgent
+        ? await resolveTaskTransitionExecutorAgent({
+            ctx: opts.ctx,
+            taskId: opts.taskId,
+            author: opts.author,
+        })
+        : undefined;
+    return await commitFromComment({
+        ctx: opts.ctx,
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride,
+        taskId: opts.taskId,
+        primaryTag: opts.primaryTag,
+        executorAgent,
+        author: opts.author,
+        statusFrom: opts.statusFrom,
+        statusTo: opts.statusTo,
+        commentBody: opts.commentBody,
+        formattedComment: opts.formattedComment,
+        emoji: opts.emoji,
+        allow: opts.allow,
+        autoAllow: opts.autoAllow,
+        allowTasks: opts.allowTasks,
+        requireClean: opts.requireClean,
+        quiet: opts.quiet,
+        config: opts.ctx.config,
+    });
+}
 export async function readHeadCommit(cwd) {
     const { stdout } = await execFileAsync("git", ["log", "-1", "--pretty=%H%x00%s"], { cwd });
     const { hash, subject } = parseGitLogHashSubject(stdout);

package/dist/commands/task/shared/workflow-transition-service.d.ts

@@ -0,0 +1,75 @@
+import { type AgentplaneConfig } from "@agentplaneorg/core";
+import type { TaskBackend, TaskData } from "../../../backends/task-backend.js";
+import { type TaskStoreIntent, type TaskStoreTaskPatch } from "../../shared/task-store.js";
+import { type DependencyState } from "./dependencies.js";
+type TaskComment = NonNullable<TaskData["comments"]>[number];
+type BuildTaskStatusTransitionOptions = {
+    task: TaskData;
+    at: string;
+    toStatus: TaskData["status"];
+    eventAuthor: string;
+    updatedBy: string;
+    note?: string;
+    comment?: TaskComment;
+    commit?: TaskData["commit"] | null;
+    extraFields?: TaskStoreTaskPatch;
+};
+type BuildTaskVerificationTransitionOptions = {
+    task: TaskData;
+    at: string;
+    by: string;
+    note: string;
+    state: "ok" | "needs_rework";
+    verificationSection: string;
+    nextDoc: string;
+    requiredSections: string[];
+};
+export type ExecuteTaskVerificationTransitionRequest = {
+    task: TaskData;
+    at: string;
+    by: string;
+    note: string;
+    state: "ok" | "needs_rework";
+    details?: string | null;
+    doc: string;
+    requiredSections: string[];
+};
+export type TaskVerificationTransitionExecution = TaskTransitionWrite & {
+    verificationSection: string;
+    nextDoc: string;
+};
+export type TaskTransitionWrite = {
+    currentStatus: string;
+    intents: TaskStoreIntent[];
+    nextTask: TaskData;
+};
+export type TaskStatusTransitionDependencyPolicy = {
+    kind: "none";
+} | {
+    kind: "require-ready";
+    failureMessage?: string;
+};
+export type TaskStatusTransitionCommentCommitPolicy = {
+    enabled: boolean;
+    action: string;
+    confirmed: boolean;
+    quiet: boolean;
+};
+export type ExecuteTaskStatusTransitionRequest = BuildTaskStatusTransitionOptions & {
+    backend: Pick<TaskBackend, "getTask" | "getTasks">;
+    config: AgentplaneConfig;
+    force: boolean;
+    dependencyPolicy?: TaskStatusTransitionDependencyPolicy;
+    commentCommitPolicy?: TaskStatusTransitionCommentCommitPolicy;
+};
+export type TaskStatusTransitionExecution = TaskTransitionWrite & {
+    dependencyState: DependencyState | null;
+    deferredWarnings: string[];
+};
+export declare function readDeferredTaskTransitionWarnings(error: unknown): string[];
+export declare function buildTaskStatusTransition(opts: BuildTaskStatusTransitionOptions): TaskTransitionWrite;
+export declare function executeTaskStatusTransitionRequest(opts: ExecuteTaskStatusTransitionRequest): Promise<TaskStatusTransitionExecution>;
+export declare function buildTaskVerificationTransition(opts: BuildTaskVerificationTransitionOptions): TaskTransitionWrite;
+export declare function executeTaskVerificationTransitionRequest(opts: ExecuteTaskVerificationTransitionRequest): TaskVerificationTransitionExecution;
+export {};
+//# sourceMappingURL=workflow-transition-service.d.ts.map

package/dist/commands/task/shared/workflow-transition-service.d.ts.map

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

package/dist/commands/task/shared/workflow-transition-service.js

@@ -0,0 +1,226 @@
+import { createHash } from "node:crypto";
+import { ensureDocSections, setMarkdownSection } from "@agentplaneorg/core";
+import { CliError } from "../../../shared/errors.js";
+import { appendTaskCommentIntent, appendTaskEventIntent, setTaskFieldsIntent, setTaskSectionIntent, touchTaskDocMetaIntent, } from "../../shared/task-store.js";
+import { dependencyWarningMessages, resolveTaskDependencyState, } from "./dependencies.js";
+import { appendTaskEvent, extractDocSection, normalizeTaskDocVersion, normalizeVerificationSectionLayout, VERIFICATION_RESULTS_BEGIN, VERIFICATION_RESULTS_END, } from "../shared.js";
+import { ensureStatusTransitionAllowed, resolveCommentCommitWarning } from "./transitions.js";
+export function readDeferredTaskTransitionWarnings(error) {
+    if (!(error instanceof CliError))
+        return [];
+    const warnings = error.context?.deferred_warnings;
+    if (!Array.isArray(warnings))
+        return [];
+    return [
+        ...new Set(warnings.filter((item) => typeof item === "string" && item.length > 0)),
+    ];
+}
+function normalizeComments(task) {
+    return Array.isArray(task.comments)
+        ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
+        : [];
+}
+function appendVerificationEntryBetweenMarkers(sectionText, entryText, version) {
+    const ensured = normalizeVerificationSectionLayout(sectionText, version);
+    const beginIdx = ensured.indexOf(VERIFICATION_RESULTS_BEGIN);
+    const endIdx = ensured.indexOf(VERIFICATION_RESULTS_END);
+    if (beginIdx === -1 || endIdx === -1 || endIdx <= beginIdx) {
+        throw new Error("Verification results markers are malformed");
+    }
+    const beforeEnd = ensured.slice(0, endIdx).trimEnd();
+    const afterEnd = ensured.slice(endIdx).trimStart();
+    const entry = entryText.trimEnd();
+    const parts = [
+        beforeEnd,
+        ...(beforeEnd.endsWith(VERIFICATION_RESULTS_BEGIN) ? [] : [""]),
+        entry,
+        "",
+        afterEnd,
+    ];
+    return parts.join("\n").trimEnd();
+}
+function renderVerificationEntry(opts) {
+    const lines = [
+        `### ${opts.at} — VERIFY — ${opts.state}`,
+        "",
+        `By: ${opts.by}`,
+        "",
+        `Note: ${opts.note}`,
+    ];
+    const verifyStepsRef = (opts.verifyStepsRef ?? "").trim();
+    if (verifyStepsRef) {
+        lines.push("", `VerifyStepsRef: ${verifyStepsRef}`);
+    }
+    const details = (opts.details ?? "").trim();
+    if (details) {
+        lines.push("", "Details:", "", details);
+    }
+    return `${lines.join("\n").trimEnd()}\n`;
+}
+function sha256Hex(text) {
+    return createHash("sha256").update(text, "utf8").digest("hex");
+}
+function buildStatusTaskPatch(opts) {
+    const patch = { status: opts.toStatus };
+    if (opts.extraFields)
+        Object.assign(patch, opts.extraFields);
+    if (opts.commit !== undefined) {
+        patch.commit = opts.commit;
+    }
+    return patch;
+}
+export function buildTaskStatusTransition(opts) {
+    const currentStatus = String(opts.task.status || "TODO").toUpperCase();
+    const patch = buildStatusTaskPatch(opts);
+    const statusEvent = {
+        type: "status",
+        at: opts.at,
+        author: opts.eventAuthor,
+        from: currentStatus,
+        to: opts.toStatus,
+        note: opts.note,
+    };
+    const intents = [setTaskFieldsIntent(patch)];
+    if (opts.comment) {
+        intents.push(appendTaskCommentIntent(opts.comment));
+    }
+    intents.push(appendTaskEventIntent(statusEvent), touchTaskDocMetaIntent({
+        updatedBy: opts.updatedBy,
+        version: normalizeTaskDocVersion(opts.task.doc_version),
+    }));
+    const nextTask = {
+        ...opts.task,
+        ...patch,
+        comments: opts.comment ? [...normalizeComments(opts.task), opts.comment] : opts.task.comments,
+        events: appendTaskEvent(opts.task, statusEvent),
+        doc_version: normalizeTaskDocVersion(opts.task.doc_version),
+        doc_updated_at: opts.at,
+        doc_updated_by: opts.updatedBy,
+    };
+    return { currentStatus, intents, nextTask };
+}
+export async function executeTaskStatusTransitionRequest(opts) {
+    const currentStatus = String(opts.task.status || "TODO").toUpperCase();
+    ensureStatusTransitionAllowed({
+        currentStatus,
+        nextStatus: opts.toStatus,
+        force: opts.force,
+    });
+    let dependencyState = null;
+    const deferredWarnings = [];
+    const dependencyPolicy = opts.dependencyPolicy ?? { kind: "none" };
+    if (dependencyPolicy.kind === "require-ready" && !opts.force) {
+        dependencyState = await resolveTaskDependencyState(opts.task, opts.backend);
+        deferredWarnings.push(...dependencyWarningMessages(dependencyState));
+        if (dependencyState.missing.length > 0 || dependencyState.incomplete.length > 0) {
+            const warnings = [...new Set(deferredWarnings)];
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: dependencyPolicy.failureMessage ??
+                    `Task is not ready: ${opts.task.id} (use --force to override)`,
+                context: {
+                    reason_code: "task_transition_dependencies_not_ready",
+                    deferred_warnings: warnings,
+                },
+            });
+        }
+    }
+    if (opts.commentCommitPolicy) {
+        const warning = resolveCommentCommitWarning({
+            enabled: opts.commentCommitPolicy.enabled,
+            config: opts.config,
+            action: opts.commentCommitPolicy.action,
+            confirmed: opts.commentCommitPolicy.confirmed,
+            quiet: opts.commentCommitPolicy.quiet,
+            statusFrom: currentStatus,
+            statusTo: opts.toStatus,
+        });
+        if (warning)
+            deferredWarnings.push(warning);
+    }
+    return {
+        ...buildTaskStatusTransition(opts),
+        dependencyState,
+        deferredWarnings: [...new Set(deferredWarnings)],
+    };
+}
+export function buildTaskVerificationTransition(opts) {
+    const currentStatus = String(opts.task.status || "TODO").toUpperCase();
+    const verification = {
+        state: opts.state,
+        updated_at: opts.at,
+        updated_by: opts.by,
+        note: opts.note,
+    };
+    const patch = {
+        verification,
+        ...(opts.state === "needs_rework" ? { status: "DOING", commit: null } : {}),
+    };
+    const verifyEvent = {
+        type: "verify",
+        at: opts.at,
+        author: opts.by,
+        state: opts.state,
+        note: opts.note,
+    };
+    const intents = [
+        setTaskFieldsIntent(patch),
+        setTaskSectionIntent({
+            section: "Verification",
+            text: opts.verificationSection,
+            requiredSections: opts.requiredSections,
+        }),
+        appendTaskEventIntent(verifyEvent),
+        touchTaskDocMetaIntent({ updatedBy: opts.by }),
+    ];
+    const nextTask = {
+        ...opts.task,
+        ...patch,
+        doc: opts.nextDoc,
+        events: appendTaskEvent(opts.task, verifyEvent),
+        doc_version: normalizeTaskDocVersion(opts.task.doc_version),
+        doc_updated_at: opts.at,
+        doc_updated_by: opts.by,
+    };
+    return { currentStatus, intents, nextTask };
+}
+export function executeTaskVerificationTransitionRequest(opts) {
+    const baseDoc = ensureDocSections(opts.doc, opts.requiredSections);
+    const verificationSection = extractDocSection(baseDoc, "Verification") ?? "";
+    const verifySteps = extractDocSection(baseDoc, "Verify Steps");
+    const verifyStepsHash = verifySteps
+        ? sha256Hex(verifySteps.replaceAll("\r\n", "\n").trim())
+        : null;
+    const docVersion = normalizeTaskDocVersion(opts.task.doc_version);
+    const verifyStepsRef = [
+        `doc_version=${String(docVersion)}`,
+        `doc_updated_at=${String(opts.task.doc_updated_at ?? "missing")}`,
+        `excerpt_hash=sha256:${verifyStepsHash ?? "missing"}`,
+    ].join(", ");
+    const entry = renderVerificationEntry({
+        at: opts.at,
+        state: opts.state,
+        by: opts.by,
+        note: opts.note,
+        details: opts.details ?? null,
+        verifyStepsRef,
+    });
+    const nextVerification = appendVerificationEntryBetweenMarkers(verificationSection, entry, docVersion);
+    const nextDoc = ensureDocSections(setMarkdownSection(baseDoc, "Verification", nextVerification), opts.requiredSections);
+    const transition = buildTaskVerificationTransition({
+        task: opts.task,
+        at: opts.at,
+        by: opts.by,
+        note: opts.note,
+        state: opts.state,
+        verificationSection: nextVerification,
+        nextDoc,
+        requiredSections: opts.requiredSections,
+    });
+    return {
+        ...transition,
+        verificationSection: nextVerification,
+        nextDoc,
+    };
+}