@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/cli-contracts/flag-contracts.js

@@ -1,1948 +1,2 @@
-/**
- * @module sdk/cli-contracts/flag-contracts
- *
- * Per-command CLI flag contracts — the canonical `--flag` vocabulary every pm
- * command accepts. The argv bootstrap normalizer, Commander registration, shell
- * completion, and the `pm contracts` command all read these contracts so the
- * flag surface stays single-sourced across the CLI, SDK, and MCP boundaries.
- */
-
-!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]="573d318a-5ebe-5547-8be7-16026a077c84")}catch(e){}}();
-import { normalizeUniqueStringList } from "./string-lists.js";
-import { RESERVED_EXTENSION_HOST_FLAGS } from "../../core/extensions/reserved-host-flags.js";
-import { PM_POSITIONAL_ACTION_CONTRACTS, } from "./grammar-contracts.js";
-function normalizeFlagAliasKey(flag) {
-    if (!flag.startsWith("--")) {
-        return flag;
-    }
-    return `--${flag.slice(2).replaceAll("_", "-")}`;
-}
-/** Returns the flag contracts with their `aliases` populated by folding every dash/underscore spelling of a flag into its canonical `--kebab-case` entry, so a single contract row advertises all accepted spellings. */
-export function withFlagAliasMetadata(flagContracts) {
-    const aliasesByCanonical = new Map();
-    for (const contract of flagContracts) {
-        const canonical = normalizeFlagAliasKey(contract.flag);
-        const bucket = aliasesByCanonical.get(canonical) ?? 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,
-        };
-    });
-}
-/**
- * Collapses alias-only duplicate rows into their canonical flag: runs
- * {@link withFlagAliasMetadata}, then drops contracts that merely restate an
- * alias already attached to a canonical flag, yielding a deduplicated list.
- */
-export 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);
-    });
-}
-/** Public contract for subcommand global flag contracts, shared by SDK and presentation-layer consumers. */
-export const SUBCOMMAND_GLOBAL_FLAG_CONTRACTS = RESERVED_EXTENSION_HOST_FLAGS.map((definition) => ({
-    flag: definition.flag,
-    reservation_scope: "inherited",
-    ...(definition.aliases ? { aliases: [...definition.aliases] } : {}),
-    ...(definition.value_name ? { value_name: definition.value_name } : {}),
-}));
-/** Public contract for global flag contracts, shared by SDK and presentation-layer consumers. */
-export const GLOBAL_FLAG_CONTRACTS = [
-    ...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,
-    { flag: "--version", value_type: "boolean", reservation_scope: "root_only" },
-    { flag: "--all", value_type: "boolean", reservation_scope: "root_only", description: "Expand root help to every command." },
-    { flag: "--explain", value_type: "boolean", reservation_scope: "root_only", description: "Expand root help with command guidance." },
-];
-/** Governance-missing (GH-236) + content-field presence/absence (GH-242) selection-filter flags shared verbatim by the `list` and `search` flag tables. Module-private on purpose — spread into both tables at the same position so the published contract order is unchanged. */
-const 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" },
-];
-/** `--filter-*`-prefixed governance/content selection flags plus the trailing `--ids`/`--limit`/`--offset` scoping entries shared verbatim by the bulk `update-many` and `close-many` flag tables. Module-private on purpose — spread into both tables at the same position so the published contract order is unchanged. */
-const 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" },
-];
-/** Public contract for list filter flag contracts, shared by SDK and presentation-layer consumers. */
-export const LIST_FILTER_FLAG_CONTRACTS = withCursorSemantics([
-    { flag: "--for", value_name: "intent" },
-    { flag: "--token-budget", aliases: ["--token_budget"] },
-    { flag: "--status", list: true },
-    { flag: "--all", value_type: "boolean" },
-    { flag: "--type", list: true },
-    { flag: "--tag", aliases: ["--tags"], list: true },
-    { flag: "--priority", list: true },
-    { flag: "--deadline-before" },
-    { flag: "--deadline-after" },
-    { flag: "--today" },
-    { flag: "--recent" },
-    { flag: "--updated-after" },
-    { flag: "--updated-before" },
-    { flag: "--created-after" },
-    { flag: "--created-before" },
-    { flag: "--ids", list: true },
-    { flag: "--assignee", list: true },
-    { flag: "--assignee-filter" },
-    { flag: "--assignee_filter" },
-    { flag: "--parent" },
-    { flag: "--sprint", list: true },
-    { flag: "--release", list: true },
-    { 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: "--after" },
-    { flag: "--no-truncate" },
-    { 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: "--strict-read" },
-    { flag: "--format" },
-    { flag: "--stream" },
-], new Set([
-    "--limit",
-    "--token-budget",
-    "--offset",
-    "--after",
-    "--no-truncate",
-    "--compact",
-    "--brief",
-    "--full",
-    "--fields",
-    "--include-body",
-    "--strict-read",
-]));
-/** Public contract for aggregate flag contracts, shared by SDK and presentation-layer consumers. */
-export const AGGREGATE_FLAG_CONTRACTS = [
-    { flag: "--group-by", list: true },
-    { flag: "--count" },
-    { flag: "--completion" },
-    { flag: "--sum" },
-    { flag: "--avg" },
-    { flag: "--include-unparented" },
-    { flag: "--include_unparented" },
-    { flag: "--status", list: true },
-    { flag: "--type", list: true },
-    { flag: "--tag", list: true },
-    { flag: "--priority", list: true },
-    { flag: "--deadline-before" },
-    { flag: "--deadline-after" },
-    { flag: "--assignee", list: true },
-    { flag: "--assignee-filter" },
-    { flag: "--assignee_filter" },
-    { flag: "--parent" },
-    { flag: "--sprint", list: true },
-    { flag: "--release", list: true },
-];
-/** Public contract for comments flag contracts, shared by SDK and presentation-layer consumers. */
-export const COMMENTS_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--add", aliases: ["--comment", "--body", "--text"] },
-    { flag: "--stdin" },
-    { flag: "--file" },
-    { flag: "--edit" },
-    { flag: "--delete" },
-    { flag: "--limit" },
-    { flag: "--full-history" },
-    { flag: "--if-absent", value_type: "boolean" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-function withCursorSemantics(contracts, presentationFlags) {
-    return contracts.map((contract) => presentationFlags.has(contract.flag)
-        ? { ...contract, cursor_semantics: "presentation" }
-        : contract);
-}
-/** Public contract for notes flag contracts, shared by SDK and presentation-layer consumers. */
-export const NOTES_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--add", aliases: ["--note", "--text"] },
-    { flag: "--add-json" },
-    { flag: "--stdin" },
-    { flag: "--file" },
-    { flag: "--edit" },
-    { flag: "--delete" },
-    { flag: "--limit" },
-    { flag: "--since" },
-    { flag: "--event-type" },
-    { flag: "--include-meta" },
-    { flag: "--full-history" },
-    { flag: "--if-absent", value_type: "boolean" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for learnings flag contracts, shared by SDK and presentation-layer consumers. */
-export const LEARNINGS_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--add", aliases: ["--learning", "--text"] },
-    { flag: "--stdin" },
-    { flag: "--file" },
-    { flag: "--edit" },
-    { flag: "--delete" },
-    { flag: "--limit" },
-    { flag: "--full-history" },
-    { flag: "--if-absent", value_type: "boolean" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for files flag contracts, shared by SDK and presentation-layer consumers. */
-export const FILES_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { 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: "--scope" },
-    { flag: "--limit" },
-    { flag: "--offset" },
-    { flag: "--no-truncate" },
-    { flag: "--strict-read" },
-    { flag: "--explain" },
-    { flag: "--lines", value_name: "start:end" },
-    { flag: "--decision-depth", value_name: "n", value_type: "number" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for docs flag contracts, shared by SDK and presentation-layer consumers. */
-export const DOCS_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { 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: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for history flag contracts, shared by SDK and presentation-layer consumers. */
-export const HISTORY_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--limit" },
-    { flag: "--compact" },
-    { flag: "--full" },
-    { flag: "--provenance" },
-    { flag: "--provenance-summary" },
-    { flag: "--harness", repeatable: true },
-    { flag: "--agent-instance", repeatable: true },
-    { flag: "--provenance-filter", repeatable: true },
-    { flag: "--diff" },
-    { flag: "--field" },
-    { flag: "--verify" },
-    { flag: "--strict-exit" },
-    { flag: "--fail-on-warn" },
-    { flag: "--format" },
-];
-/** Public contract for merge flag contracts, shared by SDK and presentation-layer consumers. */
-export const MERGE_FLAG_CONTRACTS = [
-    { flag: "--dry-run" },
-    { flag: "--message" },
-    { flag: "--force" },
-    { flag: "--include-reconciled" },
-    { flag: "--output" },
-    { flag: "--item-path" },
-    { flag: "--prefer" },
-];
-/** Public contract for history redact flag contracts, shared by SDK and presentation-layer consumers. */
-export const HISTORY_REDACT_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--literal" },
-    { flag: "--regex" },
-    { flag: "--replacement" },
-    { flag: "--dry-run" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for history repair flag contracts, shared by SDK and presentation-layer consumers. */
-export const HISTORY_REPAIR_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--all" },
-    { flag: "--dry-run" },
-    { flag: "--normalize-provenance" },
-    { flag: "--salvage-tail", value_type: "boolean" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for append-only unknown-author acknowledgment flags. */
-export const HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS = [
-    { flag: "--event", repeatable: true },
-    { flag: "--all-actionable" },
-    { flag: "--dry-run" },
-    { flag: "--plan-fingerprint" },
-    { flag: "--limit", value_type: "number" },
-    { flag: "--attributed-author", aliases: ["--attributed_author"] },
-    { flag: "--reviewer" },
-    { flag: "--reason" },
-];
-/** Public contract for history compact flag contracts, shared by SDK and presentation-layer consumers. */
-export const HISTORY_COMPACT_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { 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" },
-];
-/** Public contract for schema flag contracts, shared by SDK and presentation-layer consumers. */
-export const 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", value_type: "boolean" },
-    // Lossless schema evolution flags.
-    { flag: "--to" },
-    { flag: "--migration-id", aliases: ["--migration_id"] },
-    { flag: "--dry-run" },
-    { flag: "--author" },
-    { flag: "--force" },
-];
-/** Flags accepted by the `pm profile` command (list/show/apply subcommands). */
-export const PROFILE_FLAG_CONTRACTS = [
-    { flag: "--dry-run" },
-    { flag: "--author" },
-    { flag: "--force" },
-];
-/** Public contract for plan flag contracts, shared by SDK and presentation-layer consumers. */
-export const 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: "--status", short: "-s" },
-    { flag: "--create-mode", aliases: ["--create_mode"] },
-    { flag: "--deadline" },
-    {
-        flag: "--estimate",
-        aliases: ["--estimated-minutes", "--estimated_minutes"],
-    },
-    {
-        flag: "--acceptance-criteria",
-        aliases: ["--acceptance_criteria", "--ac"],
-        repeatable: true,
-    },
-    { flag: "--definition-of-ready", aliases: ["--definition_of_ready"] },
-    { flag: "--order" },
-    { flag: "--rank" },
-    { flag: "--goal" },
-    { flag: "--objective" },
-    { flag: "--value" },
-    { flag: "--impact" },
-    { flag: "--outcome" },
-    { flag: "--why-now", aliases: ["--why_now"] },
-    { flag: "--assignee" },
-    { flag: "--reviewer" },
-    { flag: "--risk" },
-    { flag: "--confidence" },
-    { flag: "--sprint" },
-    { flag: "--release" },
-    { flag: "--blocked-reason", aliases: ["--blocked_reason"] },
-    { flag: "--unblock-note", aliases: ["--unblock_note"] },
-    { flag: "--reporter" },
-    { flag: "--severity" },
-    { flag: "--environment" },
-    { flag: "--repro-steps", aliases: ["--repro_steps"] },
-    { flag: "--resolution" },
-    {
-        flag: "--expected-result",
-        aliases: ["--expected_result", "--expected"],
-    },
-    {
-        flag: "--actual-result",
-        aliases: ["--actual_result", "--actual"],
-    },
-    { flag: "--affected-version", aliases: ["--affected_version"] },
-    { flag: "--fixed-version", aliases: ["--fixed_version"] },
-    { flag: "--component" },
-    { flag: "--regression" },
-    { flag: "--customer-impact", aliases: ["--customer_impact"] },
-    { flag: "--comment", repeatable: true },
-    { flag: "--note", repeatable: true },
-    { flag: "--learning", repeatable: true },
-    { flag: "--reminder", repeatable: true },
-    { flag: "--event", repeatable: true },
-    {
-        flag: "--type-option",
-        aliases: ["--type_option"],
-        repeatable: true,
-    },
-    { 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: "--field" },
-    { 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" },
-];
-/** Public contract for init flag contracts, shared by SDK and presentation-layer consumers. */
-export const INIT_FLAG_CONTRACTS = [
-    { flag: "--id-prefix", aliases: ["--prefix"] },
-    { flag: "--preset" },
-    { flag: "--type-preset" },
-    { flag: "--defaults", short: "-y", aliases: ["--yes"] },
-    { flag: "--author" },
-    { flag: "--agent-guidance" },
-    { flag: "--with-packages" },
-    { flag: "--no-merge-fence" },
-    { flag: "--workspace" },
-    { flag: "--force" },
-    { flag: "--verbose" },
-];
-/** Public contract for config flag contracts, shared by SDK and presentation-layer consumers. */
-export const CONFIG_FLAG_CONTRACTS = [
-    { flag: "--value", value_name: "value" },
-    { 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" },
-];
-/** Public contract for extension flag contracts, shared by SDK and presentation-layer consumers. */
-export const 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: "--isolated" },
-    { flag: "--ignore-global" },
-    { flag: "--strict-exit" },
-    { flag: "--fail-on-warn" },
-];
-/** Public contract for extension scope flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_SCOPE_FLAG_CONTRACTS = [
-    { flag: "--project" },
-    { flag: "--local" },
-    { flag: "--global" },
-];
-/** Public contract for extension init flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_INIT_FLAG_CONTRACTS = [
-    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-    { flag: "--capability" },
-];
-// `pm package` / `pm packages` additionally accept `--declarative` to scaffold the
-// `composeExtension` blueprint starter. It is a runtime SDK *value* import that only
-// package-mode authoring links, so `pm extension` omits it — the lone flag where the
-// package surface diverges from the extension surface.
-/** Public contract for package flag contracts, shared by SDK and presentation-layer consumers. */
-export const PACKAGE_FLAG_CONTRACTS = [
-    ...EXTENSION_FLAG_CONTRACTS,
-    { flag: "--declarative" },
-];
-/** Public contract for package init flag contracts, shared by SDK and presentation-layer consumers. */
-export const PACKAGE_INIT_FLAG_CONTRACTS = [
-    ...EXTENSION_INIT_FLAG_CONTRACTS,
-    { flag: "--declarative" },
-];
-/** Public contract for extension install flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_INSTALL_FLAG_CONTRACTS = [
-    { flag: "--project" },
-    { flag: "--local" },
-    { flag: "--global" },
-    { flag: "--gh" },
-    { flag: "--github" },
-    { flag: "--ref" },
-];
-/** Public contract for extension uninstall flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_UNINSTALL_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
-/** Public contract for extension explore flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_EXPLORE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
-/** Public contract for extension describe flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_DESCRIBE_FLAG_CONTRACTS = [
-    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-    { flag: "--markdown" },
-    { flag: "--output" },
-];
-/** Public contract for extension adopt all flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_ADOPT_ALL_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
-/** Public contract for extension activate flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_ACTIVATE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
-/** Public contract for extension deactivate flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_DEACTIVATE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
-/** Public contract for extension migration flag contracts. */
-export const EXTENSION_MIGRATE_FLAG_CONTRACTS = [
-    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-    { flag: "--dry-run" },
-];
-/** Public contract for extension manage flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_MANAGE_FLAG_CONTRACTS = [
-    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-    { flag: "--runtime-probe" },
-    { flag: "--fix-managed-state" },
-];
-/** Public contract for extension reload flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_RELOAD_FLAG_CONTRACTS = [
-    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-    { flag: "--watch" },
-];
-/** Public contract for extension doctor flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_DOCTOR_FLAG_CONTRACTS = [
-    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-    { flag: "--detail" },
-    { flag: "--trace" },
-    { flag: "--fix-managed-state" },
-    { flag: "--isolated" },
-    { flag: "--ignore-global" },
-    { flag: "--strict-exit" },
-    { flag: "--fail-on-warn" },
-];
-/** Public contract for extension catalog flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_CATALOG_FLAG_CONTRACTS = [
-    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-    { flag: "--fields", list: true },
-];
-/** Public contract for extension adopt flag contracts, shared by SDK and presentation-layer consumers. */
-export const EXTENSION_ADOPT_FLAG_CONTRACTS = [
-    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
-    { flag: "--gh" },
-    { flag: "--github" },
-    { flag: "--ref" },
-];
-/** Public contract for install flag contracts, shared by SDK and presentation-layer consumers. */
-export const INSTALL_FLAG_CONTRACTS = [
-    { flag: "--project" },
-    { flag: "--local" },
-    { flag: "--global" },
-    { flag: "--gh" },
-    { flag: "--github" },
-    { flag: "--ref" },
-];
-/** Public contract for upgrade flag contracts, shared by SDK and presentation-layer consumers. */
-export const UPGRADE_FLAG_CONTRACTS = [
-    { flag: "--dry-run" },
-    { flag: "--cli-only" },
-    { flag: "--packages-only" },
-    { flag: "--project" },
-    { flag: "--local" },
-    { flag: "--global" },
-    { flag: "--repair" },
-    { flag: "--tag" },
-    { flag: "--package-name" },
-];
-/** Public contract for reindex flag contracts, shared by SDK and presentation-layer consumers. */
-export const REINDEX_FLAG_CONTRACTS = [
-    { flag: "--mode" },
-    { flag: "--progress" },
-];
-/** Public contract for close flag contracts, shared by SDK and presentation-layer consumers. */
-export const CLOSE_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--reason", value_name: "value" },
-    { flag: "--close-reason", value_name: "value" },
-    { flag: "--completed-at", value_name: "value" },
-    { flag: "--duplicate-of", value_name: "value" },
-    { flag: "--author", value_name: "value" },
-    { flag: "--message", value_name: "value" },
-    {
-        flag: "--validate-close",
-        value_name: "off|warn|strict",
-    },
-    // 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", value_name: "value" },
-    {
-        flag: "--expected-result",
-        aliases: ["--expected_result", "--expected"],
-        value_name: "value",
-    },
-    {
-        flag: "--actual-result",
-        aliases: ["--actual_result", "--actual"],
-        value_name: "value",
-    },
-    { flag: "--force", value_type: "boolean" },
-];
-// close-many shares update-many's `--filter-*` scoping family and close's
-// inline closure-validation fields. The shared close reason is required for the
-// audited bulk close (each matched item routes through runClose semantics).
-/** Public contract for close many flag contracts, shared by SDK and presentation-layer consumers. */
-export const 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: "--completed-at" },
-    { 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" },
-];
-/** Public contract for append flag contracts, shared by SDK and presentation-layer consumers. */
-export const APPEND_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--body", short: "-b" },
-    { flag: "--text" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for claim flag contracts, shared by SDK and presentation-layer consumers. */
-export const CLAIM_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--author", aliases: ["--assignee"] },
-    { flag: "--message" },
-    { flag: "--force" },
-    { flag: "--if-available" },
-    { flag: "--next" },
-    { flag: "--type" },
-    { flag: "--tag" },
-    { flag: "--priority" },
-    { flag: "--assignee-filter" },
-    { flag: "--parent" },
-    { flag: "--sprint" },
-    { flag: "--release" },
-    { flag: "--max-attempts" },
-    { flag: "--include-decisions" },
-    { flag: "--include-gates" },
-    { flag: "--include-containers" },
-    { flag: "--token-budget", aliases: ["--token_budget"] },
-    { flag: "--explain-ranking", aliases: ["--explain_ranking"] },
-];
-/** Public contract for restore flag contracts, shared by SDK and presentation-layer consumers. */
-export const RESTORE_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for delete flag contracts, shared by SDK and presentation-layer consumers. */
-export const DELETE_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--dry-run" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for release flag contracts, shared by SDK and presentation-layer consumers. */
-export const RELEASE_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--author", aliases: ["--assignee"] },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for start task flag contracts, shared by SDK and presentation-layer consumers. */
-export const START_TASK_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--author", aliases: ["--assignee"] },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for pause task flag contracts, shared by SDK and presentation-layer consumers. */
-export const PAUSE_TASK_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--author", aliases: ["--assignee"] },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for close task flag contracts, shared by SDK and presentation-layer consumers. */
-export const CLOSE_TASK_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--author", aliases: ["--assignee"] },
-    { flag: "--message" },
-    { flag: "--validate-close", value_name: "off|warn|strict" },
-    { flag: "--force" },
-];
-/** Shared create-passthrough flags for every scheduling shortcut (GH-217). */
-const SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS = [
-    { flag: "--parent" },
-    { flag: "--allow-missing-parent" },
-    { flag: "--tags" },
-    { flag: "--priority" },
-    { flag: "--body" },
-    { flag: "--description" },
-    { flag: "--author" },
-    { flag: "--message" },
-];
-/** Public contract for meet flag contracts, shared by SDK and presentation-layer consumers. */
-export const MEET_FLAG_CONTRACTS = [
-    { flag: "--start" },
-    { flag: "--duration" },
-    { flag: "--end" },
-    { flag: "--location" },
-    { flag: "--timezone" },
-    { flag: "--all-day" },
-    ...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS,
-];
-/** Public contract for event flag contracts, shared by SDK and presentation-layer consumers. */
-export const EVENT_FLAG_CONTRACTS = MEET_FLAG_CONTRACTS;
-/** Public contract for remind flag contracts, shared by SDK and presentation-layer consumers. */
-export const REMIND_FLAG_CONTRACTS = [
-    { flag: "--at" },
-    { flag: "--text" },
-    ...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS,
-];
-/** Public contract for test flag contracts, shared by SDK and presentation-layer consumers. */
-export const TEST_FLAG_CONTRACTS = [
-    { flag: "--list" },
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--add" },
-    { flag: "--add-json" },
-    { flag: "--remove" },
-    { flag: "--remove-index", repeatable: true },
-    { 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: "--workspace-context" },
-    { flag: "--override-linked-workspace-context" },
-    { flag: "--allow-untrusted-linked-tests" },
-    { flag: "--acknowledge-linked-tests" },
-    { 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: "--measure", list: true },
-    { flag: "--metric-below" },
-    { flag: "--metric-diff" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for test all flag contracts, shared by SDK and presentation-layer consumers. */
-export const 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: "--workspace-context" },
-    { flag: "--override-linked-workspace-context" },
-    { flag: "--allow-untrusted-linked-tests" },
-    { 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" },
-];
-/** Public contract for telemetry flag contracts, shared by SDK and presentation-layer consumers. */
-export const TELEMETRY_FLAG_CONTRACTS = [
-    { flag: "--limit" },
-];
-/** Public contract for test runs flag contracts, shared by SDK and presentation-layer consumers. */
-export const TEST_RUNS_FLAG_CONTRACTS = [
-    { flag: "--status" },
-    { flag: "--limit" },
-    { flag: "--stream" },
-    { flag: "--tail" },
-    { flag: "--force" },
-    { flag: "--author" },
-];
-/** Public contract for gc flag contracts, shared by SDK and presentation-layer consumers. */
-export const GC_FLAG_CONTRACTS = [
-    { flag: "--dry-run" },
-    { flag: "--scope" },
-];
-/** Public contract for stats flag contracts, shared by SDK and presentation-layer consumers. */
-export const STATS_FLAG_CONTRACTS = [
-    { flag: "--include-empty" },
-    { flag: "--storage" },
-    { flag: "--metadata-coverage" },
-    { flag: "--field-utilization" },
-    { flag: "--by-assignee" },
-    { flag: "--by-tag" },
-    { flag: "--by-priority" },
-    { flag: "--tag-prefix" },
-    { flag: "--analytics" },
-];
-/** Public contract for duplicate-cluster discovery flags. */
-export const DUPLICATES_FLAG_CONTRACTS = [
-    { flag: "--exhaustive", value_type: "boolean" },
-    { flag: "--status", repeatable: true, list: true },
-    { flag: "--since" },
-    { flag: "--threshold" },
-    { flag: "--limit" },
-];
-/** Public contract for health flag contracts, shared by SDK and presentation-layer consumers. */
-export const HEALTH_FLAG_CONTRACTS = [
-    { flag: "--strict-directories" },
-    { flag: "--require-merge-drivers" },
-    { flag: "--strict-exit" },
-    { flag: "--fail-on-warn" },
-    { flag: "--check-only" },
-    { flag: "--check-telemetry" },
-    { flag: "--no-refresh" },
-    { flag: "--refresh-vectors" },
-    { flag: "--verbose-stale-items" },
-    { flag: "--verbose-author-events" },
-    { flag: "--brief" },
-    { flag: "--summary" },
-    { flag: "--skip-vectors" },
-    { flag: "--skip-integrity" },
-    { flag: "--skip-drift" },
-    { flag: "--full" },
-];
-/** Public contract for validate flag contracts, shared by SDK and presentation-layer consumers. */
-export const 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" },
-    { flag: "--check-storage-integrity" },
-    { flag: "--counts" },
-    { flag: "--full" },
-];
-/** Public assurance registry and gate-evaluation flag contracts. */
-export const ASSURANCE_FLAG_CONTRACTS = [
-    { flag: "--definition", value_name: "json" },
-    { flag: "--trigger", value_name: "value" },
-    { flag: "--tree", value_name: "value" },
-    { flag: "--gate", value_name: "id" },
-    { flag: "--limit", value_name: "number" },
-    { flag: "--dry-run" },
-    { flag: "--author", value_name: "value" },
-    { flag: "--message", value_name: "value" },
-    { flag: "--owner", value_name: "item-id" },
-    { flag: "--apply", value_type: "boolean" },
-    { flag: "--enforcement", value_name: "level" },
-];
-const ITEM_OWNERSHIP_AND_ISSUE_FLAG_CONTRACTS = [
-    { flag: "--assignee" },
-    { flag: "--parent" },
-    { flag: "--allow-missing-parent" },
-    { flag: "--allow-unresolved-deps" },
-    { 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" },
-];
-const ITEM_PORTFOLIO_FLAG_CONTRACTS = [
-    { 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" },
-];
-const ITEM_CONTENT_METADATA_FLAG_CONTRACTS = [
-    { short: "-p", flag: "--priority" },
-    { flag: "--type" },
-    { flag: "--tags", aliases: ["--tag"], list: true },
-    { 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: "--add-ac", aliases: ["--add_ac"] },
-    { flag: "--remove-ac", aliases: ["--remove_ac"] },
-];
-/** Creates flag contracts using the validated operation inputs. */
-export const CREATE_FLAG_CONTRACTS = [
-    { flag: "--stdin-json" },
-    { 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" },
-    { flag: "--close-reason" },
-    { flag: "--close_reason" },
-    { flag: "--completed-at" },
-    { flag: "--completed_at" },
-    { 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" },
-    ...ITEM_OWNERSHIP_AND_ISSUE_FLAG_CONTRACTS,
-    ...ITEM_PORTFOLIO_FLAG_CONTRACTS,
-    { 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", aliases: ["--linked-file"] },
-    { flag: "--test", aliases: ["--linked-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" },
-    { flag: "--allow-duplicate", value_type: "boolean" },
-];
-/** Atomic item-batch flags shared by contracts, help, and completions. */
-export const ITEM_MUTATE_FLAG_CONTRACTS = [
-    { flag: "--transaction-id", value_name: "value" },
-    { flag: "--stdin-json" },
-    { flag: "--dry-run" },
-    { flag: "--create-compensation", value_name: "mode" },
-    { flag: "--lock-ttl-seconds", value_name: "n" },
-    { flag: "--lock-wait-ms", value_name: "n" },
-    { flag: "--author", value_name: "value" },
-];
-/** Atomic item-completion flags shared by contracts, help, and completions. */
-export const ITEM_COMPLETE_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--transaction-id", value_name: "value", required: true },
-    { flag: "--reason", value_name: "value" },
-    { flag: "--file", value_name: "value", repeatable: true },
-    { flag: "--doc", value_name: "value", repeatable: true },
-    { flag: "--test", value_name: "value", repeatable: true },
-    { flag: "--comment", value_name: "value", repeatable: true },
-    { flag: "--note", value_name: "value", repeatable: true },
-    { flag: "--learning", value_name: "value", repeatable: true },
-    { flag: "--resolution", value_name: "value" },
-    { flag: "--expected-result", value_name: "value" },
-    { flag: "--actual-result", value_name: "value" },
-    { flag: "--completed-at", value_name: "value" },
-    { flag: "--validate-close", value_name: "off|warn|strict" },
-    { flag: "--lock-ttl-seconds", value_name: "n" },
-    { flag: "--lock-wait-ms", value_name: "n" },
-    { flag: "--dry-run" },
-    { flag: "--force" },
-    { flag: "--author", value_name: "value" },
-];
-/** Recurrence transition flags shared by CLI, SDK, MCP, help, and completion. */
-export const ITEM_REOPEN_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--status", value_name: "open|in_progress" },
-    { flag: "--message", value_name: "value" },
-    { flag: "--force" },
-    { flag: "--author", value_name: "value" },
-];
-/** Public contract for copy flag contracts, shared by SDK and presentation-layer consumers. */
-export const COPY_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--title", value_name: "value" },
-    { flag: "--author", value_name: "value" },
-    { flag: "--message", value_name: "value" },
-    { flag: "--allow-duplicate", value_type: "boolean" },
-];
-/** Public contract for focus flag contracts, shared by SDK and presentation-layer consumers. */
-export const FOCUS_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--clear" },
-];
-/** Public contract for update flag contracts, shared by SDK and presentation-layer consumers. */
-export const UPDATE_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--stdin-json" },
-    { 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" },
-    { flag: "--completed-at" },
-    // 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`).
-    ...ITEM_CONTENT_METADATA_FLAG_CONTRACTS,
-    ...ITEM_OWNERSHIP_AND_ISSUE_FLAG_CONTRACTS,
-    { flag: "--fixed_version" },
-    ...ITEM_PORTFOLIO_FLAG_CONTRACTS,
-    { 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: "--replace-files" },
-    { flag: "--replace-docs" },
-    { flag: "--comment" },
-    { flag: "--note" },
-    { flag: "--learning" },
-    { flag: "--file", aliases: ["--linked-file"] },
-    { flag: "--test", aliases: ["--linked-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: "--force" },
-];
-/** Public contract for update many flag contracts, shared by SDK and presentation-layer consumers. */
-export const UPDATE_MANY_FLAG_CONTRACTS = [
-    { flag: "--status", short: "-s" },
-    { flag: "--assignee" },
-    { flag: "--parent" },
-    { flag: "--blocked-by", aliases: ["--blocked_by"] },
-    { flag: "--blocked-reason", aliases: ["--blocked_reason"] },
-    { flag: "--unblock-note", aliases: ["--unblock_note"] },
-    { flag: "--filter-status", list: true },
-    { flag: "--filter-type", list: true },
-    { flag: "--filter-tag", list: true },
-    { flag: "--filter-priority", list: true },
-    { 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", list: true },
-    { flag: "--filter-assignee-filter" },
-    { flag: "--filter-assignee_filter" },
-    { flag: "--filter-parent" },
-    { flag: "--filter-sprint", list: true },
-    { flag: "--filter-release", list: true },
-    { 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" },
-    // 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`).
-    ...ITEM_CONTENT_METADATA_FLAG_CONTRACTS,
-    { 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: "--allow-unresolved-deps" },
-    { flag: "--dep" },
-    { flag: "--dep-remove" },
-    { flag: "--dep_remove" },
-    { flag: "--replace-deps" },
-    { flag: "--replace-tests" },
-    { flag: "--replace-files" },
-    { flag: "--replace-docs" },
-    { 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: "--author" },
-    { flag: "--message" },
-    { flag: "--force" },
-];
-/** Public contract for calendar flag contracts, shared by SDK and presentation-layer consumers. */
-export const 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" },
-];
-/** Public contract for activity flag contracts, shared by SDK and presentation-layer consumers. */
-export const ACTIVITY_FLAG_CONTRACTS = [
-    { flag: "--id" },
-    { flag: "--op" },
-    { flag: "--author" },
-    { flag: "--from" },
-    { flag: "--to" },
-    { flag: "--limit" },
-    { flag: "--unbounded" },
-    { flag: "--compact" },
-    { flag: "--raw" },
-    { flag: "--full" },
-    { flag: "--provenance" },
-    { flag: "--provenance-summary" },
-    { flag: "--harness", repeatable: true },
-    { flag: "--agent-instance", repeatable: true },
-    { flag: "--provenance-filter", repeatable: true },
-    { flag: "--stream" },
-];
-/** Public contract for mutation event stream flags shared by SDK and CLI consumers. */
-export const EVENTS_FLAG_CONTRACTS = [
-    { flag: "--since" },
-    { flag: "--type", repeatable: true },
-    { flag: "--author", repeatable: true },
-    { flag: "--item", repeatable: true },
-    { flag: "--limit", value_type: "number" },
-    { flag: "--cursor-mode", value_name: "batch|row" },
-    { flag: "--full" },
-    { flag: "--provenance" },
-    { flag: "--provenance-summary" },
-    { flag: "--harness", repeatable: true },
-    { flag: "--agent-instance", repeatable: true },
-    { flag: "--provenance-filter", repeatable: true },
-    { flag: "--follow" },
-    { flag: "--interval-ms", value_type: "number" },
-];
-/** Public contract for context flag contracts, shared by SDK and presentation-layer consumers. */
-export const CONTEXT_FLAG_CONTRACTS = withCursorSemantics([
-    { flag: "--for", value_name: "intent" },
-    { 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", aliases: ["--max-items"] },
-    { flag: "--after" },
-    { flag: "--format" },
-    { flag: "--depth" },
-    { flag: "--fields", list: true },
-    { flag: "--section" },
-    { flag: "--activity-limit" },
-    { flag: "--stale-threshold" },
-    { flag: "--explain-ranking" },
-    { flag: "--explain_ranking" },
-    { flag: "--token-budget", aliases: ["--token_budget"] },
-    { flag: "--no-extension-health" },
-    { flag: "--no-tags" },
-], new Set([
-    "--limit",
-    "--after",
-    "--format",
-    "--fields",
-    "--section",
-    "--activity-limit",
-    "--stale-threshold",
-    "--explain-ranking",
-    "--explain_ranking",
-    "--no-extension-health",
-    "--no-tags",
-]));
-/** Public contract for get flag contracts, shared by SDK and presentation-layer consumers. */
-export const GET_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--for", value_name: "intent" },
-    { flag: "--token-budget", aliases: ["--token_budget"] },
-    { flag: "--depth" },
-    { flag: "--full", value_type: "boolean" },
-    { flag: "--fields", list: true },
-    { flag: "--at" },
-    { flag: "--tree" },
-    { flag: "--tree-depth" },
-    { flag: "--tree_depth" },
-    { flag: "--format" },
-];
-/** Public contract for guide flag contracts, shared by SDK and presentation-layer consumers. */
-export const GUIDE_FLAG_CONTRACTS = [
-    { flag: "--list" },
-    { flag: "--format" },
-    { flag: "--depth" },
-];
-/** Public contract for deps flag contracts, shared by SDK and presentation-layer consumers. */
-export const DEPS_FLAG_CONTRACTS = [
-    { flag: "--id", value_name: "item-id" },
-    { flag: "--format" },
-    { flag: "--max-depth" },
-    { flag: "--collapse" },
-    { flag: "--summary" },
-    { flag: "--full" },
-    { flag: "--node-limit" },
-    { flag: "--edge-limit" },
-    { flag: "--token-budget" },
-    { flag: "--cursor" },
-    { flag: "--direction" },
-    { flag: "--kind", list: true },
-];
-/** Public contract for graph flag contracts, shared by SDK and presentation-layer consumers. */
-export const GRAPH_FLAG_CONTRACTS = [
-    { flag: "--kind", list: true },
-    { flag: "--max-depth" },
-    { flag: "--limit" },
-    { flag: "--after" },
-    { flag: "--direction" },
-    { flag: "--max-paths" },
-    { flag: "--sample" },
-    { flag: "--exempt-isolate", list: true },
-    { flag: "--exempt-isolate-type", list: true },
-    { flag: "--save-baseline" },
-    { flag: "--rebuild" },
-    { flag: "--clear" },
-    { flag: "--summary" },
-    { flag: "--full" },
-];
-/** Public contract for eval flag contracts, shared by SDK and presentation-layer consumers. */
-export const EVAL_FLAG_CONTRACTS = [
-    { flag: "--mode" },
-    { flag: "--k" },
-    { flag: "--fail-under" },
-    { flag: "--queries" },
-    { flag: "--format" },
-];
-/** Public contract for guarded portable workspace snapshot command paths. */
-export const WORKSPACE_FLAG_CONTRACTS = [
-    { flag: "--dry-run" },
-    { flag: "--force" },
-    { flag: "--author" },
-    { flag: "--message" },
-];
-/** Flagless bounded workspace position read. */
-export const WORKSPACE_POSITION_FLAG_CONTRACTS = [];
-/** Public contract for next flag contracts, shared by SDK and presentation-layer consumers. */
-export const NEXT_FLAG_CONTRACTS = [
-    { flag: "--include-decisions" },
-    { flag: "--include-gates" },
-    { flag: "--include-containers" },
-    { flag: "--for", value_name: "intent" },
-    { 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" },
-    { flag: "--explain-ranking" },
-    { flag: "--explain_ranking" },
-    { flag: "--token-budget", aliases: ["--token_budget"] },
-];
-/** Public contract for search flag contracts, shared by SDK and presentation-layer consumers. */
-export const SEARCH_FLAG_CONTRACTS = withCursorSemantics([
-    { flag: "--for", value_name: "intent" },
-    { flag: "--token-budget", aliases: ["--token_budget"] },
-    { 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: "--after" },
-    { flag: "--status", list: true },
-    { flag: "--type", list: true },
-    { flag: "--tag", aliases: ["--tags"], list: true },
-    { flag: "--priority", list: true },
-    { flag: "--deadline-before" },
-    { flag: "--deadline-after" },
-    { flag: "--updated-after" },
-    { flag: "--updated-before" },
-    { flag: "--created-after" },
-    { flag: "--created-before" },
-    { flag: "--assignee", list: true },
-    { flag: "--sprint", list: true },
-    { flag: "--release", list: true },
-    { flag: "--parent" },
-    ...GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS,
-], new Set([
-    "--highlight",
-    "--compact",
-    "--full",
-    "--fields",
-    "--format",
-    "--limit",
-    "--token-budget",
-    "--after",
-]));
-/** Public contract for contracts flag contracts, shared by SDK and presentation-layer consumers. */
-export const CONTRACTS_FLAG_CONTRACTS = [
-    { flag: "--action" },
-    { flag: "--command" },
-    { flag: "--summary" },
-    { flag: "--schema-only" },
-    { flag: "--flags-only" },
-    { flag: "--availability-only" },
-    { flag: "--runtime-only" },
-    { flag: "--active-only" },
-    { flag: "--full" },
-];
-/** Public contract for completion flag contracts, shared by SDK and presentation-layer consumers. */
-export const COMPLETION_FLAG_CONTRACTS = [
-    { flag: "--eager-tags" },
-];
-/** Deduplicates flag contracts by their `flag`/`short`/`aliases` identity, preserving first-seen order. Used when merging the shared subcommand-global flags into a command's own contracts so a flag declared by both surfaces is registered only once. */
-export function toUniqueFlagContracts(contracts) {
-    const seen = 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) {
-    const byCanonicalFlag = new Map();
-    for (const contract of [...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, ...contracts]) {
-        const canonicalFlag = normalizeFlagAliasKey(contract.flag);
-        const prior = byCanonicalFlag.get(canonicalFlag);
-        const { aliases: declaredAliases, ...contractWithoutAliases } = contract;
-        const aliases = normalizeUniqueStringList([
-            ...(declaredAliases ?? []),
-            ...(contract.flag === canonicalFlag ? [] : [contract.flag]),
-        ]).filter((alias) => alias !== canonicalFlag);
-        const normalizedContract = {
-            ...contractWithoutAliases,
-            flag: canonicalFlag,
-            ...(aliases.length > 0 ? { aliases } : {}),
-        };
-        const mergedAliases = normalizeUniqueStringList([
-            ...(prior?.aliases ?? []),
-            ...(normalizedContract.aliases ?? []),
-        ]);
-        byCanonicalFlag.set(canonicalFlag, prior === undefined
-            ? normalizedContract
-            : {
-                ...prior,
-                ...normalizedContract,
-                ...(mergedAliases.length > 0 ? { aliases: mergedAliases } : {}),
-            });
-    }
-    return withFlagAliasMetadata([...byCanonicalFlag.values()]);
-}
-const FIXED_STATUS_LIST_COMMAND_ALIASES = [
-    "list-draft",
-    "list-open",
-    "list-in-progress",
-    "list-blocked",
-    "list-closed",
-    "list-canceled",
-];
-const FIXED_STATUS_LIST_FLAG_CONTRACTS = LIST_FILTER_FLAG_CONTRACTS.filter((contract) => contract.flag !== "--status" && contract.flag !== "--all");
-function indexCliFlagContracts(contracts) {
-    const index = new Map();
-    for (const contract of contracts) {
-        for (const spelling of [contract.flag, ...(contract.aliases ?? [])]) {
-            const matches = index.get(spelling) ?? [];
-            matches.push(contract);
-            index.set(spelling, matches);
-        }
-    }
-    return index;
-}
-const PLAN_FLAG_CONTRACT_INDEX = indexCliFlagContracts(PLAN_FLAG_CONTRACTS);
-const ASSURANCE_FLAG_CONTRACT_INDEX = indexCliFlagContracts(ASSURANCE_FLAG_CONTRACTS);
-const POSITIONAL_ACTION_FLAG_INDEX_BY_PARENT = new Map([
-    ["assurance", ASSURANCE_FLAG_CONTRACT_INDEX],
-    ["plan", PLAN_FLAG_CONTRACT_INDEX],
-    ["workspace", indexCliFlagContracts(WORKSPACE_POSITION_FLAG_CONTRACTS)],
-    ["workspace snapshot", indexCliFlagContracts(WORKSPACE_FLAG_CONTRACTS)],
-]);
-/** Resolve every positional action's accepted flags against one parent contract. */
-export function resolvePmPositionalActionFlagContracts(actions = PM_POSITIONAL_ACTION_CONTRACTS) {
-    return actions.map(({ command, parent, accepted_flags: acceptedFlags }) => {
-        const parentFlagIndex = POSITIONAL_ACTION_FLAG_INDEX_BY_PARENT.get(parent);
-        if (!parentFlagIndex) {
-            throw new Error(`Positional action ${command} has no flag-contract index for ${parent}.`);
-        }
-        const selected = acceptedFlags.map((acceptedFlag) => {
-            const matches = parentFlagIndex.get(acceptedFlag) ?? [];
-            if (matches.length !== 1) {
-                throw new Error(`Positional action ${command} accepted flag ${acceptedFlag} does not resolve to exactly one ${parent} flag contract.`);
-            }
-            return matches[0];
-        });
-        return [command, selected];
-    });
-}
-/** Validated positional action flag entries shared by registration and contracts. */
-export const PM_POSITIONAL_ACTION_FLAG_CONTRACTS = resolvePmPositionalActionFlagContracts();
-// Single-token command (plus the `list`/`cal`/`ctx`/`templates` aliases) → its
-// dedicated flag-contract table. Lookups fall back to the subcommand-global set,
-// so tokens absent here (`reindex`, `help`, or any unknown command) degrade to
-// globals exactly as the prior `switch` `default` arm did. A `Map` (rather than a
-// plain object) keeps an untrusted command token from ever resolving an inherited
-// member such as `constructor` or `toString`.
-const SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND = new Map([
-    ["list", LIST_FILTER_FLAG_CONTRACTS],
-    ["list-all", LIST_FILTER_FLAG_CONTRACTS],
-    ...FIXED_STATUS_LIST_COMMAND_ALIASES.map((command) => [
-        command,
-        FIXED_STATUS_LIST_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],
-    ["item", []],
-    ["item mutate", ITEM_MUTATE_FLAG_CONTRACTS],
-    ["item complete", ITEM_COMPLETE_FLAG_CONTRACTS],
-    ["item reopen", ITEM_REOPEN_FLAG_CONTRACTS],
-    ["copy", COPY_FLAG_CONTRACTS],
-    ["focus", FOCUS_FLAG_CONTRACTS],
-    ["aggregate", AGGREGATE_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],
-    ["workspace", WORKSPACE_FLAG_CONTRACTS],
-    ["workspace position", WORKSPACE_POSITION_FLAG_CONTRACTS],
-    ["workspace snapshot", WORKSPACE_FLAG_CONTRACTS],
-    ["workspace snapshot create", WORKSPACE_FLAG_CONTRACTS],
-    ["workspace snapshot list", WORKSPACE_FLAG_CONTRACTS],
-    ["workspace snapshot inspect", WORKSPACE_FLAG_CONTRACTS],
-    ["workspace snapshot restore", WORKSPACE_FLAG_CONTRACTS],
-    ["workspace snapshot delete", WORKSPACE_FLAG_CONTRACTS],
-    ["history", HISTORY_FLAG_CONTRACTS],
-    ["history-redact", HISTORY_REDACT_FLAG_CONTRACTS],
-    ["history-repair", HISTORY_REPAIR_FLAG_CONTRACTS],
-    ["history-author-acknowledge", HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS],
-    ["history-compact", HISTORY_COMPACT_FLAG_CONTRACTS],
-    ["merge", MERGE_FLAG_CONTRACTS],
-    ["schema", SCHEMA_FLAG_CONTRACTS],
-    ["profile", PROFILE_FLAG_CONTRACTS],
-    ["plan", PLAN_FLAG_CONTRACTS],
-    ["activity", ACTIVITY_FLAG_CONTRACTS],
-    ["events", EVENTS_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],
-    ["notes", NOTES_FLAG_CONTRACTS],
-    ["learnings", LEARNINGS_FLAG_CONTRACTS],
-    ["files", FILES_FLAG_CONTRACTS],
-    ["docs", DOCS_FLAG_CONTRACTS],
-    ["deps", DEPS_FLAG_CONTRACTS],
-    ["graph", GRAPH_FLAG_CONTRACTS],
-    ["test", TEST_FLAG_CONTRACTS],
-    ["test-all", TEST_ALL_FLAG_CONTRACTS],
-    ["telemetry", TELEMETRY_FLAG_CONTRACTS],
-    ["health", HEALTH_FLAG_CONTRACTS],
-    ["assurance", ASSURANCE_FLAG_CONTRACTS],
-    ...PM_POSITIONAL_ACTION_FLAG_CONTRACTS,
-    ["validate", VALIDATE_FLAG_CONTRACTS],
-    ["gc", GC_FLAG_CONTRACTS],
-    ["stats", STATS_FLAG_CONTRACTS],
-    ["duplicates", DUPLICATES_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],
-]);
-// `extension`/`package`/`packages <subcommand>` lifecycle flag tables. `init` is
-// resolved separately because its `--declarative` flag is package-only; every
-// other lifecycle subcommand shares one table across the extension and package
-// command roots.
-const EXTENSION_LIFECYCLE_FLAG_CONTRACTS_BY_SUBCOMMAND = 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],
-    ["list", 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],
-    ["migrate", EXTENSION_MIGRATE_FLAG_CONTRACTS],
-]);
-function normalizeCommandNameForContracts(commandName) {
-    if (typeof commandName !== "string") {
-        return "";
-    }
-    return commandName.trim().toLowerCase();
-}
-/** Returns whether a normalized command path owns a concrete core flag-contract row. Surface-less commands such as `help` intentionally return false, while positional virtual paths such as `workspace snapshot create` return true. */
-export function hasSubcommandFlagContractsForCommand(commandName) {
-    const normalized = normalizeCommandNameForContracts(commandName);
-    if (SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND.has(normalized)) {
-        return true;
-    }
-    const [rootCommand, lifecycleSubcommand, ...extraParts] = normalized.split(/\s+/);
-    return ((rootCommand === "extension" ||
-        rootCommand === "package" ||
-        rootCommand === "packages") &&
-        lifecycleSubcommand !== undefined &&
-        extraParts.length === 0 &&
-        (lifecycleSubcommand === "init" ||
-            lifecycleSubcommand === "scaffold" ||
-            EXTENSION_LIFECYCLE_FLAG_CONTRACTS_BY_SUBCOMMAND.has(lifecycleSubcommand)));
-}
-/** Resolves the flag contracts an `extension`/`package <subcommand>` lifecycle invocation accepts. `init` carries the package-only `--declarative` flag, so `package`/`packages init` resolve to the package init table while `extension init` resolves to the extension init table; every other lifecycle subcommand shares one table, and an unknown subcommand falls back to globals-only. */
-function resolveExtensionLifecycleFlagContracts(rootCommand, lifecycleSubcommand) {
-    if (lifecycleSubcommand === "init" || lifecycleSubcommand === "scaffold") {
-        // `--declarative` is package-only, so `package init` / `packages init` carry it.
-        return rootCommand === "extension"
-            ? EXTENSION_INIT_FLAG_CONTRACTS
-            : PACKAGE_INIT_FLAG_CONTRACTS;
-    }
-    return (EXTENSION_LIFECYCLE_FLAG_CONTRACTS_BY_SUBCOMMAND.get(lifecycleSubcommand) ??
-        []);
-}
-/** Resolves the flag contracts a given command (or list/extension subcommand) accepts, merged with the shared subcommand-global flags. Returns the global set for unknown or surface-less commands so completion and validation degrade gracefully. */
-export 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 !== undefined &&
-        extraParts.length === 0) {
-        if ((rootCommand === "package" || rootCommand === "packages") &&
-            lifecycleSubcommand === "upgrade") {
-            return withSubcommandGlobalFlags(UPGRADE_FLAG_CONTRACTS);
-        }
-        return withSubcommandGlobalFlags(resolveExtensionLifecycleFlagContracts(rootCommand, lifecycleSubcommand));
-    }
-    const contracts = SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND.get(normalized) ?? [];
-    return withSubcommandGlobalFlags(contracts);
-}
-/** Renders a space-separated, de-duplicated list of every flag spelling (short, canonical, and aliases) for shell-completion candidate generation, optionally appending the shared subcommand-global flags. */
-export 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(" ");
-}
+!(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]="d2fd41e7-4043-5a3f-a2b2-cca9554eb8bd")}catch(e2){}})();import{resolvePmHistoryOperation}from"./command-aliases.js";import{normalizeUniqueStringList}from"./string-lists.js";import{RESERVED_EXTENSION_HOST_FLAGS}from"../../core/extensions/reserved-host-flags.js";import{PM_POSITIONAL_ACTION_CONTRACTS}from"./grammar-contracts.js";function normalizeFlagAliasKey(flag){if(!flag.startsWith("--")){return flag}return`--${flag.slice(2).replaceAll("_","-")}`}function withFlagAliasMetadata(flagContracts){const aliasesByCanonical=new Map;for(const contract of flagContracts){const canonical=normalizeFlagAliasKey(contract.flag);const bucket=aliasesByCanonical.get(canonical)??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)})}const SUBCOMMAND_GLOBAL_FLAG_CONTRACTS=RESERVED_EXTENSION_HOST_FLAGS.map(definition=>({flag:definition.flag,reservation_scope:"inherited",...definition.aliases?{aliases:[...definition.aliases]}:{},...definition.value_name?{value_name:definition.value_name}:{}}));const GLOBAL_FLAG_CONTRACTS=[...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,{flag:"--version",value_type:"boolean",reservation_scope:"root_only"},{flag:"--all",value_type:"boolean",reservation_scope:"root_only",description:"Expand root help to every command."},{flag:"--explain",value_type:"boolean",reservation_scope:"root_only",description:"Expand root help with command guidance."}];const 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"}];const 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"}];const LIST_FILTER_FLAG_CONTRACTS=withCursorSemantics([{flag:"--for",value_name:"intent"},{flag:"--token-budget",aliases:["--token_budget"]},{flag:"--status",list:true},{flag:"--all",value_type:"boolean"},{flag:"--type",list:true},{flag:"--tag",aliases:["--tags"],list:true},{flag:"--priority",list:true},{flag:"--deadline-before"},{flag:"--deadline-after"},{flag:"--today"},{flag:"--recent"},{flag:"--updated-after"},{flag:"--updated-before"},{flag:"--created-after"},{flag:"--created-before"},{flag:"--ids",list:true},{flag:"--assignee",list:true},{flag:"--assignee-filter"},{flag:"--assignee_filter"},{flag:"--parent"},{flag:"--sprint",list:true},{flag:"--release",list:true},{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:"--after"},{flag:"--no-truncate"},{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:"--strict-read"},{flag:"--format"},{flag:"--stream"}],new Set(["--limit","--token-budget","--offset","--after","--no-truncate","--compact","--brief","--full","--fields","--include-body","--strict-read"]));const AGGREGATE_FLAG_CONTRACTS=[{flag:"--group-by",list:true},{flag:"--set-mode"},{flag:"--limit"},{flag:"--after"},{flag:"--count"},{flag:"--completion"},{flag:"--sum"},{flag:"--avg"},{flag:"--include-unparented"},{flag:"--include_unparented"},{flag:"--status",list:true},{flag:"--type",list:true},{flag:"--tag",list:true},{flag:"--priority",list:true},{flag:"--deadline-before"},{flag:"--deadline-after"},{flag:"--assignee",list:true},{flag:"--assignee-filter"},{flag:"--assignee_filter"},{flag:"--parent"},{flag:"--sprint",list:true},{flag:"--release",list:true}];const COMMENTS_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--add",aliases:["--comment","--body","--text"]},{flag:"--stdin"},{flag:"--file"},{flag:"--edit"},{flag:"--delete"},{flag:"--limit"},{flag:"--full-history"},{flag:"--if-absent",value_type:"boolean"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];function withCursorSemantics(contracts,presentationFlags){return contracts.map(contract=>presentationFlags.has(contract.flag)?{...contract,cursor_semantics:"presentation"}:contract)}const NOTES_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--add",aliases:["--note","--text"]},{flag:"--add-json"},{flag:"--stdin"},{flag:"--file"},{flag:"--edit"},{flag:"--delete"},{flag:"--limit"},{flag:"--since"},{flag:"--event-type"},{flag:"--include-meta"},{flag:"--full-history"},{flag:"--if-absent",value_type:"boolean"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];const LEARNINGS_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--add",aliases:["--learning","--text"]},{flag:"--stdin"},{flag:"--file"},{flag:"--edit"},{flag:"--delete"},{flag:"--limit"},{flag:"--full-history"},{flag:"--if-absent",value_type:"boolean"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];const FILES_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--add"},{flag:"--add-glob"},{flag:"--remove"},{flag:"--migrate"},{flag:"--note"},{flag:"--list"},{flag:"--append-stable"},{flag:"--validate-paths"},{flag:"--scope"},{flag:"--limit"},{flag:"--offset"},{flag:"--no-truncate"},{flag:"--strict-read"},{flag:"--explain"},{flag:"--lines",value_name:"start:end"},{flag:"--decision-depth",value_name:"n",value_type:"number"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];const DOCS_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--add"},{flag:"--add-glob"},{flag:"--remove"},{flag:"--migrate"},{flag:"--note"},{flag:"--list"},{flag:"--validate-paths"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];const HISTORY_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--limit"},{flag:"--compact"},{flag:"--full"},{flag:"--provenance"},{flag:"--provenance-summary"},{flag:"--harness",repeatable:true},{flag:"--agent-instance",repeatable:true},{flag:"--provenance-filter",repeatable:true},{flag:"--diff"},{flag:"--field"},{flag:"--verify"},{flag:"--strict-exit"},{flag:"--fail-on-warn"},{flag:"--format"}];const MERGE_FLAG_CONTRACTS=[{flag:"--dry-run"},{flag:"--message"},{flag:"--force"},{flag:"--include-reconciled"},{flag:"--output"},{flag:"--item-path"},{flag:"--prefer"}];const HISTORY_REDACT_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--literal"},{flag:"--regex"},{flag:"--replacement"},{flag:"--dry-run"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];const HISTORY_REPAIR_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--all"},{flag:"--dry-run"},{flag:"--normalize-provenance"},{flag:"--salvage-tail",value_type:"boolean"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];const HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS=[{flag:"--event",repeatable:true},{flag:"--all-actionable"},{flag:"--dry-run"},{flag:"--plan-fingerprint"},{flag:"--limit",value_type:"number"},{flag:"--attributed-author",aliases:["--attributed_author"]},{flag:"--reviewer"},{flag:"--reason"}];const HISTORY_COMPACT_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{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"}];const SCHEMA_FLAG_CONTRACTS=[{flag:"--description"},{flag:"--default-status",aliases:["--default_status"]},{flag:"--folder"},{flag:"--alias"},{flag:"--role"},{flag:"--order"},{flag:"--type"},{flag:"--commands"},{flag:"--cli-flag"},{flag:"--required"},{flag:"--required-on-create"},{flag:"--no-allow-unset"},{flag:"--required-types"},{flag:"--infer"},{flag:"--min-count"},{flag:"--apply",value_type:"boolean"},{flag:"--to"},{flag:"--migration-id",aliases:["--migration_id"]},{flag:"--dry-run"},{flag:"--author"},{flag:"--force"}];const PROFILE_FLAG_CONTRACTS=[{flag:"--dry-run"},{flag:"--author"},{flag:"--force"}];const 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:"--status",short:"-s"},{flag:"--create-mode",aliases:["--create_mode"]},{flag:"--deadline"},{flag:"--estimate",aliases:["--estimated-minutes","--estimated_minutes"]},{flag:"--acceptance-criteria",aliases:["--acceptance_criteria","--ac"],repeatable:true},{flag:"--definition-of-ready",aliases:["--definition_of_ready"]},{flag:"--order"},{flag:"--rank"},{flag:"--goal"},{flag:"--objective"},{flag:"--value"},{flag:"--impact"},{flag:"--outcome"},{flag:"--why-now",aliases:["--why_now"]},{flag:"--assignee"},{flag:"--reviewer"},{flag:"--risk"},{flag:"--confidence"},{flag:"--sprint"},{flag:"--release"},{flag:"--blocked-reason",aliases:["--blocked_reason"]},{flag:"--unblock-note",aliases:["--unblock_note"]},{flag:"--reporter"},{flag:"--severity"},{flag:"--environment"},{flag:"--repro-steps",aliases:["--repro_steps"]},{flag:"--resolution"},{flag:"--expected-result",aliases:["--expected_result","--expected"]},{flag:"--actual-result",aliases:["--actual_result","--actual"]},{flag:"--affected-version",aliases:["--affected_version"]},{flag:"--fixed-version",aliases:["--fixed_version"]},{flag:"--component"},{flag:"--regression"},{flag:"--customer-impact",aliases:["--customer_impact"]},{flag:"--comment",repeatable:true},{flag:"--note",repeatable:true},{flag:"--learning",repeatable:true},{flag:"--reminder",repeatable:true},{flag:"--event",repeatable:true},{flag:"--type-option",aliases:["--type_option"],repeatable:true},{flag:"--body"},{flag:"--claim"},{flag:"--from-search",aliases:["--from_search"]},{flag:"--template"},{flag:"--step-title",aliases:["--step_title"]},{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:"--field"},{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"}];const INIT_FLAG_CONTRACTS=[{flag:"--id-prefix",aliases:["--prefix"]},{flag:"--preset"},{flag:"--type-preset"},{flag:"--defaults",short:"-y",aliases:["--yes"]},{flag:"--author"},{flag:"--agent-guidance"},{flag:"--with-packages"},{flag:"--no-merge-fence"},{flag:"--workspace"},{flag:"--force"},{flag:"--verbose"}];const CONFIG_FLAG_CONTRACTS=[{flag:"--value",value_name:"value"},{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"}];const EXTENSION_FLAG_CONTRACTS=[{flag:"--dry-run"},{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:"--isolated"},{flag:"--ignore-global"},{flag:"--strict-exit"},{flag:"--fail-on-warn"}];const EXTENSION_SCOPE_FLAG_CONTRACTS=[{flag:"--project"},{flag:"--local"},{flag:"--global"}];const EXTENSION_INIT_FLAG_CONTRACTS=[...EXTENSION_SCOPE_FLAG_CONTRACTS,{flag:"--capability"}];const PACKAGE_FLAG_CONTRACTS=[...EXTENSION_FLAG_CONTRACTS,{flag:"--declarative"}];const PACKAGE_INIT_FLAG_CONTRACTS=[...EXTENSION_INIT_FLAG_CONTRACTS,{flag:"--declarative"}];const EXTENSION_INSTALL_FLAG_CONTRACTS=[{flag:"--dry-run"},{flag:"--project"},{flag:"--local"},{flag:"--global"},{flag:"--gh"},{flag:"--github"},{flag:"--ref"}];const EXTENSION_UNINSTALL_FLAG_CONTRACTS=EXTENSION_SCOPE_FLAG_CONTRACTS;const EXTENSION_EXPLORE_FLAG_CONTRACTS=EXTENSION_SCOPE_FLAG_CONTRACTS;const EXTENSION_DESCRIBE_FLAG_CONTRACTS=[...EXTENSION_SCOPE_FLAG_CONTRACTS,{flag:"--markdown"},{flag:"--output"}];const EXTENSION_ADOPT_ALL_FLAG_CONTRACTS=EXTENSION_SCOPE_FLAG_CONTRACTS;const EXTENSION_ACTIVATE_FLAG_CONTRACTS=EXTENSION_SCOPE_FLAG_CONTRACTS;const EXTENSION_DEACTIVATE_FLAG_CONTRACTS=EXTENSION_SCOPE_FLAG_CONTRACTS;const EXTENSION_MIGRATE_FLAG_CONTRACTS=[...EXTENSION_SCOPE_FLAG_CONTRACTS,{flag:"--dry-run"}];const EXTENSION_MANAGE_FLAG_CONTRACTS=[...EXTENSION_SCOPE_FLAG_CONTRACTS,{flag:"--runtime-probe"},{flag:"--fix-managed-state"}];const EXTENSION_RELOAD_FLAG_CONTRACTS=[...EXTENSION_SCOPE_FLAG_CONTRACTS,{flag:"--watch"}];const EXTENSION_DOCTOR_FLAG_CONTRACTS=[...EXTENSION_SCOPE_FLAG_CONTRACTS,{flag:"--detail"},{flag:"--trace"},{flag:"--fix-managed-state"},{flag:"--isolated"},{flag:"--ignore-global"},{flag:"--strict-exit"},{flag:"--fail-on-warn"}];const EXTENSION_CATALOG_FLAG_CONTRACTS=[...EXTENSION_SCOPE_FLAG_CONTRACTS,{flag:"--fields",list:true}];const EXTENSION_ADOPT_FLAG_CONTRACTS=[...EXTENSION_SCOPE_FLAG_CONTRACTS,{flag:"--gh"},{flag:"--github"},{flag:"--ref"}];const INSTALL_FLAG_CONTRACTS=[{flag:"--dry-run"},{flag:"--project"},{flag:"--local"},{flag:"--global"},{flag:"--gh"},{flag:"--github"},{flag:"--ref"}];const UPGRADE_FLAG_CONTRACTS=[{flag:"--dry-run"},{flag:"--cli-only"},{flag:"--packages-only"},{flag:"--project"},{flag:"--local"},{flag:"--global"},{flag:"--repair"},{flag:"--tag"},{flag:"--package-name"}];const REINDEX_FLAG_CONTRACTS=[{flag:"--mode"},{flag:"--progress"}];const CLOSE_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--reason",value_name:"value"},{flag:"--close-reason",value_name:"value"},{flag:"--completed-at",value_name:"value"},{flag:"--duplicate-of",value_name:"value"},{flag:"--author",value_name:"value"},{flag:"--message",value_name:"value"},{flag:"--validate-close",value_name:"off|warn|strict"},{flag:"--resolution",value_name:"value"},{flag:"--expected-result",aliases:["--expected_result","--expected"],value_name:"value"},{flag:"--actual-result",aliases:["--actual_result","--actual"],value_name:"value"},{flag:"--force",value_type:"boolean"}];const 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:"--completed-at"},{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"}];const APPEND_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--body",short:"-b"},{flag:"--text"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];const CLAIM_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--author",aliases:["--assignee"]},{flag:"--message"},{flag:"--force"},{flag:"--if-available"},{flag:"--next"},{flag:"--type"},{flag:"--tag"},{flag:"--priority"},{flag:"--assignee-filter"},{flag:"--parent"},{flag:"--sprint"},{flag:"--release"},{flag:"--max-attempts"},{flag:"--include-decisions"},{flag:"--include-gates"},{flag:"--include-containers"},{flag:"--token-budget",aliases:["--token_budget"]},{flag:"--explain-ranking",aliases:["--explain_ranking"]}];const RESTORE_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];const DELETE_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--dry-run"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];const RELEASE_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--author",aliases:["--assignee"]},{flag:"--message"},{flag:"--force"}];const START_TASK_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--author",aliases:["--assignee"]},{flag:"--message"},{flag:"--force"}];const PAUSE_TASK_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--author",aliases:["--assignee"]},{flag:"--message"},{flag:"--force"}];const CLOSE_TASK_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--author",aliases:["--assignee"]},{flag:"--message"},{flag:"--validate-close",value_name:"off|warn|strict"},{flag:"--force"}];const SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS=[{flag:"--parent"},{flag:"--allow-missing-parent"},{flag:"--tags"},{flag:"--priority"},{flag:"--body"},{flag:"--description"},{flag:"--author"},{flag:"--message"}];const MEET_FLAG_CONTRACTS=[{flag:"--start"},{flag:"--duration"},{flag:"--end"},{flag:"--location"},{flag:"--timezone"},{flag:"--all-day"},...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS];const EVENT_FLAG_CONTRACTS=MEET_FLAG_CONTRACTS;const REMIND_FLAG_CONTRACTS=[{flag:"--at"},{flag:"--text"},...SCHEDULING_SHORTCUT_COMMON_FLAG_CONTRACTS];const TEST_FLAG_CONTRACTS=[{flag:"--list"},{flag:"--id",value_name:"item-id"},{flag:"--add"},{flag:"--add-json"},{flag:"--remove"},{flag:"--remove-index",repeatable:true},{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:"--workspace-context"},{flag:"--override-linked-workspace-context"},{flag:"--allow-untrusted-linked-tests"},{flag:"--acknowledge-linked-tests"},{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:"--measure",list:true},{flag:"--metric-below"},{flag:"--metric-diff"},{flag:"--author"},{flag:"--message"},{flag:"--force"}];const 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:"--workspace-context"},{flag:"--override-linked-workspace-context"},{flag:"--allow-untrusted-linked-tests"},{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"}];const TELEMETRY_FLAG_CONTRACTS=[{flag:"--limit"}];const TEST_RUNS_FLAG_CONTRACTS=[{flag:"--status"},{flag:"--limit"},{flag:"--stream"},{flag:"--tail"},{flag:"--force"},{flag:"--author"}];const GC_FLAG_CONTRACTS=[{flag:"--dry-run"},{flag:"--scope"}];const STATS_FLAG_CONTRACTS=[{flag:"--include-empty"},{flag:"--storage"},{flag:"--metadata-coverage"},{flag:"--field-utilization"},{flag:"--by-assignee"},{flag:"--by-tag"},{flag:"--by-priority"},{flag:"--tag-prefix"},{flag:"--analytics"}];const DUPLICATES_FLAG_CONTRACTS=[{flag:"--exhaustive",value_type:"boolean"},{flag:"--status",repeatable:true,list:true},{flag:"--since"},{flag:"--threshold"},{flag:"--limit"}];const HEALTH_FLAG_CONTRACTS=[{flag:"--strict-directories"},{flag:"--require-merge-drivers"},{flag:"--strict-exit"},{flag:"--fail-on-warn"},{flag:"--check-only"},{flag:"--check-telemetry"},{flag:"--no-refresh"},{flag:"--refresh-vectors"},{flag:"--verbose-stale-items"},{flag:"--verbose-author-events"},{flag:"--brief"},{flag:"--summary"},{flag:"--skip-vectors"},{flag:"--skip-integrity"},{flag:"--skip-drift"},{flag:"--full"}];const 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"},{flag:"--fix-scope"},{flag:"--prune-missing"},{flag:"--check-history-drift"},{flag:"--check-command-references"},{flag:"--check-storage-integrity"},{flag:"--counts"},{flag:"--full"}];const ASSURANCE_FLAG_CONTRACTS=[{flag:"--definition",value_name:"json"},{flag:"--trigger",value_name:"value"},{flag:"--tree",value_name:"value"},{flag:"--gate",value_name:"id"},{flag:"--limit",value_name:"number"},{flag:"--dry-run"},{flag:"--author",value_name:"value"},{flag:"--message",value_name:"value"},{flag:"--owner",value_name:"item-id"},{flag:"--apply",value_type:"boolean"},{flag:"--enforcement",value_name:"level"}];const ITEM_OWNERSHIP_AND_ISSUE_FLAG_CONTRACTS=[{flag:"--assignee"},{flag:"--parent"},{flag:"--allow-missing-parent"},{flag:"--allow-unresolved-deps"},{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"}];const ITEM_PORTFOLIO_FLAG_CONTRACTS=[{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"}];const ITEM_CONTENT_METADATA_FLAG_CONTRACTS=[{short:"-p",flag:"--priority"},{flag:"--type"},{flag:"--tags",aliases:["--tag"],list:true},{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:"--add-ac",aliases:["--add_ac"]},{flag:"--remove-ac",aliases:["--remove_ac"]}];const CREATE_FLAG_CONTRACTS=[{flag:"--stdin-json"},{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"},{flag:"--close-reason"},{flag:"--close_reason"},{flag:"--completed-at"},{flag:"--completed_at"},{short:"-p",flag:"--priority"},{flag:"--tags",aliases:["--tag"],list:true},{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"},...ITEM_OWNERSHIP_AND_ISSUE_FLAG_CONTRACTS,...ITEM_PORTFOLIO_FLAG_CONTRACTS,{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",aliases:["--linked-file"]},{flag:"--test",aliases:["--linked-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"},{flag:"--allow-duplicate",value_type:"boolean"}];const ITEM_MUTATE_FLAG_CONTRACTS=[{flag:"--transaction-id",value_name:"value"},{flag:"--stdin-json"},{flag:"--dry-run"},{flag:"--create-compensation",value_name:"mode"},{flag:"--lock-ttl-seconds",value_name:"n"},{flag:"--lock-wait-ms",value_name:"n"},{flag:"--author",value_name:"value"}];const ITEM_COMPLETE_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--transaction-id",value_name:"value",required:true},{flag:"--reason",value_name:"value"},{flag:"--file",value_name:"value",repeatable:true},{flag:"--doc",value_name:"value",repeatable:true},{flag:"--test",value_name:"value",repeatable:true},{flag:"--comment",value_name:"value",repeatable:true},{flag:"--note",value_name:"value",repeatable:true},{flag:"--learning",value_name:"value",repeatable:true},{flag:"--resolution",value_name:"value"},{flag:"--expected-result",value_name:"value"},{flag:"--actual-result",value_name:"value"},{flag:"--completed-at",value_name:"value"},{flag:"--validate-close",value_name:"off|warn|strict"},{flag:"--lock-ttl-seconds",value_name:"n"},{flag:"--lock-wait-ms",value_name:"n"},{flag:"--dry-run"},{flag:"--force"},{flag:"--author",value_name:"value"}];const ITEM_REOPEN_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--status",value_name:"open|in_progress"},{flag:"--message",value_name:"value"},{flag:"--force"},{flag:"--author",value_name:"value"}];const COPY_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--title",value_name:"value"},{flag:"--author",value_name:"value"},{flag:"--message",value_name:"value"},{flag:"--allow-duplicate",value_type:"boolean"}];const FOCUS_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--clear"}];const UPDATE_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--stdin-json"},{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"},{flag:"--completed-at"},...ITEM_CONTENT_METADATA_FLAG_CONTRACTS,...ITEM_OWNERSHIP_AND_ISSUE_FLAG_CONTRACTS,{flag:"--fixed_version"},...ITEM_PORTFOLIO_FLAG_CONTRACTS,{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:"--replace-files"},{flag:"--replace-docs"},{flag:"--comment"},{flag:"--note"},{flag:"--learning"},{flag:"--file",aliases:["--linked-file"]},{flag:"--test",aliases:["--linked-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:"--force"}];const UPDATE_MANY_FLAG_CONTRACTS=[{flag:"--status",short:"-s"},{flag:"--assignee"},{flag:"--parent"},{flag:"--blocked-by",aliases:["--blocked_by"]},{flag:"--blocked-reason",aliases:["--blocked_reason"]},{flag:"--unblock-note",aliases:["--unblock_note"]},{flag:"--filter-status",list:true},{flag:"--filter-type",list:true},{flag:"--filter-tag",list:true},{flag:"--filter-priority",list:true},{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",list:true},{flag:"--filter-assignee-filter"},{flag:"--filter-assignee_filter"},{flag:"--filter-parent"},{flag:"--filter-sprint",list:true},{flag:"--filter-release",list:true},{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"},...ITEM_CONTENT_METADATA_FLAG_CONTRACTS,{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:"--allow-unresolved-deps"},{flag:"--dep"},{flag:"--dep-remove"},{flag:"--dep_remove"},{flag:"--replace-deps"},{flag:"--replace-tests"},{flag:"--replace-files"},{flag:"--replace-docs"},{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:"--author"},{flag:"--message"},{flag:"--force"}];const 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"}];const ACTIVITY_FLAG_CONTRACTS=[{flag:"--id"},{flag:"--op"},{flag:"--author"},{flag:"--from"},{flag:"--to"},{flag:"--limit"},{flag:"--unbounded"},{flag:"--compact"},{flag:"--raw"},{flag:"--full"},{flag:"--provenance"},{flag:"--provenance-summary"},{flag:"--harness",repeatable:true},{flag:"--agent-instance",repeatable:true},{flag:"--provenance-filter",repeatable:true},{flag:"--stream"}];const EVENTS_FLAG_CONTRACTS=[{flag:"--since"},{flag:"--type",repeatable:true},{flag:"--author",repeatable:true},{flag:"--item",repeatable:true},{flag:"--limit",value_type:"number"},{flag:"--cursor-mode",value_name:"batch|row"},{flag:"--full"},{flag:"--provenance"},{flag:"--provenance-summary"},{flag:"--harness",repeatable:true},{flag:"--agent-instance",repeatable:true},{flag:"--provenance-filter",repeatable:true},{flag:"--follow"},{flag:"--interval-ms",value_type:"number"}];const CONTEXT_FLAG_CONTRACTS=withCursorSemantics([{flag:"--for",value_name:"intent"},{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",aliases:["--max-items"]},{flag:"--after"},{flag:"--format"},{flag:"--depth"},{flag:"--fields",list:true},{flag:"--section"},{flag:"--activity-limit"},{flag:"--stale-threshold"},{flag:"--explain-ranking"},{flag:"--explain_ranking"},{flag:"--token-budget",aliases:["--token_budget"]},{flag:"--no-extension-health"},{flag:"--no-tags"}],new Set(["--limit","--after","--format","--fields","--section","--activity-limit","--stale-threshold","--explain-ranking","--explain_ranking","--no-extension-health","--no-tags"]));const GET_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--for",value_name:"intent"},{flag:"--token-budget",aliases:["--token_budget"]},{flag:"--depth"},{flag:"--full",value_type:"boolean"},{flag:"--fields",list:true},{flag:"--at"},{flag:"--tree"},{flag:"--tree-depth"},{flag:"--tree_depth"},{flag:"--format"}];const GUIDE_FLAG_CONTRACTS=[{flag:"--list"},{flag:"--format"},{flag:"--depth"}];const DEPS_FLAG_CONTRACTS=[{flag:"--id",value_name:"item-id"},{flag:"--format"},{flag:"--max-depth"},{flag:"--collapse"},{flag:"--summary"},{flag:"--full"},{flag:"--node-limit"},{flag:"--edge-limit"},{flag:"--token-budget"},{flag:"--cursor"},{flag:"--direction"},{flag:"--kind",list:true}];const GRAPH_FLAG_CONTRACTS=[{flag:"--kind",list:true},{flag:"--max-depth"},{flag:"--limit"},{flag:"--after"},{flag:"--direction"},{flag:"--max-paths"},{flag:"--sample"},{flag:"--exempt-isolate",list:true},{flag:"--exempt-isolate-type",list:true},{flag:"--save-baseline"},{flag:"--rebuild"},{flag:"--clear"},{flag:"--summary"},{flag:"--full"}];const EVAL_FLAG_CONTRACTS=[{flag:"--mode"},{flag:"--k"},{flag:"--fail-under"},{flag:"--queries"},{flag:"--format"}];const WORKSPACE_FLAG_CONTRACTS=[{flag:"--dry-run"},{flag:"--force"},{flag:"--author"},{flag:"--message"}];const WORKSPACE_POSITION_FLAG_CONTRACTS=[];const NEXT_FLAG_CONTRACTS=[{flag:"--include-decisions"},{flag:"--include-gates"},{flag:"--include-containers"},{flag:"--for",value_name:"intent"},{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"},{flag:"--explain-ranking"},{flag:"--explain_ranking"},{flag:"--token-budget",aliases:["--token_budget"]}];const SEARCH_FLAG_CONTRACTS=withCursorSemantics([{flag:"--for",value_name:"intent"},{flag:"--token-budget",aliases:["--token_budget"]},{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:"--after"},{flag:"--status",list:true},{flag:"--type",list:true},{flag:"--tag",aliases:["--tags"],list:true},{flag:"--priority",list:true},{flag:"--deadline-before"},{flag:"--deadline-after"},{flag:"--updated-after"},{flag:"--updated-before"},{flag:"--created-after"},{flag:"--created-before"},{flag:"--assignee",list:true},{flag:"--sprint",list:true},{flag:"--release",list:true},{flag:"--parent"},...GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS],new Set(["--highlight","--compact","--full","--fields","--format","--limit","--token-budget","--after"]));const CONTRACTS_FLAG_CONTRACTS=[{flag:"--action"},{flag:"--command"},{flag:"--summary"},{flag:"--schema-only"},{flag:"--flags-only"},{flag:"--availability-only"},{flag:"--runtime-only"},{flag:"--active-only"},{flag:"--full"}];const COMPLETION_FLAG_CONTRACTS=[{flag:"--eager-tags"}];function toUniqueFlagContracts(contracts){const seen=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){const byCanonicalFlag=new Map;for(const contract of[...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,...contracts]){const canonicalFlag=normalizeFlagAliasKey(contract.flag);const prior=byCanonicalFlag.get(canonicalFlag);const{aliases:declaredAliases,...contractWithoutAliases}=contract;const aliases=normalizeUniqueStringList([...declaredAliases??[],...contract.flag===canonicalFlag?[]:[contract.flag]]).filter(alias=>alias!==canonicalFlag);const normalizedContract={...contractWithoutAliases,flag:canonicalFlag,...aliases.length>0?{aliases}:{}};const mergedAliases=normalizeUniqueStringList([...prior?.aliases??[],...normalizedContract.aliases??[]]);byCanonicalFlag.set(canonicalFlag,prior===void 0?normalizedContract:{...prior,...normalizedContract,...mergedAliases.length>0?{aliases:mergedAliases}:{}})}return withFlagAliasMetadata([...byCanonicalFlag.values()])}const FIXED_STATUS_LIST_COMMAND_ALIASES=["list-draft","list-open","list-in-progress","list-blocked","list-closed","list-canceled"];const FIXED_STATUS_LIST_FLAG_CONTRACTS=LIST_FILTER_FLAG_CONTRACTS.filter(contract=>contract.flag!=="--status"&&contract.flag!=="--all");function indexCliFlagContracts(contracts){const index=new Map;for(const contract of contracts){for(const spelling of[contract.flag,...contract.aliases??[]]){const matches=index.get(spelling)??[];matches.push(contract);index.set(spelling,matches)}}return index}const PLAN_FLAG_CONTRACT_INDEX=indexCliFlagContracts(PLAN_FLAG_CONTRACTS);const ASSURANCE_FLAG_CONTRACT_INDEX=indexCliFlagContracts(ASSURANCE_FLAG_CONTRACTS);const POSITIONAL_ACTION_FLAG_INDEX_BY_PARENT=new Map([["assurance",ASSURANCE_FLAG_CONTRACT_INDEX],["plan",PLAN_FLAG_CONTRACT_INDEX],["workspace",indexCliFlagContracts(WORKSPACE_POSITION_FLAG_CONTRACTS)],["workspace snapshot",indexCliFlagContracts(WORKSPACE_FLAG_CONTRACTS)]]);function resolvePmPositionalActionFlagContracts(actions=PM_POSITIONAL_ACTION_CONTRACTS){return actions.map(({command,parent,accepted_flags:acceptedFlags})=>{const parentFlagIndex=POSITIONAL_ACTION_FLAG_INDEX_BY_PARENT.get(parent);if(!parentFlagIndex){throw new Error(`Positional action ${command} has no flag-contract index for ${parent}.`)}const selected=acceptedFlags.map(acceptedFlag=>{const matches=parentFlagIndex.get(acceptedFlag)??[];if(matches.length!==1){throw new Error(`Positional action ${command} accepted flag ${acceptedFlag} does not resolve to exactly one ${parent} flag contract.`)}return matches[0]});return[command,selected]})}const PM_POSITIONAL_ACTION_FLAG_CONTRACTS=resolvePmPositionalActionFlagContracts();const SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND=new Map([["list",LIST_FILTER_FLAG_CONTRACTS],["list-all",LIST_FILTER_FLAG_CONTRACTS],...FIXED_STATUS_LIST_COMMAND_ALIASES.map(command=>[command,FIXED_STATUS_LIST_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],["package",PACKAGE_FLAG_CONTRACTS],["packages",PACKAGE_FLAG_CONTRACTS],["install",INSTALL_FLAG_CONTRACTS],["upgrade",UPGRADE_FLAG_CONTRACTS],["create",CREATE_FLAG_CONTRACTS],["item",[]],["item mutate",ITEM_MUTATE_FLAG_CONTRACTS],["item complete",ITEM_COMPLETE_FLAG_CONTRACTS],["item reopen",ITEM_REOPEN_FLAG_CONTRACTS],["copy",COPY_FLAG_CONTRACTS],["focus",FOCUS_FLAG_CONTRACTS],["aggregate",AGGREGATE_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],["workspace",WORKSPACE_FLAG_CONTRACTS],["workspace position",WORKSPACE_POSITION_FLAG_CONTRACTS],["workspace snapshot",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot create",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot list",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot inspect",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot restore",WORKSPACE_FLAG_CONTRACTS],["workspace snapshot delete",WORKSPACE_FLAG_CONTRACTS],["history",HISTORY_FLAG_CONTRACTS],["history-redact",HISTORY_REDACT_FLAG_CONTRACTS],["history-repair",HISTORY_REPAIR_FLAG_CONTRACTS],["history-author-acknowledge",HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS],["history-compact",HISTORY_COMPACT_FLAG_CONTRACTS],["merge",MERGE_FLAG_CONTRACTS],["schema",SCHEMA_FLAG_CONTRACTS],["profile",PROFILE_FLAG_CONTRACTS],["plan",PLAN_FLAG_CONTRACTS],["activity",ACTIVITY_FLAG_CONTRACTS],["events",EVENTS_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],["notes",NOTES_FLAG_CONTRACTS],["learnings",LEARNINGS_FLAG_CONTRACTS],["files",FILES_FLAG_CONTRACTS],["docs",DOCS_FLAG_CONTRACTS],["deps",DEPS_FLAG_CONTRACTS],["graph",GRAPH_FLAG_CONTRACTS],["test",TEST_FLAG_CONTRACTS],["test-all",TEST_ALL_FLAG_CONTRACTS],["telemetry",TELEMETRY_FLAG_CONTRACTS],["health",HEALTH_FLAG_CONTRACTS],["assurance",ASSURANCE_FLAG_CONTRACTS],...PM_POSITIONAL_ACTION_FLAG_CONTRACTS,["validate",VALIDATE_FLAG_CONTRACTS],["gc",GC_FLAG_CONTRACTS],["stats",STATS_FLAG_CONTRACTS],["duplicates",DUPLICATES_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]]);const EXTENSION_LIFECYCLE_FLAG_CONTRACTS_BY_SUBCOMMAND=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],["list",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],["migrate",EXTENSION_MIGRATE_FLAG_CONTRACTS]]);function normalizeCommandNameForContracts(commandName){if(typeof commandName!=="string"){return""}return resolvePmHistoryOperation(commandName.trim().toLowerCase())}function hasSubcommandFlagContractsForCommand(commandName){const normalized=normalizeCommandNameForContracts(commandName);if(SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND.has(normalized)){return true}const[rootCommand,lifecycleSubcommand,...extraParts]=normalized.split(/\s+/);return(rootCommand==="extension"||rootCommand==="package"||rootCommand==="packages")&&lifecycleSubcommand!==void 0&&extraParts.length===0&&(lifecycleSubcommand==="init"||lifecycleSubcommand==="scaffold"||EXTENSION_LIFECYCLE_FLAG_CONTRACTS_BY_SUBCOMMAND.has(lifecycleSubcommand))}function resolveExtensionLifecycleFlagContracts(rootCommand,lifecycleSubcommand){if(lifecycleSubcommand==="init"||lifecycleSubcommand==="scaffold"){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){if((rootCommand==="package"||rootCommand==="packages")&&lifecycleSubcommand==="upgrade"){return withSubcommandGlobalFlags(UPGRADE_FLAG_CONTRACTS)}return withSubcommandGlobalFlags(resolveExtensionLifecycleFlagContracts(rootCommand,lifecycleSubcommand))}const contracts=SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND.get(normalized)??[];return withSubcommandGlobalFlags(contracts)}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(" ")}export{ACTIVITY_FLAG_CONTRACTS,AGGREGATE_FLAG_CONTRACTS,APPEND_FLAG_CONTRACTS,ASSURANCE_FLAG_CONTRACTS,CALENDAR_FLAG_CONTRACTS,CLAIM_FLAG_CONTRACTS,CLOSE_FLAG_CONTRACTS,CLOSE_MANY_FLAG_CONTRACTS,CLOSE_TASK_FLAG_CONTRACTS,COMMENTS_FLAG_CONTRACTS,COMPLETION_FLAG_CONTRACTS,CONFIG_FLAG_CONTRACTS,CONTEXT_FLAG_CONTRACTS,CONTRACTS_FLAG_CONTRACTS,COPY_FLAG_CONTRACTS,CREATE_FLAG_CONTRACTS,DELETE_FLAG_CONTRACTS,DEPS_FLAG_CONTRACTS,DOCS_FLAG_CONTRACTS,DUPLICATES_FLAG_CONTRACTS,EVAL_FLAG_CONTRACTS,EVENTS_FLAG_CONTRACTS,EVENT_FLAG_CONTRACTS,EXTENSION_ACTIVATE_FLAG_CONTRACTS,EXTENSION_ADOPT_ALL_FLAG_CONTRACTS,EXTENSION_ADOPT_FLAG_CONTRACTS,EXTENSION_CATALOG_FLAG_CONTRACTS,EXTENSION_DEACTIVATE_FLAG_CONTRACTS,EXTENSION_DESCRIBE_FLAG_CONTRACTS,EXTENSION_DOCTOR_FLAG_CONTRACTS,EXTENSION_EXPLORE_FLAG_CONTRACTS,EXTENSION_FLAG_CONTRACTS,EXTENSION_INIT_FLAG_CONTRACTS,EXTENSION_INSTALL_FLAG_CONTRACTS,EXTENSION_MANAGE_FLAG_CONTRACTS,EXTENSION_MIGRATE_FLAG_CONTRACTS,EXTENSION_RELOAD_FLAG_CONTRACTS,EXTENSION_SCOPE_FLAG_CONTRACTS,EXTENSION_UNINSTALL_FLAG_CONTRACTS,FILES_FLAG_CONTRACTS,FOCUS_FLAG_CONTRACTS,GC_FLAG_CONTRACTS,GET_FLAG_CONTRACTS,GLOBAL_FLAG_CONTRACTS,GRAPH_FLAG_CONTRACTS,GUIDE_FLAG_CONTRACTS,HEALTH_FLAG_CONTRACTS,HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS,HISTORY_COMPACT_FLAG_CONTRACTS,HISTORY_FLAG_CONTRACTS,HISTORY_REDACT_FLAG_CONTRACTS,HISTORY_REPAIR_FLAG_CONTRACTS,INIT_FLAG_CONTRACTS,INSTALL_FLAG_CONTRACTS,ITEM_COMPLETE_FLAG_CONTRACTS,ITEM_MUTATE_FLAG_CONTRACTS,ITEM_REOPEN_FLAG_CONTRACTS,LEARNINGS_FLAG_CONTRACTS,LIST_FILTER_FLAG_CONTRACTS,MEET_FLAG_CONTRACTS,MERGE_FLAG_CONTRACTS,NEXT_FLAG_CONTRACTS,NOTES_FLAG_CONTRACTS,PACKAGE_FLAG_CONTRACTS,PACKAGE_INIT_FLAG_CONTRACTS,PAUSE_TASK_FLAG_CONTRACTS,PLAN_FLAG_CONTRACTS,PM_POSITIONAL_ACTION_FLAG_CONTRACTS,PROFILE_FLAG_CONTRACTS,REINDEX_FLAG_CONTRACTS,RELEASE_FLAG_CONTRACTS,REMIND_FLAG_CONTRACTS,RESTORE_FLAG_CONTRACTS,SCHEMA_FLAG_CONTRACTS,SEARCH_FLAG_CONTRACTS,START_TASK_FLAG_CONTRACTS,STATS_FLAG_CONTRACTS,SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,TELEMETRY_FLAG_CONTRACTS,TEST_ALL_FLAG_CONTRACTS,TEST_FLAG_CONTRACTS,TEST_RUNS_FLAG_CONTRACTS,UPDATE_FLAG_CONTRACTS,UPDATE_MANY_FLAG_CONTRACTS,UPGRADE_FLAG_CONTRACTS,VALIDATE_FLAG_CONTRACTS,WORKSPACE_FLAG_CONTRACTS,WORKSPACE_POSITION_FLAG_CONTRACTS,compactFlagAliasContracts,hasSubcommandFlagContractsForCommand,resolvePmPositionalActionFlagContracts,resolveSubcommandFlagContractsForCommand,toCompletionFlagString,toUniqueFlagContracts,withFlagAliasMetadata};
 //# sourceMappingURL=flag-contracts.js.map
-//# debugId=573d318a-5ebe-5547-8be7-16026a077c84