agentplane 0.3.23 → 0.3.26

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

@@ -1,305 +0,0 @@
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { resolveTaskDocUpdatedBy, parseTaskReadme, taskDocToSectionMap, } from "@agentplaneorg/core/tasks";
-import { validateTaskReadmeFrontmatter, withTaskReadmeFrontmatterDefaults, } from "@agentplaneorg/core/schemas";
-import { CliError } from "../../shared/errors.js";
-import { emitTraceEvent } from "../../shared/trace-events.js";
-import { loadTaskBackend, taskRecordToData, toTaskSummary, } from "../../backends/task-backend.js";
-import { findWorktreeForBranch, GitContext, gitListTaskBranches, gitShowFile, parseTaskIdFromBranch, toGitPath, } from "@agentplaneorg/core/git";
-function normalizeDocUpdatedBy(value) {
-    const trimmed = value?.trim() ?? "";
-    if (!trimmed)
-        return "";
-    if (trimmed.toLowerCase() === "agentplane")
-        return "";
-    return trimmed;
-}
-export function resolveDocUpdatedBy(task, author) {
-    return normalizeDocUpdatedBy(resolveTaskDocUpdatedBy({
-        comments: task.comments ?? null,
-        doc_updated_by: task.doc_updated_by,
-        owner: task.owner,
-    }, author));
-}
-export function taskDataToFrontmatter(task) {
-    const planApproval = task.plan_approval ??
-        { state: "pending", updated_at: null, updated_by: null, note: null };
-    const verification = task.verification ??
-        { state: "pending", updated_at: null, updated_by: null, note: null };
-    const revision = Number.isInteger(task.revision) && Number(task.revision) > 0 ? Number(task.revision) : 1;
-    const sections = task.doc === undefined
-        ? task.sections && Object.keys(task.sections).length > 0
-            ? task.sections
-            : undefined
-        : taskDocToSectionMap(task.doc);
-    return {
-        id: task.id,
-        title: task.title,
-        result_summary: task.result_summary,
-        risk_level: task.risk_level,
-        breaking: task.breaking,
-        status: task.status,
-        priority: task.priority,
-        owner: task.owner,
-        revision,
-        origin: task.origin ?? undefined,
-        depends_on: task.depends_on ?? [],
-        tags: task.tags ?? [],
-        verify: task.verify ?? [],
-        plan_approval: planApproval,
-        verification,
-        runner: task.runner ?? undefined,
-        commit: task.commit ?? null,
-        comments: task.comments ?? [],
-        events: task.events ?? [],
-        doc_version: task.doc_version,
-        doc_updated_at: task.doc_updated_at,
-        doc_updated_by: task.doc_updated_by,
-        description: task.description ?? "",
-        sections,
-        id_source: task.id_source,
-        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,
-        rootOverride: opts.rootOverride ?? null,
-        resolvedProject: opts.resolvedProject,
-        config: opts.config,
-    });
-    const { backend, backendId, backendConfigPath, resolved, config } = backendLoaded;
-    emitTraceEvent({
-        component: "backend-ops",
-        event: "command_context_loaded",
-        details: {
-            backend: backendId,
-            config_path: path.relative(resolved.gitRoot, backendConfigPath),
-            canonical_source: backend.capabilities?.canonical_source ?? null,
-        },
-    });
-    return {
-        resolvedProject: resolved,
-        config,
-        taskBackend: backend,
-        backendId,
-        backendConfigPath,
-        git: new GitContext({ gitRoot: resolved.gitRoot }),
-        memo: {},
-    };
-}
-export async function loadTaskFromContext(opts) {
-    const tasksDir = path.join(opts.ctx.resolvedProject.gitRoot, opts.ctx.config.paths.workflow_dir);
-    const readmePath = path.join(tasksDir, opts.taskId, "README.md");
-    const branchFallback = () => loadTaskFromBranchSnapshot({
-        ctx: opts.ctx,
-        taskId: opts.taskId,
-        readmePath,
-        branch: opts.branchSnapshotBranch ?? null,
-    });
-    if (opts.preferBranchSnapshot) {
-        const preferredBranchTask = await branchFallback();
-        if (preferredBranchTask)
-            return preferredBranchTask;
-    }
-    const task = await opts.ctx.taskBackend.getTask(opts.taskId);
-    if (task) {
-        emitTraceEvent({
-            component: "backend-ops",
-            event: "task_loaded",
-            details: { task_id: opts.taskId, backend: opts.ctx.backendId },
-        });
-        return task;
-    }
-    const fallbackTask = await branchFallback();
-    if (fallbackTask) {
-        emitTraceEvent({
-            component: "backend-ops",
-            event: "task_loaded_from_branch_snapshot",
-            details: { task_id: opts.taskId, backend: opts.ctx.backendId },
-        });
-        return fallbackTask;
-    }
-    throw new CliError({
-        exitCode: 4,
-        code: "E_IO",
-        message: `ENOENT: no such file or directory, open '${readmePath}'`,
-    });
-}
-export async function resolveTaskBranchFromContext(opts) {
-    if (!backendSupportsTaskBranchSnapshots(opts.ctx)) {
-        return null;
-    }
-    const prefix = opts.ctx.config.branch.task_prefix;
-    const branches = await gitListTaskBranches(opts.ctx.resolvedProject.gitRoot, prefix);
-    const matches = branches.filter((branch) => parseTaskIdFromBranch(prefix, branch) === opts.taskId);
-    if (matches.length === 1)
-        return matches[0] ?? null;
-    if (matches.length > 1) {
-        throw new CliError({
-            exitCode: 3,
-            code: "E_VALIDATION",
-            message: `Multiple task branches match ${opts.taskId}: ${matches.join(", ")}`,
-        });
-    }
-    return null;
-}
-export async function loadTaskFromBranchSnapshot(opts) {
-    if (!backendSupportsTaskBranchSnapshots(opts.ctx)) {
-        return null;
-    }
-    const branch = typeof opts.branch === "string" && opts.branch.trim().length > 0
-        ? opts.branch.trim()
-        : await resolveTaskBranchFromContext({ ctx: opts.ctx, taskId: opts.taskId });
-    if (!branch)
-        return null;
-    const liveWorktreePath = await findWorktreeForBranch(opts.ctx.resolvedProject.gitRoot, branch);
-    if (liveWorktreePath) {
-        const liveReadmePath = path.join(liveWorktreePath, path.relative(opts.ctx.resolvedProject.gitRoot, opts.readmePath));
-        try {
-            const liveText = await readFile(liveReadmePath, "utf8");
-            const parsed = parseTaskReadme(liveText);
-            const frontmatter = validateTaskReadmeFrontmatter(withTaskReadmeFrontmatterDefaults({
-                ...parsed.frontmatter,
-                id: typeof parsed.frontmatter.id === "string" && parsed.frontmatter.id.trim().length > 0
-                    ? parsed.frontmatter.id
-                    : opts.taskId,
-            }));
-            return taskRecordToData({
-                id: opts.taskId,
-                frontmatter: frontmatter,
-                body: parsed.body,
-                readmePath: opts.readmePath,
-            });
-        }
-        catch {
-            // Fall back to the committed branch snapshot when the live worktree lacks the README.
-        }
-    }
-    const relReadmePath = toGitPath(path.relative(opts.ctx.resolvedProject.gitRoot, opts.readmePath));
-    const refsToTry = [branch, branch.startsWith("origin/") ? null : `origin/${branch}`].filter((ref) => Boolean(ref && ref.trim().length > 0));
-    let text = "";
-    let loaded = false;
-    for (const ref of refsToTry) {
-        try {
-            text = await gitShowFile(opts.ctx.resolvedProject.gitRoot, ref, relReadmePath);
-            loaded = true;
-            break;
-        }
-        catch {
-            // Try the next candidate ref.
-        }
-    }
-    if (!loaded)
-        return null;
-    const parsed = parseTaskReadme(text);
-    const frontmatter = validateTaskReadmeFrontmatter(withTaskReadmeFrontmatterDefaults({
-        ...parsed.frontmatter,
-        id: typeof parsed.frontmatter.id === "string" && parsed.frontmatter.id.trim().length > 0
-            ? parsed.frontmatter.id
-            : opts.taskId,
-    }));
-    return taskRecordToData({
-        id: opts.taskId,
-        frontmatter: frontmatter,
-        body: parsed.body,
-        readmePath: opts.readmePath,
-    });
-}
-export async function loadBackendTask(opts) {
-    const ctx = opts.ctx ??
-        (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-    const task = await loadTaskFromContext({ ctx, taskId: opts.taskId });
-    return {
-        backend: ctx.taskBackend,
-        backendId: ctx.backendId,
-        backendConfigPath: ctx.backendConfigPath,
-        resolved: ctx.resolvedProject,
-        config: ctx.config,
-        task,
-    };
-}
-export async function writeTasksOrFallback(backend, tasks) {
-    if (tasks.length === 0)
-        return;
-    if (backend.writeTasks) {
-        await backend.writeTasks([...tasks]);
-        return;
-    }
-    for (const task of tasks) {
-        await backend.writeTask(task);
-    }
-}
-export async function listTaskSummariesMemo(ctx) {
-    ctx.memo.taskProjection ??= (async () => {
-        if (ctx.taskBackend.capabilities?.projection_read_mode === "native") {
-            if (!ctx.taskBackend.listProjectionTasks) {
-                throw new CliError({
-                    exitCode: 1,
-                    code: "E_INTERNAL",
-                    message: `Backend ${ctx.taskBackend.id} advertises native projection reads but does not implement listProjectionTasks()`,
-                });
-            }
-            return await ctx.taskBackend.listProjectionTasks();
-        }
-        const tasks = await ctx.taskBackend.listTasks();
-        return tasks.map((task) => toTaskSummary(task));
-    })();
-    return await ctx.memo.taskProjection;
-}
-export async function listTaskProjection(ctx) {
-    if (ctx.taskBackend.capabilities?.projection_read_mode === "native") {
-        return await listTaskSummariesMemo(ctx);
-    }
-    if (ctx.taskBackend.capabilities?.reads_from_projection_by_default) {
-        return await listTaskSummariesMemo(ctx);
-    }
-    return null;
-}
-export async function exportTaskProjectionSnapshot(opts) {
-    if (opts.ctx.taskBackend.exportProjectionSnapshot) {
-        await opts.ctx.taskBackend.exportProjectionSnapshot(opts.outputPath);
-        return;
-    }
-    if (opts.ctx.taskBackend.exportTasksJson) {
-        await opts.ctx.taskBackend.exportTasksJson(opts.outputPath);
-        return;
-    }
-    throw new CliError({
-        exitCode: 3,
-        code: "E_VALIDATION",
-        message: "Configured backend does not support exporting a task snapshot",
-    });
-}

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

@@ -1,65 +0,0 @@
-import type { TaskHandoff, TaskHandoffRoute, TaskHandoffRunnerNextAction, TaskHandoffRunnerState } from "@agentplaneorg/core/schemas";
-import type { CommandContext } from "./task-backend.js";
-export type TaskHandoffArtifact = TaskHandoff;
-export type TaskHandoffRunnerHint = TaskHandoffRunnerState;
-export type TaskHandoffPaths = {
-    handoff_dir: string;
-    latest_path: string;
-    history_path: string;
-};
-export declare function resolveTaskHandoffPaths(opts: {
-    git_root: string;
-    workflow_dir: string;
-    task_id: string;
-}): TaskHandoffPaths;
-export declare function readTaskHandoffLatest(paths: TaskHandoffPaths): Promise<TaskHandoffArtifact | null>;
-export declare function readTaskHandoffLatestRequired(opts: {
-    task_id: string;
-    paths: TaskHandoffPaths;
-}): Promise<TaskHandoffArtifact>;
-export declare function writeTaskHandoff(opts: {
-    paths: TaskHandoffPaths;
-    handoff: TaskHandoffArtifact;
-}): Promise<void>;
-export declare function currentGitBranch(gitRoot: string): Promise<string | null>;
-export declare function readTaskPrBranch(opts: {
-    ctx: CommandContext;
-    task_id: string;
-}): Promise<string | null>;
-export declare function readTaskPrMetaSummary(opts: {
-    ctx: CommandContext;
-    task_id: string;
-}): Promise<{
-    branch: string | null;
-    base: string | null;
-}>;
-export declare function buildTaskHandoffArtifact(opts: {
-    task_id: string;
-    created_at: string;
-    from_role: string;
-    to_role?: string | null;
-    reason: string;
-    note?: string;
-    branch?: string | null;
-    base_branch?: string | null;
-    head_sha?: string | null;
-    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;
-    evidence_paths?: string[] | undefined;
-}): TaskHandoffArtifact;
-export declare function buildRunnerHintCommands(opts: {
-    task_id: string;
-    run_id: string | null;
-    status: string | null;
-}): {
-    next_action: TaskHandoffRunnerNextAction;
-    next_command: string | null;
-    resume_command: string | null;
-    retry_command: string | null;
-};
-//# sourceMappingURL=task-handoff.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,167 +0,0 @@
-import { appendFile, mkdir, readFile } from "node:fs/promises";
-import path from "node:path";
-import { validateTaskHandoff } from "@agentplaneorg/core/schemas";
-import { CliError } from "../../shared/errors.js";
-import { execFileAsync } from "@agentplaneorg/core/process";
-import { gitEnv } from "@agentplaneorg/core/git";
-import { writeJsonStableIfChanged } from "../../shared/write-if-changed.js";
-function trimOrNull(value) {
-    const trimmed = value?.trim() ?? "";
-    return trimmed.length > 0 ? trimmed : null;
-}
-function normalizeStringList(values) {
-    if (!values?.length)
-        return undefined;
-    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 {
-        handoff_dir,
-        latest_path: path.join(handoff_dir, "latest.json"),
-        history_path: path.join(handoff_dir, "history.jsonl"),
-    };
-}
-export async function readTaskHandoffLatest(paths) {
-    try {
-        const raw = await readFile(paths.latest_path, "utf8");
-        return validateTaskHandoff(JSON.parse(raw));
-    }
-    catch (err) {
-        const code = err?.code;
-        if (code === "ENOENT")
-            return null;
-        throw err;
-    }
-}
-export async function readTaskHandoffLatestRequired(opts) {
-    const handoff = await readTaskHandoffLatest(opts.paths);
-    if (handoff)
-        return handoff;
-    throw new CliError({
-        exitCode: 4,
-        code: "E_IO",
-        message: `Task handoff artifact not found for ${opts.task_id} (${opts.paths.latest_path})`,
-    });
-}
-export async function writeTaskHandoff(opts) {
-    await mkdir(opts.paths.handoff_dir, { recursive: true });
-    await writeJsonStableIfChanged(opts.paths.latest_path, opts.handoff);
-    await appendFile(opts.paths.history_path, `${JSON.stringify(opts.handoff)}\n`, "utf8");
-}
-export async function currentGitBranch(gitRoot) {
-    try {
-        const { stdout } = await execFileAsync("git", ["branch", "--show-current"], {
-            cwd: gitRoot,
-            env: gitEnv(),
-        });
-        return trimOrNull(stdout);
-    }
-    catch {
-        return null;
-    }
-}
-export async function readTaskPrBranch(opts) {
-    const summary = await readTaskPrMetaSummary(opts);
-    return summary.branch;
-}
-export async function readTaskPrMetaSummary(opts) {
-    const prMetaPath = path.join(opts.ctx.resolvedProject.gitRoot, opts.ctx.config.paths.workflow_dir, opts.task_id, "pr", "meta.json");
-    try {
-        const raw = JSON.parse(await readFile(prMetaPath, "utf8"));
-        return {
-            branch: trimOrNull(raw.branch),
-            base: trimOrNull(raw.base),
-        };
-    }
-    catch (err) {
-        const code = err?.code;
-        if (code === "ENOENT")
-            return { branch: null, base: null };
-        throw err;
-    }
-}
-export function buildTaskHandoffArtifact(opts) {
-    return validateTaskHandoff({
-        schema_version: 1,
-        task_id: opts.task_id,
-        created_at: opts.created_at,
-        from_role: opts.from_role.trim(),
-        to_role: trimOrNull(opts.to_role),
-        reason: opts.reason.trim(),
-        note: trimOrNull(opts.note) ?? undefined,
-        branch: trimOrNull(opts.branch),
-        base_branch: trimOrNull(opts.base_branch),
-        head_sha: trimOrNull(opts.head_sha),
-        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),
-        evidence_paths: normalizeStringList(opts.evidence_paths),
-    });
-}
-export function buildRunnerHintCommands(opts) {
-    const taskRunCommand = `agentplane task run ${opts.task_id}`;
-    const resumeCommand = opts.run_id
-        ? `agentplane task run resume ${opts.task_id} ${opts.run_id}`
-        : null;
-    const retryCommand = opts.run_id
-        ? `agentplane task run retry ${opts.task_id} ${opts.run_id}`
-        : null;
-    if (!opts.run_id || !opts.status) {
-        return {
-            next_action: "run",
-            next_command: taskRunCommand,
-            resume_command: null,
-            retry_command: null,
-        };
-    }
-    if (opts.status === "prepared") {
-        return {
-            next_action: "resume",
-            next_command: resumeCommand,
-            resume_command: resumeCommand,
-            retry_command: retryCommand,
-        };
-    }
-    if (opts.status === "failed" || opts.status === "cancelled") {
-        return {
-            next_action: "retry",
-            next_command: retryCommand,
-            resume_command: resumeCommand,
-            retry_command: retryCommand,
-        };
-    }
-    if (opts.status === "success") {
-        return {
-            next_action: "none",
-            next_command: null,
-            resume_command: resumeCommand,
-            retry_command: retryCommand,
-        };
-    }
-    return {
-        next_action: "wait",
-        next_command: null,
-        resume_command: resumeCommand,
-        retry_command: retryCommand,
-    };
-}

package/dist/commands/shared/task-local-freshness.d.ts

@@ -1,15 +0,0 @@
-export declare function isTaskLocalAdvancePath(opts: {
-    workflowDir: string;
-    taskId: string;
-    tasksPath?: string;
-    relPath: string;
-}): boolean;
-export declare function isTaskLocalOnlyAdvance(opts: {
-    gitRoot: string;
-    workflowDir: string;
-    taskId: string;
-    tasksPath?: string;
-    fromRef: string | null;
-    toRef: string;
-}): Promise<boolean>;
-//# sourceMappingURL=task-local-freshness.d.ts.map

package/dist/commands/shared/task-local-freshness.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"task-local-freshness.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-local-freshness.ts"],"names":[],"mappings":"AAQA,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAOV;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBnB"}

package/dist/commands/shared/task-local-freshness.js

@@ -1,26 +0,0 @@
-import path from "node:path";
-import { gitDiffNames, toGitPath } from "@agentplaneorg/core/git";
-function taskRootPrefix(workflowDir, taskId) {
-    return `${toGitPath(path.join(workflowDir, taskId))}/`;
-}
-export function isTaskLocalAdvancePath(opts) {
-    const normalizedRelPath = toGitPath(opts.relPath);
-    if (normalizedRelPath.startsWith(taskRootPrefix(opts.workflowDir, opts.taskId))) {
-        return true;
-    }
-    const normalizedTasksPath = opts.tasksPath ? toGitPath(opts.tasksPath) : null;
-    return normalizedTasksPath !== null && normalizedRelPath === normalizedTasksPath;
-}
-export async function isTaskLocalOnlyAdvance(opts) {
-    if (!opts.fromRef || opts.fromRef === opts.toRef) {
-        return false;
-    }
-    const changedPaths = await gitDiffNames(opts.gitRoot, opts.fromRef, opts.toRef);
-    return (changedPaths.length > 0 &&
-        changedPaths.every((relPath) => isTaskLocalAdvancePath({
-            workflowDir: opts.workflowDir,
-            taskId: opts.taskId,
-            tasksPath: opts.tasksPath,
-            relPath,
-        })));
-}

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

@@ -1,38 +0,0 @@
-import type { TaskData, TaskWriteOptions } from "../../backends/task-backend.js";
-import type { PolicyActionId } from "../../policy/taxonomy.js";
-import { type CommandContext } from "./task-backend.js";
-import { getTaskStore, type TaskStoreIntentResult } from "./task-store.js";
-export type TaskMutationPlan = {
-    intents?: TaskStoreIntentResult;
-    nextTask?: TaskData;
-    forceWrite?: boolean;
-    writeOptions?: TaskWriteOptions;
-};
-export type TaskCollectionMutationPlan<TResult> = {
-    tasksToWrite?: readonly TaskData[];
-    result: TResult;
-};
-export declare function withTaskMutationStorage<TResult>(opts: {
-    ctx: CommandContext;
-    local: (store: ReturnType<typeof getTaskStore>) => Promise<TResult> | TResult;
-    remote: (backend: CommandContext["taskBackend"]) => Promise<TResult> | TResult;
-}): Promise<TResult>;
-export declare function applyTaskMutation(opts: {
-    ctx: CommandContext;
-    taskId: string;
-    policyAction?: PolicyActionId;
-    build: (current: TaskData) => Promise<TaskMutationPlan | null | undefined> | TaskMutationPlan | null | undefined;
-    writeOptions?: TaskWriteOptions;
-}): Promise<{
-    changed: boolean;
-    task: TaskData;
-    mode: "local-store" | "backend";
-}>;
-export declare function applyTaskCollectionMutation<TResult>(opts: {
-    ctx: CommandContext;
-    build: (current: TaskData[]) => Promise<TaskCollectionMutationPlan<TResult>> | TaskCollectionMutationPlan<TResult>;
-}): Promise<{
-    result: TResult;
-    tasksToWrite: TaskData[];
-}>;
-//# sourceMappingURL=task-mutation.d.ts.map

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

@@ -1 +0,0 @@
-{"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"}