agentplane 0.3.12 → 0.3.14

package/dist/commands/scenario/info.command.js

@@ -1,13 +1,13 @@
 import { usageError } from "../../cli/spec/errors.js";
 import { cmdScenarioInfoParsed } from "../scenario.js";
 export const scenarioInfoSpec = {
-    id: ["scenario", "info"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "info"],
+    group: "Recipes",
     summary: "Show manifest-backed scenario details and normalized run profile.",
     args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
     examples: [
         {
-            cmd: "agentplane scenario info viewer:demo",
+            cmd: "agentplane recipes scenario info viewer:demo",
             why: "Inspect resolver-backed scenario metadata before execution.",
         },
     ],
@@ -17,7 +17,7 @@ export const scenarioInfoSpec = {
         if (!recipeId || !scenarioId) {
             throw usageError({
                 spec: scenarioInfoSpec,
-                command: "scenario info",
+                command: "recipes scenario info",
                 message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
             });
         }

package/dist/commands/scenario/list.command.js

@@ -1,9 +1,9 @@
 import { cmdScenarioListParsed } from "../scenario.js";
 export const scenarioListSpec = {
-    id: ["scenario", "list"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "list"],
+    group: "Recipes",
     summary: "List resolver-backed scenario descriptors from installed recipes.",
     parse: () => ({}),
-    examples: [{ cmd: "agentplane scenario list", why: "List available recipe scenarios." }],
+    examples: [{ cmd: "agentplane recipes scenario list", why: "List available recipe scenarios." }],
 };
 export const runScenarioList = (ctx) => cmdScenarioListParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });

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

@@ -1,14 +1,14 @@
 import { usageError } from "../../cli/spec/errors.js";
 import { cmdScenarioRunParsed } from "../scenario.js";
 export const scenarioRunSpec = {
-    id: ["scenario", "run"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "run"],
+    group: "Recipes",
     summary: "Preview a validated scenario plan without creating a task or running a runner.",
     args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
     examples: [
         {
-            cmd: "agentplane scenario run viewer:demo",
-            why: "Validate a scenario and inspect the preview plan before `scenario execute`.",
+            cmd: "agentplane recipes scenario run viewer:demo",
+            why: "Validate a scenario and inspect the preview plan before `recipes scenario execute`.",
         },
     ],
     parse: (raw) => {
@@ -17,7 +17,7 @@ export const scenarioRunSpec = {
         if (!recipeId || !scenarioId) {
             throw usageError({
                 spec: scenarioRunSpec,
-                command: "scenario run",
+                command: "recipes scenario run",
                 message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
             });
         }

package/dist/commands/scenario/scenario.command.js

@@ -1,9 +1,9 @@
 import { loadDirectSubcommandNames, parseGroupCommand, throwGroupCommandUsage, } from "../../cli/group-command.js";
 export const scenarioSpec = {
-    id: ["scenario"],
-    group: "Scenario",
+    id: ["recipes", "scenario"],
+    group: "Recipes",
     summary: "Recipe scenario commands.",
-    synopsis: ["agentplane scenario <subcommand> [options]"],
+    synopsis: ["agentplane recipes scenario <subcommand> [options]"],
     args: [{ name: "subcommand", required: false, variadic: true, valueHint: "<subcommand>" }],
     parse: (raw) => parseGroupCommand(raw, "subcommand"),
 };
@@ -11,9 +11,9 @@ export const runScenario = async (_ctx, p) => {
     throwGroupCommandUsage({
         spec: scenarioSpec,
         cmd: p.cmd,
-        subcommands: await loadDirectSubcommandNames(["scenario"]),
-        command: "scenario",
-        missingMessage: "Missing scenario subcommand.",
-        unknownMessage: (subcommand) => `Unknown scenario subcommand: ${subcommand}.`,
+        subcommands: await loadDirectSubcommandNames(["recipes", "scenario"]),
+        command: "recipes scenario",
+        missingMessage: "Missing recipes scenario subcommand.",
+        unknownMessage: (subcommand) => `Unknown recipes scenario subcommand: ${subcommand}.`,
     });
 };

package/dist/commands/shared/reconcile-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconcile-check.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/reconcile-check.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAuG3B,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDhB"}
+{"version":3,"file":"reconcile-check.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/reconcile-check.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAuG3B,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDhB"}

package/dist/commands/shared/reconcile-check.js

@@ -2,7 +2,7 @@ import { exitCodeForError } from "../../cli/exit-codes.js";
 import { withDiagnosticContext } from "../../shared/diagnostics.js";
 import { CliError } from "../../shared/errors.js";
 import path from "node:path";
-import { listTaskSummariesMemo, loadTaskFromBranchSnapshot, } from "./task-backend.js";
+import { backendUsesLocalTaskStore, listTaskSummariesMemo, loadTaskFromBranchSnapshot, } from "./task-backend.js";
 function compactError(err) {
     if (err instanceof Error) {
         const text = err.message.trim();
@@ -135,7 +135,7 @@ export async function ensureReconciledBeforeMutation(opts) {
     });
 }
 async function filterWarningsResolvedFromTaskBranch(ctx, warnings) {
-    if (warnings.length === 0 || ctx.backendId !== "local") {
+    if (warnings.length === 0 || !backendUsesLocalTaskStore(ctx)) {
         return warnings;
     }
     const kept = [];

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

@@ -1,6 +1,6 @@
 import { type AgentplaneConfig, type ResolvedProject } from "@agentplaneorg/core";
 import type { ResolvedHarnessContract } from "../../runtime/harness/index.js";
-import { loadTaskBackend, type TaskBackend, type TaskData, type TaskSummary } from "../../backends/task-backend.js";
+import { loadTaskBackend, type TaskBackendCapabilities, type TaskBackend, type TaskData, type TaskSummary } from "../../backends/task-backend.js";
 import { GitContext } from "./git-context.js";
 export type CommandMemo = {
     taskProjection?: Promise<TaskSummary[]>;
@@ -20,6 +20,11 @@ export type CommandContext = {
 };
 export declare function resolveDocUpdatedBy(task: TaskData, author?: string): string;
 export declare function taskDataToFrontmatter(task: TaskData): Record<string, unknown>;
+export declare function getTaskBackendCapabilities(ctx: CommandContext): TaskBackendCapabilities;
+export declare function backendHasLocalCanonicalSource(ctx: CommandContext): boolean;
+export declare function backendWritesTaskReadmes(ctx: CommandContext): boolean;
+export declare function backendSupportsTaskBranchSnapshots(ctx: CommandContext): boolean;
+export declare function backendUsesLocalTaskStore(ctx: CommandContext): boolean;
 export declare function loadCommandContext(opts: {
     cwd: string;
     rootOverride?: string | null;

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

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

package/dist/commands/shared/task-backend.js

@@ -61,6 +61,38 @@ export function taskDataToFrontmatter(task) {
         dirty: task.dirty,
     };
 }
+export function getTaskBackendCapabilities(ctx) {
+    const capabilities = ctx.taskBackend?.capabilities;
+    if (capabilities)
+        return capabilities;
+    const isLocal = ctx.backendId === "local";
+    return {
+        canonical_source: isLocal ? "local" : "remote",
+        projection: isLocal ? "canonical" : "cache",
+        projection_read_mode: "native",
+        reads_from_projection_by_default: !isLocal,
+        writes_task_readmes: isLocal,
+        supports_task_revisions: isLocal,
+        supports_revision_guarded_writes: isLocal,
+        may_access_network_on_read: !isLocal,
+        may_access_network_on_write: !isLocal,
+        supports_projection_refresh: !isLocal,
+        supports_push_sync: !isLocal,
+        supports_snapshot_export: true,
+    };
+}
+export function backendHasLocalCanonicalSource(ctx) {
+    return getTaskBackendCapabilities(ctx).canonical_source === "local";
+}
+export function backendWritesTaskReadmes(ctx) {
+    return getTaskBackendCapabilities(ctx).writes_task_readmes === true;
+}
+export function backendSupportsTaskBranchSnapshots(ctx) {
+    return backendHasLocalCanonicalSource(ctx) && backendWritesTaskReadmes(ctx);
+}
+export function backendUsesLocalTaskStore(ctx) {
+    return backendSupportsTaskBranchSnapshots(ctx);
+}
 export async function loadCommandContext(opts) {
     const backendLoaded = await loadTaskBackend({
         cwd: opts.cwd,
@@ -106,7 +138,7 @@ export async function loadTaskFromContext(opts) {
     });
 }
 export async function resolveTaskBranchFromContext(opts) {
-    if (opts.ctx.backendId !== "local") {
+    if (!backendSupportsTaskBranchSnapshots(opts.ctx)) {
         return null;
     }
     const prefix = opts.ctx.config.branch.task_prefix;
@@ -124,7 +156,7 @@ export async function resolveTaskBranchFromContext(opts) {
     return null;
 }
 export async function loadTaskFromBranchSnapshot(opts) {
-    if (opts.ctx.backendId !== "local") {
+    if (!backendSupportsTaskBranchSnapshots(opts.ctx)) {
         return null;
     }
     const branch = typeof opts.branch === "string" && opts.branch.trim().length > 0

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

@@ -1,4 +1,4 @@
-import { type TaskHandoff, type TaskHandoffRunnerNextAction, type TaskHandoffRunnerState } from "@agentplaneorg/core";
+import { type TaskHandoff, type TaskHandoffRoute, type TaskHandoffRunnerNextAction, type TaskHandoffRunnerState } from "@agentplaneorg/core";
 import type { CommandContext } from "./task-backend.js";
 export type TaskHandoffArtifact = TaskHandoff;
 export type TaskHandoffRunnerHint = TaskHandoffRunnerState;
@@ -46,6 +46,7 @@ export declare function buildTaskHandoffArtifact(opts: {
     workspace_root?: string | null;
     pr_branch?: string | null;
     runner?: TaskHandoffRunnerHint | undefined;
+    route?: TaskHandoffRoute | undefined;
     next_actions?: string[] | undefined;
     risks?: string[] | undefined;
     open_questions?: string[] | undefined;

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

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

package/dist/commands/shared/task-handoff.js

@@ -14,6 +14,20 @@ function normalizeStringList(values) {
     const normalized = values.map((value) => value.trim()).filter((value) => value.length > 0);
     return normalized.length > 0 ? normalized : undefined;
 }
+function normalizeRoute(route) {
+    if (!route)
+        return undefined;
+    return {
+        kind: route.kind,
+        status: route.status ?? undefined,
+        local_mutation: route.local_mutation ?? undefined,
+        finalize_via: route.finalize_via ?? undefined,
+        pr_number: typeof route.pr_number === "number" && route.pr_number > 0 ? route.pr_number : null,
+        pr_url: trimOrNull(route.pr_url) ?? undefined,
+        handoff_show_command: trimOrNull(route.handoff_show_command) ?? undefined,
+        base_pull_command: trimOrNull(route.base_pull_command) ?? undefined,
+    };
+}
 export function resolveTaskHandoffPaths(opts) {
     const handoff_dir = path.join(opts.git_root, opts.workflow_dir, opts.task_id, "handoff");
     return {
@@ -96,6 +110,7 @@ export function buildTaskHandoffArtifact(opts) {
         workspace_root: trimOrNull(opts.workspace_root),
         pr_branch: trimOrNull(opts.pr_branch),
         runner: opts.runner,
+        route: normalizeRoute(opts.route),
         next_actions: normalizeStringList(opts.next_actions),
         risks: normalizeStringList(opts.risks),
         open_questions: normalizeStringList(opts.open_questions),

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

@@ -1 +1 @@
-{"version":3,"file":"task-mutation.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-mutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAA6C,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAGL,YAAY,EACZ,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,OAAO,IAAI;IAChD,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,IAAI,EAAE;IAC3D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC9E,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChF,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IACxF,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAC,CA8DjF;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,IAAI,EAAE;IAC/D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,EAAE,KAChB,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;CACzF,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAQzD"}
+{"version":3,"file":"task-mutation.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-mutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,YAAY,EACZ,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,OAAO,IAAI;IAChD,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,IAAI,EAAE;IAC3D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC9E,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChF,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IACxF,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAC,CA8DjF;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,IAAI,EAAE;IAC/D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,EAAE,KAChB,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;CACzF,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAQzD"}

package/dist/commands/shared/task-mutation.js

@@ -1,8 +1,8 @@
 import { PolicyEngine } from "../../policy/engine.js";
-import { loadTaskFromContext, writeTasksOrFallback } from "./task-backend.js";
-import { applyTaskStoreIntentsToTask, backendIsLocalFileBackend, getTaskStore, } from "./task-store.js";
+import { backendUsesLocalTaskStore, loadTaskFromContext, writeTasksOrFallback, } from "./task-backend.js";
+import { applyTaskStoreIntentsToTask, getTaskStore, } from "./task-store.js";
 export async function withTaskMutationStorage(opts) {
-    if (backendIsLocalFileBackend(opts.ctx)) {
+    if (backendUsesLocalTaskStore(opts.ctx)) {
         return await opts.local(getTaskStore(opts.ctx));
     }
     return await opts.remote(opts.ctx.taskBackend);
@@ -14,7 +14,7 @@ export async function applyTaskMutation(opts) {
         taskId: opts.taskId,
         git: { stagedPaths: [] },
     });
-    if (backendIsLocalFileBackend(opts.ctx)) {
+    if (backendUsesLocalTaskStore(opts.ctx)) {
         const store = getTaskStore(opts.ctx);
         const result = await store.update(opts.taskId, async (current) => {
             const plan = await opts.build({ ...current });

package/dist/commands/shared/task-store/intents.d.ts

@@ -0,0 +1,34 @@
+import type { TaskData, TaskEvent } from "../../../backends/task-backend.js";
+import type { CachedTask, TaskComment, TaskStoreIntent, TaskStoreIntentResult, TaskStoreLike, TaskStoreMutationOptions, TaskStorePatch, TaskStoreTaskPatch } from "./types.js";
+export declare function setTaskFieldsIntent(task: TaskStoreTaskPatch): TaskStoreIntent;
+export declare function appendTaskCommentsIntent(comments: TaskComment[]): TaskStoreIntent;
+export declare function appendTaskCommentIntent(comment: TaskComment): TaskStoreIntent;
+export declare function appendTaskEventsIntent(events: TaskEvent[]): TaskStoreIntent;
+export declare function appendTaskEventIntent(event: TaskEvent): TaskStoreIntent;
+export declare function replaceTaskDocIntent(opts: {
+    doc: string;
+    expectedCurrentDoc?: string | null;
+}): TaskStoreIntent;
+export declare function setTaskSectionIntent(opts: {
+    section: string;
+    text: string;
+    requiredSections: string[];
+    expectedCurrentText?: string | null;
+}): TaskStoreIntent;
+export declare function touchTaskDocMetaIntent(opts?: {
+    updatedBy?: string;
+    version?: 2 | 3;
+}): TaskStoreIntent;
+export declare function taskStorePatchFromIntents(intents: TaskStoreIntentResult): TaskStorePatch | null | undefined;
+export declare function mutateTaskStore(store: TaskStoreLike, taskId: string, builder: (current: TaskData) => Promise<TaskStoreIntentResult> | TaskStoreIntentResult, opts?: TaskStoreMutationOptions): Promise<{
+    changed: boolean;
+    task: TaskData;
+}>;
+export declare function applyTaskStoreIntentsToTask(task: TaskData, intents: TaskStoreIntentResult, opts?: {
+    currentDocVersion?: 2 | 3;
+    docUpdatedAt?: string;
+}): TaskData;
+export declare function applyTaskStoreIntents(entry: CachedTask, intents: TaskStoreIntent[]): TaskData;
+export declare function resolveTaskStoreIntents(intents: TaskStoreIntentResult): TaskStoreIntent[];
+export declare function resolveTaskStorePatch(patch: TaskStorePatch | null | undefined): TaskStoreIntent[];
+//# sourceMappingURL=intents.d.ts.map

package/dist/commands/shared/task-store/intents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intents.d.ts","sourceRoot":"","sources":["../../../../src/commands/shared/task-store/intents.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAK7E,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEX,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,eAAe,CAE7E;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,eAAe,CAEjF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,CAE7E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,CAE3E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,CAEvE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,GAAG,eAAe,CAElB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,GAAG,eAAe,CAElB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,GAAE;IACJ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACZ,GACL,eAAe,CAEjB;AAuFD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,GAAG,IAAI,GAAG,SAAS,CA2DnC;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,EACtF,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAS/C;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,qBAAqB,EAC9B,IAAI,GAAE;IACJ,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,QAAQ,CA0GV;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,QAAQ,CAI7F;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,eAAe,EAAE,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,EAAE,CAEjG"}

package/dist/commands/shared/task-store/intents.js

@@ -0,0 +1,265 @@
+import { applyTaskDocMutations, normalizeTaskDocVersion, taskDocToSectionMap, } from "@agentplaneorg/core";
+import { assertExpectedTaskDoc, assertExpectedTaskSection, } from "../../../shared/task-doc-conflicts.js";
+export function setTaskFieldsIntent(task) {
+    return { kind: "set-task-fields", task };
+}
+export function appendTaskCommentsIntent(comments) {
+    return { kind: "append-comments", comments };
+}
+export function appendTaskCommentIntent(comment) {
+    return appendTaskCommentsIntent([comment]);
+}
+export function appendTaskEventsIntent(events) {
+    return { kind: "append-events", events };
+}
+export function appendTaskEventIntent(event) {
+    return appendTaskEventsIntent([event]);
+}
+export function replaceTaskDocIntent(opts) {
+    return { kind: "replace-doc", ...opts };
+}
+export function setTaskSectionIntent(opts) {
+    return { kind: "set-section", ...opts };
+}
+export function touchTaskDocMetaIntent(opts = {}) {
+    return { kind: "touch-doc-meta", ...opts };
+}
+function normalizeComments(task) {
+    return Array.isArray(task.comments)
+        ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
+        : [];
+}
+function normalizeEvents(task) {
+    return Array.isArray(task.events)
+        ? task.events.filter((item) => !!item &&
+            typeof item.type === "string" &&
+            typeof item.at === "string" &&
+            typeof item.author === "string")
+        : [];
+}
+function applyDocMutationsToState(docState, mutations, opts) {
+    const applied = applyTaskDocMutations(docState, mutations, {
+        now: opts.docUpdatedAt,
+    });
+    return {
+        ...docState,
+        doc: applied.doc,
+        sections: applied.sections,
+        doc_version: applied.doc_version,
+        doc_updated_at: applied.doc_updated_at,
+        doc_updated_by: applied.doc_updated_by,
+    };
+}
+function normalizeTaskStoreIntents(intents) {
+    if (!intents)
+        return [];
+    if (Array.isArray(intents)) {
+        return intents.filter((intent) => intent != null);
+    }
+    return [intents];
+}
+function patchToIntents(patch) {
+    if (!patch)
+        return [];
+    const intents = [];
+    if (patch.task)
+        intents.push(setTaskFieldsIntent(patch.task));
+    if (patch.appendComments && patch.appendComments.length > 0) {
+        intents.push(appendTaskCommentsIntent(patch.appendComments));
+    }
+    if (patch.appendEvents && patch.appendEvents.length > 0) {
+        intents.push(appendTaskEventsIntent(patch.appendEvents));
+    }
+    if (patch.doc) {
+        intents.push(patch.doc.kind === "replace-doc"
+            ? replaceTaskDocIntent({
+                doc: patch.doc.doc,
+                expectedCurrentDoc: patch.doc.expectedCurrentDoc,
+            })
+            : setTaskSectionIntent({
+                section: patch.doc.section,
+                text: patch.doc.text,
+                requiredSections: patch.doc.requiredSections,
+                expectedCurrentText: patch.doc.expectedCurrentText,
+            }));
+    }
+    if (patch.docMeta && (patch.doc !== undefined || patch.docMeta.touch === true)) {
+        intents.push(touchTaskDocMetaIntent({
+            updatedBy: patch.docMeta.updatedBy,
+            version: patch.docMeta.version,
+        }));
+    }
+    return intents;
+}
+export function taskStorePatchFromIntents(intents) {
+    const normalized = normalizeTaskStoreIntents(intents);
+    if (normalized.length === 0)
+        return null;
+    const patch = {};
+    for (const intent of normalized) {
+        switch (intent.kind) {
+            case "set-task-fields": {
+                patch.task = patch.task ? { ...patch.task, ...intent.task } : { ...intent.task };
+                break;
+            }
+            case "append-comments": {
+                if (intent.comments.length > 0) {
+                    patch.appendComments = [...(patch.appendComments ?? []), ...intent.comments];
+                }
+                break;
+            }
+            case "append-events": {
+                if (intent.events.length > 0) {
+                    patch.appendEvents = [...(patch.appendEvents ?? []), ...intent.events];
+                }
+                break;
+            }
+            case "replace-doc": {
+                const docPatch = {
+                    kind: "replace-doc",
+                    doc: intent.doc,
+                };
+                if (intent.expectedCurrentDoc !== undefined) {
+                    docPatch.expectedCurrentDoc = intent.expectedCurrentDoc;
+                }
+                patch.doc = docPatch;
+                break;
+            }
+            case "set-section": {
+                const sectionPatch = {
+                    kind: "set-section",
+                    section: intent.section,
+                    text: intent.text,
+                    requiredSections: [...intent.requiredSections],
+                };
+                if (intent.expectedCurrentText !== undefined) {
+                    sectionPatch.expectedCurrentText = intent.expectedCurrentText;
+                }
+                patch.doc = sectionPatch;
+                break;
+            }
+            case "touch-doc-meta": {
+                patch.docMeta = {
+                    touch: true,
+                    updatedBy: intent.updatedBy ?? patch.docMeta?.updatedBy,
+                    version: intent.version ?? patch.docMeta?.version,
+                };
+                break;
+            }
+        }
+    }
+    return patch;
+}
+export async function mutateTaskStore(store, taskId, builder, opts = {}) {
+    if (typeof store.mutate === "function") {
+        return await store.mutate(taskId, builder, opts);
+    }
+    return await store.patch(taskId, async (current) => taskStorePatchFromIntents(await builder(current)), opts);
+}
+export function applyTaskStoreIntentsToTask(task, intents, opts = {}) {
+    const normalizedIntents = normalizeTaskStoreIntents(intents);
+    if (normalizedIntents.length === 0)
+        return { ...task };
+    const current = task;
+    const next = { ...current };
+    let docState = {
+        comments: next.comments ?? null,
+        doc: String(next.doc ?? ""),
+        doc_updated_by: next.doc_updated_by,
+        doc_version: normalizeTaskDocVersion(opts.currentDocVersion ?? task.doc_version),
+        owner: next.owner,
+        sections: next.sections ?? null,
+    };
+    let touchDoc = false;
+    for (const intent of normalizedIntents) {
+        switch (intent.kind) {
+            case "set-task-fields": {
+                Object.assign(next, intent.task);
+                docState = {
+                    ...docState,
+                    doc_updated_by: next.doc_updated_by,
+                    doc_version: normalizeTaskDocVersion(next.doc_version ?? docState.doc_version),
+                    owner: next.owner,
+                };
+                break;
+            }
+            case "append-comments": {
+                if (intent.comments.length > 0) {
+                    next.comments = [...normalizeComments(next), ...intent.comments];
+                    docState = { ...docState, comments: next.comments };
+                }
+                break;
+            }
+            case "append-events": {
+                if (intent.events.length > 0) {
+                    next.events = [...normalizeEvents(next), ...intent.events];
+                }
+                break;
+            }
+            case "replace-doc": {
+                if (intent.expectedCurrentDoc !== undefined) {
+                    assertExpectedTaskDoc({
+                        taskId: current.id,
+                        currentDoc: docState.doc,
+                        expectedDoc: intent.expectedCurrentDoc,
+                    });
+                }
+                docState = applyDocMutationsToState(docState, [{ kind: "replace-doc", doc: intent.doc }], {
+                    docUpdatedAt: opts.docUpdatedAt,
+                });
+                touchDoc = true;
+                break;
+            }
+            case "set-section": {
+                if (intent.expectedCurrentText !== undefined) {
+                    assertExpectedTaskSection({
+                        taskId: current.id,
+                        currentDoc: docState.doc,
+                        section: intent.section,
+                        expectedText: intent.expectedCurrentText,
+                    });
+                }
+                docState = applyDocMutationsToState(docState, [
+                    {
+                        kind: "set-section",
+                        section: intent.section,
+                        text: intent.text,
+                        requiredSections: intent.requiredSections,
+                    },
+                ], { docUpdatedAt: opts.docUpdatedAt });
+                touchDoc = true;
+                break;
+            }
+            case "touch-doc-meta": {
+                docState = applyDocMutationsToState(docState, [
+                    {
+                        kind: "touch-doc-meta",
+                        updatedBy: intent.updatedBy,
+                        version: intent.version,
+                    },
+                ], { docUpdatedAt: opts.docUpdatedAt });
+                touchDoc = true;
+                break;
+            }
+        }
+    }
+    if (touchDoc) {
+        next.doc = docState.doc;
+        next.sections = docState.sections ?? taskDocToSectionMap(docState.doc);
+        next.doc_version = docState.doc_version;
+        next.doc_updated_at = docState.doc_updated_at;
+        next.doc_updated_by = docState.doc_updated_by;
+    }
+    return next;
+}
+export function applyTaskStoreIntents(entry, intents) {
+    return applyTaskStoreIntentsToTask(entry.task, intents, {
+        currentDocVersion: normalizeTaskDocVersion(entry.parsed.frontmatter.doc_version),
+    });
+}
+export function resolveTaskStoreIntents(intents) {
+    return normalizeTaskStoreIntents(intents);
+}
+export function resolveTaskStorePatch(patch) {
+    return patchToIntents(patch);
+}

package/dist/commands/shared/task-store/readme.d.ts

@@ -0,0 +1,28 @@
+import { type TaskData } from "../../../backends/task-backend.js";
+import { CliError } from "../../../shared/errors.js";
+import type { CachedTask, TaskStoreContext } from "./types.js";
+export declare function normalizeTaskRevision(value: unknown, fallback?: number): number;
+export declare function readStoredTaskRevision(value: unknown): number | null;
+export declare function isConcurrentReadmeChangeError(err: unknown): err is CliError;
+export declare function throwTaskRevisionConflict(opts: {
+    taskId: string;
+    expectedRevision: number;
+    currentRevision: number;
+}): never;
+export declare function readTaskReadmeCached(opts: {
+    ctx: TaskStoreContext;
+    taskId: string;
+}): Promise<CachedTask>;
+export declare function ensureUnchangedOnDisk(opts: {
+    readmePath: string;
+    expectedMtimeMs: number;
+}): Promise<void>;
+export declare function didReadmeChangeOnDisk(opts: {
+    readmePath: string;
+    expectedMtimeMs: number;
+}): Promise<boolean>;
+export declare function writeTaskReadme(opts: {
+    entry: CachedTask;
+    next: TaskData;
+}): Promise<boolean>;
+//# sourceMappingURL=readme.d.ts.map

package/dist/commands/shared/task-store/readme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme.d.ts","sourceRoot":"","sources":["../../../../src/commands/shared/task-store/readme.ts"],"names":[],"mappings":"AAYA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAEpF,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAM/D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,MAAM,CAE1E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,QAAQ,CAM3E;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,KAAK,CAcR;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,gBAAgB,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0BtB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,OAAO,CAAC,CASnB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CA2CnB"}