@unbrained/pm-cli 2026.7.3 → 2026.7.5

package/dist/cli-bundle/chunks/{chunk-572FKBRL.js → chunk-PPE4YUQM.js}

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8006b49d-650e-5e01-b633-dd123c57b2d8")}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-L4SLHV6G.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,989 +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" }
-];
-var GLOBAL_FLAG_CONTRACTS = [
-  ...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,
-  { flag: "--version" }
+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 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: "--has-docs" },
-  { flag: "--no-docs" },
-  { flag: "--has-tests" },
-  { flag: "--no-tests" },
-  { flag: "--has-comments" },
-  { flag: "--no-comments" },
-  { flag: "--has-deps" },
-  { flag: "--no-deps" },
-  { flag: "--has-body" },
-  { flag: "--empty-body" },
-  { flag: "--has-linked-command" },
-  { flag: "--no-linked-command" }
+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 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_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 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_SEARCH_RELATION_FILTER_OPTION_CONTRACTS = [
+  { param: "assignee", flag: "--assignee" },
+  { param: "sprint", flag: "--sprint" },
+  { param: "release", flag: "--release" },
+  { param: "parent", flag: "--parent" }
 ];
-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_BASIC_ITEM_FILTER_OPTION_CONTRACTS = [
+  ...TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS,
+  ...TOOL_ITEM_RELATION_FILTER_OPTION_CONTRACTS
 ];
-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_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_MERGE_FLAG_CONTRACTS = [
-  { flag: "--keep" },
-  { flag: "--close", list: true },
-  { flag: "--apply" },
-  { flag: "--dry-run" },
-  { flag: "--skip-children" },
-  { flag: "--author" },
-  { flag: "--message" }
+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 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" },
-  { 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"] },
+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 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: "--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
-];
-var EVENT_FLAG_CONTRACTS = MEET_FLAG_CONTRACTS;
-var REMIND_FLAG_CONTRACTS = [
-  { flag: "--at" },
-  { flag: "--text" },
-  ...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS
-];
-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: "--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 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 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 TELEMETRY_FLAG_CONTRACTS = [
-  { flag: "--limit" }
+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_RUNS_FLAG_CONTRACTS = [
-  { flag: "--status" },
-  { flag: "--limit" },
-  { flag: "--stream" },
-  { flag: "--tail" },
-  { flag: "--force" },
-  { flag: "--author" }
+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 GC_FLAG_CONTRACTS = [
-  { flag: "--dry-run" },
-  { flag: "--scope" }
+var EXTENSION_SCOPE_FLAG_CONTRACTS = [
+  { flag: "--project" },
+  { flag: "--local" },
+  { flag: "--global" }
 ];
-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_INIT_FLAG_CONTRACTS = [
+  ...EXTENSION_SCOPE_FLAG_CONTRACTS,
+  { flag: "--capability" }
 ];
-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 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 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_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" }
+];
+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: "--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: "--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: "--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" },
@@ -1827,723 +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" },
-  { flag: "--limit" },
-  { flag: "--blocked-limit" },
-  { flag: "--blocked_limit" },
-  { flag: "--ready-only" },
-  { flag: "--ready_only" },
-  { flag: "--format" }
+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 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 TEST_ALL_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: "--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 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 TELEMETRY_FLAG_CONTRACTS = [
+  { flag: "--limit" }
 ];
-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 TEST_RUNS_FLAG_CONTRACTS = [
+  { flag: "--status" },
+  { flag: "--limit" },
+  { flag: "--stream" },
+  { flag: "--tail" },
+  { flag: "--force" },
+  { flag: "--author" }
 ];
-var TOOL_SEARCH_RELATION_FILTER_OPTION_CONTRACTS = [
-  { param: "assignee", flag: "--assignee" },
-  { param: "sprint", flag: "--sprint" },
-  { param: "release", flag: "--release" },
-  { param: "parent", flag: "--parent" }
+var GC_FLAG_CONTRACTS = [
+  { flag: "--dry-run" },
+  { flag: "--scope" }
 ];
-var TOOL_BASIC_ITEM_FILTER_OPTION_CONTRACTS = [
-  ...TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS,
-  ...TOOL_ITEM_RELATION_FILTER_OPTION_CONTRACTS
+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_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 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_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: "hasDocs", flag: "--has-docs" },
-  { param: "noDocs", flag: "--no-docs" },
-  { 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 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_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 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_AGGREGATE_OPTION_CONTRACTS = [
-  { param: "groupBy", flag: "--group-by" },
-  { param: "sum", flag: "--sum" },
-  { param: "avg", flag: "--avg" },
-  ...cloneOptionContracts(TOOL_BASIC_ITEM_FILTER_OPTION_CONTRACTS)
+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: "--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 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 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_DEDUPE_AUDIT_OPTION_CONTRACTS = [
-  { param: "mode", flag: "--mode" },
-  { param: "limit", flag: "--limit" },
-  { param: "threshold", flag: "--threshold" },
-  ...cloneOptionContracts(TOOL_BASIC_ITEM_FILTER_OPTION_CONTRACTS)
+var ACTIVITY_FLAG_CONTRACTS = [
+  { flag: "--id" },
+  { flag: "--op" },
+  { flag: "--author" },
+  { flag: "--from" },
+  { flag: "--to" },
+  { flag: "--limit" },
+  { flag: "--compact" },
+  { flag: "--full" },
+  { flag: "--stream" }
 ];
-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 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_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 GET_FLAG_CONTRACTS = [
+  { flag: "--depth" },
+  { flag: "--full" },
+  { flag: "--fields", list: true },
+  { flag: "--tree" },
+  { flag: "--tree-depth" },
+  { flag: "--tree_depth" },
+  { 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 GUIDE_FLAG_CONTRACTS = [
+  { flag: "--list" },
+  { flag: "--format" },
+  { flag: "--depth" }
 ];
-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 DEPS_FLAG_CONTRACTS = [
+  { flag: "--format" },
+  { flag: "--max-depth" },
+  { flag: "--collapse" },
+  { flag: "--summary" }
 ];
-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 EVAL_FLAG_CONTRACTS = [
+  { flag: "--mode" },
+  { flag: "--k" },
+  { flag: "--fail-under" },
+  { flag: "--queries" },
+  { flag: "--format" }
 ];
-var TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [
-  ...cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_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" },
+  { flag: "--limit" },
+  { flag: "--blocked-limit" },
+  { flag: "--blocked_limit" },
+  { flag: "--ready-only" },
+  { flag: "--ready_only" },
+  { flag: "--format" }
 ];
-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 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 TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS = [
-  ...cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_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 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 COMPLETION_FLAG_CONTRACTS = [
+  { flag: "--eager-tags" }
 ];
-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" }
+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 = {
@@ -3880,104 +3936,65 @@ var NEXT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
   "format"
 ]);
 var AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = ["author", "message", "force"];
+var MANAGED_EXTENSION_PACKAGE_OPTION_KEYS = [
+  "target",
+  "scope",
+  "github",
+  "ref",
+  "init",
+  "install",
+  "uninstall",
+  "explore",
+  "manage",
+  "describe",
+  "markdown",
+  "output",
+  "reload",
+  "doctor",
+  "catalog",
+  "adopt",
+  "adoptAll",
+  "activate",
+  "deactivate",
+  "runtimeProbe",
+  "fixManagedState",
+  "detail",
+  "trace",
+  "watch",
+  "strictExit",
+  "failOnWarn"
+];
+function managedLifecycleSchemaContracts(prefix) {
+  return {
+    [`${prefix}-init`]: { required: ["target"], optional: ["scope"] },
+    [`${prefix}-install`]: {
+      optional: ["target", "github", "scope", "ref"],
+      anyOfRequired: [["target"], ["github"]]
+    },
+    [`${prefix}-uninstall`]: { required: ["target"], optional: ["scope"] },
+    [`${prefix}-explore`]: { optional: ["scope"] },
+    [`${prefix}-manage`]: { optional: ["scope", "runtimeProbe", "fixManagedState"] },
+    [`${prefix}-describe`]: { optional: ["target", "scope", "markdown", "output"] },
+    [`${prefix}-reload`]: { optional: ["scope", "watch"] },
+    [`${prefix}-doctor`]: { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
+    [`${prefix}-catalog`]: { optional: ["scope", "fields"] },
+    [`${prefix}-adopt`]: { required: ["target"], optional: ["scope", "github", "ref"] },
+    [`${prefix}-adopt-all`]: { optional: ["scope"] },
+    [`${prefix}-activate`]: { required: ["target"], optional: ["scope"] },
+    [`${prefix}-deactivate`]: { required: ["target"], optional: ["scope"] },
+    [prefix]: {
+      optional: MANAGED_EXTENSION_PACKAGE_OPTION_KEYS
+    }
+  };
+}
 var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   init: { optional: ["prefix", "preset", "typePreset", "defaults", "author", "agentGuidance", "withPackages", "force", "verbose"] },
   config: {
     required: ["scope", "configAction"],
     optional: ["key", "value", "criterion", "clearCriteria", "format", "policy"]
   },
-  "extension-init": { required: ["target"], optional: ["scope"] },
-  "extension-install": {
-    optional: ["target", "github", "scope", "ref"],
-    anyOfRequired: [["target"], ["github"]]
-  },
-  "extension-uninstall": { required: ["target"], optional: ["scope"] },
-  "extension-explore": { optional: ["scope"] },
-  "extension-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
-  "extension-describe": { optional: ["target", "scope", "markdown", "output"] },
-  "extension-reload": { optional: ["scope", "watch"] },
-  "extension-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
-  "extension-catalog": { optional: ["scope", "fields"] },
-  "extension-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
-  "extension-adopt-all": { optional: ["scope"] },
-  "extension-activate": { required: ["target"], optional: ["scope"] },
-  "extension-deactivate": { required: ["target"], optional: ["scope"] },
-  extension: {
-    optional: [
-      "target",
-      "scope",
-      "github",
-      "ref",
-      "init",
-      "install",
-      "uninstall",
-      "explore",
-      "manage",
-      "describe",
-      "markdown",
-      "output",
-      "reload",
-      "doctor",
-      "catalog",
-      "adopt",
-      "adoptAll",
-      "activate",
-      "deactivate",
-      "runtimeProbe",
-      "fixManagedState",
-      "detail",
-      "trace",
-      "watch",
-      "strictExit",
-      "failOnWarn"
-    ]
-  },
-  "package-init": { required: ["target"], optional: ["scope"] },
-  "package-install": {
-    optional: ["target", "github", "scope", "ref"],
-    anyOfRequired: [["target"], ["github"]]
-  },
-  "package-uninstall": { required: ["target"], optional: ["scope"] },
-  "package-explore": { optional: ["scope"] },
-  "package-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
-  "package-describe": { optional: ["target", "scope", "markdown", "output"] },
-  "package-reload": { optional: ["scope", "watch"] },
-  "package-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
-  "package-catalog": { optional: ["scope", "fields"] },
-  "package-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
-  "package-adopt-all": { optional: ["scope"] },
-  "package-activate": { required: ["target"], optional: ["scope"] },
-  "package-deactivate": { required: ["target"], optional: ["scope"] },
-  package: {
-    optional: [
-      "target",
-      "scope",
-      "github",
-      "ref",
-      "init",
-      "install",
-      "uninstall",
-      "explore",
-      "manage",
-      "describe",
-      "markdown",
-      "output",
-      "reload",
-      "doctor",
-      "catalog",
-      "adopt",
-      "adoptAll",
-      "activate",
-      "deactivate",
-      "runtimeProbe",
-      "fixManagedState",
-      "detail",
-      "trace",
-      "watch",
-      "strictExit",
-      "failOnWarn"
-    ]
-  },
+  ...managedLifecycleSchemaContracts("extension"),
+  ...managedLifecycleSchemaContracts("package"),
   install: {
     optional: ["target", "github", "scope", "ref"],
     anyOfRequired: [["target"], ["github"]]
@@ -4557,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,
@@ -4582,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,
@@ -4604,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,
@@ -4632,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,
@@ -4641,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,
@@ -4656,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-572FKBRL.js.map
+//# sourceMappingURL=chunk-PPE4YUQM.js.map
 
-//# debugId=8006b49d-650e-5e01-b633-dd123c57b2d8
+//# debugId=35ca0798-2e49-5524-996c-72aaeb970d26