@unbrained/pm-cli 2026.6.13 → 2026.6.17

package/dist/cli-bundle/chunks/{register-mutation-QKFPTIZG.js → register-mutation-6UCOEQ6L.js}

@@ -6,31 +6,73 @@ import {
   invalidateSearchCachesForMutation,
   normalizeCreateOptions,
   normalizeUpdateOptions
-} from "./chunk-JWXTOYBI.js";
+} from "./chunk-G2MOUCTU.js";
 import {
   CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,
   UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS
-} from "./chunk-7CRFV6JR.js";
-import "./chunk-PEH7SZD2.js";
+} from "./chunk-VXHMQDXA.js";
+import "./chunk-YLAW3FZN.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunk-O3YCJOVX.js";
-import "./chunk-XXLMJDUB.js";
-import "./chunk-LGOXXQUW.js";
-import "./chunk-MACCNKSZ.js";
-import "./chunk-W6KNFAMZ.js";
-import "./chunk-IXVSSHGV.js";
+} from "./chunk-R4AKUPKI.js";
+import "./chunk-KA22USXD.js";
+import "./chunk-5XGWFUW2.js";
+import "./chunk-TBV33CB4.js";
+import "./chunk-QXMXRPX5.js";
+import "./chunk-LNH5Q32E.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
   PmCliError
-} from "./chunk-LFW5NQUP.js";
+} from "./chunk-CHM2VFVL.js";
 
 // dist/cli/register-mutation.js
 import { Option } from "commander";
 
+// dist/core/io/body-file.js
+import { readFile } from "node:fs/promises";
+!(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] = "0f24c814-7ca3-557a-90fa-187e399521e9");
+  } catch (e2) {
+  }
+})();
+var defaultBodyFileReader = (path) => readFile(path, "utf8");
+async function resolveBodyFileContent(bodyFile, inlineBody, readFileImpl = defaultBodyFileReader) {
+  if (inlineBody !== void 0) {
+    throw new PmCliError("--body and --body-file are mutually exclusive; provide the body inline with --body or from a file with --body-file, not both.", EXIT_CODE.USAGE, {
+      code: "body_file_conflicts_with_body",
+      required: "Choose exactly one body source.",
+      why: "Both --body and --body-file set the item body; allowing both would make the effective body ambiguous.",
+      nextSteps: ["Re-run with only --body <text> or only --body-file <path>."]
+    });
+  }
+  const path = bodyFile.trim();
+  if (path.length === 0) {
+    throw new PmCliError("--body-file requires a file path.", EXIT_CODE.USAGE, {
+      code: "body_file_missing_path",
+      required: "Pass a readable file path: --body-file <path>.",
+      why: "An empty --body-file value has no file to read the body from."
+    });
+  }
+  try {
+    return await readFileImpl(path);
+  } catch (error) {
+    const errno = error?.code;
+    const isDirectory = errno === "EISDIR";
+    const detail = errno ? ` (${errno})` : "";
+    throw new PmCliError(isDirectory ? `--body-file "${path}" is a directory, not a file. Point it at a readable file.` : `--body-file could not read "${path}"${detail}. Check that the file exists and is readable.`, EXIT_CODE.NOT_FOUND, {
+      code: "body_file_unreadable",
+      required: "Point --body-file at an existing, readable file.",
+      why: `The body content is loaded from the file at the supplied path, so an unreadable path cannot produce a body${errno ? ` (underlying error: ${errno})` : ""}.`,
+      nextSteps: [`Verify the path: ls -l "${path}"`, "Or pass the body inline with --body <text>."]
+    });
+  }
+}
+
 // dist/core/shared/option-alias-visibility.js
 !(function() {
   try {
@@ -66,7 +108,7 @@ function isPureSnakeCaseAlias(canonicalFlagSpec, aliasFlagSpec) {
 !(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] = "07f90455-c9f8-5cb9-86fe-be98e72908cb");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "e38412ec-cbfb-5416-8790-6ca1958f596b");
   } catch (e2) {
   }
 })();
@@ -100,6 +142,175 @@ function parseSchemaOrderOption(raw) {
   }
   throw new PmCliError("--order must be a finite integer.", EXIT_CODE.USAGE);
 }
+async function dispatchSchemaSubcommand(schema, inputs) {
+  const { normalizedSubcommand, typeName, options, globalOptions } = inputs;
+  const { author, force, description } = inputs;
+  switch (normalizedSubcommand) {
+    case "list":
+      return schema.runSchemaList(globalOptions);
+    case "show":
+      return schema.runSchemaShow(typeName, globalOptions);
+    case "show-status":
+      return schema.runSchemaShowStatus(typeName, globalOptions);
+    case "list-fields":
+      return schema.runSchemaListFields(globalOptions);
+    case "show-field":
+      return schema.runSchemaShowField(typeName, globalOptions);
+    case "remove-type":
+      return schema.runSchemaRemoveType(typeName, { author, force }, globalOptions);
+    case "remove-field":
+      return schema.runSchemaRemoveField(typeName, { author, force }, globalOptions);
+    case "apply-preset":
+      return schema.runSchemaApplyPreset(typeName, { author, force }, globalOptions);
+    case "add-field":
+      return schema.runSchemaAddField(typeName, {
+        type: typeof options.type === "string" ? options.type : void 0,
+        commands: inputs.commands,
+        description,
+        cliFlag: typeof options.cliFlag === "string" ? options.cliFlag : void 0,
+        alias: inputs.aliases,
+        required: Boolean(options.required),
+        requiredOnCreate: Boolean(options.requiredOnCreate),
+        // commander stores --no-allow-unset as allowUnset:false; the default
+        // (flag omitted) is true. Forward the tri-state faithfully.
+        allowUnset: options.allowUnset !== false,
+        requiredTypes: inputs.requiredTypes,
+        author,
+        force
+      }, globalOptions);
+    case "add-status":
+      return schema.runSchemaAddStatus(typeName, { role: inputs.roles, alias: inputs.aliases, description, order: inputs.order, author, force }, globalOptions);
+    case "remove-status":
+      return schema.runSchemaRemoveStatus(typeName, { author, force }, globalOptions);
+    default:
+      if (options.infer === true) {
+        return schema.runSchemaInferTypes({ minCount: inputs.minCount, apply: Boolean(options.apply), author, force }, globalOptions);
+      }
+      return schema.runSchemaAddType(typeName, {
+        description,
+        defaultStatus: inputs.defaultStatus,
+        folder: typeof options.folder === "string" ? options.folder : void 0,
+        alias: inputs.aliases,
+        author,
+        force
+      }, globalOptions);
+  }
+}
+function renderSchemaResultHuman(schema, result) {
+  switch (result.action) {
+    case "list":
+      writeStdout(`${schema.formatSchemaListHuman(result)}
+`);
+      return;
+    case "show":
+      writeStdout(`${schema.formatSchemaShowHuman(result)}
+`);
+      return;
+    case "show-status":
+      writeStdout(`${schema.formatSchemaShowStatusHuman(result)}
+`);
+      return;
+    case "list-fields":
+      writeStdout(`${schema.formatSchemaListFieldsHuman(result)}
+`);
+      return;
+    case "show-field":
+      writeStdout(`${schema.formatSchemaShowFieldHuman(result)}
+`);
+      return;
+    case "remove-type":
+      writeStdout(`${schema.formatSchemaRemoveTypeHuman(result)}
+`);
+      break;
+    case "remove-field":
+      writeStdout(`${schema.formatSchemaRemoveFieldHuman(result)}
+`);
+      break;
+    case "apply-preset":
+      writeStdout(`${schema.formatSchemaApplyPresetHuman(result)}
+`);
+      break;
+    case "infer-types":
+      writeStdout(`${schema.formatSchemaInferTypesHuman(result)}
+`);
+      break;
+    case "add-field":
+      writeStdout(`${schema.formatSchemaAddFieldHuman(result)}
+`);
+      break;
+    case "add-status":
+      writeStdout(`${schema.formatSchemaAddStatusHuman(result)}
+`);
+      break;
+    case "remove-status":
+      writeStdout(`${schema.formatSchemaRemoveStatusHuman(result)}
+`);
+      break;
+    default:
+      writeStdout(`${schema.formatSchemaAddTypeHuman(result)}
+`);
+      break;
+  }
+  if (result.warnings.length > 0) {
+    printError(`schema ${result.action} warnings: ${formatHookWarnings(result.warnings)}`);
+  }
+}
+function parsePositiveIntOption(flag) {
+  return (value) => {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+      throw new PmCliError(`${flag} must be a positive integer (1-based index).`, EXIT_CODE.USAGE);
+    }
+    return parsed;
+  };
+}
+function registerBulkContentAndGovernanceFilters(command, action) {
+  command.option("--filter-has-notes", `Select only items that have notes before ${action}`).option("--filter-no-notes", `Select only items that have no notes before ${action}`).option("--filter-has-learnings", `Select only items that have learnings before ${action}`).option("--filter-no-learnings", `Select only items that have no learnings before ${action}`).option("--filter-has-files", `Select only items that have linked files before ${action}`).option("--filter-no-files", `Select only items that have no linked files before ${action}`).option("--filter-has-docs", `Select only items that have linked docs before ${action}`).option("--filter-no-docs", `Select only items that have no linked docs before ${action}`).option("--filter-has-tests", `Select only items that have linked tests before ${action}`).option("--filter-no-tests", `Select only items that have no linked tests before ${action}`).option("--filter-has-comments", `Select only items that have comments before ${action}`).option("--filter-no-comments", `Select only items that have no comments before ${action}`).option("--filter-has-deps", `Select only items that have dependencies before ${action}`).option("--filter-no-deps", `Select only items that have no dependencies before ${action}`).option("--filter-has-body", `Select only items that have a non-empty body before ${action}`).option("--filter-empty-body", `Select only items with an empty body before ${action}`).option("--filter-has-linked-command", `Select only items whose linked tests carry a runnable command before ${action}`).option("--filter-no-linked-command", `Select only items whose linked tests carry no runnable command before ${action}`).option("--filter-reviewer-missing", `Select only items missing reviewer before ${action}`).option("--filter-risk-missing", `Select only items missing risk before ${action}`).option("--filter-confidence-missing", `Select only items missing confidence before ${action}`).option("--filter-sprint-missing", `Select only items missing sprint before ${action}`).option("--filter-release-missing", `Select only items missing release before ${action}`);
+}
+var BULK_CONTENT_FILTER_CONFLICTS = [
+  ["filterHasNotes", "filterNoNotes", "--filter-has-notes", "--filter-no-notes"],
+  ["filterHasLearnings", "filterNoLearnings", "--filter-has-learnings", "--filter-no-learnings"],
+  ["filterHasFiles", "filterNoFiles", "--filter-has-files", "--filter-no-files"],
+  ["filterHasDocs", "filterNoDocs", "--filter-has-docs", "--filter-no-docs"],
+  ["filterHasTests", "filterNoTests", "--filter-has-tests", "--filter-no-tests"],
+  ["filterHasComments", "filterNoComments", "--filter-has-comments", "--filter-no-comments"],
+  ["filterHasDeps", "filterNoDeps", "--filter-has-deps", "--filter-no-deps"],
+  ["filterHasBody", "filterEmptyBody", "--filter-has-body", "--filter-empty-body"],
+  ["filterHasLinkedCommand", "filterNoLinkedCommand", "--filter-has-linked-command", "--filter-no-linked-command"]
+];
+function mapBulkContentAndGovernanceFilters(options) {
+  const presence = (key) => options[key] === true ? true : void 0;
+  for (const [hasKey, noKey, hasFlag, noFlag] of BULK_CONTENT_FILTER_CONFLICTS) {
+    if (options[hasKey] === true && options[noKey] === true) {
+      throw new PmCliError(`Cannot combine ${hasFlag} with ${noFlag} for the same field.`, EXIT_CODE.USAGE);
+    }
+  }
+  return {
+    filterReviewerMissing: presence("filterReviewerMissing"),
+    filterRiskMissing: presence("filterRiskMissing"),
+    filterConfidenceMissing: presence("filterConfidenceMissing"),
+    filterSprintMissing: presence("filterSprintMissing"),
+    filterReleaseMissing: presence("filterReleaseMissing"),
+    hasNotes: presence("filterHasNotes"),
+    hasLearnings: presence("filterHasLearnings"),
+    hasFiles: presence("filterHasFiles"),
+    hasDocs: presence("filterHasDocs"),
+    hasTests: presence("filterHasTests"),
+    hasComments: presence("filterHasComments"),
+    hasDeps: presence("filterHasDeps"),
+    hasBody: presence("filterHasBody"),
+    hasLinkedCommand: presence("filterHasLinkedCommand"),
+    noNotes: presence("filterNoNotes"),
+    noLearnings: presence("filterNoLearnings"),
+    noFiles: presence("filterNoFiles"),
+    noDocs: presence("filterNoDocs"),
+    noTests: presence("filterNoTests"),
+    noComments: presence("filterNoComments"),
+    noDeps: presence("filterNoDeps"),
+    emptyBody: presence("filterEmptyBody"),
+    noLinkedCommand: presence("filterNoLinkedCommand")
+  };
+}
 function registerCommanderOptionContracts(command, contracts) {
   for (const contract of contracts) {
     if (contract.required) {
@@ -120,10 +331,38 @@ function registerCommanderOptionContracts(command, contracts) {
     }
   }
 }
+function buildUpdateManyListOptions(options) {
+  const readString = (key) => typeof options[key] === "string" ? options[key] : void 0;
+  return {
+    type: readString("filterType"),
+    tag: readString("filterTag"),
+    priority: readString("filterPriority"),
+    deadlineBefore: readString("filterDeadlineBefore"),
+    deadlineAfter: readString("filterDeadlineAfter"),
+    updatedAfter: readString("filterUpdatedAfter"),
+    updatedBefore: readString("filterUpdatedBefore"),
+    createdAfter: readString("filterCreatedAfter"),
+    createdBefore: readString("filterCreatedBefore"),
+    ids: readString("ids"),
+    assignee: readString("filterAssignee"),
+    assigneeFilter: readString("filterAssigneeFilter") ?? readString("filterAssignee_filter"),
+    parent: readString("filterParent"),
+    sprint: readString("filterSprint"),
+    release: readString("filterRelease"),
+    filterAcMissing: options.filterAcMissing === true ? true : void 0,
+    filterEstimatesMissing: options.filterEstimatesMissing === true || options.filterEstimateMissing === true ? true : void 0,
+    filterResolutionMissing: options.filterResolutionMissing === true ? true : void 0,
+    filterMetadataMissing: options.filterMetadataMissing === true ? true : void 0,
+    ...mapBulkContentAndGovernanceFilters(options),
+    limit: readString("limit"),
+    offset: readString("offset"),
+    includeBody: true
+  };
+}
 function 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("--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) => {
+  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;
@@ -132,7 +371,12 @@ function registerMutationCommands(program) {
       positionalType = typeOrTitle;
       positionalTitle = secondTitle;
     } else if (typeof typeOrTitle === "string" && typeOrTitle.length > 0) {
-      positionalTitle = typeOrTitle;
+      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();
@@ -154,8 +398,12 @@ function registerMutationCommands(program) {
     if (typeof positionalTitle === "string" && positionalTitle.length > 0 && options.title === void 0) {
       options.title = 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-NW3K7LVG.js");
+    const { runCreate } = await import("./create-RTRFW6RE.js");
     const result = await runCreate(normalized, globalOptions);
     await invalidateSearchCachesForMutation(globalOptions, result);
     printResult(result, globalOptions);
@@ -166,7 +414,7 @@ function registerMutationCommands(program) {
   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-EB3MUCSW.js");
+    const { runCopy } = await import("./copy-Q2PPU4AY.js");
     const result = await runCopy(id, {
       title: typeof options.title === "string" ? options.title : void 0,
       author: typeof options.author === "string" ? options.author : void 0,
@@ -178,15 +426,29 @@ function registerMutationCommands(program) {
       printError(`profile:command=copy took_ms=${Date.now() - startedAt}`);
     }
   });
+  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-ZMDP4FEL.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}`);
+    }
+  });
   const updateCommand = program.command("update").argument("<id>", "Item id").description("Update item fields and metadata.");
   registerCommanderOptionContracts(updateCommand, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);
-  updateCommand.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");
+  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();
-    const { runUpdate } = await import("./update-PD46VOXI.js");
+    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-MIWEJC76.js");
     const result = await runUpdate(id, normalizeUpdateOptions(options), globalOptions);
     await invalidateSearchCachesForMutation(globalOptions, result);
     printResult(result, globalOptions);
@@ -194,7 +456,9 @@ function registerMutationCommands(program) {
       printError(`profile:command=update took_ms=${Date.now() - startedAt}`);
     }
   });
-  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("--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");
+  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 [
     ["--filter-assignee_filter <value>", "Alias for --filter-assignee-filter"],
     ["--estimated_minutes <value>", "Alias for --estimated-minutes"],
@@ -211,7 +475,8 @@ function registerMutationCommands(program) {
     ["--fixed_version <value>", "Alias for --fixed-version"],
     ["--customer_impact <value>", "Alias for --customer-impact"],
     ["--allow_audit_update", "Alias for --allow-audit-update"],
-    ["--allow_audit_dep_update", "Alias for --allow-audit-dep-update"]
+    ["--allow_audit_dep_update", "Alias for --allow-audit-dep-update"],
+    ["--filter-estimate-missing", "Alias for --filter-estimates-missing"]
   ]) {
     addHiddenOption(updateManyCommand, flags, description, false);
   }
@@ -226,29 +491,10 @@ function registerMutationCommands(program) {
   updateManyCommand.action(async (options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runUpdateMany } = await import("./update-many-724JCVDE.js");
+    const { runUpdateMany } = await import("./update-many-5B4HLVBK.js");
     const result = await runUpdateMany({
       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: typeof options.filterAssigneeFilter === "string" ? options.filterAssigneeFilter : typeof options.filterAssignee_filter === "string" ? options.filterAssignee_filter : void 0,
-        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,
-        limit: typeof options.limit === "string" ? options.limit : void 0,
-        offset: typeof options.offset === "string" ? options.offset : void 0,
-        includeBody: true
-      },
+      list: buildUpdateManyListOptions(options),
       update: normalizeUpdateOptions(extractUpdateManyMutationOptionSource(options)),
       dryRun: options.dryRun === true ? true : void 0,
       rollback: typeof options.rollback === "string" ? options.rollback : void 0,
@@ -260,13 +506,13 @@ function registerMutationCommands(program) {
       printError(`profile:command=update-many took_ms=${Date.now() - startedAt}`);
     }
   });
-  const closeCommand = program.command("close").argument("<id>", "Item id").argument("[text]", "Close reason text (alias: --reason)").option("--reason <value>", "Close reason text (alias for positional <text>)").option("--close-reason <value>", "Close reason text (alias for positional <text>)").option("--duplicate-of <id>", "Close as a duplicate of the canonical item id and auto-fill duplicate closure metadata").option("--author <value>", "Mutation author").option("--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.");
+  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-WOG5WTMZ.js");
+    const { runClose } = await import("./close-I7PRQ5G7.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) => {
@@ -293,7 +539,9 @@ function registerMutationCommands(program) {
       printError(`profile:command=close took_ms=${Date.now() - startedAt}`);
     }
   });
-  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").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");
+  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);
@@ -308,7 +556,7 @@ function registerMutationCommands(program) {
       }
       return void 0;
     };
-    const { runCloseMany } = await import("./close-many-GL6NRUU5.js");
+    const { runCloseMany } = await import("./close-many-TXABDCSJ.js");
     const result = await runCloseMany({
       status: typeof options.filterStatus === "string" ? options.filterStatus : void 0,
       list: {
@@ -327,6 +575,7 @@ function registerMutationCommands(program) {
         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
       },
@@ -351,7 +600,7 @@ function registerMutationCommands(program) {
   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-X5QLXIQX.js");
+    const { runDelete } = await import("./delete-T6DJSUJI.js");
     const result = await runDelete(id, {
       author: typeof options.author === "string" ? options.author : void 0,
       message: typeof options.message === "string" ? options.message : void 0,
@@ -380,7 +629,7 @@ function registerMutationCommands(program) {
     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-N2AWXKZC.js");
+    const { runAppend } = await import("./append-HSPK4L4V.js");
     const result = await runAppend(id, {
       body: resolvedBody,
       author: typeof options.author === "string" ? options.author : void 0,
@@ -396,7 +645,7 @@ function registerMutationCommands(program) {
   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-DRBNXJJH.js");
+    const { runRestore } = await import("./restore-XQXICL3V.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,
@@ -445,7 +694,7 @@ function registerMutationCommands(program) {
   planCommand.action(async (subcommand, id, stepRef, reorderToken, options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runPlan, PLAN_SUBCOMMANDS } = await import("./plan-NANUWH4T.js");
+    const { runPlan, PLAN_SUBCOMMANDS } = await import("./plan-4LF4AV63.js");
     const normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
     if (!normalizedSubcommand) {
       throw new PmCliError(`pm plan requires a subcommand. Allowed: ${PLAN_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, {
@@ -529,7 +778,7 @@ function registerMutationCommands(program) {
   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-75KIIJUJ.js");
+    const { runHistoryRedact } = await import("./history-redact-WZZ6GZ2Z.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, {
@@ -552,7 +801,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-UCYS55ZX.js");
+    const { runHistoryRepair, runHistoryRepairAll, assertHistoryRepairTarget } = await import("./history-repair-GQN2X4TR.js");
     const all = options.all === true;
     assertHistoryRepairTarget(id, all);
     const repairOptions = {
@@ -578,7 +827,7 @@ function registerMutationCommands(program) {
   program.command("history-compact").argument("<id>", "Item id").option("--before <value>", "Compact entries strictly before this version number or ISO timestamp").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 an item history stream into a synthetic baseline plus retained tail entries.").action(async (id, options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runHistoryCompact } = await import("./history-compact-WQZQ6KXM.js");
+    const { runHistoryCompact } = await import("./history-compact-24VQ63A3.js");
     const result = await runHistoryCompact(id, {
       before: typeof options.before === "string" ? options.before : void 0,
       dryRun: options.dryRun === true,
@@ -591,12 +840,13 @@ function registerMutationCommands(program) {
       printError(`profile:command=history-compact took_ms=${Date.now() - startedAt}`);
     }
   });
-  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 or status").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 or status (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("--author <value>", "Mutation author").option("--force", "Force ownership/lock override").description("Inspect and manage config-driven runtime schema.");
+  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 { runSchemaAddType, runSchemaRemoveType, runSchemaAddStatus, runSchemaRemoveStatus, runSchemaList, runSchemaShow, runSchemaShowStatus, formatSchemaAddTypeHuman, formatSchemaRemoveTypeHuman, formatSchemaAddStatusHuman, formatSchemaRemoveStatusHuman, formatSchemaListHuman, formatSchemaShowHuman, formatSchemaShowStatusHuman, SCHEMA_SUBCOMMANDS } = await import("./schema-RNVJ55V2.js");
+    const schemaModule = await import("./schema-TSBYSEMW.js");
+    const { SCHEMA_SUBCOMMANDS } = schemaModule;
     let normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
     let typeName = name;
     if (!normalizedSubcommand) {
@@ -609,14 +859,33 @@ function registerMutationCommands(program) {
           '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 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 = typeof options.alias === "string" ? [options.alias] : Array.isArray(options.alias) ? options.alias : void 0;
-    const roles = typeof options.role === "string" ? [options.role] : Array.isArray(options.role) ? options.role : void 0;
+    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 splitCommaList = (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 = splitCommaList(options.commands);
+    const requiredTypes = splitCommaList(options.requiredTypes);
+    const minCount = parseSchemaOrderOption(options.minCount);
     if (!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand) && typeName === void 0) {
       typeName = subcommand;
       normalizedSubcommand = "add-type";
@@ -626,57 +895,37 @@ function registerMutationCommands(program) {
     }
     const author = typeof options.author === "string" ? options.author : void 0;
     const force = Boolean(options.force);
-    const result = normalizedSubcommand === "list" ? await runSchemaList(globalOptions) : normalizedSubcommand === "show" ? await runSchemaShow(typeName, globalOptions) : normalizedSubcommand === "show-status" ? await runSchemaShowStatus(typeName, globalOptions) : normalizedSubcommand === "remove-type" ? await runSchemaRemoveType(typeName, { author, force }, globalOptions) : normalizedSubcommand === "add-status" ? await runSchemaAddStatus(typeName, {
-      role: roles,
-      alias: aliases,
-      description: typeof options.description === "string" ? options.description : void 0,
-      order,
-      author,
-      force
-    }, globalOptions) : normalizedSubcommand === "remove-status" ? await runSchemaRemoveStatus(typeName, { author, force }, globalOptions) : await runSchemaAddType(typeName, {
-      description: typeof options.description === "string" ? options.description : void 0,
+    const description = typeof options.description === "string" ? options.description : void 0;
+    const result = await dispatchSchemaSubcommand(schemaModule, {
+      normalizedSubcommand,
+      typeName,
+      options,
+      aliases,
+      roles,
+      commands,
+      requiredTypes,
       defaultStatus,
-      folder: typeof options.folder === "string" ? options.folder : void 0,
-      alias: aliases,
+      order,
+      minCount,
       author,
-      force
-    }, globalOptions);
+      force,
+      description,
+      globalOptions
+    });
     if (globalOptions.json === true || globalOptions.defaultOutputFormat === "json") {
       printResult(result, globalOptions);
     } else if (!globalOptions.quiet) {
-      if (result.action === "list") {
-        writeStdout(`${formatSchemaListHuman(result)}
-`);
-      } else if (result.action === "show") {
-        writeStdout(`${formatSchemaShowHuman(result)}
-`);
-      } else if (result.action === "show-status") {
-        writeStdout(`${formatSchemaShowStatusHuman(result)}
-`);
-      } else if (result.action === "remove-type") {
-        writeStdout(`${formatSchemaRemoveTypeHuman(result)}
-`);
-      } else if (result.action === "add-status") {
-        writeStdout(`${formatSchemaAddStatusHuman(result)}
-`);
-      } else if (result.action === "remove-status") {
-        writeStdout(`${formatSchemaRemoveStatusHuman(result)}
-`);
-      } else {
-        writeStdout(`${formatSchemaAddTypeHuman(result)}
-`);
-      }
-      if (result.action !== "list" && result.action !== "show" && result.action !== "show-status" && result.warnings.length > 0) {
-        printError(`schema ${result.action} warnings: ${formatHookWarnings(result.warnings)}`);
-      }
+      renderSchemaResultHuman(schemaModule, result);
     }
     if (globalOptions.profile) {
       printError(`profile:command=schema 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("--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 without requiring --force").option("--force", "Force ownership override").description("List or add comments for an item.").action(async (id, text, options, command) => {
+  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;
@@ -689,18 +938,21 @@ function registerMutationCommands(program) {
       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-TOLOYWNI.js");
+    const { runComments } = await import("./comments-YAMXKHUX.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);
-    if (typeof add === "string" || readFromStdin || readFromFile !== void 0) {
+    const isMutation = typeof add === "string" || readFromStdin || readFromFile !== void 0 || editIndex !== void 0 || deleteIndex !== void 0;
+    if (isMutation) {
       await invalidateSearchCachesForMutation(globalOptions, result);
     }
     printResult(result, globalOptions);
@@ -717,7 +969,7 @@ function registerMutationCommands(program) {
       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-HMCB7TK6.js");
+    const { runNotes } = await import("./notes-EUANWWKD.js");
     const result = await runNotes(id, {
       add,
       limit: typeof options.limit === "string" ? options.limit : void 0,
@@ -743,7 +995,7 @@ function registerMutationCommands(program) {
       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-QKJOKEAO.js");
+    const { runLearnings } = await import("./learnings-TV2CTGJ3.js");
     const result = await runLearnings(id, {
       add,
       limit: typeof options.limit === "string" ? options.limit : void 0,
@@ -768,7 +1020,7 @@ function registerMutationCommands(program) {
     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-LIFDKNCN.js");
+    const { runFiles } = await import("./files-ZWFJFWBK.js");
     const result = await runFiles(id, {
       add: addValues,
       addGlob: addGlobValues,
@@ -795,7 +1047,7 @@ function registerMutationCommands(program) {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
     const mergedOptions = { ...command.optsWithGlobals(), ...options };
-    const { runFilesDiscover } = await import("./files-LIFDKNCN.js");
+    const { runFilesDiscover } = await import("./files-ZWFJFWBK.js");
     const result = await runFilesDiscover(id, {
       apply: Boolean(mergedOptions.apply),
       note: typeof mergedOptions.note === "string" ? mergedOptions.note : void 0,
@@ -819,7 +1071,7 @@ function registerMutationCommands(program) {
     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-SRTLCQOL.js");
+    const { runDocs } = await import("./docs-HE3HCQ4S.js");
     const result = await runDocs(id, {
       add: addValues,
       addGlob: addGlobValues,
@@ -844,11 +1096,11 @@ function registerMutationCommands(program) {
   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-GPB3LGWN.js");
+    const { runDeps } = await import("./deps-5GWMMS6D.js");
     const result = await runDeps(id, {
-      format: typeof options.format === "string" ? options.format : void 0,
+      format: options.format,
       maxDepth: typeof options.maxDepth === "string" ? options.maxDepth : void 0,
-      collapse: typeof options.collapse === "string" ? options.collapse : void 0,
+      collapse: options.collapse,
       summary: options.summary === true
     }, globalOptions);
     printResult(result, globalOptions);
@@ -858,6 +1110,9 @@ function registerMutationCommands(program) {
   });
 }
 export {
+  parsePositiveIntOption,
+  parseSchemaOrderOption,
+  registerCommanderOptionContracts,
   registerMutationCommands
 };
-//# sourceMappingURL=register-mutation-QKFPTIZG.js.map
+//# sourceMappingURL=register-mutation-6UCOEQ6L.js.map