agentplane 0.3.24 → 0.3.27

package/dist/commands/shared/post-commit-pr-artifacts.js

@@ -1,58 +0,0 @@
-import { warnMessage } from "../../cli/output.js";
-import { normalizeGhTransportError } from "../shared/gh-transport.js";
-import { execFileAsync } from "@agentplaneorg/core/process";
-import { gitEnv } from "@agentplaneorg/core/git";
-import { ensurePrArtifactsSynced } from "../pr/internal/sync.js";
-import { isTaskLocalOnlyAdvance } from "./task-local-freshness.js";
-function isUnknownRevisionError(err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return (/unknown revision or path not in the working tree/i.test(message) ||
-        /bad revision/i.test(message) ||
-        /ambiguous argument/i.test(message));
-}
-async function resolveHeadParent(gitRoot) {
-    try {
-        const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD^"], {
-            cwd: gitRoot,
-            env: gitEnv(),
-        });
-        const parent = stdout.trim();
-        return parent.length > 0 ? parent : null;
-    }
-    catch (err) {
-        if (!isUnknownRevisionError(err))
-            throw err;
-        return null;
-    }
-}
-export async function refreshBranchPrArtifactsAfterTaskCommit(opts) {
-    if (opts.ctx.config.workflow_mode !== "branch_pr")
-        return;
-    try {
-        const gitRoot = opts.ctx.resolvedProject.gitRoot;
-        const headParent = await resolveHeadParent(gitRoot);
-        if (await isTaskLocalOnlyAdvance({
-            gitRoot,
-            workflowDir: opts.ctx.config.paths.workflow_dir,
-            tasksPath: opts.ctx.config.paths.tasks_path,
-            taskId: opts.taskId,
-            fromRef: headParent,
-            toRef: "HEAD",
-        })) {
-            return;
-        }
-        await ensurePrArtifactsSynced({
-            ctx: opts.ctx,
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride,
-            taskId: opts.taskId,
-        });
-    }
-    catch (err) {
-        if (opts.quiet)
-            return;
-        const detail = normalizeGhTransportError(err).trim();
-        const suffix = detail ? ` (${detail})` : "";
-        process.stderr.write(`${warnMessage(`task commit succeeded but PR artifacts refresh failed for ${opts.taskId}; run \`agentplane pr update ${opts.taskId}\`${suffix}`)}\n`);
-    }
-}

package/dist/commands/shared/pr-meta.d.ts

@@ -1,75 +0,0 @@
-import type { TaskPrMeta } from "@agentplaneorg/core/schemas";
-export type PrMeta = TaskPrMeta;
-export type ObservedGithubPrState = {
-    prNumber: number;
-    prUrl: string | null;
-    status: "OPEN" | "CLOSED" | "MERGED";
-    mergedAt?: string | null;
-    mergeCommit?: string | null;
-    base?: string | null;
-    headSha?: string | null;
-};
-export type PrArtifactTextState = {
-    diffstatText: string | null;
-    verifyLogText: string | null;
-    reviewText: string | null;
-};
-export type PrArtifactState = PrArtifactTextState & {
-    meta: PrMeta;
-};
-export declare function buildOpenedPrMeta(opts: {
-    taskId: string;
-    branch: string;
-    at: string;
-    previousMeta: PrMeta | null;
-    base?: string | null;
-    headSha?: string | null;
-}): PrMeta;
-export declare function buildUpdatedPrMeta(opts: {
-    meta: PrMeta;
-    branch: string;
-    at: string;
-    base?: string | null;
-    headSha?: string | null;
-}): PrMeta;
-export declare function resolvePrArtifactHeadSha(opts: {
-    previousHeadSha?: string | null;
-    currentHeadSha?: string | null;
-    preservePrevious: boolean;
-}): string | undefined;
-export declare function buildObservedGithubPrMeta(opts: {
-    meta: PrMeta;
-    observed: ObservedGithubPrState;
-    at: string;
-}): PrMeta;
-export declare function buildVerifiedPrMeta(opts: {
-    meta: PrMeta;
-    at: string;
-    state: "pass" | "fail";
-}): PrMeta;
-export declare function buildIntegratedPrMeta(opts: {
-    meta: PrMeta;
-    branch: string;
-    base: string;
-    mergeStrategy: "squash" | "merge" | "rebase";
-    mergeHash: string;
-    branchHeadSha: string;
-    at: string;
-    verifyCommands: string[];
-    shouldRunVerify: boolean;
-    alreadyVerifiedSha: string | null;
-}): PrMeta;
-export type ShellInvocation = {
-    command: string;
-    args: string[];
-};
-export declare function resolveShellInvocation(command: string): ShellInvocation;
-export declare function parsePrMeta(raw: string, taskId: string): PrMeta;
-export declare function parsePrMetaForwardCompatible(raw: string, taskId: string): PrMeta;
-export declare function extractLastVerifiedSha(logText: string): string | null;
-export declare function appendVerifyLog(logPath: string, header: string, content: string): Promise<void>;
-export declare function runShellCommand(command: string, cwd: string): Promise<{
-    code: number;
-    output: string;
-}>;
-//# sourceMappingURL=pr-meta.d.ts.map

package/dist/commands/shared/pr-meta.d.ts.map

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

package/dist/commands/shared/pr-meta.js

@@ -1,266 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import { validateTaskPrMeta } from "@agentplaneorg/core/schemas";
-import { execFileAsync } from "@agentplaneorg/core/process";
-function nowOrExisting(value, fallback) {
-    const trimmed = value?.trim() ?? "";
-    return trimmed || fallback;
-}
-export function buildOpenedPrMeta(opts) {
-    const nextBase = opts.base ?? opts.previousMeta?.base;
-    const nextHeadSha = opts.headSha ?? opts.previousMeta?.head_sha;
-    const changed = opts.previousMeta === null ||
-        (opts.previousMeta.branch ?? null) !== opts.branch ||
-        (opts.previousMeta.base ?? null) !== (nextBase ?? null) ||
-        (opts.previousMeta.head_sha ?? null) !== (nextHeadSha ?? null);
-    return {
-        schema_version: 1,
-        task_id: opts.taskId,
-        branch: opts.branch,
-        pr_number: opts.previousMeta?.pr_number,
-        pr_url: opts.previousMeta?.pr_url,
-        created_at: opts.previousMeta?.created_at ?? opts.at,
-        updated_at: changed ? opts.at : (opts.previousMeta?.updated_at ?? opts.at),
-        status: opts.previousMeta?.status,
-        merge_strategy: opts.previousMeta?.merge_strategy,
-        merged_at: opts.previousMeta?.merged_at,
-        merge_commit: opts.previousMeta?.merge_commit,
-        last_verified_sha: opts.previousMeta?.last_verified_sha ?? null,
-        last_verified_at: opts.previousMeta?.last_verified_at ?? null,
-        verify: opts.previousMeta?.verify ?? { status: "skipped" },
-        base: nextBase,
-        head_sha: nextHeadSha,
-    };
-}
-export function buildUpdatedPrMeta(opts) {
-    const nextBase = opts.base ?? opts.meta.base;
-    const nextHeadSha = opts.headSha ?? opts.meta.head_sha;
-    const changed = (opts.meta.branch ?? null) !== opts.branch ||
-        (opts.meta.base ?? null) !== (nextBase ?? null) ||
-        (opts.meta.head_sha ?? null) !== (nextHeadSha ?? null);
-    return {
-        ...opts.meta,
-        branch: opts.branch,
-        base: nextBase,
-        head_sha: nextHeadSha,
-        updated_at: changed ? opts.at : opts.meta.updated_at,
-        last_verified_sha: opts.meta.last_verified_sha ?? null,
-        last_verified_at: opts.meta.last_verified_at ?? null,
-    };
-}
-export function resolvePrArtifactHeadSha(opts) {
-    const previousHeadSha = asNonEmptyString(opts.previousHeadSha);
-    const currentHeadSha = asNonEmptyString(opts.currentHeadSha);
-    if (opts.preservePrevious && previousHeadSha)
-        return previousHeadSha;
-    return currentHeadSha ?? previousHeadSha;
-}
-export function buildObservedGithubPrMeta(opts) {
-    const nextStatus = opts.observed.status;
-    const nextHeadSha = opts.meta.head_sha ?? opts.observed.headSha ?? undefined;
-    const nextMeta = {
-        ...opts.meta,
-        pr_number: opts.observed.prNumber,
-        pr_url: opts.observed.prUrl ?? opts.meta.pr_url,
-        status: nextStatus,
-        base: opts.observed.base ?? opts.meta.base,
-        head_sha: nextHeadSha,
-        updated_at: opts.meta.updated_at,
-    };
-    if (nextStatus === "MERGED") {
-        nextMeta.merged_at = opts.observed.mergedAt ?? opts.meta.merged_at;
-        nextMeta.merge_commit = opts.observed.mergeCommit ?? opts.meta.merge_commit;
-    }
-    else {
-        delete nextMeta.merged_at;
-        delete nextMeta.merge_commit;
-        delete nextMeta.merge_strategy;
-    }
-    const changed = nextMeta.pr_number !== opts.meta.pr_number ||
-        (nextMeta.pr_url ?? null) !== (opts.meta.pr_url ?? null) ||
-        nextMeta.status !== opts.meta.status ||
-        (nextMeta.base ?? null) !== (opts.meta.base ?? null) ||
-        (nextMeta.head_sha ?? null) !== (opts.meta.head_sha ?? null) ||
-        (nextMeta.merged_at ?? null) !== (opts.meta.merged_at ?? null) ||
-        (nextMeta.merge_commit ?? null) !== (opts.meta.merge_commit ?? null);
-    if (changed) {
-        nextMeta.updated_at = opts.at;
-    }
-    return nextMeta;
-}
-export function buildVerifiedPrMeta(opts) {
-    const verifiedSha = opts.meta.head_sha ?? null;
-    return {
-        ...opts.meta,
-        updated_at: opts.meta.updated_at,
-        last_verified_sha: verifiedSha,
-        last_verified_at: opts.at,
-        verify: opts.meta.verify ? { ...opts.meta.verify, status: opts.state } : { status: opts.state },
-    };
-}
-export function buildIntegratedPrMeta(opts) {
-    const nextMeta = {
-        ...opts.meta,
-        branch: opts.branch,
-        base: opts.base,
-        merge_strategy: opts.mergeStrategy,
-        status: "MERGED",
-        merged_at: nowOrExisting(opts.meta.merged_at, opts.at),
-        merge_commit: opts.mergeHash,
-        head_sha: opts.branchHeadSha,
-        updated_at: opts.at,
-    };
-    if (opts.verifyCommands.length > 0 && (opts.shouldRunVerify || opts.alreadyVerifiedSha)) {
-        nextMeta.last_verified_sha = opts.branchHeadSha;
-        nextMeta.last_verified_at = opts.at;
-        nextMeta.verify = opts.meta.verify
-            ? { ...opts.meta.verify, status: "pass" }
-            : { status: "pass", command: opts.verifyCommands.join(" && ") };
-    }
-    return nextMeta;
-}
-export function resolveShellInvocation(command) {
-    if (os.platform() === "win32") {
-        const rawComspec = process.env.ComSpec ?? process.env.COMSPEC;
-        const shellCommand = rawComspec && rawComspec !== "undefined" && rawComspec !== "null" ? rawComspec : "cmd.exe";
-        return { command: shellCommand, args: ["/d", "/s", "/c", command] };
-    }
-    return { command: "sh", args: ["-lc", command] };
-}
-export function parsePrMeta(raw, taskId) {
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        throw new Error(`JSON Parse error: ${message}`);
-    }
-    const meta = validateTaskPrMeta(parsed);
-    if (meta.task_id !== taskId)
-        throw new Error("pr/meta.json task_id mismatch");
-    return meta;
-}
-function asNonEmptyString(value) {
-    if (typeof value !== "string")
-        return undefined;
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
-function asOptionalInteger(value) {
-    return Number.isInteger(value) && Number(value) > 0 ? Number(value) : undefined;
-}
-function asVerifyStatus(value) {
-    if (!value || typeof value !== "object")
-        return undefined;
-    const status = asNonEmptyString(value.status);
-    if (status !== "pass" && status !== "fail" && status !== "skipped")
-        return undefined;
-    const command = asNonEmptyString(value.command);
-    return command ? { status, command } : { status };
-}
-function asMergeStrategy(value) {
-    const strategy = asNonEmptyString(value);
-    return strategy === "squash" || strategy === "merge" || strategy === "rebase"
-        ? strategy
-        : undefined;
-}
-function buildForwardCompatiblePrMeta(parsed, taskId) {
-    if (parsed.schema_version !== 1)
-        return null;
-    if (asNonEmptyString(parsed.task_id) !== taskId)
-        return null;
-    const branch = asNonEmptyString(parsed.branch);
-    const createdAt = asNonEmptyString(parsed.created_at);
-    const updatedAt = asNonEmptyString(parsed.updated_at);
-    if (!branch || !createdAt || !updatedAt)
-        return null;
-    const statusCandidate = asNonEmptyString(parsed.status);
-    const status = statusCandidate === "OPEN" || statusCandidate === "CLOSED" || statusCandidate === "MERGED"
-        ? statusCandidate
-        : undefined;
-    return {
-        schema_version: 1,
-        task_id: taskId,
-        branch,
-        pr_number: asOptionalInteger(parsed.pr_number),
-        pr_url: asNonEmptyString(parsed.pr_url),
-        created_at: createdAt,
-        updated_at: updatedAt,
-        status,
-        merge_strategy: asMergeStrategy(parsed.merge_strategy),
-        merged_at: asNonEmptyString(parsed.merged_at),
-        merge_commit: asNonEmptyString(parsed.merge_commit),
-        last_verified_sha: asNonEmptyString(parsed.last_verified_sha),
-        last_verified_at: asNonEmptyString(parsed.last_verified_at),
-        verify: asVerifyStatus(parsed.verify) ?? { status: "skipped" },
-        base: asNonEmptyString(parsed.base),
-        head_sha: asNonEmptyString(parsed.head_sha),
-    };
-}
-export function parsePrMetaForwardCompatible(raw, taskId) {
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        throw new Error(`JSON Parse error: ${message}`);
-    }
-    try {
-        const meta = validateTaskPrMeta(parsed);
-        if (meta.task_id !== taskId)
-            throw new Error("pr/meta.json task_id mismatch");
-        return meta;
-    }
-    catch (err) {
-        const compat = buildForwardCompatiblePrMeta(parsed, taskId);
-        if (compat)
-            return compat;
-        throw err;
-    }
-}
-export function extractLastVerifiedSha(logText) {
-    const regex = /verified_sha=([0-9a-f]{7,40})/gi;
-    let match = null;
-    let last = null;
-    while ((match = regex.exec(logText))) {
-        last = match[1] ?? null;
-    }
-    return last;
-}
-export async function appendVerifyLog(logPath, header, content) {
-    await mkdir(path.dirname(logPath), { recursive: true });
-    const lines = [header.trimEnd()];
-    if (content)
-        lines.push(content.trimEnd());
-    lines.push("");
-    await writeFile(logPath, `${lines.join("\n")}\n`, { flag: "a" });
-}
-export async function runShellCommand(command, cwd) {
-    const invocation = resolveShellInvocation(command);
-    try {
-        const { stdout, stderr } = await execFileAsync(invocation.command, invocation.args, {
-            cwd,
-            env: process.env,
-            maxBuffer: 10 * 1024 * 1024,
-        });
-        let output = "";
-        if (stdout)
-            output += stdout;
-        if (stderr)
-            output += (output && !output.endsWith("\n") ? "\n" : "") + stderr;
-        return { code: 0, output };
-    }
-    catch (err) {
-        const error = err;
-        let output = "";
-        if (error.stdout)
-            output += String(error.stdout);
-        if (error.stderr)
-            output += (output && !output.endsWith("\n") ? "\n" : "") + String(error.stderr);
-        const code = typeof error.code === "number" ? error.code : 1;
-        return { code, output };
-    }
-}

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

@@ -1,7 +0,0 @@
-import { type CommandContext } from "./task-backend.js";
-export declare function ensureReconciledBeforeMutation(opts: {
-    ctx: CommandContext;
-    command: string;
-    strictTaskScan?: boolean;
-}): Promise<void>;
-//# sourceMappingURL=reconcile-check.d.ts.map

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

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

@@ -1,160 +0,0 @@
-import { exitCodeForError } from "../../cli/exit-codes.js";
-import { withDiagnosticContext } from "./diagnostics.js";
-import { CliError } from "../../shared/errors.js";
-import path from "node:path";
-import { backendUsesLocalTaskStore, listTaskSummariesMemo, loadTaskFromBranchSnapshot, } from "./task-backend.js";
-function compactError(err) {
-    if (err instanceof Error) {
-        const text = err.message.trim();
-        return text.length > 0 ? text : err.name;
-    }
-    return String(err);
-}
-function parseTaskScanWarning(raw) {
-    const trimmed = raw.trim();
-    const match = /^skip:([^:]+):\s*(.+)$/.exec(trimmed);
-    if (!match) {
-        return { raw: trimmed, taskId: null, kind: null };
-    }
-    return {
-        raw: trimmed,
-        taskId: match[1]?.trim() || null,
-        kind: match[2]?.trim() || null,
-    };
-}
-function describePrimaryWarning(warning) {
-    const subject = warning.taskId ? `task README for ${warning.taskId}` : "a task README";
-    switch (warning.kind) {
-        case "invalid_readme_frontmatter": {
-            return {
-                summary: `${subject} has invalid frontmatter and could not be parsed`,
-                likelyCause: `${subject} has invalid frontmatter, so reconcile skipped it before the mutating command could run`,
-                hint: "Fix the malformed task README frontmatter, then rerun the mutating command.",
-            };
-        }
-        case "empty_or_invalid_frontmatter": {
-            return {
-                summary: `${subject} has empty or invalid frontmatter and could not be parsed`,
-                likelyCause: `${subject} is missing required frontmatter fields, so reconcile skipped it before the mutating command could run`,
-                hint: "Restore valid task README frontmatter, then rerun the mutating command.",
-            };
-        }
-        case "unreadable_readme":
-        case "missing_or_unreadable_readme": {
-            return {
-                summary: `${subject} could not be read during task scan`,
-                likelyCause: `${subject} is missing or unreadable, so reconcile skipped it before the mutating command could run`,
-                hint: "Restore or fix the task README file, then rerun the mutating command.",
-            };
-        }
-        default: {
-            return null;
-        }
-    }
-}
-function summarizeWarnings(warnings) {
-    const primary = describePrimaryWarning(parseTaskScanWarning(warnings[0] ?? ""));
-    if (primary) {
-        const extra = warnings.length - 1;
-        if (extra <= 0)
-            return primary.summary;
-        return `${primary.summary}; +${extra} more task scan warning${extra === 1 ? "" : "s"}`;
-    }
-    const preview = warnings.slice(0, 3).join("; ");
-    const suffix = warnings.length > 3 ? `; +${warnings.length - 3} more` : "";
-    return `skipped ${warnings.length} task files during scan (${preview}${suffix})`;
-}
-function buildWarningDiagnostic(warnings) {
-    const primary = describePrimaryWarning(parseTaskScanWarning(warnings[0] ?? ""));
-    if (primary) {
-        return {
-            state: "mutation preflight cannot reconcile task artifacts",
-            likelyCause: primary.likelyCause,
-            hint: primary.hint,
-            nextAction: {
-                command: "agentplane task list --strict-read",
-                reason: "surface the malformed or unreadable task README before retrying mutating commands",
-                reasonCode: "reconcile_task_scan_incomplete",
-            },
-        };
-    }
-    return {
-        state: "mutation preflight found skipped task artifacts",
-        likelyCause: "task scan skipped one or more task artifacts due to parse/read warnings, so the mutating command stopped before touching git state",
-        hint: "Reconcile check failed due to task scan drift or parse/read errors.",
-        nextAction: {
-            command: "agentplane task list --strict-read",
-            reason: "surface task scan/read failures before retrying mutating commands",
-            reasonCode: "reconcile_task_scan_incomplete",
-        },
-    };
-}
-export async function ensureReconciledBeforeMutation(opts) {
-    try {
-        await opts.ctx.git.statusChangedPaths();
-    }
-    catch (err) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_GIT"),
-            code: "E_GIT",
-            message: `reconcile check failed: cannot inspect git status (${compactError(err)})`,
-            context: {
-                command: opts.command,
-                reason_code: "reconcile_git_state_unreadable",
-            },
-        });
-    }
-    if (opts.strictTaskScan === false)
-        return;
-    try {
-        await listTaskSummariesMemo(opts.ctx);
-    }
-    catch (err) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `reconcile check failed: task scan error (${compactError(err)})`,
-            context: {
-                command: opts.command,
-                reason_code: "reconcile_task_scan_failed",
-            },
-        });
-    }
-    const warnings = await filterWarningsResolvedFromTaskBranch(opts.ctx, opts.ctx.taskBackend.getLastListWarnings?.() ?? []);
-    if (warnings.length === 0)
-        return;
-    throw new CliError({
-        exitCode: exitCodeForError("E_VALIDATION"),
-        code: "E_VALIDATION",
-        message: `reconcile check failed: ${summarizeWarnings(warnings)}`,
-        context: withDiagnosticContext({
-            command: opts.command,
-            reason_code: "reconcile_task_scan_incomplete",
-            warning_count: warnings.length,
-        }, buildWarningDiagnostic(warnings)),
-    });
-}
-async function filterWarningsResolvedFromTaskBranch(ctx, warnings) {
-    if (warnings.length === 0 || !backendUsesLocalTaskStore(ctx)) {
-        return warnings;
-    }
-    const kept = [];
-    for (const raw of warnings) {
-        const parsed = parseTaskScanWarning(raw);
-        if (!parsed.taskId ||
-            (parsed.kind !== "missing_or_unreadable_readme" && parsed.kind !== "unreadable_readme")) {
-            kept.push(raw);
-            continue;
-        }
-        const taskId = parsed.taskId;
-        const readmePath = path.join(ctx.resolvedProject.gitRoot, ctx.config.paths.workflow_dir, taskId, "README.md");
-        const snapshot = await loadTaskFromBranchSnapshot({
-            ctx,
-            taskId,
-            readmePath,
-        });
-        if (!snapshot)
-            kept.push(raw);
-    }
-    return kept;
-}

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

@@ -1,71 +0,0 @@
-import type { ResolvedProject } from "@agentplaneorg/core/project";
-import type { AgentplaneConfig } from "@agentplaneorg/core/config";
-import type { ResolvedHarnessContract } from "../../runtime/harness/index.js";
-import { loadTaskBackend, type TaskBackendCapabilities, type TaskBackend, type TaskData, type TaskSummary } from "../../backends/task-backend.js";
-import { GitContext } from "@agentplaneorg/core/git";
-export type CommandMemo = {
-    taskProjection?: Promise<TaskSummary[]>;
-    changedPaths?: Promise<string[]>;
-    headCommit?: Promise<string>;
-    agentIds?: Promise<string[]>;
-    harness?: Promise<ResolvedHarnessContract>;
-};
-export type CommandContext = {
-    resolvedProject: Awaited<ReturnType<typeof loadTaskBackend>>["resolved"];
-    config: Awaited<ReturnType<typeof loadTaskBackend>>["config"];
-    taskBackend: Awaited<ReturnType<typeof loadTaskBackend>>["backend"];
-    backendId: string;
-    backendConfigPath: string;
-    git: GitContext;
-    memo: CommandMemo;
-};
-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;
-    resolvedProject?: ResolvedProject;
-    config?: AgentplaneConfig;
-}): Promise<CommandContext>;
-export declare function loadTaskFromContext(opts: {
-    ctx: CommandContext;
-    taskId: string;
-    preferBranchSnapshot?: boolean;
-    branchSnapshotBranch?: string | null;
-}): Promise<TaskData>;
-export declare function resolveTaskBranchFromContext(opts: {
-    ctx: CommandContext;
-    taskId: string;
-}): Promise<string | null>;
-export declare function loadTaskFromBranchSnapshot(opts: {
-    ctx: CommandContext;
-    taskId: string;
-    readmePath: string;
-    branch?: string | null;
-}): Promise<TaskData | null>;
-export declare function loadBackendTask(opts: {
-    ctx?: CommandContext;
-    cwd: string;
-    rootOverride?: string | null;
-    taskId: string;
-}): Promise<{
-    backend: CommandContext["taskBackend"];
-    backendId: string;
-    backendConfigPath: string;
-    resolved: CommandContext["resolvedProject"];
-    config: CommandContext["config"];
-    task: TaskData;
-}>;
-export declare function writeTasksOrFallback(backend: Pick<TaskBackend, "writeTask" | "writeTasks">, tasks: readonly TaskData[]): Promise<void>;
-export declare function listTaskSummariesMemo(ctx: CommandContext): Promise<TaskSummary[]>;
-export declare function listTaskProjection(ctx: CommandContext): Promise<TaskSummary[] | null>;
-export declare function exportTaskProjectionSnapshot(opts: {
-    ctx: CommandContext;
-    outputPath: string;
-}): Promise<void>;
-//# sourceMappingURL=task-backend.d.ts.map

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

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