@unbrained/pm-cli 2026.6.11 → 2026.6.13

package/dist/cli-bundle/chunks/{chunk-3SLOMKCJ.js → chunk-5HSAHRYA.js}

@@ -1,6 +1,6 @@
 import {
   runClose
-} from "./chunk-VFUZV5EB.js";
+} from "./chunk-7SM7VA5I.js";
 import {
   assertNoLegacyNoneToken,
   assertNoLegacyNoneTokens,
@@ -18,7 +18,7 @@ import {
   parseTests,
   parseTypeOptionEntries,
   resolvePriority
-} from "./chunk-IKOH24GZ.js";
+} from "./chunk-MGAQ6KZG.js";
 import {
   applyTagRemovals,
   createStdinTokenResolver,
@@ -26,15 +26,15 @@ import {
   parseCsvKv,
   parseOptionalNumber,
   parseTags
-} from "./chunk-TNAP7EJX.js";
+} from "./chunk-HZOX5BYD.js";
 import {
   normalizeParentReferenceValue,
   validateMissingParentReference,
   validateSprintOrReleaseValue
-} from "./chunk-XTKJSVWH.js";
+} from "./chunk-QU3OPNVV.js";
 import {
   buildInvalidTypeError
-} from "./chunk-OLKBSY4N.js";
+} from "./chunk-UCVJP4JL.js";
 import {
   applyRegisteredItemFieldDefaultsAndValidation,
   buildItemNotFoundError,
@@ -44,14 +44,14 @@ import {
   parseRegisteredItemFieldAssignments,
   readLocatedItem,
   toItemRecord
-} from "./chunk-3KLPFWZ4.js";
+} from "./chunk-XXLMJDUB.js";
 import {
   normalizeItemId
-} from "./chunk-VPEAS7PS.js";
+} from "./chunk-LGOXXQUW.js";
 import {
   collectRuntimeUpdateFieldValues,
   normalizeStatusInput
-} from "./chunk-73ZPG2I3.js";
+} from "./chunk-MACCNKSZ.js";
 import {
   canonicalizeCommandOptionKey,
   commandOptionFlagLabel,
@@ -60,10 +60,10 @@ import {
   resolveTypeDefinition,
   resolveTypeName,
   validateTypeOptions
-} from "./chunk-5SCT2JCT.js";
+} from "./chunk-W6KNFAMZ.js";
 import {
   resolveIsoOrRelative
-} from "./chunk-IUKD4W6Z.js";
+} from "./chunk-IXVSSHGV.js";
 import {
   DEPENDENCY_KIND_VALUES,
   EXIT_CODE,
@@ -78,7 +78,7 @@ import {
   resolveRuntimeFieldRegistry,
   resolveRuntimeStatusRegistry,
   stableValueEquals
-} from "./chunk-FY4SPXSC.js";
+} from "./chunk-LFW5NQUP.js";
 
 // dist/core/schema/type-workflows.js
 !(function() {
@@ -1711,4 +1711,4 @@ async function runUpdate(id, options, global2) {
 export {
   runUpdate
 };
-//# sourceMappingURL=chunk-3SLOMKCJ.js.map
+//# sourceMappingURL=chunk-5HSAHRYA.js.map

package/dist/cli-bundle/chunks/{chunk-ZLMIWZUG.js → chunk-5LMF75Q7.js}

@@ -3,7 +3,7 @@ import {
   PmCliError,
   isPathWithinDirectory,
   pathExists
-} from "./chunk-FY4SPXSC.js";
+} from "./chunk-LFW5NQUP.js";
 
 // dist/cli/commands/extension/shared.js
 import fs from "node:fs/promises";
@@ -112,4 +112,4 @@ export {
   parseExtensionManifest,
   validateExtensionDirectory
 };
-//# sourceMappingURL=chunk-ZLMIWZUG.js.map
+//# sourceMappingURL=chunk-5LMF75Q7.js.map

package/dist/cli-bundle/chunks/{chunk-TK5VZFHY.js → chunk-6TBR5AZ2.js}

@@ -3,21 +3,21 @@ import {
 } from "./chunk-O7IWB35H.js";
 import {
   parseCsvKv
-} from "./chunk-TNAP7EJX.js";
+} from "./chunk-HZOX5BYD.js";
 import {
   parseLimit
-} from "./chunk-QJMGRZO2.js";
+} from "./chunk-VYZNX4C5.js";
 import {
   locateItem,
   mutateItem,
   readLocatedItem
-} from "./chunk-3KLPFWZ4.js";
+} from "./chunk-XXLMJDUB.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-5SCT2JCT.js";
+} from "./chunk-W6KNFAMZ.js";
 import {
   nowIso
-} from "./chunk-IUKD4W6Z.js";
+} from "./chunk-IXVSSHGV.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -26,7 +26,7 @@ import {
   pathExists,
   readSettings,
   resolvePmRoot
-} from "./chunk-FY4SPXSC.js";
+} from "./chunk-LFW5NQUP.js";
 
 // dist/cli/commands/annotation-command.js
 !(function() {
@@ -154,4 +154,4 @@ export {
   wrapOwnershipConflict,
   runAnnotationCommand
 };
-//# sourceMappingURL=chunk-TK5VZFHY.js.map
+//# sourceMappingURL=chunk-6TBR5AZ2.js.map

package/dist/cli-bundle/chunks/{chunk-ATEES5SX.js → chunk-6ZFTM65G.js}

@@ -3,7 +3,7 @@
 import {
   TYPE_TO_FOLDER,
   pathExists
-} from "./chunk-A6LXQFO7.js";
+} from "./chunk-S2CDTRJ6.js";
 
 // dist/core/item/id.js
 import crypto from "node:crypto";
@@ -70,6 +70,6 @@ export {
   normalizeItemId,
   generateItemId
 };
-//# sourceMappingURL=chunk-ATEES5SX.js.map
+//# sourceMappingURL=chunk-6ZFTM65G.js.map
 
 //# debugId=fee16454-2fff-5dc9-8e3e-374148e3e18f

package/dist/cli-bundle/chunks/{chunk-P2PSODAQ.js → chunk-7CRFV6JR.js}

@@ -9,7 +9,7 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-FY4SPXSC.js";
+} from "./chunk-LFW5NQUP.js";
 
 // dist/sdk/cli-contracts/commander-types.js
 !(function() {
@@ -1094,7 +1094,7 @@ var TOOL_CONTEXT_OPTION_CONTRACTS = [
 !(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] = "28cc182a-a139-5258-a9c6-5cc6b60e18c3");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "94debfc3-fbc8-5417-83a4-05126242aa06");
   } catch (e2) {
   }
 })();
@@ -1300,6 +1300,9 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   strictExit: { type: "boolean" },
   failOnWarn: { type: "boolean" },
   fixHints: { type: "boolean" },
+  autoFix: { type: "boolean" },
+  fixScope: { type: "array", items: { type: "string", enum: ["metadata", "resolution", "lifecycle"] } },
+  pruneMissing: { type: "boolean" },
   checkHistoryDrift: { type: "boolean" },
   checkCommandReferences: { type: "boolean" },
   allowAuditNote: { type: "boolean" },
@@ -1309,6 +1312,7 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   allowAuditDepUpdate: { type: "boolean" },
   allowAuditRelease: { type: "boolean" },
   dryRun: { type: "boolean" },
+  all: { type: "boolean" },
   cliOnly: { type: "boolean" },
   packagesOnly: { type: "boolean" },
   repair: { type: "boolean" },
@@ -1348,6 +1352,10 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   discover: { type: "boolean" },
   apply: { type: "boolean" },
   discoveryNote: { type: "string" },
+  // GH-170 (pm-pfnx): single-string note for files/docs add batches (the shared
+  // `note` key below is the array-typed create/update note seed).
+  addNote: { type: "string" },
+  list: { type: "boolean" },
   appendStable: { type: "boolean" },
   validatePaths: { type: "boolean" },
   audit: { type: "boolean" },
@@ -1419,6 +1427,9 @@ var PLAN_ACTION_PARAMETER_PROPERTIES = {
   claim: { type: "boolean" },
   fromSearch: { type: "string" },
   stepTitle: { type: "string" },
+  // pm-6mit: ordered step titles for create (string or array; values are never
+  // comma-split). On step subcommands a single value aliases stepTitle.
+  step: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }] },
   stepBody: { type: "string" },
   stepOwner: { type: "string" },
   stepStatus: { type: "string", enum: [...PLAN_STEP_STATUS_VALUES] },
@@ -1470,6 +1481,10 @@ var PLAN_ACTION_PARAMETER_METADATA = {
     description: "Plan lifecycle mode.",
     examples: ["draft", "research", "approved"]
   },
+  step: {
+    description: "Ordered initial step titles for create (string or array, never comma-split; stepTitle, when also set, becomes the first step). For step subcommands a single value aliases stepTitle.",
+    examples: [["Read the code", "Write the fix", "Run the tests"]]
+  },
   file: {
     description: "File link to attach while creating or materializing a Plan.",
     examples: ["path=src/cli.ts,note=implementation surface"]
@@ -1804,6 +1819,9 @@ var PM_TOOL_PARAMETER_METADATA = {
   dryRun: {
     description: "Preview command effects without mutating storage artifacts."
   },
+  all: {
+    description: "For history-repair action: scan every stream for drift and repair each drifted stream in one audited pass (mutually exclusive with id)."
+  },
   gcScope: {
     description: "Repeatable gc scope selector values (index, embeddings, runtime, locks).",
     examples: [["index", "embeddings"], ["runtime"], ["locks"]]
@@ -1918,6 +1936,16 @@ var PM_TOOL_PARAMETER_METADATA = {
   fixHints: {
     description: "For validate action, add a machine-executable fix_hints[] of pm commands to each failing check's details."
   },
+  autoFix: {
+    description: "For validate action, apply the safe, deterministic subset of fix-hint remediations (field backfills) automatically; combine with dryRun to preview and fixScope to grant gated scopes."
+  },
+  fixScope: {
+    description: "For validate action, grant --auto-fix scopes (metadata, resolution, lifecycle). Defaults to the safe scopes metadata and resolution; lifecycle must be named explicitly.",
+    examples: [["lifecycle"], ["metadata", "resolution"]]
+  },
+  pruneMissing: {
+    description: "For validate action, remove stale linked-file/doc LINKS whose paths classified as deleted (link removal only \u2014 never touches real files); honors dryRun."
+  },
   checkHistoryDrift: {
     description: "Run item/history hash drift checks."
   },
@@ -1966,6 +1994,14 @@ var PM_TOOL_PARAMETER_METADATA = {
     description: "Note attached to file links added by files discovery.",
     examples: ["discovered from item text"]
   },
+  addNote: {
+    description: "Note attached to every link added by add/addGlob in this call (per-entry embedded note= wins; requires add or addGlob). Maps to the CLI --note flag on pm files/pm docs.",
+    examples: ["command wiring"]
+  },
+  list: {
+    description: "When true for files/docs action, list the current linked paths without mutating them.",
+    examples: [true]
+  },
   stream: {
     description: "Stream selector: test-runs logs accepts stdout|stderr|both; activity accepts boolean/rows|ndjson|jsonl for line-delimited output.",
     examples: ["stderr", "stdout", "both", "rows", "ndjson", "jsonl", true]
@@ -2097,7 +2133,7 @@ var PM_TOOL_PARAMETER_METADATA = {
 !(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] = "9091cd85-ff8e-55db-b56e-c5fc84e60632");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "0e11d981-3bc2-5584-b783-ee213f7395ba");
   } catch (e2) {
   }
 })();
@@ -2282,6 +2318,9 @@ var FILES_FLAG_CONTRACTS = [
   { flag: "--add-glob" },
   { flag: "--remove" },
   { flag: "--migrate" },
+  // GH-170 (pm-pfnx): single-value note applied to every --add/--add-glob link
+  // in the invocation (embedded note= wins; usage error without an add).
+  { flag: "--note" },
   { flag: "--list" },
   { flag: "--append-stable" },
   { flag: "--validate-paths" },
@@ -2295,6 +2334,9 @@ var DOCS_FLAG_CONTRACTS = [
   { flag: "--add-glob" },
   { flag: "--remove" },
   { flag: "--migrate" },
+  // GH-170 (pm-pfnx): see FILES_FLAG_CONTRACTS --note.
+  { flag: "--note" },
+  { flag: "--list" },
   { flag: "--validate-paths" },
   { flag: "--audit" },
   { flag: "--author" },
@@ -2319,6 +2361,7 @@ var HISTORY_REDACT_FLAG_CONTRACTS = [
   { flag: "--force" }
 ];
 var HISTORY_REPAIR_FLAG_CONTRACTS = [
+  { flag: "--all" },
   { flag: "--dry-run" },
   { flag: "--author" },
   { flag: "--message" },
@@ -2360,7 +2403,12 @@ var PLAN_FLAG_CONTRACTS = [
   { flag: "--body" },
   { flag: "--claim" },
   { flag: "--from-search", aliases: ["--from_search"] },
-  { flag: "--step-title", aliases: ["--step", "--step_title"] },
+  { flag: "--step-title", aliases: ["--step_title"] },
+  // pm-6mit: --step is a Commander collect repeatable (ordered step titles on
+  // create; single-value stepTitle alias elsewhere). It must NOT be list:true —
+  // the bootstrap coalescer comma-joins list flags and would corrupt titles
+  // containing commas.
+  { flag: "--step" },
   { flag: "--step-body", aliases: ["--step_body"] },
   { flag: "--step-owner", aliases: ["--step_owner"] },
   { flag: "--step-status", aliases: ["--step_status"] },
@@ -2703,6 +2751,13 @@ var VALIDATE_FLAG_CONTRACTS = [
   { flag: "--strict-exit" },
   { flag: "--fail-on-warn" },
   { flag: "--fix-hints" },
+  { flag: "--auto-fix" },
+  { flag: "--dry-run" },
+  // NOT list:true — repeatable via Commander's collector; the bootstrap
+  // coalescer must not comma-join occurrences (values may also be
+  // comma-separated lists which the resolver splits itself).
+  { flag: "--fix-scope" },
+  { flag: "--prune-missing" },
   { flag: "--check-history-drift" },
   { flag: "--check-command-references" }
 ];
@@ -3563,8 +3618,9 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     anyOfRequired: [["literal"], ["regex"]]
   },
   "history-repair": {
-    required: ["id"],
-    optional: ["dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS]
+    // Exactly one of `id` (single stream) or `all` (bulk drift repair) is required.
+    optional: ["id", "all", "dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],
+    oneOfRequired: [["id"], ["all"]]
   },
   "history-compact": {
     required: ["id"],
@@ -3606,6 +3662,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
       "claim",
       "fromSearch",
       "stepTitle",
+      "step",
       "stepBody",
       "stepOwner",
       "stepStatus",
@@ -3685,6 +3742,10 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
       "addGlob",
       "remove",
       "migrate",
+      // GH-170 (pm-pfnx): `addNote` is the MCP spelling of the CLI --note flag
+      // (the shared `note` parameter is the array-typed create/update note
+      // seed, so files/docs use a distinct single-string key).
+      "addNote",
       "discover",
       "apply",
       "discoveryNote",
@@ -3692,11 +3753,23 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
       "validatePaths",
       "audit",
       ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS
-    ]
+    ],
+    dependentAnyOfRequired: [{ property: "addNote", anyOfRequired: [["add"], ["addGlob"]] }]
   },
   docs: {
     required: ["id"],
-    optional: ["add", "addGlob", "remove", "migrate", "validatePaths", "audit", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS]
+    optional: [
+      "add",
+      "addGlob",
+      "remove",
+      "migrate",
+      "addNote",
+      "list",
+      "validatePaths",
+      "audit",
+      ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS
+    ],
+    dependentAnyOfRequired: [{ property: "addNote", anyOfRequired: [["add"], ["addGlob"]] }]
   },
   deps: { required: ["id"], optional: ["format", "maxDepth", "collapse", "summary"] },
   test: {
@@ -3802,6 +3875,10 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
       "strictExit",
       "failOnWarn",
       "fixHints",
+      "autoFix",
+      "dryRun",
+      "fixScope",
+      "pruneMissing",
       "checkHistoryDrift",
       "checkCommandReferences"
     ]
@@ -3882,6 +3959,16 @@ function buildActionScopedToolSchema(action) {
       required: [...requiredFields]
     }));
   }
+  if (contract.oneOfRequired && contract.oneOfRequired.length > 0) {
+    schema.oneOf = contract.oneOfRequired.map((requiredFields) => {
+      const otherFields = contract.oneOfRequired?.flat().filter((field) => !requiredFields.includes(field)) ?? [];
+      return {
+        required: [...requiredFields],
+        ...otherFields.length > 0 ? { not: { anyOf: otherFields.map((field) => ({ required: [field] })) } } : {},
+        ...action === "history-repair" && requiredFields.includes("all") ? { properties: { all: { const: true } } } : {}
+      };
+    });
+  }
   if (contract.conditionalRequired && contract.conditionalRequired.length > 0) {
     schema.allOf = contract.conditionalRequired.map((entry) => ({
       if: {
@@ -3895,6 +3982,20 @@ function buildActionScopedToolSchema(action) {
       }
     }));
   }
+  if (contract.dependentAnyOfRequired && contract.dependentAnyOfRequired.length > 0) {
+    const allOf = Array.isArray(schema.allOf) ? [...schema.allOf] : [];
+    for (const entry of contract.dependentAnyOfRequired) {
+      allOf.push({
+        if: { required: [entry.property] },
+        then: {
+          anyOf: entry.anyOfRequired.map((requiredFields) => ({
+            required: [...requiredFields]
+          }))
+        }
+      });
+    }
+    schema.allOf = allOf;
+  }
   return schema;
 }
 function createLazyContractSchema(build) {
@@ -3913,7 +4014,7 @@ function createLazyContractSchema(build) {
     }
   });
 }
-var PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.0.2";
+var PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.0.3";
 var PM_TOOL_PARAMETERS_SCHEMA_MAJOR = PM_TOOL_PARAMETERS_SCHEMA_VERSION.split(".")[0];
 var PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION = "1.0.0";
 var PM_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(() => ({
@@ -4062,4 +4163,4 @@ export {
   resolveSubcommandFlagContractsForCommand,
   PM_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-P2PSODAQ.js.map
+//# sourceMappingURL=chunk-7CRFV6JR.js.map