@unbrained/pm-cli 2026.6.11 → 2026.6.12

package/dist/cli-bundle/chunks/{chunk-FXRU333M.js → chunk-UIG4TW2H.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]="2533bfec-8cab-58ea-acd2-3582f0f1b6bd")}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]="60d8e31c-b4ba-5c8f-b2dc-523d0a2b3b13")}catch(e){}}();
 import {
   KNOWN_EXTENSION_CAPABILITIES,
   KNOWN_EXTENSION_POLICY_MODES,
@@ -1267,6 +1267,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" },
@@ -1276,6 +1279,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" },
@@ -1315,6 +1319,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" },
@@ -1386,6 +1394,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] },
@@ -1437,6 +1448,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"]
@@ -1771,6 +1786,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"]]
@@ -1885,6 +1903,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."
   },
@@ -1933,6 +1961,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]
@@ -2242,6 +2278,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" },
@@ -2255,6 +2294,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" },
@@ -2279,6 +2321,7 @@ var HISTORY_REDACT_FLAG_CONTRACTS = [
   { flag: "--force" }
 ];
 var HISTORY_REPAIR_FLAG_CONTRACTS = [
+  { flag: "--all" },
   { flag: "--dry-run" },
   { flag: "--author" },
   { flag: "--message" },
@@ -2320,7 +2363,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"] },
@@ -2663,6 +2711,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" }
 ];
@@ -3523,8 +3578,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"],
@@ -3566,6 +3622,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
       "claim",
       "fromSearch",
       "stepTitle",
+      "step",
       "stepBody",
       "stepOwner",
       "stepStatus",
@@ -3645,6 +3702,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",
@@ -3652,11 +3713,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: {
@@ -3762,6 +3835,10 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
       "strictExit",
       "failOnWarn",
       "fixHints",
+      "autoFix",
+      "dryRun",
+      "fixScope",
+      "pruneMissing",
       "checkHistoryDrift",
       "checkCommandReferences"
     ]
@@ -3842,6 +3919,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: {
@@ -3855,6 +3942,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) {
@@ -3873,7 +3974,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(() => ({
@@ -4022,6 +4123,6 @@ export {
   resolveSubcommandFlagContractsForCommand,
   PM_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-FXRU333M.js.map
+//# sourceMappingURL=chunk-UIG4TW2H.js.map
 
-//# debugId=2533bfec-8cab-58ea-acd2-3582f0f1b6bd
+//# debugId=60d8e31c-b4ba-5c8f-b2dc-523d0a2b3b13