agentplane 0.3.24 → 0.3.26

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

@@ -1,15 +0,0 @@
-import { type CommandContext } from "../shared/task-backend.js";
-import { type TaskListFilters } from "./shared.js";
-export declare function cmdTaskListWithFilters(opts: {
-    ctx?: CommandContext;
-    cwd: string;
-    rootOverride?: string;
-    filters: TaskListFilters;
-}): Promise<number>;
-export declare function cmdTaskList(opts: {
-    ctx?: CommandContext;
-    cwd: string;
-    rootOverride?: string;
-    filters: TaskListFilters;
-}): Promise<number>;
-//# sourceMappingURL=list.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/task/list.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAElB"}

package/dist/commands/task/list.js

@@ -1,36 +0,0 @@
-import { normalizeTaskStatus } from "@agentplaneorg/core/tasks";
-import { mapBackendError } from "../../cli/error-map.js";
-import { listTaskSummariesMemo, loadCommandContext, } from "../shared/task-backend.js";
-import { formatTaskLine, handleTaskListWarnings, queryTaskProjection, } from "./shared.js";
-export async function cmdTaskListWithFilters(opts) {
-    try {
-        const ctx = opts.ctx ??
-            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-        const tasks = await listTaskSummariesMemo(ctx);
-        handleTaskListWarnings({ backend: ctx.taskBackend, strictRead: opts.filters.strictRead });
-        const { depState, items } = queryTaskProjection({ tasks, filters: opts.filters });
-        for (const task of items) {
-            process.stdout.write(`${formatTaskLine(task, depState.get(task.id))}\n`);
-        }
-        if (!opts.filters.quiet) {
-            const counts = {};
-            for (const task of items) {
-                const status = normalizeTaskStatus(task.status);
-                counts[status] = (counts[status] ?? 0) + 1;
-            }
-            const total = items.length;
-            const summary = Object.keys(counts)
-                .toSorted()
-                .map((key) => `${key}=${counts[key]}`)
-                .join(", ");
-            process.stdout.write(`Total: ${total}${summary ? ` (${summary})` : ""}\n`);
-        }
-        return 0;
-    }
-    catch (err) {
-        throw mapBackendError(err, { command: "task list", root: opts.rootOverride ?? null });
-    }
-}
-export async function cmdTaskList(opts) {
-    return await cmdTaskListWithFilters(opts);
-}

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

@@ -1,5 +0,0 @@
-import type { CommandCtx } from "../../cli/spec/spec.js";
-import type { CommandContext } from "../shared/task-backend.js";
-import type { TaskListParsed } from "./list.spec.js";
-export declare function makeRunTaskListHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskListParsed) => Promise<number>;
-//# sourceMappingURL=list.run.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"list.run.d.ts","sourceRoot":"","sources":["../../../src/commands/task/list.run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACvE,KAAK,UAAU,EAAE,GAAG,cAAc,KAAG,OAAO,CAAC,MAAM,CAAC,CAiBnE"}

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

@@ -1,20 +0,0 @@
-import { makeReadOnlyExecutionContext } from "../../runtime/execution-context.js";
-import { cmdTaskList } from "./list.js";
-export function makeRunTaskListHandler(getCtx) {
-    return async (ctx, p) => {
-        const command = await getCtx("task list");
-        const execution = await makeReadOnlyExecutionContext(command);
-        void execution.policy.evaluate({
-            action: "task_list",
-            config: execution.config,
-            taskId: "",
-            git: { stagedPaths: [] },
-        });
-        return await cmdTaskList({
-            ctx: execution.command,
-            cwd: ctx.cwd,
-            rootOverride: ctx.rootOverride,
-            filters: p.filters,
-        });
-    };
-}

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

@@ -1,7 +0,0 @@
-import type { CommandSpec } from "../../cli/spec/spec.js";
-import type { TaskListFilters } from "./shared.js";
-export type TaskListParsed = {
-    filters: TaskListFilters;
-};
-export declare const taskListSpec: CommandSpec<TaskListParsed>;
-//# sourceMappingURL=list.spec.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"list.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/task/list.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAE1D,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CAuDpD,CAAC"}

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

@@ -1,58 +0,0 @@
-import { usageError } from "../../cli/spec/errors.js";
-import { toStringList } from "../../cli/spec/parse-utils.js";
-export const taskListSpec = {
-    id: ["task", "list"],
-    group: "Task",
-    summary: "List tasks (optionally filtered by status/owner/tag).",
-    options: [
-        {
-            kind: "string",
-            name: "status",
-            valueHint: "<status>",
-            repeatable: true,
-            description: "Repeatable. Filter by status.",
-        },
-        {
-            kind: "string",
-            name: "owner",
-            valueHint: "<owner>",
-            repeatable: true,
-            description: "Repeatable. Filter by owner id.",
-        },
-        {
-            kind: "string",
-            name: "tag",
-            valueHint: "<tag>",
-            repeatable: true,
-            description: "Repeatable. Filter by tag.",
-        },
-        {
-            kind: "boolean",
-            name: "strict-read",
-            default: false,
-            description: "Fail if task scan skips malformed/unreadable task files.",
-        },
-        { kind: "boolean", name: "quiet", default: false, description: "Suppress summary output." },
-    ],
-    examples: [
-        { cmd: "agentplane task list", why: "List all tasks." },
-        { cmd: "agentplane task list --status TODO --owner CODER", why: "List filtered tasks." },
-    ],
-    validateRaw: (raw) => {
-        for (const key of ["status", "owner", "tag"]) {
-            const list = toStringList(raw.opts[key]);
-            if (list.some((s) => s.trim() === "")) {
-                throw usageError({ spec: taskListSpec, message: `Invalid value for --${key}: empty.` });
-            }
-        }
-    },
-    parse: (raw) => ({
-        filters: {
-            status: toStringList(raw.opts.status),
-            owner: toStringList(raw.opts.owner),
-            tag: toStringList(raw.opts.tag),
-            quiet: raw.opts.quiet === true,
-            strictRead: raw.opts["strict-read"] === true,
-        },
-    }),
-};

package/dist/commands/task/migrate-doc.command.d.ts

@@ -1,9 +0,0 @@
-import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
-export type TaskMigrateDocParsed = {
-    all: boolean;
-    quiet: boolean;
-    taskIds: string[];
-};
-export declare const taskMigrateDocSpec: CommandSpec<TaskMigrateDocParsed>;
-export declare function runTaskMigrateDoc(ctx: CommandCtx, p: TaskMigrateDocParsed): Promise<number>;
-//# sourceMappingURL=migrate-doc.command.d.ts.map

package/dist/commands/task/migrate-doc.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrate-doc.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAa,MAAM,wBAAwB,CAAC;AAKjF,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAUF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CAiDhE,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQjG"}

package/dist/commands/task/migrate-doc.command.js

@@ -1,69 +0,0 @@
-import { usageError } from "../../cli/spec/errors.js";
-import { cmdTaskMigrateDoc } from "./migrate-doc.js";
-function normalizeTaskIdsArg(raw) {
-    const value = raw.args["task-id"];
-    if (Array.isArray(value))
-        return value.filter((v) => typeof v === "string" && v.trim().length > 0);
-    if (typeof value === "string" && value.trim().length > 0)
-        return [value];
-    return [];
-}
-export const taskMigrateDocSpec = {
-    id: ["task", "migrate-doc"],
-    group: "Task",
-    summary: "Migrate legacy task README docs to the current README v3 template/metadata format.",
-    args: [{ name: "task-id", required: false, variadic: true, valueHint: "<task-id>" }],
-    options: [
-        { kind: "boolean", name: "all", default: false, description: "Migrate all task READMEs." },
-        {
-            kind: "boolean",
-            name: "quiet",
-            default: false,
-            description: "Suppress normal output (still prints errors).",
-        },
-    ],
-    examples: [
-        { cmd: "agentplane task migrate-doc --all", why: "Migrate all task READMEs." },
-        {
-            cmd: "agentplane task migrate-doc 202602030608-F1Q8AB 202602030609-ABCDEF",
-            why: "Migrate specific task READMEs.",
-        },
-    ],
-    notes: [
-        "Use this after framework upgrade when doctor reports active legacy README v2 tasks or an active v2/v3 mixed state.",
-        "This command upgrades task-local docs; it does not replace framework-managed files such as AGENTS.md or .agentplane/policy/**.",
-    ],
-    validateRaw: (raw) => {
-        const all = raw.opts.all === true;
-        const taskIds = normalizeTaskIdsArg(raw);
-        const hasIds = taskIds.length > 0;
-        if (all && hasIds) {
-            throw usageError({
-                spec: taskMigrateDocSpec,
-                message: "Invalid arguments: use either --all or <task-id>..., not both.",
-            });
-        }
-        if (!all && !hasIds) {
-            throw usageError({
-                spec: taskMigrateDocSpec,
-                message: "Missing task ids (provide <task-id>... or use --all).",
-            });
-        }
-    },
-    parse: (raw) => {
-        return {
-            all: raw.opts.all === true,
-            quiet: raw.opts.quiet === true,
-            taskIds: normalizeTaskIdsArg(raw),
-        };
-    },
-};
-export async function runTaskMigrateDoc(ctx, p) {
-    return await cmdTaskMigrateDoc({
-        cwd: ctx.cwd,
-        rootOverride: ctx.rootOverride,
-        all: p.all,
-        quiet: p.quiet,
-        taskIds: p.taskIds,
-    });
-}

package/dist/commands/task/migrate-doc.d.ts

@@ -1,24 +0,0 @@
-import type { AgentplaneConfig } from "@agentplaneorg/core/config";
-import { resolveProject } from "@agentplaneorg/core/project";
-import { type CommandContext } from "../shared/task-backend.js";
-export type TaskDocMigrationResult = {
-    changed: number;
-    changedPaths: string[];
-};
-export declare function migrateTaskDocsInWorkspace(opts: {
-    cwd: string;
-    rootOverride?: string | null;
-    all: boolean;
-    taskIds: string[];
-    resolvedProject?: Awaited<ReturnType<typeof resolveProject>>;
-    config?: AgentplaneConfig;
-    ctx?: CommandContext;
-}): Promise<TaskDocMigrationResult>;
-export declare function cmdTaskMigrateDoc(opts: {
-    cwd: string;
-    rootOverride?: string;
-    all: boolean;
-    quiet: boolean;
-    taskIds: string[];
-}): Promise<number>;
-//# sourceMappingURL=migrate-doc.d.ts.map

package/dist/commands/task/migrate-doc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrate-doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAO7D,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAKnC,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAqEF,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA4DlC;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlB"}

package/dist/commands/task/migrate-doc.js

@@ -1,151 +0,0 @@
-import { readdir, readFile } from "node:fs/promises";
-import path from "node:path";
-import { loadConfig } from "@agentplaneorg/core/config";
-import { gitEnv } from "@agentplaneorg/core/git";
-import { execFileAsync } from "@agentplaneorg/core/process";
-import { resolveProject } from "@agentplaneorg/core/project";
-import { mapCoreError } from "../../cli/error-map.js";
-import { exitCodeForError } from "../../cli/exit-codes.js";
-import { fileExists, getPathKind } from "../../cli/fs-utils.js";
-import { successMessage } from "../../cli/output.js";
-import { CliError } from "../../shared/errors.js";
-import { exportTaskProjectionSnapshot, loadCommandContext, } from "../shared/task-backend.js";
-import { migrateTaskReadmeDoc } from "./migrate-doc.readme.js";
-async function resolveReadmePaths(opts) {
-    if (!opts.params.all) {
-        return opts.params.taskIds.map((taskId) => path.join(opts.tasksDir, taskId, "README.md"));
-    }
-    if ((await getPathKind(opts.tasksDir)) !== "dir")
-        return [];
-    const entries = await readdir(opts.tasksDir, { withFileTypes: true });
-    const out = [];
-    for (const entry of entries) {
-        if (!entry.isDirectory())
-            continue;
-        const readmePath = path.join(opts.tasksDir, entry.name, "README.md");
-        if (await fileExists(readmePath))
-            out.push(readmePath);
-    }
-    return out;
-}
-async function canStageGitPath(gitRoot, relPath) {
-    try {
-        await execFileAsync("git", ["ls-files", "--error-unmatch", "--", relPath], {
-            cwd: gitRoot,
-            env: gitEnv(),
-        });
-        return true;
-    }
-    catch {
-        // Continue below: untracked paths may still be stageable when they are not ignored.
-    }
-    try {
-        await execFileAsync("git", ["check-ignore", "--quiet", "--", relPath], {
-            cwd: gitRoot,
-            env: gitEnv(),
-        });
-        return false;
-    }
-    catch {
-        return true;
-    }
-}
-async function exportProjectionSnapshotIfChanged(opts) {
-    if (!(opts.ctx.taskBackend.exportProjectionSnapshot || opts.ctx.taskBackend.exportTasksJson)) {
-        return [];
-    }
-    const relOutputPath = opts.tasksPath.replaceAll("\\", "/");
-    const outputPath = path.join(opts.resolvedGitRoot, relOutputPath);
-    let before = null;
-    try {
-        before = await readFile(outputPath, "utf8");
-    }
-    catch {
-        before = null;
-    }
-    await exportTaskProjectionSnapshot({ ctx: opts.ctx, outputPath });
-    let after = null;
-    try {
-        after = await readFile(outputPath, "utf8");
-    }
-    catch {
-        after = null;
-    }
-    if (before === after)
-        return [];
-    return (await canStageGitPath(opts.resolvedGitRoot, relOutputPath)) ? [relOutputPath] : [];
-}
-export async function migrateTaskDocsInWorkspace(opts) {
-    const resolved = opts.resolvedProject ??
-        (await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        }));
-    let config = opts.config;
-    if (!config) {
-        const loadedConfig = await loadConfig(resolved.agentplaneDir);
-        config = loadedConfig.config;
-    }
-    const ctx = opts.ctx ??
-        (await loadCommandContext({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-            resolvedProject: resolved,
-            config,
-        }));
-    const params = { all: opts.all, quiet: false, taskIds: opts.taskIds };
-    const tasksDir = path.join(resolved.gitRoot, config.paths.workflow_dir);
-    const readmePaths = await resolveReadmePaths({ tasksDir, params });
-    if (!opts.all) {
-        for (const readmePath of readmePaths) {
-            if (!(await fileExists(readmePath))) {
-                const taskId = path.basename(path.dirname(readmePath));
-                throw new CliError({
-                    exitCode: exitCodeForError("E_IO"),
-                    code: "E_IO",
-                    message: `Task README not found: ${taskId}`,
-                });
-            }
-        }
-    }
-    let changed = 0;
-    const changedPaths = [];
-    for (const readmePath of readmePaths) {
-        const res = await migrateTaskReadmeDoc({ readmePath, config });
-        if (!res.changed)
-            continue;
-        changed += 1;
-        const relReadmePath = path.relative(resolved.gitRoot, readmePath).replaceAll("\\", "/");
-        if (await canStageGitPath(resolved.gitRoot, relReadmePath)) {
-            changedPaths.push(relReadmePath);
-        }
-    }
-    if (changed > 0) {
-        changedPaths.push(...(await exportProjectionSnapshotIfChanged({
-            ctx,
-            resolvedGitRoot: resolved.gitRoot,
-            tasksPath: config.paths.tasks_path,
-        })));
-    }
-    return { changed, changedPaths: [...new Set(changedPaths)] };
-}
-export async function cmdTaskMigrateDoc(opts) {
-    const params = { all: opts.all, quiet: opts.quiet, taskIds: opts.taskIds };
-    try {
-        const result = await migrateTaskDocsInWorkspace({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-            all: params.all,
-            taskIds: params.taskIds,
-        });
-        if (!params.quiet) {
-            process.stdout.write(`${successMessage("migrated task docs", undefined, `changed=${result.changed}`)}\n`);
-        }
-        return 0;
-    }
-    catch (err) {
-        if (err instanceof CliError)
-            throw err;
-        throw mapCoreError(err, { command: "task migrate-doc", root: opts.rootOverride ?? null });
-    }
-}

package/dist/commands/task/migrate-doc.readme.d.ts

@@ -1,8 +0,0 @@
-import type { AgentplaneConfig } from "@agentplaneorg/core/config";
-export declare function migrateTaskReadmeDoc(opts: {
-    readmePath: string;
-    config: AgentplaneConfig;
-}): Promise<{
-    changed: boolean;
-}>;
-//# sourceMappingURL=migrate-doc.readme.d.ts.map

package/dist/commands/task/migrate-doc.readme.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrate-doc.readme.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.readme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AA4NnE,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAuDhC"}

package/dist/commands/task/migrate-doc.readme.js

@@ -1,225 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { atomicWriteFile } from "@agentplaneorg/core/fs";
-import { ensureDocSections, extractTaskDoc, mergeTaskDoc, normalizeTaskDoc, parseTaskReadme, renderTaskDocFromSections, renderTaskReadme, setMarkdownSection, taskDocToSectionMap, } from "@agentplaneorg/core/tasks";
-import { decodeEscapedTaskTextNewlines, extractDocSection, extractTaskObservationSection, normalizeTaskDocVersion, normalizeVerificationSectionLayout, } from "./shared/docs.js";
-import { defaultTaskDocV3 } from "./doc-template.js";
-const V3_CANONICAL_ORDER = [
-    "Summary",
-    "Scope",
-    "Plan",
-    "Verify Steps",
-    "Verification",
-    "Rollback Plan",
-    "Findings",
-];
-const HUMAN_TEXT_SECTIONS = new Set(["summary", "context", "scope", "plan", "findings", "notes"]);
-function isRecord(value) {
-    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function normalizeRevision(value) {
-    return Number.isInteger(value) && typeof value === "number" && value > 0 ? value : null;
-}
-function normalizeCanonicalSections(value) {
-    if (!isRecord(value))
-        return null;
-    const out = {};
-    for (const [title, text] of Object.entries(value)) {
-        const normalizedTitle = title.trim();
-        if (!normalizedTitle || typeof text !== "string")
-            continue;
-        out[normalizedTitle] = text.replaceAll("\r\n", "\n").trimEnd();
-    }
-    return Object.keys(out).length > 0 ? out : null;
-}
-function normalizeSectionKey(section) {
-    return section.trim().replaceAll(/\s+/g, " ").toLowerCase();
-}
-function parseMarkdownSections(doc) {
-    const lines = doc.replaceAll("\r\n", "\n").split("\n");
-    const sections = [];
-    let current = null;
-    for (const line of lines) {
-        const match = /^##\s+(.*)$/.exec(line.trim());
-        if (match) {
-            if (current) {
-                current.text = current.text.trimEnd();
-                sections.push(current);
-            }
-            current = { title: (match[1] ?? "").trim(), text: "" };
-            continue;
-        }
-        if (current) {
-            current.text = current.text.length > 0 ? `${current.text}\n${line}` : line;
-        }
-    }
-    if (current) {
-        current.text = current.text.trimEnd();
-        sections.push(current);
-    }
-    return sections;
-}
-function renderMarkdownSections(sections) {
-    return sections
-        .map((section) => {
-        const text = section.text.trimEnd();
-        return text ? `## ${section.title}\n\n${text}` : `## ${section.title}\n`;
-    })
-        .join("\n\n")
-        .trimEnd();
-}
-function normalizeLiteralNewlinesInHumanSection(title, text) {
-    if (!HUMAN_TEXT_SECTIONS.has(normalizeSectionKey(title)))
-        return text.trimEnd();
-    return decodeEscapedTaskTextNewlines(text).trimEnd();
-}
-function firstSectionText(sections, title) {
-    const target = normalizeSectionKey(title);
-    return sections.find((section) => normalizeSectionKey(section.title) === target)?.text ?? null;
-}
-function mergeObservationText(doc, version) {
-    const preferred = extractTaskObservationSection(doc, version)?.trim() ?? "";
-    const notes = extractDocSection(doc, "Notes")?.trim() ?? "";
-    const findings = extractDocSection(doc, "Findings")?.trim() ?? "";
-    const out = [];
-    for (const candidate of [preferred, findings, notes]) {
-        if (!candidate)
-            continue;
-        if (out.includes(candidate))
-            continue;
-        out.push(candidate);
-    }
-    return out.join("\n\n").trim();
-}
-function migrateDocToV3(opts) {
-    const currentSections = parseMarkdownSections(opts.doc);
-    const defaultSections = parseMarkdownSections(defaultTaskDocV3({ title: opts.title, description: opts.description }));
-    const emitted = new Set();
-    const nextSections = [];
-    const observationText = mergeObservationText(opts.doc, 2);
-    for (const title of V3_CANONICAL_ORDER) {
-        const key = normalizeSectionKey(title);
-        const currentText = firstSectionText(currentSections, title);
-        const defaultText = firstSectionText(defaultSections, title) ?? "";
-        let nextText = currentText ?? defaultText;
-        if (title === "Verification") {
-            nextText = normalizeVerificationSectionLayout(currentText ?? defaultText, 3);
-        }
-        if (title === "Findings") {
-            nextText = observationText || defaultText;
-        }
-        if (nextText === null)
-            continue;
-        nextText = normalizeLiteralNewlinesInHumanSection(title, nextText);
-        nextSections.push({ title, text: nextText.trimEnd() });
-        emitted.add(key);
-        if (title === "Findings")
-            emitted.add("notes");
-    }
-    for (const section of currentSections) {
-        const key = normalizeSectionKey(section.title);
-        if (emitted.has(key))
-            continue;
-        nextSections.push({ title: section.title, text: section.text.trimEnd() });
-        emitted.add(key);
-    }
-    return renderMarkdownSections(nextSections);
-}
-function ensurePlanApprovalFrontmatter(frontmatter) {
-    const raw = frontmatter.plan_approval;
-    if (isRecord(raw) && typeof raw.state === "string")
-        return;
-    frontmatter.plan_approval = {
-        state: "pending",
-        updated_at: null,
-        updated_by: null,
-        note: null,
-    };
-}
-function ensureVerificationFrontmatter(frontmatter) {
-    const raw = frontmatter.verification;
-    if (isRecord(raw) && typeof raw.state === "string")
-        return;
-    frontmatter.verification = {
-        state: "pending",
-        updated_at: null,
-        updated_by: null,
-        note: null,
-    };
-}
-const DATE_ONLY_ON_RE = /\bon (\d{4}-\d{2}-\d{2})(?!T)\b/g;
-function isIsoTimestamp(value) {
-    if (!value.includes("T") || !value.endsWith("Z"))
-        return false;
-    const ms = Date.parse(value);
-    return Number.isFinite(ms);
-}
-function normalizeNoteTimestamp(opts) {
-    if (!isIsoTimestamp(opts.updatedAt))
-        return opts.note;
-    const updatedDate = opts.updatedAt.slice(0, 10);
-    return opts.note.replaceAll(DATE_ONLY_ON_RE, (match, date) => {
-        if (date !== updatedDate)
-            return match;
-        return `on ${opts.updatedAt}`;
-    });
-}
-function normalizeFrontmatterNoteTimestamps(frontmatter) {
-    const plan = frontmatter.plan_approval;
-    if (isRecord(plan) && typeof plan.note === "string" && typeof plan.updated_at === "string") {
-        plan.note = normalizeNoteTimestamp({ note: plan.note, updatedAt: plan.updated_at });
-    }
-    const verification = frontmatter.verification;
-    if (isRecord(verification) &&
-        typeof verification.note === "string" &&
-        typeof verification.updated_at === "string") {
-        verification.note = normalizeNoteTimestamp({
-            note: verification.note,
-            updatedAt: verification.updated_at,
-        });
-    }
-}
-export async function migrateTaskReadmeDoc(opts) {
-    const originalRaw = await readFile(opts.readmePath, "utf8");
-    const original = originalRaw.endsWith("\n") ? originalRaw : `${originalRaw}\n`;
-    const parsed = parseTaskReadme(original);
-    const frontmatter = { ...parsed.frontmatter };
-    ensurePlanApprovalFrontmatter(frontmatter);
-    ensureVerificationFrontmatter(frontmatter);
-    normalizeFrontmatterNoteTimestamps(frontmatter);
-    const canonicalSections = normalizeCanonicalSections(frontmatter.sections);
-    const required = opts.config.tasks.doc.required_sections;
-    const extracted = extractTaskDoc(parsed.body);
-    const baseDoc = canonicalSections === null
-        ? extracted || parsed.body
-        : renderTaskDocFromSections(canonicalSections);
-    let nextDoc = normalizeTaskDoc(ensureDocSections(baseDoc, required));
-    const docVersion = normalizeTaskDocVersion(frontmatter.doc_version);
-    if (docVersion === 2) {
-        frontmatter.doc_version = 3;
-        nextDoc = migrateDocToV3({
-            title: typeof frontmatter.title === "string" ? frontmatter.title : "",
-            description: typeof frontmatter.description === "string" ? frontmatter.description : "",
-            doc: nextDoc,
-        });
-    }
-    else {
-        const verificationSection = extractDocSection(nextDoc, "Verification");
-        const normalizedVerification = normalizeVerificationSectionLayout(verificationSection, docVersion);
-        nextDoc = setMarkdownSection(nextDoc, "Verification", normalizedVerification);
-        for (const sectionTitle of ["Summary", "Context", "Scope", "Plan", "Findings", "Notes"]) {
-            const sectionText = extractDocSection(nextDoc, sectionTitle);
-            if (sectionText == null)
-                continue;
-            nextDoc = setMarkdownSection(nextDoc, sectionTitle, normalizeLiteralNewlinesInHumanSection(sectionTitle, sectionText));
-        }
-    }
-    const nextBody = extracted ? mergeTaskDoc(parsed.body, nextDoc) : nextDoc;
-    frontmatter.sections = taskDocToSectionMap(nextDoc);
-    frontmatter.revision = normalizeRevision(frontmatter.revision) ?? 1;
-    const rendered = renderTaskReadme(frontmatter, nextBody);
-    const next = rendered.endsWith("\n") ? rendered : `${rendered}\n`;
-    if (next === original)
-        return { changed: false };
-    await atomicWriteFile(opts.readmePath, next, "utf8");
-    return { changed: true };
-}