@unbrained/pm-cli 2026.6.13 → 2026.6.17

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]="0e11d981-3bc2-5584-b783-ee213f7395ba")}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]="d96141cc-85b2-5835-97d9-a5ddcb542b38")}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
@@ -40,7 +40,10 @@ export function withFlagAliasMetadata(flagContracts) {
         if (contract.flag !== canonical) {
             return contract;
         }
-        const aliases = normalizeUniqueStringList([...(contract.aliases ?? []), ...(aliasesByCanonical.get(canonical) ?? [])]).filter((alias) => alias !== canonical);
+        const aliases = normalizeUniqueStringList([
+            ...(contract.aliases ?? []),
+            ...aliasesByCanonical.get(canonical),
+        ]).filter((alias) => alias !== canonical);
         if (aliases.length === 0) {
             return contract;
         }
@@ -91,8 +94,36 @@ export const LIST_FILTER_FLAG_CONTRACTS = [
     { flag: "--parent" },
     { flag: "--sprint" },
     { flag: "--release" },
+    { flag: "--filter-ac-missing" },
+    { flag: "--filter-estimates-missing", aliases: ["--filter-estimate-missing"] },
+    { flag: "--filter-resolution-missing" },
+    { flag: "--filter-metadata-missing" },
+    { flag: "--filter-reviewer-missing" },
+    { flag: "--filter-risk-missing" },
+    { flag: "--filter-confidence-missing" },
+    { flag: "--filter-sprint-missing" },
+    { flag: "--filter-release-missing" },
+    { flag: "--has-notes" },
+    { flag: "--no-notes" },
+    { flag: "--has-learnings" },
+    { flag: "--no-learnings" },
+    { flag: "--has-files" },
+    { flag: "--no-files" },
+    { flag: "--has-docs" },
+    { flag: "--no-docs" },
+    { flag: "--has-tests" },
+    { flag: "--no-tests" },
+    { flag: "--has-comments" },
+    { flag: "--no-comments" },
+    { flag: "--has-deps" },
+    { flag: "--no-deps" },
+    { flag: "--has-body" },
+    { flag: "--empty-body" },
+    { flag: "--has-linked-command" },
+    { flag: "--no-linked-command" },
     { flag: "--limit" },
     { flag: "--offset" },
+    { flag: "--no-truncate", aliases: ["--all"] },
     { flag: "--compact" },
     { flag: "--brief" },
     { flag: "--full" },
@@ -163,6 +194,8 @@ export const COMMENTS_FLAG_CONTRACTS = [
     { flag: "--add", aliases: ["--comment"] },
     { flag: "--stdin" },
     { flag: "--file" },
+    { flag: "--edit" },
+    { flag: "--delete" },
     { flag: "--limit" },
     { flag: "--author" },
     { flag: "--message" },
@@ -258,6 +291,20 @@ export const SCHEMA_FLAG_CONTRACTS = [
     // values.
     { flag: "--role" },
     { flag: "--order" },
+    // add-field flags (custom runtime fields). --commands/--required-types are
+    // repeatable Commander collect flags (comma-splitting handled in the action),
+    // so they stay off the comma-list contract for the same reason as --alias.
+    { flag: "--type" },
+    { flag: "--commands" },
+    { flag: "--cli-flag" },
+    { flag: "--required" },
+    { flag: "--required-on-create" },
+    { flag: "--no-allow-unset" },
+    { flag: "--required-types" },
+    // add-type --infer flags (title-prefix type inference).
+    { flag: "--infer" },
+    { flag: "--min-count" },
+    { flag: "--apply" },
     { flag: "--author" },
     { flag: "--force" },
 ];
@@ -475,6 +522,29 @@ export const CLOSE_MANY_FLAG_CONTRACTS = [
     { flag: "--filter-parent" },
     { flag: "--filter-sprint" },
     { flag: "--filter-release" },
+    { flag: "--filter-reviewer-missing" },
+    { flag: "--filter-risk-missing" },
+    { flag: "--filter-confidence-missing" },
+    { flag: "--filter-sprint-missing" },
+    { flag: "--filter-release-missing" },
+    { flag: "--filter-has-notes" },
+    { flag: "--filter-no-notes" },
+    { flag: "--filter-has-learnings" },
+    { flag: "--filter-no-learnings" },
+    { flag: "--filter-has-files" },
+    { flag: "--filter-no-files" },
+    { flag: "--filter-has-docs" },
+    { flag: "--filter-no-docs" },
+    { flag: "--filter-has-tests" },
+    { flag: "--filter-no-tests" },
+    { flag: "--filter-has-comments" },
+    { flag: "--filter-no-comments" },
+    { flag: "--filter-has-deps" },
+    { flag: "--filter-no-deps" },
+    { flag: "--filter-has-body" },
+    { flag: "--filter-empty-body" },
+    { flag: "--filter-has-linked-command" },
+    { flag: "--filter-no-linked-command" },
     { flag: "--ids", list: true },
     { flag: "--limit" },
     { flag: "--offset" },
@@ -534,6 +604,32 @@ export const CLOSE_TASK_FLAG_CONTRACTS = [
     { flag: "--validate-close" },
     { flag: "--force" },
 ];
+/** Shared create-passthrough flags for every scheduling shortcut (GH-217). */
+const SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS = [
+    { flag: "--parent" },
+    { flag: "--allow-missing-parent" },
+    { flag: "--tags" },
+    { flag: "--priority" },
+    { flag: "--body" },
+    { flag: "--description" },
+    { flag: "--author" },
+    { flag: "--message" },
+];
+export const MEET_FLAG_CONTRACTS = [
+    { flag: "--start" },
+    { flag: "--duration" },
+    { flag: "--end" },
+    { flag: "--location" },
+    { flag: "--timezone" },
+    { flag: "--all-day" },
+    ...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS,
+];
+export const EVENT_FLAG_CONTRACTS = MEET_FLAG_CONTRACTS;
+export const REMIND_FLAG_CONTRACTS = [
+    { flag: "--at" },
+    { flag: "--text" },
+    ...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS,
+];
 export const TEST_FLAG_CONTRACTS = [
     { flag: "--add" },
     { flag: "--add-json" },
@@ -596,6 +692,12 @@ export const GC_FLAG_CONTRACTS = [
 ];
 export const STATS_FLAG_CONTRACTS = [
     { flag: "--storage" },
+    { flag: "--metadata-coverage" },
+    { flag: "--field-utilization" },
+    { flag: "--by-assignee" },
+    { flag: "--by-tag" },
+    { flag: "--by-priority" },
+    { flag: "--tag-prefix" },
 ];
 export const HEALTH_FLAG_CONTRACTS = [
     { flag: "--strict-directories" },
@@ -625,6 +727,7 @@ export const VALIDATE_FLAG_CONTRACTS = [
     { flag: "--include-pm-internals" },
     { flag: "--verbose-file-lists" },
     { flag: "--verbose-diagnostics" },
+    { flag: "--all-affected-ids" },
     { flag: "--strict-exit" },
     { flag: "--fail-on-warn" },
     { flag: "--fix-hints" },
@@ -656,6 +759,7 @@ export const CREATE_FLAG_CONTRACTS = [
     // corrupting the JSON-array value form before parseTags sees it.
     { flag: "--add-tags", aliases: ["--add_tags"] },
     { short: "-b", flag: "--body" },
+    { flag: "--body-file" },
     { flag: "--deadline" },
     { flag: "--estimate" },
     { flag: "--estimated-minutes" },
@@ -739,10 +843,14 @@ export const COPY_FLAG_CONTRACTS = [
     { flag: "--author" },
     { flag: "--message" },
 ];
+export const FOCUS_FLAG_CONTRACTS = [
+    { flag: "--clear" },
+];
 export const UPDATE_FLAG_CONTRACTS = [
     { short: "-t", flag: "--title" },
     { short: "-d", flag: "--description" },
     { short: "-b", flag: "--body" },
+    { flag: "--body-file" },
     { short: "-s", flag: "--status" },
     { flag: "--close-reason" },
     { flag: "--close_reason" },
@@ -857,6 +965,33 @@ export const UPDATE_MANY_FLAG_CONTRACTS = [
     { flag: "--filter-parent" },
     { flag: "--filter-sprint" },
     { flag: "--filter-release" },
+    { flag: "--filter-ac-missing" },
+    { flag: "--filter-estimates-missing", aliases: ["--filter-estimate-missing"] },
+    { flag: "--filter-resolution-missing" },
+    { flag: "--filter-metadata-missing" },
+    { flag: "--filter-reviewer-missing" },
+    { flag: "--filter-risk-missing" },
+    { flag: "--filter-confidence-missing" },
+    { flag: "--filter-sprint-missing" },
+    { flag: "--filter-release-missing" },
+    { flag: "--filter-has-notes" },
+    { flag: "--filter-no-notes" },
+    { flag: "--filter-has-learnings" },
+    { flag: "--filter-no-learnings" },
+    { flag: "--filter-has-files" },
+    { flag: "--filter-no-files" },
+    { flag: "--filter-has-docs" },
+    { flag: "--filter-no-docs" },
+    { flag: "--filter-has-tests" },
+    { flag: "--filter-no-tests" },
+    { flag: "--filter-has-comments" },
+    { flag: "--filter-no-comments" },
+    { flag: "--filter-has-deps" },
+    { flag: "--filter-no-deps" },
+    { flag: "--filter-has-body" },
+    { flag: "--filter-empty-body" },
+    { flag: "--filter-has-linked-command" },
+    { flag: "--filter-no-linked-command" },
     { flag: "--ids", list: true },
     { flag: "--limit" },
     { flag: "--offset" },
@@ -1022,6 +1157,7 @@ export const CONTEXT_FLAG_CONTRACTS = [
     { flag: "--assignee_filter" },
     { flag: "--sprint" },
     { flag: "--release" },
+    { flag: "--parent" },
     { flag: "--limit" },
     { flag: "--format" },
     { flag: "--depth" },
@@ -1052,6 +1188,9 @@ export const SEARCH_FLAG_CONTRACTS = [
     { flag: "--mode" },
     { flag: "--semantic" },
     { flag: "--hybrid" },
+    { flag: "--match-mode" },
+    { flag: "--min-score" },
+    { flag: "--count" },
     { flag: "--semantic-weight" },
     { flag: "--include-linked" },
     { flag: "--title-exact" },
@@ -1066,6 +1205,37 @@ export const SEARCH_FLAG_CONTRACTS = [
     { flag: "--priority" },
     { flag: "--deadline-before" },
     { flag: "--deadline-after" },
+    { flag: "--updated-after" },
+    { flag: "--updated-before" },
+    { flag: "--created-after" },
+    { flag: "--created-before" },
+    { flag: "--assignee" },
+    { flag: "--sprint" },
+    { flag: "--release" },
+    { flag: "--parent" },
+    { flag: "--filter-reviewer-missing" },
+    { flag: "--filter-risk-missing" },
+    { flag: "--filter-confidence-missing" },
+    { flag: "--filter-sprint-missing" },
+    { flag: "--filter-release-missing" },
+    { flag: "--has-notes" },
+    { flag: "--no-notes" },
+    { flag: "--has-learnings" },
+    { flag: "--no-learnings" },
+    { flag: "--has-files" },
+    { flag: "--no-files" },
+    { flag: "--has-docs" },
+    { flag: "--no-docs" },
+    { flag: "--has-tests" },
+    { flag: "--no-tests" },
+    { flag: "--has-comments" },
+    { flag: "--no-comments" },
+    { flag: "--has-deps" },
+    { flag: "--no-deps" },
+    { flag: "--has-body" },
+    { flag: "--empty-body" },
+    { flag: "--has-linked-command" },
+    { flag: "--no-linked-command" },
 ];
 export const CONTRACTS_FLAG_CONTRACTS = [
     { flag: "--action" },
@@ -1190,6 +1360,8 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
             return withSubcommandGlobalFlags(CREATE_FLAG_CONTRACTS);
         case "copy":
             return withSubcommandGlobalFlags(COPY_FLAG_CONTRACTS);
+        case "focus":
+            return withSubcommandGlobalFlags(FOCUS_FLAG_CONTRACTS);
         case "aggregate":
             return withSubcommandGlobalFlags(AGGREGATE_FLAG_CONTRACTS);
         case "calendar":
@@ -1266,6 +1438,12 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
             return withSubcommandGlobalFlags(PAUSE_TASK_FLAG_CONTRACTS);
         case "close-task":
             return withSubcommandGlobalFlags(CLOSE_TASK_FLAG_CONTRACTS);
+        case "meet":
+            return withSubcommandGlobalFlags(MEET_FLAG_CONTRACTS);
+        case "event":
+            return withSubcommandGlobalFlags(EVENT_FLAG_CONTRACTS);
+        case "remind":
+            return withSubcommandGlobalFlags(REMIND_FLAG_CONTRACTS);
         default:
             return withSubcommandGlobalFlags([]);
     }
@@ -1357,6 +1535,7 @@ const ACTIVITY_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
 const LIST_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     ...TOOL_LIST_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
     "includeBody",
+    "noTruncate",
     "compact",
     "brief",
     "full",
@@ -1484,6 +1663,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
         optional: CREATE_CONTRACT_PARAMETER_KEYS,
     },
     copy: { required: ["id"], optional: ["title", "author", "message"] },
+    focus: { optional: ["id", "clear"], mutuallyExclusive: [["id", "clear"]] },
     list: { optional: LIST_CONTRACT_PARAMETER_KEYS },
     "list-all": { optional: LIST_CONTRACT_PARAMETER_KEYS },
     "list-draft": { optional: LIST_CONTRACT_PARAMETER_KEYS },
@@ -1521,7 +1701,28 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     schema: {
         required: ["subcommand"],
         // No --message: schema mutations write config files, not item history.
-        optional: ["name", "description", "defaultStatus", "folder", "alias", "role", "order", "author", "force"],
+        optional: [
+            "name",
+            "description",
+            "defaultStatus",
+            "folder",
+            "alias",
+            "role",
+            "order",
+            "fieldType",
+            "commands",
+            "cliFlag",
+            "required",
+            "requiredOnCreate",
+            "allowUnset",
+            "requiredTypes",
+            "typePreset",
+            "infer",
+            "minCount",
+            "apply",
+            "author",
+            "force",
+        ],
         conditionalRequired: [
             { property: "subcommand", value: "show", required: ["name"] },
             { property: "subcommand", value: "show-status", required: ["name"] },
@@ -1530,6 +1731,12 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             // show-status/add-status/remove-status pass the status id as `name`.
             { property: "subcommand", value: "add-status", required: ["name"] },
             { property: "subcommand", value: "remove-status", required: ["name"] },
+            // field subcommands pass the field key as `name`.
+            { property: "subcommand", value: "add-field", required: ["name"] },
+            { property: "subcommand", value: "remove-field", required: ["name"] },
+            { property: "subcommand", value: "show-field", required: ["name"] },
+            // apply-preset passes the preset name as `typePreset`.
+            { property: "subcommand", value: "apply-preset", required: ["typePreset"] },
         ],
     },
     plan: {
@@ -1600,7 +1807,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     append: { required: ["id", "body"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
     comments: {
         required: ["id"],
-        optional: ["text", "add", "stdin", "file", "limit", "allowAuditComment", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],
+        optional: ["text", "add", "stdin", "file", "edit", "delete", "limit", "allowAuditComment", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],
     },
     "comments-audit": {
         optional: [
@@ -1733,7 +1940,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
         required: ["runId"],
         optional: ["author"],
     },
-    stats: { optional: ["storage"] },
+    stats: { optional: ["storage", "metadataCoverage", "fieldUtilization", "byAssignee", "byTag", "byPriority", "tagPrefix"] },
     health: {
         optional: [
             "strictDirectories",
@@ -1764,6 +1971,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "includePmInternals",
             "verboseFileLists",
             "verboseDiagnostics",
+            "allAffectedIds",
             "strictExit",
             "failOnWarn",
             "fixHints",
@@ -1828,7 +2036,7 @@ function buildActionScopedToolSchema(action) {
     const required = toSchemaKeyList(contract.required ?? []);
     const optional = toSchemaKeyList(contract.optional ?? []);
     const mutationParameterKeys = PM_TOOL_ACTION_MUTATION_PARAMETER_KEYS[action] ?? [];
-    const allowedKeys = toSchemaKeyList([...PM_TOOL_GLOBAL_PARAMETER_KEYS, ...mutationParameterKeys, ...required, ...optional]);
+    const allowedKeys = toSchemaKeyList(["action", ...PM_TOOL_GLOBAL_PARAMETER_KEYS, ...mutationParameterKeys, ...required, ...optional]);
     const properties = {
         action: {
             const: action,
@@ -1856,11 +2064,11 @@ 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)) ?? [];
+    const oneOfRequiredGroups = contract.oneOfRequired;
+    if (oneOfRequiredGroups && oneOfRequiredGroups.length > 0) {
+        const allOneOfFields = oneOfRequiredGroups.flat();
+        schema.oneOf = oneOfRequiredGroups.map((requiredFields) => {
+            const otherFields = allOneOfFields.filter((field) => !requiredFields.includes(field));
             return {
                 required: [...requiredFields],
                 ...(otherFields.length > 0 ? { not: { anyOf: otherFields.map((field) => ({ required: [field] })) } } : {}),
@@ -1895,6 +2103,13 @@ function buildActionScopedToolSchema(action) {
         }
         schema.allOf = allOf;
     }
+    if (contract.mutuallyExclusive && contract.mutuallyExclusive.length > 0) {
+        const allOf = Array.isArray(schema.allOf) ? [...schema.allOf] : [];
+        for (const group of contract.mutuallyExclusive) {
+            allOf.push({ not: { required: toSchemaKeyList(group) } });
+        }
+        schema.allOf = allOf;
+    }
     return schema;
 }
 // Building the full MCP tool-parameter schemas (one variant per action) is only
@@ -1992,5 +2207,16 @@ function buildProviderCompatibleToolSchema() {
     };
 }
 export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(buildProviderCompatibleToolSchema);
+export const _testOnlyCliContracts = {
+    buildActionScopedToolSchema,
+    buildProviderCompatibleToolSchema,
+    decorateActionScopedToolParameterDefinition,
+    decorateToolParameterDefinition,
+    toolActionSchemaContracts: PM_TOOL_ACTION_SCHEMA_CONTRACTS,
+    toolParameterMetadata: PM_TOOL_PARAMETER_METADATA,
+    toProviderCompatibleParameterDefinition,
+    toUniqueFlagContracts,
+    withFlagAliasMetadata,
+};
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=0e11d981-3bc2-5584-b783-ee213f7395ba
+//# debugId=d96141cc-85b2-5835-97d9-a5ddcb542b38