@unbrained/pm-cli 2026.7.1 → 2026.7.3

package/dist/cli-bundle/chunks/{register-mutation-ENNDUAZG.js → register-mutation-SJWMVIJ2.js}

@@ -1,5 +1,5 @@
 
-!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]="83d6617e-974e-5c3a-904a-d8671268dbd1")}catch(e){}}();
+!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]="919c1fe0-eaf0-51d1-9788-48d73b423eb3")}catch(e){}}();
 import {
   splitCommaList
 } from "./chunk-P4SESZGT.js";
@@ -10,26 +10,27 @@ import {
   getGlobalOptions,
   invalidateSearchCachesForMutation,
   normalizeCreateOptions,
-  normalizeUpdateOptions
-} from "./chunk-CWFNTKQJ.js";
+  normalizeUpdateOptions,
+  readOptionString
+} from "./chunk-RJH5VQHW.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunk-NWMZWYYB.js";
-import "./chunk-UYUYDGIB.js";
+} from "./chunk-T3P7PMZP.js";
+import "./chunk-OGLGI22K.js";
 import {
   CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,
   UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS
-} from "./chunk-HXTQJXWT.js";
-import "./chunk-JSU5P7VS.js";
-import "./chunk-QCWF6IYD.js";
-import "./chunk-AXIDKKAT.js";
+} from "./chunk-572FKBRL.js";
+import "./chunk-4WB6S4YX.js";
+import "./chunk-YSDFIY7N.js";
+import "./chunk-CXR3CMBQ.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
   PmCliError
-} from "./chunk-7R4QEMZZ.js";
+} from "./chunk-L4SLHV6G.js";
 
 // dist/cli/register-mutation.js
 import { Option } from "commander";
@@ -102,6 +103,11 @@ function addHiddenOption(command, flags, description, repeatable) {
   }
   command.addOption(option);
 }
+function addHiddenOptions(command, aliases, repeatable) {
+  for (const [flags, description] of aliases) {
+    addHiddenOption(command, flags, description, repeatable);
+  }
+}
 var SCHEMA_SHORTHAND_RESERVED_PREFIXES = ["add-", "apply-", "list-", "remove-", "show-"];
 var SCHEMA_SHORTHAND_RESERVED_TOKENS = /* @__PURE__ */ new Set([
   "field",
@@ -397,107 +403,709 @@ function buildUpdateManyListOptions(options) {
     includeBody: true
   };
 }
-function registerMutationCommands(program) {
-  const createCommand = program.command("create").argument("[typeOrTitle]", '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("--body-file <path>", "Load the item markdown body from a file (mutually exclusive 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").action(async (typeOrTitle, secondTitle, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    let positionalType;
-    let positionalTitle;
-    if (typeof secondTitle === "string" && secondTitle.length > 0) {
-      positionalType = typeOrTitle;
-      positionalTitle = secondTitle;
-    } else if (typeof typeOrTitle === "string" && typeOrTitle.length > 0) {
-      const explicitTitleProvided = typeof options.title === "string" && options.title.trim().length > 0;
-      if (explicitTitleProvided && options.type === void 0) {
-        positionalType = typeOrTitle;
-      } else {
-        positionalTitle = typeOrTitle;
-      }
-    }
-    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())) {
-      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>"`
-        ]
-      });
-    }
-    if (typeof positionalType === "string" && positionalType.length > 0 && options.type === void 0) {
-      options.type = positionalType;
-    }
-    if (typeof positionalTitle === "string" && positionalTitle.length > 0 && options.title === void 0) {
-      options.title = positionalTitle;
+function pickStringOption(...candidates) {
+  for (const candidate of candidates) {
+    if (typeof candidate === "string") {
+      return candidate;
     }
-    if (typeof options.bodyFile === "string") {
-      options.body = await resolveBodyFileContent(options.bodyFile, options.body !== void 0 ? String(options.body) : void 0);
-      delete options.bodyFile;
-    }
-    const normalized = normalizeCreateOptions(options, { requireType: false });
-    const { runCreate } = await import("./create-RLRJMRTM.js");
-    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}`);
+  }
+  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>"`
+    ]
+  });
+}
+async function runCreateAction(typeOrTitle, secondTitle, options, command) {
+  const globalOptions = getGlobalOptions(command);
+  const startedAt = Date.now();
+  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;
+  }
+  if (typeof options.bodyFile === "string") {
+    options.body = await resolveBodyFileContent(options.bodyFile, options.body !== void 0 ? String(options.body) : void 0);
+    delete options.bodyFile;
+  }
+  const normalized = normalizeCreateOptions(options, { requireType: false });
+  const { runCreate } = await import("./create-PM45M6PE.js");
+  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();
+  const { runCloseMany } = await import("./close-many-JKUJMHLG.js");
+  const result = await runCloseMany({
+    status: readOptionString(options, "filterStatus"),
+    list: buildCloseManyListOptions(options),
+    reason: readOptionString(options, "reason"),
+    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();
+  const { runUpdateMany } = await import("./update-many-BEMTDA2X.js");
+  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(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 { runClose } = await import("./close-AFVKPR57.js");
+  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"),
+    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];
     }
+  }
+  return planOptions;
+}
+function assertKnownPlanSubcommand(subcommand, 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 new PmCliError(`Unknown pm plan subcommand "${subcommand}". Allowed: ${allowed.join(", ")}`, EXIT_CODE.USAGE, examples ? { code: "unknown_subcommand", examples } : 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 { runPlan, PLAN_SUBCOMMANDS } = await import("./plan-JO6V7BXO.js");
+  const normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
+  assertKnownPlanSubcommand(subcommand, 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
   });
-  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").description("Copy an item into a new item id while resetting lifecycle fields.").action(async (id, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { runCopy } = await import("./copy-DEM4DATS.js");
-    const result = await runCopy(id, {
-      title: typeof options.title === "string" ? options.title : void 0,
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0
+  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 void 0;
+  }
+  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);
+}
+async function runHistoryCompactAction(id, options, command) {
+  const globalOptions = getGlobalOptions(command);
+  const startedAt = Date.now();
+  const { runHistoryCompact, runHistoryCompactBulk, assertHistoryCompactTarget } = await import("./history-compact-V5DNAQHH.js");
+  const ids = typeof options.ids === "string" ? splitCommaList(options.ids) : void 0;
+  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" : void 0;
+  const isBulk = ids !== void 0 || allOver !== void 0 || scope !== void 0;
+  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 === void 0) {
+    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);
-    await invalidateSearchCachesForMutation(globalOptions, result);
     printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=copy took_ms=${Date.now() - startedAt}`);
+    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 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 schemaModule = await import("./schema-IB2NZZWD.js");
+  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(normalizedSubcommand)) {
+    typeName = subcommand;
+    normalizedSubcommand = "add-type";
+  }
+  if (!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand)) {
+    throw new PmCliError(`Unknown pm schema subcommand "${subcommand}". Allowed: ${SCHEMA_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, { code: "unknown_subcommand" });
+  }
+  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
   });
-  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(async (id, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { runFocus } = await import("./focus-DWYIG7GU.js");
-    const result = await runFocus(id, { clear: options.clear === true }, globalOptions);
+  if (globalOptions.json === true || globalOptions.defaultOutputFormat === "json") {
     printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=focus took_ms=${Date.now() - startedAt}`);
-    }
+  } 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"
+    ]
   });
+}
+function resolveCommentSources(text, options) {
+  const editIndex = typeof options.edit === "number" ? options.edit : void 0;
+  const deleteIndex = typeof options.delete === "number" ? options.delete : void 0;
+  const addFromOption = readOptionString(options, "add");
+  const addFromPositional = typeof text === "string" ? text : void 0;
+  const readFromStdin = options.stdin === true;
+  const readFromFile = readOptionString(options, "file");
+  const sourceCount = Number(addFromOption !== void 0) + Number(addFromPositional !== void 0) + Number(readFromStdin) + Number(readFromFile !== void 0);
+  if (sourceCount > 1) {
+    if (addFromOption !== void 0 && addFromPositional !== void 0 && !readFromStdin && readFromFile === void 0) {
+      throw new PmCliError("Specify comment text either as positional [text] or with --add, not both", EXIT_CODE.USAGE);
+    }
+    throw new PmCliError("Specify comment text with exactly one source: positional [text], --add, --stdin, or --file", EXIT_CODE.USAGE);
+  }
+  const add = addFromOption ?? addFromPositional;
+  const isMutation = typeof add === "string" || readFromStdin || readFromFile !== void 0 || editIndex !== void 0 || deleteIndex !== void 0;
+  return { add, readFromStdin, readFromFile, editIndex, deleteIndex, isMutation };
+}
+async function runCommentsAction(id, text, options, command) {
+  const globalOptions = getGlobalOptions(command);
+  const startedAt = Date.now();
+  const sources = resolveCommentSources(text, options);
+  const { runComments } = await import("./comments-RW23R3VE.js");
+  const result = await runComments(id, {
+    add: sources.add,
+    stdin: sources.readFromStdin,
+    file: sources.readFromFile,
+    edit: sources.editIndex,
+    delete: sources.deleteIndex,
+    limit: readOptionString(options, "limit"),
+    author: readOptionString(options, "author"),
+    message: readOptionString(options, "message"),
+    allowAuditComment: Boolean(options.allowAuditComment),
+    force: Boolean(options.force)
+  }, globalOptions);
+  if (sources.isMutation) {
+    await invalidateSearchCachesForMutation(globalOptions, result);
+  }
+  printResult(result, globalOptions);
+  if (globalOptions.profile) {
+    printError(`profile:command=comments took_ms=${Date.now() - startedAt}`);
+  }
+}
+async function runCopyAction(id, options, command) {
+  const globalOptions = getGlobalOptions(command);
+  const startedAt = Date.now();
+  const { runCopy } = await import("./copy-6XOR3HKN.js");
+  const result = await runCopy(id, {
+    title: readOptionString(options, "title"),
+    author: readOptionString(options, "author"),
+    message: readOptionString(options, "message")
+  }, 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 { runFocus } = await import("./focus-2Q3K76G2.js");
+  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();
+  if (typeof options.bodyFile === "string") {
+    options.body = await resolveBodyFileContent(options.bodyFile, options.body !== void 0 ? String(options.body) : void 0);
+    delete options.bodyFile;
+  }
+  const { runUpdate } = await import("./update-IKJZWLQC.js");
+  const result = await runUpdate(id, normalizeUpdateOptions(options), globalOptions);
+  await invalidateSearchCachesForMutation(globalOptions, result);
+  printResult(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 { runDelete } = await import("./delete-LPISP43T.js");
+  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 resolveSingleTextSource(label, positional, options) {
+  const addFromOption = readOptionString(options, "add");
+  const addFromPositional = typeof positional === "string" ? positional : void 0;
+  if (addFromOption !== void 0 && addFromPositional !== void 0) {
+    throw new PmCliError(`Specify ${label} text either as positional [text] or with --add, not both`, EXIT_CODE.USAGE);
+  }
+  return addFromOption ?? addFromPositional;
+}
+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 { runAppend } = await import("./append-JFG4WQMG.js");
+  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 { runRestore } = await import("./restore-44IHMMZZ.js");
+  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 profileModule = await import("./profile-WIQY2KCV.js");
+  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 new PmCliError(`Unknown pm profile subcommand "${subcommand}". Allowed: ${PROFILE_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, { code: "unknown_subcommand" });
+  }
+  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}`);
+  }
+}
+async function runNotesAction(id, text, options, command) {
+  const globalOptions = getGlobalOptions(command);
+  const startedAt = Date.now();
+  const add = resolveSingleTextSource("note", text, options);
+  const { runNotes } = await import("./notes-W4UEICGF.js");
+  const result = await runNotes(id, {
+    add,
+    limit: readOptionString(options, "limit"),
+    author: readOptionString(options, "author"),
+    message: readOptionString(options, "message"),
+    allowAuditComment: Boolean(options.allowAuditNote || options.allowAuditComment),
+    force: Boolean(options.force)
+  }, globalOptions);
+  if (typeof add === "string") {
+    await invalidateSearchCachesForMutation(globalOptions, result);
+  }
+  printResult(result, globalOptions);
+  if (globalOptions.profile) {
+    printError(`profile:command=notes took_ms=${Date.now() - startedAt}`);
+  }
+}
+async function runLearningsAction(id, text, options, command) {
+  const globalOptions = getGlobalOptions(command);
+  const startedAt = Date.now();
+  const add = resolveSingleTextSource("learning", text, options);
+  const { runLearnings } = await import("./learnings-4BHWFFUV.js");
+  const result = await runLearnings(id, {
+    add,
+    limit: readOptionString(options, "limit"),
+    author: readOptionString(options, "author"),
+    message: readOptionString(options, "message"),
+    allowAuditComment: Boolean(options.allowAuditLearning || options.allowAuditComment),
+    force: Boolean(options.force)
+  }, globalOptions);
+  if (typeof add === "string") {
+    await invalidateSearchCachesForMutation(globalOptions, result);
+  }
+  printResult(result, globalOptions);
+  if (globalOptions.profile) {
+    printError(`profile:command=learnings 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 { runFiles } = await import("./files-6SGKHS6O.js");
+  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),
+    audit: Boolean(options.audit),
+    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(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 { runFilesDiscover } = await import("./files-6SGKHS6O.js");
+  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 { runDocs } = await import("./docs-6LQ3GLM7.js");
+  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),
+    audit: Boolean(options.audit),
+    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(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 { runDeps } = await import("./deps-WATKQDE3.js");
+  const result = await runDeps(id, {
+    format: options.format,
+    maxDepth: readOptionString(options, "maxDepth"),
+    collapse: options.collapse,
+    summary: options.summary === true
+  }, globalOptions);
+  printResult(result, globalOptions);
+  if (globalOptions.profile) {
+    printError(`profile:command=deps took_ms=${Date.now() - startedAt}`);
+  }
+}
+function registerMutationCommands(program) {
+  const createCommand = program.command("create").argument("[typeOrTitle]", '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("--body-file <path>", "Load the item markdown body from a file (mutually exclusive 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").action(runCreateAction);
+  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").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("--body-file <path>", "Load the item markdown body from a file (mutually exclusive 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("--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-audit-update", "Allow non-owner metadata-only audit updates without requiring --force").option("--allow-audit-dep-update", "Allow non-owner append-only dependency updates without requiring --force").option("--force", "Force ownership override");
   addHiddenOption(updateCommand, "--allow_audit_update", "Alias for --allow-audit-update", false);
   addHiddenOption(updateCommand, "--allow_audit_dep_update", "Alias for --allow-audit-dep-update", false);
-  updateCommand.action(async (id, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    if (typeof options.bodyFile === "string") {
-      options.body = await resolveBodyFileContent(options.bodyFile, options.body !== void 0 ? String(options.body) : void 0);
-      delete options.bodyFile;
-    }
-    const { runUpdate } = await import("./update-KFX2SIAC.js");
-    const result = await runUpdate(id, normalizeUpdateOptions(options), globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=update took_ms=${Date.now() - startedAt}`);
-    }
-  });
+  updateCommand.action(runUpdateAction);
   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>", "Restrict to an explicit comma-separated ID allowlist (intersected with other filters)").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("--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: 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("--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("--allow-audit-update", "Allow non-owner metadata-only audit updates without requiring --force").option("--allow-audit-dep-update", "Allow non-owner append-only dependency updates without requiring --force").option("--author <value>", "Mutation author").option("--message <value>", "Mutation message").option("--force", "Force ownership override");
-  for (const [flags, description] of [
+  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"],
@@ -515,188 +1123,30 @@ function registerMutationCommands(program) {
     ["--allow_audit_update", "Alias for --allow-audit-update"],
     ["--allow_audit_dep_update", "Alias for --allow-audit-dep-update"],
     ["--filter-estimate-missing", "Alias for --filter-estimates-missing"]
-  ]) {
-    addHiddenOption(updateManyCommand, flags, description, false);
-  }
-  for (const [flags, description] of [
+  ], 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"]
-  ]) {
-    addHiddenOption(updateManyCommand, flags, description, true);
-  }
-  updateManyCommand.action(async (options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { runUpdateMany } = await import("./update-many-RNSBX2TA.js");
-    const result = await runUpdateMany({
-      status: typeof options.filterStatus === "string" ? options.filterStatus : void 0,
-      list: buildUpdateManyListOptions(options),
-      update: normalizeUpdateOptions(extractUpdateManyMutationOptionSource(options)),
-      dryRun: options.dryRun === true ? true : void 0,
-      rollback: typeof options.rollback === "string" ? options.rollback : void 0,
-      checkpoint: options.checkpoint === false ? false : void 0
-    }, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=update-many took_ms=${Date.now() - startedAt}`);
-    }
-  });
+  ], 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("-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(async (id, text, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { runClose } = await import("./close-TQYAAFJP.js");
-    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 pickInlineString = (...candidates) => {
-      for (const candidate of candidates) {
-        if (typeof candidate === "string") {
-          return candidate;
-        }
-      }
-      return void 0;
-    };
-    const result = await runClose(id, resolvedText, {
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      validateClose: options.validateClose === true ? "warn" : typeof options.validateClose === "string" ? options.validateClose : void 0,
-      force: Boolean(options.force),
-      duplicateOf: typeof options.duplicateOf === "string" ? options.duplicateOf : void 0,
-      resolution: typeof options.resolution === "string" ? options.resolution : void 0,
-      expectedResult: pickInlineString(options.expectedResult, options.expected_result, options.expected),
-      actualResult: pickInlineString(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}`);
-    }
-  });
+  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>", "Restrict to an explicit comma-separated ID allowlist (intersected with other filters)").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("--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(async (options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const pickString = (...candidates) => {
-      for (const candidate of candidates) {
-        if (typeof candidate === "string") {
-          return candidate;
-        }
-      }
-      return void 0;
-    };
-    const { runCloseMany } = await import("./close-many-LDRVEQY2.js");
-    const result = await runCloseMany({
-      status: typeof options.filterStatus === "string" ? options.filterStatus : void 0,
-      list: {
-        type: typeof options.filterType === "string" ? options.filterType : void 0,
-        tag: typeof options.filterTag === "string" ? options.filterTag : void 0,
-        priority: typeof options.filterPriority === "string" ? options.filterPriority : void 0,
-        deadlineBefore: typeof options.filterDeadlineBefore === "string" ? options.filterDeadlineBefore : void 0,
-        deadlineAfter: typeof options.filterDeadlineAfter === "string" ? options.filterDeadlineAfter : void 0,
-        updatedAfter: typeof options.filterUpdatedAfter === "string" ? options.filterUpdatedAfter : void 0,
-        updatedBefore: typeof options.filterUpdatedBefore === "string" ? options.filterUpdatedBefore : void 0,
-        createdAfter: typeof options.filterCreatedAfter === "string" ? options.filterCreatedAfter : void 0,
-        createdBefore: typeof options.filterCreatedBefore === "string" ? options.filterCreatedBefore : void 0,
-        ids: typeof options.ids === "string" ? options.ids : void 0,
-        assignee: typeof options.filterAssignee === "string" ? options.filterAssignee : void 0,
-        assigneeFilter: pickString(options.filterAssigneeFilter, options.filterAssignee_filter),
-        parent: typeof options.filterParent === "string" ? options.filterParent : void 0,
-        sprint: typeof options.filterSprint === "string" ? options.filterSprint : void 0,
-        release: typeof options.filterRelease === "string" ? options.filterRelease : void 0,
-        ...mapBulkContentAndGovernanceFilters(options),
-        limit: typeof options.limit === "string" ? options.limit : void 0,
-        offset: typeof options.offset === "string" ? options.offset : void 0
-      },
-      reason: typeof options.reason === "string" ? options.reason : void 0,
-      resolution: typeof options.resolution === "string" ? options.resolution : void 0,
-      expectedResult: pickString(options.expectedResult, options.expected_result, options.expected),
-      actualResult: pickString(options.actualResult, options.actual_result, options.actual),
-      validateClose: options.validateClose === true ? "warn" : typeof options.validateClose === "string" ? options.validateClose : void 0,
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      force: Boolean(options.force),
-      dryRun: options.dryRun === true ? true : void 0,
-      rollback: typeof options.rollback === "string" ? options.rollback : void 0,
-      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}`);
-    }
-  });
-  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(async (id, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { runDelete } = await import("./delete-LSVHAB4Y.js");
-    const result = await runDelete(id, {
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      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}`);
-    }
-  });
-  program.command("append").argument("<id>", "Item id").argument("[text]", "Optional body text shorthand (equivalent to --body; use - for 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.").action(async (id, text, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const bodyFromOption = typeof options.body === "string" ? options.body : void 0;
-    const bodyFromAlias = typeof options.text === "string" ? options.text : void 0;
-    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);
-    }
-    const { runAppend } = await import("./append-QCFJSDFL.js");
-    const result = await runAppend(id, {
-      body: resolvedBody,
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      force: Boolean(options.force)
-    }, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=append took_ms=${Date.now() - startedAt}`);
-    }
-  });
-  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(async (id, target, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { runRestore } = await import("./restore-4MHZFJ2E.js");
-    const result = await runRestore(id, target, {
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      force: Boolean(options.force)
-    }, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=restore took_ms=${Date.now() - startedAt}`);
-    }
-  });
+  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]", "Optional body text shorthand (equivalent to --body; use - for 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.").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]", "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("[stepRef]", "Step reference: stable id (plan-step-001) or order integer").argument("[reorderTo]", "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: related|blocks|blocked_by|depends_on|discovered_from|implements|verifies|supersedes").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("--author <value>", "Mutation author").option("--message <value>", "Mutation message").option("--force", "Force ownership override");
-  for (const [flags, description] of [
+  addHiddenOptions(planCommand, [
     ["--resume_context <value>", "Alias for --resume-context"],
     ["--from_search <value>", "Alias for --from-search"],
     ["--step_title <value>", "Alias for --step-title"],
@@ -720,103 +1170,17 @@ function registerMutationCommands(program) {
     ["--materialize_type <value>", "Alias for --materialize-type"],
     ["--materialize_parent <value>", "Alias for --materialize-parent"],
     ["--materialize_tags <value>", "Alias for --materialize-tags"]
-  ]) {
-    addHiddenOption(planCommand, flags, description, false);
-  }
-  for (const [flags, description] of [
+  ], false);
+  addHiddenOptions(planCommand, [
     ["--blocked_by <value>", "Alias for --blocked-by"],
     ["--depends_on <value>", "Alias for --depends-on"]
-  ]) {
-    addHiddenOption(planCommand, flags, description, true);
-  }
-  planCommand.action(async (subcommand, id, stepRef, reorderToken, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { runPlan, PLAN_SUBCOMMANDS } = await import("./plan-RKZHQVXR.js");
-    const normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
-    if (!normalizedSubcommand) {
-      throw new PmCliError(`pm plan requires a subcommand. Allowed: ${PLAN_SUBCOMMANDS.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 (!PLAN_SUBCOMMANDS.includes(normalizedSubcommand)) {
-      const didYouMean = normalizedSubcommand === "list" || normalizedSubcommand === "ls" ? ["pm list --type Plan", "pm list-all --type Plan"] : void 0;
-      throw new PmCliError(`Unknown pm plan subcommand "${subcommand}". Allowed: ${PLAN_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, didYouMean ? { code: "unknown_subcommand", examples: didYouMean } : void 0);
-    }
-    const planOptions = { ...options };
-    const aliasPairs = [
-      ["blocked_by", "blockedBy"],
-      ["resume_context", "resumeContext"],
-      ["from_search", "fromSearch"],
-      // pm-6mit: "step" is no longer folded into stepTitle here — it is a
-      // first-class repeatable option normalized inside runPlan (create
-      // accumulates ordered steps; other subcommands accept a single value
-      // as a stepTitle alias).
-      ["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];
-      }
-    }
-    let reorderTo;
-    if (normalizedSubcommand === "reorder-step" && typeof reorderToken === "string") {
-      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);
-      }
-      reorderTo = parsed;
-    }
-    let planId = id;
-    if (normalizedSubcommand === "create" && typeof id === "string" && id.length > 0 && planOptions.title === void 0) {
-      planOptions.title = id;
-      planId = void 0;
-    }
-    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}`);
-    }
-  });
+  ], 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 { runHistoryRedact } = await import("./history-redact-O3NBCNWC.js");
+    const { runHistoryRedact } = await import("./history-redact-IRL7WJ3E.js");
     const literal = Array.isArray(options.literal) ? options.literal : void 0;
     const regex = Array.isArray(options.regex) ? options.regex : void 0;
     const result = await runHistoryRedact(id, {
@@ -839,7 +1203,7 @@ function registerMutationCommands(program) {
   program.command("history-repair").argument("[id]", "Item id (omit with --all)").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("--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 { runHistoryRepair, runHistoryRepairAll, assertHistoryRepairTarget } = await import("./history-repair-XA3LC4GA.js");
+    const { runHistoryRepair, runHistoryRepairAll, assertHistoryRepairTarget } = await import("./history-repair-4WVBVHFR.js");
     const all = options.all === true;
     assertHistoryRepairTarget(id, all);
     const repairOptions = {
@@ -862,357 +1226,20 @@ function registerMutationCommands(program) {
       printError(`profile:command=history-repair took_ms=${Date.now() - startedAt}`);
     }
   });
-  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: compact an explicit comma-separated list of item ids").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(async (id, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { runHistoryCompact, runHistoryCompactBulk, assertHistoryCompactTarget } = await import("./history-compact-HR7BB4LR.js");
-    const parseNonNegativeIntFlag = (raw, flag) => {
-      if (typeof raw !== "string") {
-        return void 0;
-      }
-      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);
-    };
-    const ids = typeof options.ids === "string" ? splitCommaList(options.ids) : void 0;
-    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" : void 0;
-    const isBulk = ids !== void 0 || allOver !== void 0 || scope !== void 0;
-    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 === void 0) {
-      const result = await runHistoryCompactBulk({
-        ids,
-        scope,
-        allOver,
-        minEntries,
-        dryRun: options.dryRun === true,
-        author: typeof options.author === "string" ? options.author : void 0,
-        message: typeof options.message === "string" ? options.message : void 0,
-        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: typeof options.before === "string" ? options.before : void 0,
-        dryRun: options.dryRun === true,
-        author: typeof options.author === "string" ? options.author : void 0,
-        message: typeof options.message === "string" ? options.message : void 0,
-        force: Boolean(options.force)
-      }, globalOptions);
-      printResult(result, globalOptions);
-    }
-    if (globalOptions.profile) {
-      printError(`profile:command=history-compact took_ms=${Date.now() - startedAt}`);
-    }
-  });
+  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: compact an explicit comma-separated list of item ids").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);
   const schemaCommand = program.command("schema").argument("[subcommand]", "Schema subcommand: list, show, show-status, add-type, remove-type, add-status, remove-status, or a custom item type name shorthand").argument("[name]", "Item type name (add-type/remove-type/show) or status id (show-status/add-status/remove-status)").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").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("--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);
-  schemaCommand.action(async (subcommand, name, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const schemaModule = await import("./schema-73HR2OJW.js");
-    const { SCHEMA_SUBCOMMANDS } = schemaModule;
-    let normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
-    let typeName = name;
-    if (!normalizedSubcommand) {
-      throw new PmCliError(`pm schema requires a subcommand. Allowed: ${SCHEMA_SUBCOMMANDS.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"
-        ]
-      });
-    }
-    const aliases = (
-      /* c8 ignore next -- --alias is registered with commander `collect`, so it is always an array here; the string arm is a defensive guard for non-CLI (programmatic) callers */
-      typeof options.alias === "string" ? [options.alias] : Array.isArray(options.alias) ? options.alias : void 0
-    );
-    const roles = (
-      /* c8 ignore next -- --role is registered with commander `collect`, so it is always an array here; the string arm is a defensive guard for non-CLI (programmatic) callers */
-      typeof options.role === "string" ? [options.role] : Array.isArray(options.role) ? options.role : void 0
-    );
-    const defaultStatus = typeof options.defaultStatus === "string" ? options.defaultStatus : typeof options.default_status === "string" ? options.default_status : void 0;
-    const order = parseSchemaOrderOption(options.order);
-    const splitCollectedCommaList = (raw) => {
-      if (!Array.isArray(raw)) {
-        return void 0;
-      }
-      return raw.flatMap((value) => value.split(",")).map((value) => value.trim()).filter((value) => value.length > 0);
-    };
-    const commands = splitCollectedCommaList(options.commands);
-    const requiredTypes = splitCollectedCommaList(options.requiredTypes);
-    const minCount = parseSchemaOrderOption(options.minCount);
-    if (!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand) && typeName === void 0 && !looksLikeSchemaSubcommandTypo(normalizedSubcommand)) {
-      typeName = subcommand;
-      normalizedSubcommand = "add-type";
-    }
-    if (!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand)) {
-      throw new PmCliError(`Unknown pm schema subcommand "${subcommand}". Allowed: ${SCHEMA_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, { code: "unknown_subcommand" });
-    }
-    const author = typeof options.author === "string" ? options.author : void 0;
-    const force = Boolean(options.force);
-    const description = typeof options.description === "string" ? options.description : void 0;
-    const result = await dispatchSchemaSubcommand(schemaModule, {
-      normalizedSubcommand,
-      typeName,
-      options,
-      aliases,
-      roles,
-      commands,
-      requiredTypes,
-      defaultStatus,
-      order,
-      minCount,
-      author,
-      force,
-      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}`);
-    }
-  });
+  schemaCommand.action(runSchemaAction);
   const profileCommand = program.command("profile").argument("[subcommand]", "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(async (subcommand, name, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const profileModule = await import("./profile-QLER5ENE.js");
-    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 new PmCliError(`Unknown pm profile subcommand "${subcommand}". Allowed: ${PROFILE_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, { code: "unknown_subcommand" });
-    }
-    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}`);
-    }
-  });
-  program.command("comments").argument("<id>", "Item id").argument("[text]", "Optional comment text shorthand (equivalent to --add)").option("--add <text>", "Add one comment entry (plain text fallback, text=<value>, markdown pairs, or - for stdin; CSV-like key fragments are preserved as plain text unless text is explicit)").option("--stdin", "Read comment text from stdin (supports multiline markdown)").option("--file <path>", "Read comment text from file (supports multiline markdown)").option("--edit <index>", "Replace the comment at 1-based <index> (replacement text from positional [text], --add, --stdin, or --file)", parsePositiveIntOption("--edit")).option("--delete <index>", "Delete the comment at 1-based <index>", parsePositiveIntOption("--delete")).option("--limit <n>", "Return only latest n comments").option("--author [value]", "Comment author (optional; falls back to PM_AUTHOR/settings)").option("--message <value>", "History message").option("--allow-audit-comment", "Allow non-owner append-only comment audits (add/edit/delete) without requiring --force").option("--force", "Force ownership override").description("List, add, edit, or delete comments for an item.").action(async (id, text, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const editIndex = typeof options.edit === "number" ? options.edit : void 0;
-    const deleteIndex = typeof options.delete === "number" ? options.delete : void 0;
-    const addFromOption = typeof options.add === "string" ? options.add : void 0;
-    const addFromPositional = typeof text === "string" ? text : void 0;
-    const readFromStdin = options.stdin === true;
-    const readFromFile = typeof options.file === "string" ? options.file : void 0;
-    const sourceCount = Number(addFromOption !== void 0) + Number(addFromPositional !== void 0) + Number(readFromStdin) + Number(readFromFile !== void 0);
-    if (sourceCount > 1) {
-      if (addFromOption !== void 0 && addFromPositional !== void 0 && !readFromStdin && readFromFile === void 0) {
-        throw new PmCliError("Specify comment text either as positional [text] or with --add, not both", EXIT_CODE.USAGE);
-      }
-      throw new PmCliError("Specify comment text with exactly one source: positional [text], --add, --stdin, or --file", EXIT_CODE.USAGE);
-    }
-    const add = addFromOption ?? addFromPositional;
-    const { runComments } = await import("./comments-QCKR2YY2.js");
-    const result = await runComments(id, {
-      add,
-      stdin: readFromStdin,
-      file: readFromFile,
-      edit: editIndex,
-      delete: deleteIndex,
-      limit: typeof options.limit === "string" ? options.limit : void 0,
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      allowAuditComment: Boolean(options.allowAuditComment),
-      force: Boolean(options.force)
-    }, globalOptions);
-    const isMutation = typeof add === "string" || readFromStdin || readFromFile !== void 0 || editIndex !== void 0 || deleteIndex !== void 0;
-    if (isMutation) {
-      await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=comments took_ms=${Date.now() - startedAt}`);
-    }
-  });
-  program.command("notes").argument("<id>", "Item id").argument("[text]", "Optional note text shorthand (equivalent to --add; use - for stdin)").option("--add <text>", "Add one note entry (plain text fallback, text=<value>, markdown pairs, or - for stdin; CSV-like key fragments are preserved as plain text unless text is explicit)").option("--limit <n>", "Return only latest n notes").option("--author [value]", "Note author (optional; falls back to PM_AUTHOR/settings)").option("--message <value>", "History message").option("--allow-audit-note", "Allow non-owner append-only note audits without requiring --force").option("--allow-audit-comment", "Backward-compatible alias for --allow-audit-note").option("--force", "Force ownership override").description("List or add notes for an item.").action(async (id, text, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const addFromOption = typeof options.add === "string" ? options.add : void 0;
-    const addFromPositional = typeof text === "string" ? text : void 0;
-    if (addFromOption !== void 0 && addFromPositional !== void 0) {
-      throw new PmCliError("Specify note text either as positional [text] or with --add, not both", EXIT_CODE.USAGE);
-    }
-    const add = addFromOption ?? addFromPositional;
-    const { runNotes } = await import("./notes-6KTGO2OJ.js");
-    const result = await runNotes(id, {
-      add,
-      limit: typeof options.limit === "string" ? options.limit : void 0,
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      allowAuditComment: Boolean(options.allowAuditNote || options.allowAuditComment),
-      force: Boolean(options.force)
-    }, globalOptions);
-    if (typeof add === "string") {
-      await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=notes took_ms=${Date.now() - startedAt}`);
-    }
-  });
-  program.command("learnings").argument("<id>", "Item id").argument("[text]", "Optional learning text shorthand (equivalent to --add; use - for stdin)").option("--add <text>", "Add one learning entry (plain text fallback, text=<value>, markdown pairs, or - for stdin; CSV-like key fragments are preserved as plain text unless text is explicit)").option("--limit <n>", "Return only latest n learnings").option("--author [value]", "Learning author (optional; falls back to PM_AUTHOR/settings)").option("--message <value>", "History message").option("--allow-audit-learning", "Allow non-owner append-only learning audits without requiring --force").option("--allow-audit-comment", "Backward-compatible alias for --allow-audit-learning").option("--force", "Force ownership override").description("List or add learnings for an item.").action(async (id, text, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const addFromOption = typeof options.add === "string" ? options.add : void 0;
-    const addFromPositional = typeof text === "string" ? text : void 0;
-    if (addFromOption !== void 0 && addFromPositional !== void 0) {
-      throw new PmCliError("Specify learning text either as positional [text] or with --add, not both", EXIT_CODE.USAGE);
-    }
-    const add = addFromOption ?? addFromPositional;
-    const { runLearnings } = await import("./learnings-LPKCSJX7.js");
-    const result = await runLearnings(id, {
-      add,
-      limit: typeof options.limit === "string" ? options.limit : void 0,
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      allowAuditComment: Boolean(options.allowAuditLearning || options.allowAuditComment),
-      force: Boolean(options.force)
-    }, globalOptions);
-    if (typeof add === "string") {
-      await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=learnings took_ms=${Date.now() - startedAt}`);
-    }
-  });
+  profileCommand.action(runProfileAction);
+  program.command("comments").argument("<id>", "Item id").argument("[text]", "Optional comment text shorthand (equivalent to --add)").option("--add <text>", "Add one comment entry (plain text fallback, text=<value>, markdown pairs, or - for stdin; CSV-like key fragments are preserved as plain text unless text is explicit)").option("--stdin", "Read comment text from stdin (supports multiline markdown)").option("--file <path>", "Read comment text from file (supports multiline markdown)").option("--edit <index>", "Replace the comment at 1-based <index> (replacement text from positional [text], --add, --stdin, or --file)", parsePositiveIntOption("--edit")).option("--delete <index>", "Delete the comment at 1-based <index>", parsePositiveIntOption("--delete")).option("--limit <n>", "Return only latest n comments").option("--author [value]", "Comment author (optional; falls back to PM_AUTHOR/settings)").option("--message <value>", "History message").option("--allow-audit-comment", "Allow non-owner append-only comment audits (add/edit/delete) without requiring --force").option("--force", "Force ownership override").description("List, add, edit, or delete comments for an item.").action(runCommentsAction);
+  program.command("notes").argument("<id>", "Item id").argument("[text]", "Optional note text shorthand (equivalent to --add; use - for stdin)").option("--add <text>", "Add one note entry (plain text fallback, text=<value>, markdown pairs, or - for stdin; CSV-like key fragments are preserved as plain text unless text is explicit)").option("--limit <n>", "Return only latest n notes").option("--author [value]", "Note author (optional; falls back to PM_AUTHOR/settings)").option("--message <value>", "History message").option("--allow-audit-note", "Allow non-owner append-only note audits without requiring --force").option("--allow-audit-comment", "Backward-compatible alias for --allow-audit-note").option("--force", "Force ownership override").description("List or add notes for an item.").action(runNotesAction);
+  program.command("learnings").argument("<id>", "Item id").argument("[text]", "Optional learning text shorthand (equivalent to --add; use - for stdin)").option("--add <text>", "Add one learning entry (plain text fallback, text=<value>, markdown pairs, or - for stdin; CSV-like key fragments are preserved as plain text unless text is explicit)").option("--limit <n>", "Return only latest n learnings").option("--author [value]", "Learning author (optional; falls back to PM_AUTHOR/settings)").option("--message <value>", "History message").option("--allow-audit-learning", "Allow non-owner append-only learning audits without requiring --force").option("--allow-audit-comment", "Backward-compatible alias for --allow-audit-learning").option("--force", "Force ownership override").description("List or add learnings for an item.").action(runLearningsAction);
   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("--audit", "Audit linked file usage across all items for this item's linked paths").option("--author <value>", "Mutation author").option("--message <value>", "History message").option("--force", "Force ownership override").action(async (id, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const addValues = Array.isArray(options.add) ? options.add : [];
-    const addGlobValues = Array.isArray(options.addGlob) ? options.addGlob : [];
-    const removeValues = Array.isArray(options.remove) ? options.remove : [];
-    const migrateValues = Array.isArray(options.migrate) ? options.migrate : [];
-    const { runFiles } = await import("./files-NQHEXUZD.js");
-    const result = await runFiles(id, {
-      add: addValues,
-      addGlob: addGlobValues,
-      remove: removeValues,
-      migrate: migrateValues,
-      note: typeof options.note === "string" ? options.note : void 0,
-      list: Boolean(options.list),
-      appendStable: Boolean(options.appendStable),
-      validatePaths: Boolean(options.validatePaths),
-      audit: Boolean(options.audit),
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      force: Boolean(options.force)
-    }, globalOptions);
-    if (addValues.length > 0 || addGlobValues.length > 0 || removeValues.length > 0 || migrateValues.length > 0) {
-      await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=files took_ms=${Date.now() - startedAt}`);
-    }
-  });
-  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(async (id, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const mergedOptions = { ...command.optsWithGlobals(), ...options };
-    const { runFilesDiscover } = await import("./files-NQHEXUZD.js");
-    const result = await runFilesDiscover(id, {
-      apply: Boolean(mergedOptions.apply),
-      note: typeof mergedOptions.note === "string" ? mergedOptions.note : void 0,
-      appendStable: Boolean(mergedOptions.appendStable),
-      author: typeof mergedOptions.author === "string" ? mergedOptions.author : void 0,
-      message: typeof mergedOptions.message === "string" ? mergedOptions.message : void 0,
-      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}`);
-    }
-  });
-  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("--audit", "Audit linked doc usage across all items for this item's linked paths").option("--author <value>", "Mutation author").option("--message <value>", "History message").option("--force", "Force ownership override").description("Manage docs linked to an item.").action(async (id, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const addValues = Array.isArray(options.add) ? options.add : [];
-    const addGlobValues = Array.isArray(options.addGlob) ? options.addGlob : [];
-    const removeValues = Array.isArray(options.remove) ? options.remove : [];
-    const migrateValues = Array.isArray(options.migrate) ? options.migrate : [];
-    const { runDocs } = await import("./docs-GYZNVS26.js");
-    const result = await runDocs(id, {
-      add: addValues,
-      addGlob: addGlobValues,
-      remove: removeValues,
-      migrate: migrateValues,
-      note: typeof options.note === "string" ? options.note : void 0,
-      list: Boolean(options.list),
-      validatePaths: Boolean(options.validatePaths),
-      audit: Boolean(options.audit),
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      force: Boolean(options.force)
-    }, globalOptions);
-    if (addValues.length > 0 || addGlobValues.length > 0 || removeValues.length > 0 || migrateValues.length > 0) {
-      await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=docs took_ms=${Date.now() - startedAt}`);
-    }
-  });
-  program.command("deps").argument("<id>", "Item id").option("--format <value>", "Output format (tree or graph)", "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").description("Show dependency relationships for an item.").action(async (id, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { runDeps } = await import("./deps-4UDFJRUA.js");
-    const result = await runDeps(id, {
-      format: options.format,
-      maxDepth: typeof options.maxDepth === "string" ? options.maxDepth : void 0,
-      collapse: options.collapse,
-      summary: options.summary === true
-    }, globalOptions);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=deps took_ms=${Date.now() - startedAt}`);
-    }
-  });
+  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("--audit", "Audit linked file usage across all items for this item's linked paths").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);
+  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("--audit", "Audit linked doc usage across all items for this item's linked paths").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 or graph)", "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").description("Show dependency relationships for an item.").action(runDepsAction);
 }
 export {
   looksLikeSchemaSubcommandTypo,
@@ -1221,6 +1248,6 @@ export {
   registerCommanderOptionContracts,
   registerMutationCommands
 };
-//# sourceMappingURL=register-mutation-ENNDUAZG.js.map
+//# sourceMappingURL=register-mutation-SJWMVIJ2.js.map
 
-//# debugId=83d6617e-974e-5c3a-904a-d8671268dbd1
+//# debugId=919c1fe0-eaf0-51d1-9788-48d73b423eb3