agentplane 0.3.7 → 0.3.9

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

@@ -0,0 +1,74 @@
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { infoMessage } from "../../cli/output.js";
+import { loadCommandContext } from "../shared/task-backend.js";
+import { executeTaskRunnerExecution, prepareTaskRunnerExecution, } from "../../runner/usecases/task-run.js";
+import { formatRunnerCapabilitySummaryLines, formatRunnerPolicyFieldSummaryLines, } from "../../runner/policy-display.js";
+import { CliError } from "../../shared/errors.js";
+export { taskRunSpec } from "./run.spec.js";
+export const runTaskRun = async (ctx, parsed) => {
+    try {
+        const commandCtx = await loadCommandContext({
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+        });
+        if (!parsed.dryRun) {
+            const executed = await executeTaskRunnerExecution({
+                ctx: commandCtx,
+                cwd: ctx.cwd,
+                rootOverride: ctx.rootOverride ?? null,
+                task_id: parsed.taskId,
+            });
+            process.stdout.write(`${infoMessage(`task run executed: ${parsed.taskId}`)}\n`);
+            process.stdout.write(`adapter: ${executed.invocation.adapter_id}\n`);
+            process.stdout.write(`run_id: ${executed.invocation.run_id}\n`);
+            process.stdout.write(`result: ${executed.invocation.result_path}\n`);
+            process.stdout.write(`state: ${executed.bundle.execution.artifact_paths.state_path}\n`);
+            process.stdout.write(`events: ${executed.bundle.execution.artifact_paths.events_path}\n`);
+            process.stdout.write(`status: ${executed.result.status}\n`);
+            process.stdout.write(`runner_exit_code: ${executed.result.exit_code ?? "null"}\n`);
+            if (executed.result.stdout_summary) {
+                process.stdout.write(`stdout: ${executed.result.stdout_summary}\n`);
+            }
+            if (executed.result.stderr_summary) {
+                process.stderr.write(`stderr: ${executed.result.stderr_summary}\n`);
+            }
+            return executed.result.status === "success"
+                ? 0
+                : (executed.result.exit_code ?? exitCodeForError("E_RUNTIME"));
+        }
+        const prepared = await prepareTaskRunnerExecution({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+            task_id: parsed.taskId,
+            mode: "dry_run",
+        });
+        process.stdout.write(`${infoMessage(`task run dry-run prepared: ${parsed.taskId}`)}\n`);
+        process.stdout.write(`adapter: ${prepared.invocation.adapter_id}\n`);
+        process.stdout.write(`run_id: ${prepared.invocation.run_id}\n`);
+        process.stdout.write(`bundle: ${prepared.bundle.execution.artifact_paths.bundle_path}\n`);
+        process.stdout.write(`result: ${prepared.bundle.execution.artifact_paths.result_path}\n`);
+        process.stdout.write(`bootstrap: ${prepared.bundle.execution.artifact_paths.bootstrap_path}\n`);
+        process.stdout.write(`state: ${prepared.bundle.execution.artifact_paths.state_path}\n`);
+        process.stdout.write(`events: ${prepared.bundle.execution.artifact_paths.events_path}\n`);
+        process.stdout.write(`capabilities: ${JSON.stringify(prepared.bundle.execution.adapter_capabilities ?? null)}\n`);
+        for (const line of formatRunnerCapabilitySummaryLines(prepared.bundle.execution.adapter_capabilities)) {
+            process.stdout.write(`${line}\n`);
+        }
+        process.stdout.write(`policy_requested: ${JSON.stringify(prepared.bundle.execution.policy_decision?.requested ?? {})}\n`);
+        process.stdout.write(`policy_effective: ${JSON.stringify(prepared.bundle.execution.policy_decision?.effective ?? {})}\n`);
+        process.stdout.write(`policy_fields: ${JSON.stringify(prepared.bundle.execution.policy_decision?.fields ?? {})}\n`);
+        process.stdout.write(`policy_refusal: ${JSON.stringify(prepared.bundle.execution.policy_decision?.refusal_reason ?? null)}\n`);
+        for (const line of formatRunnerPolicyFieldSummaryLines(prepared.bundle.execution.policy_decision)) {
+            process.stdout.write(`${line}\n`);
+        }
+        process.stdout.write(`argv: ${prepared.invocation.argv.join(" ")}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "task run", task_id: parsed.taskId });
+    }
+};

package/dist/commands/task/run.spec.d.ts

@@ -0,0 +1,7 @@
+import type { CommandSpec } from "../../cli/spec/spec.js";
+export type TaskRunParsed = {
+    taskId: string;
+    dryRun: boolean;
+};
+export declare const taskRunSpec: CommandSpec<TaskRunParsed>;
+//# sourceMappingURL=run.spec.d.ts.map

package/dist/commands/task/run.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhE,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CA2BlD,CAAC"}

package/dist/commands/task/run.spec.js

@@ -0,0 +1,26 @@
+export const taskRunSpec = {
+    id: ["task", "run"],
+    group: "Task",
+    summary: "Prepare or run a task through the shared runner contract.",
+    description: "Materializes runner bundle artifacts for a task and can execute the configured runner adapter against that prepared bundle.",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "boolean",
+            name: "dry-run",
+            default: false,
+            description: "Prepare runner artifacts and print invocation metadata without executing a runner.",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane task run 202602030608-F1Q8AB --dry-run",
+            why: "Materialize bundle/run artifacts and inspect the prepared runner invocation.",
+        },
+        {
+            cmd: "agentplane task run 202602030608-F1Q8AB",
+            why: "Prepare bundle artifacts and execute the configured runner adapter for the task.",
+        },
+    ],
+    parse: (raw) => ({ taskId: String(raw.args["task-id"]), dryRun: raw.opts["dry-run"] === true }),
+};

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

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/commands/task/scaffold.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAMnC,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0FlB"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/commands/task/scaffold.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AASnC,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0FlB"}

package/dist/commands/task/scaffold.js

@@ -9,6 +9,8 @@ import { writeTextIfChanged } from "../../shared/write-if-changed.js";
 import { nowIso } from "./shared.js";
 import { ensureActionApproved } from "../shared/approval-requirements.js";
 import { defaultTaskDocV3, TASK_DOC_VERSION_V3 } from "./doc-template.js";
+const DEFAULT_SCAFFOLD_TITLE = "(untitled task)";
+const DEFAULT_SCAFFOLD_OWNER = "UNKNOWN";
 export async function cmdTaskScaffold(opts) {
     try {
         const ctx = opts.ctx ??
@@ -54,11 +56,11 @@ export async function cmdTaskScaffold(opts) {
         const baseTask = task ??
             {
                 id: opts.taskId,
-                title: opts.title ?? "",
+                title: opts.title ?? DEFAULT_SCAFFOLD_TITLE,
                 description: "",
                 status: "TODO",
                 priority: "med",
-                owner: "",
+                owner: DEFAULT_SCAFFOLD_OWNER,
                 depends_on: [],
                 tags: [],
                 verify: [],

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

@@ -1 +1 @@
-{"version":3,"file":"scrub.d.ts","sourceRoot":"","sources":["../../../src/commands/task/scrub.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAgBpF,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ClB"}
+{"version":3,"file":"scrub.d.ts","sourceRoot":"","sources":["../../../src/commands/task/scrub.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAiBpF,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDlB"}

package/dist/commands/task/scrub.js

@@ -1,6 +1,7 @@
 import { mapBackendError } from "../../cli/error-map.js";
 import { infoMessage, successMessage } from "../../cli/output.js";
 import { loadCommandContext } from "../shared/task-backend.js";
+import { applyTaskCollectionMutation } from "../shared/task-mutation.js";
 function scrubValue(value, find, replace) {
     if (typeof value === "string")
         return value.replaceAll(find, replace);
@@ -20,23 +21,26 @@ export async function cmdTaskScrub(opts) {
     try {
         const ctx = opts.ctx ??
             (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-        const tasks = await ctx.taskBackend.listTasks();
-        const updated = [];
-        const changedIds = new Set();
-        for (const task of tasks) {
-            const before = JSON.stringify(task);
-            const scrubbed = scrubValue(task, opts.find, opts.replace);
-            if (scrubbed && typeof scrubbed === "object") {
-                const next = scrubbed;
-                updated.push(next);
-                const after = JSON.stringify(next);
-                if (before !== after)
-                    changedIds.add(next.id);
-            }
-            else {
-                updated.push(task);
+        const buildScrubbedTasks = (tasks) => {
+            const updated = [];
+            const changedIds = new Set();
+            for (const task of tasks) {
+                const before = JSON.stringify(task);
+                const scrubbed = scrubValue(task, opts.find, opts.replace);
+                if (scrubbed && typeof scrubbed === "object") {
+                    const next = scrubbed;
+                    updated.push(next);
+                    const after = JSON.stringify(next);
+                    if (before !== after)
+                        changedIds.add(next.id);
+                }
+                else {
+                    updated.push(task);
+                }
             }
-        }
+            return { updated, changedIds };
+        };
+        const { changedIds, updated } = buildScrubbedTasks(await ctx.taskBackend.listTasks());
         if (opts.dryRun) {
             if (!opts.quiet) {
                 process.stdout.write(`${infoMessage(`dry-run: would update ${changedIds.size} task(s)`)}` + "\n");
@@ -46,14 +50,13 @@ export async function cmdTaskScrub(opts) {
             }
             return 0;
         }
-        if (ctx.taskBackend.writeTasks) {
-            await ctx.taskBackend.writeTasks(updated);
-        }
-        else {
-            for (const task of updated) {
-                await ctx.taskBackend.writeTask(task);
-            }
-        }
+        await applyTaskCollectionMutation({
+            ctx,
+            build: () => ({
+                result: changedIds,
+                tasksToWrite: updated,
+            }),
+        });
         if (!opts.quiet) {
             process.stdout.write(`${successMessage("updated tasks", undefined, `count=${changedIds.size}`)}` + "\n");
         }

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/commands/task/search.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EAOL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CA8DlB"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/commands/task/search.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDlB"}

package/dist/commands/task/search.js

@@ -1,8 +1,8 @@
 import { mapBackendError } from "../../cli/error-map.js";
 import { invalidValueMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-import { loadCommandContext } from "../shared/task-backend.js";
-import { buildDependencyState, dedupeStrings, formatTaskLine, handleTaskListWarnings, taskTextBlob, toStringArray, } from "./shared.js";
+import { listTaskSummariesMemo, loadCommandContext, } from "../shared/task-backend.js";
+import { formatTaskLine, handleTaskListWarnings, queryTaskProjection, taskTextBlob, } from "./shared.js";
 export async function cmdTaskSearch(opts) {
     const query = opts.query.trim();
     if (!query) {
@@ -15,26 +15,8 @@ export async function cmdTaskSearch(opts) {
     try {
         const ctx = opts.ctx ??
             (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-        const tasks = await ctx.taskBackend.listTasks();
+        const tasks = await listTaskSummariesMemo(ctx);
         handleTaskListWarnings({ backend: ctx.taskBackend, strictRead: opts.filters.strictRead });
-        const depState = buildDependencyState(tasks);
-        let filtered = tasks;
-        if (opts.filters.status.length > 0) {
-            const wanted = new Set(opts.filters.status.map((s) => s.trim().toUpperCase()));
-            filtered = filtered.filter((task) => wanted.has(String(task.status || "TODO").toUpperCase()));
-        }
-        if (opts.filters.owner.length > 0) {
-            const wanted = new Set(opts.filters.owner.map((o) => o.trim().toUpperCase()));
-            filtered = filtered.filter((task) => wanted.has(String(task.owner || "").toUpperCase()));
-        }
-        if (opts.filters.tag.length > 0) {
-            const wanted = new Set(opts.filters.tag.map((t) => t.trim()).filter(Boolean));
-            filtered = filtered.filter((task) => {
-                const tags = dedupeStrings(toStringArray(task.tags));
-                return tags.some((tag) => wanted.has(tag));
-            });
-        }
-        let matches = [];
         if (opts.regex) {
             let pattern;
             try {
@@ -48,17 +30,25 @@ export async function cmdTaskSearch(opts) {
                     message: invalidValueMessage("regex", message, "valid pattern"),
                 });
             }
-            matches = filtered.filter((task) => pattern.test(taskTextBlob(task)));
-        }
-        else {
-            const needle = query.toLowerCase();
-            matches = filtered.filter((task) => taskTextBlob(task).toLowerCase().includes(needle));
-        }
-        if (opts.filters.limit !== undefined && opts.filters.limit >= 0) {
-            matches = matches.slice(0, opts.filters.limit);
+            const { depState, items } = queryTaskProjection({
+                tasks,
+                filters: opts.filters,
+                match: (task) => pattern.test(taskTextBlob(task)),
+                limitOrder: "before-sort",
+            });
+            for (const task of items) {
+                process.stdout.write(`${formatTaskLine(task, depState.get(task.id))}\n`);
+            }
+            return 0;
         }
-        const sorted = matches.toSorted((a, b) => a.id.localeCompare(b.id));
-        for (const task of sorted) {
+        const needle = query.toLowerCase();
+        const { depState, items } = queryTaskProjection({
+            tasks,
+            filters: opts.filters,
+            match: (task) => taskTextBlob(task).toLowerCase().includes(needle),
+            limitOrder: "before-sort",
+        });
+        for (const task of items) {
             process.stdout.write(`${formatTaskLine(task, depState.get(task.id))}\n`);
         }
         return 0;

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":"AAQA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AA2BnC,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,GAAG,EAAE,OAAO,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;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2OlB"}
+{"version":3,"file":"set-status.d.ts","sourceRoot":"","sources":["../../../src/commands/task/set-status.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAYnC,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,GAAG,EAAE,OAAO,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;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmHlB"}

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

@@ -1,12 +1,9 @@
 import { mapBackendError } from "../../cli/error-map.js";
-import { successMessage, warnMessage } from "../../cli/output.js";
-import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
+import { successMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-import { commitFromComment } from "../guard/index.js";
 import { ensureActionApproved } from "../shared/approval-requirements.js";
-import { loadCommandContext, loadTaskFromContext, resolveDocUpdatedBy, } from "../shared/task-backend.js";
-import { appendTaskCommentIntent, appendTaskEventIntent, backendIsLocalFileBackend, getTaskStore, mutateTaskStore, setTaskFieldsIntent, touchTaskDocMetaIntent, } from "../shared/task-store.js";
-import { appendTaskEvent, dependencyWarningMessages, defaultCommitEmojiForStatus, ensureCommentCommitAllowed, resolveCommentCommitWarning, ensureStatusTransitionAllowed, normalizeTaskDocVersion, normalizeTaskStatus, nowIso, readCommitInfo, resolveTaskDependencyState, resolvePrimaryTag, toStringArray, } from "./shared.js";
+import { loadCommandContext, resolveDocUpdatedBy, } from "../shared/task-backend.js";
+import { applyTaskStatusTransitionCommand, defaultCommitEmojiForStatus, normalizeTaskStatus, nowIso, prepareTaskTransitionComment, readCommitInfo, runTaskTransitionCommentCommit, } from "./shared.js";
 export async function cmdTaskSetStatus(opts) {
     const nextStatus = normalizeTaskStatus(opts.status);
     if (nextStatus === "DONE" && !opts.force) {
@@ -36,158 +33,46 @@ export async function cmdTaskSetStatus(opts) {
             });
         }
         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 });
-        const currentStatus = String(task.status || "TODO").toUpperCase();
-        if (!useStore) {
-            ensureStatusTransitionAllowed({
-                currentStatus,
-                nextStatus,
-                force: opts.force,
-            });
-            if (!opts.force && (nextStatus === "DOING" || nextStatus === "DONE")) {
-                const dep = await resolveTaskDependencyState(task, ctx.taskBackend);
-                if (dep.missing.length > 0 || dep.incomplete.length > 0) {
-                    if (!opts.quiet) {
-                        if (dep.missing.length > 0) {
-                            process.stderr.write(`${warnMessage(`missing deps: ${dep.missing.join(", ")}`)}\n`);
-                        }
-                        if (dep.incomplete.length > 0) {
-                            process.stderr.write(`${warnMessage(`incomplete deps: ${dep.incomplete.join(", ")}`)}\n`);
-                        }
-                    }
-                    throw new CliError({
-                        exitCode: 2,
-                        code: "E_USAGE",
-                        message: `Task is not ready: ${task.id} (use --force to override)`,
-                    });
-                }
-            }
-            ensureCommentCommitAllowed({
+        const preparedComment = opts.author && opts.body
+            ? prepareTaskTransitionComment({
+                body: opts.body,
                 enabled: opts.commitFromComment,
                 config,
-                action: "task set-status",
-                confirmed: opts.confirmStatusCommit,
-                quiet: opts.quiet,
-                statusFrom: currentStatus,
-                statusTo: nextStatus,
-            });
-        }
-        const existingComments = Array.isArray(task.comments)
-            ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
-            : [];
-        let comments = existingComments;
-        let commentBody;
-        if (opts.author && opts.body) {
-            commentBody = opts.commitFromComment
-                ? formatCommentBodyForCommit(opts.body, config)
-                : opts.body;
-            comments = [...existingComments, { author: opts.author, body: commentBody }];
-        }
+            })
+            : null;
+        const commentBody = preparedComment?.commentBody;
         const at = nowIso();
-        const eventAuthor = resolveDocUpdatedBy(task, opts.author);
         const commitInfo = opts.commit ? await readCommitInfo(resolved.gitRoot, opts.commit) : null;
         const nextCommit = opts.commit
             ? { hash: commitInfo.hash, message: commitInfo.message }
             : undefined;
-        let currentStatusForCommit = currentStatus;
-        let primaryTagForCommit = resolvePrimaryTag(toStringArray(task.tags), ctx).primary;
-        let deferredWarnings = [];
-        const next = {
-            ...task,
-            status: nextStatus,
-            comments,
-            events: appendTaskEvent(task, {
-                type: "status",
-                at,
-                author: eventAuthor,
-                from: currentStatus,
-                to: nextStatus,
-                note: commentBody,
-            }),
-            doc_version: normalizeTaskDocVersion(task.doc_version),
-            doc_updated_at: at,
-            doc_updated_by: eventAuthor,
-        };
-        if (opts.commit) {
-            next.commit = nextCommit;
-        }
-        try {
-            await (useStore
-                ? mutateTaskStore(store, opts.taskId, async (current) => {
-                    deferredWarnings = [];
-                    const currentStatus = String(current.status || "TODO").toUpperCase();
-                    currentStatusForCommit = currentStatus;
-                    primaryTagForCommit = resolvePrimaryTag(toStringArray(current.tags), ctx).primary;
-                    ensureStatusTransitionAllowed({
-                        currentStatus,
-                        nextStatus,
-                        force: opts.force,
-                    });
-                    if (!opts.force && (nextStatus === "DOING" || nextStatus === "DONE")) {
-                        const dep = await resolveTaskDependencyState(current, ctx.taskBackend);
-                        deferredWarnings = [...deferredWarnings, ...dependencyWarningMessages(dep)];
-                        if (dep.missing.length > 0 || dep.incomplete.length > 0) {
-                            throw new CliError({
-                                exitCode: 2,
-                                code: "E_USAGE",
-                                message: `Task is not ready: ${current.id} (use --force to override)`,
-                            });
-                        }
-                    }
-                    const commitWarning = resolveCommentCommitWarning({
+        const transition = await applyTaskStatusTransitionCommand({
+            ctx,
+            taskId: opts.taskId,
+            quiet: opts.quiet,
+            build: (current) => {
+                const currentEventAuthor = resolveDocUpdatedBy(current, opts.author);
+                return {
+                    at,
+                    toStatus: nextStatus,
+                    eventAuthor: currentEventAuthor,
+                    updatedBy: currentEventAuthor,
+                    note: commentBody,
+                    comment: commentBody && opts.author ? { author: opts.author, body: commentBody } : undefined,
+                    commit: nextCommit,
+                    force: opts.force,
+                    dependencyPolicy: nextStatus === "DOING" || nextStatus === "DONE"
+                        ? { kind: "require-ready" }
+                        : { kind: "none" },
+                    commentCommitPolicy: {
                         enabled: opts.commitFromComment,
-                        config,
                         action: "task set-status",
                         confirmed: opts.confirmStatusCommit,
                         quiet: opts.quiet,
-                        statusFrom: currentStatus,
-                        statusTo: nextStatus,
-                    });
-                    if (commitWarning)
-                        deferredWarnings.push(commitWarning);
-                    const currentEventAuthor = resolveDocUpdatedBy(current, opts.author);
-                    const intents = [
-                        setTaskFieldsIntent({
-                            status: nextStatus,
-                            ...(nextCommit ? { commit: nextCommit } : {}),
-                        }),
-                        appendTaskEventIntent({
-                            type: "status",
-                            at,
-                            author: currentEventAuthor,
-                            from: currentStatus,
-                            to: nextStatus,
-                            note: commentBody,
-                        }),
-                        touchTaskDocMetaIntent({
-                            updatedBy: currentEventAuthor,
-                            version: normalizeTaskDocVersion(current.doc_version),
-                        }),
-                    ];
-                    if (commentBody) {
-                        intents.splice(1, 0, appendTaskCommentIntent({ author: opts.author, body: commentBody }));
-                    }
-                    return intents;
-                })
-                : ctx.taskBackend.writeTask(next));
-        }
-        catch (err) {
-            if (err instanceof CliError && !opts.quiet) {
-                for (const warning of new Set(deferredWarnings)) {
-                    process.stderr.write(`${warnMessage(warning)}\n`);
-                }
-            }
-            throw err;
-        }
-        if (!opts.quiet) {
-            for (const warning of new Set(deferredWarnings)) {
-                process.stderr.write(`${warnMessage(warning)}\n`);
-            }
-        }
+                    },
+                };
+            },
+        });
         // tasks.json is export-only; generated via `agentplane task export`.
         if (opts.commitFromComment) {
             if (!opts.body) {
@@ -197,24 +82,23 @@ export async function cmdTaskSetStatus(opts) {
                     message: "--body is required when using --commit-from-comment",
                 });
             }
-            await commitFromComment({
+            await runTaskTransitionCommentCommit({
                 ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: opts.taskId,
-                primaryTag: primaryTagForCommit,
+                primaryTag: transition.primaryTag,
                 author: opts.author,
-                statusFrom: currentStatusForCommit,
+                statusFrom: transition.execution.currentStatus,
                 statusTo: nextStatus,
                 commentBody: opts.body,
-                formattedComment: formatCommentBodyForCommit(opts.body, config),
+                formattedComment: preparedComment?.formattedComment ?? null,
                 emoji: opts.commitEmoji ?? defaultCommitEmojiForStatus(nextStatus),
                 allow: opts.commitAllow,
                 autoAllow: opts.commitAutoAllow || opts.commitAllow.length === 0,
                 allowTasks: opts.commitAllowTasks,
                 requireClean: opts.commitRequireClean,
                 quiet: opts.quiet,
-                config,
             });
         }
         if (!opts.quiet) {

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

@@ -1,16 +1,16 @@
-import type { TaskBackend, TaskData } from "../../../backends/task-backend.js";
+import { type TaskBackend, type TaskData, type TaskSummary } from "../../../backends/task-backend.js";
 export type DependencyState = {
     dependsOn: string[];
     missing: string[];
     incomplete: string[];
 };
 export declare function ensureTaskDependsOnGraphIsAcyclic(opts: {
-    backend: Pick<TaskBackend, "listTasks">;
+    backend: Pick<TaskBackend, "listTasks" | "listProjectionTasks">;
     taskId: string;
     dependsOn: string[];
 }): Promise<void>;
 export declare function resolveTaskDependencyState(task: TaskData, backend: Pick<TaskBackend, "getTask" | "getTasks">): Promise<DependencyState>;
 export declare function dependencyWarningMessages(dep: DependencyState): string[];
-export declare function buildDependencyState(tasks: TaskData[]): Map<string, DependencyState>;
-export declare function formatTaskLine(task: TaskData, depState?: DependencyState): string;
+export declare function buildDependencyState(tasks: TaskSummary[]): Map<string, DependencyState>;
+export declare function formatTaskLine(task: TaskSummary, depState?: DependencyState): string;
 //# sourceMappingURL=dependencies.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAK/E,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAkCF,wBAAsB,iCAAiC,CAAC,IAAI,EAAE;IAC5D,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,UAAU,CAAC,GACjD,OAAO,CAAC,eAAe,CAAC,CAuB1B;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,EAAE,CASxE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAqBpF;AAgBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,MAAM,CAejF"}
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAK3C,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAkCF,wBAAsB,iCAAiC,CAAC,IAAI,EAAE;IAC5D,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,qBAAqB,CAAC,CAAC;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,UAAU,CAAC,GACjD,OAAO,CAAC,eAAe,CAAC,CAuB1B;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,EAAE,CASxE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAqBvF;AAgBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,MAAM,CAepF"}

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

@@ -1,3 +1,4 @@
+import { toTaskSummary, } from "../../../backends/task-backend.js";
 import { CliError } from "../../../shared/errors.js";
 import { dedupeStrings } from "../../../shared/strings.js";
 import { toStringArray } from "./tags.js";
@@ -41,9 +42,16 @@ export async function ensureTaskDependsOnGraphIsAcyclic(opts) {
             message: `depends_on cannot include task itself (${opts.taskId})`,
         });
     }
-    const allTasks = await opts.backend.listTasks();
+    let normalizedTasks;
+    if (opts.backend.listProjectionTasks) {
+        normalizedTasks = await opts.backend.listProjectionTasks();
+    }
+    else {
+        const tasks = await opts.backend.listTasks();
+        normalizedTasks = tasks.map((task) => toTaskSummary(task));
+    }
     const depMap = new Map();
-    for (const task of allTasks) {
+    for (const task of normalizedTasks) {
         const taskId = String(task.id || "").trim();
         if (!taskId)
             continue;

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

@@ -1,4 +1,4 @@
-import type { AgentplaneConfig } from "@agentplaneorg/core";
+import { type AgentplaneConfig } from "@agentplaneorg/core";
 import type { TaskData } from "../../../backends/task-backend.js";
 export declare function nowIso(): string;
 export declare const VERIFY_STEPS_PLACEHOLDER = "<!-- TODO: REPLACE WITH TASK-SPECIFIC ACCEPTANCE STEPS -->";
@@ -12,6 +12,11 @@ export declare function normalizeTaskDocVersion(value: unknown, fallback?: TaskD
 export declare function normalizeVerificationSectionLayout(sectionText: string | null, version: TaskDocVersion): string;
 export declare function taskObservationSectionName(version: TaskDocVersion): "Notes" | "Findings";
 export declare function extractTaskObservationSection(doc: string, version: TaskDocVersion): string | null;
+export declare function resolveWritableDocSections(opts: {
+    allowedSections: readonly string[];
+    requiredSections: readonly string[];
+    targetSection: string;
+}): string[];
 export declare function isDocSectionFilled(sectionText: string | null): boolean;
 export declare function ensureAgentFilledRequiredDocSections(opts: {
     task: Pick<TaskData, "id">;

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

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAElE,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,eAAO,MAAM,wBAAwB,+DACyB,CAAC;AAC/D,eAAO,MAAM,0BAA0B,wCAAwC,CAAC;AAChF,eAAO,MAAM,wBAAwB,sCAAsC,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,CAAC;AAEnC,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjF;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAKvE;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,cAAkB,GAC3B,cAAc,CAEhB;AAED,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,EAAE,cAAc,GACtB,MAAM,CAyCR;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,GAAG,UAAU,CAExF;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAIjG;AAMD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAKtE;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE;IACzD,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CA6BP"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAElE,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,eAAO,MAAM,wBAAwB,+DACyB,CAAC;AAC/D,eAAO,MAAM,0BAA0B,wCAAwC,CAAC;AAChF,eAAO,MAAM,wBAAwB,sCAAsC,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,CAAC;AAEnC,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjF;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAKvE;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,cAAkB,GAC3B,cAAc,CAEhB;AAED,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,EAAE,cAAc,GACtB,MAAM,CAyCR;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,GAAG,UAAU,CAExF;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAIjG;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,EAAE,CAaX;AAMD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAKtE;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE;IACzD,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CA6BP"}