@unbrained/pm-cli 2026.6.11 → 2026.6.12

package/dist/sdk/cli-contracts.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]="9091cd85-ff8e-55db-b56e-c5fc84e60632")}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]="0e11d981-3bc2-5584-b783-ee213f7395ba")}catch(e){}}();
 export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "./cli-contracts/commander-types.js";
 export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, } from "./cli-contracts/commander-mutation-options.js";
 // PM_* enum/guard contracts and the bulk tool-parameter property/metadata data
@@ -192,6 +192,9 @@ export const 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" },
@@ -205,6 +208,9 @@ export const 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" },
@@ -229,6 +235,7 @@ export const HISTORY_REDACT_FLAG_CONTRACTS = [
     { flag: "--force" },
 ];
 export const HISTORY_REPAIR_FLAG_CONTRACTS = [
+    { flag: "--all" },
     { flag: "--dry-run" },
     { flag: "--author" },
     { flag: "--message" },
@@ -270,7 +277,12 @@ export const 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"] },
@@ -616,6 +628,13 @@ export const 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" },
 ];
@@ -1491,8 +1510,9 @@ const 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"],
@@ -1534,6 +1554,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "claim",
             "fromSearch",
             "stepTitle",
+            "step",
             "stepBody",
             "stepOwner",
             "stepStatus",
@@ -1613,6 +1634,10 @@ const 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",
@@ -1621,10 +1646,22 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "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: {
@@ -1730,6 +1767,10 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "strictExit",
             "failOnWarn",
             "fixHints",
+            "autoFix",
+            "dryRun",
+            "fixScope",
+            "pruneMissing",
             "checkHistoryDrift",
             "checkCommandReferences",
         ],
@@ -1815,6 +1856,18 @@ 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: {
@@ -1828,6 +1881,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;
 }
 // Building the full MCP tool-parameter schemas (one variant per action) is only
@@ -1860,7 +1927,7 @@ function createLazyContractSchema(build) {
  * the MAJOR for breaking changes — the major also drives the `$id`
  * `tool-parameters-v{major}` slug, so the two never drift.
  */
-export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.0.2";
+export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.0.3";
 /**
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
  * schema `$id` slug so a breaking version bump renames the document in lockstep.
@@ -1926,4 +1993,4 @@ function buildProviderCompatibleToolSchema() {
 }
 export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(buildProviderCompatibleToolSchema);
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=9091cd85-ff8e-55db-b56e-c5fc84e60632
+//# debugId=0e11d981-3bc2-5584-b783-ee213f7395ba