npm - @unbrained/pm-cli - Versions diffs - 2026.7.4 → 2026.7.5 - Mend

@unbrained/pm-cli 2026.7.4 → 2026.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (601) hide show

package/dist/cli-bundle/chunks/{chunk-LLQLLAKU.js → chunk-PPE4YUQM.js} RENAMED Viewed

@@ -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]="4864c4b3-8a15-5324-8332-42e51eb9a217")}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]="35ca0798-2e49-5524-996c-72aaeb970d26")}catch(e){}}();
 import {
   KNOWN_EXTENSION_CAPABILITIES,
   KNOWN_EXTENSION_POLICY_MODES,
@@ -11,7 +11,7 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-SL2ANJSV.js";
+} from "./chunk-YD5FML7K.js";
 // dist/sdk/cli-contracts/commander-types.js
 var LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
@@ -155,6 +155,7 @@ var CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
     option: "--title, -t <value>",
     description: "Item title [required] (or pass title as the first positional argument)"
   },
+  { target: "id", keys: ["id"], option: "--id <value>", description: "Explicit item id (normalized with the configured id_prefix)" },
   {
     target: "description",
     keys: ["description"],
@@ -829,991 +830,935 @@ var PM_TOOL_ACTIONS = [
   "pause-task",
   "close-task"
 ];
-// dist/sdk/cli-contracts/string-lists.js
-function normalizeUniqueStringList(values) {
-  return [...new Set(Array.from(values, (value) => value.trim()).filter((value) => value.length > 0))];
+function isPmToolAction(value) {
+  return PM_TOOL_ACTIONS.includes(value);
 }
-// dist/sdk/cli-contracts/flag-contracts.js
-function normalizeFlagAliasKey(flag) {
-  if (!flag.startsWith("--")) {
-    return flag;
-  }
-  return `--${flag.slice(2).replaceAll("_", "-")}`;
+function isPmExtensionCapabilityContract(value) {
+  return PM_EXTENSION_CAPABILITY_CONTRACTS.includes(value);
 }
-function withFlagAliasMetadata(flagContracts) {
-  const aliasesByCanonical = /* @__PURE__ */ new Map();
-  for (const contract of flagContracts) {
-    const canonical = normalizeFlagAliasKey(contract.flag);
-    const bucket = aliasesByCanonical.get(canonical) ?? /* @__PURE__ */ new Set();
-    if (contract.flag !== canonical) {
-      bucket.add(contract.flag);
-    }
-    for (const alias of contract.aliases ?? []) {
-      if (alias !== canonical) {
-        bucket.add(alias);
-      }
-    }
-    aliasesByCanonical.set(canonical, bucket);
-  }
-  return flagContracts.map((contract) => {
-    const canonical = normalizeFlagAliasKey(contract.flag);
-    if (contract.flag !== canonical) {
-      return contract;
-    }
-    const aliases = normalizeUniqueStringList([
-      ...contract.aliases ?? [],
-      ...aliasesByCanonical.get(canonical)
-    ]).filter((alias) => alias !== canonical);
-    if (aliases.length === 0) {
-      return contract;
-    }
-    return {
-      ...contract,
-      aliases
-    };
-  });
+function isPmExtensionServiceNameContract(value) {
+  return PM_EXTENSION_SERVICE_NAME_CONTRACTS.includes(value);
 }
-function compactFlagAliasContracts(flagContracts) {
-  const withAliases = withFlagAliasMetadata(flagContracts);
-  const canonicalFlags = new Set(withAliases.map((contract) => contract.flag));
-  return withAliases.filter((contract) => {
-    const canonical = normalizeFlagAliasKey(contract.flag);
-    return contract.flag === canonical || !canonicalFlags.has(canonical);
-  });
+function isPmExtensionPolicyModeContract(value) {
+  return PM_EXTENSION_POLICY_MODE_CONTRACTS.includes(value);
 }
-var SUBCOMMAND_GLOBAL_FLAG_CONTRACTS = [
-  { flag: "--json" },
-  { flag: "--quiet" },
-  { flag: "--no-changed-fields" },
-  { flag: "--id-only" },
-  { flag: "--pm-path", aliases: ["--path"] },
-  { flag: "--no-extensions" },
-  { flag: "--no-pager" },
-  { flag: "--profile" },
-  { flag: "--help" }
+function isPmExtensionPolicySurfaceContract(value) {
+  return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
+}
+// dist/sdk/cli-contracts/tool-option-contracts.js
+function cloneOptionContracts(contracts) {
+  return contracts.map((contract) => ({ ...contract }));
+}
+var TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS = [
+  { param: "status", flag: "--status" },
+  { param: "type", flag: "--type" },
+  { param: "tag", flag: "--tag" },
+  { param: "priority", flag: "--priority" },
+  { param: "deadlineBefore", flag: "--deadline-before" },
+  { param: "deadlineAfter", flag: "--deadline-after" }
 ];
-var GLOBAL_FLAG_CONTRACTS = [
-  ...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,
-  { flag: "--version" }
+var TOOL_ITEM_WINDOW_FILTER_OPTION_CONTRACTS = [
+  { param: "updatedAfter", flag: "--updated-after" },
+  { param: "updatedBefore", flag: "--updated-before" },
+  { param: "createdAfter", flag: "--created-after" },
+  { param: "createdBefore", flag: "--created-before" }
 ];
-var GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS = [
-  { 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: "--filter-files-missing" },
-  { flag: "--has-docs" },
-  { flag: "--no-docs" },
-  { flag: "--filter-docs-missing" },
-  { 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" }
+var TOOL_ITEM_RELATION_FILTER_OPTION_CONTRACTS = [
+  { param: "assignee", flag: "--assignee" },
+  { param: "assigneeFilter", flag: "--assignee-filter" },
+  { param: "parent", flag: "--parent" },
+  { param: "sprint", flag: "--sprint" },
+  { param: "release", flag: "--release" }
 ];
-var MANY_GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS = [
-  { 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" }
+var TOOL_SEARCH_RELATION_FILTER_OPTION_CONTRACTS = [
+  { param: "assignee", flag: "--assignee" },
+  { param: "sprint", flag: "--sprint" },
+  { param: "release", flag: "--release" },
+  { param: "parent", flag: "--parent" }
 ];
-var LIST_FILTER_FLAG_CONTRACTS = [
-  { flag: "--status", list: true },
-  { flag: "--type" },
-  { flag: "--tag", aliases: ["--tags"] },
-  { flag: "--priority" },
-  { flag: "--deadline-before" },
-  { flag: "--deadline-after" },
-  { flag: "--updated-after" },
-  { flag: "--updated-before" },
-  { flag: "--created-after" },
-  { flag: "--created-before" },
-  { flag: "--ids", list: true },
-  { flag: "--assignee" },
-  { flag: "--assignee-filter" },
-  { flag: "--assignee_filter" },
-  { 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" },
-  ...GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS,
-  { flag: "--limit" },
-  { flag: "--offset" },
-  { flag: "--no-truncate", aliases: ["--all"] },
-  { flag: "--compact" },
-  { flag: "--brief" },
-  { flag: "--full" },
-  { flag: "--fields", list: true },
-  { flag: "--sort" },
-  { flag: "--order" },
-  { flag: "--tree" },
-  { flag: "--tree-depth" },
-  { flag: "--tree_depth" },
-  { flag: "--include-body" },
-  { flag: "--format" },
-  { flag: "--stream" }
+var TOOL_BASIC_ITEM_FILTER_OPTION_CONTRACTS = [
+  ...TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS,
+  ...TOOL_ITEM_RELATION_FILTER_OPTION_CONTRACTS
 ];
-var AGGREGATE_FLAG_CONTRACTS = [
-  { flag: "--group-by", list: true },
-  { flag: "--count" },
-  { flag: "--completion" },
-  { flag: "--sum" },
-  { flag: "--avg" },
-  { flag: "--include-unparented" },
-  { flag: "--include_unparented" },
-  { flag: "--status" },
-  { flag: "--type" },
-  { flag: "--tag" },
-  { flag: "--priority" },
-  { flag: "--deadline-before" },
-  { flag: "--deadline-after" },
-  { flag: "--assignee" },
-  { flag: "--assignee-filter" },
-  { flag: "--assignee_filter" },
-  { flag: "--parent" },
-  { flag: "--sprint" },
-  { flag: "--release" }
+var TOOL_GOVERNANCE_MISSING_OPTION_CONTRACTS = [
+  { param: "filterReviewerMissing", flag: "--filter-reviewer-missing" },
+  { param: "filterRiskMissing", flag: "--filter-risk-missing" },
+  { param: "filterConfidenceMissing", flag: "--filter-confidence-missing" },
+  { param: "filterSprintMissing", flag: "--filter-sprint-missing" },
+  { param: "filterReleaseMissing", flag: "--filter-release-missing" }
 ];
-var DEDUPE_AUDIT_FLAG_CONTRACTS = [
-  { flag: "--mode" },
-  { flag: "--limit" },
-  { flag: "--threshold" },
-  { flag: "--status" },
-  { flag: "--type" },
-  { flag: "--tag" },
-  { flag: "--priority" },
-  { flag: "--deadline-before" },
-  { flag: "--deadline-after" },
-  { flag: "--assignee" },
-  { flag: "--assignee-filter" },
-  { flag: "--assignee_filter" },
-  { flag: "--parent" },
-  { flag: "--sprint" },
-  { flag: "--release" }
+var TOOL_CONTENT_PRESENCE_OPTION_CONTRACTS = [
+  { param: "hasNotes", flag: "--has-notes" },
+  { param: "noNotes", flag: "--no-notes" },
+  { param: "hasLearnings", flag: "--has-learnings" },
+  { param: "noLearnings", flag: "--no-learnings" },
+  { param: "hasFiles", flag: "--has-files" },
+  { param: "noFiles", flag: "--no-files" },
+  { param: "filterFilesMissing", flag: "--filter-files-missing" },
+  { param: "hasDocs", flag: "--has-docs" },
+  { param: "noDocs", flag: "--no-docs" },
+  { param: "filterDocsMissing", flag: "--filter-docs-missing" },
+  { param: "hasTests", flag: "--has-tests" },
+  { param: "noTests", flag: "--no-tests" },
+  { param: "hasComments", flag: "--has-comments" },
+  { param: "noComments", flag: "--no-comments" },
+  { param: "hasDeps", flag: "--has-deps" },
+  { param: "noDeps", flag: "--no-deps" },
+  { param: "hasBody", flag: "--has-body" },
+  { param: "emptyBody", flag: "--empty-body" },
+  { param: "hasLinkedCommand", flag: "--has-linked-command" },
+  { param: "noLinkedCommand", flag: "--no-linked-command" }
 ];
-var DEDUPE_MERGE_FLAG_CONTRACTS = [
-  { flag: "--keep" },
-  { flag: "--close", list: true },
-  { flag: "--apply" },
-  { flag: "--dry-run" },
-  { flag: "--skip-children" },
-  { flag: "--author" },
-  { flag: "--message" }
-];
-var COMMENTS_AUDIT_FLAG_CONTRACTS = [
-  { flag: "--status" },
-  { flag: "--type" },
-  { flag: "--assignee" },
-  { flag: "--assignee-filter" },
-  { flag: "--assignee_filter" },
-  { flag: "--parent" },
-  { flag: "--tag" },
-  { flag: "--sprint" },
-  { flag: "--release" },
-  { flag: "--priority" },
-  { flag: "--limit-items" },
-  { flag: "--limit" },
-  { flag: "--full-history" },
-  { flag: "--latest" }
-];
-var COMMENTS_FLAG_CONTRACTS = [
-  { flag: "--add", aliases: ["--comment"] },
-  { flag: "--stdin" },
-  { flag: "--file" },
-  { flag: "--edit" },
-  { flag: "--delete" },
-  { flag: "--limit" },
-  { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--allow-audit-comment" },
-  { flag: "--force" }
-];
-var NOTES_FLAG_CONTRACTS = [
-  { flag: "--add", aliases: ["--note"] },
-  { flag: "--limit" },
-  { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--allow-audit-note" },
-  { flag: "--allow-audit-comment" },
-  { flag: "--force" }
+var TOOL_LIST_FILTER_OPTION_CONTRACTS = [
+  ...cloneOptionContracts(TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS),
+  ...cloneOptionContracts(TOOL_ITEM_WINDOW_FILTER_OPTION_CONTRACTS),
+  { param: "ids", flag: "--ids" },
+  ...cloneOptionContracts(TOOL_ITEM_RELATION_FILTER_OPTION_CONTRACTS),
+  { param: "filterAcMissing", flag: "--filter-ac-missing" },
+  { param: "filterEstimatesMissing", flag: "--filter-estimates-missing" },
+  { param: "filterResolutionMissing", flag: "--filter-resolution-missing" },
+  { param: "filterMetadataMissing", flag: "--filter-metadata-missing" },
+  ...cloneOptionContracts(TOOL_GOVERNANCE_MISSING_OPTION_CONTRACTS),
+  ...cloneOptionContracts(TOOL_CONTENT_PRESENCE_OPTION_CONTRACTS),
+  { param: "limit", flag: "--limit" },
+  { param: "offset", flag: "--offset" },
+  { param: "fields", flag: "--fields" },
+  { param: "sort", flag: "--sort" },
+  { param: "order", flag: "--order" },
+  { param: "tree", flag: "--tree" },
+  { param: "treeDepth", flag: "--tree-depth" }
 ];
-var LEARNINGS_FLAG_CONTRACTS = [
-  { flag: "--add", aliases: ["--learning"] },
-  { flag: "--limit" },
-  { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--allow-audit-learning" },
-  { flag: "--allow-audit-comment" },
-  { flag: "--force" }
+var TOOL_AGGREGATE_OPTION_CONTRACTS = [
+  { param: "groupBy", flag: "--group-by" },
+  { param: "sum", flag: "--sum" },
+  { param: "avg", flag: "--avg" },
+  ...cloneOptionContracts(TOOL_BASIC_ITEM_FILTER_OPTION_CONTRACTS)
 ];
-var FILES_FLAG_CONTRACTS = [
-  { flag: "--add" },
-  { 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" },
-  { flag: "--audit" },
-  { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--force" }
+var TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS = [
+  { param: "mode", flag: "--mode" },
+  { param: "limit", flag: "--limit" },
+  { param: "threshold", flag: "--threshold" },
+  ...cloneOptionContracts(TOOL_BASIC_ITEM_FILTER_OPTION_CONTRACTS)
 ];
-var DOCS_FLAG_CONTRACTS = [
-  { flag: "--add" },
-  { 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" },
-  { flag: "--message" },
-  { flag: "--force" }
+var TOOL_SEARCH_FILTER_OPTION_CONTRACTS = [
+  { param: "matchMode", flag: "--match-mode" },
+  { param: "minScore", flag: "--min-score" },
+  { param: "count", flag: "--count", booleanish: true },
+  { param: "semanticWeight", flag: "--semantic-weight" },
+  ...cloneOptionContracts(TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS),
+  ...cloneOptionContracts(TOOL_ITEM_WINDOW_FILTER_OPTION_CONTRACTS),
+  ...cloneOptionContracts(TOOL_SEARCH_RELATION_FILTER_OPTION_CONTRACTS),
+  ...cloneOptionContracts(TOOL_GOVERNANCE_MISSING_OPTION_CONTRACTS),
+  ...cloneOptionContracts(TOOL_CONTENT_PRESENCE_OPTION_CONTRACTS),
+  { param: "fields", flag: "--fields" },
+  { param: "limit", flag: "--limit" }
 ];
-var HISTORY_FLAG_CONTRACTS = [
-  { flag: "--limit" },
-  { flag: "--compact" },
-  { flag: "--full" },
-  { flag: "--diff" },
-  { flag: "--field" },
-  { flag: "--verify" },
-  { flag: "--format" }
+var TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = [
+  { param: "parent", flag: "--parent" },
+  { param: "reviewer", flag: "--reviewer" },
+  { param: "risk", flag: "--risk" },
+  { param: "confidence", flag: "--confidence" },
+  { param: "sprint", flag: "--sprint" },
+  { param: "release", flag: "--release" },
+  { param: "blockedBy", flag: "--blocked-by" },
+  { param: "blockedReason", flag: "--blocked-reason" },
+  { param: "unblockNote", flag: "--unblock-note" },
+  { param: "reporter", flag: "--reporter" },
+  { param: "severity", flag: "--severity" },
+  { param: "environment", flag: "--environment" },
+  { param: "reproSteps", flag: "--repro-steps" },
+  { param: "resolution", flag: "--resolution" },
+  { param: "expectedResult", flag: "--expected-result" },
+  { param: "actualResult", flag: "--actual-result" },
+  { param: "affectedVersion", flag: "--affected-version" },
+  { param: "fixedVersion", flag: "--fixed-version" },
+  { param: "component", flag: "--component" },
+  { param: "regression", flag: "--regression", booleanish: true },
+  { param: "customerImpact", flag: "--customer-impact" },
+  { param: "definitionOfReady", flag: "--definition-of-ready", allowEmpty: true },
+  { param: "order", flag: "--order" },
+  { param: "goal", flag: "--goal" },
+  { param: "objective", flag: "--objective" },
+  { param: "value", flag: "--value" },
+  { param: "impact", flag: "--impact" },
+  { param: "outcome", flag: "--outcome" },
+  { param: "whyNow", flag: "--why-now" }
 ];
-var HISTORY_REDACT_FLAG_CONTRACTS = [
-  { flag: "--literal" },
-  { flag: "--regex" },
-  { flag: "--replacement" },
-  { flag: "--dry-run" },
-  { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--force" }
+var TOOL_CREATE_OPTION_CONTRACTS = [
+  { param: "title", flag: "--title" },
+  { param: "description", flag: "--description", allowEmpty: true },
+  { param: "type", flag: "--type" },
+  { param: "template", flag: "--template" },
+  { param: "createMode", flag: "--create-mode" },
+  { param: "schedulePreset", flag: "--schedule-preset" },
+  { param: "status", flag: "--status" },
+  { param: "priority", flag: "--priority" },
+  { param: "tags", flag: "--tags", allowEmpty: true },
+  { param: "addTags", flag: "--add-tags", repeatable: true },
+  { param: "body", flag: "--body", allowEmpty: true },
+  { param: "deadline", flag: "--deadline" },
+  { param: "estimate", flag: "--estimate" },
+  { param: "acceptanceCriteria", flag: "--acceptance-criteria", allowEmpty: true },
+  { param: "author", flag: "--author" },
+  { param: "message", flag: "--message", allowEmpty: true },
+  { param: "assignee", flag: "--assignee" },
+  { param: "allowMissingParent", flag: "--allow-missing-parent" },
+  { param: "reminder", flag: "--reminder", repeatable: true },
+  { param: "event", flag: "--event", repeatable: true },
+  { param: "typeOption", flag: "--type-option", repeatable: true },
+  { param: "field", flag: "--field", repeatable: true },
+  { param: "dep", flag: "--dep", repeatable: true },
+  { param: "comment", flag: "--comment", repeatable: true },
+  { param: "note", flag: "--note", repeatable: true },
+  { param: "learning", flag: "--learning", repeatable: true },
+  { param: "linkedFile", flag: "--file", repeatable: true },
+  { param: "linkedTest", flag: "--test", repeatable: true },
+  { param: "doc", flag: "--doc", repeatable: true },
+  { param: "unset", flag: "--unset", repeatable: true },
+  { param: "clearDeps", flag: "--clear-deps" },
+  { param: "clearComments", flag: "--clear-comments" },
+  { param: "clearNotes", flag: "--clear-notes" },
+  { param: "clearLearnings", flag: "--clear-learnings" },
+  { param: "clearFiles", flag: "--clear-files" },
+  { param: "clearTests", flag: "--clear-tests" },
+  { param: "clearDocs", flag: "--clear-docs" },
+  { param: "clearReminders", flag: "--clear-reminders" },
+  { param: "clearEvents", flag: "--clear-events" },
+  { param: "clearTypeOptions", flag: "--clear-type-options" }
 ];
-var HISTORY_REPAIR_FLAG_CONTRACTS = [
-  { flag: "--all" },
-  { flag: "--dry-run" },
-  { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--force" }
+var TOOL_UPDATE_OPTION_CONTRACTS = [
+  { param: "title", flag: "--title" },
+  { param: "description", flag: "--description", allowEmpty: true },
+  { param: "body", flag: "--body", allowEmpty: true },
+  { param: "status", flag: "--status" },
+  { param: "closeReason", flag: "--close-reason" },
+  { param: "priority", flag: "--priority" },
+  { param: "type", flag: "--type" },
+  { param: "tags", flag: "--tags", allowEmpty: true },
+  { param: "addTags", flag: "--add-tags", repeatable: true },
+  { param: "removeTags", flag: "--remove-tags", repeatable: true },
+  { param: "deadline", flag: "--deadline" },
+  { param: "estimate", flag: "--estimate" },
+  { param: "acceptanceCriteria", flag: "--acceptance-criteria", allowEmpty: true },
+  { param: "author", flag: "--author" },
+  { param: "message", flag: "--message", allowEmpty: true },
+  { param: "assignee", flag: "--assignee" },
+  { param: "dep", flag: "--dep", repeatable: true },
+  { param: "depRemove", flag: "--dep-remove", repeatable: true },
+  { param: "replaceDeps", flag: "--replace-deps" },
+  { param: "replaceTests", flag: "--replace-tests" },
+  { param: "comment", flag: "--comment", repeatable: true },
+  { param: "note", flag: "--note", repeatable: true },
+  { param: "learning", flag: "--learning", repeatable: true },
+  { param: "linkedFile", flag: "--file", repeatable: true },
+  { param: "linkedTest", flag: "--test", repeatable: true },
+  { param: "doc", flag: "--doc", repeatable: true },
+  { param: "reminder", flag: "--reminder", repeatable: true },
+  { param: "event", flag: "--event", repeatable: true },
+  { param: "typeOption", flag: "--type-option", repeatable: true },
+  { param: "field", flag: "--field", repeatable: true },
+  { param: "unset", flag: "--unset", repeatable: true },
+  { param: "clearDeps", flag: "--clear-deps" },
+  { param: "clearComments", flag: "--clear-comments" },
+  { param: "clearNotes", flag: "--clear-notes" },
+  { param: "clearLearnings", flag: "--clear-learnings" },
+  { param: "clearFiles", flag: "--clear-files" },
+  { param: "clearTests", flag: "--clear-tests" },
+  { param: "clearDocs", flag: "--clear-docs" },
+  { param: "clearReminders", flag: "--clear-reminders" },
+  { param: "clearEvents", flag: "--clear-events" },
+  { param: "clearTypeOptions", flag: "--clear-type-options" },
+  { param: "allowAuditUpdate", flag: "--allow-audit-update" },
+  { param: "allowAuditDepUpdate", flag: "--allow-audit-dep-update" }
 ];
-var HISTORY_COMPACT_FLAG_CONTRACTS = [
-  { flag: "--before" },
-  { flag: "--ids", list: true },
-  { flag: "--all-over", value_type: "number" },
-  { flag: "--closed" },
-  { flag: "--all-streams" },
-  { flag: "--min-entries", value_type: "number" },
-  { flag: "--dry-run" },
-  { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--force" }
-];
-var SCHEMA_FLAG_CONTRACTS = [
-  { flag: "--description" },
-  { flag: "--default-status", aliases: ["--default_status"] },
-  { flag: "--folder" },
-  { flag: "--alias" },
-  // --role is a repeatable Commander collect flag (NOT a comma-list contract),
-  // mirroring --alias; list:false keeps the bootstrap coalescer from corrupting
-  // 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" }
+var TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS = [
+  { param: "filterStatus", flag: "--filter-status" },
+  { param: "filterType", flag: "--filter-type" },
+  { param: "filterTag", flag: "--filter-tag" },
+  { param: "filterPriority", flag: "--filter-priority" },
+  { param: "filterDeadlineBefore", flag: "--filter-deadline-before" },
+  { param: "filterDeadlineAfter", flag: "--filter-deadline-after" },
+  { param: "filterUpdatedAfter", flag: "--filter-updated-after" },
+  { param: "filterUpdatedBefore", flag: "--filter-updated-before" },
+  { param: "filterCreatedAfter", flag: "--filter-created-after" },
+  { param: "filterCreatedBefore", flag: "--filter-created-before" },
+  { param: "filterAssignee", flag: "--filter-assignee" },
+  { param: "filterAssigneeFilter", flag: "--filter-assignee-filter" },
+  { param: "filterParent", flag: "--filter-parent" },
+  { param: "filterSprint", flag: "--filter-sprint" },
+  { param: "filterRelease", flag: "--filter-release" },
+  { param: "filterReviewerMissing", flag: "--filter-reviewer-missing" },
+  { param: "filterRiskMissing", flag: "--filter-risk-missing" },
+  { param: "filterConfidenceMissing", flag: "--filter-confidence-missing" },
+  { param: "filterSprintMissing", flag: "--filter-sprint-missing" },
+  { param: "filterReleaseMissing", flag: "--filter-release-missing" },
+  { param: "filterHasNotes", flag: "--filter-has-notes" },
+  { param: "filterNoNotes", flag: "--filter-no-notes" },
+  { param: "filterHasLearnings", flag: "--filter-has-learnings" },
+  { param: "filterNoLearnings", flag: "--filter-no-learnings" },
+  { param: "filterHasFiles", flag: "--filter-has-files" },
+  { param: "filterNoFiles", flag: "--filter-no-files" },
+  { param: "filterHasDocs", flag: "--filter-has-docs" },
+  { param: "filterNoDocs", flag: "--filter-no-docs" },
+  { param: "filterHasTests", flag: "--filter-has-tests" },
+  { param: "filterNoTests", flag: "--filter-no-tests" },
+  { param: "filterHasComments", flag: "--filter-has-comments" },
+  { param: "filterNoComments", flag: "--filter-no-comments" },
+  { param: "filterHasDeps", flag: "--filter-has-deps" },
+  { param: "filterNoDeps", flag: "--filter-no-deps" },
+  { param: "filterHasBody", flag: "--filter-has-body" },
+  { param: "filterEmptyBody", flag: "--filter-empty-body" },
+  { param: "filterHasLinkedCommand", flag: "--filter-has-linked-command" },
+  { param: "filterNoLinkedCommand", flag: "--filter-no-linked-command" },
+  { param: "ids", flag: "--ids" },
+  { param: "limit", flag: "--limit" },
+  { param: "offset", flag: "--offset" }
 ];
-var PROFILE_FLAG_CONTRACTS = [
-  { flag: "--dry-run" },
-  { flag: "--author" },
-  { flag: "--force" }
+var TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [
+  ...cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS)
 ];
-var PLAN_FLAG_CONTRACTS = [
-  { flag: "--title" },
-  { flag: "--description" },
-  { flag: "--scope" },
-  { flag: "--parent" },
-  { flag: "--related" },
-  { flag: "--blocks" },
-  { flag: "--blocked-by", aliases: ["--blocked_by"] },
-  { flag: "--harness" },
-  { flag: "--mode" },
-  { flag: "--resume-context", aliases: ["--resume_context"] },
-  { flag: "--tags", aliases: ["--tag"], list: true },
-  { flag: "--priority" },
-  { flag: "--body" },
-  { flag: "--claim" },
-  { flag: "--from-search", aliases: ["--from_search"] },
-  { flag: "--template" },
-  { 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"] },
-  { flag: "--step-evidence", aliases: ["--step_evidence"] },
-  { flag: "--step-blocked-reason", aliases: ["--step_blocked_reason"] },
-  { flag: "--step-replacement", aliases: ["--step_replacement"] },
-  { flag: "--depends-on", aliases: ["--depends_on"] },
-  { flag: "--link" },
-  { flag: "--link-kind", aliases: ["--link_kind"] },
-  { flag: "--link-note", aliases: ["--link_note"] },
-  { flag: "--promote-to-item-dep", aliases: ["--promote_to_item_dep"] },
-  { flag: "--allow-multiple-active", aliases: ["--allow_multiple_active"] },
-  { flag: "--file" },
-  { flag: "--test" },
-  { flag: "--doc" },
-  { flag: "--decision-text", aliases: ["--decision_text", "--decision"] },
-  { flag: "--decision-rationale", aliases: ["--decision_rationale"] },
-  { flag: "--decision-evidence", aliases: ["--decision_evidence"] },
-  { flag: "--discovery-text", aliases: ["--discovery_text", "--discovery"] },
-  { flag: "--validation-text", aliases: ["--validation_text", "--validation"] },
-  { flag: "--validation-command", aliases: ["--validation_command"] },
-  { flag: "--validation-expected", aliases: ["--validation_expected"] },
-  { flag: "--depth" },
-  { flag: "--fields", list: true },
-  { flag: "--steps" },
-  { flag: "--materialize-type", aliases: ["--materialize_type"] },
-  { flag: "--materialize-parent", aliases: ["--materialize_parent"] },
-  { flag: "--materialize-tags", aliases: ["--materialize_tags"] },
-  { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--force" }
+var TOOL_NORMALIZE_FILTER_OPTION_CONTRACTS = [
+  { param: "filterStatus", flag: "--filter-status" },
+  { param: "filterType", flag: "--filter-type" },
+  { param: "filterTag", flag: "--filter-tag" },
+  { param: "filterPriority", flag: "--filter-priority" },
+  { param: "filterDeadlineBefore", flag: "--filter-deadline-before" },
+  { param: "filterDeadlineAfter", flag: "--filter-deadline-after" },
+  { param: "filterAssignee", flag: "--filter-assignee" },
+  { param: "filterAssigneeFilter", flag: "--filter-assignee-filter" },
+  { param: "filterParent", flag: "--filter-parent" },
+  { param: "filterSprint", flag: "--filter-sprint" },
+  { param: "filterRelease", flag: "--filter-release" },
+  { param: "limit", flag: "--limit" },
+  { param: "offset", flag: "--offset" }
 ];
-var INIT_FLAG_CONTRACTS = [
-  { flag: "--preset" },
-  { flag: "--type-preset" },
-  { flag: "--defaults", short: "-y", aliases: ["--yes"] },
-  { flag: "--author" },
-  { flag: "--agent-guidance" },
-  { flag: "--with-packages" },
-  { flag: "--force" },
-  { flag: "--verbose" }
+var TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS = [
+  ...cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS)
 ];
-var CONFIG_FLAG_CONTRACTS = [
-  { flag: "--criterion" },
-  { flag: "--clear-criteria" },
-  { flag: "--format" },
-  { flag: "--policy" },
-  { flag: "--default-depth" },
-  { flag: "--activity-limit" },
-  { flag: "--stale-threshold-days" },
-  { flag: "--section-hierarchy" },
-  { flag: "--section-activity" },
-  { flag: "--section-progress" },
-  { flag: "--section-blockers" },
-  { flag: "--section-files" },
-  { flag: "--section-workload" },
-  { flag: "--section-staleness" },
-  { flag: "--section-tests" }
+var TOOL_CALENDAR_OPTION_CONTRACTS = [
+  { param: "view", flag: "--view" },
+  { param: "date", flag: "--date" },
+  { param: "from", flag: "--from" },
+  { param: "to", flag: "--to" },
+  { param: "type", flag: "--type" },
+  { param: "tag", flag: "--tag" },
+  { param: "priority", flag: "--priority" },
+  { param: "status", flag: "--status" },
+  { param: "assignee", flag: "--assignee" },
+  { param: "assigneeFilter", flag: "--assignee-filter" },
+  { param: "sprint", flag: "--sprint" },
+  { param: "release", flag: "--release" },
+  { param: "include", flag: "--include" },
+  { param: "recurrenceLookaheadDays", flag: "--recurrence-lookahead-days" },
+  { param: "recurrenceLookbackDays", flag: "--recurrence-lookback-days" },
+  { param: "occurrenceLimit", flag: "--occurrence-limit" },
+  { param: "limit", flag: "--limit" },
+  { param: "format", flag: "--format" }
 ];
-var EXTENSION_FLAG_CONTRACTS = [
-  { flag: "--init" },
-  { flag: "--scaffold" },
-  { flag: "--capability" },
-  { flag: "--install" },
-  { flag: "--uninstall" },
-  { flag: "--explore" },
-  { flag: "--list" },
-  { flag: "--manage" },
-  { flag: "--describe" },
-  { flag: "--markdown" },
-  { flag: "--output" },
-  { flag: "--reload" },
-  { flag: "--watch" },
-  { flag: "--doctor" },
-  { flag: "--catalog" },
-  { flag: "--adopt" },
-  { flag: "--adopt-all" },
-  { flag: "--activate" },
-  { flag: "--deactivate" },
-  { flag: "--project" },
-  { flag: "--local" },
-  { flag: "--global" },
-  { flag: "--gh" },
-  { flag: "--github" },
-  { flag: "--ref" },
-  { flag: "--detail" },
-  { flag: "--trace" },
-  { flag: "--runtime-probe" },
-  { flag: "--fix-managed-state" },
-  { flag: "--strict-exit" },
-  { flag: "--fail-on-warn" }
+var TOOL_ACTIVITY_OPTION_CONTRACTS = [
+  { param: "id", flag: "--id" },
+  { param: "op", flag: "--op" },
+  { param: "author", flag: "--author" },
+  { param: "from", flag: "--from" },
+  { param: "to", flag: "--to" },
+  { param: "limit", flag: "--limit" },
+  { param: "compact", flag: "--compact" },
+  { param: "full", flag: "--full" }
 ];
-var EXTENSION_SCOPE_FLAG_CONTRACTS = [
-  { flag: "--project" },
-  { flag: "--local" },
-  { flag: "--global" }
+var TOOL_CONTEXT_OPTION_CONTRACTS = [
+  { param: "date", flag: "--date" },
+  { param: "from", flag: "--from" },
+  { param: "to", flag: "--to" },
+  { param: "type", flag: "--type" },
+  { param: "tag", flag: "--tag" },
+  { param: "priority", flag: "--priority" },
+  { param: "assignee", flag: "--assignee" },
+  { param: "assigneeFilter", flag: "--assignee-filter" },
+  { param: "sprint", flag: "--sprint" },
+  { param: "release", flag: "--release" },
+  { param: "parent", flag: "--parent" },
+  { param: "limit", flag: "--limit" },
+  { param: "format", flag: "--format" },
+  { param: "depth", flag: "--depth" },
+  { param: "fields", flag: "--fields" },
+  { param: "section", flag: "--section", repeatable: true },
+  { param: "activityLimit", flag: "--activity-limit" },
+  { param: "staleThreshold", flag: "--stale-threshold" }
 ];
-var EXTENSION_INIT_FLAG_CONTRACTS = [
-  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-  { flag: "--capability" }
+var TOOL_DEPS_OPTION_CONTRACTS = [
+  { param: "format", flag: "--format" },
+  { param: "maxDepth", flag: "--max-depth" },
+  { param: "collapse", flag: "--collapse" },
+  { param: "summary", flag: "--summary" }
 ];
-var PACKAGE_FLAG_CONTRACTS = [...EXTENSION_FLAG_CONTRACTS, { flag: "--declarative" }];
-var PACKAGE_INIT_FLAG_CONTRACTS = [...EXTENSION_INIT_FLAG_CONTRACTS, { flag: "--declarative" }];
-var EXTENSION_INSTALL_FLAG_CONTRACTS = [
-  { flag: "--project" },
-  { flag: "--local" },
-  { flag: "--global" },
-  { flag: "--gh" },
-  { flag: "--github" },
-  { flag: "--ref" }
-];
-var EXTENSION_UNINSTALL_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
-var EXTENSION_EXPLORE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
-var EXTENSION_DESCRIBE_FLAG_CONTRACTS = [
-  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-  { flag: "--markdown" },
-  { flag: "--output" }
-];
-var EXTENSION_ADOPT_ALL_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
-var EXTENSION_ACTIVATE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
-var EXTENSION_DEACTIVATE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
-var EXTENSION_MANAGE_FLAG_CONTRACTS = [
-  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-  { flag: "--runtime-probe" },
-  { flag: "--fix-managed-state" }
-];
-var EXTENSION_RELOAD_FLAG_CONTRACTS = [
-  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-  { flag: "--watch" }
+// dist/sdk/cli-contracts/string-lists.js
+function normalizeUniqueStringList(values) {
+  return [...new Set(Array.from(values, (value) => value.trim()).filter((value) => value.length > 0))];
+}
+// dist/sdk/cli-contracts/flag-contracts.js
+function normalizeFlagAliasKey(flag) {
+  if (!flag.startsWith("--")) {
+    return flag;
+  }
+  return `--${flag.slice(2).replaceAll("_", "-")}`;
+}
+function withFlagAliasMetadata(flagContracts) {
+  const aliasesByCanonical = /* @__PURE__ */ new Map();
+  for (const contract of flagContracts) {
+    const canonical = normalizeFlagAliasKey(contract.flag);
+    const bucket = aliasesByCanonical.get(canonical) ?? /* @__PURE__ */ new Set();
+    if (contract.flag !== canonical) {
+      bucket.add(contract.flag);
+    }
+    for (const alias of contract.aliases ?? []) {
+      if (alias !== canonical) {
+        bucket.add(alias);
+      }
+    }
+    aliasesByCanonical.set(canonical, bucket);
+  }
+  return flagContracts.map((contract) => {
+    const canonical = normalizeFlagAliasKey(contract.flag);
+    if (contract.flag !== canonical) {
+      return contract;
+    }
+    const aliases = normalizeUniqueStringList([
+      ...contract.aliases ?? [],
+      ...aliasesByCanonical.get(canonical)
+    ]).filter((alias) => alias !== canonical);
+    if (aliases.length === 0) {
+      return contract;
+    }
+    return {
+      ...contract,
+      aliases
+    };
+  });
+}
+function compactFlagAliasContracts(flagContracts) {
+  const withAliases = withFlagAliasMetadata(flagContracts);
+  const canonicalFlags = new Set(withAliases.map((contract) => contract.flag));
+  return withAliases.filter((contract) => {
+    const canonical = normalizeFlagAliasKey(contract.flag);
+    return contract.flag === canonical || !canonicalFlags.has(canonical);
+  });
+}
+var SUBCOMMAND_GLOBAL_FLAG_CONTRACTS = [
+  { flag: "--json" },
+  { flag: "--quiet" },
+  { flag: "--no-changed-fields" },
+  { flag: "--id-only" },
+  { flag: "--pm-path", aliases: ["--path"] },
+  { flag: "--no-extensions" },
+  { flag: "--no-pager" },
+  { flag: "--profile" },
+  { flag: "--help" }
 ];
-var EXTENSION_DOCTOR_FLAG_CONTRACTS = [
-  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-  { flag: "--detail" },
-  { flag: "--trace" },
-  { flag: "--fix-managed-state" },
-  { flag: "--strict-exit" },
-  { flag: "--fail-on-warn" }
+var GLOBAL_FLAG_CONTRACTS = [
+  ...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,
+  { flag: "--version" }
 ];
-var EXTENSION_CATALOG_FLAG_CONTRACTS = [
-  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-  { flag: "--fields", list: true }
+var GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS = [
+  { 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: "--filter-files-missing" },
+  { flag: "--has-docs" },
+  { flag: "--no-docs" },
+  { flag: "--filter-docs-missing" },
+  { 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" }
 ];
-var EXTENSION_ADOPT_FLAG_CONTRACTS = [
-  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-  { flag: "--gh" },
-  { flag: "--github" },
-  { flag: "--ref" }
+var MANY_GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS = [
+  { 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" }
 ];
-var INSTALL_FLAG_CONTRACTS = [
-  { flag: "--project" },
-  { flag: "--local" },
-  { flag: "--global" },
-  { flag: "--gh" },
-  { flag: "--github" },
-  { flag: "--ref" }
+var LIST_FILTER_FLAG_CONTRACTS = [
+  { flag: "--status", list: true },
+  { flag: "--type" },
+  { flag: "--tag", aliases: ["--tags"] },
+  { flag: "--priority" },
+  { flag: "--deadline-before" },
+  { flag: "--deadline-after" },
+  { flag: "--updated-after" },
+  { flag: "--updated-before" },
+  { flag: "--created-after" },
+  { flag: "--created-before" },
+  { flag: "--ids", list: true },
+  { flag: "--assignee" },
+  { flag: "--assignee-filter" },
+  { flag: "--assignee_filter" },
+  { 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" },
+  ...GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS,
+  { flag: "--limit" },
+  { flag: "--offset" },
+  { flag: "--no-truncate", aliases: ["--all"] },
+  { flag: "--compact" },
+  { flag: "--brief" },
+  { flag: "--full" },
+  { flag: "--fields", list: true },
+  { flag: "--sort" },
+  { flag: "--order" },
+  { flag: "--tree" },
+  { flag: "--tree-depth" },
+  { flag: "--tree_depth" },
+  { flag: "--include-body" },
+  { flag: "--format" },
+  { flag: "--stream" }
 ];
-var UPGRADE_FLAG_CONTRACTS = [
-  { flag: "--dry-run" },
-  { flag: "--cli-only" },
-  { flag: "--packages-only" },
-  { flag: "--project" },
-  { flag: "--local" },
-  { flag: "--global" },
-  { flag: "--repair" },
+var AGGREGATE_FLAG_CONTRACTS = [
+  { flag: "--group-by", list: true },
+  { flag: "--count" },
+  { flag: "--completion" },
+  { flag: "--sum" },
+  { flag: "--avg" },
+  { flag: "--include-unparented" },
+  { flag: "--include_unparented" },
+  { flag: "--status" },
+  { flag: "--type" },
   { flag: "--tag" },
-  { flag: "--package-name" }
+  { flag: "--priority" },
+  { flag: "--deadline-before" },
+  { flag: "--deadline-after" },
+  { flag: "--assignee" },
+  { flag: "--assignee-filter" },
+  { flag: "--assignee_filter" },
+  { flag: "--parent" },
+  { flag: "--sprint" },
+  { flag: "--release" }
 ];
-var REINDEX_FLAG_CONTRACTS = [
+var DEDUPE_AUDIT_FLAG_CONTRACTS = [
   { flag: "--mode" },
-  { flag: "--progress" }
+  { flag: "--limit" },
+  { flag: "--threshold" },
+  { flag: "--status" },
+  { flag: "--type" },
+  { flag: "--tag" },
+  { flag: "--priority" },
+  { flag: "--deadline-before" },
+  { flag: "--deadline-after" },
+  { flag: "--assignee" },
+  { flag: "--assignee-filter" },
+  { flag: "--assignee_filter" },
+  { flag: "--parent" },
+  { flag: "--sprint" },
+  { flag: "--release" }
 ];
-var CLOSE_FLAG_CONTRACTS = [
-  { flag: "--reason" },
-  { flag: "--close-reason" },
-  { flag: "--duplicate-of" },
+var DEDUPE_MERGE_FLAG_CONTRACTS = [
+  { flag: "--keep" },
+  { flag: "--close", list: true },
+  { flag: "--apply" },
+  { flag: "--dry-run" },
+  { flag: "--skip-children" },
+  { flag: "--author" },
+  { flag: "--message" }
+];
+var COMMENTS_AUDIT_FLAG_CONTRACTS = [
+  { flag: "--status" },
+  { flag: "--type" },
+  { flag: "--assignee" },
+  { flag: "--assignee-filter" },
+  { flag: "--assignee_filter" },
+  { flag: "--parent" },
+  { flag: "--tag" },
+  { flag: "--sprint" },
+  { flag: "--release" },
+  { flag: "--priority" },
+  { flag: "--limit-items" },
+  { flag: "--limit" },
+  { flag: "--full-history" },
+  { flag: "--latest" }
+];
+var COMMENTS_FLAG_CONTRACTS = [
+  { flag: "--add", aliases: ["--comment"] },
+  { flag: "--stdin" },
+  { flag: "--file" },
+  { flag: "--edit" },
+  { flag: "--delete" },
+  { flag: "--limit" },
   { flag: "--author" },
   { flag: "--message" },
-  { flag: "--validate-close" },
-  // pm-fl0c #11 (2026-05-28) + Codex P2 follow-up: inline closure-validation
-  // fields. Surface them through the contract so `pm contracts --command
-  // close`, the JSON help payload, and bootstrap flag normalization /
-  // suggestions all stay consistent with the commander registration.
-  { flag: "--resolution" },
-  { flag: "--expected-result", aliases: ["--expected_result", "--expected"] },
-  { flag: "--actual-result", aliases: ["--actual_result", "--actual"] },
+  { flag: "--allow-audit-comment" },
   { flag: "--force" }
 ];
-var CLOSE_MANY_FLAG_CONTRACTS = [
-  { flag: "--filter-status", list: true },
-  { flag: "--filter-type" },
-  { flag: "--filter-tag" },
-  { flag: "--filter-priority" },
-  { flag: "--filter-deadline-before" },
-  { flag: "--filter-deadline-after" },
-  { flag: "--filter-updated-after" },
-  { flag: "--filter-updated-before" },
-  { flag: "--filter-created-after" },
-  { flag: "--filter-created-before" },
-  { flag: "--filter-assignee" },
-  { flag: "--filter-assignee-filter" },
-  { flag: "--filter-assignee_filter" },
-  { flag: "--filter-parent" },
-  { flag: "--filter-sprint" },
-  { flag: "--filter-release" },
-  ...MANY_GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS,
-  { flag: "--reason" },
-  { flag: "--resolution" },
-  { flag: "--expected-result", aliases: ["--expected_result", "--expected"] },
-  { flag: "--actual-result", aliases: ["--actual_result", "--actual"] },
-  { flag: "--validate-close" },
+var NOTES_FLAG_CONTRACTS = [
+  { flag: "--add", aliases: ["--note"] },
+  { flag: "--limit" },
   { flag: "--author" },
   { flag: "--message" },
-  { flag: "--force" },
-  { flag: "--dry-run" },
-  { flag: "--rollback" },
-  { flag: "--no-checkpoint" }
+  { flag: "--allow-audit-note" },
+  { flag: "--allow-audit-comment" },
+  { flag: "--force" }
 ];
-var APPEND_FLAG_CONTRACTS = [
-  { flag: "--body", short: "-b" },
+var LEARNINGS_FLAG_CONTRACTS = [
+  { flag: "--add", aliases: ["--learning"] },
+  { flag: "--limit" },
   { flag: "--author" },
   { flag: "--message" },
+  { flag: "--allow-audit-learning" },
+  { flag: "--allow-audit-comment" },
   { flag: "--force" }
 ];
-var CLAIM_FLAG_CONTRACTS = [
+var FILES_FLAG_CONTRACTS = [
+  { flag: "--add" },
+  { 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" },
+  { flag: "--audit" },
   { flag: "--author" },
   { flag: "--message" },
   { flag: "--force" }
 ];
-var RESTORE_FLAG_CONTRACTS = [
+var DOCS_FLAG_CONTRACTS = [
+  { flag: "--add" },
+  { 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" },
   { flag: "--message" },
   { flag: "--force" }
 ];
-var DELETE_FLAG_CONTRACTS = [
+var HISTORY_FLAG_CONTRACTS = [
+  { flag: "--limit" },
+  { flag: "--compact" },
+  { flag: "--full" },
+  { flag: "--diff" },
+  { flag: "--field" },
+  { flag: "--verify" },
+  { flag: "--format" }
+];
+var HISTORY_REDACT_FLAG_CONTRACTS = [
+  { flag: "--literal" },
+  { flag: "--regex" },
+  { flag: "--replacement" },
   { flag: "--dry-run" },
   { flag: "--author" },
   { flag: "--message" },
   { flag: "--force" }
 ];
-var RELEASE_FLAG_CONTRACTS = [
+var HISTORY_REPAIR_FLAG_CONTRACTS = [
+  { flag: "--all" },
+  { flag: "--dry-run" },
   { flag: "--author" },
   { flag: "--message" },
-  { flag: "--allow-audit-release" },
   { flag: "--force" }
 ];
-var START_TASK_FLAG_CONTRACTS = [
+var HISTORY_COMPACT_FLAG_CONTRACTS = [
+  { flag: "--before" },
+  { flag: "--ids", list: true },
+  { flag: "--all-over", value_type: "number" },
+  { flag: "--closed" },
+  { flag: "--all-streams" },
+  { flag: "--min-entries", value_type: "number" },
+  { flag: "--dry-run" },
   { flag: "--author" },
   { flag: "--message" },
   { flag: "--force" }
 ];
-var PAUSE_TASK_FLAG_CONTRACTS = [
+var SCHEMA_FLAG_CONTRACTS = [
+  { flag: "--description" },
+  { flag: "--default-status", aliases: ["--default_status"] },
+  { flag: "--folder" },
+  { flag: "--alias" },
+  // --role is a repeatable Commander collect flag (NOT a comma-list contract),
+  // mirroring --alias; list:false keeps the bootstrap coalescer from corrupting
+  // 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: "--message" },
   { flag: "--force" }
 ];
-var CLOSE_TASK_FLAG_CONTRACTS = [
+var PROFILE_FLAG_CONTRACTS = [
+  { flag: "--dry-run" },
   { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--validate-close" },
   { flag: "--force" }
 ];
-var SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS = [
+var PLAN_FLAG_CONTRACTS = [
+  { flag: "--title" },
+  { flag: "--description" },
+  { flag: "--scope" },
   { flag: "--parent" },
-  { flag: "--allow-missing-parent" },
-  { flag: "--tags" },
+  { flag: "--related" },
+  { flag: "--blocks" },
+  { flag: "--blocked-by", aliases: ["--blocked_by"] },
+  { flag: "--harness" },
+  { flag: "--mode" },
+  { flag: "--resume-context", aliases: ["--resume_context"] },
+  { flag: "--tags", aliases: ["--tag"], list: true },
   { flag: "--priority" },
   { flag: "--body" },
-  { flag: "--description" },
+  { flag: "--claim" },
+  { flag: "--from-search", aliases: ["--from_search"] },
+  { flag: "--template" },
+  { 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"] },
+  { flag: "--step-evidence", aliases: ["--step_evidence"] },
+  { flag: "--step-blocked-reason", aliases: ["--step_blocked_reason"] },
+  { flag: "--step-replacement", aliases: ["--step_replacement"] },
+  { flag: "--depends-on", aliases: ["--depends_on"] },
+  { flag: "--link" },
+  { flag: "--link-kind", aliases: ["--link_kind"] },
+  { flag: "--link-note", aliases: ["--link_note"] },
+  { flag: "--promote-to-item-dep", aliases: ["--promote_to_item_dep"] },
+  { flag: "--allow-multiple-active", aliases: ["--allow_multiple_active"] },
+  { flag: "--file" },
+  { flag: "--test" },
+  { flag: "--doc" },
+  { flag: "--decision-text", aliases: ["--decision_text", "--decision"] },
+  { flag: "--decision-rationale", aliases: ["--decision_rationale"] },
+  { flag: "--decision-evidence", aliases: ["--decision_evidence"] },
+  { flag: "--discovery-text", aliases: ["--discovery_text", "--discovery"] },
+  { flag: "--validation-text", aliases: ["--validation_text", "--validation"] },
+  { flag: "--validation-command", aliases: ["--validation_command"] },
+  { flag: "--validation-expected", aliases: ["--validation_expected"] },
+  { flag: "--depth" },
+  { flag: "--fields", list: true },
+  { flag: "--steps" },
+  { flag: "--materialize-type", aliases: ["--materialize_type"] },
+  { flag: "--materialize-parent", aliases: ["--materialize_parent"] },
+  { flag: "--materialize-tags", aliases: ["--materialize_tags"] },
   { flag: "--author" },
-  { flag: "--message" }
-];
-var MEET_FLAG_CONTRACTS = [
-  { flag: "--start" },
-  { flag: "--duration" },
-  { flag: "--end" },
-  { flag: "--location" },
-  { flag: "--timezone" },
-  { flag: "--all-day" },
-  ...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS
+  { flag: "--message" },
+  { flag: "--force" }
 ];
-var EVENT_FLAG_CONTRACTS = MEET_FLAG_CONTRACTS;
-var REMIND_FLAG_CONTRACTS = [
-  { flag: "--at" },
-  { flag: "--text" },
-  ...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS
+var INIT_FLAG_CONTRACTS = [
+  { flag: "--preset" },
+  { flag: "--type-preset" },
+  { flag: "--defaults", short: "-y", aliases: ["--yes"] },
+  { flag: "--author" },
+  { flag: "--agent-guidance" },
+  { flag: "--with-packages" },
+  { flag: "--force" },
+  { flag: "--verbose" }
 ];
-var TEST_FLAG_CONTRACTS = [
-  { flag: "--add" },
-  { flag: "--add-json" },
-  { flag: "--remove" },
-  { flag: "--run" },
-  { flag: "--match" },
-  { flag: "--only-index" },
-  { flag: "--only-last" },
-  { flag: "--background" },
-  { flag: "--timeout" },
-  { flag: "--progress" },
-  { flag: "--env-set" },
-  { flag: "--env-clear" },
-  { flag: "--shared-host-safe" },
-  { flag: "--pm-context" },
-  { flag: "--override-linked-pm-context" },
-  { flag: "--fail-on-context-mismatch" },
-  { flag: "--fail-on-skipped" },
-  { flag: "--fail-on-empty-test-run" },
-  { flag: "--require-assertions-for-pm" },
-  { flag: "--check-context" },
-  { flag: "--auto-pm-context" },
-  { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--force" }
+var CONFIG_FLAG_CONTRACTS = [
+  { flag: "--criterion" },
+  { flag: "--clear-criteria" },
+  { flag: "--format" },
+  { flag: "--policy" },
+  { flag: "--default-depth" },
+  { flag: "--activity-limit" },
+  { flag: "--stale-threshold-days" },
+  { flag: "--section-hierarchy" },
+  { flag: "--section-activity" },
+  { flag: "--section-progress" },
+  { flag: "--section-blockers" },
+  { flag: "--section-files" },
+  { flag: "--section-workload" },
+  { flag: "--section-staleness" },
+  { flag: "--section-tests" }
 ];
-var TEST_ALL_FLAG_CONTRACTS = [
-  { flag: "--status" },
-  { flag: "--limit" },
-  { flag: "--offset" },
-  { flag: "--background" },
-  { flag: "--timeout" },
-  { flag: "--progress" },
-  { flag: "--env-set" },
-  { flag: "--env-clear" },
-  { flag: "--shared-host-safe" },
-  { flag: "--pm-context" },
-  { flag: "--override-linked-pm-context" },
-  { flag: "--fail-on-context-mismatch" },
-  { flag: "--fail-on-skipped" },
-  { flag: "--fail-on-empty-test-run" },
-  { flag: "--require-assertions-for-pm" },
-  { flag: "--check-context" },
-  { flag: "--auto-pm-context" }
+var EXTENSION_FLAG_CONTRACTS = [
+  { flag: "--init" },
+  { flag: "--scaffold" },
+  { flag: "--capability" },
+  { flag: "--install" },
+  { flag: "--uninstall" },
+  { flag: "--explore" },
+  { flag: "--list" },
+  { flag: "--manage" },
+  { flag: "--describe" },
+  { flag: "--markdown" },
+  { flag: "--output" },
+  { flag: "--reload" },
+  { flag: "--watch" },
+  { flag: "--doctor" },
+  { flag: "--catalog" },
+  { flag: "--adopt" },
+  { flag: "--adopt-all" },
+  { flag: "--activate" },
+  { flag: "--deactivate" },
+  { flag: "--project" },
+  { flag: "--local" },
+  { flag: "--global" },
+  { flag: "--gh" },
+  { flag: "--github" },
+  { flag: "--ref" },
+  { flag: "--detail" },
+  { flag: "--trace" },
+  { flag: "--runtime-probe" },
+  { flag: "--fix-managed-state" },
+  { flag: "--strict-exit" },
+  { flag: "--fail-on-warn" }
 ];
-var TELEMETRY_FLAG_CONTRACTS = [
-  { flag: "--limit" }
+var EXTENSION_SCOPE_FLAG_CONTRACTS = [
+  { flag: "--project" },
+  { flag: "--local" },
+  { flag: "--global" }
 ];
-var TEST_RUNS_FLAG_CONTRACTS = [
-  { flag: "--status" },
-  { flag: "--limit" },
-  { flag: "--stream" },
-  { flag: "--tail" },
-  { flag: "--force" },
-  { flag: "--author" }
+var EXTENSION_INIT_FLAG_CONTRACTS = [
+  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
+  { flag: "--capability" }
 ];
-var GC_FLAG_CONTRACTS = [
-  { flag: "--dry-run" },
-  { flag: "--scope" }
+var PACKAGE_FLAG_CONTRACTS = [...EXTENSION_FLAG_CONTRACTS, { flag: "--declarative" }];
+var PACKAGE_INIT_FLAG_CONTRACTS = [...EXTENSION_INIT_FLAG_CONTRACTS, { flag: "--declarative" }];
+var EXTENSION_INSTALL_FLAG_CONTRACTS = [
+  { flag: "--project" },
+  { flag: "--local" },
+  { flag: "--global" },
+  { flag: "--gh" },
+  { flag: "--github" },
+  { flag: "--ref" }
 ];
-var STATS_FLAG_CONTRACTS = [
-  { flag: "--storage" },
-  { flag: "--metadata-coverage" },
-  { flag: "--field-utilization" },
-  { flag: "--by-assignee" },
-  { flag: "--by-tag" },
-  { flag: "--by-priority" },
-  { flag: "--tag-prefix" }
+var EXTENSION_UNINSTALL_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
+var EXTENSION_EXPLORE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
+var EXTENSION_DESCRIBE_FLAG_CONTRACTS = [
+  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
+  { flag: "--markdown" },
+  { flag: "--output" }
 ];
-var HEALTH_FLAG_CONTRACTS = [
-  { flag: "--strict-directories" },
-  { flag: "--strict-exit" },
-  { flag: "--fail-on-warn" },
-  { flag: "--check-only" },
-  { flag: "--check-telemetry" },
-  { flag: "--no-refresh" },
-  { flag: "--refresh-vectors" },
-  { flag: "--verbose-stale-items" },
-  { flag: "--brief" },
-  { flag: "--summary" },
-  { flag: "--skip-vectors" },
-  { flag: "--skip-integrity" },
-  { flag: "--skip-drift" },
-  { flag: "--full" }
+var EXTENSION_ADOPT_ALL_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
+var EXTENSION_ACTIVATE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
+var EXTENSION_DEACTIVATE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
+var EXTENSION_MANAGE_FLAG_CONTRACTS = [
+  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
+  { flag: "--runtime-probe" },
+  { flag: "--fix-managed-state" }
 ];
-var VALIDATE_FLAG_CONTRACTS = [
-  { flag: "--check-metadata" },
-  { flag: "--metadata-profile" },
-  { flag: "--check-resolution" },
-  { flag: "--check-lifecycle" },
-  { flag: "--check-stale-blockers" },
-  { flag: "--dependency-cycle-severity" },
-  { flag: "--parent-cycle-severity" },
-  { flag: "--check-files" },
-  { flag: "--scan-mode" },
-  { flag: "--include-pm-internals" },
-  { flag: "--verbose-file-lists" },
-  { flag: "--verbose-diagnostics" },
-  { flag: "--all-affected-ids" },
+var EXTENSION_RELOAD_FLAG_CONTRACTS = [
+  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
+  { flag: "--watch" }
+];
+var EXTENSION_DOCTOR_FLAG_CONTRACTS = [
+  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
+  { flag: "--detail" },
+  { flag: "--trace" },
+  { flag: "--fix-managed-state" },
   { flag: "--strict-exit" },
-  { flag: "--fail-on-warn" },
-  { flag: "--fix-hints" },
-  { flag: "--auto-fix" },
+  { flag: "--fail-on-warn" }
+];
+var EXTENSION_CATALOG_FLAG_CONTRACTS = [
+  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
+  { flag: "--fields", list: true }
+];
+var EXTENSION_ADOPT_FLAG_CONTRACTS = [
+  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
+  { flag: "--gh" },
+  { flag: "--github" },
+  { flag: "--ref" }
+];
+var INSTALL_FLAG_CONTRACTS = [
+  { flag: "--project" },
+  { flag: "--local" },
+  { flag: "--global" },
+  { flag: "--gh" },
+  { flag: "--github" },
+  { flag: "--ref" }
+];
+var UPGRADE_FLAG_CONTRACTS = [
   { 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" }
+  { flag: "--cli-only" },
+  { flag: "--packages-only" },
+  { flag: "--project" },
+  { flag: "--local" },
+  { flag: "--global" },
+  { flag: "--repair" },
+  { flag: "--tag" },
+  { flag: "--package-name" }
 ];
-var CREATE_FLAG_CONTRACTS = [
-  { short: "-t", flag: "--title" },
-  { short: "-d", flag: "--description" },
-  { flag: "--type" },
-  { flag: "--template" },
-  { flag: "--create-mode" },
-  { flag: "--create_mode" },
-  { flag: "--schedule-preset" },
-  { flag: "--schedule_preset" },
-  { short: "-s", flag: "--status" },
-  { short: "-p", flag: "--priority" },
-  { flag: "--tags", aliases: ["--tag"], list: true },
-  // NOT list:true — these use Commander's repeatable collector. Marking them
-  // list:true would make the bootstrap coalescer comma-join repeated
-  // occurrences (`--add-tags '["a","b"]' --add-tags c` -> `["a","b"],c`),
-  // 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" },
-  { flag: "--estimated_minutes" },
-  { flag: "--acceptance-criteria" },
-  { flag: "--acceptance_criteria" },
-  { flag: "--ac" },
+var REINDEX_FLAG_CONTRACTS = [
+  { flag: "--mode" },
+  { flag: "--progress" }
+];
+var CLOSE_FLAG_CONTRACTS = [
+  { flag: "--reason" },
+  { flag: "--close-reason" },
+  { flag: "--duplicate-of" },
   { flag: "--author" },
   { flag: "--message" },
-  { flag: "--assignee" },
-  { flag: "--parent" },
-  { flag: "--allow-missing-parent" },
-  { flag: "--reviewer" },
-  { flag: "--risk" },
-  { flag: "--confidence" },
-  { flag: "--sprint" },
-  { flag: "--release" },
-  { flag: "--blocked-by" },
-  { flag: "--blocked-reason" },
-  { flag: "--unblock-note" },
-  { flag: "--reporter" },
-  { flag: "--severity" },
-  { flag: "--environment" },
-  { flag: "--repro-steps" },
-  { flag: "--resolution" },
-  { flag: "--expected-result" },
-  { flag: "--actual-result" },
-  { flag: "--affected-version" },
-  { flag: "--fixed-version" },
-  { flag: "--component" },
-  { flag: "--regression" },
-  { flag: "--customer-impact" },
-  { flag: "--customer_impact" },
-  { flag: "--definition-of-ready" },
-  { flag: "--definition_of_ready" },
-  { flag: "--order" },
-  { flag: "--rank" },
-  { flag: "--goal" },
-  { flag: "--objective" },
-  { flag: "--value" },
-  { flag: "--impact" },
-  { flag: "--outcome" },
-  { flag: "--why-now" },
-  { flag: "--why_now" },
-  { flag: "--blocked_by" },
-  { flag: "--blocked_reason" },
-  { flag: "--unblock_note" },
-  { flag: "--repro_steps" },
-  { flag: "--expected_result" },
-  { flag: "--actual_result" },
-  { flag: "--expected" },
-  { flag: "--actual" },
-  { flag: "--affected_version" },
-  { flag: "--fixed_version" },
-  { flag: "--dep" },
-  { flag: "--type-option" },
-  { flag: "--type_option" },
-  { flag: "--field" },
-  { flag: "--reminder" },
-  { flag: "--event" },
-  { flag: "--comment" },
-  { flag: "--note" },
-  { flag: "--learning" },
-  { flag: "--file" },
-  { flag: "--test" },
-  { flag: "--doc" },
-  { flag: "--unset" },
-  { flag: "--clear-deps" },
-  { flag: "--clear-comments" },
-  { flag: "--clear-notes" },
-  { flag: "--clear-learnings" },
-  { flag: "--clear-files" },
-  { flag: "--clear-tests" },
-  { flag: "--clear-docs" },
-  { flag: "--clear-reminders" },
-  { flag: "--clear-events" },
-  { flag: "--clear-type-options" }
-];
-var COPY_FLAG_CONTRACTS = [
-  { flag: "--title" },
-  { flag: "--author" },
-  { flag: "--message" }
-];
-var FOCUS_FLAG_CONTRACTS = [
-  { flag: "--clear" }
-];
-var 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" },
-  { short: "-p", flag: "--priority" },
-  { flag: "--type" },
-  { flag: "--tags", aliases: ["--tag"], list: true },
-  // NOT list:true — Commander's repeatable collector accumulates these, so
-  // bootstrap coalescing must not comma-join repeated occurrences (it would
-  // corrupt JSON-array values like `--add-tags '["a","b"]' --add-tags c`).
-  { flag: "--add-tags", aliases: ["--add_tags"] },
-  { flag: "--remove-tags", aliases: ["--remove_tags"] },
-  { flag: "--deadline" },
-  { flag: "--estimate" },
-  { flag: "--estimated-minutes" },
-  { flag: "--estimated_minutes" },
-  { flag: "--acceptance-criteria" },
-  { flag: "--acceptance_criteria" },
-  { flag: "--ac" },
-  { flag: "--assignee" },
-  { flag: "--parent" },
-  { flag: "--reviewer" },
-  { flag: "--risk" },
-  { flag: "--confidence" },
-  { flag: "--sprint" },
-  { flag: "--release" },
-  { flag: "--blocked-by" },
-  { flag: "--blocked-reason" },
-  { flag: "--unblock-note" },
-  { flag: "--reporter" },
-  { flag: "--severity" },
-  { flag: "--environment" },
-  { flag: "--repro-steps" },
+  { flag: "--validate-close" },
+  // pm-fl0c #11 (2026-05-28) + Codex P2 follow-up: inline closure-validation
+  // fields. Surface them through the contract so `pm contracts --command
+  // close`, the JSON help payload, and bootstrap flag normalization /
+  // suggestions all stay consistent with the commander registration.
   { flag: "--resolution" },
-  { flag: "--expected-result" },
-  { flag: "--actual-result" },
-  { flag: "--affected-version" },
-  { flag: "--fixed-version" },
-  { flag: "--fixed_version" },
-  { flag: "--component" },
-  { flag: "--regression" },
-  { flag: "--customer-impact" },
-  { flag: "--customer_impact" },
-  { flag: "--definition-of-ready" },
-  { flag: "--definition_of_ready" },
-  { flag: "--order" },
-  { flag: "--rank" },
-  { flag: "--goal" },
-  { flag: "--objective" },
-  { flag: "--value" },
-  { flag: "--impact" },
-  { flag: "--outcome" },
-  { flag: "--why-now" },
-  { flag: "--why_now" },
-  { flag: "--author" },
-  { flag: "--message" },
-  { flag: "--blocked_by" },
-  { flag: "--blocked_reason" },
-  { flag: "--unblock_note" },
-  { flag: "--repro_steps" },
-  { flag: "--expected_result" },
-  { flag: "--actual_result" },
-  { flag: "--expected" },
-  { flag: "--actual" },
-  { flag: "--affected_version" },
-  { flag: "--dep" },
-  { flag: "--dep-remove" },
-  { flag: "--dep_remove" },
-  { flag: "--replace-deps" },
-  { flag: "--replace-tests" },
-  { flag: "--comment" },
-  { flag: "--note" },
-  { flag: "--learning" },
-  { flag: "--file" },
-  { flag: "--test" },
-  { flag: "--doc" },
-  { flag: "--reminder" },
-  { flag: "--event" },
-  { flag: "--type-option" },
-  { flag: "--type_option" },
-  { flag: "--field" },
-  { flag: "--unset" },
-  { flag: "--clear-deps" },
-  { flag: "--clear-comments" },
-  { flag: "--clear-notes" },
-  { flag: "--clear-learnings" },
-  { flag: "--clear-files" },
-  { flag: "--clear-tests" },
-  { flag: "--clear-docs" },
-  { flag: "--clear-reminders" },
-  { flag: "--clear-events" },
-  { flag: "--clear-type-options" },
-  { flag: "--allow-audit-update" },
-  { flag: "--allow_audit_update" },
-  { flag: "--allow-audit-dep-update" },
-  { flag: "--allow_audit_dep_update" },
+  { flag: "--expected-result", aliases: ["--expected_result", "--expected"] },
+  { flag: "--actual-result", aliases: ["--actual_result", "--actual"] },
   { flag: "--force" }
 ];
-var UPDATE_MANY_FLAG_CONTRACTS = [
-  { flag: "--filter-status" },
+var CLOSE_MANY_FLAG_CONTRACTS = [
+  { flag: "--filter-status", list: true },
   { flag: "--filter-type" },
   { flag: "--filter-tag" },
   { flag: "--filter-priority" },
@@ -1829,725 +1774,832 @@ var 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" },
   ...MANY_GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS,
+  { flag: "--reason" },
+  { flag: "--resolution" },
+  { flag: "--expected-result", aliases: ["--expected_result", "--expected"] },
+  { flag: "--actual-result", aliases: ["--actual_result", "--actual"] },
+  { flag: "--validate-close" },
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--force" },
   { flag: "--dry-run" },
   { flag: "--rollback" },
-  { flag: "--no-checkpoint" },
-  { short: "-t", flag: "--title" },
-  { short: "-d", flag: "--description" },
-  { short: "-b", flag: "--body" },
-  { short: "-p", flag: "--priority" },
-  { flag: "--type" },
-  { flag: "--tags", aliases: ["--tag"], list: true },
-  // NOT list:true — Commander's repeatable collector accumulates these, so
-  // bootstrap coalescing must not comma-join repeated occurrences (it would
-  // corrupt JSON-array values like `--add-tags '["a","b"]' --add-tags c`).
-  { flag: "--add-tags", aliases: ["--add_tags"] },
-  { flag: "--remove-tags", aliases: ["--remove_tags"] },
-  { flag: "--deadline" },
-  { flag: "--estimate" },
-  { flag: "--estimated-minutes" },
-  { flag: "--estimated_minutes" },
-  { flag: "--acceptance-criteria" },
-  { flag: "--acceptance_criteria" },
-  { flag: "--ac" },
-  { flag: "--definition-of-ready" },
-  { flag: "--definition_of_ready" },
-  { flag: "--order" },
-  { flag: "--rank" },
-  { flag: "--goal" },
-  { flag: "--objective" },
-  { flag: "--value" },
-  { flag: "--impact" },
-  { flag: "--outcome" },
-  { flag: "--why-now" },
-  { flag: "--why_now" },
-  { flag: "--reviewer" },
-  { flag: "--risk" },
-  { flag: "--confidence" },
-  { flag: "--sprint" },
-  { flag: "--release" },
-  { flag: "--reporter" },
-  { flag: "--severity" },
-  { flag: "--environment" },
-  { flag: "--repro-steps" },
-  { flag: "--repro_steps" },
-  { flag: "--resolution" },
-  { flag: "--expected-result" },
-  { flag: "--expected_result" },
-  { flag: "--expected" },
-  { flag: "--actual-result" },
-  { flag: "--actual_result" },
-  { flag: "--actual" },
-  { flag: "--affected-version" },
-  { flag: "--affected_version" },
-  { flag: "--fixed-version" },
-  { flag: "--fixed_version" },
-  { flag: "--component" },
-  { flag: "--regression" },
-  { flag: "--customer-impact" },
-  { flag: "--customer_impact" },
-  { flag: "--dep" },
-  { flag: "--dep-remove" },
-  { flag: "--dep_remove" },
-  { flag: "--replace-deps" },
-  { flag: "--replace-tests" },
-  { flag: "--comment" },
-  { flag: "--note" },
-  { flag: "--learning" },
-  { flag: "--file" },
-  { flag: "--test" },
-  { flag: "--doc" },
-  { flag: "--reminder" },
-  { flag: "--event" },
-  { flag: "--type-option" },
-  { flag: "--type_option" },
-  { flag: "--unset" },
-  { flag: "--clear-deps" },
-  { flag: "--clear-comments" },
-  { flag: "--clear-notes" },
-  { flag: "--clear-learnings" },
-  { flag: "--clear-files" },
-  { flag: "--clear-tests" },
-  { flag: "--clear-docs" },
-  { flag: "--clear-reminders" },
-  { flag: "--clear-events" },
-  { flag: "--clear-type-options" },
-  { flag: "--allow-audit-update" },
-  { flag: "--allow_audit_update" },
-  { flag: "--allow-audit-dep-update" },
-  { flag: "--allow_audit_dep_update" },
+  { flag: "--no-checkpoint" }
+];
+var APPEND_FLAG_CONTRACTS = [
+  { flag: "--body", short: "-b" },
   { flag: "--author" },
   { flag: "--message" },
   { flag: "--force" }
 ];
-var NORMALIZE_FLAG_CONTRACTS = [
-  { flag: "--filter-status" },
-  { flag: "--filter-type" },
-  { flag: "--filter-tag" },
-  { flag: "--filter-priority" },
-  { flag: "--filter-deadline-before" },
-  { flag: "--filter-deadline-after" },
-  { flag: "--filter-assignee" },
-  { flag: "--filter-assignee-filter" },
-  { flag: "--filter-assignee_filter" },
-  { flag: "--filter-parent" },
-  { flag: "--filter-sprint" },
-  { flag: "--filter-release" },
-  { flag: "--limit" },
-  { flag: "--offset" },
+var CLAIM_FLAG_CONTRACTS = [
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--force" }
+];
+var RESTORE_FLAG_CONTRACTS = [
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--force" }
+];
+var DELETE_FLAG_CONTRACTS = [
   { flag: "--dry-run" },
-  { flag: "--apply" },
   { flag: "--author" },
   { flag: "--message" },
-  { flag: "--allow-audit-update" },
-  { flag: "--allow_audit_update" },
   { flag: "--force" }
 ];
-var CALENDAR_FLAG_CONTRACTS = [
-  { flag: "--view" },
-  { flag: "--date" },
-  { flag: "--from" },
-  { flag: "--to" },
-  { flag: "--past" },
-  { flag: "--full-period" },
-  { flag: "--full_period" },
-  { flag: "--type" },
-  { flag: "--tag" },
-  { flag: "--priority" },
-  { flag: "--status" },
-  { flag: "--assignee" },
-  { flag: "--assignee-filter" },
-  { flag: "--assignee_filter" },
-  { flag: "--sprint" },
-  { flag: "--release" },
-  { flag: "--include" },
-  { flag: "--recurrence-lookahead-days" },
-  { flag: "--recurrence-lookback-days" },
-  { flag: "--occurrence-limit" },
-  { flag: "--limit" },
-  { flag: "--format" }
+var RELEASE_FLAG_CONTRACTS = [
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--allow-audit-release" },
+  { flag: "--force" }
 ];
-var ACTIVITY_FLAG_CONTRACTS = [
-  { flag: "--id" },
-  { flag: "--op" },
+var START_TASK_FLAG_CONTRACTS = [
   { flag: "--author" },
-  { flag: "--from" },
-  { flag: "--to" },
-  { flag: "--limit" },
-  { flag: "--compact" },
-  { flag: "--full" },
-  { flag: "--stream" }
+  { flag: "--message" },
+  { flag: "--force" }
 ];
-var CONTEXT_FLAG_CONTRACTS = [
-  { flag: "--date" },
-  { flag: "--from" },
-  { flag: "--to" },
-  { flag: "--past" },
-  { flag: "--type" },
-  { flag: "--tag" },
-  { flag: "--priority" },
-  { flag: "--assignee" },
-  { flag: "--assignee-filter" },
-  { flag: "--assignee_filter" },
-  { flag: "--sprint" },
-  { flag: "--release" },
-  { flag: "--parent" },
-  { flag: "--limit" },
-  { flag: "--format" },
-  { flag: "--depth" },
-  { flag: "--fields", list: true },
-  { flag: "--section" },
-  { flag: "--activity-limit" },
-  { flag: "--stale-threshold" }
+var PAUSE_TASK_FLAG_CONTRACTS = [
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--force" }
 ];
-var GET_FLAG_CONTRACTS = [
-  { flag: "--depth" },
-  { flag: "--full" },
-  { flag: "--fields", list: true },
-  { flag: "--tree" },
-  { flag: "--tree-depth" },
-  { flag: "--tree_depth" },
-  { flag: "--format" }
+var CLOSE_TASK_FLAG_CONTRACTS = [
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--validate-close" },
+  { flag: "--force" }
 ];
-var GUIDE_FLAG_CONTRACTS = [
-  { flag: "--list" },
-  { flag: "--format" },
-  { flag: "--depth" }
+var SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS = [
+  { flag: "--parent" },
+  { flag: "--allow-missing-parent" },
+  { flag: "--tags" },
+  { flag: "--priority" },
+  { flag: "--body" },
+  { flag: "--description" },
+  { flag: "--author" },
+  { flag: "--message" }
 ];
-var DEPS_FLAG_CONTRACTS = [
-  { flag: "--format" },
-  { flag: "--max-depth" },
-  { flag: "--collapse" },
-  { flag: "--summary" }
+var MEET_FLAG_CONTRACTS = [
+  { flag: "--start" },
+  { flag: "--duration" },
+  { flag: "--end" },
+  { flag: "--location" },
+  { flag: "--timezone" },
+  { flag: "--all-day" },
+  ...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS
 ];
-var EVAL_FLAG_CONTRACTS = [
-  { flag: "--mode" },
-  { flag: "--k" },
-  { flag: "--fail-under" },
-  { flag: "--queries" },
-  { flag: "--format" }
+var EVENT_FLAG_CONTRACTS = MEET_FLAG_CONTRACTS;
+var REMIND_FLAG_CONTRACTS = [
+  { flag: "--at" },
+  { flag: "--text" },
+  ...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS
 ];
-var NEXT_FLAG_CONTRACTS = [
-  { flag: "--type" },
-  { flag: "--tag" },
-  { flag: "--priority" },
-  { flag: "--assignee" },
-  { flag: "--assignee-filter" },
-  { flag: "--assignee_filter" },
-  { flag: "--sprint" },
-  { flag: "--release" },
-  { flag: "--parent" },
+var TEST_FLAG_CONTRACTS = [
+  { flag: "--add" },
+  { flag: "--add-json" },
+  { flag: "--remove" },
+  { flag: "--run" },
+  { flag: "--match" },
+  { flag: "--only-index" },
+  { flag: "--only-last" },
+  { flag: "--background" },
+  { flag: "--timeout" },
+  { flag: "--progress" },
+  { flag: "--env-set" },
+  { flag: "--env-clear" },
+  { flag: "--shared-host-safe" },
+  { flag: "--pm-context" },
+  { flag: "--override-linked-pm-context" },
+  { flag: "--fail-on-context-mismatch" },
+  { flag: "--fail-on-skipped" },
+  { flag: "--fail-on-empty-test-run" },
+  { flag: "--require-assertions-for-pm" },
+  { flag: "--check-context" },
+  { flag: "--auto-pm-context" },
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--force" }
+];
+var TEST_ALL_FLAG_CONTRACTS = [
+  { flag: "--status" },
   { flag: "--limit" },
-  { flag: "--blocked-limit" },
-  { flag: "--blocked_limit" },
-  { flag: "--ready-only" },
-  { flag: "--ready_only" },
-  { flag: "--format" }
+  { flag: "--offset" },
+  { flag: "--background" },
+  { flag: "--timeout" },
+  { flag: "--progress" },
+  { flag: "--env-set" },
+  { flag: "--env-clear" },
+  { flag: "--shared-host-safe" },
+  { flag: "--pm-context" },
+  { flag: "--override-linked-pm-context" },
+  { flag: "--fail-on-context-mismatch" },
+  { flag: "--fail-on-skipped" },
+  { flag: "--fail-on-empty-test-run" },
+  { flag: "--require-assertions-for-pm" },
+  { flag: "--check-context" },
+  { flag: "--auto-pm-context" }
 ];
-var 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" },
-  { flag: "--phrase-exact" },
-  { flag: "--highlight" },
-  { flag: "--compact" },
-  { flag: "--full" },
-  { flag: "--fields", list: true },
-  { flag: "--format" },
+var TELEMETRY_FLAG_CONTRACTS = [
+  { flag: "--limit" }
+];
+var TEST_RUNS_FLAG_CONTRACTS = [
+  { flag: "--status" },
   { flag: "--limit" },
-  { flag: "--status", list: true },
-  { flag: "--type" },
-  { flag: "--tag", aliases: ["--tags"] },
-  { 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" },
-  ...GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS
+  { flag: "--stream" },
+  { flag: "--tail" },
+  { flag: "--force" },
+  { flag: "--author" }
 ];
-var CONTRACTS_FLAG_CONTRACTS = [
-  { flag: "--action" },
-  { flag: "--command" },
-  { flag: "--schema-only" },
-  { flag: "--flags-only" },
-  { flag: "--availability-only" },
-  { flag: "--runtime-only" },
-  { flag: "--active-only" },
-  { flag: "--full" }
-];
-var COMPLETION_FLAG_CONTRACTS = [
-  { flag: "--eager-tags" }
-];
-function toUniqueFlagContracts(contracts) {
-  const seen = /* @__PURE__ */ new Set();
-  const unique = [];
-  for (const contract of contracts) {
-    const aliasKey = (contract.aliases ?? []).join(",");
-    const key = `${contract.flag}|${contract.short ?? ""}|${aliasKey}`;
-    if (seen.has(key)) {
-      continue;
-    }
-    seen.add(key);
-    unique.push(contract);
-  }
-  return unique;
-}
-function withSubcommandGlobalFlags(contracts) {
-  return withFlagAliasMetadata(toUniqueFlagContracts([...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, ...contracts]));
-}
-var LIST_COMMAND_FLAG_ALIASES = [
-  "list",
-  "list-all",
-  "list-draft",
-  "list-open",
-  "list-in-progress",
-  "list-blocked",
-  "list-closed",
-  "list-canceled"
-];
-var SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND = new Map([
-  ...LIST_COMMAND_FLAG_ALIASES.map((command) => [command, LIST_FILTER_FLAG_CONTRACTS]),
-  ["templates", CREATE_FLAG_CONTRACTS],
-  ["cal", CALENDAR_FLAG_CONTRACTS],
-  ["ctx", CONTEXT_FLAG_CONTRACTS],
-  ["test-runs-worker", TEST_RUNS_FLAG_CONTRACTS],
-  ["init", INIT_FLAG_CONTRACTS],
-  ["config", CONFIG_FLAG_CONTRACTS],
-  ["extension", EXTENSION_FLAG_CONTRACTS],
-  // `--declarative` is package-only (see PACKAGE_FLAG_CONTRACTS).
-  ["package", PACKAGE_FLAG_CONTRACTS],
-  ["packages", PACKAGE_FLAG_CONTRACTS],
-  ["install", INSTALL_FLAG_CONTRACTS],
-  ["upgrade", UPGRADE_FLAG_CONTRACTS],
-  ["create", CREATE_FLAG_CONTRACTS],
-  ["copy", COPY_FLAG_CONTRACTS],
-  ["focus", FOCUS_FLAG_CONTRACTS],
-  ["aggregate", AGGREGATE_FLAG_CONTRACTS],
-  ["dedupe-audit", DEDUPE_AUDIT_FLAG_CONTRACTS],
-  ["dedupe-merge", DEDUPE_MERGE_FLAG_CONTRACTS],
-  ["normalize", NORMALIZE_FLAG_CONTRACTS],
-  ["calendar", CALENDAR_FLAG_CONTRACTS],
-  ["context", CONTEXT_FLAG_CONTRACTS],
-  ["get", GET_FLAG_CONTRACTS],
-  ["guide", GUIDE_FLAG_CONTRACTS],
-  ["search", SEARCH_FLAG_CONTRACTS],
-  ["next", NEXT_FLAG_CONTRACTS],
-  ["eval", EVAL_FLAG_CONTRACTS],
-  ["history", HISTORY_FLAG_CONTRACTS],
-  ["history-redact", HISTORY_REDACT_FLAG_CONTRACTS],
-  ["history-repair", HISTORY_REPAIR_FLAG_CONTRACTS],
-  ["history-compact", HISTORY_COMPACT_FLAG_CONTRACTS],
-  ["schema", SCHEMA_FLAG_CONTRACTS],
-  ["profile", PROFILE_FLAG_CONTRACTS],
-  ["plan", PLAN_FLAG_CONTRACTS],
-  ["activity", ACTIVITY_FLAG_CONTRACTS],
-  ["restore", RESTORE_FLAG_CONTRACTS],
-  ["update", UPDATE_FLAG_CONTRACTS],
-  ["update-many", UPDATE_MANY_FLAG_CONTRACTS],
-  ["close", CLOSE_FLAG_CONTRACTS],
-  ["close-many", CLOSE_MANY_FLAG_CONTRACTS],
-  ["delete", DELETE_FLAG_CONTRACTS],
-  ["append", APPEND_FLAG_CONTRACTS],
-  ["comments", COMMENTS_FLAG_CONTRACTS],
-  ["comments-audit", COMMENTS_AUDIT_FLAG_CONTRACTS],
-  ["notes", NOTES_FLAG_CONTRACTS],
-  ["learnings", LEARNINGS_FLAG_CONTRACTS],
-  ["files", FILES_FLAG_CONTRACTS],
-  ["docs", DOCS_FLAG_CONTRACTS],
-  ["deps", DEPS_FLAG_CONTRACTS],
-  ["test", TEST_FLAG_CONTRACTS],
-  ["test-all", TEST_ALL_FLAG_CONTRACTS],
-  ["telemetry", TELEMETRY_FLAG_CONTRACTS],
-  ["health", HEALTH_FLAG_CONTRACTS],
-  ["validate", VALIDATE_FLAG_CONTRACTS],
-  ["gc", GC_FLAG_CONTRACTS],
-  ["stats", STATS_FLAG_CONTRACTS],
-  ["contracts", CONTRACTS_FLAG_CONTRACTS],
-  ["completion", COMPLETION_FLAG_CONTRACTS],
-  ["claim", CLAIM_FLAG_CONTRACTS],
-  ["release", RELEASE_FLAG_CONTRACTS],
-  ["start-task", START_TASK_FLAG_CONTRACTS],
-  ["pause-task", PAUSE_TASK_FLAG_CONTRACTS],
-  ["close-task", CLOSE_TASK_FLAG_CONTRACTS],
-  ["meet", MEET_FLAG_CONTRACTS],
-  ["event", EVENT_FLAG_CONTRACTS],
-  ["remind", REMIND_FLAG_CONTRACTS]
-]);
-var EXTENSION_LIFECYCLE_FLAG_CONTRACTS_BY_SUBCOMMAND = /* @__PURE__ */ new Map([
-  ["install", EXTENSION_INSTALL_FLAG_CONTRACTS],
-  ["uninstall", EXTENSION_UNINSTALL_FLAG_CONTRACTS],
-  ["explore", EXTENSION_EXPLORE_FLAG_CONTRACTS],
-  ["manage", EXTENSION_MANAGE_FLAG_CONTRACTS],
-  ["describe", EXTENSION_DESCRIBE_FLAG_CONTRACTS],
-  ["reload", EXTENSION_RELOAD_FLAG_CONTRACTS],
-  ["doctor", EXTENSION_DOCTOR_FLAG_CONTRACTS],
-  ["catalog", EXTENSION_CATALOG_FLAG_CONTRACTS],
-  ["adopt", EXTENSION_ADOPT_FLAG_CONTRACTS],
-  ["adopt-all", EXTENSION_ADOPT_ALL_FLAG_CONTRACTS],
-  ["activate", EXTENSION_ACTIVATE_FLAG_CONTRACTS],
-  ["deactivate", EXTENSION_DEACTIVATE_FLAG_CONTRACTS]
-]);
-function normalizeCommandNameForContracts(commandName) {
-  if (typeof commandName !== "string") {
-    return "";
-  }
-  return commandName.trim().toLowerCase();
-}
-function resolveExtensionLifecycleFlagContracts(rootCommand, lifecycleSubcommand) {
-  if (lifecycleSubcommand === "init") {
-    return rootCommand === "extension" ? EXTENSION_INIT_FLAG_CONTRACTS : PACKAGE_INIT_FLAG_CONTRACTS;
-  }
-  return EXTENSION_LIFECYCLE_FLAG_CONTRACTS_BY_SUBCOMMAND.get(lifecycleSubcommand) ?? [];
-}
-function resolveSubcommandFlagContractsForCommand(commandName) {
-  const normalized = normalizeCommandNameForContracts(commandName);
-  if (normalized.length === 0) {
-    return withSubcommandGlobalFlags([]);
-  }
-  const [rootCommand, lifecycleSubcommand, ...extraParts] = normalized.split(/\s+/);
-  if ((rootCommand === "extension" || rootCommand === "package" || rootCommand === "packages") && lifecycleSubcommand !== void 0 && extraParts.length === 0) {
-    return withSubcommandGlobalFlags(resolveExtensionLifecycleFlagContracts(rootCommand, lifecycleSubcommand));
-  }
-  return withSubcommandGlobalFlags(SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND.get(normalized) ?? []);
-}
-// dist/sdk/cli-contracts/tool-option-contracts.js
-function cloneOptionContracts(contracts) {
-  return contracts.map((contract) => ({ ...contract }));
-}
-var TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS = [
-  { param: "status", flag: "--status" },
-  { param: "type", flag: "--type" },
-  { param: "tag", flag: "--tag" },
-  { param: "priority", flag: "--priority" },
-  { param: "deadlineBefore", flag: "--deadline-before" },
-  { param: "deadlineAfter", flag: "--deadline-after" }
-];
-var TOOL_ITEM_WINDOW_FILTER_OPTION_CONTRACTS = [
-  { param: "updatedAfter", flag: "--updated-after" },
-  { param: "updatedBefore", flag: "--updated-before" },
-  { param: "createdAfter", flag: "--created-after" },
-  { param: "createdBefore", flag: "--created-before" }
-];
-var TOOL_ITEM_RELATION_FILTER_OPTION_CONTRACTS = [
-  { param: "assignee", flag: "--assignee" },
-  { param: "assigneeFilter", flag: "--assignee-filter" },
-  { param: "parent", flag: "--parent" },
-  { param: "sprint", flag: "--sprint" },
-  { param: "release", flag: "--release" }
+var GC_FLAG_CONTRACTS = [
+  { flag: "--dry-run" },
+  { flag: "--scope" }
 ];
-var TOOL_SEARCH_RELATION_FILTER_OPTION_CONTRACTS = [
-  { param: "assignee", flag: "--assignee" },
-  { param: "sprint", flag: "--sprint" },
-  { param: "release", flag: "--release" },
-  { param: "parent", flag: "--parent" }
+var STATS_FLAG_CONTRACTS = [
+  { flag: "--storage" },
+  { flag: "--metadata-coverage" },
+  { flag: "--field-utilization" },
+  { flag: "--by-assignee" },
+  { flag: "--by-tag" },
+  { flag: "--by-priority" },
+  { flag: "--tag-prefix" }
 ];
-var TOOL_BASIC_ITEM_FILTER_OPTION_CONTRACTS = [
-  ...TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS,
-  ...TOOL_ITEM_RELATION_FILTER_OPTION_CONTRACTS
+var HEALTH_FLAG_CONTRACTS = [
+  { flag: "--strict-directories" },
+  { flag: "--strict-exit" },
+  { flag: "--fail-on-warn" },
+  { flag: "--check-only" },
+  { flag: "--check-telemetry" },
+  { flag: "--no-refresh" },
+  { flag: "--refresh-vectors" },
+  { flag: "--verbose-stale-items" },
+  { flag: "--brief" },
+  { flag: "--summary" },
+  { flag: "--skip-vectors" },
+  { flag: "--skip-integrity" },
+  { flag: "--skip-drift" },
+  { flag: "--full" }
 ];
-var TOOL_GOVERNANCE_MISSING_OPTION_CONTRACTS = [
-  { param: "filterReviewerMissing", flag: "--filter-reviewer-missing" },
-  { param: "filterRiskMissing", flag: "--filter-risk-missing" },
-  { param: "filterConfidenceMissing", flag: "--filter-confidence-missing" },
-  { param: "filterSprintMissing", flag: "--filter-sprint-missing" },
-  { param: "filterReleaseMissing", flag: "--filter-release-missing" }
+var VALIDATE_FLAG_CONTRACTS = [
+  { flag: "--check-metadata" },
+  { flag: "--metadata-profile" },
+  { flag: "--check-resolution" },
+  { flag: "--check-lifecycle" },
+  { flag: "--check-stale-blockers" },
+  { flag: "--dependency-cycle-severity" },
+  { flag: "--parent-cycle-severity" },
+  { flag: "--check-files" },
+  { flag: "--scan-mode" },
+  { 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" },
+  { 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" }
 ];
-var TOOL_CONTENT_PRESENCE_OPTION_CONTRACTS = [
-  { param: "hasNotes", flag: "--has-notes" },
-  { param: "noNotes", flag: "--no-notes" },
-  { param: "hasLearnings", flag: "--has-learnings" },
-  { param: "noLearnings", flag: "--no-learnings" },
-  { param: "hasFiles", flag: "--has-files" },
-  { param: "noFiles", flag: "--no-files" },
-  { param: "filterFilesMissing", flag: "--filter-files-missing" },
-  { param: "hasDocs", flag: "--has-docs" },
-  { param: "noDocs", flag: "--no-docs" },
-  { param: "filterDocsMissing", flag: "--filter-docs-missing" },
-  { param: "hasTests", flag: "--has-tests" },
-  { param: "noTests", flag: "--no-tests" },
-  { param: "hasComments", flag: "--has-comments" },
-  { param: "noComments", flag: "--no-comments" },
-  { param: "hasDeps", flag: "--has-deps" },
-  { param: "noDeps", flag: "--no-deps" },
-  { param: "hasBody", flag: "--has-body" },
-  { param: "emptyBody", flag: "--empty-body" },
-  { param: "hasLinkedCommand", flag: "--has-linked-command" },
-  { param: "noLinkedCommand", flag: "--no-linked-command" }
+var CREATE_FLAG_CONTRACTS = [
+  { short: "-t", flag: "--title" },
+  { flag: "--id" },
+  { short: "-d", flag: "--description" },
+  { flag: "--type" },
+  { flag: "--template" },
+  { flag: "--create-mode" },
+  { flag: "--create_mode" },
+  { flag: "--schedule-preset" },
+  { flag: "--schedule_preset" },
+  { short: "-s", flag: "--status" },
+  { short: "-p", flag: "--priority" },
+  { flag: "--tags", aliases: ["--tag"], list: true },
+  // NOT list:true — these use Commander's repeatable collector. Marking them
+  // list:true would make the bootstrap coalescer comma-join repeated
+  // occurrences (`--add-tags '["a","b"]' --add-tags c` -> `["a","b"],c`),
+  // 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" },
+  { flag: "--estimated_minutes" },
+  { flag: "--acceptance-criteria" },
+  { flag: "--acceptance_criteria" },
+  { flag: "--ac" },
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--assignee" },
+  { flag: "--parent" },
+  { flag: "--allow-missing-parent" },
+  { flag: "--reviewer" },
+  { flag: "--risk" },
+  { flag: "--confidence" },
+  { flag: "--sprint" },
+  { flag: "--release" },
+  { flag: "--blocked-by" },
+  { flag: "--blocked-reason" },
+  { flag: "--unblock-note" },
+  { flag: "--reporter" },
+  { flag: "--severity" },
+  { flag: "--environment" },
+  { flag: "--repro-steps" },
+  { flag: "--resolution" },
+  { flag: "--expected-result" },
+  { flag: "--actual-result" },
+  { flag: "--affected-version" },
+  { flag: "--fixed-version" },
+  { flag: "--component" },
+  { flag: "--regression" },
+  { flag: "--customer-impact" },
+  { flag: "--customer_impact" },
+  { flag: "--definition-of-ready" },
+  { flag: "--definition_of_ready" },
+  { flag: "--order" },
+  { flag: "--rank" },
+  { flag: "--goal" },
+  { flag: "--objective" },
+  { flag: "--value" },
+  { flag: "--impact" },
+  { flag: "--outcome" },
+  { flag: "--why-now" },
+  { flag: "--why_now" },
+  { flag: "--blocked_by" },
+  { flag: "--blocked_reason" },
+  { flag: "--unblock_note" },
+  { flag: "--repro_steps" },
+  { flag: "--expected_result" },
+  { flag: "--actual_result" },
+  { flag: "--expected" },
+  { flag: "--actual" },
+  { flag: "--affected_version" },
+  { flag: "--fixed_version" },
+  { flag: "--dep" },
+  { flag: "--type-option" },
+  { flag: "--type_option" },
+  { flag: "--field" },
+  { flag: "--reminder" },
+  { flag: "--event" },
+  { flag: "--comment" },
+  { flag: "--note" },
+  { flag: "--learning" },
+  { flag: "--file" },
+  { flag: "--test" },
+  { flag: "--doc" },
+  { flag: "--unset" },
+  { flag: "--clear-deps" },
+  { flag: "--clear-comments" },
+  { flag: "--clear-notes" },
+  { flag: "--clear-learnings" },
+  { flag: "--clear-files" },
+  { flag: "--clear-tests" },
+  { flag: "--clear-docs" },
+  { flag: "--clear-reminders" },
+  { flag: "--clear-events" },
+  { flag: "--clear-type-options" }
 ];
-var TOOL_LIST_FILTER_OPTION_CONTRACTS = [
-  ...cloneOptionContracts(TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS),
-  ...cloneOptionContracts(TOOL_ITEM_WINDOW_FILTER_OPTION_CONTRACTS),
-  { param: "ids", flag: "--ids" },
-  ...cloneOptionContracts(TOOL_ITEM_RELATION_FILTER_OPTION_CONTRACTS),
-  { param: "filterAcMissing", flag: "--filter-ac-missing" },
-  { param: "filterEstimatesMissing", flag: "--filter-estimates-missing" },
-  { param: "filterResolutionMissing", flag: "--filter-resolution-missing" },
-  { param: "filterMetadataMissing", flag: "--filter-metadata-missing" },
-  ...cloneOptionContracts(TOOL_GOVERNANCE_MISSING_OPTION_CONTRACTS),
-  ...cloneOptionContracts(TOOL_CONTENT_PRESENCE_OPTION_CONTRACTS),
-  { param: "limit", flag: "--limit" },
-  { param: "offset", flag: "--offset" },
-  { param: "fields", flag: "--fields" },
-  { param: "sort", flag: "--sort" },
-  { param: "order", flag: "--order" },
-  { param: "tree", flag: "--tree" },
-  { param: "treeDepth", flag: "--tree-depth" }
+var COPY_FLAG_CONTRACTS = [
+  { flag: "--title" },
+  { flag: "--author" },
+  { flag: "--message" }
 ];
-var TOOL_AGGREGATE_OPTION_CONTRACTS = [
-  { param: "groupBy", flag: "--group-by" },
-  { param: "sum", flag: "--sum" },
-  { param: "avg", flag: "--avg" },
-  ...cloneOptionContracts(TOOL_BASIC_ITEM_FILTER_OPTION_CONTRACTS)
+var FOCUS_FLAG_CONTRACTS = [
+  { flag: "--clear" }
 ];
-var TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS = [
-  { param: "mode", flag: "--mode" },
-  { param: "limit", flag: "--limit" },
-  { param: "threshold", flag: "--threshold" },
-  ...cloneOptionContracts(TOOL_BASIC_ITEM_FILTER_OPTION_CONTRACTS)
+var 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" },
+  { short: "-p", flag: "--priority" },
+  { flag: "--type" },
+  { flag: "--tags", aliases: ["--tag"], list: true },
+  // NOT list:true — Commander's repeatable collector accumulates these, so
+  // bootstrap coalescing must not comma-join repeated occurrences (it would
+  // corrupt JSON-array values like `--add-tags '["a","b"]' --add-tags c`).
+  { flag: "--add-tags", aliases: ["--add_tags"] },
+  { flag: "--remove-tags", aliases: ["--remove_tags"] },
+  { flag: "--deadline" },
+  { flag: "--estimate" },
+  { flag: "--estimated-minutes" },
+  { flag: "--estimated_minutes" },
+  { flag: "--acceptance-criteria" },
+  { flag: "--acceptance_criteria" },
+  { flag: "--ac" },
+  { flag: "--assignee" },
+  { flag: "--parent" },
+  { flag: "--reviewer" },
+  { flag: "--risk" },
+  { flag: "--confidence" },
+  { flag: "--sprint" },
+  { flag: "--release" },
+  { flag: "--blocked-by" },
+  { flag: "--blocked-reason" },
+  { flag: "--unblock-note" },
+  { flag: "--reporter" },
+  { flag: "--severity" },
+  { flag: "--environment" },
+  { flag: "--repro-steps" },
+  { flag: "--resolution" },
+  { flag: "--expected-result" },
+  { flag: "--actual-result" },
+  { flag: "--affected-version" },
+  { flag: "--fixed-version" },
+  { flag: "--fixed_version" },
+  { flag: "--component" },
+  { flag: "--regression" },
+  { flag: "--customer-impact" },
+  { flag: "--customer_impact" },
+  { flag: "--definition-of-ready" },
+  { flag: "--definition_of_ready" },
+  { flag: "--order" },
+  { flag: "--rank" },
+  { flag: "--goal" },
+  { flag: "--objective" },
+  { flag: "--value" },
+  { flag: "--impact" },
+  { flag: "--outcome" },
+  { flag: "--why-now" },
+  { flag: "--why_now" },
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--blocked_by" },
+  { flag: "--blocked_reason" },
+  { flag: "--unblock_note" },
+  { flag: "--repro_steps" },
+  { flag: "--expected_result" },
+  { flag: "--actual_result" },
+  { flag: "--expected" },
+  { flag: "--actual" },
+  { flag: "--affected_version" },
+  { flag: "--dep" },
+  { flag: "--dep-remove" },
+  { flag: "--dep_remove" },
+  { flag: "--replace-deps" },
+  { flag: "--replace-tests" },
+  { flag: "--comment" },
+  { flag: "--note" },
+  { flag: "--learning" },
+  { flag: "--file" },
+  { flag: "--test" },
+  { flag: "--doc" },
+  { flag: "--reminder" },
+  { flag: "--event" },
+  { flag: "--type-option" },
+  { flag: "--type_option" },
+  { flag: "--field" },
+  { flag: "--unset" },
+  { flag: "--clear-deps" },
+  { flag: "--clear-comments" },
+  { flag: "--clear-notes" },
+  { flag: "--clear-learnings" },
+  { flag: "--clear-files" },
+  { flag: "--clear-tests" },
+  { flag: "--clear-docs" },
+  { flag: "--clear-reminders" },
+  { flag: "--clear-events" },
+  { flag: "--clear-type-options" },
+  { flag: "--allow-audit-update" },
+  { flag: "--allow_audit_update" },
+  { flag: "--allow-audit-dep-update" },
+  { flag: "--allow_audit_dep_update" },
+  { flag: "--force" }
+];
+var UPDATE_MANY_FLAG_CONTRACTS = [
+  { flag: "--filter-status" },
+  { flag: "--filter-type" },
+  { flag: "--filter-tag" },
+  { flag: "--filter-priority" },
+  { flag: "--filter-deadline-before" },
+  { flag: "--filter-deadline-after" },
+  { flag: "--filter-updated-after" },
+  { flag: "--filter-updated-before" },
+  { flag: "--filter-created-after" },
+  { flag: "--filter-created-before" },
+  { flag: "--filter-assignee" },
+  { flag: "--filter-assignee-filter" },
+  { flag: "--filter-assignee_filter" },
+  { 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" },
+  ...MANY_GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS,
+  { flag: "--dry-run" },
+  { flag: "--rollback" },
+  { flag: "--no-checkpoint" },
+  { short: "-t", flag: "--title" },
+  { short: "-d", flag: "--description" },
+  { short: "-b", flag: "--body" },
+  { short: "-p", flag: "--priority" },
+  { flag: "--type" },
+  { flag: "--tags", aliases: ["--tag"], list: true },
+  // NOT list:true — Commander's repeatable collector accumulates these, so
+  // bootstrap coalescing must not comma-join repeated occurrences (it would
+  // corrupt JSON-array values like `--add-tags '["a","b"]' --add-tags c`).
+  { flag: "--add-tags", aliases: ["--add_tags"] },
+  { flag: "--remove-tags", aliases: ["--remove_tags"] },
+  { flag: "--deadline" },
+  { flag: "--estimate" },
+  { flag: "--estimated-minutes" },
+  { flag: "--estimated_minutes" },
+  { flag: "--acceptance-criteria" },
+  { flag: "--acceptance_criteria" },
+  { flag: "--ac" },
+  { flag: "--definition-of-ready" },
+  { flag: "--definition_of_ready" },
+  { flag: "--order" },
+  { flag: "--rank" },
+  { flag: "--goal" },
+  { flag: "--objective" },
+  { flag: "--value" },
+  { flag: "--impact" },
+  { flag: "--outcome" },
+  { flag: "--why-now" },
+  { flag: "--why_now" },
+  { flag: "--reviewer" },
+  { flag: "--risk" },
+  { flag: "--confidence" },
+  { flag: "--sprint" },
+  { flag: "--release" },
+  { flag: "--reporter" },
+  { flag: "--severity" },
+  { flag: "--environment" },
+  { flag: "--repro-steps" },
+  { flag: "--repro_steps" },
+  { flag: "--resolution" },
+  { flag: "--expected-result" },
+  { flag: "--expected_result" },
+  { flag: "--expected" },
+  { flag: "--actual-result" },
+  { flag: "--actual_result" },
+  { flag: "--actual" },
+  { flag: "--affected-version" },
+  { flag: "--affected_version" },
+  { flag: "--fixed-version" },
+  { flag: "--fixed_version" },
+  { flag: "--component" },
+  { flag: "--regression" },
+  { flag: "--customer-impact" },
+  { flag: "--customer_impact" },
+  { flag: "--dep" },
+  { flag: "--dep-remove" },
+  { flag: "--dep_remove" },
+  { flag: "--replace-deps" },
+  { flag: "--replace-tests" },
+  { flag: "--comment" },
+  { flag: "--note" },
+  { flag: "--learning" },
+  { flag: "--file" },
+  { flag: "--test" },
+  { flag: "--doc" },
+  { flag: "--reminder" },
+  { flag: "--event" },
+  { flag: "--type-option" },
+  { flag: "--type_option" },
+  { flag: "--unset" },
+  { flag: "--clear-deps" },
+  { flag: "--clear-comments" },
+  { flag: "--clear-notes" },
+  { flag: "--clear-learnings" },
+  { flag: "--clear-files" },
+  { flag: "--clear-tests" },
+  { flag: "--clear-docs" },
+  { flag: "--clear-reminders" },
+  { flag: "--clear-events" },
+  { flag: "--clear-type-options" },
+  { flag: "--allow-audit-update" },
+  { flag: "--allow_audit_update" },
+  { flag: "--allow-audit-dep-update" },
+  { flag: "--allow_audit_dep_update" },
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--force" }
 ];
-var TOOL_SEARCH_FILTER_OPTION_CONTRACTS = [
-  { param: "matchMode", flag: "--match-mode" },
-  { param: "minScore", flag: "--min-score" },
-  { param: "count", flag: "--count", booleanish: true },
-  { param: "semanticWeight", flag: "--semantic-weight" },
-  ...cloneOptionContracts(TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS),
-  ...cloneOptionContracts(TOOL_ITEM_WINDOW_FILTER_OPTION_CONTRACTS),
-  ...cloneOptionContracts(TOOL_SEARCH_RELATION_FILTER_OPTION_CONTRACTS),
-  ...cloneOptionContracts(TOOL_GOVERNANCE_MISSING_OPTION_CONTRACTS),
-  ...cloneOptionContracts(TOOL_CONTENT_PRESENCE_OPTION_CONTRACTS),
-  { param: "fields", flag: "--fields" },
-  { param: "limit", flag: "--limit" }
+var NORMALIZE_FLAG_CONTRACTS = [
+  { flag: "--filter-status" },
+  { flag: "--filter-type" },
+  { flag: "--filter-tag" },
+  { flag: "--filter-priority" },
+  { flag: "--filter-deadline-before" },
+  { flag: "--filter-deadline-after" },
+  { flag: "--filter-assignee" },
+  { flag: "--filter-assignee-filter" },
+  { flag: "--filter-assignee_filter" },
+  { flag: "--filter-parent" },
+  { flag: "--filter-sprint" },
+  { flag: "--filter-release" },
+  { flag: "--limit" },
+  { flag: "--offset" },
+  { flag: "--dry-run" },
+  { flag: "--apply" },
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--allow-audit-update" },
+  { flag: "--allow_audit_update" },
+  { flag: "--force" }
 ];
-var TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = [
-  { param: "parent", flag: "--parent" },
-  { param: "reviewer", flag: "--reviewer" },
-  { param: "risk", flag: "--risk" },
-  { param: "confidence", flag: "--confidence" },
-  { param: "sprint", flag: "--sprint" },
-  { param: "release", flag: "--release" },
-  { param: "blockedBy", flag: "--blocked-by" },
-  { param: "blockedReason", flag: "--blocked-reason" },
-  { param: "unblockNote", flag: "--unblock-note" },
-  { param: "reporter", flag: "--reporter" },
-  { param: "severity", flag: "--severity" },
-  { param: "environment", flag: "--environment" },
-  { param: "reproSteps", flag: "--repro-steps" },
-  { param: "resolution", flag: "--resolution" },
-  { param: "expectedResult", flag: "--expected-result" },
-  { param: "actualResult", flag: "--actual-result" },
-  { param: "affectedVersion", flag: "--affected-version" },
-  { param: "fixedVersion", flag: "--fixed-version" },
-  { param: "component", flag: "--component" },
-  { param: "regression", flag: "--regression", booleanish: true },
-  { param: "customerImpact", flag: "--customer-impact" },
-  { param: "definitionOfReady", flag: "--definition-of-ready", allowEmpty: true },
-  { param: "order", flag: "--order" },
-  { param: "goal", flag: "--goal" },
-  { param: "objective", flag: "--objective" },
-  { param: "value", flag: "--value" },
-  { param: "impact", flag: "--impact" },
-  { param: "outcome", flag: "--outcome" },
-  { param: "whyNow", flag: "--why-now" }
+var CALENDAR_FLAG_CONTRACTS = [
+  { flag: "--view" },
+  { flag: "--date" },
+  { flag: "--from" },
+  { flag: "--to" },
+  { flag: "--past" },
+  { flag: "--full-period" },
+  { flag: "--full_period" },
+  { flag: "--type" },
+  { flag: "--tag" },
+  { flag: "--priority" },
+  { flag: "--status" },
+  { flag: "--assignee" },
+  { flag: "--assignee-filter" },
+  { flag: "--assignee_filter" },
+  { flag: "--sprint" },
+  { flag: "--release" },
+  { flag: "--include" },
+  { flag: "--recurrence-lookahead-days" },
+  { flag: "--recurrence-lookback-days" },
+  { flag: "--occurrence-limit" },
+  { flag: "--limit" },
+  { flag: "--format" }
 ];
-var TOOL_CREATE_OPTION_CONTRACTS = [
-  { param: "title", flag: "--title" },
-  { param: "description", flag: "--description", allowEmpty: true },
-  { param: "type", flag: "--type" },
-  { param: "template", flag: "--template" },
-  { param: "createMode", flag: "--create-mode" },
-  { param: "schedulePreset", flag: "--schedule-preset" },
-  { param: "status", flag: "--status" },
-  { param: "priority", flag: "--priority" },
-  { param: "tags", flag: "--tags", allowEmpty: true },
-  { param: "addTags", flag: "--add-tags", repeatable: true },
-  { param: "body", flag: "--body", allowEmpty: true },
-  { param: "deadline", flag: "--deadline" },
-  { param: "estimate", flag: "--estimate" },
-  { param: "acceptanceCriteria", flag: "--acceptance-criteria", allowEmpty: true },
-  { param: "author", flag: "--author" },
-  { param: "message", flag: "--message", allowEmpty: true },
-  { param: "assignee", flag: "--assignee" },
-  { param: "allowMissingParent", flag: "--allow-missing-parent" },
-  { param: "reminder", flag: "--reminder", repeatable: true },
-  { param: "event", flag: "--event", repeatable: true },
-  { param: "typeOption", flag: "--type-option", repeatable: true },
-  { param: "field", flag: "--field", repeatable: true },
-  { param: "dep", flag: "--dep", repeatable: true },
-  { param: "comment", flag: "--comment", repeatable: true },
-  { param: "note", flag: "--note", repeatable: true },
-  { param: "learning", flag: "--learning", repeatable: true },
-  { param: "linkedFile", flag: "--file", repeatable: true },
-  { param: "linkedTest", flag: "--test", repeatable: true },
-  { param: "doc", flag: "--doc", repeatable: true },
-  { param: "unset", flag: "--unset", repeatable: true },
-  { param: "clearDeps", flag: "--clear-deps" },
-  { param: "clearComments", flag: "--clear-comments" },
-  { param: "clearNotes", flag: "--clear-notes" },
-  { param: "clearLearnings", flag: "--clear-learnings" },
-  { param: "clearFiles", flag: "--clear-files" },
-  { param: "clearTests", flag: "--clear-tests" },
-  { param: "clearDocs", flag: "--clear-docs" },
-  { param: "clearReminders", flag: "--clear-reminders" },
-  { param: "clearEvents", flag: "--clear-events" },
-  { param: "clearTypeOptions", flag: "--clear-type-options" }
+var ACTIVITY_FLAG_CONTRACTS = [
+  { flag: "--id" },
+  { flag: "--op" },
+  { flag: "--author" },
+  { flag: "--from" },
+  { flag: "--to" },
+  { flag: "--limit" },
+  { flag: "--compact" },
+  { flag: "--full" },
+  { flag: "--stream" }
 ];
-var TOOL_UPDATE_OPTION_CONTRACTS = [
-  { param: "title", flag: "--title" },
-  { param: "description", flag: "--description", allowEmpty: true },
-  { param: "body", flag: "--body", allowEmpty: true },
-  { param: "status", flag: "--status" },
-  { param: "closeReason", flag: "--close-reason" },
-  { param: "priority", flag: "--priority" },
-  { param: "type", flag: "--type" },
-  { param: "tags", flag: "--tags", allowEmpty: true },
-  { param: "addTags", flag: "--add-tags", repeatable: true },
-  { param: "removeTags", flag: "--remove-tags", repeatable: true },
-  { param: "deadline", flag: "--deadline" },
-  { param: "estimate", flag: "--estimate" },
-  { param: "acceptanceCriteria", flag: "--acceptance-criteria", allowEmpty: true },
-  { param: "author", flag: "--author" },
-  { param: "message", flag: "--message", allowEmpty: true },
-  { param: "assignee", flag: "--assignee" },
-  { param: "dep", flag: "--dep", repeatable: true },
-  { param: "depRemove", flag: "--dep-remove", repeatable: true },
-  { param: "replaceDeps", flag: "--replace-deps" },
-  { param: "replaceTests", flag: "--replace-tests" },
-  { param: "comment", flag: "--comment", repeatable: true },
-  { param: "note", flag: "--note", repeatable: true },
-  { param: "learning", flag: "--learning", repeatable: true },
-  { param: "linkedFile", flag: "--file", repeatable: true },
-  { param: "linkedTest", flag: "--test", repeatable: true },
-  { param: "doc", flag: "--doc", repeatable: true },
-  { param: "reminder", flag: "--reminder", repeatable: true },
-  { param: "event", flag: "--event", repeatable: true },
-  { param: "typeOption", flag: "--type-option", repeatable: true },
-  { param: "field", flag: "--field", repeatable: true },
-  { param: "unset", flag: "--unset", repeatable: true },
-  { param: "clearDeps", flag: "--clear-deps" },
-  { param: "clearComments", flag: "--clear-comments" },
-  { param: "clearNotes", flag: "--clear-notes" },
-  { param: "clearLearnings", flag: "--clear-learnings" },
-  { param: "clearFiles", flag: "--clear-files" },
-  { param: "clearTests", flag: "--clear-tests" },
-  { param: "clearDocs", flag: "--clear-docs" },
-  { param: "clearReminders", flag: "--clear-reminders" },
-  { param: "clearEvents", flag: "--clear-events" },
-  { param: "clearTypeOptions", flag: "--clear-type-options" },
-  { param: "allowAuditUpdate", flag: "--allow-audit-update" },
-  { param: "allowAuditDepUpdate", flag: "--allow-audit-dep-update" }
+var CONTEXT_FLAG_CONTRACTS = [
+  { flag: "--date" },
+  { flag: "--from" },
+  { flag: "--to" },
+  { flag: "--past" },
+  { flag: "--type" },
+  { flag: "--tag" },
+  { flag: "--priority" },
+  { flag: "--assignee" },
+  { flag: "--assignee-filter" },
+  { flag: "--assignee_filter" },
+  { flag: "--sprint" },
+  { flag: "--release" },
+  { flag: "--parent" },
+  { flag: "--limit" },
+  { flag: "--format" },
+  { flag: "--depth" },
+  { flag: "--fields", list: true },
+  { flag: "--section" },
+  { flag: "--activity-limit" },
+  { flag: "--stale-threshold" }
 ];
-var TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS = [
-  { param: "filterStatus", flag: "--filter-status" },
-  { param: "filterType", flag: "--filter-type" },
-  { param: "filterTag", flag: "--filter-tag" },
-  { param: "filterPriority", flag: "--filter-priority" },
-  { param: "filterDeadlineBefore", flag: "--filter-deadline-before" },
-  { param: "filterDeadlineAfter", flag: "--filter-deadline-after" },
-  { param: "filterUpdatedAfter", flag: "--filter-updated-after" },
-  { param: "filterUpdatedBefore", flag: "--filter-updated-before" },
-  { param: "filterCreatedAfter", flag: "--filter-created-after" },
-  { param: "filterCreatedBefore", flag: "--filter-created-before" },
-  { param: "filterAssignee", flag: "--filter-assignee" },
-  { param: "filterAssigneeFilter", flag: "--filter-assignee-filter" },
-  { param: "filterParent", flag: "--filter-parent" },
-  { param: "filterSprint", flag: "--filter-sprint" },
-  { param: "filterRelease", flag: "--filter-release" },
-  { param: "filterReviewerMissing", flag: "--filter-reviewer-missing" },
-  { param: "filterRiskMissing", flag: "--filter-risk-missing" },
-  { param: "filterConfidenceMissing", flag: "--filter-confidence-missing" },
-  { param: "filterSprintMissing", flag: "--filter-sprint-missing" },
-  { param: "filterReleaseMissing", flag: "--filter-release-missing" },
-  { param: "filterHasNotes", flag: "--filter-has-notes" },
-  { param: "filterNoNotes", flag: "--filter-no-notes" },
-  { param: "filterHasLearnings", flag: "--filter-has-learnings" },
-  { param: "filterNoLearnings", flag: "--filter-no-learnings" },
-  { param: "filterHasFiles", flag: "--filter-has-files" },
-  { param: "filterNoFiles", flag: "--filter-no-files" },
-  { param: "filterHasDocs", flag: "--filter-has-docs" },
-  { param: "filterNoDocs", flag: "--filter-no-docs" },
-  { param: "filterHasTests", flag: "--filter-has-tests" },
-  { param: "filterNoTests", flag: "--filter-no-tests" },
-  { param: "filterHasComments", flag: "--filter-has-comments" },
-  { param: "filterNoComments", flag: "--filter-no-comments" },
-  { param: "filterHasDeps", flag: "--filter-has-deps" },
-  { param: "filterNoDeps", flag: "--filter-no-deps" },
-  { param: "filterHasBody", flag: "--filter-has-body" },
-  { param: "filterEmptyBody", flag: "--filter-empty-body" },
-  { param: "filterHasLinkedCommand", flag: "--filter-has-linked-command" },
-  { param: "filterNoLinkedCommand", flag: "--filter-no-linked-command" },
-  { param: "ids", flag: "--ids" },
-  { param: "limit", flag: "--limit" },
-  { param: "offset", flag: "--offset" }
+var GET_FLAG_CONTRACTS = [
+  { flag: "--depth" },
+  { flag: "--full" },
+  { flag: "--fields", list: true },
+  { flag: "--tree" },
+  { flag: "--tree-depth" },
+  { flag: "--tree_depth" },
+  { flag: "--format" }
 ];
-var TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [
-  ...cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS)
+var GUIDE_FLAG_CONTRACTS = [
+  { flag: "--list" },
+  { flag: "--format" },
+  { flag: "--depth" }
 ];
-var TOOL_NORMALIZE_FILTER_OPTION_CONTRACTS = [
-  { param: "filterStatus", flag: "--filter-status" },
-  { param: "filterType", flag: "--filter-type" },
-  { param: "filterTag", flag: "--filter-tag" },
-  { param: "filterPriority", flag: "--filter-priority" },
-  { param: "filterDeadlineBefore", flag: "--filter-deadline-before" },
-  { param: "filterDeadlineAfter", flag: "--filter-deadline-after" },
-  { param: "filterAssignee", flag: "--filter-assignee" },
-  { param: "filterAssigneeFilter", flag: "--filter-assignee-filter" },
-  { param: "filterParent", flag: "--filter-parent" },
-  { param: "filterSprint", flag: "--filter-sprint" },
-  { param: "filterRelease", flag: "--filter-release" },
-  { param: "limit", flag: "--limit" },
-  { param: "offset", flag: "--offset" }
+var DEPS_FLAG_CONTRACTS = [
+  { flag: "--format" },
+  { flag: "--max-depth" },
+  { flag: "--collapse" },
+  { flag: "--summary" }
 ];
-var TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS = [
-  ...cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS)
+var EVAL_FLAG_CONTRACTS = [
+  { flag: "--mode" },
+  { flag: "--k" },
+  { flag: "--fail-under" },
+  { flag: "--queries" },
+  { flag: "--format" }
 ];
-var TOOL_ACTIVITY_OPTION_CONTRACTS = [
-  { param: "id", flag: "--id" },
-  { param: "op", flag: "--op" },
-  { param: "author", flag: "--author" },
-  { param: "from", flag: "--from" },
-  { param: "to", flag: "--to" },
-  { param: "limit", flag: "--limit" },
-  { param: "compact", flag: "--compact" },
-  { param: "full", flag: "--full" }
+var NEXT_FLAG_CONTRACTS = [
+  { flag: "--type" },
+  { flag: "--tag" },
+  { flag: "--priority" },
+  { flag: "--assignee" },
+  { flag: "--assignee-filter" },
+  { flag: "--assignee_filter" },
+  { flag: "--sprint" },
+  { flag: "--release" },
+  { flag: "--parent" },
+  { flag: "--limit" },
+  { flag: "--blocked-limit" },
+  { flag: "--blocked_limit" },
+  { flag: "--ready-only" },
+  { flag: "--ready_only" },
+  { flag: "--format" }
 ];
-var TOOL_CONTEXT_OPTION_CONTRACTS = [
-  { param: "date", flag: "--date" },
-  { param: "from", flag: "--from" },
-  { param: "to", flag: "--to" },
-  { param: "type", flag: "--type" },
-  { param: "tag", flag: "--tag" },
-  { param: "priority", flag: "--priority" },
-  { param: "assignee", flag: "--assignee" },
-  { param: "assigneeFilter", flag: "--assignee-filter" },
-  { param: "sprint", flag: "--sprint" },
-  { param: "release", flag: "--release" },
-  { param: "parent", flag: "--parent" },
-  { param: "limit", flag: "--limit" },
-  { param: "format", flag: "--format" },
-  { param: "depth", flag: "--depth" },
-  { param: "fields", flag: "--fields" },
-  { param: "section", flag: "--section", repeatable: true },
-  { param: "activityLimit", flag: "--activity-limit" },
-  { param: "staleThreshold", flag: "--stale-threshold" }
+var 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" },
+  { flag: "--phrase-exact" },
+  { flag: "--highlight" },
+  { flag: "--compact" },
+  { flag: "--full" },
+  { flag: "--fields", list: true },
+  { flag: "--format" },
+  { flag: "--limit" },
+  { flag: "--status", list: true },
+  { flag: "--type" },
+  { flag: "--tag", aliases: ["--tags"] },
+  { 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" },
+  ...GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS
+];
+var CONTRACTS_FLAG_CONTRACTS = [
+  { flag: "--action" },
+  { flag: "--command" },
+  { flag: "--schema-only" },
+  { flag: "--flags-only" },
+  { flag: "--availability-only" },
+  { flag: "--runtime-only" },
+  { flag: "--active-only" },
+  { flag: "--full" }
+];
+var COMPLETION_FLAG_CONTRACTS = [
+  { flag: "--eager-tags" }
+];
+function toUniqueFlagContracts(contracts) {
+  const seen = /* @__PURE__ */ new Set();
+  const unique = [];
+  for (const contract of contracts) {
+    const aliasKey = (contract.aliases ?? []).join(",");
+    const key = `${contract.flag}|${contract.short ?? ""}|${aliasKey}`;
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    unique.push(contract);
+  }
+  return unique;
+}
+function withSubcommandGlobalFlags(contracts) {
+  return withFlagAliasMetadata(toUniqueFlagContracts([...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, ...contracts]));
+}
+var LIST_COMMAND_FLAG_ALIASES = [
+  "list",
+  "list-all",
+  "list-draft",
+  "list-open",
+  "list-in-progress",
+  "list-blocked",
+  "list-closed",
+  "list-canceled"
 ];
+var SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND = new Map([
+  ...LIST_COMMAND_FLAG_ALIASES.map((command) => [command, LIST_FILTER_FLAG_CONTRACTS]),
+  ["templates", CREATE_FLAG_CONTRACTS],
+  ["cal", CALENDAR_FLAG_CONTRACTS],
+  ["ctx", CONTEXT_FLAG_CONTRACTS],
+  ["test-runs-worker", TEST_RUNS_FLAG_CONTRACTS],
+  ["init", INIT_FLAG_CONTRACTS],
+  ["config", CONFIG_FLAG_CONTRACTS],
+  ["extension", EXTENSION_FLAG_CONTRACTS],
+  // `--declarative` is package-only (see PACKAGE_FLAG_CONTRACTS).
+  ["package", PACKAGE_FLAG_CONTRACTS],
+  ["packages", PACKAGE_FLAG_CONTRACTS],
+  ["install", INSTALL_FLAG_CONTRACTS],
+  ["upgrade", UPGRADE_FLAG_CONTRACTS],
+  ["create", CREATE_FLAG_CONTRACTS],
+  ["copy", COPY_FLAG_CONTRACTS],
+  ["focus", FOCUS_FLAG_CONTRACTS],
+  ["aggregate", AGGREGATE_FLAG_CONTRACTS],
+  ["dedupe-audit", DEDUPE_AUDIT_FLAG_CONTRACTS],
+  ["dedupe-merge", DEDUPE_MERGE_FLAG_CONTRACTS],
+  ["normalize", NORMALIZE_FLAG_CONTRACTS],
+  ["calendar", CALENDAR_FLAG_CONTRACTS],
+  ["context", CONTEXT_FLAG_CONTRACTS],
+  ["get", GET_FLAG_CONTRACTS],
+  ["guide", GUIDE_FLAG_CONTRACTS],
+  ["search", SEARCH_FLAG_CONTRACTS],
+  ["next", NEXT_FLAG_CONTRACTS],
+  ["eval", EVAL_FLAG_CONTRACTS],
+  ["history", HISTORY_FLAG_CONTRACTS],
+  ["history-redact", HISTORY_REDACT_FLAG_CONTRACTS],
+  ["history-repair", HISTORY_REPAIR_FLAG_CONTRACTS],
+  ["history-compact", HISTORY_COMPACT_FLAG_CONTRACTS],
+  ["schema", SCHEMA_FLAG_CONTRACTS],
+  ["profile", PROFILE_FLAG_CONTRACTS],
+  ["plan", PLAN_FLAG_CONTRACTS],
+  ["activity", ACTIVITY_FLAG_CONTRACTS],
+  ["restore", RESTORE_FLAG_CONTRACTS],
+  ["update", UPDATE_FLAG_CONTRACTS],
+  ["update-many", UPDATE_MANY_FLAG_CONTRACTS],
+  ["close", CLOSE_FLAG_CONTRACTS],
+  ["close-many", CLOSE_MANY_FLAG_CONTRACTS],
+  ["delete", DELETE_FLAG_CONTRACTS],
+  ["append", APPEND_FLAG_CONTRACTS],
+  ["comments", COMMENTS_FLAG_CONTRACTS],
+  ["comments-audit", COMMENTS_AUDIT_FLAG_CONTRACTS],
+  ["notes", NOTES_FLAG_CONTRACTS],
+  ["learnings", LEARNINGS_FLAG_CONTRACTS],
+  ["files", FILES_FLAG_CONTRACTS],
+  ["docs", DOCS_FLAG_CONTRACTS],
+  ["deps", DEPS_FLAG_CONTRACTS],
+  ["test", TEST_FLAG_CONTRACTS],
+  ["test-all", TEST_ALL_FLAG_CONTRACTS],
+  ["telemetry", TELEMETRY_FLAG_CONTRACTS],
+  ["health", HEALTH_FLAG_CONTRACTS],
+  ["validate", VALIDATE_FLAG_CONTRACTS],
+  ["gc", GC_FLAG_CONTRACTS],
+  ["stats", STATS_FLAG_CONTRACTS],
+  ["contracts", CONTRACTS_FLAG_CONTRACTS],
+  ["completion", COMPLETION_FLAG_CONTRACTS],
+  ["claim", CLAIM_FLAG_CONTRACTS],
+  ["release", RELEASE_FLAG_CONTRACTS],
+  ["start-task", START_TASK_FLAG_CONTRACTS],
+  ["pause-task", PAUSE_TASK_FLAG_CONTRACTS],
+  ["close-task", CLOSE_TASK_FLAG_CONTRACTS],
+  ["meet", MEET_FLAG_CONTRACTS],
+  ["event", EVENT_FLAG_CONTRACTS],
+  ["remind", REMIND_FLAG_CONTRACTS]
+]);
+var EXTENSION_LIFECYCLE_FLAG_CONTRACTS_BY_SUBCOMMAND = /* @__PURE__ */ new Map([
+  ["install", EXTENSION_INSTALL_FLAG_CONTRACTS],
+  ["uninstall", EXTENSION_UNINSTALL_FLAG_CONTRACTS],
+  ["explore", EXTENSION_EXPLORE_FLAG_CONTRACTS],
+  ["manage", EXTENSION_MANAGE_FLAG_CONTRACTS],
+  ["describe", EXTENSION_DESCRIBE_FLAG_CONTRACTS],
+  ["reload", EXTENSION_RELOAD_FLAG_CONTRACTS],
+  ["doctor", EXTENSION_DOCTOR_FLAG_CONTRACTS],
+  ["catalog", EXTENSION_CATALOG_FLAG_CONTRACTS],
+  ["adopt", EXTENSION_ADOPT_FLAG_CONTRACTS],
+  ["adopt-all", EXTENSION_ADOPT_ALL_FLAG_CONTRACTS],
+  ["activate", EXTENSION_ACTIVATE_FLAG_CONTRACTS],
+  ["deactivate", EXTENSION_DEACTIVATE_FLAG_CONTRACTS]
+]);
+function normalizeCommandNameForContracts(commandName) {
+  if (typeof commandName !== "string") {
+    return "";
+  }
+  return commandName.trim().toLowerCase();
+}
+function resolveExtensionLifecycleFlagContracts(rootCommand, lifecycleSubcommand) {
+  if (lifecycleSubcommand === "init") {
+    return rootCommand === "extension" ? EXTENSION_INIT_FLAG_CONTRACTS : PACKAGE_INIT_FLAG_CONTRACTS;
+  }
+  return EXTENSION_LIFECYCLE_FLAG_CONTRACTS_BY_SUBCOMMAND.get(lifecycleSubcommand) ?? [];
+}
+function resolveSubcommandFlagContractsForCommand(commandName) {
+  const normalized = normalizeCommandNameForContracts(commandName);
+  if (normalized.length === 0) {
+    return withSubcommandGlobalFlags([]);
+  }
+  const [rootCommand, lifecycleSubcommand, ...extraParts] = normalized.split(/\s+/);
+  if ((rootCommand === "extension" || rootCommand === "package" || rootCommand === "packages") && lifecycleSubcommand !== void 0 && extraParts.length === 0) {
+    return withSubcommandGlobalFlags(resolveExtensionLifecycleFlagContracts(rootCommand, lifecycleSubcommand));
+  }
+  return withSubcommandGlobalFlags(SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND.get(normalized) ?? []);
+}
+function toCompletionFlagString(flagContracts, includeGlobal = true) {
+  const aliasAwareContracts = withFlagAliasMetadata(flagContracts);
+  const scoped = aliasAwareContracts.flatMap((entry) => [entry.short, entry.flag, ...entry.aliases ?? []]).filter((value) => Boolean(value));
+  const all = includeGlobal ? [
+    ...scoped,
+    ...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS.flatMap((entry) => [entry.short, entry.flag, ...entry.aliases ?? []]).filter((value) => Boolean(value))
+  ] : scoped;
+  return normalizeUniqueStringList(all).join(" ");
+}
 // dist/sdk/cli-contracts/tool-parameter-tables.js
 var PM_TOOL_PARAMETER_PROPERTIES = {
@@ -4522,6 +4574,17 @@ function buildProviderCompatibleToolSchema() {
   };
 }
 var PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(buildProviderCompatibleToolSchema);
+var _testOnlyCliContracts = {
+  buildActionScopedToolSchema,
+  buildProviderCompatibleToolSchema,
+  decorateActionScopedToolParameterDefinition,
+  decorateToolParameterDefinition,
+  toolActionSchemaContracts: PM_TOOL_ACTION_SCHEMA_CONTRACTS,
+  toolParameterMetadata: PM_TOOL_PARAMETER_METADATA,
+  toProviderCompatibleParameterDefinition,
+  toUniqueFlagContracts,
+  withFlagAliasMetadata
+};
 export {
   LIST_COMMANDER_STRING_OPTION_CONTRACTS,
@@ -4547,7 +4610,28 @@ export {
   PM_EXTENSION_POLICY_SURFACE_CONTRACTS,
   PM_CORE_COMMAND_NAMES,
   PM_TOOL_ACTIONS,
+  isPmToolAction,
+  isPmExtensionCapabilityContract,
+  isPmExtensionServiceNameContract,
+  isPmExtensionPolicyModeContract,
+  isPmExtensionPolicySurfaceContract,
+  TOOL_LIST_FILTER_OPTION_CONTRACTS,
+  TOOL_AGGREGATE_OPTION_CONTRACTS,
+  TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS,
+  TOOL_SEARCH_FILTER_OPTION_CONTRACTS,
+  TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS,
+  TOOL_CREATE_OPTION_CONTRACTS,
+  TOOL_UPDATE_OPTION_CONTRACTS,
+  TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS,
+  TOOL_NORMALIZE_FILTER_OPTION_CONTRACTS,
+  TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS,
+  TOOL_CALENDAR_OPTION_CONTRACTS,
+  TOOL_ACTIVITY_OPTION_CONTRACTS,
+  TOOL_CONTEXT_OPTION_CONTRACTS,
+  TOOL_DEPS_OPTION_CONTRACTS,
+  withFlagAliasMetadata,
   compactFlagAliasContracts,
+  SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,
   GLOBAL_FLAG_CONTRACTS,
   LIST_FILTER_FLAG_CONTRACTS,
   AGGREGATE_FLAG_CONTRACTS,
@@ -4569,6 +4653,7 @@ export {
   INIT_FLAG_CONTRACTS,
   CONFIG_FLAG_CONTRACTS,
   EXTENSION_FLAG_CONTRACTS,
+  EXTENSION_SCOPE_FLAG_CONTRACTS,
   EXTENSION_INIT_FLAG_CONTRACTS,
   PACKAGE_FLAG_CONTRACTS,
   PACKAGE_INIT_FLAG_CONTRACTS,
@@ -4597,6 +4682,9 @@ export {
   START_TASK_FLAG_CONTRACTS,
   PAUSE_TASK_FLAG_CONTRACTS,
   CLOSE_TASK_FLAG_CONTRACTS,
+  MEET_FLAG_CONTRACTS,
+  EVENT_FLAG_CONTRACTS,
+  REMIND_FLAG_CONTRACTS,
   TEST_FLAG_CONTRACTS,
   TEST_ALL_FLAG_CONTRACTS,
   TELEMETRY_FLAG_CONTRACTS,
@@ -4606,6 +4694,8 @@ export {
   HEALTH_FLAG_CONTRACTS,
   VALIDATE_FLAG_CONTRACTS,
   CREATE_FLAG_CONTRACTS,
+  COPY_FLAG_CONTRACTS,
+  FOCUS_FLAG_CONTRACTS,
   UPDATE_FLAG_CONTRACTS,
   UPDATE_MANY_FLAG_CONTRACTS,
   NORMALIZE_FLAG_CONTRACTS,
@@ -4621,8 +4711,15 @@ export {
   CONTRACTS_FLAG_CONTRACTS,
   COMPLETION_FLAG_CONTRACTS,
   resolveSubcommandFlagContractsForCommand,
-  PM_TOOL_PARAMETERS_SCHEMA
+  toCompletionFlagString,
+  PM_TOOL_ACTION_PARAMETER_CONTRACTS,
+  PM_TOOL_PARAMETERS_SCHEMA_VERSION,
+  PM_TOOL_PARAMETERS_SCHEMA_MAJOR,
+  PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION,
+  PM_TOOL_PARAMETERS_SCHEMA,
+  PM_PROVIDER_TOOL_PARAMETERS_SCHEMA,
+  _testOnlyCliContracts
 };
-//# sourceMappingURL=chunk-LLQLLAKU.js.map
+//# sourceMappingURL=chunk-PPE4YUQM.js.map
-//# debugId=4864c4b3-8a15-5324-8332-42e51eb9a217
+//# debugId=35ca0798-2e49-5524-996c-72aaeb970d26