@unbrained/pm-cli 2026.6.12 → 2026.6.16

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]="04e618fa-fe9c-5680-b10a-9409a7e053f0")}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" },
@@ -475,6 +508,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" },
@@ -596,6 +652,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 +687,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 +719,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 +803,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 +925,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 +1117,7 @@ export const CONTEXT_FLAG_CONTRACTS = [
     { flag: "--assignee_filter" },
     { flag: "--sprint" },
     { flag: "--release" },
+    { flag: "--parent" },
     { flag: "--limit" },
     { flag: "--format" },
     { flag: "--depth" },
@@ -1052,6 +1148,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 +1165,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 +1320,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":
@@ -1357,6 +1489,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 +1617,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 },
@@ -1600,7 +1734,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 +1867,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 +1898,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "includePmInternals",
             "verboseFileLists",
             "verboseDiagnostics",
+            "allAffectedIds",
             "strictExit",
             "failOnWarn",
             "fixHints",
@@ -1828,7 +1963,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 +1991,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 +2030,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 +2134,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=04e618fa-fe9c-5680-b10a-9409a7e053f0