agentplane 0.3.24 → 0.3.27

package/dist/commands/task/findings-add.command.js

@@ -1,165 +0,0 @@
-import { usageError } from "../../cli/spec/errors.js";
-import { cmdTaskFindingsAdd } from "./findings.js";
-export const taskFindingsAddSpec = {
-    id: ["task", "findings", "add"],
-    group: "Task",
-    summary: "Append a structured Findings/Notes block; incident promotion is default unless --local-only.",
-    synopsis: [
-        "agentplane task findings add <task-id> --observation <text> --impact <text> --resolution <text> [--local-only] [--repo-fixable] [--incident-scope <text>] [--incident-tag <tag>] [--incident-match <term>] [--incident-advice <text>] [--incident-rule <text>] [--updated-by <id>]",
-    ],
-    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
-    options: [
-        {
-            kind: "string",
-            name: "observation",
-            valueHint: "<text>",
-            description: "Required. Observation field.",
-        },
-        { kind: "string", name: "impact", valueHint: "<text>", description: "Required. Impact field." },
-        {
-            kind: "string",
-            name: "resolution",
-            valueHint: "<text>",
-            description: "Required. Resolution field.",
-        },
-        {
-            kind: "boolean",
-            name: "promote",
-            description: "Compatibility flag. Promotion is the default unless `--local-only` is set.",
-        },
-        {
-            kind: "boolean",
-            name: "external",
-            description: "Compatibility flag. External incident metadata is the default unless `--local-only` is set.",
-        },
-        {
-            kind: "boolean",
-            name: "repo-fixable",
-            description: "Mark the structured finding as repo-fixable so it can promote into incidents.md.",
-        },
-        {
-            kind: "boolean",
-            name: "local-only",
-            default: false,
-            description: "Keep the entry task-local only; omit `Promotion: incident-candidate` and any explicit fixability marker.",
-        },
-        {
-            kind: "string",
-            name: "incident-scope",
-            valueHint: "<text>",
-            description: "Optional. IncidentScope override.",
-        },
-        {
-            kind: "string",
-            name: "incident-tag",
-            valueHint: "<tag>",
-            repeatable: true,
-            description: "Repeatable. IncidentTags entry.",
-        },
-        {
-            kind: "string",
-            name: "incident-match",
-            valueHint: "<term>",
-            repeatable: true,
-            description: "Repeatable. IncidentMatch entry.",
-        },
-        {
-            kind: "string",
-            name: "incident-advice",
-            valueHint: "<text>",
-            description: "Optional. IncidentAdvice field.",
-        },
-        {
-            kind: "string",
-            name: "incident-rule",
-            valueHint: "<text>",
-            description: "Optional. IncidentRule field.",
-        },
-        {
-            kind: "string",
-            name: "updated-by",
-            valueHint: "<id>",
-            description: "Optional. Override doc_updated_by metadata (must be non-empty).",
-        },
-    ],
-    examples: [
-        {
-            cmd: 'agentplane task findings add 202602030608-F1Q8AB --observation "GitHub API EOF retries were manual." --impact "Operators repeated the reconcile loop." --resolution "Switch the retry path to REST polling." --incident-scope "GitHub PR reconciliation" --incident-tag workflow --incident-tag github',
-            why: "Append a promotable external incident candidate without hand-editing the README or remembering hidden flags.",
-        },
-        {
-            cmd: 'agentplane task findings add 202602030608-F1Q8AB --observation "One manual follow-up remains." --impact "Task notes should stay local." --resolution "Track it in Findings only." --local-only',
-            why: "Keep an observation task-local when it should not feed incidents collection.",
-        },
-    ],
-    validateRaw: (raw) => {
-        for (const key of ["observation", "impact", "resolution"]) {
-            const value = raw.opts[key];
-            if (typeof value !== "string" || value.trim() === "") {
-                throw usageError({
-                    spec: taskFindingsAddSpec,
-                    message: `Missing required option: --${key}.`,
-                });
-            }
-        }
-        const updatedBy = raw.opts["updated-by"];
-        if (typeof updatedBy === "string" && updatedBy.trim() === "") {
-            throw usageError({ spec: taskFindingsAddSpec, message: "--updated-by must be non-empty." });
-        }
-        if (raw.opts["local-only"] === true &&
-            (raw.opts.promote === true || raw.opts.external === true || raw.opts["repo-fixable"] === true)) {
-            throw usageError({
-                spec: taskFindingsAddSpec,
-                message: "--local-only cannot be combined with --promote, --external, or --repo-fixable.",
-            });
-        }
-        if (raw.opts.external === true && raw.opts["repo-fixable"] === true) {
-            throw usageError({
-                spec: taskFindingsAddSpec,
-                message: "--external and --repo-fixable are mutually exclusive.",
-            });
-        }
-    },
-    parse: (raw) => {
-        const localOnly = raw.opts["local-only"] === true;
-        const repoFixable = raw.opts["repo-fixable"] === true;
-        const fixability = localOnly ? null : repoFixable ? "repo-fixable" : "external";
-        return {
-            taskId: String(raw.args["task-id"]),
-            observation: String(raw.opts.observation),
-            impact: String(raw.opts.impact),
-            resolution: String(raw.opts.resolution),
-            promote: !localOnly,
-            external: !localOnly,
-            fixability,
-            incidentScope: typeof raw.opts["incident-scope"] === "string" ? raw.opts["incident-scope"] : undefined,
-            incidentTags: raw.opts["incident-tag"] ?? [],
-            incidentMatch: raw.opts["incident-match"] ?? [],
-            incidentAdvice: typeof raw.opts["incident-advice"] === "string" ? raw.opts["incident-advice"] : undefined,
-            incidentRule: typeof raw.opts["incident-rule"] === "string" ? raw.opts["incident-rule"] : undefined,
-            updatedBy: typeof raw.opts["updated-by"] === "string" ? raw.opts["updated-by"] : undefined,
-        };
-    },
-};
-export function makeRunTaskFindingsAddHandler(getCtx) {
-    return async (ctx, p) => {
-        return await cmdTaskFindingsAdd({
-            ctx: await getCtx("task findings add"),
-            cwd: ctx.cwd,
-            rootOverride: ctx.rootOverride,
-            taskId: p.taskId,
-            observation: p.observation,
-            impact: p.impact,
-            resolution: p.resolution,
-            promote: p.promote,
-            external: p.external,
-            fixability: p.fixability === "repo-fixable" ? "repo-fixable" : null,
-            incidentScope: p.incidentScope,
-            incidentTags: p.incidentTags,
-            incidentMatch: p.incidentMatch,
-            incidentAdvice: p.incidentAdvice,
-            incidentRule: p.incidentRule,
-            updatedBy: p.updatedBy,
-        });
-    };
-}

package/dist/commands/task/findings.command.d.ts

@@ -1,7 +0,0 @@
-import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
-export type TaskFindingsParsed = {
-    subcommand?: string;
-};
-export declare const taskFindingsSpec: CommandSpec<TaskFindingsParsed>;
-export declare function runTaskFindings(_ctx: CommandCtx, p: TaskFindingsParsed): Promise<number>;
-//# sourceMappingURL=findings.command.d.ts.map

package/dist/commands/task/findings.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"findings.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/findings.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAY5D,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAM9F"}

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

@@ -1,20 +0,0 @@
-import { loadDirectSubcommandNames, throwGroupCommandUsage } from "../../cli/group-command.js";
-export const taskFindingsSpec = {
-    id: ["task", "findings"],
-    group: "Task",
-    summary: "Structured Findings/Notes commands (incident promotion is default unless --local-only).",
-    synopsis: [
-        "agentplane task findings add <task-id> --observation <text> --impact <text> --resolution <text> [--local-only] [--incident-scope <text>] [--incident-tag <tag>] [--incident-match <term>] [--incident-advice <text>] [--incident-rule <text>] [--updated-by <id>]",
-    ],
-    args: [{ name: "subcommand", required: false, valueHint: "<add>" }],
-    parse: (raw) => ({
-        subcommand: typeof raw.args.subcommand === "string" ? raw.args.subcommand : undefined,
-    }),
-};
-export async function runTaskFindings(_ctx, p) {
-    throwGroupCommandUsage({
-        spec: taskFindingsSpec,
-        cmd: p.subcommand ? [p.subcommand] : [],
-        subcommands: await loadDirectSubcommandNames(["task", "findings"]),
-    });
-}

package/dist/commands/task/findings.d.ts

@@ -1,63 +0,0 @@
-import type { AgentplaneConfig } from "@agentplaneorg/core/config";
-import type { TaskData } from "../../backends/task-backend.js";
-import { type CommandContext } from "../shared/task-backend.js";
-import { type TaskStoreIntent } from "../shared/task-store.js";
-export declare function renderStructuredFindingBlock(opts: {
-    observation: string;
-    impact: string;
-    resolution: string;
-    promote: boolean;
-    external: boolean;
-    fixability?: "repo-fixable" | null;
-    incidentScope?: string;
-    incidentTags: readonly string[];
-    incidentMatch: readonly string[];
-    incidentAdvice?: string;
-    incidentRule?: string;
-}): string;
-export type StructuredFindingMutationPlan = {
-    targetSection: string;
-    expectedCurrentText: string | null;
-    intents: readonly TaskStoreIntent[];
-};
-export declare function buildStructuredFindingMutationPlan(opts: {
-    current: TaskData;
-    config: AgentplaneConfig;
-    observation: string;
-    impact: string;
-    resolution: string;
-    promote: boolean;
-    external: boolean;
-    fixability?: "repo-fixable" | null;
-    incidentScope?: string;
-    incidentTags: readonly string[];
-    incidentMatch: readonly string[];
-    incidentAdvice?: string;
-    incidentRule?: string;
-    updatedBy?: string;
-}): StructuredFindingMutationPlan | null;
-export declare function renderFindingsAddRegistryNote(opts: {
-    promote: boolean;
-    external: boolean;
-    taskId: string;
-    branchPr?: boolean;
-}): string;
-export declare function cmdTaskFindingsAdd(opts: {
-    ctx?: CommandContext;
-    cwd: string;
-    rootOverride?: string;
-    taskId: string;
-    observation: string;
-    impact: string;
-    resolution: string;
-    promote: boolean;
-    external: boolean;
-    fixability?: "repo-fixable" | null;
-    incidentScope?: string;
-    incidentTags: string[];
-    incidentMatch: string[];
-    incidentAdvice?: string;
-    incidentRule?: string;
-    updatedBy?: string;
-}): Promise<number>;
-//# sourceMappingURL=findings.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../../../src/commands/task/findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAI/D,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAoCjC,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAkBT;AAQD,MAAM,MAAM,6BAA6B,GAAG;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;CACrC,CAAC;AAEF,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACvD,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,6BAA6B,GAAG,IAAI,CA0CvC;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CAcT;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ElB"}

package/dist/commands/task/findings.js

@@ -1,188 +0,0 @@
-import { ensureDocSections, normalizeTaskDoc, setMarkdownSection } from "@agentplaneorg/core/tasks";
-import { mapBackendError } from "../../cli/error-map.js";
-import { infoMessage } from "../../cli/output.js";
-import { CliError } from "../../shared/errors.js";
-import { loadCommandContext } from "../shared/task-backend.js";
-import { applyTaskMutation } from "../shared/task-mutation.js";
-import { setTaskSectionIntent, touchTaskDocMetaIntent, } from "../shared/task-store.js";
-import { resolveWritableDocSections } from "./shared.js";
-import { extractDocSection, extractTaskObservationSection, normalizeTaskDocVersion, taskObservationSectionName, } from "./shared/docs.js";
-function ensureNonEmptyFlag(name, value) {
-    const trimmed = value.trim();
-    if (!trimmed) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: `Invalid value for --${name}: empty.`,
-        });
-    }
-    return trimmed;
-}
-function dedupeTrimmed(values) {
-    const seen = new Set();
-    const out = [];
-    for (const raw of values) {
-        const trimmed = raw.trim();
-        if (!trimmed)
-            continue;
-        const key = trimmed.toLowerCase();
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        out.push(trimmed);
-    }
-    return out;
-}
-export function renderStructuredFindingBlock(opts) {
-    const fixability = opts.fixability ?? (opts.external ? "external" : null);
-    const lines = [
-        `- Observation: ${ensureNonEmptyFlag("observation", opts.observation)}`,
-        `  Impact: ${ensureNonEmptyFlag("impact", opts.impact)}`,
-        `  Resolution: ${ensureNonEmptyFlag("resolution", opts.resolution)}`,
-    ];
-    if (opts.promote)
-        lines.push("  Promotion: incident-candidate");
-    if (fixability === "external")
-        lines.push("  Fixability: external");
-    if (fixability === "repo-fixable")
-        lines.push("  Fixability: repo-fixable");
-    if (opts.incidentScope?.trim())
-        lines.push(`  IncidentScope: ${opts.incidentScope.trim()}`);
-    const tags = dedupeTrimmed(opts.incidentTags);
-    if (tags.length > 0)
-        lines.push(`  IncidentTags: ${tags.join(", ")}`);
-    const match = dedupeTrimmed(opts.incidentMatch);
-    if (match.length > 0)
-        lines.push(`  IncidentMatch: ${match.join(", ")}`);
-    if (opts.incidentAdvice?.trim())
-        lines.push(`  IncidentAdvice: ${opts.incidentAdvice.trim()}`);
-    if (opts.incidentRule?.trim())
-        lines.push(`  IncidentRule: ${opts.incidentRule.trim()}`);
-    return lines.join("\n");
-}
-function appendFindingBlock(existingSection, block) {
-    const current = (existingSection ?? "").trim();
-    if (!current)
-        return block;
-    return `${current}\n\n${block}`;
-}
-export function buildStructuredFindingMutationPlan(opts) {
-    const currentDocRaw = typeof opts.current.doc === "string" ? opts.current.doc : "";
-    const docVersion = normalizeTaskDocVersion(opts.current.doc_version);
-    const targetSection = taskObservationSectionName(docVersion);
-    const sectionOrder = resolveWritableDocSections({
-        allowedSections: opts.config.tasks.doc.sections,
-        requiredSections: opts.config.tasks.doc.required_sections,
-        targetSection,
-    });
-    const existingSection = extractTaskObservationSection(currentDocRaw, docVersion);
-    const block = renderStructuredFindingBlock({
-        observation: opts.observation,
-        impact: opts.impact,
-        resolution: opts.resolution,
-        promote: opts.promote,
-        external: opts.external,
-        fixability: opts.fixability ?? null,
-        incidentScope: opts.incidentScope,
-        incidentTags: opts.incidentTags,
-        incidentMatch: opts.incidentMatch,
-        incidentAdvice: opts.incidentAdvice,
-        incidentRule: opts.incidentRule,
-    });
-    const nextSectionText = appendFindingBlock(existingSection, block);
-    const nextDoc = ensureDocSections(setMarkdownSection(currentDocRaw, targetSection, nextSectionText), sectionOrder);
-    if (normalizeTaskDoc(currentDocRaw) === normalizeTaskDoc(nextDoc) && !opts.updatedBy) {
-        return null;
-    }
-    const expectedCurrentText = extractDocSection(currentDocRaw, targetSection);
-    const intents = [
-        setTaskSectionIntent({
-            section: targetSection,
-            text: nextSectionText,
-            requiredSections: sectionOrder,
-            expectedCurrentText,
-        }),
-        ...(opts.updatedBy ? [touchTaskDocMetaIntent({ updatedBy: opts.updatedBy })] : []),
-    ];
-    return { targetSection, expectedCurrentText, intents };
-}
-export function renderFindingsAddRegistryNote(opts) {
-    if (opts.promote && opts.external) {
-        if (opts.branchPr) {
-            return (`incident candidate recorded for ${opts.taskId}; ` +
-                "incidents.md updates later during finish, `verify --collect-incidents`, or `agentplane incidents collect <task-id>`; task-local until base-branch promotion in the current task worktree");
-        }
-        return (`incident candidate recorded for ${opts.taskId}; ` +
-            "incidents.md updates later during finish, `verify --collect-incidents`, or `agentplane incidents collect <task-id>`; task-local in the current checkout until promotion");
-    }
-    return `task-local finding recorded for ${opts.taskId}; incidents.md unchanged in the current checkout`;
-}
-export async function cmdTaskFindingsAdd(opts) {
-    let updatedBy;
-    if (opts.updatedBy !== undefined) {
-        updatedBy = ensureNonEmptyFlag("updated-by", opts.updatedBy);
-    }
-    try {
-        const ctx = opts.ctx ??
-            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-        const backend = ctx.taskBackend;
-        const config = ctx.config;
-        const resolved = ctx.resolvedProject;
-        if (!backend.getTaskDoc || !backend.writeTask) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: "Configured task backend does not support task docs.",
-            });
-        }
-        let targetSection = "Findings";
-        await applyTaskMutation({
-            ctx,
-            taskId: opts.taskId,
-            build: (current) => {
-                const plan = buildStructuredFindingMutationPlan({
-                    current,
-                    config,
-                    observation: opts.observation,
-                    impact: opts.impact,
-                    resolution: opts.resolution,
-                    promote: opts.promote,
-                    external: opts.external,
-                    fixability: opts.fixability ?? null,
-                    incidentScope: opts.incidentScope,
-                    incidentTags: opts.incidentTags,
-                    incidentMatch: opts.incidentMatch,
-                    incidentAdvice: opts.incidentAdvice,
-                    incidentRule: opts.incidentRule,
-                    updatedBy,
-                });
-                if (!plan) {
-                    return null;
-                }
-                targetSection = plan.targetSection;
-                return {
-                    intents: plan.intents,
-                    writeOptions: {
-                        expectedCurrentText: plan.expectedCurrentText,
-                        expectedSection: targetSection,
-                    },
-                };
-            },
-        });
-        const tasksDir = `${resolved.gitRoot}/${config.paths.workflow_dir}`;
-        process.stdout.write(`${tasksDir}/${opts.taskId}/README.md\n`);
-        process.stderr.write(`${infoMessage(`task findings add outcome=entry-appended section=${targetSection}`)}\n`);
-        process.stderr.write(`${infoMessage(renderFindingsAddRegistryNote({
-            promote: opts.promote,
-            external: opts.external,
-            taskId: opts.taskId,
-            branchPr: config.workflow_mode === "branch_pr",
-        }))}\n`);
-        return 0;
-    }
-    catch (err) {
-        if (err instanceof CliError)
-            throw err;
-        throw mapBackendError(err, { command: "task findings add", root: opts.rootOverride ?? null });
-    }
-}

package/dist/commands/task/finish-close.d.ts

@@ -1,22 +0,0 @@
-import type { CommandContext } from "../shared/task-backend.js";
-export declare function clearDirectWorkLockIfMatches(opts: {
-    agentplaneDir: string;
-    taskIds: string[];
-}): Promise<void>;
-export declare function ensureFinishRunsOnBaseBranch(opts: {
-    ctx: CommandContext;
-    cwd: string;
-    rootOverride?: string;
-    baseBranchOverride?: string;
-}): Promise<void>;
-export declare function materializeBranchPrCloseTail(opts: {
-    ctx: CommandContext;
-    cwd: string;
-    rootOverride?: string;
-    taskId: string;
-    baseBranchOverride?: string;
-    quiet: boolean;
-    closeUnstageOthers?: boolean;
-    allowPolicy?: boolean;
-}): Promise<string | null>;
-//# sourceMappingURL=finish-close.d.ts.map

package/dist/commands/task/finish-close.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"finish-close.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish-close.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKhE,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB;AAsBD,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyDzB"}

package/dist/commands/task/finish-close.js

@@ -1,119 +0,0 @@
-import { resolveBaseBranch, gitEnv } from "@agentplaneorg/core/git";
-import { readFile, rm } from "node:fs/promises";
-import path from "node:path";
-import { exitCodeForError } from "../../cli/exit-codes.js";
-import { CliError } from "../../shared/errors.js";
-import { execFileAsync } from "@agentplaneorg/core/process";
-import { gitBranchExists, gitCurrentBranch } from "../shared/git-ops.js";
-import { taskCloseAlreadyRecordedOnBase } from "./close-tail-state.js";
-import { createTaskCloseCommit } from "./finish-shared.js";
-export async function clearDirectWorkLockIfMatches(opts) {
-    const lockPath = path.join(opts.agentplaneDir, "cache", "direct-work.json");
-    try {
-        const text = await readFile(lockPath, "utf8");
-        const parsed = JSON.parse(text);
-        const lockTaskId = parsed && typeof parsed.task_id === "string" ? parsed.task_id : null;
-        if (!lockTaskId)
-            return;
-        if (!opts.taskIds.includes(lockTaskId))
-            return;
-        await rm(lockPath, { force: true });
-    }
-    catch {
-        // best-effort
-    }
-}
-export async function ensureFinishRunsOnBaseBranch(opts) {
-    if (opts.ctx.config.workflow_mode !== "branch_pr")
-        return;
-    const baseBranch = await resolveBaseBranch({
-        cwd: opts.cwd,
-        rootOverride: opts.rootOverride ?? null,
-        cliBaseOpt: opts.baseBranchOverride ?? null,
-        mode: opts.ctx.config.workflow_mode,
-    });
-    if (!baseBranch) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_USAGE"),
-            code: "E_USAGE",
-            message: "Base branch could not be resolved (use `agentplane branch base set` or --base).",
-        });
-    }
-    const currentBranch = await gitCurrentBranch(opts.ctx.resolvedProject.gitRoot);
-    if (currentBranch === baseBranch)
-        return;
-    throw new CliError({
-        exitCode: exitCodeForError("E_GIT"),
-        code: "E_GIT",
-        message: `finish must run on base branch ${baseBranch} in branch_pr mode ` +
-            `(current: ${currentBranch}); integrate first or reconcile from the base checkout.`,
-    });
-}
-async function readHeadCommitHash(gitRoot) {
-    const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD"], {
-        cwd: gitRoot,
-        env: gitEnv(),
-    });
-    const hash = stdout.trim();
-    if (!hash) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_GIT"),
-            code: "E_GIT",
-            message: "Failed to resolve HEAD while preparing a branch_pr close tail.",
-        });
-    }
-    return hash;
-}
-function branchPrCloseBranchName(taskId, headCommitHash) {
-    return `task-close/${taskId}/${headCommitHash.slice(0, 12)}`;
-}
-export async function materializeBranchPrCloseTail(opts) {
-    const gitRoot = opts.ctx.resolvedProject.gitRoot;
-    const baseBranch = await gitCurrentBranch(gitRoot);
-    const alreadyClosedOnBase = await taskCloseAlreadyRecordedOnBase({
-        gitRoot,
-        workflowDir: opts.ctx.config.paths.workflow_dir,
-        taskId: opts.taskId,
-        baseBranch,
-    });
-    if (alreadyClosedOnBase) {
-        return null;
-    }
-    const headCommitHash = await readHeadCommitHash(gitRoot);
-    const closeBranch = branchPrCloseBranchName(opts.taskId, headCommitHash);
-    const branchExists = await gitBranchExists(gitRoot, closeBranch);
-    await execFileAsync("git", branchExists ? ["checkout", closeBranch] : ["checkout", "-b", closeBranch], { cwd: gitRoot, env: gitEnv() });
-    let checkoutError = null;
-    try {
-        await createTaskCloseCommit({
-            ctx: opts.ctx,
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride,
-            taskId: opts.taskId,
-            baseBranchOverride: opts.baseBranchOverride,
-            quiet: opts.quiet,
-            closeUnstageOthers: opts.closeUnstageOthers,
-            allowPolicy: opts.allowPolicy,
-        });
-    }
-    finally {
-        try {
-            await execFileAsync("git", ["checkout", baseBranch], {
-                cwd: gitRoot,
-                env: gitEnv(),
-            });
-        }
-        catch (error) {
-            checkoutError = error;
-        }
-    }
-    if (checkoutError) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_GIT"),
-            code: "E_GIT",
-            message: `Created ${closeBranch} but failed to return to ${baseBranch}; ` +
-                "inspect the local checkout before continuing.",
-        });
-    }
-    return closeBranch;
-}

package/dist/commands/task/finish-command.d.ts

@@ -1,3 +0,0 @@
-import type { FinishOptions } from "./finish-types.js";
-export declare function cmdFinish(options: FinishOptions): Promise<number>;
-//# sourceMappingURL=finish-command.d.ts.map

package/dist/commands/task/finish-command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"finish-command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish-command.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CvE"}

package/dist/commands/task/finish-command.js

@@ -1,56 +0,0 @@
-import { mapBackendError } from "../../cli/error-map.js";
-import { CliError } from "../../shared/errors.js";
-import { emitTraceEvent } from "../../shared/trace-events.js";
-import { ensureActionApproved } from "../shared/approval-requirements.js";
-import { ensureReconciledBeforeMutation } from "../shared/reconcile-check.js";
-import { loadCommandContext } from "../shared/task-backend.js";
-import { ensureFinishRunsOnBaseBranch } from "./finish-close.js";
-import { executeFinishPlan } from "./finish-execute.js";
-import { resolveFinishExecutionPlan } from "./finish-plan.js";
-export async function cmdFinish(options) {
-    try {
-        const ctx = options.ctx ??
-            (await loadCommandContext({ cwd: options.cwd, rootOverride: options.rootOverride ?? null }));
-        emitTraceEvent({
-            component: "task-finish",
-            event: "finish_started",
-            details: { task_count: options.taskIds.length, backend: ctx.backendId },
-        });
-        await ensureReconciledBeforeMutation({ ctx, command: "finish" });
-        await ensureFinishRunsOnBaseBranch({
-            ctx,
-            cwd: options.cwd,
-            rootOverride: options.rootOverride,
-            baseBranchOverride: options.baseBranchOverride,
-        });
-        if (options.force) {
-            await ensureActionApproved({
-                action: "force_action",
-                config: ctx.config,
-                yes: options.yes === true,
-                reason: "finish --force",
-            });
-        }
-        const plan = resolveFinishExecutionPlan({ ctx, options });
-        const code = await executeFinishPlan({ ctx, options, plan });
-        emitTraceEvent({
-            component: "task-finish",
-            event: "finish_completed",
-            details: { task_count: options.taskIds.length, exit_code: code },
-        });
-        return code;
-    }
-    catch (err) {
-        emitTraceEvent({
-            component: "task-finish",
-            event: "finish_failed",
-            details: {
-                task_count: options.taskIds.length,
-                error: err instanceof Error ? err.name : "UnknownError",
-            },
-        });
-        if (err instanceof CliError)
-            throw err;
-        throw mapBackendError(err, { command: "finish", root: options.rootOverride ?? null });
-    }
-}