@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/cli/register-mutation.js

@@ -1,1894 +1,20 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c9d736d1-58bf-5088-aaae-0b89ad61d41f")}catch(e){}}();
-import { resolveBodyFileContent, resolveCliBulkIdsInput, EXIT_CODE, splitCommaList, PmCliError, createUnknownSubcommandError, } from "../sdk/runtime-primitives.js";
-import { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, MERGE_SUBCOMMAND_VALUES, PLAN_CREATE_METADATA_PARAMETER_KEYS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, } from "../sdk/cli-contracts.js";
-import { BUILTIN_ITEM_TYPE_VALUES, PLAN_STEP_LINK_KIND_VALUES, } from "../types/index.js";
-import { MERGE_DRIVER_ARTIFACT_VALUES, runMergeDriver, runMergeInstall, runMergeReconcile, runMergeReceiptEvidenceReport, } from "./commands/merge.js";
-import { runAppend } from "./commands/append.js";
-import { runClose } from "./commands/close.js";
-import { runCloseMany } from "./commands/close-many.js";
-import { runCopy } from "./commands/copy.js";
-import { runCreate } from "./commands/create.js";
-import { runDelete } from "./commands/delete.js";
-import { runDeps } from "./commands/deps.js";
-import { runDocs } from "./commands/docs.js";
-import { runFiles, runFilesDiscover } from "./commands/files.js";
-import { runFocus } from "./commands/focus.js";
-import { assertHistoryCompactTarget, runHistoryCompact, runHistoryCompactBulk, } from "./commands/history-compact.js";
-import { runHistoryRedact } from "./commands/history-redact.js";
-import { assertHistoryRepairTarget, runHistoryRepair, runHistoryRepairAll, } from "./commands/history-repair.js";
-import * as profileModule from "./commands/profile.js";
-import { runRestore } from "./commands/restore.js";
-import * as schemaModule from "./commands/schema.js";
-import { runUpdate } from "./commands/update.js";
-import { runUpdateMany } from "./commands/update-many.js";
-import { createStdinTokenResolver, preserveMutationStdinTokenFields, preserveMutationStdinTokenLiterals, } from "../sdk/runtime-primitives.js";
-import { resolveDescriptionStdin } from "./description-stdin.js";
-import { itemDocumentToMutationOptions } from "../sdk/structured-mutations.js";
-import { registerStructuredMutationCommands } from "./register-structured-mutation.js";
-import { registerHistoryAuthorAcknowledgeCommand } from "./register-history-author.js";
-import { PLAN_SUBCOMMANDS, runPlan } from "./commands/plan.js";
-import { registerAnnotationCommands } from "./register-annotations.js";
-import { registerFilesLookupCommand } from "./register-files-lookup.js";
-import { isPureSnakeCaseAlias, looksLikeSchemaSubcommandTypo, parseSchemaOrderOption, } from "./schema-registration-helpers.js";
-export { looksLikeSchemaSubcommandTypo, parseSchemaOrderOption, } from "./schema-registration-helpers.js";
-// Lowercase set of built-in type names ("epic", "feature", ...) used by the
-// `pm create` positional guard (pm-edge #1, 2026-05-28): if the single
-// positional exactly matches a known type AND no --title was given, we throw
-// instead of silently creating a Task titled with the type name.
-const BUILTIN_TYPE_NAME_LOOKUP = new Set(BUILTIN_ITEM_TYPE_VALUES.map((value) => value.toLowerCase()));
-const PLAN_CREATE_METADATA_OPTION_TARGETS = new Set(PLAN_CREATE_METADATA_PARAMETER_KEYS.map((key) => key === "estimate" ? "estimatedMinutes" : key));
-import { collect, applyActiveCommandResultService, addHiddenOption, addHiddenOptions, extractUpdateManyMutationOptionSource, formatHookWarnings, getGlobalOptions, invalidateSearchCachesForMutation, normalizeCreateOptions, normalizeUpdateOptions, printError, printResult, readOptionString, writeStdout, } from "./registration-helpers.js";
-function dispatchSchemaMigration(schema, inputs) {
-    const kind = inputs.normalizedSubcommand;
-    if (kind !== "rename-type" &&
-        kind !== "rename-field" &&
-        kind !== "remap-status") {
-        return null;
-    }
-    return schema.runSchemaEvolutionMigration({
-        kind,
-        from: inputs.typeName,
-        to: readOptionString(inputs.options, "to"),
-        ...(kind === "rename-field" && typeof inputs.options.type === "string"
-            ? { type: inputs.options.type }
-            : {}),
-    }, {
-        migrationId: readOptionString(inputs.options, "migrationId") ??
-            readOptionString(inputs.options, "migration_id"),
-        dryRun: inputs.options.dryRun === true,
-        author: inputs.author,
-        force: inputs.force,
-    }, inputs.globalOptions);
-}
-function dispatchSchemaReadRemoveOrPreset(schema, inputs) {
-    const { normalizedSubcommand, typeName, globalOptions, author, force } = inputs;
-    switch (normalizedSubcommand) {
-        case "list":
-            return schema.runSchemaList(globalOptions);
-        case "show":
-            return schema.runSchemaShow(typeName, globalOptions);
-        case "show-status":
-            return schema.runSchemaShowStatus(typeName, globalOptions);
-        case "list-fields":
-            return schema.runSchemaListFields(globalOptions);
-        case "show-field":
-            return schema.runSchemaShowField(typeName, globalOptions);
-        case "remove-type":
-            return schema.runSchemaRemoveType(typeName, { author, force }, globalOptions);
-        case "remove-field":
-            return schema.runSchemaRemoveField(typeName, { author, force }, globalOptions);
-        case "remove-status":
-            return schema.runSchemaRemoveStatus(typeName, { author, force }, globalOptions);
-        case "apply-preset":
-            return schema.runSchemaApplyPreset(typeName, { author, force }, globalOptions);
-        default:
-            return null;
-    }
-}
-/** Routes a normalized `pm schema` subcommand to its run function. Extracted from the schema `.action()` body so the per-subcommand dispatch lives in one single-purpose function and registerMutationCommands stays under the cyclomatic-complexity gate. */
-async function dispatchSchemaSubcommand(schema, inputs) {
-    const { normalizedSubcommand, typeName, options, globalOptions } = inputs;
-    const { author, force, description } = inputs;
-    const migration = dispatchSchemaMigration(schema, inputs);
-    if (migration)
-        return migration;
-    const readRemoveOrPreset = dispatchSchemaReadRemoveOrPreset(schema, inputs);
-    if (readRemoveOrPreset)
-        return readRemoveOrPreset;
-    switch (normalizedSubcommand) {
-        case "add-field":
-            return schema.runSchemaAddField(typeName, {
-                type: typeof options.type === "string" ? options.type : undefined,
-                commands: inputs.commands,
-                description,
-                cliFlag: typeof options.cliFlag === "string" ? options.cliFlag : undefined,
-                alias: inputs.aliases,
-                required: Boolean(options.required),
-                requiredOnCreate: Boolean(options.requiredOnCreate),
-                // commander stores --no-allow-unset as allowUnset:false; the default
-                // (flag omitted) is true. Forward the tri-state faithfully.
-                allowUnset: options.allowUnset !== false,
-                requiredTypes: inputs.requiredTypes,
-                author,
-                force,
-            }, globalOptions);
-        case "add-status":
-            return schema.runSchemaAddStatus(typeName, {
-                role: inputs.roles,
-                alias: inputs.aliases,
-                description,
-                order: inputs.order,
-                author,
-                force,
-            }, globalOptions);
-        default:
-            // add-type, optionally in --infer mode.
-            if (options.infer === true) {
-                return schema.runSchemaInferTypes({
-                    minCount: inputs.minCount,
-                    apply: Boolean(options.apply),
-                    author,
-                    force,
-                }, globalOptions);
-            }
-            return schema.runSchemaAddType(typeName, {
-                description,
-                defaultStatus: inputs.defaultStatus,
-                folder: typeof options.folder === "string" ? options.folder : undefined,
-                alias: inputs.aliases,
-                author,
-                force,
-            }, globalOptions);
-    }
-}
-/** Renders a schema command result for non-JSON, non-quiet output and surfaces any on-write hook warnings. Extracted from the schema `.action()` body to keep registerMutationCommands under the cyclomatic-complexity gate. */
-function renderSchemaResultHuman(schema, result) {
-    if ("migration_id" in result) {
-        writeStdout(`${schema.formatSchemaEvolutionMigrationHuman(result)}\n`);
-        return;
-    }
-    switch (result.action) {
-        case "list":
-            writeStdout(`${schema.formatSchemaListHuman(result)}\n`);
-            return;
-        case "show":
-            writeStdout(`${schema.formatSchemaShowHuman(result)}\n`);
-            return;
-        case "show-status":
-            writeStdout(`${schema.formatSchemaShowStatusHuman(result)}\n`);
-            return;
-        case "list-fields":
-            writeStdout(`${schema.formatSchemaListFieldsHuman(result)}\n`);
-            return;
-        case "show-field":
-            writeStdout(`${schema.formatSchemaShowFieldHuman(result)}\n`);
-            return;
-        case "remove-type":
-            writeStdout(`${schema.formatSchemaRemoveTypeHuman(result)}\n`);
-            break;
-        case "remove-field":
-            writeStdout(`${schema.formatSchemaRemoveFieldHuman(result)}\n`);
-            break;
-        case "apply-preset":
-            writeStdout(`${schema.formatSchemaApplyPresetHuman(result)}\n`);
-            break;
-        case "infer-types":
-            writeStdout(`${schema.formatSchemaInferTypesHuman(result)}\n`);
-            break;
-        case "add-field":
-            writeStdout(`${schema.formatSchemaAddFieldHuman(result)}\n`);
-            break;
-        case "add-status":
-            writeStdout(`${schema.formatSchemaAddStatusHuman(result)}\n`);
-            break;
-        case "remove-status":
-            writeStdout(`${schema.formatSchemaRemoveStatusHuman(result)}\n`);
-            break;
-        default:
-            writeStdout(`${schema.formatSchemaAddTypeHuman(result)}\n`);
-            break;
-    }
-    // Surface extension on-write hook diagnostics (mutation subcommands only;
-    // inspection results carry no warnings array).
-    if (result.warnings.length > 0) {
-        printError(`schema ${result.action} warnings: ${formatHookWarnings(result.warnings)}`);
-    }
-}
-/** Routes a normalized `pm profile` subcommand to its run function. Extracted from the profile `.action()` body so the per-subcommand dispatch lives in one place. */
-async function dispatchProfileSubcommand(profile, subcommand, name, options, globalOptions) {
-    switch (subcommand) {
-        case "list":
-            return profile.runProfileList();
-        case "show":
-            return profile.runProfileShow(name);
-        case "lint":
-            return profile.runProfileLint(name);
-        default:
-            return profile.runProfileApply(name, {
-                dryRun: options.dryRun === true,
-                author: typeof options.author === "string" ? options.author : undefined,
-                force: options.force === true,
-            }, globalOptions);
-    }
-}
-/** Renders a profile command result for non-JSON, non-quiet output and surfaces any on-write hook warnings from an apply. */
-function renderProfileResultHuman(profile, result) {
-    switch (result.action) {
-        case "list":
-            writeStdout(`${profile.formatProfileListHuman(result)}\n`);
-            return;
-        case "show":
-            writeStdout(`${profile.formatProfileShowHuman(result)}\n`);
-            return;
-        case "lint":
-            writeStdout(`${profile.formatProfileLintHuman(result)}\n`);
-            return;
-        default:
-            writeStdout(`${profile.formatProfileApplyHuman(result)}\n`);
-            if (result.warnings.length > 0) {
-                printError(`profile apply warnings: ${formatHookWarnings(result.warnings)}`);
-            }
-            break;
-    }
-}
-/** Build a commander argParser that coerces a flag value into a positive (1-based) integer, throwing a usage error when the supplied value is not a whole number >= 1. Used by `pm comments --edit/--delete <index>` so an invalid index fails fast with a clear message instead of silently coercing. */
-export function parsePositiveIntOption(flag) {
-    return (value) => {
-        const parsed = Number(value);
-        if (!Number.isInteger(parsed) || parsed < 1) {
-            throw new PmCliError(`${flag} must be a positive integer (1-based index).`, EXIT_CODE.USAGE);
-        }
-        return parsed;
-    };
-}
-// Bulk content-field selection filters (GH-242) shared by update-many and
-// close-many. Each pair mirrors the list-family presence/absence flags but uses
-// the `--filter-` prefix so they live in the bulk-selection namespace. The
-// governance-missing filters (GH-236) reuse the same `--filter-<gov>-missing`
-// spelling as the list family.
-function registerBulkContentAndGovernanceFilters(command, action) {
-    command
-        .option("--filter-has-notes", `Select only items that have notes before ${action}`)
-        .option("--filter-no-notes", `Select only items that have no notes before ${action}`)
-        .option("--filter-has-learnings", `Select only items that have learnings before ${action}`)
-        .option("--filter-no-learnings", `Select only items that have no learnings before ${action}`)
-        .option("--filter-has-files", `Select only items that have linked files before ${action}`)
-        .option("--filter-no-files", `Select only items that have no linked files before ${action}`)
-        .option("--filter-has-docs", `Select only items that have linked docs before ${action}`)
-        .option("--filter-no-docs", `Select only items that have no linked docs before ${action}`)
-        .option("--filter-has-tests", `Select only items that have linked tests before ${action}`)
-        .option("--filter-no-tests", `Select only items that have no linked tests before ${action}`)
-        .option("--filter-has-comments", `Select only items that have comments before ${action}`)
-        .option("--filter-no-comments", `Select only items that have no comments before ${action}`)
-        .option("--filter-has-deps", `Select only items that have dependencies before ${action}`)
-        .option("--filter-no-deps", `Select only items that have no dependencies before ${action}`)
-        .option("--filter-has-body", `Select only items that have a non-empty body before ${action}`)
-        .option("--filter-empty-body", `Select only items with an empty body before ${action}`)
-        .option("--filter-has-linked-command", `Select only items whose linked tests carry a runnable command before ${action}`)
-        .option("--filter-no-linked-command", `Select only items whose linked tests carry no runnable command before ${action}`)
-        .option("--filter-reviewer-missing", `Select only items missing reviewer before ${action}`)
-        .option("--filter-risk-missing", `Select only items missing risk before ${action}`)
-        .option("--filter-confidence-missing", `Select only items missing confidence before ${action}`)
-        .option("--filter-sprint-missing", `Select only items missing sprint before ${action}`)
-        .option("--filter-release-missing", `Select only items missing release before ${action}`);
-}
-// Map the bulk content/governance `--filter-*` commander options into the
-// ListOptions content/governance fields runList consumes. Shared by update-many
-// and close-many.
-// [hasCommanderKey, noCommanderKey, --filter-has flag, --filter-no flag]
-const BULK_CONTENT_FILTER_CONFLICTS = [
-    [
-        "filterHasNotes",
-        "filterNoNotes",
-        "--filter-has-notes",
-        "--filter-no-notes",
-    ],
-    [
-        "filterHasLearnings",
-        "filterNoLearnings",
-        "--filter-has-learnings",
-        "--filter-no-learnings",
-    ],
-    [
-        "filterHasFiles",
-        "filterNoFiles",
-        "--filter-has-files",
-        "--filter-no-files",
-    ],
-    ["filterHasDocs", "filterNoDocs", "--filter-has-docs", "--filter-no-docs"],
-    [
-        "filterHasTests",
-        "filterNoTests",
-        "--filter-has-tests",
-        "--filter-no-tests",
-    ],
-    [
-        "filterHasComments",
-        "filterNoComments",
-        "--filter-has-comments",
-        "--filter-no-comments",
-    ],
-    ["filterHasDeps", "filterNoDeps", "--filter-has-deps", "--filter-no-deps"],
-    [
-        "filterHasBody",
-        "filterEmptyBody",
-        "--filter-has-body",
-        "--filter-empty-body",
-    ],
-    [
-        "filterHasLinkedCommand",
-        "filterNoLinkedCommand",
-        "--filter-has-linked-command",
-        "--filter-no-linked-command",
-    ],
-];
-function mapBulkContentAndGovernanceFilters(options) {
-    const presence = (key) => options[key] === true ? true : undefined;
-    // Catch a both-present-and-absent bulk request here so the error names the
-    // bulk --filter-* flags the user actually typed, rather than the downstream
-    // list-level --has-/--no- flags resolveContentFieldFilters would report.
-    for (const [hasKey, noKey, hasFlag, noFlag,] of BULK_CONTENT_FILTER_CONFLICTS) {
-        if (options[hasKey] === true && options[noKey] === true) {
-            throw new PmCliError(`Cannot combine ${hasFlag} with ${noFlag} for the same field.`, EXIT_CODE.USAGE);
-        }
-    }
-    return {
-        filterReviewerMissing: presence("filterReviewerMissing"),
-        filterRiskMissing: presence("filterRiskMissing"),
-        filterConfidenceMissing: presence("filterConfidenceMissing"),
-        filterSprintMissing: presence("filterSprintMissing"),
-        filterReleaseMissing: presence("filterReleaseMissing"),
-        hasNotes: presence("filterHasNotes"),
-        hasLearnings: presence("filterHasLearnings"),
-        hasFiles: presence("filterHasFiles"),
-        hasDocs: presence("filterHasDocs"),
-        hasTests: presence("filterHasTests"),
-        hasComments: presence("filterHasComments"),
-        hasDeps: presence("filterHasDeps"),
-        hasBody: presence("filterHasBody"),
-        hasLinkedCommand: presence("filterHasLinkedCommand"),
-        noNotes: presence("filterNoNotes"),
-        noLearnings: presence("filterNoLearnings"),
-        noFiles: presence("filterNoFiles"),
-        noDocs: presence("filterNoDocs"),
-        noTests: presence("filterNoTests"),
-        noComments: presence("filterNoComments"),
-        noDeps: presence("filterNoDeps"),
-        emptyBody: presence("filterEmptyBody"),
-        noLinkedCommand: presence("filterNoLinkedCommand"),
-    };
-}
-/** Implements register commander option contracts for the public runtime surface of this module. */
-export function registerCommanderOptionContracts(command, contracts) {
-    for (const contract of contracts) {
-        const sharedValues = [];
-        let activeParseArgs = command.args;
-        const repeatableParser = (value) => {
-            if (command.args !== activeParseArgs) {
-                sharedValues.length = 0;
-                activeParseArgs = command.args;
-            }
-            sharedValues.push(value);
-            return sharedValues;
-        };
-        if (contract.required) {
-            command.requiredOption(contract.option, contract.description);
-        }
-        else if (contract.repeatable) {
-            command.option(contract.option, contract.description, repeatableParser);
-        }
-        else {
-            command.option(contract.option, contract.description);
-        }
-        for (const aliasContract of contract.aliasOptions ?? []) {
-            // Hide pure snake_case underscore-duplicate aliases (e.g. --create_mode
-            // for --create-mode) from --help, but keep semantically-distinct aliases
-            // (e.g. --ac for --acceptance-criteria) visible.
-            if (isPureSnakeCaseAlias(contract.option, aliasContract.option)) {
-                addHiddenOption(command, aliasContract.option, aliasContract.description, contract.repeatable === true, contract.repeatable ? repeatableParser : undefined);
-            }
-            else if (contract.repeatable) {
-                command.option(aliasContract.option, aliasContract.description, repeatableParser);
-            }
-            else {
-                command.option(aliasContract.option, aliasContract.description);
-            }
-        }
-    }
-}
-/** Map raw `update-many --filter-*` commander options into the ListOptions shape runList consumes. Extracted from registerMutationCommands so its many string/boolean coercions do not inflate that function's cyclomatic complexity. */
-function buildUpdateManyListOptions(options) {
-    const readString = (key) => typeof options[key] === "string" ? options[key] : undefined;
-    return {
-        type: readString("filterType"),
-        tag: readString("filterTag"),
-        priority: readString("filterPriority"),
-        deadlineBefore: readString("filterDeadlineBefore"),
-        deadlineAfter: readString("filterDeadlineAfter"),
-        updatedAfter: readString("filterUpdatedAfter"),
-        updatedBefore: readString("filterUpdatedBefore"),
-        createdAfter: readString("filterCreatedAfter"),
-        createdBefore: readString("filterCreatedBefore"),
-        ids: readString("ids"),
-        assignee: readString("filterAssignee"),
-        assigneeFilter: readString("filterAssigneeFilter") ?? readString("filterAssignee_filter"),
-        parent: readString("filterParent"),
-        sprint: readString("filterSprint"),
-        release: readString("filterRelease"),
-        filterAcMissing: options.filterAcMissing === true ? true : undefined,
-        filterEstimatesMissing: options.filterEstimatesMissing === true ||
-            options.filterEstimateMissing === true
-            ? true
-            : undefined,
-        filterResolutionMissing: options.filterResolutionMissing === true ? true : undefined,
-        filterMetadataMissing: options.filterMetadataMissing === true ? true : undefined,
-        ...mapBulkContentAndGovernanceFilters(options),
-        limit: readString("limit"),
-        offset: readString("offset"),
-        includeBody: true,
-    };
-}
-function pickStringOption(...candidates) {
-    for (const candidate of candidates) {
-        if (typeof candidate === "string") {
-            return candidate;
-        }
-    }
-    return undefined;
-}
-function stringArrayOption(value) {
-    if (Array.isArray(value)) {
-        return value;
-    }
-    if (typeof value === "string") {
-        return [value];
-    }
-    return undefined;
-}
-function resolveCreatePositionals(typeOrTitle, secondTitle, options) {
-    if (typeof secondTitle === "string" && secondTitle.length > 0) {
-        return { positionalType: typeOrTitle, positionalTitle: secondTitle };
-    }
-    if (typeof typeOrTitle !== "string" || typeOrTitle.length === 0) {
-        return { positionalType: undefined, positionalTitle: undefined };
-    }
-    const explicitTitleProvided = typeof options.title === "string" && options.title.trim().length > 0;
-    return explicitTitleProvided && options.type === undefined
-        ? { positionalType: typeOrTitle, positionalTitle: undefined }
-        : { positionalType: undefined, positionalTitle: typeOrTitle };
-}
-function assertCreatePositionalTypeHasTitle(positionalType, positionalTitle, options) {
-    if (positionalType !== undefined ||
-        typeof positionalTitle !== "string" ||
-        positionalTitle.length === 0 ||
-        options.title !== undefined ||
-        options.type !== undefined ||
-        !BUILTIN_TYPE_NAME_LOOKUP.has(positionalTitle.trim().toLowerCase())) {
-        return;
-    }
-    const matchedType = positionalTitle.trim();
-    throw new PmCliError(`pm create needs a title — "${matchedType}" looks like an item type, not a title. Use either: pm create ${matchedType} "<title>" or pm create "<title>" --type ${matchedType}.`, EXIT_CODE.USAGE, {
-        code: "create_positional_type_without_title",
-        why: 'Without this guard the single positional is used as the title and the type defaults to Task — so the command would silently create a Task literally titled "' +
-            matchedType +
-            '".',
-        examples: [
-            `pm create ${matchedType} "Wire up SSO for the agent harness"`,
-            `pm create "Wire up SSO for the agent harness" --type ${matchedType}`,
-        ],
-        nextSteps: [
-            `Re-run with both type and title: pm create ${matchedType} "<title>"`,
-        ],
-    });
-}
-const STRUCTURED_STDIN_CONFLICT_KEYS = [
-    "body",
-    "bodyFile",
-    "description",
-    "dep",
-    "depRemove",
-    "comment",
-    "note",
-    "learning",
-    "file",
-    "test",
-    "doc",
-    "reminder",
-    "event",
-    "typeOption",
-    "field",
-    "ids",
-];
-function assertSingleMutationStdinConsumer(options) {
-    const stdinFlags = STRUCTURED_STDIN_CONFLICT_KEYS.flatMap((key) => {
-        const value = options[key];
-        const count = typeof value === "string" && value.trim() === "-"
-            ? 1
-            : Array.isArray(value)
-                ? value.filter((entry) => typeof entry === "string" && entry.trim() === "-").length
-                : 0;
-        const flag = `--${key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
-        return Array.from({ length: count }, () => flag);
-    });
-    if (options.stdinJson === true) {
-        stdinFlags.unshift("--stdin-json");
-    }
-    if (stdinFlags.length > 1) {
-        throw new PmCliError(`Only one option may consume stdin per command invocation. Found: ${stdinFlags.join(", ")}.`, EXIT_CODE.USAGE);
-    }
-}
-function preserveResolvedMutationStdinFields(options, bodyFileResolved, descriptionStdinResolved) {
-    const fields = [];
-    if (bodyFileResolved)
-        fields.push("body");
-    if (descriptionStdinResolved)
-        fields.push("description");
-    preserveMutationStdinTokenFields(options, fields);
-}
-function isDescriptionStdinConsumer(options, stdinJsonConsumed) {
-    return (!stdinJsonConsumed &&
-        typeof options.description === "string" &&
-        options.description.trim() === "-");
-}
-async function runCreateAction(typeOrTitle, secondTitle, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    assertSingleMutationStdinConsumer(options);
-    const stdinJsonConsumed = options.stdinJson === true;
-    if (stdinJsonConsumed) {
-        const input = await createStdinTokenResolver().resolveValue("-", "--stdin-json");
-        options = itemDocumentToMutationOptions(input ?? "", "create", options);
-    }
-    const positionals = resolveCreatePositionals(typeOrTitle, secondTitle, options);
-    assertCreatePositionalTypeHasTitle(positionals.positionalType, positionals.positionalTitle, options);
-    if (typeof positionals.positionalType === "string" &&
-        positionals.positionalType.length > 0 &&
-        options.type === undefined) {
-        options.type = positionals.positionalType;
-    }
-    if (typeof positionals.positionalTitle === "string" &&
-        positionals.positionalTitle.length > 0 &&
-        options.title === undefined)
-        options.title = positionals.positionalTitle;
-    const descriptionStdinResolved = isDescriptionStdinConsumer(options, stdinJsonConsumed);
-    if (!stdinJsonConsumed) {
-        await resolveDescriptionStdin(options);
-    }
-    const bodyFileResolved = typeof options.bodyFile === "string";
-    if (bodyFileResolved) {
-        options.body = await resolveBodyFileContent(String(options.bodyFile), options.body !== undefined ? String(options.body) : undefined);
-        delete options.bodyFile;
-    }
-    const normalized = normalizeCreateOptions(options, { requireType: false });
-    preserveResolvedMutationStdinFields(normalized, bodyFileResolved, descriptionStdinResolved);
-    if (stdinJsonConsumed)
-        preserveMutationStdinTokenLiterals(normalized);
-    const result = await runCreate(normalized, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=create took_ms=${Date.now() - startedAt}`);
-    }
-}
-function buildCloseManyListOptions(options) {
-    return {
-        type: readOptionString(options, "filterType"),
-        tag: readOptionString(options, "filterTag"),
-        priority: readOptionString(options, "filterPriority"),
-        deadlineBefore: readOptionString(options, "filterDeadlineBefore"),
-        deadlineAfter: readOptionString(options, "filterDeadlineAfter"),
-        updatedAfter: readOptionString(options, "filterUpdatedAfter"),
-        updatedBefore: readOptionString(options, "filterUpdatedBefore"),
-        createdAfter: readOptionString(options, "filterCreatedAfter"),
-        createdBefore: readOptionString(options, "filterCreatedBefore"),
-        ids: readOptionString(options, "ids"),
-        assignee: readOptionString(options, "filterAssignee"),
-        assigneeFilter: pickStringOption(options.filterAssigneeFilter, options.filterAssignee_filter),
-        parent: readOptionString(options, "filterParent"),
-        sprint: readOptionString(options, "filterSprint"),
-        release: readOptionString(options, "filterRelease"),
-        ...mapBulkContentAndGovernanceFilters(options),
-        limit: readOptionString(options, "limit"),
-        offset: readOptionString(options, "offset"),
-    };
-}
-async function runCloseManyAction(options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    assertSingleMutationStdinConsumer(options);
-    options.ids = await resolveCliBulkIdsInput(readOptionString(options, "ids"));
-    const result = await runCloseMany({
-        status: readOptionString(options, "filterStatus"),
-        list: buildCloseManyListOptions(options),
-        reason: readOptionString(options, "reason"),
-        completedAt: readOptionString(options, "completedAt"),
-        resolution: readOptionString(options, "resolution"),
-        expectedResult: pickStringOption(options.expectedResult, options.expected_result, options.expected),
-        actualResult: pickStringOption(options.actualResult, options.actual_result, options.actual),
-        validateClose: options.validateClose === true
-            ? "warn"
-            : readOptionString(options, "validateClose"),
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        force: Boolean(options.force),
-        dryRun: options.dryRun === true ? true : undefined,
-        rollback: readOptionString(options, "rollback"),
-        checkpoint: options.checkpoint === false ? false : undefined,
-    }, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=close-many took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runUpdateManyAction(options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    assertSingleMutationStdinConsumer(options);
-    options.ids = await resolveCliBulkIdsInput(readOptionString(options, "ids"));
-    const result = await runUpdateMany({
-        status: readOptionString(options, "filterStatus"),
-        list: buildUpdateManyListOptions(options),
-        update: normalizeUpdateOptions(extractUpdateManyMutationOptionSource(options)),
-        dryRun: options.dryRun === true ? true : undefined,
-        rollback: readOptionString(options, "rollback"),
-        checkpoint: options.checkpoint === false ? false : undefined,
-    }, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(await applyActiveCommandResultService("update-many", [], options, globalOptions, result), globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=update-many took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runCloseAction(id, text, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const reasonFromOption = (typeof options.reason === "string" &&
-        options.reason.trim().length > 0 &&
-        options.reason) ||
-        (typeof options.closeReason === "string" &&
-            options.closeReason.trim().length > 0 &&
-            options.closeReason) ||
-        undefined;
-    const resolvedText = typeof text === "string" && text.length > 0 ? text : reasonFromOption;
-    const result = await runClose(id, resolvedText, {
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        validateClose: options.validateClose === true
-            ? "warn"
-            : readOptionString(options, "validateClose"),
-        force: Boolean(options.force),
-        duplicateOf: readOptionString(options, "duplicateOf"),
-        completedAt: readOptionString(options, "completedAt"),
-        resolution: readOptionString(options, "resolution"),
-        expectedResult: pickStringOption(options.expectedResult, options.expected_result, options.expected),
-        actualResult: pickStringOption(options.actualResult, options.actual_result, options.actual),
-    }, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=close took_ms=${Date.now() - startedAt}`);
-    }
-}
-function normalizePlanAliases(options) {
-    const planOptions = { ...options };
-    const aliasPairs = [
-        ["blocked_by", "blockedBy"],
-        ["resume_context", "resumeContext"],
-        ["from_search", "fromSearch"],
-        ["step_title", "stepTitle"],
-        ["step_body", "stepBody"],
-        ["step_owner", "stepOwner"],
-        ["step_status", "stepStatus"],
-        ["step_evidence", "stepEvidence"],
-        ["step_blocked_reason", "stepBlockedReason"],
-        ["step_replacement", "stepReplacement"],
-        ["depends_on", "dependsOn"],
-        ["link_kind", "linkKind"],
-        ["link_note", "linkNote"],
-        ["promote_to_item_dep", "promoteToItemDep"],
-        ["allow_multiple_active", "allowMultipleActive"],
-        ["decision_text", "decisionText"],
-        ["decision_rationale", "decisionRationale"],
-        ["decision_evidence", "decisionEvidence"],
-        ["discovery_text", "discoveryText"],
-        ["validation_text", "validationText"],
-        ["validation_command", "validationCommand"],
-        ["validation_expected", "validationExpected"],
-        ["materialize_type", "materializeType"],
-        ["materialize_parent", "materializeParent"],
-        ["materialize_tags", "materializeTags"],
-    ];
-    for (const [snake, camel] of aliasPairs) {
-        if (planOptions[snake] !== undefined && planOptions[camel] === undefined) {
-            planOptions[camel] = planOptions[snake];
-        }
-    }
-    const normalized = normalizeCreateOptions(planOptions, {
-        requireType: false,
-    });
-    normalized.blockedBy = planOptions.blockedBy;
-    return normalized;
-}
-function assertKnownPlanSubcommand(normalized, allowed) {
-    if (!normalized) {
-        throw new PmCliError(`pm plan requires a subcommand. Allowed: ${allowed.join(", ")}`, EXIT_CODE.USAGE, {
-            code: "missing_required_argument",
-            examples: [
-                'pm plan create --title "Refactor lock retry"',
-                "pm plan show pm-a1b2 --depth standard",
-                'pm plan add-step pm-a1b2 --step-title "Read lock.ts"',
-            ],
-        });
-    }
-    if (allowed.includes(normalized)) {
-        return;
-    }
-    const examples = normalized === "list" || normalized === "ls"
-        ? ["pm list --type Plan", "pm list-all --type Plan"]
-        : undefined;
-    throw createUnknownSubcommandError({
-        command_path: "plan",
-        token: normalized,
-        allowed,
-        examples,
-        retry_command: normalized === "list" || normalized === "ls"
-            ? "pm list --type Plan"
-            : undefined,
-    });
-}
-function parsePlanReorderTo(normalizedSubcommand, reorderToken) {
-    if (normalizedSubcommand !== "reorder-step" ||
-        typeof reorderToken !== "string") {
-        return undefined;
-    }
-    const parsed = Number.parseInt(reorderToken, 10);
-    if (!Number.isFinite(parsed)) {
-        throw new PmCliError(`reorder-step requires an integer new order, got "${reorderToken}"`, EXIT_CODE.USAGE);
-    }
-    return parsed;
-}
-async function runPlanAction(subcommand, id, stepRef, reorderToken, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
-    assertKnownPlanSubcommand(normalizedSubcommand, PLAN_SUBCOMMANDS);
-    const planOptions = normalizePlanAliases(options);
-    const reorderTo = parsePlanReorderTo(normalizedSubcommand, reorderToken);
-    const planId = normalizedSubcommand === "create" &&
-        typeof id === "string" &&
-        id.length > 0 &&
-        planOptions.title === undefined
-        ? undefined
-        : id;
-    if (planId === undefined && typeof id === "string" && id.length > 0) {
-        planOptions.title = id;
-    }
-    const result = await runPlan({
-        subcommand: normalizedSubcommand,
-        id: planId,
-        stepRef,
-        reorderTo,
-        options: planOptions,
-        global: globalOptions,
-    });
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=plan took_ms=${Date.now() - startedAt}`);
-    }
-}
-function parseNonNegativeIntFlag(raw, flag) {
-    if (typeof raw !== "string") {
-        return undefined;
-    }
-    if (!/^\d+$/.test(raw.trim())) {
-        throw new PmCliError(`history-compact ${flag} must be a non-negative integer.`, EXIT_CODE.USAGE);
-    }
-    return Number.parseInt(raw, 10);
-}
-/** Run the audited post-merge reconciliation branch and map failures to CLI exit state. */
-async function runMergeReconcileSubcommand(artifact, options, globalOptions) {
-    if (artifact !== undefined) {
-        throw new PmCliError("merge reconcile takes no positional arguments.", EXIT_CODE.USAGE);
-    }
-    const result = await runMergeReconcile({
-        dryRun: options.dryRun === true,
-        force: options.force === true,
-        message: typeof options.message === "string" ? options.message : undefined,
-        author: globalOptions.author,
-    }, globalOptions);
-    printResult(result, globalOptions);
-    if (!result.ok)
-        process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-}
-/** Run the field-aware merge-driver branch and map unresolved conflicts to git's expected nonzero exit state. */
-async function runMergeDriverSubcommand(artifact, base, ours, theirs, options, globalOptions) {
-    if (artifact === undefined ||
-        base === undefined ||
-        ours === undefined ||
-        theirs === undefined) {
-        throw new PmCliError("merge driver requires <artifact> <base> <ours> <theirs> (git supplies %O %A %B). Example: pm merge driver history %O %A %B", EXIT_CODE.USAGE);
-    }
-    const result = await runMergeDriver({
-        artifact,
-        basePath: base,
-        oursPath: ours,
-        theirsPath: theirs,
-        outputPath: typeof options.output === "string" ? options.output : undefined,
-        itemPath: typeof options.itemPath === "string" ? options.itemPath : undefined,
-        prefer: typeof options.prefer === "string" ? options.prefer : undefined,
-    }, globalOptions);
-    printResult(result, globalOptions);
-    if (!result.ok) {
-        // Nonzero exit tells git the path is still conflicted; the merged file
-        // stays parseable with the preferred side's values.
-        process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-    }
-}
-async function runMergeAction(subcommand, artifact, base, ours, theirs, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const normalized = subcommand.trim().toLowerCase();
-    switch (normalized) {
-        case "install": {
-            if (artifact !== undefined) {
-                throw new PmCliError("merge install takes no positional arguments.", EXIT_CODE.USAGE);
-            }
-            const result = await runMergeInstall({ dryRun: options.dryRun === true }, globalOptions);
-            printResult(result, globalOptions);
-            break;
-        }
-        case "reconcile":
-            await runMergeReconcileSubcommand(artifact, options, globalOptions);
-            break;
-        case "report": {
-            if (artifact !== undefined) {
-                throw new PmCliError("merge report takes no positional arguments.", EXIT_CODE.USAGE);
-            }
-            const result = await runMergeReceiptEvidenceReport({
-                includeReconciled: options.includeReconciled === true,
-            });
-            printResult(result, globalOptions);
-            if (!result.ok)
-                process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-            break;
-        }
-        case "driver":
-            await runMergeDriverSubcommand(artifact, base, ours, theirs, options, globalOptions);
-            break;
-        default:
-            throw createUnknownSubcommandError({
-                command_path: "merge",
-                token: subcommand,
-                allowed: MERGE_SUBCOMMAND_VALUES,
-                display_name: "merge",
-            });
-    }
-    if (globalOptions.profile) {
-        printError(`profile:command=merge took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runHistoryCompactAction(id, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const idsValue = await resolveCliBulkIdsInput(readOptionString(options, "ids"));
-    const ids = idsValue === undefined ? undefined : splitCommaList(idsValue);
-    const allOver = parseNonNegativeIntFlag(options.allOver, "--all-over");
-    const minEntries = parseNonNegativeIntFlag(options.minEntries, "--min-entries");
-    if (options.closed === true && options.allStreams === true) {
-        throw new PmCliError("history-compact: --closed and --all-streams are mutually exclusive; pick one lifecycle scope.", EXIT_CODE.USAGE);
-    }
-    const scope = options.closed === true
-        ? "closed"
-        : options.allStreams === true
-            ? "all-streams"
-            : undefined;
-    const isBulk = ids !== undefined || allOver !== undefined || scope !== undefined;
-    if (isBulk && typeof options.before === "string") {
-        throw new PmCliError("history-compact: --before applies only in single-id mode (bulk mode always compacts full streams).", EXIT_CODE.USAGE);
-    }
-    assertHistoryCompactTarget(id, { ids, allOver, scope });
-    if (id === undefined) {
-        const result = await runHistoryCompactBulk({
-            ids,
-            scope,
-            allOver,
-            minEntries,
-            dryRun: options.dryRun === true,
-            author: readOptionString(options, "author"),
-            message: readOptionString(options, "message"),
-            force: Boolean(options.force),
-        }, globalOptions);
-        printResult(result, globalOptions);
-        if (result.totals.items_errored > 0) {
-            process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-        }
-    }
-    else {
-        const result = await runHistoryCompact(id, {
-            before: readOptionString(options, "before"),
-            dryRun: options.dryRun === true,
-            author: readOptionString(options, "author"),
-            message: readOptionString(options, "message"),
-            force: Boolean(options.force),
-        }, globalOptions);
-        printResult(result, globalOptions);
-    }
-    if (globalOptions.profile) {
-        printError(`profile:command=history-compact took_ms=${Date.now() - startedAt}`);
-    }
-}
-function splitCollectedCommaList(raw) {
-    if (!Array.isArray(raw)) {
-        return undefined;
-    }
-    return raw
-        .flatMap((value) => value.split(","))
-        .map((value) => value.trim())
-        .filter((value) => value.length > 0);
-}
-async function runSchemaAction(subcommand, name, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { SCHEMA_SUBCOMMANDS } = schemaModule;
-    let normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
-    let typeName = name;
-    assertSchemaSubcommandPresent(normalizedSubcommand, SCHEMA_SUBCOMMANDS);
-    if (!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand) &&
-        typeName === undefined &&
-        !looksLikeSchemaSubcommandTypo(subcommand)) {
-        typeName = subcommand;
-        normalizedSubcommand = "add-type";
-    }
-    if (!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand)) {
-        throw createUnknownSubcommandError({
-            command_path: "schema",
-            token: normalizedSubcommand,
-            allowed: SCHEMA_SUBCOMMANDS,
-        });
-    }
-    const result = await dispatchSchemaSubcommand(schemaModule, {
-        normalizedSubcommand,
-        typeName,
-        options,
-        aliases: stringArrayOption(options.alias),
-        roles: stringArrayOption(options.role),
-        commands: splitCollectedCommaList(options.commands),
-        requiredTypes: splitCollectedCommaList(options.requiredTypes),
-        defaultStatus: pickStringOption(options.defaultStatus, options.default_status),
-        order: parseSchemaOrderOption(options.order),
-        minCount: parseSchemaOrderOption(options.minCount),
-        author: readOptionString(options, "author"),
-        force: Boolean(options.force),
-        description: readOptionString(options, "description"),
-        globalOptions,
-    });
-    if (globalOptions.json === true ||
-        globalOptions.defaultOutputFormat === "json") {
-        printResult(result, globalOptions);
-    }
-    else if (!globalOptions.quiet) {
-        renderSchemaResultHuman(schemaModule, result);
-    }
-    if (globalOptions.profile) {
-        printError(`profile:command=schema took_ms=${Date.now() - startedAt}`);
-    }
-}
-function assertSchemaSubcommandPresent(normalizedSubcommand, allowed) {
-    if (normalizedSubcommand) {
-        return;
-    }
-    throw new PmCliError(`pm schema requires a subcommand. Allowed: ${allowed.join(", ")}`, EXIT_CODE.USAGE, {
-        code: "missing_required_argument",
-        examples: [
-            "pm schema list",
-            "pm schema show Task",
-            "pm schema show-status open",
-            'pm schema add-type Spike --description "Time-boxed investigation" --default-status open',
-            "pm schema remove-type Spike",
-            "pm schema add-status review --role active --alias in_review",
-            "pm schema remove-status review",
-            "pm schema add-field severity_level --type string --commands create,update",
-            "pm schema list-fields",
-            "pm schema apply-preset agile",
-            "pm schema add-type --infer --min-count 10",
-            "pm schema rename-type Spike --to Experiment --migration-id spike-v2 --dry-run",
-            "pm schema rename-field severity --to impact --migration-id severity-v2",
-            "pm schema remap-status review --to verifying --migration-id review-v2",
-        ],
-    });
-}
-async function runCopyAction(id, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const result = await runCopy(id, {
-        title: readOptionString(options, "title"),
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        allowDuplicate: options.allowDuplicate === true,
-    }, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=copy took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runFocusAction(id, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const result = await runFocus(id, { clear: options.clear === true }, globalOptions);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=focus took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runUpdateAction(id, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    assertSingleMutationStdinConsumer(options);
-    const stdinJsonConsumed = options.stdinJson === true;
-    if (stdinJsonConsumed) {
-        const input = await createStdinTokenResolver().resolveValue("-", "--stdin-json");
-        options = itemDocumentToMutationOptions(input ?? "", "update", options);
-    }
-    const descriptionStdinResolved = isDescriptionStdinConsumer(options, stdinJsonConsumed);
-    if (!stdinJsonConsumed) {
-        await resolveDescriptionStdin(options);
-    }
-    // GH-214: resolve --body-file into the existing body field before
-    // normalization so the rest of update is unchanged. CLI-only input alias.
-    const bodyFileResolved = typeof options.bodyFile === "string";
-    if (bodyFileResolved) {
-        options.body = await resolveBodyFileContent(String(options.bodyFile), options.body !== undefined ? String(options.body) : undefined);
-        delete options.bodyFile;
-    }
-    const normalized = normalizeUpdateOptions(options);
-    preserveResolvedMutationStdinFields(normalized, bodyFileResolved, descriptionStdinResolved);
-    if (stdinJsonConsumed)
-        preserveMutationStdinTokenLiterals(normalized);
-    const result = await runUpdate(id, normalized, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(await applyActiveCommandResultService("update", [id], options, globalOptions, result), globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=update took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runDeleteAction(id, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const result = await runDelete(id, {
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        force: Boolean(options.force),
-        dryRun: options.dryRun === true,
-    }, globalOptions);
-    if (result.dry_run !== true) {
-        await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=delete took_ms=${Date.now() - startedAt}`);
-    }
-}
-function resolveAppendBody(text, options) {
-    const bodyFromOption = readOptionString(options, "body");
-    const bodyFromAlias = readOptionString(options, "text");
-    const bodyFromPositional = typeof text === "string" ? text : undefined;
-    const bodySourceCount = [
-        bodyFromOption,
-        bodyFromAlias,
-        bodyFromPositional,
-    ].filter((value) => value !== undefined).length;
-    if (bodySourceCount > 1) {
-        throw new PmCliError("Specify append text with exactly one source: positional [text], --body, or --text", EXIT_CODE.USAGE);
-    }
-    const resolvedBody = bodyFromOption ?? bodyFromAlias ?? bodyFromPositional;
-    if (resolvedBody === undefined) {
-        throw new PmCliError("Missing append text. Provide it as positional [text], --body <value>, or --text <value> (use - for stdin).", EXIT_CODE.USAGE);
-    }
-    return resolvedBody;
-}
-async function runAppendAction(id, text, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const result = await runAppend(id, {
-        body: resolveAppendBody(text, options),
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        force: Boolean(options.force),
-    }, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=append took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runRestoreAction(id, target, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const result = await runRestore(id, target, {
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        force: Boolean(options.force),
-    }, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=restore took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runProfileAction(subcommand, name, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { PROFILE_SUBCOMMANDS } = profileModule;
-    const normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
-    if (!normalizedSubcommand) {
-        throw new PmCliError(`pm profile requires a subcommand. Allowed: ${PROFILE_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, {
-            code: "missing_required_argument",
-            examples: [
-                "pm profile list",
-                "pm profile show agile",
-                "pm profile apply agile --dry-run",
-                "pm profile lint agile",
-            ],
-        });
-    }
-    if (!PROFILE_SUBCOMMANDS.includes(normalizedSubcommand)) {
-        throw createUnknownSubcommandError({
-            command_path: "profile",
-            token: normalizedSubcommand,
-            allowed: PROFILE_SUBCOMMANDS,
-        });
-    }
-    const result = await dispatchProfileSubcommand(profileModule, normalizedSubcommand, name, options, globalOptions);
-    // Profile inspection and schema staging do not mutate item content, so search caches stay valid (mirrors pm schema).
-    if (globalOptions.json === true ||
-        globalOptions.defaultOutputFormat === "json") {
-        printResult(result, globalOptions);
-    }
-    else if (!globalOptions.quiet) {
-        renderProfileResultHuman(profileModule, result);
-    }
-    // `pm profile lint` is a validation gate: exit non-zero when the profile has
-    // error-severity findings so shell/CI callers can fail on them. Warnings keep
-    // `ok` true and never fail the command.
-    if (result.action === "lint" && !result.ok) {
-        process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-    }
-    if (globalOptions.profile) {
-        printError(`profile:command=profile took_ms=${Date.now() - startedAt}`);
-    }
-}
-function readStringArrayOption(options, key) {
-    return stringArrayOption(options[key]) ?? [];
-}
-async function runFilesAction(id, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const addValues = readStringArrayOption(options, "add");
-    const addGlobValues = readStringArrayOption(options, "addGlob");
-    const removeValues = readStringArrayOption(options, "remove");
-    const migrateValues = readStringArrayOption(options, "migrate");
-    const result = await runFiles(id, {
-        add: addValues,
-        addGlob: addGlobValues,
-        remove: removeValues,
-        migrate: migrateValues,
-        note: readOptionString(options, "note"),
-        list: Boolean(options.list),
-        appendStable: Boolean(options.appendStable),
-        validatePaths: Boolean(options.validatePaths),
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        force: Boolean(options.force),
-    }, globalOptions);
-    if (addValues.length > 0 ||
-        addGlobValues.length > 0 ||
-        removeValues.length > 0 ||
-        migrateValues.length > 0) {
-        await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printResult(await applyActiveCommandResultService("files", [id], options, globalOptions, result), globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=files took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runFilesDiscoverAction(id, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    // Flags also declared on the parent files command (--note/--append-stable/
-    // --author/--message/--force) are consumed by the parent during parse, so
-    // merge ancestor opts back in (own options win) instead of reading opts() alone.
-    const mergedOptions = {
-        ...command.optsWithGlobals(),
-        ...options,
-    };
-    const result = await runFilesDiscover(id, {
-        apply: Boolean(mergedOptions.apply),
-        note: readOptionString(mergedOptions, "note"),
-        appendStable: Boolean(mergedOptions.appendStable),
-        author: readOptionString(mergedOptions, "author"),
-        message: readOptionString(mergedOptions, "message"),
-        force: Boolean(mergedOptions.force),
-    }, globalOptions);
-    if (result.changed) {
-        await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=files.discover took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runDocsAction(id, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const addValues = readStringArrayOption(options, "add");
-    const addGlobValues = readStringArrayOption(options, "addGlob");
-    const removeValues = readStringArrayOption(options, "remove");
-    const migrateValues = readStringArrayOption(options, "migrate");
-    const result = await runDocs(id, {
-        add: addValues,
-        addGlob: addGlobValues,
-        remove: removeValues,
-        migrate: migrateValues,
-        note: readOptionString(options, "note"),
-        list: Boolean(options.list),
-        validatePaths: Boolean(options.validatePaths),
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        force: Boolean(options.force),
-    }, globalOptions);
-    if (addValues.length > 0 ||
-        addGlobValues.length > 0 ||
-        removeValues.length > 0 ||
-        migrateValues.length > 0) {
-        await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printResult(await applyActiveCommandResultService("docs", [id], options, globalOptions, result), globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=docs took_ms=${Date.now() - startedAt}`);
-    }
-}
-async function runDepsAction(id, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    // --format and --collapse carry commander defaults ("tree"/"none"), so
-    // they are always strings by the time the action runs; --maxDepth has no
-    // default and may be unset. Use `as string` rather than String(...) so an
-    // omitted option stays undefined instead of becoming the literal "undefined".
-    const result = await runDeps(id, {
-        format: options.format,
-        maxDepth: readOptionString(options, "maxDepth"),
-        collapse: options.collapse,
-        summary: options.summary === true,
-        full: options.full === true,
-        nodeLimit: readOptionString(options, "nodeLimit"),
-        edgeLimit: readOptionString(options, "edgeLimit"),
-        tokenBudget: readOptionString(options, "tokenBudget"),
-        cursor: readOptionString(options, "cursor"),
-        direction: readOptionString(options, "direction"),
-        ...(Array.isArray(options.kind)
-            ? { kind: options.kind }
-            : {}),
-    }, globalOptions);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=deps took_ms=${Date.now() - startedAt}`);
-    }
-}
-/** Implements register mutation commands for the public runtime surface of this module. */
-export function registerMutationCommands(program, registrationOptions = {}) {
-    const createCommand = program
-        .command("create")
-        .argument("[type-or-title]", 'Item title, or item type when a title follows (e.g. `pm create task "Fix bug"`)')
-        .argument("[title]", "Item title when the first argument is an item type")
-        .description("Create a new project management item.");
-    registerCommanderOptionContracts(createCommand, CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);
-    createCommand
-        .option("--stdin-json", "Read a full item JSON document from stdin; explicit flags override document values")
-        .option("--body-file <path>", "Load body from a file or stdin (-); conflicts with --body")
-        .option("--clear-deps", "Clear dependency entries")
-        .option("--clear-comments", "Clear comments")
-        .option("--clear-notes", "Clear notes")
-        .option("--clear-learnings", "Clear learnings")
-        .option("--clear-files", "Clear linked files")
-        .option("--clear-tests", "Clear linked tests")
-        .option("--clear-docs", "Clear linked docs")
-        .option("--clear-reminders", "Clear reminders")
-        .option("--clear-events", "Clear events")
-        .option("--clear-type-options", "Clear type options")
-        .option("--allow-duplicate", "Explicitly create even when strict similarity governance finds likely duplicates")
-        .action(runCreateAction);
-    if (registrationOptions.targetCommandName === "create") {
-        return;
-    }
-    program
-        .command("copy")
-        .argument("<id>", "Source item id")
-        .option("--title <value>", "Optional title override for the copied item")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "History message")
-        .option("--allow-duplicate", "Explicitly copy even when strict similarity governance finds likely duplicates")
-        .description("Copy an item into a new item id while resetting lifecycle fields.")
-        .action(runCopyAction);
-    program
-        .command("focus")
-        .argument("[id]", "Item id to focus (omit to show current focus)")
-        .option("--clear", "Clear the focused item")
-        .description("Set/clear/show the session focused item that new items default --parent to.")
-        .action(runFocusAction);
-    const updateCommand = program
-        .command("update")
-        .argument("<id>", "Item id")
-        .description("Update item fields and metadata.");
-    registerCommanderOptionContracts(updateCommand, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);
-    updateCommand
-        .option("--stdin-json", "Read a full item JSON document from stdin; explicit flags override document values")
-        .option("--body-file <path>", "Load body from a file or stdin (-); conflicts with --body")
-        .option("--replace-deps", "Atomically replace dependency entries with the provided --dep values")
-        .option("--replace-tests", "Atomically replace linked test entries with the provided --test values")
-        .option("--replace-files", "Atomically replace linked file entries with the provided --file values")
-        .option("--replace-docs", "Atomically replace linked doc entries with the provided --doc values")
-        .option("--clear-deps", "Clear dependency entries")
-        .option("--clear-comments", "Clear comments")
-        .option("--clear-notes", "Clear notes")
-        .option("--clear-learnings", "Clear learnings")
-        .option("--clear-files", "Clear linked files")
-        .option("--clear-tests", "Clear linked tests")
-        .option("--clear-docs", "Clear linked docs")
-        .option("--clear-reminders", "Clear reminders")
-        .option("--clear-events", "Clear events")
-        .option("--clear-type-options", "Clear type options")
-        .option("--force", "Force ownership override");
-    updateCommand.action(runUpdateAction);
-    registerStructuredMutationCommands(program);
-    const updateManyCommand = program
-        .command("update-many")
-        .description("Bulk-update matched items with dry-run plans and rollback checkpoints.")
-        .option("--filter-status <value>", "Filter by status before applying updates")
-        .option("--filter-type <value>", "Filter by item type before applying updates")
-        .option("--filter-tag <value>", "Filter by tag before applying updates")
-        .option("--filter-priority <value>", "Filter by priority before applying updates")
-        .option("--filter-deadline-before <value>", "Filter by deadline upper bound before applying updates")
-        .option("--filter-deadline-after <value>", "Filter by deadline lower bound before applying updates")
-        .option("--filter-updated-after <value>", "Filter by updated_at lower bound before applying updates (ISO/relative)")
-        .option("--filter-updated-before <value>", "Filter by updated_at upper bound before applying updates (ISO/relative)")
-        .option("--filter-created-after <value>", "Filter by created_at lower bound before applying updates (ISO/relative)")
-        .option("--filter-created-before <value>", "Filter by created_at upper bound before applying updates (ISO/relative)")
-        .option("--filter-assignee <value>", "Filter by assignee before applying updates")
-        .option("--filter-assignee-filter <value>", "Filter assignee presence: assigned|unassigned before applying updates")
-        .option("--filter-parent <value>", "Filter by parent item ID before applying updates")
-        .option("--filter-sprint <value>", "Filter by sprint before applying updates")
-        .option("--filter-release <value>", "Filter by release before applying updates")
-        .option("--filter-ac-missing", "Select only items missing acceptance_criteria (bulk backfill)")
-        .option("--filter-estimates-missing", "Select only items missing estimated_minutes (bulk backfill)")
-        .option("--filter-resolution-missing", "Select only terminal items missing resolution (bulk backfill)")
-        .option("--filter-metadata-missing", "Select only items missing any tracked metadata (AC, estimate, or resolution)");
-    registerBulkContentAndGovernanceFilters(updateManyCommand, "applying updates");
-    updateManyCommand
-        .option("--ids <value>", "Explicit ID allowlist: comma/newline text, - stdin, or @path file")
-        .option("--limit <n>", "Limit matched item count before apply/preview")
-        .option("--offset <n>", "Skip first n matched rows before apply/preview")
-        .option("--dry-run", "Preview per-item diffs and checkpoint intent without mutating")
-        .option("--rollback <value>", "Rollback a prior update-many checkpoint ID")
-        .option("--no-checkpoint", "Disable checkpoint creation during apply mode")
-        .option("--title, -t <value>", "Set title")
-        .option("--description, -d <value>", "Set description")
-        .option("--body, -b <value>", "Set body (allow empty string)")
-        .option("--status, -s <value>", "Set status (use close command for closed)")
-        .option("--priority, -p <value>", "Set priority")
-        .option("--type <value>", "Set type")
-        .option("--tags <value>", "Set comma-separated tags (replaces existing). Use --add-tags / --remove-tags to mutate additively.")
-        .option("--add-tags <value>", "Add tags additively without replacing existing (repeatable; CSV accepted)", collect)
-        .option("--remove-tags <value>", "Remove tags from the existing list (repeatable; CSV accepted)", collect)
-        .option("--deadline <value>", "Set deadline (ISO/date string or relative)")
-        .option("--estimate, --estimated-minutes <value>", "Set estimated minutes")
-        .option("--acceptance-criteria <value>", "Set acceptance criteria")
-        .option("--ac <value>", "Alias for --acceptance-criteria")
-        .option("--add-ac <value>", "Add one semicolon-free acceptance criterion without replacing the existing list (repeatable)", collect)
-        .option("--remove-ac <value>", "Remove one semicolon-free acceptance criterion by exact text match (repeatable)", collect)
-        .option("--definition-of-ready <value>", "Set definition of ready")
-        .option("--order <value>", "Set planning order/rank integer")
-        .option("--rank <value>", "Alias for --order")
-        .option("--goal <value>", "Set goal identifier")
-        .option("--objective <value>", "Set objective identifier")
-        .option("--value <value>", "Set business value summary")
-        .option("--impact <value>", "Set business impact summary")
-        .option("--outcome <value>", "Set expected outcome summary")
-        .option("--why-now <value>", "Set why-now rationale")
-        .option("--assignee <value>", "Set assignee")
-        .option("--parent <value>", "Set parent item ID")
-        .option("--reviewer <value>", "Set reviewer")
-        .option("--risk <value>", "Set risk level")
-        .option("--confidence <value>", "Set confidence level")
-        .option("--sprint <value>", "Set sprint identifier")
-        .option("--release <value>", "Set release identifier")
-        .option("--blocked-by <value>", "Set blocked-by item ID or reason")
-        .option("--blocked-reason <value>", "Set blocked reason")
-        .option("--unblock-note <value>", "Set unblock rationale note")
-        .option("--reporter <value>", "Set issue reporter")
-        .option("--severity <value>", "Set issue severity")
-        .option("--environment <value>", "Set issue environment context")
-        .option("--repro-steps <value>", "Set issue reproduction steps")
-        .option("--resolution <value>", "Set issue resolution summary")
-        .option("--expected-result <value>", "Set issue expected behavior")
-        .option("--expected <value>", "Short alias for --expected-result")
-        .option("--actual-result <value>", "Set issue observed behavior")
-        .option("--actual <value>", "Short alias for --actual-result")
-        .option("--affected-version <value>", "Set affected version identifier")
-        .option("--fixed-version <value>", "Set fixed version identifier")
-        .option("--component <value>", "Set issue component ownership")
-        .option("--regression [value]", "Set regression marker; bare flag means true, or pass true|false|1|0")
-        .option("--customer-impact <value>", "Set customer impact summary")
-        .option("--dep <value>", "Add dependency entry id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>", collect)
-        .option("--dep-remove <value>", "Remove dependency entries by id/kind/author/timestamp signature", collect)
-        .option("--replace-deps", "Atomically replace dependency entries with provided --dep values")
-        .option("--replace-tests", "Atomically replace linked tests with provided --test values")
-        .option("--replace-files", "Atomically replace linked files with provided --file values")
-        .option("--replace-docs", "Atomically replace linked docs with provided --doc values")
-        .option("--comment <value>", "Add comment seed author=<value>,created_at=<iso|now>,text=<value>", collect)
-        .option("--note <value>", "Add note seed author=<value>,created_at=<iso|now>,text=<value>", collect)
-        .option("--learning <value>", "Add learning seed author=<value>,created_at=<iso|now>,text=<value>", collect)
-        .option("--file <value>", "Add linked file path=<value>,scope=<project|global>,note=<text>", collect)
-        .option("--test <value>", "Add linked test command=<value>,path=<value>,scope=<project|global>", collect)
-        .option("--doc <value>", "Add linked doc path=<value>,scope=<project|global>,note=<text>", collect)
-        .option("--reminder <value>", "Add reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>", collect)
-        .option("--event <value>", "Add event entry start=<iso|relative>,end=<iso|relative>,recur_*", collect)
-        .option("--type-option <value>", "Set type options key=value (repeatable)", collect)
-        .option("--unset <field>", "Clear scalar metadata field by name (repeatable)", collect)
-        .option("--clear-deps", "Clear dependency entries")
-        .option("--clear-comments", "Clear comments")
-        .option("--clear-notes", "Clear notes")
-        .option("--clear-learnings", "Clear learnings")
-        .option("--clear-files", "Clear linked files")
-        .option("--clear-tests", "Clear linked tests")
-        .option("--clear-docs", "Clear linked docs")
-        .option("--clear-reminders", "Clear reminders")
-        .option("--clear-events", "Clear events")
-        .option("--clear-type-options", "Clear type options")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "Mutation message")
-        .option("--force", "Force ownership override");
-    // Hidden pure snake_case underscore-duplicate aliases (kept parse-functional,
-    // omitted from --help to save agent context).
-    addHiddenOptions(updateManyCommand, [
-        [
-            "--filter-assignee_filter <value>",
-            "Alias for --filter-assignee-filter",
-        ],
-        ["--estimated_minutes <value>", "Alias for --estimated-minutes"],
-        ["--acceptance_criteria <value>", "Alias for --acceptance-criteria"],
-        ["--definition_of_ready <value>", "Alias for --definition-of-ready"],
-        ["--why_now <value>", "Alias for --why-now"],
-        ["--blocked_by <value>", "Alias for --blocked-by"],
-        ["--blocked_reason <value>", "Alias for --blocked-reason"],
-        ["--unblock_note <value>", "Alias for --unblock-note"],
-        ["--repro_steps <value>", "Alias for --repro-steps"],
-        ["--expected_result <value>", "Alias for --expected-result"],
-        ["--actual_result <value>", "Alias for --actual-result"],
-        ["--affected_version <value>", "Alias for --affected-version"],
-        ["--fixed_version <value>", "Alias for --fixed-version"],
-        ["--customer_impact <value>", "Alias for --customer-impact"],
-        ["--filter-estimate-missing", "Alias for --filter-estimates-missing"],
-    ], false);
-    addHiddenOptions(updateManyCommand, [
-        ["--dep_remove <value>", "Alias for --dep-remove"],
-        ["--type_option <value>", "Alias for --type-option"],
-        ["--add_tags <value>", "Alias for --add-tags"],
-        ["--remove_tags <value>", "Alias for --remove-tags"],
-        ["--add_ac <value>", "Alias for --add-ac"],
-        ["--remove_ac <value>", "Alias for --remove-ac"],
-    ], true);
-    updateManyCommand.action(runUpdateManyAction);
-    const closeCommand = program
-        .command("close")
-        .argument("<id>", "Item id")
-        .argument("[text]", "Close reason text (alias: --reason)")
-        .option("-r, --reason <value>", "Close reason text (alias for positional <text>)")
-        .option("--close-reason <value>", "Close reason text (alias for positional <text>)")
-        .option("--completed-at <value>", "Actual completion timestamp (ISO or relative), distinct from tracker close time")
-        .option("-d, --duplicate-of <id>", "Close as a duplicate of the canonical item id and auto-fill duplicate closure metadata")
-        .option("--author <value>", "Mutation author")
-        .option("-m, --message <value>", "History message")
-        .option("--validate-close [mode]", 'Validate closure metadata before close: "off", "warn", or "strict" (default: settings governance preset)')
-        .option("--resolution <value>", "Set the closure resolution summary inline (same field --validate-close strict checks; previously required a prior pm update)")
-        .option("--expected-result <value>", "Set the expected-result note inline (closure validation field)")
-        .option("--expected <value>", "Short alias for --expected-result")
-        .option("--actual-result <value>", "Set the actual-result note inline (closure validation field)")
-        .option("--actual <value>", "Short alias for --actual-result")
-        .option("--force", "Force ownership override")
-        .description("Close an item. Close reason requirement follows governance.require_close_reason.");
-    // pm-fl0c #11 (2026-05-28): expose snake_case aliases alongside the canonical
-    // kebab-case so agents using --expected_result/--actual_result do not get an
-    // Unknown option error; the rendered help stays clean (aliases hidden).
-    addHiddenOption(closeCommand, "--expected_result <value>", "Alias for --expected-result", false);
-    addHiddenOption(closeCommand, "--actual_result <value>", "Alias for --actual-result", false);
-    closeCommand.action(runCloseAction);
-    const closeManyCommand = program
-        .command("close-many")
-        .description("Bulk-close matched items with a shared reason and full runClose semantics (dry-run + rollback checkpoint).")
-        .option("--filter-status <value>", "Filter by status before closing")
-        .option("--filter-type <value>", "Filter by item type before closing")
-        .option("--filter-tag <value>", "Filter by tag before closing")
-        .option("--filter-priority <value>", "Filter by priority before closing")
-        .option("--filter-deadline-before <value>", "Filter by deadline upper bound before closing")
-        .option("--filter-deadline-after <value>", "Filter by deadline lower bound before closing")
-        .option("--filter-updated-after <value>", "Filter by updated_at lower bound before closing (ISO/relative)")
-        .option("--filter-updated-before <value>", "Filter by updated_at upper bound before closing (ISO/relative)")
-        .option("--filter-created-after <value>", "Filter by created_at lower bound before closing (ISO/relative)")
-        .option("--filter-created-before <value>", "Filter by created_at upper bound before closing (ISO/relative)")
-        .option("--filter-assignee <value>", "Filter by assignee before closing")
-        .option("--filter-assignee-filter <value>", "Filter assignee presence: assigned|unassigned before closing")
-        .option("--filter-parent <value>", "Filter by parent item ID before closing")
-        .option("--filter-sprint <value>", "Filter by sprint before closing")
-        .option("--filter-release <value>", "Filter by release before closing");
-    registerBulkContentAndGovernanceFilters(closeManyCommand, "closing");
-    closeManyCommand
-        .option("--ids <value>", "Explicit ID allowlist: comma/newline text, - stdin, or @path file")
-        .option("--limit <n>", "Limit matched item count before apply/preview")
-        .option("--offset <n>", "Skip first n matched rows before apply/preview")
-        .option("--reason <value>", "Shared close reason applied to matched items (required when governance.require_close_reason is enabled)")
-        .option("--completed-at <value>", "Actual completion timestamp (ISO or relative) applied to every matched item")
-        .option("--resolution <value>", "Shared closure resolution applied to every matched item (closure-validation field)")
-        .option("--expected-result <value>", "Shared expected-result note (closure-validation field)")
-        .option("--expected <value>", "Short alias for --expected-result")
-        .option("--actual-result <value>", "Shared actual-result note (closure-validation field)")
-        .option("--actual <value>", "Short alias for --actual-result")
-        .option("--validate-close [mode]", 'Validate closure metadata per item: "off", "warn", or "strict" (default: settings governance preset)')
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "History message")
-        .option("--force", "Re-close already-terminal matches and override ownership")
-        .option("--dry-run", "Preview matched items + per-item skip/active-child plan without mutating")
-        .option("--rollback <value>", "Rollback a prior close-many checkpoint ID")
-        .option("--no-checkpoint", "Disable checkpoint creation during apply mode");
-    addHiddenOption(closeManyCommand, "--filter-assignee_filter <value>", "Alias for --filter-assignee-filter", false);
-    addHiddenOption(closeManyCommand, "--expected_result <value>", "Alias for --expected-result", false);
-    addHiddenOption(closeManyCommand, "--actual_result <value>", "Alias for --actual-result", false);
-    closeManyCommand.action(runCloseManyAction);
-    program
-        .command("delete")
-        .argument("<id>", "Item id")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "History message")
-        .option("--force", "Force ownership override")
-        .option("--dry-run", "Preview the item file that would be deleted without mutating")
-        .description("Delete an item and record the change in history.")
-        .action(runDeleteAction);
-    program
-        .command("append")
-        .argument("<id>", "Item id")
-        .argument("[text]", "Body text; same as --body (- reads stdin)")
-        .option("--body <value>", "Text to append to body (or - for stdin)")
-        .option("--text <value>", "Alias for --body")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "Mutation message")
-        .option("--force", "Force ownership override")
-        .description("Append text to an item's body. For concurrent writes, use pm notes.")
-        .action(runAppendAction);
-    program
-        .command("restore")
-        .argument("<id>", "Item id")
-        .argument("<target>", "Restore target timestamp or version number")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "History message")
-        .option("--force", "Force ownership/lock override")
-        .description("Restore an item to an earlier timestamp or version.")
-        .action(runRestoreAction);
-    const planCommand = program
-        .command("plan")
-        .description("Agent-optimized Plan item workflow: create, manage steps, link dependencies, approve, and materialize.")
-        .argument("[subcommand]", "Required; Plan subcommand: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize")
-        .argument("[id]", "Plan id (required for non-create subcommands); for create this may be the positional title")
-        .argument("[step]", "Step reference: stable id (plan-step-001) or order integer")
-        .argument("[new-order]", "New order integer for reorder-step")
-        .option("--title <value>", "Plan title")
-        .option("--description <value>", "Plan description")
-        .option("--scope <value>", "Short scope statement of the target change or investigation")
-        .option("--parent <value>", "Parent pm item id")
-        .option("--related <value>", "Related pm item ids (repeatable, csv-friendly)", collect)
-        .option("--blocks <value>", "Pm item ids this plan blocks (repeatable, csv-friendly)", collect)
-        .option("--blocked-by <value>", "Pm item ids that block this plan (repeatable, csv-friendly)", collect)
-        .option("--harness <value>", "Plan harness provenance: codex|claude-code|cursor|generic")
-        .option("--mode <value>", "Plan mode: draft|research|review|approved|executing|paused|completed|superseded")
-        .option("--resume-context <value>", "Compact context summary for a future stateless agent")
-        .option("--tags <value>", "Comma-separated tags")
-        .option("--priority <value>", "Priority 0-4")
-        .option("--body <value>", "Plan item body")
-        .option("--claim", "Claim the plan on create for the author")
-        .option("--from-search <value>", "Record the search query that led to plan creation")
-        .option("--template <value>", "Seed plan steps from a built-in template: bug-investigation|feature-implementation|refactoring-sprint")
-        .option("--step-title <value>", "Step title for add-step / update-step")
-        // pm-6mit: --step is a Commander collect repeatable so `pm plan create
-        // --step A --step B` seeds ordered steps (previously a single-value alias
-        // for --step-title where the last value silently won). It must NOT be
-        // list:true in contracts — the bootstrap coalescer would comma-join values
-        // and corrupt titles containing commas.
-        .option("--step <value>", "Step title (repeatable on create: each --step appends an ordered step; elsewhere a single value aliases --step-title)", collect)
-        .option("--step-body <value>", "Step body text")
-        .option("--step-owner <value>", "Step owner")
-        .option("--step-status <value>", "Step status: pending|in_progress|completed|blocked|skipped|superseded")
-        .option("--step-evidence <value>", "Step evidence text (used by update-step/complete-step)")
-        .option("--step-blocked-reason <value>", "Step blocked reason (required when blocking)")
-        .option("--step-replacement <value>", "Replacement reference for a superseded step")
-        .option("--depends-on <value>", "Pm item ids the step depends on (repeatable, csv-friendly)", collect)
-        .option("--link <value>", "Pm item id to link (repeatable, csv-friendly)", collect)
-        .option("--link-kind <value>", `Link kind: ${PLAN_STEP_LINK_KIND_VALUES.join("|")}`)
-        .option("--link-note <value>", "Optional note for the link")
-        .option("--promote-to-item-dep", "Also add the linked id as a top-level item dependency when linking")
-        .option("--allow-multiple-active", "Allow multiple steps to be in_progress at once")
-        .option("--file <value>", "Step linked file path=<value>[,scope=project|global,note=<text>] (repeatable)", collect)
-        .option("--test <value>", "Step linked test command=<value>[,path=<value>,note=<text>] (repeatable)", collect)
-        .option("--doc <value>", "Step linked doc path=<value>[,scope=project|global,note=<text>] (repeatable)", collect)
-        .option("--decision-text <value>", "Decision log entry text")
-        .option("--decision <value>", "Alias for --decision-text")
-        .option("--decision-rationale <value>", "Decision log entry rationale")
-        .option("--decision-evidence <value>", "Decision log entry evidence")
-        .option("--discovery-text <value>", "Discovery log entry text")
-        .option("--discovery <value>", "Alias for --discovery-text")
-        .option("--validation-text <value>", "Validation log entry text")
-        .option("--validation <value>", "Alias for --validation-text")
-        .option("--validation-command <value>", "Validation log entry command")
-        .option("--validation-expected <value>", "Validation log entry expected outcome")
-        .option("--depth <value>", "Show depth: brief|standard|deep (default: brief)")
-        .option("--fields <value>", "Comma-separated field projection for show output")
-        .option("--steps <value>", "Comma-separated step ids/orders for materialize")
-        .option("--materialize-type <value>", "Item type for materialized steps (default: Task)")
-        .option("--materialize-parent <value>", "Parent item id for materialized children (default: the plan)")
-        .option("--materialize-tags <value>", "Comma-separated tags for materialized children")
-        .option("--field <name=value>", "Custom field value forwarded to every materialized child (repeatable)", collect)
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "Mutation message")
-        .option("--force", "Force ownership override");
-    registerCommanderOptionContracts(planCommand, CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS.filter((contract) => PLAN_CREATE_METADATA_OPTION_TARGETS.has(contract.target)));
-    // Hidden pure snake_case underscore-duplicate aliases (kept parse-functional,
-    // omitted from --help to save agent context).
-    addHiddenOptions(planCommand, [
-        ["--resume_context <value>", "Alias for --resume-context"],
-        ["--from_search <value>", "Alias for --from-search"],
-        ["--step_title <value>", "Alias for --step-title"],
-        ["--step_body <value>", "Alias for --step-body"],
-        ["--step_owner <value>", "Alias for --step-owner"],
-        ["--step_status <value>", "Alias for --step-status"],
-        ["--step_evidence <value>", "Alias for --step-evidence"],
-        ["--step_blocked_reason <value>", "Alias for --step-blocked-reason"],
-        ["--step_replacement <value>", "Alias for --step-replacement"],
-        ["--link_kind <value>", "Alias for --link-kind"],
-        ["--link_note <value>", "Alias for --link-note"],
-        ["--promote_to_item_dep", "Alias for --promote-to-item-dep"],
-        ["--allow_multiple_active", "Alias for --allow-multiple-active"],
-        ["--decision_text <value>", "Alias for --decision-text"],
-        ["--decision_rationale <value>", "Alias for --decision-rationale"],
-        ["--decision_evidence <value>", "Alias for --decision-evidence"],
-        ["--discovery_text <value>", "Alias for --discovery-text"],
-        ["--validation_text <value>", "Alias for --validation-text"],
-        ["--validation_command <value>", "Alias for --validation-command"],
-        ["--validation_expected <value>", "Alias for --validation-expected"],
-        ["--materialize_type <value>", "Alias for --materialize-type"],
-        ["--materialize_parent <value>", "Alias for --materialize-parent"],
-        ["--materialize_tags <value>", "Alias for --materialize-tags"],
-    ], false);
-    addHiddenOptions(planCommand, [
-        ["--blocked_by <value>", "Alias for --blocked-by"],
-        ["--depends_on <value>", "Alias for --depends-on"],
-    ], true);
-    planCommand.action(runPlanAction);
-    void planCommand;
-    program
-        .command("history-redact")
-        .argument("<id>", "Item id")
-        .option("--literal <value>", "Literal string to redact (repeatable)", collect)
-        .option("--regex <value>", "Regex pattern to redact (repeatable; accepts /pattern/flags or raw pattern)", collect)
-        .option("--replacement <value>", 'Replacement string (default: "[redacted]")')
-        .option("--dry-run", "Preview redaction impact without writing item/history files")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "Audit history message for the redaction marker entry")
-        .option("--force", "Force ownership/lock override")
-        .description("Redact sensitive literals/patterns from an item history stream and recompute hashes.")
-        .action(async (id, options, command) => {
-        const globalOptions = getGlobalOptions(command);
-        const startedAt = Date.now();
-        const literal = Array.isArray(options.literal)
-            ? options.literal
-            : undefined;
-        const regex = Array.isArray(options.regex)
-            ? options.regex
-            : undefined;
-        const result = await runHistoryRedact(id, {
-            literal,
-            regex,
-            replacement: typeof options.replacement === "string"
-                ? options.replacement
-                : undefined,
-            dryRun: options.dryRun === true,
-            author: typeof options.author === "string" ? options.author : undefined,
-            message: typeof options.message === "string" ? options.message : undefined,
-            force: Boolean(options.force),
-        }, globalOptions);
-        if (result.changed && !result.dry_run) {
-            await invalidateSearchCachesForMutation(globalOptions, result);
-        }
-        printResult(result, globalOptions);
-        if (globalOptions.profile) {
-            printError(`profile:command=history-redact took_ms=${Date.now() - startedAt}`);
-        }
-    });
-    program
-        .command("history-repair")
-        .argument("[id]", "Item id (omit with --all)")
-        .option("--salvage-tail", "Recover invalid tail; requires verified prefix")
-        .option("--all", "Scan every stream for drift and repair each drifted stream in one audited pass")
-        .option("--dry-run", "Preview the re-anchor impact without writing the history file")
-        .option("--normalize-provenance", "Remove invalid provenance; return aggregate-only evidence")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "Audit history message for the repair marker entry")
-        .option("--force", "Force ownership/lock override")
-        .description("Re-anchor a drifted item history chain (recompute hashes, reconcile with the on-disk item) and record an audit marker. Use --all to repair every drifted stream.")
-        .action(async (id, options, command) => {
-        const globalOptions = getGlobalOptions(command);
-        const startedAt = Date.now();
-        const all = options.all === true;
-        assertHistoryRepairTarget(id, all);
-        const repairOptions = {
-            dryRun: options.dryRun === true,
-            author: typeof options.author === "string" ? options.author : undefined,
-            message: typeof options.message === "string" ? options.message : undefined,
-            force: Boolean(options.force),
-            normalizeProvenance: options.normalizeProvenance === true,
-            salvageTail: options.salvageTail === true,
-        };
-        // history-repair only re-anchors the audit stream; item content is untouched,
-        // so search caches do not need invalidation.
-        if (all) {
-            const result = await runHistoryRepairAll(repairOptions, globalOptions);
-            printResult(result, globalOptions);
-            if (result.totals.failed > 0) {
-                // Per-stream failures are collected (one bad stream never aborts the
-                // pass) but must still fail the command for gating callers.
-                process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-            }
-        }
-        else {
-            const result = await runHistoryRepair(id, repairOptions, globalOptions);
-            printResult(result, globalOptions);
-        }
-        if (globalOptions.profile) {
-            printError(`profile:command=history-repair took_ms=${Date.now() - startedAt}`);
-        }
-    });
-    registerHistoryAuthorAcknowledgeCommand(program);
-    program
-        .command("history-compact")
-        .argument("[id]", "Item id (omit when using a bulk selector)")
-        .option("--before <value>", "Compact entries strictly before this version number or ISO timestamp (single-id mode only)")
-        .option("--ids <value>", "Bulk IDs: comma/newline text, - stdin, or @path file")
-        .option("--all-over <n>", "Bulk: compact every stream with more than N entries")
-        .option("--closed", "Bulk: compact only closed (terminal) items' streams")
-        .option("--all-streams", "Bulk: compact every history stream regardless of lifecycle state")
-        .option("--min-entries <n>", "Bulk: skip streams with at most N entries (already compact; default 3)")
-        .option("--dry-run", "Preview compaction impact without writing the history file")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "Audit history message for the compaction marker entry")
-        .option("--force", "Force ownership/lock override")
-        .description("Compact item history streams into a synthetic baseline plus retained tail entries. Pass an item id for one stream, or a bulk selector (--ids/--all-over/--closed/--all-streams) to compact many.")
-        .action(runHistoryCompactAction);
-    program
-        .command("merge")
-        .argument("<subcommand>", `Merge subcommand: ${MERGE_SUBCOMMAND_VALUES.join(", ")}`)
-        .argument("[artifact]", `driver only: artifact class to merge (${MERGE_DRIVER_ARTIFACT_VALUES.join(", ")})`)
-        .argument("[base]", "driver only: common-ancestor file path (git %O)")
-        .argument("[ours]", "driver only: current-branch file path (git %A)")
-        .argument("[theirs]", "driver only: other-branch file path (git %B)")
-        .option("--dry-run", "install/reconcile: preview changes without writing")
-        .option("--message <text>", "reconcile only: audit message recorded on repaired history streams")
-        .option("--force", "reconcile only: permit the underlying audited history ownership override")
-        .option("--include-reconciled", "report only: include clone-local receipts already recorded in history")
-        .option("--output <path>", "driver only: write the merged content to this path instead of the ours path")
-        .option("--item-path <path>", "driver only: original repository-relative path supplied by git as %P")
-        .option("--prefer <side>", "driver only: side that wins unresolvable conflicts (ours|theirs; default ours)")
-        .description("Install merge drivers, reconcile or report post-merge history, or run a field-aware driver.")
-        .action(runMergeAction);
-    const schemaCommand = program
-        .command("schema")
-        .argument("[subcommand]", "Required; Schema subcommand: list, show, show-status, add/remove type/status/field, rename-type, rename-field, remap-status, or a custom item type name shorthand")
-        .argument("[name]", "Definition name, or source name for rename/remap migrations")
-        .option("--description <text>", "Human description for the custom item type, status, or field")
-        .option("--default-status <status>", "Default status hint recorded for the custom item type")
-        .option("--folder <dir>", "Storage folder for items of this custom type")
-        .option("--alias <name>", "Alias for the custom type, status, or field flag (repeatable, csv-friendly)", collect)
-        .option("--role <value>", "Lifecycle role for a custom status (repeatable): draft, active, blocked, terminal, terminal_done, terminal_canceled, default_open, default_close, default_cancel", collect)
-        .option("--order <n>", "Display/sort order for a custom status")
-        .option("--type <type>", "Value type for a custom field (add-field): string, number, boolean, string_array, array, object")
-        .option("--commands <list>", "Commands a custom field is wired onto (add-field; repeatable, comma-friendly): create, update, update_many, list, search, calendar, context", collect)
-        .option("--cli-flag <flag>", "Override the auto-derived CLI flag for a custom field (add-field)")
-        .option("--required", "Mark a custom field as always required (add-field)")
-        .option("--required-on-create", "Mark a custom field as required at create time (add-field)")
-        .option("--no-allow-unset", "Disallow clearing a custom field via --unset (add-field)")
-        .option("--required-types <list>", "Restrict a custom field's requirement to specific item types (add-field; repeatable, comma-friendly)", collect)
-        .option("--infer", "Infer custom item types from title-prefix conventions (add-type; preview unless --apply)")
-        .option("--min-count <n>", "Minimum items sharing a prefix for add-type --infer (default 10)")
-        .option("--apply", "Register inferred types (add-type --infer); without it the command previews only")
-        .option("--to <name>", "Target definition name for rename/remap migrations")
-        .option("--migration-id <id>", "Stable idempotency key for a resumable schema migration")
-        .option("--dry-run", "Plan a schema migration without writing schema, items, or history")
-        .option("--author <value>", "Mutation author")
-        .option("--force", "Force ownership/lock override")
-        .description("Inspect and manage config-driven runtime schema (types, statuses, fields, presets).");
-    // Hidden pure snake_case underscore-duplicate alias.
-    addHiddenOption(schemaCommand, "--default_status <status>", "Alias for --default-status", false);
-    addHiddenOption(schemaCommand, "--migration_id <id>", "Alias for --migration-id", false);
-    schemaCommand.action(runSchemaAction);
-    const profileCommand = program
-        .command("profile")
-        .argument("[subcommand]", "Required; Profile subcommand: list, show, apply, or lint")
-        .argument("[name]", "Profile name for show/apply/lint: agile, ops, or research")
-        .option("--dry-run", "Preview the apply diff without writing any files (apply)")
-        .option("--author <value>", "Mutation author")
-        .option("--force", "Force ownership/lock override")
-        .description("List, show, apply, and lint project profiles — archetype bundles of item types, statuses, fields, workflows, config, templates, and recommended packages.");
-    profileCommand.action(runProfileAction);
-    registerAnnotationCommands(program, parsePositiveIntOption);
-    const filesCommand = program
-        .command("files")
-        .description("Manage files linked to an item.");
-    filesCommand
-        .argument("<id>", "Item id")
-        .option("--add <value>", "Add linked file entry (CSV/markdown pairs or - for stdin)", collect)
-        .option("--add-glob <value>", "Add linked file entries from a glob (plain glob or pattern=<glob>,scope=<scope>,note=<text>; repeatable)", collect)
-        .option("--remove <value>", "Remove linked file by path only (path=<value>, path:<value>, plain path, or - for stdin); does not accept note=/scope= — record removal context with --message", collect)
-        .option("--migrate <value>", "Migrate linked file paths in-place (from=<prefix>,to=<prefix>; repeatable)", collect)
-        .option("--note <value>", "Note attached to every link added by --add/--add-glob in this invocation (embedded note= wins)")
-        .option("--list", "List linked files without mutating")
-        .option("--append-stable", "Preserve existing linked-file order and append new links without full-array resorting")
-        .option("--validate-paths", "Validate linked file paths for existence and file shape")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "History message")
-        .option("--force", "Force ownership override")
-        .action(runFilesAction);
-    filesCommand
-        .command("discover")
-        .argument("<id>", "Item id")
-        .option("--apply", "Add discovered missing files to the item")
-        .option("--note <value>", "Note to attach to discovered file links")
-        .option("--append-stable", "Preserve existing linked-file order and append discovered links without full-array resorting")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "History message")
-        .option("--force", "Force ownership override")
-        .description("Discover existing file paths referenced in item text and optionally link missing files.")
-        .action(runFilesDiscoverAction);
-    registerFilesLookupCommand(filesCommand);
-    program
-        .command("docs")
-        .argument("<id>", "Item id")
-        .option("--add <value>", "Add linked doc entry (CSV/markdown pairs or - for stdin)", collect)
-        .option("--add-glob <value>", "Add linked doc entries from a glob (plain glob or pattern=<glob>,scope=<scope>,note=<text>; repeatable)", collect)
-        .option("--remove <value>", "Remove linked doc by path only (path=<value>, path:<value>, plain path, or - for stdin); does not accept note=/scope= — record removal context with --message", collect)
-        .option("--migrate <value>", "Migrate linked doc paths in-place (from=<prefix>,to=<prefix>; repeatable)", collect)
-        .option("--note <value>", "Note attached to every link added by --add/--add-glob in this invocation (embedded note= wins)")
-        .option("--list", "List linked docs without mutating")
-        .option("--validate-paths", "Validate linked doc paths for existence and file shape")
-        .option("--author <value>", "Mutation author")
-        .option("--message <value>", "History message")
-        .option("--force", "Force ownership override")
-        .description("Manage docs linked to an item.")
-        .action(runDocsAction);
-    program
-        .command("deps")
-        .argument("<id>", "Item id")
-        .option("--format <value>", "Output format (tree, graph, or context)", "tree")
-        .option("--max-depth <value>", "Maximum dependency traversal depth (0 keeps only the root)")
-        .option("--collapse <value>", "Collapse mode (none or repeated)", "none")
-        .option("--summary", "Return counts only without full tree/graph payload")
-        .option("--full", "Return the complete dependency row projection")
-        .option("--node-limit <value>", "Maximum nodes in context output")
-        .option("--edge-limit <value>", "Maximum edges and missing-reference rows in context output")
-        .option("--token-budget <value>", "Maximum estimated tokens in context output")
-        .option("--cursor <value>", "Continue an equivalent context query")
-        .option("--direction <value>", "Context traversal direction (outgoing, incoming, or both)")
-        .option("--kind <value>", "Restrict context traversal to registered relationship kinds (repeatable or comma-separated)", collect)
-        .description("Show dependency relationships for an item.")
-        .action(runDepsAction);
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="be587fdc-045d-5dfc-8f4c-fb9965034872")}catch(e2){}})();import{resolveBodyFileContent,resolveCliBulkIdsInput,EXIT_CODE,PmCliError,createUnknownSubcommandError}from"../sdk/runtime-primitives.js";import{CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,MERGE_SUBCOMMAND_VALUES,PLAN_CREATE_METADATA_PARAMETER_KEYS,UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS}from"../sdk/cli-contracts.js";import{BUILTIN_ITEM_TYPE_VALUES,PLAN_STEP_LINK_KIND_VALUES}from"../types/index.js";import{MERGE_DRIVER_ARTIFACT_VALUES,runMergeDriver,runMergeInstall,runMergeReconcile,runMergeReceiptEvidenceReport}from"./commands/merge.js";import{runAppend}from"./commands/append.js";import{runClose}from"./commands/close.js";import{runCloseMany}from"./commands/close-many.js";import{runCopy}from"./commands/copy.js";import{runCreate}from"./commands/create.js";import{runDelete}from"./commands/delete.js";import{runDeps}from"./commands/deps.js";import{runDocs}from"./commands/docs.js";import{runFiles,runFilesDiscover}from"./commands/files.js";import{runFocus}from"./commands/focus.js";import*as profileModule from"./commands/profile.js";import*as schemaModule from"./commands/schema.js";import{runUpdate}from"./commands/update.js";import{runUpdateMany}from"./commands/update-many.js";import{createStdinTokenResolver,preserveMutationStdinTokenFields,preserveMutationStdinTokenLiterals}from"../sdk/runtime-primitives.js";import{resolveDescriptionStdin}from"./description-stdin.js";import{itemDocumentToMutationOptions}from"../sdk/structured-mutations.js";import{registerStructuredMutationCommands}from"./register-structured-mutation.js";import{registerHistoryMaintenanceCommands}from"./register-history-maintenance.js";import{registerHistoryAuthorAcknowledgeCommand}from"./register-history-author.js";import{PLAN_SUBCOMMANDS,runPlan}from"./commands/plan.js";import{registerAnnotationCommands}from"./register-annotations.js";import{registerFilesLookupCommand}from"./register-files-lookup.js";import{isPureSnakeCaseAlias,looksLikeSchemaSubcommandTypo,parseSchemaOrderOption}from"./schema-registration-helpers.js";import{looksLikeSchemaSubcommandTypo as looksLikeSchemaSubcommandTypo2,parseSchemaOrderOption as parseSchemaOrderOption2}from"./schema-registration-helpers.js";const BUILTIN_TYPE_NAME_LOOKUP=new Set(BUILTIN_ITEM_TYPE_VALUES.map(value=>value.toLowerCase()));const PLAN_CREATE_METADATA_OPTION_TARGETS=new Set(PLAN_CREATE_METADATA_PARAMETER_KEYS.map(key=>key==="estimate"?"estimatedMinutes":key));import{collect,applyActiveCommandResultService,addHiddenOption,addHiddenOptions,extractUpdateManyMutationOptionSource,formatHookWarnings,getGlobalOptions,invalidateSearchCachesForMutation,normalizeCreateOptions,normalizeUpdateOptions,printError,printResult,readOptionString,writeStdout}from"./registration-helpers.js";function dispatchSchemaMigration(schema,inputs){const kind=inputs.normalizedSubcommand;if(kind!=="rename-type"&&kind!=="rename-field"&&kind!=="remap-status"){return null}return schema.runSchemaEvolutionMigration({kind,from:inputs.typeName,to:readOptionString(inputs.options,"to"),...kind==="rename-field"&&typeof inputs.options.type==="string"?{type:inputs.options.type}:{}},{migrationId:readOptionString(inputs.options,"migrationId")??readOptionString(inputs.options,"migration_id"),dryRun:inputs.options.dryRun===true,author:inputs.author,force:inputs.force},inputs.globalOptions)}function dispatchSchemaReadRemoveOrPreset(schema,inputs){const{normalizedSubcommand,typeName,globalOptions,author,force}=inputs;switch(normalizedSubcommand){case"list":return schema.runSchemaList(globalOptions);case"show":return schema.runSchemaShow(typeName,globalOptions);case"show-status":return schema.runSchemaShowStatus(typeName,globalOptions);case"list-fields":return schema.runSchemaListFields(globalOptions);case"show-field":return schema.runSchemaShowField(typeName,globalOptions);case"remove-type":return schema.runSchemaRemoveType(typeName,{author,force},globalOptions);case"remove-field":return schema.runSchemaRemoveField(typeName,{author,force},globalOptions);case"remove-status":return schema.runSchemaRemoveStatus(typeName,{author,force},globalOptions);case"apply-preset":return schema.runSchemaApplyPreset(typeName,{author,force},globalOptions);default:return null}}async function dispatchSchemaSubcommand(schema,inputs){const{normalizedSubcommand,typeName,options,globalOptions}=inputs;const{author,force,description}=inputs;const migration=dispatchSchemaMigration(schema,inputs);if(migration)return migration;const readRemoveOrPreset=dispatchSchemaReadRemoveOrPreset(schema,inputs);if(readRemoveOrPreset)return readRemoveOrPreset;switch(normalizedSubcommand){case"add-field":return schema.runSchemaAddField(typeName,{type:typeof options.type==="string"?options.type:void 0,commands:inputs.commands,description,cliFlag:typeof options.cliFlag==="string"?options.cliFlag:void 0,alias:inputs.aliases,required:Boolean(options.required),requiredOnCreate:Boolean(options.requiredOnCreate),allowUnset:options.allowUnset!==false,requiredTypes:inputs.requiredTypes,author,force},globalOptions);case"add-status":return schema.runSchemaAddStatus(typeName,{role:inputs.roles,alias:inputs.aliases,description,order:inputs.order,author,force},globalOptions);default:if(options.infer===true){return schema.runSchemaInferTypes({minCount:inputs.minCount,apply:Boolean(options.apply),author,force},globalOptions)}return schema.runSchemaAddType(typeName,{description,defaultStatus:inputs.defaultStatus,folder:typeof options.folder==="string"?options.folder:void 0,alias:inputs.aliases,author,force},globalOptions)}}function renderSchemaResultHuman(schema,result){if("migration_id"in result){writeStdout(`${schema.formatSchemaEvolutionMigrationHuman(result)}
+`);return}switch(result.action){case"list":writeStdout(`${schema.formatSchemaListHuman(result)}
+`);return;case"show":writeStdout(`${schema.formatSchemaShowHuman(result)}
+`);return;case"show-status":writeStdout(`${schema.formatSchemaShowStatusHuman(result)}
+`);return;case"list-fields":writeStdout(`${schema.formatSchemaListFieldsHuman(result)}
+`);return;case"show-field":writeStdout(`${schema.formatSchemaShowFieldHuman(result)}
+`);return;case"remove-type":writeStdout(`${schema.formatSchemaRemoveTypeHuman(result)}
+`);break;case"remove-field":writeStdout(`${schema.formatSchemaRemoveFieldHuman(result)}
+`);break;case"apply-preset":writeStdout(`${schema.formatSchemaApplyPresetHuman(result)}
+`);break;case"infer-types":writeStdout(`${schema.formatSchemaInferTypesHuman(result)}
+`);break;case"add-field":writeStdout(`${schema.formatSchemaAddFieldHuman(result)}
+`);break;case"add-status":writeStdout(`${schema.formatSchemaAddStatusHuman(result)}
+`);break;case"remove-status":writeStdout(`${schema.formatSchemaRemoveStatusHuman(result)}
+`);break;default:writeStdout(`${schema.formatSchemaAddTypeHuman(result)}
+`);break}if(result.warnings.length>0){printError(`schema ${result.action} warnings: ${formatHookWarnings(result.warnings)}`)}}async function dispatchProfileSubcommand(profile,subcommand,name,options,globalOptions){switch(subcommand){case"list":return profile.runProfileList();case"show":return profile.runProfileShow(name);case"lint":return profile.runProfileLint(name);default:return profile.runProfileApply(name,{dryRun:options.dryRun===true,author:typeof options.author==="string"?options.author:void 0,force:options.force===true},globalOptions)}}function renderProfileResultHuman(profile,result){switch(result.action){case"list":writeStdout(`${profile.formatProfileListHuman(result)}
+`);return;case"show":writeStdout(`${profile.formatProfileShowHuman(result)}
+`);return;case"lint":writeStdout(`${profile.formatProfileLintHuman(result)}
+`);return;default:writeStdout(`${profile.formatProfileApplyHuman(result)}
+`);if(result.warnings.length>0){printError(`profile apply warnings: ${formatHookWarnings(result.warnings)}`)}break}}function parsePositiveIntOption(flag){return value=>{const parsed=Number(value);if(!Number.isInteger(parsed)||parsed<1){throw new PmCliError(`${flag} must be a positive integer (1-based index).`,EXIT_CODE.USAGE)}return parsed}}function registerBulkContentAndGovernanceFilters(command,action){command.option("--filter-has-notes",`Select only items that have notes before ${action}`).option("--filter-no-notes",`Select only items that have no notes before ${action}`).option("--filter-has-learnings",`Select only items that have learnings before ${action}`).option("--filter-no-learnings",`Select only items that have no learnings before ${action}`).option("--filter-has-files",`Select only items that have linked files before ${action}`).option("--filter-no-files",`Select only items that have no linked files before ${action}`).option("--filter-has-docs",`Select only items that have linked docs before ${action}`).option("--filter-no-docs",`Select only items that have no linked docs before ${action}`).option("--filter-has-tests",`Select only items that have linked tests before ${action}`).option("--filter-no-tests",`Select only items that have no linked tests before ${action}`).option("--filter-has-comments",`Select only items that have comments before ${action}`).option("--filter-no-comments",`Select only items that have no comments before ${action}`).option("--filter-has-deps",`Select only items that have dependencies before ${action}`).option("--filter-no-deps",`Select only items that have no dependencies before ${action}`).option("--filter-has-body",`Select only items that have a non-empty body before ${action}`).option("--filter-empty-body",`Select only items with an empty body before ${action}`).option("--filter-has-linked-command",`Select only items whose linked tests carry a runnable command before ${action}`).option("--filter-no-linked-command",`Select only items whose linked tests carry no runnable command before ${action}`).option("--filter-reviewer-missing",`Select only items missing reviewer before ${action}`).option("--filter-risk-missing",`Select only items missing risk before ${action}`).option("--filter-confidence-missing",`Select only items missing confidence before ${action}`).option("--filter-sprint-missing",`Select only items missing sprint before ${action}`).option("--filter-release-missing",`Select only items missing release before ${action}`)}const BULK_CONTENT_FILTER_CONFLICTS=[["filterHasNotes","filterNoNotes","--filter-has-notes","--filter-no-notes"],["filterHasLearnings","filterNoLearnings","--filter-has-learnings","--filter-no-learnings"],["filterHasFiles","filterNoFiles","--filter-has-files","--filter-no-files"],["filterHasDocs","filterNoDocs","--filter-has-docs","--filter-no-docs"],["filterHasTests","filterNoTests","--filter-has-tests","--filter-no-tests"],["filterHasComments","filterNoComments","--filter-has-comments","--filter-no-comments"],["filterHasDeps","filterNoDeps","--filter-has-deps","--filter-no-deps"],["filterHasBody","filterEmptyBody","--filter-has-body","--filter-empty-body"],["filterHasLinkedCommand","filterNoLinkedCommand","--filter-has-linked-command","--filter-no-linked-command"]];function mapBulkContentAndGovernanceFilters(options){const presence=key=>options[key]===true?true:void 0;for(const[hasKey,noKey,hasFlag,noFlag]of BULK_CONTENT_FILTER_CONFLICTS){if(options[hasKey]===true&&options[noKey]===true){throw new PmCliError(`Cannot combine ${hasFlag} with ${noFlag} for the same field.`,EXIT_CODE.USAGE)}}return{filterReviewerMissing:presence("filterReviewerMissing"),filterRiskMissing:presence("filterRiskMissing"),filterConfidenceMissing:presence("filterConfidenceMissing"),filterSprintMissing:presence("filterSprintMissing"),filterReleaseMissing:presence("filterReleaseMissing"),hasNotes:presence("filterHasNotes"),hasLearnings:presence("filterHasLearnings"),hasFiles:presence("filterHasFiles"),hasDocs:presence("filterHasDocs"),hasTests:presence("filterHasTests"),hasComments:presence("filterHasComments"),hasDeps:presence("filterHasDeps"),hasBody:presence("filterHasBody"),hasLinkedCommand:presence("filterHasLinkedCommand"),noNotes:presence("filterNoNotes"),noLearnings:presence("filterNoLearnings"),noFiles:presence("filterNoFiles"),noDocs:presence("filterNoDocs"),noTests:presence("filterNoTests"),noComments:presence("filterNoComments"),noDeps:presence("filterNoDeps"),emptyBody:presence("filterEmptyBody"),noLinkedCommand:presence("filterNoLinkedCommand")}}function registerCommanderOptionContracts(command,contracts){for(const contract of contracts){const sharedValues=[];let activeParseArgs=command.args;const repeatableParser=value=>{if(command.args!==activeParseArgs){sharedValues.length=0;activeParseArgs=command.args}sharedValues.push(value);return sharedValues};if(contract.required){command.requiredOption(contract.option,contract.description)}else if(contract.repeatable){command.option(contract.option,contract.description,repeatableParser)}else{command.option(contract.option,contract.description)}for(const aliasContract of contract.aliasOptions??[]){if(isPureSnakeCaseAlias(contract.option,aliasContract.option)){addHiddenOption(command,aliasContract.option,aliasContract.description,contract.repeatable===true,contract.repeatable?repeatableParser:void 0)}else if(contract.repeatable){command.option(aliasContract.option,aliasContract.description,repeatableParser)}else{command.option(aliasContract.option,aliasContract.description)}}}}function buildUpdateManyListOptions(options){const readString=key=>typeof options[key]==="string"?options[key]:void 0;return{type:readString("filterType"),tag:readString("filterTag"),priority:readString("filterPriority"),deadlineBefore:readString("filterDeadlineBefore"),deadlineAfter:readString("filterDeadlineAfter"),updatedAfter:readString("filterUpdatedAfter"),updatedBefore:readString("filterUpdatedBefore"),createdAfter:readString("filterCreatedAfter"),createdBefore:readString("filterCreatedBefore"),ids:readString("ids"),assignee:readString("filterAssignee"),assigneeFilter:readString("filterAssigneeFilter")??readString("filterAssignee_filter"),parent:readString("filterParent"),sprint:readString("filterSprint"),release:readString("filterRelease"),filterAcMissing:options.filterAcMissing===true?true:void 0,filterEstimatesMissing:options.filterEstimatesMissing===true||options.filterEstimateMissing===true?true:void 0,filterResolutionMissing:options.filterResolutionMissing===true?true:void 0,filterMetadataMissing:options.filterMetadataMissing===true?true:void 0,...mapBulkContentAndGovernanceFilters(options),limit:readString("limit"),offset:readString("offset"),includeBody:true}}function pickStringOption(...candidates){for(const candidate of candidates){if(typeof candidate==="string"){return candidate}}return void 0}function stringArrayOption(value){if(Array.isArray(value)){return value}if(typeof value==="string"){return[value]}return void 0}function resolveCreatePositionals(typeOrTitle,secondTitle,options){if(typeof secondTitle==="string"&&secondTitle.length>0){return{positionalType:typeOrTitle,positionalTitle:secondTitle}}if(typeof typeOrTitle!=="string"||typeOrTitle.length===0){return{positionalType:void 0,positionalTitle:void 0}}const explicitTitleProvided=typeof options.title==="string"&&options.title.trim().length>0;return explicitTitleProvided&&options.type===void 0?{positionalType:typeOrTitle,positionalTitle:void 0}:{positionalType:void 0,positionalTitle:typeOrTitle}}function assertCreatePositionalTypeHasTitle(positionalType,positionalTitle,options){if(positionalType!==void 0||typeof positionalTitle!=="string"||positionalTitle.length===0||options.title!==void 0||options.type!==void 0||!BUILTIN_TYPE_NAME_LOOKUP.has(positionalTitle.trim().toLowerCase())){return}const matchedType=positionalTitle.trim();throw new PmCliError(`pm create needs a title \u2014 "${matchedType}" looks like an item type, not a title. Use either: pm create ${matchedType} "<title>" or pm create "<title>" --type ${matchedType}.`,EXIT_CODE.USAGE,{code:"create_positional_type_without_title",why:'Without this guard the single positional is used as the title and the type defaults to Task \u2014 so the command would silently create a Task literally titled "'+matchedType+'".',examples:[`pm create ${matchedType} "Wire up SSO for the agent harness"`,`pm create "Wire up SSO for the agent harness" --type ${matchedType}`],nextSteps:[`Re-run with both type and title: pm create ${matchedType} "<title>"`]})}const STRUCTURED_STDIN_CONFLICT_KEYS=["body","bodyFile","description","dep","depRemove","comment","note","learning","file","test","doc","reminder","event","typeOption","field","ids"];function assertSingleMutationStdinConsumer(options){const stdinFlags=STRUCTURED_STDIN_CONFLICT_KEYS.flatMap(key=>{const value=options[key];const count=typeof value==="string"&&value.trim()==="-"?1:Array.isArray(value)?value.filter(entry=>typeof entry==="string"&&entry.trim()==="-").length:0;const flag=`--${key.replace(/[A-Z]/g,letter=>`-${letter.toLowerCase()}`)}`;return Array.from({length:count},()=>flag)});if(options.stdinJson===true){stdinFlags.unshift("--stdin-json")}if(stdinFlags.length>1){throw new PmCliError(`Only one option may consume stdin per command invocation. Found: ${stdinFlags.join(", ")}.`,EXIT_CODE.USAGE)}}function preserveResolvedMutationStdinFields(options,bodyFileResolved,descriptionStdinResolved){const fields=[];if(bodyFileResolved)fields.push("body");if(descriptionStdinResolved)fields.push("description");preserveMutationStdinTokenFields(options,fields)}function isDescriptionStdinConsumer(options,stdinJsonConsumed){return!stdinJsonConsumed&&typeof options.description==="string"&&options.description.trim()==="-"}async function runCreateAction(typeOrTitle,secondTitle,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertSingleMutationStdinConsumer(options);const stdinJsonConsumed=options.stdinJson===true;if(stdinJsonConsumed){const input=await createStdinTokenResolver().resolveValue("-","--stdin-json");options=itemDocumentToMutationOptions(input??"","create",options)}const positionals=resolveCreatePositionals(typeOrTitle,secondTitle,options);assertCreatePositionalTypeHasTitle(positionals.positionalType,positionals.positionalTitle,options);if(typeof positionals.positionalType==="string"&&positionals.positionalType.length>0&&options.type===void 0){options.type=positionals.positionalType}if(typeof positionals.positionalTitle==="string"&&positionals.positionalTitle.length>0&&options.title===void 0)options.title=positionals.positionalTitle;const descriptionStdinResolved=isDescriptionStdinConsumer(options,stdinJsonConsumed);if(!stdinJsonConsumed){await resolveDescriptionStdin(options)}const bodyFileResolved=typeof options.bodyFile==="string";if(bodyFileResolved){options.body=await resolveBodyFileContent(String(options.bodyFile),options.body!==void 0?String(options.body):void 0);delete options.bodyFile}const normalized=normalizeCreateOptions(options,{requireType:false});preserveResolvedMutationStdinFields(normalized,bodyFileResolved,descriptionStdinResolved);if(stdinJsonConsumed)preserveMutationStdinTokenLiterals(normalized);const result=await runCreate(normalized,globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=create took_ms=${Date.now()-startedAt}`)}}function buildCloseManyListOptions(options){return{type:readOptionString(options,"filterType"),tag:readOptionString(options,"filterTag"),priority:readOptionString(options,"filterPriority"),deadlineBefore:readOptionString(options,"filterDeadlineBefore"),deadlineAfter:readOptionString(options,"filterDeadlineAfter"),updatedAfter:readOptionString(options,"filterUpdatedAfter"),updatedBefore:readOptionString(options,"filterUpdatedBefore"),createdAfter:readOptionString(options,"filterCreatedAfter"),createdBefore:readOptionString(options,"filterCreatedBefore"),ids:readOptionString(options,"ids"),assignee:readOptionString(options,"filterAssignee"),assigneeFilter:pickStringOption(options.filterAssigneeFilter,options.filterAssignee_filter),parent:readOptionString(options,"filterParent"),sprint:readOptionString(options,"filterSprint"),release:readOptionString(options,"filterRelease"),...mapBulkContentAndGovernanceFilters(options),limit:readOptionString(options,"limit"),offset:readOptionString(options,"offset")}}async function runCloseManyAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertSingleMutationStdinConsumer(options);options.ids=await resolveCliBulkIdsInput(readOptionString(options,"ids"));const result=await runCloseMany({status:readOptionString(options,"filterStatus"),list:buildCloseManyListOptions(options),reason:readOptionString(options,"reason"),completedAt:readOptionString(options,"completedAt"),resolution:readOptionString(options,"resolution"),expectedResult:pickStringOption(options.expectedResult,options.expected_result,options.expected),actualResult:pickStringOption(options.actualResult,options.actual_result,options.actual),validateClose:options.validateClose===true?"warn":readOptionString(options,"validateClose"),author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:Boolean(options.force),dryRun:options.dryRun===true?true:void 0,rollback:readOptionString(options,"rollback"),checkpoint:options.checkpoint===false?false:void 0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=close-many took_ms=${Date.now()-startedAt}`)}}async function runUpdateManyAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertSingleMutationStdinConsumer(options);options.ids=await resolveCliBulkIdsInput(readOptionString(options,"ids"));const result=await runUpdateMany({status:readOptionString(options,"filterStatus"),list:buildUpdateManyListOptions(options),update:normalizeUpdateOptions(extractUpdateManyMutationOptionSource(options)),dryRun:options.dryRun===true?true:void 0,rollback:readOptionString(options,"rollback"),checkpoint:options.checkpoint===false?false:void 0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(await applyActiveCommandResultService("update-many",[],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=update-many took_ms=${Date.now()-startedAt}`)}}async function runCloseAction(id,text,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const reasonFromOption=typeof options.reason==="string"&&options.reason.trim().length>0&&options.reason||typeof options.closeReason==="string"&&options.closeReason.trim().length>0&&options.closeReason||void 0;const resolvedText=typeof text==="string"&&text.length>0?text:reasonFromOption;const result=await runClose(id,resolvedText,{author:readOptionString(options,"author"),message:readOptionString(options,"message"),validateClose:options.validateClose===true?"warn":readOptionString(options,"validateClose"),force:Boolean(options.force),duplicateOf:readOptionString(options,"duplicateOf"),completedAt:readOptionString(options,"completedAt"),resolution:readOptionString(options,"resolution"),expectedResult:pickStringOption(options.expectedResult,options.expected_result,options.expected),actualResult:pickStringOption(options.actualResult,options.actual_result,options.actual)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=close took_ms=${Date.now()-startedAt}`)}}function normalizePlanAliases(options){const planOptions={...options};const aliasPairs=[["blocked_by","blockedBy"],["resume_context","resumeContext"],["from_search","fromSearch"],["step_title","stepTitle"],["step_body","stepBody"],["step_owner","stepOwner"],["step_status","stepStatus"],["step_evidence","stepEvidence"],["step_blocked_reason","stepBlockedReason"],["step_replacement","stepReplacement"],["depends_on","dependsOn"],["link_kind","linkKind"],["link_note","linkNote"],["promote_to_item_dep","promoteToItemDep"],["allow_multiple_active","allowMultipleActive"],["decision_text","decisionText"],["decision_rationale","decisionRationale"],["decision_evidence","decisionEvidence"],["discovery_text","discoveryText"],["validation_text","validationText"],["validation_command","validationCommand"],["validation_expected","validationExpected"],["materialize_type","materializeType"],["materialize_parent","materializeParent"],["materialize_tags","materializeTags"]];for(const[snake,camel]of aliasPairs){if(planOptions[snake]!==void 0&&planOptions[camel]===void 0){planOptions[camel]=planOptions[snake]}}const normalized=normalizeCreateOptions(planOptions,{requireType:false});normalized.blockedBy=planOptions.blockedBy;return normalized}function assertKnownPlanSubcommand(normalized,allowed){if(!normalized){throw new PmCliError(`pm plan requires a subcommand. Allowed: ${allowed.join(", ")}`,EXIT_CODE.USAGE,{code:"missing_required_argument",examples:['pm plan create --title "Refactor lock retry"',"pm plan show pm-a1b2 --depth standard",'pm plan add-step pm-a1b2 --step-title "Read lock.ts"']})}if(allowed.includes(normalized)){return}const examples=normalized==="list"||normalized==="ls"?["pm list --type Plan","pm list-all --type Plan"]:void 0;throw createUnknownSubcommandError({command_path:"plan",token:normalized,allowed,examples,retry_command:normalized==="list"||normalized==="ls"?"pm list --type Plan":void 0})}function parsePlanReorderTo(normalizedSubcommand,reorderToken){if(normalizedSubcommand!=="reorder-step"||typeof reorderToken!=="string"){return void 0}const parsed=Number.parseInt(reorderToken,10);if(!Number.isFinite(parsed)){throw new PmCliError(`reorder-step requires an integer new order, got "${reorderToken}"`,EXIT_CODE.USAGE)}return parsed}async function runPlanAction(subcommand,id,stepRef,reorderToken,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const normalizedSubcommand=(subcommand??"").trim().toLowerCase();assertKnownPlanSubcommand(normalizedSubcommand,PLAN_SUBCOMMANDS);const planOptions=normalizePlanAliases(options);const reorderTo=parsePlanReorderTo(normalizedSubcommand,reorderToken);const planId=normalizedSubcommand==="create"&&typeof id==="string"&&id.length>0&&planOptions.title===void 0?void 0:id;if(planId===void 0&&typeof id==="string"&&id.length>0){planOptions.title=id}const result=await runPlan({subcommand:normalizedSubcommand,id:planId,stepRef,reorderTo,options:planOptions,global:globalOptions});await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=plan took_ms=${Date.now()-startedAt}`)}}async function runMergeReconcileSubcommand(artifact,options,globalOptions){if(artifact!==void 0){throw new PmCliError("merge reconcile takes no positional arguments.",EXIT_CODE.USAGE)}const result=await runMergeReconcile({dryRun:options.dryRun===true,force:options.force===true,message:typeof options.message==="string"?options.message:void 0,author:globalOptions.author},globalOptions);printResult(result,globalOptions);if(!result.ok)process.exitCode=EXIT_CODE.GENERIC_FAILURE}async function runMergeDriverSubcommand(artifact,base,ours,theirs,options,globalOptions){if(artifact===void 0||base===void 0||ours===void 0||theirs===void 0){throw new PmCliError("merge driver requires <artifact> <base> <ours> <theirs> (git supplies %O %A %B). Example: pm merge driver history %O %A %B",EXIT_CODE.USAGE)}const result=await runMergeDriver({artifact,basePath:base,oursPath:ours,theirsPath:theirs,outputPath:typeof options.output==="string"?options.output:void 0,itemPath:typeof options.itemPath==="string"?options.itemPath:void 0,prefer:typeof options.prefer==="string"?options.prefer:void 0},globalOptions);printResult(result,globalOptions);if(!result.ok){process.exitCode=EXIT_CODE.GENERIC_FAILURE}}async function runMergeAction(subcommand,artifact,base,ours,theirs,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const normalized=subcommand.trim().toLowerCase();switch(normalized){case"install":{if(artifact!==void 0){throw new PmCliError("merge install takes no positional arguments.",EXIT_CODE.USAGE)}const result=await runMergeInstall({dryRun:options.dryRun===true},globalOptions);printResult(result,globalOptions);break}case"reconcile":await runMergeReconcileSubcommand(artifact,options,globalOptions);break;case"report":{if(artifact!==void 0){throw new PmCliError("merge report takes no positional arguments.",EXIT_CODE.USAGE)}const result=await runMergeReceiptEvidenceReport({includeReconciled:options.includeReconciled===true});printResult(result,globalOptions);if(!result.ok)process.exitCode=EXIT_CODE.GENERIC_FAILURE;break}case"driver":await runMergeDriverSubcommand(artifact,base,ours,theirs,options,globalOptions);break;default:throw createUnknownSubcommandError({command_path:"merge",token:subcommand,allowed:MERGE_SUBCOMMAND_VALUES,display_name:"merge"})}if(globalOptions.profile){printError(`profile:command=merge took_ms=${Date.now()-startedAt}`)}}function splitCollectedCommaList(raw){if(!Array.isArray(raw)){return void 0}return raw.flatMap(value=>value.split(",")).map(value=>value.trim()).filter(value=>value.length>0)}async function runSchemaAction(subcommand,name,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const{SCHEMA_SUBCOMMANDS}=schemaModule;let normalizedSubcommand=(subcommand??"").trim().toLowerCase();let typeName=name;assertSchemaSubcommandPresent(normalizedSubcommand,SCHEMA_SUBCOMMANDS);if(!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand)&&typeName===void 0&&!looksLikeSchemaSubcommandTypo(subcommand)){typeName=subcommand;normalizedSubcommand="add-type"}if(!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand)){throw createUnknownSubcommandError({command_path:"schema",token:normalizedSubcommand,allowed:SCHEMA_SUBCOMMANDS})}const result=await dispatchSchemaSubcommand(schemaModule,{normalizedSubcommand,typeName,options,aliases:stringArrayOption(options.alias),roles:stringArrayOption(options.role),commands:splitCollectedCommaList(options.commands),requiredTypes:splitCollectedCommaList(options.requiredTypes),defaultStatus:pickStringOption(options.defaultStatus,options.default_status),order:parseSchemaOrderOption(options.order),minCount:parseSchemaOrderOption(options.minCount),author:readOptionString(options,"author"),force:Boolean(options.force),description:readOptionString(options,"description"),globalOptions});if(globalOptions.json===true||globalOptions.defaultOutputFormat==="json"){printResult(result,globalOptions)}else if(!globalOptions.quiet){renderSchemaResultHuman(schemaModule,result)}if(globalOptions.profile){printError(`profile:command=schema took_ms=${Date.now()-startedAt}`)}}function assertSchemaSubcommandPresent(normalizedSubcommand,allowed){if(normalizedSubcommand){return}throw new PmCliError(`pm schema requires a subcommand. Allowed: ${allowed.join(", ")}`,EXIT_CODE.USAGE,{code:"missing_required_argument",examples:["pm schema list","pm schema show Task","pm schema show-status open",'pm schema add-type Spike --description "Time-boxed investigation" --default-status open',"pm schema remove-type Spike","pm schema add-status review --role active --alias in_review","pm schema remove-status review","pm schema add-field severity_level --type string --commands create,update","pm schema list-fields","pm schema apply-preset agile","pm schema add-type --infer --min-count 10","pm schema rename-type Spike --to Experiment --migration-id spike-v2 --dry-run","pm schema rename-field severity --to impact --migration-id severity-v2","pm schema remap-status review --to verifying --migration-id review-v2"]})}async function runCopyAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runCopy(id,{title:readOptionString(options,"title"),author:readOptionString(options,"author"),message:readOptionString(options,"message"),allowDuplicate:options.allowDuplicate===true},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=copy took_ms=${Date.now()-startedAt}`)}}async function runFocusAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runFocus(id,{clear:options.clear===true},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=focus took_ms=${Date.now()-startedAt}`)}}async function runUpdateAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertSingleMutationStdinConsumer(options);const stdinJsonConsumed=options.stdinJson===true;if(stdinJsonConsumed){const input=await createStdinTokenResolver().resolveValue("-","--stdin-json");options=itemDocumentToMutationOptions(input??"","update",options)}const descriptionStdinResolved=isDescriptionStdinConsumer(options,stdinJsonConsumed);if(!stdinJsonConsumed){await resolveDescriptionStdin(options)}const bodyFileResolved=typeof options.bodyFile==="string";if(bodyFileResolved){options.body=await resolveBodyFileContent(String(options.bodyFile),options.body!==void 0?String(options.body):void 0);delete options.bodyFile}const normalized=normalizeUpdateOptions(options);preserveResolvedMutationStdinFields(normalized,bodyFileResolved,descriptionStdinResolved);if(stdinJsonConsumed)preserveMutationStdinTokenLiterals(normalized);const result=await runUpdate(id,normalized,globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(await applyActiveCommandResultService("update",[id],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=update took_ms=${Date.now()-startedAt}`)}}async function runDeleteAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runDelete(id,{author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:Boolean(options.force),dryRun:options.dryRun===true},globalOptions);if(result.dry_run!==true){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=delete took_ms=${Date.now()-startedAt}`)}}function resolveAppendBody(text,options){const bodyFromOption=readOptionString(options,"body");const bodyFromAlias=readOptionString(options,"text");const bodyFromPositional=typeof text==="string"?text:void 0;const bodySourceCount=[bodyFromOption,bodyFromAlias,bodyFromPositional].filter(value=>value!==void 0).length;if(bodySourceCount>1){throw new PmCliError("Specify append text with exactly one source: positional [text], --body, or --text",EXIT_CODE.USAGE)}const resolvedBody=bodyFromOption??bodyFromAlias??bodyFromPositional;if(resolvedBody===void 0){throw new PmCliError("Missing append text. Provide it as positional [text], --body <value>, or --text <value> (use - for stdin).",EXIT_CODE.USAGE)}return resolvedBody}async function runAppendAction(id,text,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runAppend(id,{body:resolveAppendBody(text,options),author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:Boolean(options.force)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=append took_ms=${Date.now()-startedAt}`)}}async function runProfileAction(subcommand,name,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const{PROFILE_SUBCOMMANDS}=profileModule;const normalizedSubcommand=(subcommand??"").trim().toLowerCase();if(!normalizedSubcommand){throw new PmCliError(`pm profile requires a subcommand. Allowed: ${PROFILE_SUBCOMMANDS.join(", ")}`,EXIT_CODE.USAGE,{code:"missing_required_argument",examples:["pm profile list","pm profile show agile","pm profile apply agile --dry-run","pm profile lint agile"]})}if(!PROFILE_SUBCOMMANDS.includes(normalizedSubcommand)){throw createUnknownSubcommandError({command_path:"profile",token:normalizedSubcommand,allowed:PROFILE_SUBCOMMANDS})}const result=await dispatchProfileSubcommand(profileModule,normalizedSubcommand,name,options,globalOptions);if(globalOptions.json===true||globalOptions.defaultOutputFormat==="json"){printResult(result,globalOptions)}else if(!globalOptions.quiet){renderProfileResultHuman(profileModule,result)}if(result.action==="lint"&&!result.ok){process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=profile took_ms=${Date.now()-startedAt}`)}}function readStringArrayOption(options,key){return stringArrayOption(options[key])??[]}async function runFilesAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const addValues=readStringArrayOption(options,"add");const addGlobValues=readStringArrayOption(options,"addGlob");const removeValues=readStringArrayOption(options,"remove");const migrateValues=readStringArrayOption(options,"migrate");const result=await runFiles(id,{add:addValues,addGlob:addGlobValues,remove:removeValues,migrate:migrateValues,note:readOptionString(options,"note"),list:Boolean(options.list),appendStable:Boolean(options.appendStable),validatePaths:Boolean(options.validatePaths),author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:Boolean(options.force)},globalOptions);if(addValues.length>0||addGlobValues.length>0||removeValues.length>0||migrateValues.length>0){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(await applyActiveCommandResultService("files",[id],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=files took_ms=${Date.now()-startedAt}`)}}async function runFilesDiscoverAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const mergedOptions={...command.optsWithGlobals(),...options};const result=await runFilesDiscover(id,{apply:Boolean(mergedOptions.apply),note:readOptionString(mergedOptions,"note"),appendStable:Boolean(mergedOptions.appendStable),author:readOptionString(mergedOptions,"author"),message:readOptionString(mergedOptions,"message"),force:Boolean(mergedOptions.force)},globalOptions);if(result.changed){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=files.discover took_ms=${Date.now()-startedAt}`)}}async function runDocsAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const addValues=readStringArrayOption(options,"add");const addGlobValues=readStringArrayOption(options,"addGlob");const removeValues=readStringArrayOption(options,"remove");const migrateValues=readStringArrayOption(options,"migrate");const result=await runDocs(id,{add:addValues,addGlob:addGlobValues,remove:removeValues,migrate:migrateValues,note:readOptionString(options,"note"),list:Boolean(options.list),validatePaths:Boolean(options.validatePaths),author:readOptionString(options,"author"),message:readOptionString(options,"message"),force:Boolean(options.force)},globalOptions);if(addValues.length>0||addGlobValues.length>0||removeValues.length>0||migrateValues.length>0){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(await applyActiveCommandResultService("docs",[id],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=docs took_ms=${Date.now()-startedAt}`)}}async function runDepsAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runDeps(id,{format:options.format,maxDepth:readOptionString(options,"maxDepth"),collapse:options.collapse,summary:options.summary===true,full:options.full===true,nodeLimit:readOptionString(options,"nodeLimit"),edgeLimit:readOptionString(options,"edgeLimit"),tokenBudget:readOptionString(options,"tokenBudget"),cursor:readOptionString(options,"cursor"),direction:readOptionString(options,"direction"),...Array.isArray(options.kind)?{kind:options.kind}:{}},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=deps took_ms=${Date.now()-startedAt}`)}}function registerMutationCommands(program,registrationOptions={}){const createCommand=program.command("create").argument("[type-or-title]",'Item title, or item type when a title follows (e.g. `pm create task "Fix bug"`)').argument("[title]","Item title when the first argument is an item type").description("Create a new project management item.");registerCommanderOptionContracts(createCommand,CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);createCommand.option("--stdin-json","Read a full item JSON document from stdin; explicit flags override document values").option("--body-file <path>","Load body from a file or stdin (-); conflicts with --body").option("--clear-deps","Clear dependency entries").option("--clear-comments","Clear comments").option("--clear-notes","Clear notes").option("--clear-learnings","Clear learnings").option("--clear-files","Clear linked files").option("--clear-tests","Clear linked tests").option("--clear-docs","Clear linked docs").option("--clear-reminders","Clear reminders").option("--clear-events","Clear events").option("--clear-type-options","Clear type options").option("--allow-duplicate","Explicitly create even when strict similarity governance finds likely duplicates").action(runCreateAction);if(registrationOptions.targetCommandName==="create"){return}program.command("copy").argument("<id>","Source item id").option("--title <value>","Optional title override for the copied item").option("--author <value>","Mutation author").option("--message <value>","History message").option("--allow-duplicate","Explicitly copy even when strict similarity governance finds likely duplicates").description("Copy an item into a new item id while resetting lifecycle fields.").action(runCopyAction);program.command("focus").argument("[id]","Item id to focus (omit to show current focus)").option("--clear","Clear the focused item").description("Set/clear/show the session focused item that new items default --parent to.").action(runFocusAction);const updateCommand=program.command("update").argument("<id>","Item id").description("Update item fields and metadata.");registerCommanderOptionContracts(updateCommand,UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);updateCommand.option("--stdin-json","Read a full item JSON document from stdin; explicit flags override document values").option("--body-file <path>","Load body from a file or stdin (-); conflicts with --body").option("--replace-deps","Atomically replace dependency entries with the provided --dep values").option("--replace-tests","Atomically replace linked test entries with the provided --test values").option("--replace-files","Atomically replace linked file entries with the provided --file values").option("--replace-docs","Atomically replace linked doc entries with the provided --doc values").option("--clear-deps","Clear dependency entries").option("--clear-comments","Clear comments").option("--clear-notes","Clear notes").option("--clear-learnings","Clear learnings").option("--clear-files","Clear linked files").option("--clear-tests","Clear linked tests").option("--clear-docs","Clear linked docs").option("--clear-reminders","Clear reminders").option("--clear-events","Clear events").option("--clear-type-options","Clear type options").option("--force","Force ownership override");updateCommand.action(runUpdateAction);registerStructuredMutationCommands(program);const updateManyCommand=program.command("update-many").description("Bulk-update matched items with dry-run plans and rollback checkpoints.").option("--filter-status <value>","Filter by status before applying updates").option("--filter-type <value>","Filter by item type before applying updates").option("--filter-tag <value>","Filter by tag before applying updates").option("--filter-priority <value>","Filter by priority before applying updates").option("--filter-deadline-before <value>","Filter by deadline upper bound before applying updates").option("--filter-deadline-after <value>","Filter by deadline lower bound before applying updates").option("--filter-updated-after <value>","Filter by updated_at lower bound before applying updates (ISO/relative)").option("--filter-updated-before <value>","Filter by updated_at upper bound before applying updates (ISO/relative)").option("--filter-created-after <value>","Filter by created_at lower bound before applying updates (ISO/relative)").option("--filter-created-before <value>","Filter by created_at upper bound before applying updates (ISO/relative)").option("--filter-assignee <value>","Filter by assignee before applying updates").option("--filter-assignee-filter <value>","Filter assignee presence: assigned|unassigned before applying updates").option("--filter-parent <value>","Filter by parent item ID before applying updates").option("--filter-sprint <value>","Filter by sprint before applying updates").option("--filter-release <value>","Filter by release before applying updates").option("--filter-ac-missing","Select only items missing acceptance_criteria (bulk backfill)").option("--filter-estimates-missing","Select only items missing estimated_minutes (bulk backfill)").option("--filter-resolution-missing","Select only terminal items missing resolution (bulk backfill)").option("--filter-metadata-missing","Select only items missing any tracked metadata (AC, estimate, or resolution)");registerBulkContentAndGovernanceFilters(updateManyCommand,"applying updates");updateManyCommand.option("--ids <value>","Explicit ID allowlist: comma/newline text, - stdin, or @path file").option("--limit <n>","Limit matched item count before apply/preview").option("--offset <n>","Skip first n matched rows before apply/preview").option("--dry-run","Preview per-item diffs and checkpoint intent without mutating").option("--rollback <value>","Rollback a prior update-many checkpoint ID").option("--no-checkpoint","Disable checkpoint creation during apply mode").option("--title, -t <value>","Set title").option("--description, -d <value>","Set description").option("--body, -b <value>","Set body (allow empty string)").option("--status, -s <value>","Set status (use close command for closed)").option("--priority, -p <value>","Set priority").option("--type <value>","Set type").option("--tags <value>","Set comma-separated tags (replaces existing). Use --add-tags / --remove-tags to mutate additively.").option("--add-tags <value>","Add tags additively without replacing existing (repeatable; CSV accepted)",collect).option("--remove-tags <value>","Remove tags from the existing list (repeatable; CSV accepted)",collect).option("--deadline <value>","Set deadline (ISO/date string or relative)").option("--estimate, --estimated-minutes <value>","Set estimated minutes").option("--acceptance-criteria <value>","Set acceptance criteria").option("--ac <value>","Alias for --acceptance-criteria").option("--add-ac <value>","Add one semicolon-free acceptance criterion without replacing the existing list (repeatable)",collect).option("--remove-ac <value>","Remove one semicolon-free acceptance criterion by exact text match (repeatable)",collect).option("--definition-of-ready <value>","Set definition of ready").option("--order <value>","Set planning order/rank integer").option("--rank <value>","Alias for --order").option("--goal <value>","Set goal identifier").option("--objective <value>","Set objective identifier").option("--value <value>","Set business value summary").option("--impact <value>","Set business impact summary").option("--outcome <value>","Set expected outcome summary").option("--why-now <value>","Set why-now rationale").option("--assignee <value>","Set assignee").option("--parent <value>","Set parent item ID").option("--reviewer <value>","Set reviewer").option("--risk <value>","Set risk level").option("--confidence <value>","Set confidence level").option("--sprint <value>","Set sprint identifier").option("--release <value>","Set release identifier").option("--blocked-by <value>","Set blocked-by item ID or reason").option("--blocked-reason <value>","Set blocked reason").option("--unblock-note <value>","Set unblock rationale note").option("--reporter <value>","Set issue reporter").option("--severity <value>","Set issue severity").option("--environment <value>","Set issue environment context").option("--repro-steps <value>","Set issue reproduction steps").option("--resolution <value>","Set issue resolution summary").option("--expected-result <value>","Set issue expected behavior").option("--expected <value>","Short alias for --expected-result").option("--actual-result <value>","Set issue observed behavior").option("--actual <value>","Short alias for --actual-result").option("--affected-version <value>","Set affected version identifier").option("--fixed-version <value>","Set fixed version identifier").option("--component <value>","Set issue component ownership").option("--regression [value]","Set regression marker; bare flag means true, or pass true|false|1|0").option("--customer-impact <value>","Set customer impact summary").option("--dep <value>","Add dependency entry id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>",collect).option("--dep-remove <value>","Remove dependency entries by id/kind/author/timestamp signature",collect).option("--replace-deps","Atomically replace dependency entries with provided --dep values").option("--replace-tests","Atomically replace linked tests with provided --test values").option("--replace-files","Atomically replace linked files with provided --file values").option("--replace-docs","Atomically replace linked docs with provided --doc values").option("--comment <value>","Add comment seed author=<value>,created_at=<iso|now>,text=<value>",collect).option("--note <value>","Add note seed author=<value>,created_at=<iso|now>,text=<value>",collect).option("--learning <value>","Add learning seed author=<value>,created_at=<iso|now>,text=<value>",collect).option("--file <value>","Add linked file path=<value>,scope=<project|global>,note=<text>",collect).option("--test <value>","Add linked test command=<value>,path=<value>,scope=<project|global>",collect).option("--doc <value>","Add linked doc path=<value>,scope=<project|global>,note=<text>",collect).option("--reminder <value>","Add reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>",collect).option("--event <value>","Add event entry start=<iso|relative>,end=<iso|relative>,recur_*",collect).option("--type-option <value>","Set type options key=value (repeatable)",collect).option("--unset <field>","Clear scalar metadata field by name (repeatable)",collect).option("--clear-deps","Clear dependency entries").option("--clear-comments","Clear comments").option("--clear-notes","Clear notes").option("--clear-learnings","Clear learnings").option("--clear-files","Clear linked files").option("--clear-tests","Clear linked tests").option("--clear-docs","Clear linked docs").option("--clear-reminders","Clear reminders").option("--clear-events","Clear events").option("--clear-type-options","Clear type options").option("--author <value>","Mutation author").option("--message <value>","Mutation message").option("--force","Force ownership override");addHiddenOptions(updateManyCommand,[["--filter-assignee_filter <value>","Alias for --filter-assignee-filter"],["--estimated_minutes <value>","Alias for --estimated-minutes"],["--acceptance_criteria <value>","Alias for --acceptance-criteria"],["--definition_of_ready <value>","Alias for --definition-of-ready"],["--why_now <value>","Alias for --why-now"],["--blocked_by <value>","Alias for --blocked-by"],["--blocked_reason <value>","Alias for --blocked-reason"],["--unblock_note <value>","Alias for --unblock-note"],["--repro_steps <value>","Alias for --repro-steps"],["--expected_result <value>","Alias for --expected-result"],["--actual_result <value>","Alias for --actual-result"],["--affected_version <value>","Alias for --affected-version"],["--fixed_version <value>","Alias for --fixed-version"],["--customer_impact <value>","Alias for --customer-impact"],["--filter-estimate-missing","Alias for --filter-estimates-missing"]],false);addHiddenOptions(updateManyCommand,[["--dep_remove <value>","Alias for --dep-remove"],["--type_option <value>","Alias for --type-option"],["--add_tags <value>","Alias for --add-tags"],["--remove_tags <value>","Alias for --remove-tags"],["--add_ac <value>","Alias for --add-ac"],["--remove_ac <value>","Alias for --remove-ac"]],true);updateManyCommand.action(runUpdateManyAction);const closeCommand=program.command("close").argument("<id>","Item id").argument("[text]","Close reason text (alias: --reason)").option("-r, --reason <value>","Close reason text (alias for positional <text>)").option("--close-reason <value>","Close reason text (alias for positional <text>)").option("--completed-at <value>","Actual completion timestamp (ISO or relative), distinct from tracker close time").option("-d, --duplicate-of <id>","Close as a duplicate of the canonical item id and auto-fill duplicate closure metadata").option("--author <value>","Mutation author").option("-m, --message <value>","History message").option("--validate-close [mode]",'Validate closure metadata before close: "off", "warn", or "strict" (default: settings governance preset)').option("--resolution <value>","Set the closure resolution summary inline (same field --validate-close strict checks; previously required a prior pm update)").option("--expected-result <value>","Set the expected-result note inline (closure validation field)").option("--expected <value>","Short alias for --expected-result").option("--actual-result <value>","Set the actual-result note inline (closure validation field)").option("--actual <value>","Short alias for --actual-result").option("--force","Force ownership override").description("Close an item. Close reason requirement follows governance.require_close_reason.");addHiddenOption(closeCommand,"--expected_result <value>","Alias for --expected-result",false);addHiddenOption(closeCommand,"--actual_result <value>","Alias for --actual-result",false);closeCommand.action(runCloseAction);const closeManyCommand=program.command("close-many").description("Bulk-close matched items with a shared reason and full runClose semantics (dry-run + rollback checkpoint).").option("--filter-status <value>","Filter by status before closing").option("--filter-type <value>","Filter by item type before closing").option("--filter-tag <value>","Filter by tag before closing").option("--filter-priority <value>","Filter by priority before closing").option("--filter-deadline-before <value>","Filter by deadline upper bound before closing").option("--filter-deadline-after <value>","Filter by deadline lower bound before closing").option("--filter-updated-after <value>","Filter by updated_at lower bound before closing (ISO/relative)").option("--filter-updated-before <value>","Filter by updated_at upper bound before closing (ISO/relative)").option("--filter-created-after <value>","Filter by created_at lower bound before closing (ISO/relative)").option("--filter-created-before <value>","Filter by created_at upper bound before closing (ISO/relative)").option("--filter-assignee <value>","Filter by assignee before closing").option("--filter-assignee-filter <value>","Filter assignee presence: assigned|unassigned before closing").option("--filter-parent <value>","Filter by parent item ID before closing").option("--filter-sprint <value>","Filter by sprint before closing").option("--filter-release <value>","Filter by release before closing");registerBulkContentAndGovernanceFilters(closeManyCommand,"closing");closeManyCommand.option("--ids <value>","Explicit ID allowlist: comma/newline text, - stdin, or @path file").option("--limit <n>","Limit matched item count before apply/preview").option("--offset <n>","Skip first n matched rows before apply/preview").option("--reason <value>","Shared close reason applied to matched items (required when governance.require_close_reason is enabled)").option("--completed-at <value>","Actual completion timestamp (ISO or relative) applied to every matched item").option("--resolution <value>","Shared closure resolution applied to every matched item (closure-validation field)").option("--expected-result <value>","Shared expected-result note (closure-validation field)").option("--expected <value>","Short alias for --expected-result").option("--actual-result <value>","Shared actual-result note (closure-validation field)").option("--actual <value>","Short alias for --actual-result").option("--validate-close [mode]",'Validate closure metadata per item: "off", "warn", or "strict" (default: settings governance preset)').option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Re-close already-terminal matches and override ownership").option("--dry-run","Preview matched items + per-item skip/active-child plan without mutating").option("--rollback <value>","Rollback a prior close-many checkpoint ID").option("--no-checkpoint","Disable checkpoint creation during apply mode");addHiddenOption(closeManyCommand,"--filter-assignee_filter <value>","Alias for --filter-assignee-filter",false);addHiddenOption(closeManyCommand,"--expected_result <value>","Alias for --expected-result",false);addHiddenOption(closeManyCommand,"--actual_result <value>","Alias for --actual-result",false);closeManyCommand.action(runCloseManyAction);program.command("delete").argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").option("--dry-run","Preview the item file that would be deleted without mutating").description("Delete an item and record the change in history.").action(runDeleteAction);program.command("append").argument("<id>","Item id").argument("[text]","Body text; same as --body (- reads stdin)").option("--body <value>","Text to append to body (or - for stdin)").option("--text <value>","Alias for --body").option("--author <value>","Mutation author").option("--message <value>","Mutation message").option("--force","Force ownership override").description("Append text to an item's body. For concurrent writes, use pm notes.").action(runAppendAction);const planCommand=program.command("plan").description("Agent-optimized Plan item workflow: create, manage steps, link dependencies, approve, and materialize.").argument("[subcommand]","Required; Plan subcommand: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize").argument("[id]","Plan id (required for non-create subcommands); for create this may be the positional title").argument("[step]","Step reference: stable id (plan-step-001) or order integer").argument("[new-order]","New order integer for reorder-step").option("--title <value>","Plan title").option("--description <value>","Plan description").option("--scope <value>","Short scope statement of the target change or investigation").option("--parent <value>","Parent pm item id").option("--related <value>","Related pm item ids (repeatable, csv-friendly)",collect).option("--blocks <value>","Pm item ids this plan blocks (repeatable, csv-friendly)",collect).option("--blocked-by <value>","Pm item ids that block this plan (repeatable, csv-friendly)",collect).option("--harness <value>","Plan harness provenance: codex|claude-code|cursor|generic").option("--mode <value>","Plan mode: draft|research|review|approved|executing|paused|completed|superseded").option("--resume-context <value>","Compact context summary for a future stateless agent").option("--tags <value>","Comma-separated tags").option("--priority <value>","Priority 0-4").option("--body <value>","Plan item body").option("--claim","Claim the plan on create for the author").option("--from-search <value>","Record the search query that led to plan creation").option("--template <value>","Seed plan steps from a built-in template: bug-investigation|feature-implementation|refactoring-sprint").option("--step-title <value>","Step title for add-step / update-step").option("--step <value>","Step title (repeatable on create: each --step appends an ordered step; elsewhere a single value aliases --step-title)",collect).option("--step-body <value>","Step body text").option("--step-owner <value>","Step owner").option("--step-status <value>","Step status: pending|in_progress|completed|blocked|skipped|superseded").option("--step-evidence <value>","Step evidence text (used by update-step/complete-step)").option("--step-blocked-reason <value>","Step blocked reason (required when blocking)").option("--step-replacement <value>","Replacement reference for a superseded step").option("--depends-on <value>","Pm item ids the step depends on (repeatable, csv-friendly)",collect).option("--link <value>","Pm item id to link (repeatable, csv-friendly)",collect).option("--link-kind <value>",`Link kind: ${PLAN_STEP_LINK_KIND_VALUES.join("|")}`).option("--link-note <value>","Optional note for the link").option("--promote-to-item-dep","Also add the linked id as a top-level item dependency when linking").option("--allow-multiple-active","Allow multiple steps to be in_progress at once").option("--file <value>","Step linked file path=<value>[,scope=project|global,note=<text>] (repeatable)",collect).option("--test <value>","Step linked test command=<value>[,path=<value>,note=<text>] (repeatable)",collect).option("--doc <value>","Step linked doc path=<value>[,scope=project|global,note=<text>] (repeatable)",collect).option("--decision-text <value>","Decision log entry text").option("--decision <value>","Alias for --decision-text").option("--decision-rationale <value>","Decision log entry rationale").option("--decision-evidence <value>","Decision log entry evidence").option("--discovery-text <value>","Discovery log entry text").option("--discovery <value>","Alias for --discovery-text").option("--validation-text <value>","Validation log entry text").option("--validation <value>","Alias for --validation-text").option("--validation-command <value>","Validation log entry command").option("--validation-expected <value>","Validation log entry expected outcome").option("--depth <value>","Show depth: brief|standard|deep (default: brief)").option("--fields <value>","Comma-separated field projection for show output").option("--steps <value>","Comma-separated step ids/orders for materialize").option("--materialize-type <value>","Item type for materialized steps (default: Task)").option("--materialize-parent <value>","Parent item id for materialized children (default: the plan)").option("--materialize-tags <value>","Comma-separated tags for materialized children").option("--field <name=value>","Custom field value forwarded to every materialized child (repeatable)",collect).option("--author <value>","Mutation author").option("--message <value>","Mutation message").option("--force","Force ownership override");registerCommanderOptionContracts(planCommand,CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS.filter(contract=>PLAN_CREATE_METADATA_OPTION_TARGETS.has(contract.target)));addHiddenOptions(planCommand,[["--resume_context <value>","Alias for --resume-context"],["--from_search <value>","Alias for --from-search"],["--step_title <value>","Alias for --step-title"],["--step_body <value>","Alias for --step-body"],["--step_owner <value>","Alias for --step-owner"],["--step_status <value>","Alias for --step-status"],["--step_evidence <value>","Alias for --step-evidence"],["--step_blocked_reason <value>","Alias for --step-blocked-reason"],["--step_replacement <value>","Alias for --step-replacement"],["--link_kind <value>","Alias for --link-kind"],["--link_note <value>","Alias for --link-note"],["--promote_to_item_dep","Alias for --promote-to-item-dep"],["--allow_multiple_active","Alias for --allow-multiple-active"],["--decision_text <value>","Alias for --decision-text"],["--decision_rationale <value>","Alias for --decision-rationale"],["--decision_evidence <value>","Alias for --decision-evidence"],["--discovery_text <value>","Alias for --discovery-text"],["--validation_text <value>","Alias for --validation-text"],["--validation_command <value>","Alias for --validation-command"],["--validation_expected <value>","Alias for --validation-expected"],["--materialize_type <value>","Alias for --materialize-type"],["--materialize_parent <value>","Alias for --materialize-parent"],["--materialize_tags <value>","Alias for --materialize-tags"]],false);addHiddenOptions(planCommand,[["--blocked_by <value>","Alias for --blocked-by"],["--depends_on <value>","Alias for --depends-on"]],true);planCommand.action(runPlanAction);void planCommand;registerHistoryMaintenanceCommands(program,false);registerHistoryAuthorAcknowledgeCommand(program);program.command("merge").argument("<subcommand>",`Merge subcommand: ${MERGE_SUBCOMMAND_VALUES.join(", ")}`).argument("[artifact]",`driver only: artifact class to merge (${MERGE_DRIVER_ARTIFACT_VALUES.join(", ")})`).argument("[base]","driver only: common-ancestor file path (git %O)").argument("[ours]","driver only: current-branch file path (git %A)").argument("[theirs]","driver only: other-branch file path (git %B)").option("--dry-run","install/reconcile: preview changes without writing").option("--message <text>","reconcile only: audit message recorded on repaired history streams").option("--force","reconcile only: permit the underlying audited history ownership override").option("--include-reconciled","report only: include clone-local receipts already recorded in history").option("--output <path>","driver only: write the merged content to this path instead of the ours path").option("--item-path <path>","driver only: original repository-relative path supplied by git as %P").option("--prefer <side>","driver only: side that wins unresolvable conflicts (ours|theirs; default ours)").description("Install merge drivers, reconcile or report post-merge history, or run a field-aware driver.").action(runMergeAction);const schemaCommand=program.command("schema").argument("[subcommand]","Required; Schema subcommand: list, show, show-status, add/remove type/status/field, rename-type, rename-field, remap-status, or a custom item type name shorthand").argument("[name]","Definition name, or source name for rename/remap migrations").option("--description <text>","Human description for the custom item type, status, or field").option("--default-status <status>","Default status hint recorded for the custom item type").option("--folder <dir>","Storage folder for items of this custom type").option("--alias <name>","Alias for the custom type, status, or field flag (repeatable, csv-friendly)",collect).option("--role <value>","Lifecycle role for a custom status (repeatable): draft, active, blocked, terminal, terminal_done, terminal_canceled, default_open, default_close, default_cancel",collect).option("--order <n>","Display/sort order for a custom status").option("--type <type>","Value type for a custom field (add-field): string, number, boolean, string_array, array, object").option("--commands <list>","Commands a custom field is wired onto (add-field; repeatable, comma-friendly): create, update, update_many, list, search, calendar, context",collect).option("--cli-flag <flag>","Override the auto-derived CLI flag for a custom field (add-field)").option("--required","Mark a custom field as always required (add-field)").option("--required-on-create","Mark a custom field as required at create time (add-field)").option("--no-allow-unset","Disallow clearing a custom field via --unset (add-field)").option("--required-types <list>","Restrict a custom field's requirement to specific item types (add-field; repeatable, comma-friendly)",collect).option("--infer","Infer custom item types from title-prefix conventions (add-type; preview unless --apply)").option("--min-count <n>","Minimum items sharing a prefix for add-type --infer (default 10)").option("--apply","Register inferred types (add-type --infer); without it the command previews only").option("--to <name>","Target definition name for rename/remap migrations").option("--migration-id <id>","Stable idempotency key for a resumable schema migration").option("--dry-run","Plan a schema migration without writing schema, items, or history").option("--author <value>","Mutation author").option("--force","Force ownership/lock override").description("Inspect and manage config-driven runtime schema (types, statuses, fields, presets).");addHiddenOption(schemaCommand,"--default_status <status>","Alias for --default-status",false);addHiddenOption(schemaCommand,"--migration_id <id>","Alias for --migration-id",false);schemaCommand.action(runSchemaAction);const profileCommand=program.command("profile").argument("[subcommand]","Required; Profile subcommand: list, show, apply, or lint").argument("[name]","Profile name for show/apply/lint: agile, ops, or research").option("--dry-run","Preview the apply diff without writing any files (apply)").option("--author <value>","Mutation author").option("--force","Force ownership/lock override").description("List, show, apply, and lint project profiles \u2014 archetype bundles of item types, statuses, fields, workflows, config, templates, and recommended packages.");profileCommand.action(runProfileAction);registerAnnotationCommands(program,parsePositiveIntOption);const filesCommand=program.command("files").description("Manage files linked to an item.");filesCommand.argument("<id>","Item id").option("--add <value>","Add linked file entry (CSV/markdown pairs or - for stdin)",collect).option("--add-glob <value>","Add linked file entries from a glob (plain glob or pattern=<glob>,scope=<scope>,note=<text>; repeatable)",collect).option("--remove <value>","Remove linked file by path only (path=<value>, path:<value>, plain path, or - for stdin); does not accept note=/scope= \u2014 record removal context with --message",collect).option("--migrate <value>","Migrate linked file paths in-place (from=<prefix>,to=<prefix>; repeatable)",collect).option("--note <value>","Note attached to every link added by --add/--add-glob in this invocation (embedded note= wins)").option("--list","List linked files without mutating").option("--append-stable","Preserve existing linked-file order and append new links without full-array resorting").option("--validate-paths","Validate linked file paths for existence and file shape").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").action(runFilesAction);filesCommand.command("discover").argument("<id>","Item id").option("--apply","Add discovered missing files to the item").option("--note <value>","Note to attach to discovered file links").option("--append-stable","Preserve existing linked-file order and append discovered links without full-array resorting").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Discover existing file paths referenced in item text and optionally link missing files.").action(runFilesDiscoverAction);registerFilesLookupCommand(filesCommand);program.command("docs").argument("<id>","Item id").option("--add <value>","Add linked doc entry (CSV/markdown pairs or - for stdin)",collect).option("--add-glob <value>","Add linked doc entries from a glob (plain glob or pattern=<glob>,scope=<scope>,note=<text>; repeatable)",collect).option("--remove <value>","Remove linked doc by path only (path=<value>, path:<value>, plain path, or - for stdin); does not accept note=/scope= \u2014 record removal context with --message",collect).option("--migrate <value>","Migrate linked doc paths in-place (from=<prefix>,to=<prefix>; repeatable)",collect).option("--note <value>","Note attached to every link added by --add/--add-glob in this invocation (embedded note= wins)").option("--list","List linked docs without mutating").option("--validate-paths","Validate linked doc paths for existence and file shape").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Manage docs linked to an item.").action(runDocsAction);program.command("deps").argument("<id>","Item id").option("--format <value>","Output format (tree, graph, or context)","tree").option("--max-depth <value>","Maximum dependency traversal depth (0 keeps only the root)").option("--collapse <value>","Collapse mode (none or repeated)","none").option("--summary","Return counts only without full tree/graph payload").option("--full","Return the complete dependency row projection").option("--node-limit <value>","Maximum nodes in context output").option("--edge-limit <value>","Maximum edges and missing-reference rows in context output").option("--token-budget <value>","Maximum estimated tokens in context output").option("--cursor <value>","Continue an equivalent context query").option("--direction <value>","Context traversal direction (outgoing, incoming, or both)").option("--kind <value>","Restrict context traversal to registered relationship kinds (repeatable or comma-separated)",collect).description("Show dependency relationships for an item.").action(runDepsAction)}export{looksLikeSchemaSubcommandTypo2 as looksLikeSchemaSubcommandTypo,parsePositiveIntOption,parseSchemaOrderOption2 as parseSchemaOrderOption,registerCommanderOptionContracts,registerMutationCommands};
 //# sourceMappingURL=register-mutation.js.map
-//# debugId=c9d736d1-58bf-5088-aaae-0b89ad61d41f