@unbrained/pm-cli 2026.6.11 → 2026.6.13

package/dist/cli-bundle/chunks/{register-mutation-DG53FCBV.js → register-mutation-ZYJQ4DVP.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]="85daf52a-9a42-5cd5-91f6-79b376dac005")}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]="5cbbc60e-2417-5f4f-bb35-757e6c45886a")}catch(e){}}();
 import {
   collect,
   extractUpdateManyMutationOptionSource,
@@ -8,27 +8,27 @@ import {
   invalidateSearchCachesForMutation,
   normalizeCreateOptions,
   normalizeUpdateOptions
-} from "./chunk-IH4MBKK7.js";
+} from "./chunk-2ANTZBYF.js";
 import {
   CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,
   UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS
-} from "./chunk-FXRU333M.js";
-import "./chunk-XJDGS74Y.js";
+} from "./chunk-AGG32LKL.js";
+import "./chunk-4ZKKZMLH.js";
 import {
   printError,
   printResult,
   writeStdout
-} from "./chunk-I2IJY2NL.js";
-import "./chunk-HI7STVF2.js";
-import "./chunk-ATEES5SX.js";
-import "./chunk-UUWGCWBU.js";
-import "./chunk-CCX4RSYZ.js";
-import "./chunk-WUNFKP7M.js";
+} from "./chunk-LOAR5TKX.js";
+import "./chunk-L6YQONLM.js";
+import "./chunk-6ZFTM65G.js";
+import "./chunk-QQG4HEX7.js";
+import "./chunk-32XSW44C.js";
+import "./chunk-IZHCCG4S.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
   PmCliError
-} from "./chunk-A6LXQFO7.js";
+} from "./chunk-S2CDTRJ6.js";
 
 // dist/cli/register-mutation.js
 import { Option } from "commander";
@@ -143,7 +143,7 @@ function registerMutationCommands(program) {
       options.title = positionalTitle;
     }
     const normalized = normalizeCreateOptions(options, { requireType: false });
-    const { runCreate } = await import("./create-IFA26O2I.js");
+    const { runCreate } = await import("./create-4EQNELMY.js");
     const result = await runCreate(normalized, globalOptions);
     await invalidateSearchCachesForMutation(globalOptions, result);
     printResult(result, globalOptions);
@@ -154,7 +154,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-ALU5WMHA.js");
+    const { runCopy } = await import("./copy-C4W522JM.js");
     const result = await runCopy(id, {
       title: typeof options.title === "string" ? options.title : void 0,
       author: typeof options.author === "string" ? options.author : void 0,
@@ -174,7 +174,7 @@ function registerMutationCommands(program) {
   updateCommand.action(async (id, options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runUpdate } = await import("./update-5A2B6QYB.js");
+    const { runUpdate } = await import("./update-U235A7WP.js");
     const result = await runUpdate(id, normalizeUpdateOptions(options), globalOptions);
     await invalidateSearchCachesForMutation(globalOptions, result);
     printResult(result, globalOptions);
@@ -214,7 +214,7 @@ function registerMutationCommands(program) {
   updateManyCommand.action(async (options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runUpdateMany } = await import("./update-many-V4LA3C4H.js");
+    const { runUpdateMany } = await import("./update-many-6B7PJ33I.js");
     const result = await runUpdateMany({
       status: typeof options.filterStatus === "string" ? options.filterStatus : void 0,
       list: {
@@ -254,7 +254,7 @@ function registerMutationCommands(program) {
   closeCommand.action(async (id, text, options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runClose } = await import("./close-XLEKIQSW.js");
+    const { runClose } = await import("./close-SPUFW5QR.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) => {
@@ -296,7 +296,7 @@ function registerMutationCommands(program) {
       }
       return void 0;
     };
-    const { runCloseMany } = await import("./close-many-AOD4HSAZ.js");
+    const { runCloseMany } = await import("./close-many-GKAJX54X.js");
     const result = await runCloseMany({
       status: typeof options.filterStatus === "string" ? options.filterStatus : void 0,
       list: {
@@ -339,7 +339,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-Y2SGJBGY.js");
+    const { runDelete } = await import("./delete-ZLGUYIXU.js");
     const result = await runDelete(id, {
       author: typeof options.author === "string" ? options.author : void 0,
       message: typeof options.message === "string" ? options.message : void 0,
@@ -368,7 +368,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-KG55G7S3.js");
+    const { runAppend } = await import("./append-NL67JNJU.js");
     const result = await runAppend(id, {
       body: resolvedBody,
       author: typeof options.author === "string" ? options.author : void 0,
@@ -384,7 +384,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-M6AFHMV4.js");
+    const { runRestore } = await import("./restore-FJQWXMPY.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,
@@ -396,7 +396,7 @@ function registerMutationCommands(program) {
       printError(`profile:command=restore took_ms=${Date.now() - startedAt}`);
     }
   });
-  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("--step-title <value>", "Step title for add-step / update-step").option("--step <value>", "Alias for --step-title").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");
+  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("--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 [
     ["--resume_context <value>", "Alias for --resume-context"],
     ["--from_search <value>", "Alias for --from-search"],
@@ -433,7 +433,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-VNUG3WZZ.js");
+    const { runPlan, PLAN_SUBCOMMANDS } = await import("./plan-DWBYI5C6.js");
     const normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
     if (!normalizedSubcommand) {
       throw new PmCliError(`pm plan requires a subcommand. Allowed: ${PLAN_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, {
@@ -454,7 +454,10 @@ function registerMutationCommands(program) {
       ["blocked_by", "blockedBy"],
       ["resume_context", "resumeContext"],
       ["from_search", "fromSearch"],
-      ["step", "stepTitle"],
+      // 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"],
@@ -514,7 +517,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-G72A4EJ4.js");
+    const { runHistoryRedact } = await import("./history-redact-SDTDR6WM.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, {
@@ -534,17 +537,28 @@ function registerMutationCommands(program) {
       printError(`profile:command=history-redact took_ms=${Date.now() - startedAt}`);
     }
   });
-  program.command("history-repair").argument("<id>", "Item id").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.").action(async (id, options, command) => {
+  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 } = await import("./history-repair-RUGKD3YR.js");
-    const result = await runHistoryRepair(id, {
+    const { runHistoryRepair, runHistoryRepairAll, assertHistoryRepairTarget } = await import("./history-repair-BJCGM6Q3.js");
+    const all = options.all === true;
+    assertHistoryRepairTarget(id, all);
+    const repairOptions = {
       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 (all) {
+      const result = await runHistoryRepairAll(repairOptions, globalOptions);
+      printResult(result, globalOptions);
+      if (result.totals.failed > 0) {
+        process.exitCode = EXIT_CODE.GENERIC_FAILURE;
+      }
+    } else {
+      const result = await runHistoryRepair(id, repairOptions, globalOptions);
+      printResult(result, globalOptions);
+    }
     if (globalOptions.profile) {
       printError(`profile:command=history-repair took_ms=${Date.now() - startedAt}`);
     }
@@ -552,7 +566,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-3EJ3L2O7.js");
+    const { runHistoryCompact } = await import("./history-compact-SLL6ESXH.js");
     const result = await runHistoryCompact(id, {
       before: typeof options.before === "string" ? options.before : void 0,
       dryRun: options.dryRun === true,
@@ -570,7 +584,7 @@ function registerMutationCommands(program) {
   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-76HDZJCC.js");
+    const { runSchemaAddType, runSchemaRemoveType, runSchemaAddStatus, runSchemaRemoveStatus, runSchemaList, runSchemaShow, runSchemaShowStatus, formatSchemaAddTypeHuman, formatSchemaRemoveTypeHuman, formatSchemaAddStatusHuman, formatSchemaRemoveStatusHuman, formatSchemaListHuman, formatSchemaShowHuman, formatSchemaShowStatusHuman, SCHEMA_SUBCOMMANDS } = await import("./schema-ZZ7ZDM2X.js");
     let normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
     let typeName = name;
     if (!normalizedSubcommand) {
@@ -663,7 +677,7 @@ 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-RN5TG4ZN.js");
+    const { runComments } = await import("./comments-5FPT6L7N.js");
     const result = await runComments(id, {
       add,
       stdin: readFromStdin,
@@ -691,7 +705,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-5T6P7C5V.js");
+    const { runNotes } = await import("./notes-3NLK7WTZ.js");
     const result = await runNotes(id, {
       add,
       limit: typeof options.limit === "string" ? options.limit : void 0,
@@ -717,7 +731,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-HQXSSKZ5.js");
+    const { runLearnings } = await import("./learnings-L6KTZGOT.js");
     const result = await runLearnings(id, {
       add,
       limit: typeof options.limit === "string" ? options.limit : void 0,
@@ -735,19 +749,20 @@ function registerMutationCommands(program) {
     }
   });
   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 (path=<value>, path:<value>, plain path, or - for stdin)", collect).option("--migrate <value>", "Migrate linked file paths in-place (from=<prefix>,to=<prefix>; repeatable)", collect).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) => {
+  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 (path=<value>, path:<value>, plain path, or - for stdin)", 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-DLB5LJEP.js");
+    const { runFiles } = await import("./files-OIFN3DQX.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),
@@ -767,14 +782,15 @@ function registerMutationCommands(program) {
   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 { runFilesDiscover } = await import("./files-DLB5LJEP.js");
+    const mergedOptions = { ...command.optsWithGlobals(), ...options };
+    const { runFilesDiscover } = await import("./files-OIFN3DQX.js");
     const result = await runFilesDiscover(id, {
-      apply: Boolean(options.apply),
-      note: typeof options.note === "string" ? options.note : void 0,
-      appendStable: Boolean(options.appendStable),
-      author: typeof options.author === "string" ? options.author : void 0,
-      message: typeof options.message === "string" ? options.message : void 0,
-      force: Boolean(options.force)
+      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);
@@ -784,19 +800,20 @@ function registerMutationCommands(program) {
       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 (path=<value>, path:<value>, plain path, or - for stdin)", collect).option("--migrate <value>", "Migrate linked doc paths in-place (from=<prefix>,to=<prefix>; repeatable)", collect).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) => {
+  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 (path=<value>, path:<value>, plain path, or - for stdin)", 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-5WMBVQT2.js");
+    const { runDocs } = await import("./docs-RJQPLROO.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),
@@ -815,7 +832,7 @@ 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-6TSPOSGU.js");
+    const { runDeps } = await import("./deps-HV2C2L46.js");
     const result = await runDeps(id, {
       format: typeof options.format === "string" ? options.format : void 0,
       maxDepth: typeof options.maxDepth === "string" ? options.maxDepth : void 0,
@@ -831,6 +848,6 @@ function registerMutationCommands(program) {
 export {
   registerMutationCommands
 };
-//# sourceMappingURL=register-mutation-DG53FCBV.js.map
+//# sourceMappingURL=register-mutation-ZYJQ4DVP.js.map
 
-//# debugId=85daf52a-9a42-5cd5-91f6-79b376dac005
+//# debugId=5cbbc60e-2417-5f4f-bb35-757e6c45886a