@unbrained/pm-cli 2026.7.1 → 2026.7.3

package/dist/cli-bundle/chunks/chunk-QCDTQCMW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/governance/metadata-coverage.ts"],"sourcesContent":["/**\n * Metadata governance & coverage observability primitives.\n *\n * One dependency-light module that powers the whole metadata-governance\n * surface: missing-field selection (pm list / pm update-many), coverage\n * percentages (pm stats --metadata-coverage / pm validate), and grouped\n * lifecycle breakdowns (pm stats --by-assignee/--by-tag/--by-priority,\n * pm aggregate explicit labels).\n *\n * The module is pure: it performs no IO and imports no heavy runtime\n * dependencies. Lifecycle semantics are injected via a {@link LifecycleClassifier}\n * so callers map their runtime status registry to lifecycle buckets while the\n * pure logic here stays trivially testable with a fake classifier.\n */\n\nimport { toNonEmptyStringOrUndefined } from \"../shared/primitives.js\";\n\n/** Minimal structural shape this module needs from an item's front matter. */\nexport interface CoverageItem {\n  type: string;\n  status: string;\n  assignee?: string;\n  tags?: string[];\n  parent?: string;\n  priority?: number;\n  acceptance_criteria?: string;\n  estimated_minutes?: number;\n  resolution?: string;\n  reviewer?: string;\n  risk?: string;\n  /** Confidence is a string-like enum or a numeric score depending on workspace. */\n  confidence?: string | number;\n  sprint?: string;\n  release?: string;\n  [key: string]: unknown;\n}\n\n/** Lifecycle buckets used by grouped breakdowns and distributions. */\nexport type LifecycleBucket =\n  | \"open\"\n  | \"in_progress\"\n  | \"blocked\"\n  | \"draft\"\n  | \"closed\"\n  | \"canceled\"\n  | \"other\";\n\n/** Stable rendering order for lifecycle buckets. */\nexport const LIFECYCLE_BUCKET_ORDER: readonly LifecycleBucket[] = [\n  \"open\",\n  \"in_progress\",\n  \"blocked\",\n  \"draft\",\n  \"closed\",\n  \"canceled\",\n  \"other\",\n] as const;\n\n/**\n * Classifies a raw status string into a lifecycle bucket and reports whether a\n * status is terminal (closed/canceled). Callers build this from their resolved\n * runtime status registry via {@link lifecycleClassifierFromStatusRegistry}.\n */\nexport interface LifecycleClassifier {\n  classify(status: string): LifecycleBucket;\n  isTerminal(status: string): boolean;\n}\n\n/** The subset of a resolved runtime status registry this module consumes. */\nexport interface StatusRegistryLike {\n  alias_to_id: Map<string, string>;\n  terminal_statuses: Set<string>;\n  terminal_canceled_statuses: Set<string>;\n  blocked_statuses: Set<string>;\n  draft_statuses: Set<string>;\n  active_statuses: Set<string>;\n  open_status: string;\n}\n\nfunction normalizeStatus(status: string, registry: StatusRegistryLike): string {\n  const trimmed = status.trim().toLowerCase();\n  return registry.alias_to_id.get(trimmed) ?? trimmed;\n}\n\n/**\n * Adapt a resolved runtime status registry into a {@link LifecycleClassifier}.\n *\n * Precedence is deliberate and disjoint: canceled → closed → blocked → draft →\n * open → in_progress (active but not the default open status) → other.\n */\nexport function lifecycleClassifierFromStatusRegistry(registry: StatusRegistryLike): LifecycleClassifier {\n  return {\n    isTerminal(status: string): boolean {\n      return registry.terminal_statuses.has(normalizeStatus(status, registry));\n    },\n    classify(status: string): LifecycleBucket {\n      const id = normalizeStatus(status, registry);\n      if (registry.terminal_canceled_statuses.has(id)) {\n        return \"canceled\";\n      }\n      if (registry.terminal_statuses.has(id)) {\n        return \"closed\";\n      }\n      if (registry.blocked_statuses.has(id)) {\n        return \"blocked\";\n      }\n      if (registry.draft_statuses.has(id)) {\n        return \"draft\";\n      }\n      if (id === registry.open_status) {\n        return \"open\";\n      }\n      if (registry.active_statuses.has(id)) {\n        return \"in_progress\";\n      }\n      return \"other\";\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Missing-metadata predicates\n// ---------------------------------------------------------------------------\n\n/** True when an item has no non-empty acceptance_criteria. */\nexport function isAcMissing(item: CoverageItem): boolean {\n  return toNonEmptyStringOrUndefined(item.acceptance_criteria) === undefined;\n}\n\n/** True when an item has no finite estimated_minutes. */\nexport function isEstimateMissing(item: CoverageItem): boolean {\n  return !Number.isFinite(item.estimated_minutes);\n}\n\n/**\n * True when a terminal (closed/canceled) item has no non-empty resolution.\n * Resolution is only expected on terminal items, so open items are never\n * considered \"resolution-missing\".\n */\nexport function isResolutionMissing(item: CoverageItem, classifier: LifecycleClassifier): boolean {\n  if (!classifier.isTerminal(item.status)) {\n    return false;\n  }\n  return toNonEmptyStringOrUndefined(item.resolution) === undefined;\n}\n\n/** True when an item has no non-empty reviewer. */\nexport function isReviewerMissing(item: CoverageItem): boolean {\n  return toNonEmptyStringOrUndefined(item.reviewer) === undefined;\n}\n\n/** True when an item has no non-empty risk level. */\nexport function isRiskMissing(item: CoverageItem): boolean {\n  return toNonEmptyStringOrUndefined(item.risk) === undefined;\n}\n\n/**\n * True when an item has no confidence value. Confidence is a string-like enum\n * or a numeric score depending on workspace, so a finite number counts as\n * present and only blank/absent values are treated as missing.\n */\nexport function isConfidenceMissing(item: CoverageItem): boolean {\n  if (typeof item.confidence === \"number\") {\n    return !Number.isFinite(item.confidence);\n  }\n  return toNonEmptyStringOrUndefined(item.confidence) === undefined;\n}\n\n/** True when an item has no non-empty sprint. */\nexport function isSprintMissing(item: CoverageItem): boolean {\n  return toNonEmptyStringOrUndefined(item.sprint) === undefined;\n}\n\n/** True when an item has no non-empty release. */\nexport function isReleaseMissing(item: CoverageItem): boolean {\n  return toNonEmptyStringOrUndefined(item.release) === undefined;\n}\n\n/** Selection flags for {@link filterMissingMetadata}. */\nexport interface MissingMetadataFilters {\n  acMissing?: boolean;\n  estimatesMissing?: boolean;\n  resolutionMissing?: boolean;\n  reviewerMissing?: boolean;\n  riskMissing?: boolean;\n  confidenceMissing?: boolean;\n  sprintMissing?: boolean;\n  releaseMissing?: boolean;\n  /** Match items missing ANY of the tracked metadata fields (union). */\n  metadataMissing?: boolean;\n}\n\n/** True when any missing-metadata filter is requested. */\nexport function hasMissingMetadataFilter(filters: MissingMetadataFilters): boolean {\n  return Boolean(\n    filters.acMissing ||\n      filters.estimatesMissing ||\n      filters.resolutionMissing ||\n      filters.reviewerMissing ||\n      filters.riskMissing ||\n      filters.confidenceMissing ||\n      filters.sprintMissing ||\n      filters.releaseMissing ||\n      filters.metadataMissing,\n  );\n}\n\nfunction itemMatchesSpecificMetadataFilters(\n  item: CoverageItem,\n  filters: MissingMetadataFilters,\n  classifier: LifecycleClassifier,\n): boolean {\n  const checks: Array<[boolean | undefined, boolean]> = [\n    [filters.acMissing, isAcMissing(item)],\n    [filters.estimatesMissing, isEstimateMissing(item)],\n    [filters.resolutionMissing, isResolutionMissing(item, classifier)],\n    [filters.reviewerMissing, isReviewerMissing(item)],\n    [filters.riskMissing, isRiskMissing(item)],\n    [filters.confidenceMissing, isConfidenceMissing(item)],\n    [filters.sprintMissing, isSprintMissing(item)],\n    [filters.releaseMissing, isReleaseMissing(item)],\n  ];\n  return checks.every(([requested, matched]) => requested !== true || matched);\n}\n\nfunction itemMatchesCoreMetadataMissingUnion(item: CoverageItem, classifier: LifecycleClassifier): boolean {\n  return isAcMissing(item) || isEstimateMissing(item) || isResolutionMissing(item, classifier);\n}\n\n/**\n * Does a single item satisfy the requested missing-metadata filters?\n *\n * Specific flags (acMissing/estimatesMissing/resolutionMissing plus the\n * governance flags reviewerMissing/riskMissing/confidenceMissing/sprintMissing/\n * releaseMissing) are ANDed together so callers can narrow precisely.\n * `metadataMissing` is ORed in as a union shortcut for \"missing any of the\n * core tracked fields\" (acceptance_criteria/estimated_minutes/resolution); it\n * deliberately excludes the governance fields so the long-standing flag keeps\n * its original meaning. When no filter is requested the item passes.\n */\nexport function itemMatchesMissingMetadata(\n  item: CoverageItem,\n  filters: MissingMetadataFilters,\n  classifier: LifecycleClassifier,\n): boolean {\n  if (!hasMissingMetadataFilter(filters)) {\n    return true;\n  }\n  if (!itemMatchesSpecificMetadataFilters(item, filters, classifier)) {\n    return false;\n  }\n  if (filters.metadataMissing && !itemMatchesCoreMetadataMissingUnion(item, classifier)) {\n    return false;\n  }\n  return true;\n}\n\n/** Filter a list of items by the requested missing-metadata predicates. */\nexport function filterMissingMetadata<T extends CoverageItem>(\n  items: readonly T[],\n  filters: MissingMetadataFilters,\n  classifier: LifecycleClassifier,\n): T[] {\n  if (!hasMissingMetadataFilter(filters)) {\n    return [...items];\n  }\n  return items.filter((item) => itemMatchesMissingMetadata(item, filters, classifier));\n}\n\n// ---------------------------------------------------------------------------\n// Metadata coverage percentages\n// ---------------------------------------------------------------------------\n\n/** Coverage-tracked metadata fields. */\nexport type CoverageField =\n  | \"acceptance_criteria\"\n  | \"estimated_minutes\"\n  | \"resolution\"\n  | \"tags\"\n  | \"parent\";\n\n/** Stable ordering of coverage fields for rendering. */\nexport const COVERAGE_FIELD_ORDER: readonly CoverageField[] = [\n  \"acceptance_criteria\",\n  \"estimated_minutes\",\n  \"resolution\",\n  \"tags\",\n  \"parent\",\n] as const;\n\n/** Coverage of a single field: present vs applicable, with a rounded percent. */\nexport interface FieldCoverage {\n  present: number;\n  /** Items for which the field is expected (all items, except resolution = terminal only). */\n  applicable: number;\n  /** present/applicable * 100, rounded to one decimal; 100 when applicable is 0. */\n  percent: number;\n}\n\n/**\n * Documents the metadata coverage report payload exchanged by command, SDK, and package integrations.\n */\nexport interface MetadataCoverageReport {\n  overall: Record<CoverageField, FieldCoverage>;\n  by_type: Record<string, Record<CoverageField, FieldCoverage>>;\n}\n\nfunction isFieldPresent(item: CoverageItem, field: CoverageField): boolean {\n  switch (field) {\n    case \"acceptance_criteria\":\n      return !isAcMissing(item);\n    case \"estimated_minutes\":\n      return !isEstimateMissing(item);\n    case \"resolution\":\n      return toNonEmptyStringOrUndefined(item.resolution) !== undefined;\n    case \"tags\":\n      return Array.isArray(item.tags) && item.tags.length > 0;\n    default:\n      return toNonEmptyStringOrUndefined(item.parent) !== undefined;\n  }\n}\n\n/** Whether a field applies to a given item (resolution only applies to terminal items). */\nfunction isFieldApplicable(item: CoverageItem, field: CoverageField, classifier: LifecycleClassifier): boolean {\n  if (field === \"resolution\") {\n    return classifier.isTerminal(item.status);\n  }\n  return true;\n}\n\nfunction roundPercent(present: number, applicable: number): number {\n  if (applicable === 0) {\n    return 100;\n  }\n  return Math.round((present / applicable) * 1000) / 10;\n}\n\nfunction emptyFieldCoverage(): Record<CoverageField, FieldCoverage> {\n  const record = {} as Record<CoverageField, FieldCoverage>;\n  for (const field of COVERAGE_FIELD_ORDER) {\n    record[field] = { present: 0, applicable: 0, percent: 100 };\n  }\n  return record;\n}\n\nfunction accumulateCoverage(\n  target: Record<CoverageField, FieldCoverage>,\n  item: CoverageItem,\n  classifier: LifecycleClassifier,\n): void {\n  for (const field of COVERAGE_FIELD_ORDER) {\n    if (!isFieldApplicable(item, field, classifier)) {\n      continue;\n    }\n    const entry = target[field];\n    entry.applicable += 1;\n    if (isFieldPresent(item, field)) {\n      entry.present += 1;\n    }\n  }\n}\n\nfunction finalizePercentages(record: Record<CoverageField, FieldCoverage>): void {\n  for (const field of COVERAGE_FIELD_ORDER) {\n    const entry = record[field];\n    entry.percent = roundPercent(entry.present, entry.applicable);\n  }\n}\n\n/**\n * Compute metadata coverage overall and per item type. For each tracked field\n * we report present/applicable counts and a rounded percentage. Resolution is\n * scoped to terminal items (its only applicable population).\n */\nexport function computeMetadataCoverage(\n  items: readonly CoverageItem[],\n  classifier: LifecycleClassifier,\n): MetadataCoverageReport {\n  const overall = emptyFieldCoverage();\n  const byType: Record<string, Record<CoverageField, FieldCoverage>> = {};\n  for (const item of items) {\n    accumulateCoverage(overall, item, classifier);\n    const typeRecord = byType[item.type] ?? (byType[item.type] = emptyFieldCoverage());\n    accumulateCoverage(typeRecord, item, classifier);\n  }\n  finalizePercentages(overall);\n  for (const typeRecord of Object.values(byType)) {\n    finalizePercentages(typeRecord);\n  }\n  return { overall, by_type: byType };\n}\n\n// ---------------------------------------------------------------------------\n// Grouped lifecycle breakdowns\n// ---------------------------------------------------------------------------\n\n/** Dimensions a breakdown can group by. */\nexport type GroupDimension = \"assignee\" | \"priority\" | \"tag\" | \"parent\" | \"type\" | \"status\";\n\n/** Explicit labels for empty/blank group keys, by dimension. */\nconst EMPTY_GROUP_LABELS: Record<GroupDimension, string> = {\n  assignee: \"(unassigned)\",\n  priority: \"(no priority)\",\n  tag: \"(untagged)\",\n  parent: \"(unparented)\",\n  type: \"(untyped)\",\n  status: \"(no status)\",\n};\n\n/** Explicit label for an empty/blank group value for a given dimension. */\nexport function emptyGroupLabel(dimension: GroupDimension): string {\n  return EMPTY_GROUP_LABELS[dimension];\n}\n\n/**\n * Documents the group row payload exchanged by command, SDK, and package integrations.\n */\nexport interface GroupRow {\n  /** Display label; explicit \"(unassigned)\"-style label for blank keys. */\n  label: string;\n  /** Stable structured key (null for the empty/blank group). */\n  key: string | null;\n  buckets: Record<LifecycleBucket, number>;\n  total: number;\n}\n\n/**\n * Documents the grouped breakdown payload exchanged by command, SDK, and package integrations.\n */\nexport interface GroupedBreakdown {\n  dimension: GroupDimension;\n  rows: GroupRow[];\n  /** Distinct items observed (an item can contribute to multiple tag rows). */\n  total_items: number;\n}\n\n/**\n * Documents the group options payload exchanged by command, SDK, and package integrations.\n */\nexport interface GroupOptions {\n  /** For dimension=\"tag\": only consider tags starting with this prefix. */\n  tagPrefix?: string;\n}\n\nfunction emptyBuckets(): Record<LifecycleBucket, number> {\n  return {\n    open: 0,\n    in_progress: 0,\n    blocked: 0,\n    draft: 0,\n    closed: 0,\n    canceled: 0,\n    other: 0,\n  };\n}\n\n/**\n * Resolve the group keys an item belongs to for a dimension. Most dimensions\n * yield exactly one key (possibly null for blank); tag yields one key per\n * matching tag (or [null] when none match), so an item can span multiple rows.\n */\nfunction groupKeysForItem(item: CoverageItem, dimension: GroupDimension, options: GroupOptions): (string | null)[] {\n  switch (dimension) {\n    case \"assignee\":\n      return [toNonEmptyStringOrUndefined(item.assignee) ?? null];\n    case \"parent\":\n      return [toNonEmptyStringOrUndefined(item.parent) ?? null];\n    case \"type\":\n      return [toNonEmptyStringOrUndefined(item.type) ?? null];\n    case \"status\":\n      return [toNonEmptyStringOrUndefined(item.status) ?? null];\n    case \"priority\":\n      return [typeof item.priority === \"number\" ? `P${item.priority}` : null];\n    default: {\n      const prefix = options.tagPrefix?.trim();\n      const tags = Array.isArray(item.tags) ? item.tags : [];\n      const matching = tags.filter(\n        (tag) => typeof tag === \"string\" && tag.length > 0 && (!prefix || tag.startsWith(prefix)),\n      );\n      return matching.length > 0 ? matching : [null];\n    }\n  }\n}\n\n/**\n * Group items by a dimension into lifecycle-bucketed rows. Blank keys render\n * with an explicit \"(unassigned)\"-style label. Rows are sorted by total\n * descending, then label ascending, with the empty group sorted last on ties.\n */\nexport function groupItemsByDimension(\n  items: readonly CoverageItem[],\n  dimension: GroupDimension,\n  classifier: LifecycleClassifier,\n  options: GroupOptions = {},\n): GroupedBreakdown {\n  const rows = new Map<string, GroupRow>();\n  let totalItems = 0;\n  for (const item of items) {\n    totalItems += 1;\n    const bucket = classifier.classify(item.status);\n    for (const key of groupKeysForItem(item, dimension, options)) {\n      const mapKey = key ?? \"\u0000empty\";\n      let row = rows.get(mapKey);\n      if (!row) {\n        row = {\n          label: key ?? emptyGroupLabel(dimension),\n          key,\n          buckets: emptyBuckets(),\n          total: 0,\n        };\n        rows.set(mapKey, row);\n      }\n      row.buckets[bucket] += 1;\n      row.total += 1;\n    }\n  }\n  const sorted = [...rows.values()].sort((left, right) => {\n    if (right.total !== left.total) {\n      return right.total - left.total;\n    }\n    // All blank-key items collapse into a single row per dimension, so at most\n    // one row has key === null; it sorts last on ties.\n    if (left.key === null) {\n      return 1;\n    }\n    if (right.key === null) {\n      return -1;\n    }\n    return left.label.localeCompare(right.label);\n  });\n  return { dimension, rows: sorted, total_items: totalItems };\n}\n\n/** Lifecycle-bucket distribution across all items (for stats lifecycle section). */\nexport function computeLifecycleDistribution(\n  items: readonly CoverageItem[],\n  classifier: LifecycleClassifier,\n): Record<LifecycleBucket, number> {\n  const buckets = emptyBuckets();\n  for (const item of items) {\n    buckets[classifier.classify(item.status)] += 1;\n  }\n  return buckets;\n}\n"],"names":[],"mappings":";;;;;;;AA+EA,SAAS,gBAAgB,QAAgB,UAA4B;AACnE,QAAM,UAAU,OAAO,KAAI,EAAG,YAAW;AACzC,SAAO,SAAS,YAAY,IAAI,OAAO,KAAK;AAC9C;AAQM,SAAU,sCAAsC,UAA4B;AAChF,SAAO;IACL,WAAW,QAAc;AACvB,aAAO,SAAS,kBAAkB,IAAI,gBAAgB,QAAQ,QAAQ,CAAC;IACzE;IACA,SAAS,QAAc;AACrB,YAAM,KAAK,gBAAgB,QAAQ,QAAQ;AAC3C,UAAI,SAAS,2BAA2B,IAAI,EAAE,GAAG;AAC/C,eAAO;MACT;AACA,UAAI,SAAS,kBAAkB,IAAI,EAAE,GAAG;AACtC,eAAO;MACT;AACA,UAAI,SAAS,iBAAiB,IAAI,EAAE,GAAG;AACrC,eAAO;MACT;AACA,UAAI,SAAS,eAAe,IAAI,EAAE,GAAG;AACnC,eAAO;MACT;AACA,UAAI,OAAO,SAAS,aAAa;AAC/B,eAAO;MACT;AACA,UAAI,SAAS,gBAAgB,IAAI,EAAE,GAAG;AACpC,eAAO;MACT;AACA,aAAO;IACT;;AAEJ;AAOM,SAAU,YAAY,MAAkB;AAC5C,SAAO,4BAA4B,KAAK,mBAAmB,MAAM;AACnE;AAGM,SAAU,kBAAkB,MAAkB;AAClD,SAAO,CAAC,OAAO,SAAS,KAAK,iBAAiB;AAChD;AAOM,SAAU,oBAAoB,MAAoB,YAA+B;AACrF,MAAI,CAAC,WAAW,WAAW,KAAK,MAAM,GAAG;AACvC,WAAO;EACT;AACA,SAAO,4BAA4B,KAAK,UAAU,MAAM;AAC1D;AAGM,SAAU,kBAAkB,MAAkB;AAClD,SAAO,4BAA4B,KAAK,QAAQ,MAAM;AACxD;AAGM,SAAU,cAAc,MAAkB;AAC9C,SAAO,4BAA4B,KAAK,IAAI,MAAM;AACpD;AAOM,SAAU,oBAAoB,MAAkB;AACpD,MAAI,OAAO,KAAK,eAAe,UAAU;AACvC,WAAO,CAAC,OAAO,SAAS,KAAK,UAAU;EACzC;AACA,SAAO,4BAA4B,KAAK,UAAU,MAAM;AAC1D;AAGM,SAAU,gBAAgB,MAAkB;AAChD,SAAO,4BAA4B,KAAK,MAAM,MAAM;AACtD;AAGM,SAAU,iBAAiB,MAAkB;AACjD,SAAO,4BAA4B,KAAK,OAAO,MAAM;AACvD;AAiBM,SAAU,yBAAyB,SAA+B;AACtE,SAAO,QACL,QAAQ,aACN,QAAQ,oBACR,QAAQ,qBACR,QAAQ,mBACR,QAAQ,eACR,QAAQ,qBACR,QAAQ,iBACR,QAAQ,kBACR,QAAQ,eAAe;AAE7B;AAEA,SAAS,mCACP,MACA,SACA,YAA+B;AAE/B,QAAM,SAAgD;IACpD,CAAC,QAAQ,WAAW,YAAY,IAAI,CAAC;IACrC,CAAC,QAAQ,kBAAkB,kBAAkB,IAAI,CAAC;IAClD,CAAC,QAAQ,mBAAmB,oBAAoB,MAAM,UAAU,CAAC;IACjE,CAAC,QAAQ,iBAAiB,kBAAkB,IAAI,CAAC;IACjD,CAAC,QAAQ,aAAa,cAAc,IAAI,CAAC;IACzC,CAAC,QAAQ,mBAAmB,oBAAoB,IAAI,CAAC;IACrD,CAAC,QAAQ,eAAe,gBAAgB,IAAI,CAAC;IAC7C,CAAC,QAAQ,gBAAgB,iBAAiB,IAAI,CAAC;;AAEjD,SAAO,OAAO,MAAM,CAAC,CAAC,WAAW,OAAO,MAAM,cAAc,QAAQ,OAAO;AAC7E;AAEA,SAAS,oCAAoC,MAAoB,YAA+B;AAC9F,SAAO,YAAY,IAAI,KAAK,kBAAkB,IAAI,KAAK,oBAAoB,MAAM,UAAU;AAC7F;AAaM,SAAU,2BACd,MACA,SACA,YAA+B;AAE/B,MAAI,CAAC,yBAAyB,OAAO,GAAG;AACtC,WAAO;EACT;AACA,MAAI,CAAC,mCAAmC,MAAM,SAAS,UAAU,GAAG;AAClE,WAAO;EACT;AACA,MAAI,QAAQ,mBAAmB,CAAC,oCAAoC,MAAM,UAAU,GAAG;AACrF,WAAO;EACT;AACA,SAAO;AACT;AA2BO,IAAM,uBAAiD;EAC5D;EACA;EACA;EACA;EACA;;AAoBF,SAAS,eAAe,MAAoB,OAAoB;AAC9D,UAAQ,OAAO;IACb,KAAK;AACH,aAAO,CAAC,YAAY,IAAI;IAC1B,KAAK;AACH,aAAO,CAAC,kBAAkB,IAAI;IAChC,KAAK;AACH,aAAO,4BAA4B,KAAK,UAAU,MAAM;IAC1D,KAAK;AACH,aAAO,MAAM,QAAQ,KAAK,IAAI,KAAK,KAAK,KAAK,SAAS;IACxD;AACE,aAAO,4BAA4B,KAAK,MAAM,MAAM;EACxD;AACF;AAGA,SAAS,kBAAkB,MAAoB,OAAsB,YAA+B;AAClG,MAAI,UAAU,cAAc;AAC1B,WAAO,WAAW,WAAW,KAAK,MAAM;EAC1C;AACA,SAAO;AACT;AAEA,SAAS,aAAa,SAAiB,YAAkB;AACvD,MAAI,eAAe,GAAG;AACpB,WAAO;EACT;AACA,SAAO,KAAK,MAAO,UAAU,aAAc,GAAI,IAAI;AACrD;AAEA,SAAS,qBAAkB;AACzB,QAAM,SAAS,CAAA;AACf,aAAW,SAAS,sBAAsB;AACxC,WAAO,KAAK,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,IAAG;EAC3D;AACA,SAAO;AACT;AAEA,SAAS,mBACP,QACA,MACA,YAA+B;AAE/B,aAAW,SAAS,sBAAsB;AACxC,QAAI,CAAC,kBAAkB,MAAM,OAAO,UAAU,GAAG;AAC/C;IACF;AACA,UAAM,QAAQ,OAAO,KAAK;AAC1B,UAAM,cAAc;AACpB,QAAI,eAAe,MAAM,KAAK,GAAG;AAC/B,YAAM,WAAW;IACnB;EACF;AACF;AAEA,SAAS,oBAAoB,QAA4C;AACvE,aAAW,SAAS,sBAAsB;AACxC,UAAM,QAAQ,OAAO,KAAK;AAC1B,UAAM,UAAU,aAAa,MAAM,SAAS,MAAM,UAAU;EAC9D;AACF;AAOM,SAAU,wBACd,OACA,YAA+B;AAE/B,QAAM,UAAU,mBAAkB;AAClC,QAAM,SAA+D,CAAA;AACrE,aAAW,QAAQ,OAAO;AACxB,uBAAmB,SAAS,MAAM,UAAU;AAC5C,UAAM,aAAa,OAAO,KAAK,IAAI,MAAM,OAAO,KAAK,IAAI,IAAI,mBAAkB;AAC/E,uBAAmB,YAAY,MAAM,UAAU;EACjD;AACA,sBAAoB,OAAO;AAC3B,aAAW,cAAc,OAAO,OAAO,MAAM,GAAG;AAC9C,wBAAoB,UAAU;EAChC;AACA,SAAO,EAAE,SAAS,SAAS,OAAM;AACnC;AAUA,IAAM,qBAAqD;EACzD,UAAU;EACV,UAAU;EACV,KAAK;EACL,QAAQ;EACR,MAAM;EACN,QAAQ;;AAIJ,SAAU,gBAAgB,WAAyB;AACvD,SAAO,mBAAmB,SAAS;AACrC;AAgCA,SAAS,eAAY;AACnB,SAAO;IACL,MAAM;IACN,aAAa;IACb,SAAS;IACT,OAAO;IACP,QAAQ;IACR,UAAU;IACV,OAAO;;AAEX;AAOA,SAAS,iBAAiB,MAAoB,WAA2B,SAAqB;AAC5F,UAAQ,WAAW;IACjB,KAAK;AACH,aAAO,CAAC,4BAA4B,KAAK,QAAQ,KAAK,IAAI;IAC5D,KAAK;AACH,aAAO,CAAC,4BAA4B,KAAK,MAAM,KAAK,IAAI;IAC1D,KAAK;AACH,aAAO,CAAC,4BAA4B,KAAK,IAAI,KAAK,IAAI;IACxD,KAAK;AACH,aAAO,CAAC,4BAA4B,KAAK,MAAM,KAAK,IAAI;IAC1D,KAAK;AACH,aAAO,CAAC,OAAO,KAAK,aAAa,WAAW,IAAI,KAAK,QAAQ,KAAK,IAAI;IACxE,SAAS;AACP,YAAM,SAAS,QAAQ,WAAW,KAAI;AACtC,YAAM,OAAO,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,OAAO,CAAA;AACpD,YAAM,WAAW,KAAK,OACpB,CAAC,QAAQ,OAAO,QAAQ,YAAY,IAAI,SAAS,MAAM,CAAC,UAAU,IAAI,WAAW,MAAM,EAAE;AAE3F,aAAO,SAAS,SAAS,IAAI,WAAW,CAAC,IAAI;IAC/C;EACF;AACF;AAOM,SAAU,sBACd,OACA,WACA,YACA,UAAwB,CAAA,GAAE;AAE1B,QAAM,OAAO,oBAAI,IAAG;AACpB,MAAI,aAAa;AACjB,aAAW,QAAQ,OAAO;AACxB,kBAAc;AACd,UAAM,SAAS,WAAW,SAAS,KAAK,MAAM;AAC9C,eAAW,OAAO,iBAAiB,MAAM,WAAW,OAAO,GAAG;AAC5D,YAAM,SAAS,OAAO;AACtB,UAAI,MAAM,KAAK,IAAI,MAAM;AACzB,UAAI,CAAC,KAAK;AACR,cAAM;UACJ,OAAO,OAAO,gBAAgB,SAAS;UACvC;UACA,SAAS,aAAY;UACrB,OAAO;;AAET,aAAK,IAAI,QAAQ,GAAG;MACtB;AACA,UAAI,QAAQ,MAAM,KAAK;AACvB,UAAI,SAAS;IACf;EACF;AACA,QAAM,SAAS,CAAC,GAAG,KAAK,OAAM,CAAE,EAAE,KAAK,CAAC,MAAM,UAAS;AACrD,QAAI,MAAM,UAAU,KAAK,OAAO;AAC9B,aAAO,MAAM,QAAQ,KAAK;IAC5B;AAGA,QAAI,KAAK,QAAQ,MAAM;AACrB,aAAO;IACT;AACA,QAAI,MAAM,QAAQ,MAAM;AACtB,aAAO;IACT;AACA,WAAO,KAAK,MAAM,cAAc,MAAM,KAAK;EAC7C,CAAC;AACD,SAAO,EAAE,WAAW,MAAM,QAAQ,aAAa,WAAU;AAC3D","debugId":"1f86aff5-7cfc-566c-8c4b-af6365719945"}

package/dist/cli-bundle/chunks/{chunk-4A3BJ675.js → chunk-QNNQAAZ5.js}

@@ -1,15 +1,15 @@
 
-!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]="bbea8d94-04ff-5f5e-9dde-660e98ee0b8c")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7df0fcc5-8ff4-5817-b72d-925ba746d847")}catch(e){}}();
 import {
   resolveSubcommandFlagContractsForCommand
-} from "./chunk-HXTQJXWT.js";
+} from "./chunk-572FKBRL.js";
 import {
   EXIT_CODE,
   PmCliError,
   isPathWithinDirectory,
   levenshteinDistanceWithinLimit,
   pathExists
-} from "./chunk-7R4QEMZZ.js";
+} from "./chunk-L4SLHV6G.js";
 
 // dist/cli/bootstrap-args.js
 function parseBootstrapPathToken(token, next) {
@@ -703,6 +703,21 @@ function normalizeManagedDirectoryName(name) {
   }
   return normalized;
 }
+function parseOptionalManifestPriority(value) {
+  if (value === void 0 || value === null) {
+    return DEFAULT_EXTENSION_PRIORITY;
+  }
+  return typeof value === "number" && Number.isInteger(value) ? value : null;
+}
+function parseOptionalManifestCapabilities(value) {
+  if (value === void 0 || value === null) {
+    return [];
+  }
+  if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) {
+    return null;
+  }
+  return normalizeStringList(value.map((entry) => String(entry).toLowerCase()));
+}
 function parseExtensionManifest(raw) {
   if (typeof raw !== "object" || raw === null) {
     return null;
@@ -717,19 +732,10 @@ function parseExtensionManifest(raw) {
   if (typeof candidate.entry !== "string" || candidate.entry.trim().length === 0) {
     return null;
   }
-  let priority = DEFAULT_EXTENSION_PRIORITY;
-  if (candidate.priority !== void 0 && candidate.priority !== null) {
-    if (typeof candidate.priority !== "number" || !Number.isInteger(candidate.priority)) {
-      return null;
-    }
-    priority = candidate.priority;
-  }
-  let capabilities = [];
-  if (candidate.capabilities !== void 0 && candidate.capabilities !== null) {
-    if (!Array.isArray(candidate.capabilities) || candidate.capabilities.some((value) => typeof value !== "string")) {
-      return null;
-    }
-    capabilities = normalizeStringList(candidate.capabilities.map((value) => String(value).toLowerCase()));
+  const priority = parseOptionalManifestPriority(candidate.priority);
+  const capabilities = parseOptionalManifestCapabilities(candidate.capabilities);
+  if (priority === null || capabilities === null) {
+    return null;
   }
   return {
     name: candidate.name.trim(),
@@ -794,6 +800,6 @@ export {
   parseExtensionManifest,
   validateExtensionDirectory
 };
-//# sourceMappingURL=chunk-4A3BJ675.js.map
+//# sourceMappingURL=chunk-QNNQAAZ5.js.map
 
-//# debugId=bbea8d94-04ff-5f5e-9dde-660e98ee0b8c
+//# debugId=7df0fcc5-8ff4-5817-b72d-925ba746d847

package/dist/cli-bundle/chunks/{chunk-4A3BJ675.js.map → chunk-QNNQAAZ5.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../cli/bootstrap-args.ts","../../../../../../../../cli/commands/extension/shared.ts"],"sourcesContent":["/**\n * @module cli/bootstrap-args\n *\n * Provides CLI runtime support for Bootstrap Args.\n */\nimport { resolveSubcommandFlagContractsForCommand, type CliFlagContract } from \"../sdk/cli-contracts.js\";\nimport { levenshteinDistanceWithinLimit } from \"../core/shared/levenshtein.js\";\n\nfunction parseBootstrapPathToken(\n  token: string,\n  next: string | undefined,\n): { consumed: number; pathValue?: string; preferred: boolean } | null {\n  if (token === \"--path\" || token === \"--pm-path\") {\n    if (typeof next === \"string\" && next.length > 0) {\n      return {\n        consumed: 2,\n        pathValue: next,\n        preferred: token === \"--pm-path\",\n      };\n    }\n    return {\n      consumed: 1,\n      preferred: token === \"--pm-path\",\n    };\n  }\n\n  const inlinePrefix = token.startsWith(\"--path=\")\n    ? \"--path=\"\n    : token.startsWith(\"--pm-path=\")\n      ? \"--pm-path=\"\n      : undefined;\n  if (!inlinePrefix) {\n    return null;\n  }\n\n  const value = token.slice(inlinePrefix.length);\n  if (value.length > 0) {\n    return {\n      consumed: 1,\n      pathValue: value,\n      preferred: inlinePrefix === \"--pm-path=\",\n    };\n  }\n  return {\n    consumed: 1,\n    preferred: inlinePrefix === \"--pm-path=\",\n  };\n}\n\n/**\n * Documents the bootstrap global options payload exchanged by command, SDK, and package integrations.\n */\nexport interface BootstrapGlobalOptions {\n  path?: string;\n  noExtensions: boolean;\n  noPager: boolean;\n  json: boolean;\n  quiet: boolean;\n}\n\n/**\n * Implements parse bootstrap global options for the public runtime surface of this module.\n */\nexport function parseBootstrapGlobalOptions(argv: string[]): BootstrapGlobalOptions {\n  let legacyPathValue: string | undefined;\n  let pmPathValue: string | undefined;\n  let noExtensions = false;\n  let noPager = false;\n  let json = false;\n  let quiet = false;\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (token === \"--no-extensions\") {\n      noExtensions = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--no-pager\") {\n      noPager = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--json\") {\n      json = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--quiet\") {\n      quiet = true;\n      index += 1;\n      continue;\n    }\n    const parsedPath = parseBootstrapPathToken(token, argv[index + 1]);\n    if (parsedPath) {\n      if (parsedPath.pathValue !== undefined) {\n        if (parsedPath.preferred) {\n          pmPathValue = parsedPath.pathValue;\n        } else {\n          legacyPathValue = parsedPath.pathValue;\n        }\n      }\n      index += parsedPath.consumed;\n      continue;\n    }\n    index += 1;\n  }\n  return {\n    path: pmPathValue ?? legacyPathValue,\n    noExtensions,\n    noPager,\n    json,\n    quiet,\n  };\n}\n\n/**\n * Implements strip global bootstrap tokens for the public runtime surface of this module.\n */\nexport function stripGlobalBootstrapTokens(argv: string[]): string[] {\n  const remaining: string[] = [];\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (\n      token === \"--json\" ||\n      token === \"--quiet\" ||\n      token === \"--no-extensions\" ||\n      token === \"--no-pager\" ||\n      token === \"--profile\" ||\n      token === \"--id-only\" ||\n      token === \"--explain\"\n    ) {\n      index += 1;\n      continue;\n    }\n    if (token === \"--path\" || token === \"--pm-path\") {\n      index += 2;\n      continue;\n    }\n    if (token.startsWith(\"--path=\") || token.startsWith(\"--pm-path=\")) {\n      index += 1;\n      continue;\n    }\n    remaining.push(token);\n    index += 1;\n  }\n  return remaining;\n}\n\n/**\n * Documents the bootstrap help request payload exchanged by command, SDK, and package integrations.\n */\nexport interface BootstrapHelpRequest {\n  requested: boolean;\n  commandPathTokens: string[];\n}\n\n/**\n * Implements parse bootstrap help request for the public runtime surface of this module.\n */\nexport function parseBootstrapHelpRequest(argv: string[]): BootstrapHelpRequest {\n  const stripped = stripGlobalBootstrapTokens(argv);\n  const first = stripped[0]?.trim().toLowerCase();\n  if (first === \"help\") {\n    const commandPathTokens: string[] = [];\n    for (let index = 1; index < stripped.length; index += 1) {\n      const token = stripped[index];\n      if (token.startsWith(\"-\")) {\n        break;\n      }\n      commandPathTokens.push(token.trim().toLowerCase());\n    }\n    return {\n      requested: true,\n      commandPathTokens,\n    };\n  }\n\n  const helpFlagIndex = stripped.findIndex((token) => token === \"--help\" || token === \"-h\");\n  if (helpFlagIndex < 0) {\n    return {\n      requested: false,\n      commandPathTokens: [],\n    };\n  }\n\n  const commandPathTokens: string[] = [];\n  for (const token of stripped) {\n    if (token.startsWith(\"-\")) {\n      break;\n    }\n    commandPathTokens.push(token.trim().toLowerCase());\n  }\n  return {\n    requested: true,\n    commandPathTokens,\n  };\n}\n\n/**\n * Index of the command token in argv — the first non-flag token, skipping the\n * value-consuming/global bootstrap flags. Returns undefined when there is none\n * (bare invocation, only global flags, or a leading `--`). Single source of truth\n * for command-position scanning shared by {@link parseBootstrapCommandName} and the\n * command-alias rewrite so their precedence rules can never drift apart.\n */\nfunction findCommandTokenIndex(argv: string[]): number | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--\") {\n      return undefined;\n    }\n    if (token === \"--path\" || token === \"--pm-path\") {\n      index += 1;\n      continue;\n    }\n    if (\n      token.startsWith(\"--path=\") ||\n      token.startsWith(\"--pm-path=\") ||\n      token === \"--json\" ||\n      token === \"--quiet\" ||\n      token === \"--no-extensions\" ||\n      token === \"--no-pager\" ||\n      token === \"--profile\" ||\n      token === \"--id-only\" ||\n      token === \"--explain\"\n    ) {\n      continue;\n    }\n    if (token.startsWith(\"-\")) {\n      continue;\n    }\n    return index;\n  }\n  return undefined;\n}\n\n/**\n * Implements parse bootstrap command name for the public runtime surface of this module.\n */\nexport function parseBootstrapCommandName(argv: string[]): string | undefined {\n  const index = findCommandTokenIndex(argv);\n  return index === undefined ? undefined : argv[index].trim().toLowerCase();\n}\n\nfunction shouldDisablePagerForInvocation(argv: string[], bootstrapGlobal: BootstrapGlobalOptions): boolean {\n  if (bootstrapGlobal.noPager) {\n    return true;\n  }\n  if (process.stdout.isTTY === true) {\n    return false;\n  }\n  const helpRequest = parseBootstrapHelpRequest(argv);\n  return helpRequest.requested;\n}\n\n/**\n * Implements apply bootstrap pager policy for the public runtime surface of this module.\n */\nexport function applyBootstrapPagerPolicy(argv: string[]): void {\n  const bootstrapGlobal = parseBootstrapGlobalOptions(argv);\n  if (!shouldDisablePagerForInvocation(argv, bootstrapGlobal)) {\n    return;\n  }\n  process.env.PAGER = \"cat\";\n  process.env.MANPAGER = \"cat\";\n  process.env.GIT_PAGER = \"cat\";\n  if (typeof process.env.LESS !== \"string\" || process.env.LESS.trim().length === 0) {\n    process.env.LESS = \"FRX\";\n  }\n}\n\ntype ExtensionSubcommandAction =\n  | \"init\"\n  | \"install\"\n  | \"uninstall\"\n  | \"explore\"\n  | \"manage\"\n  | \"doctor\"\n  | \"adopt\"\n  | \"adopt-all\"\n  | \"activate\"\n  | \"deactivate\";\n\nconst EXTENSION_ACTION_SYNTAX_TOKENS = new Set<ExtensionSubcommandAction>([\n  \"install\",\n  \"uninstall\",\n  \"explore\",\n  \"manage\",\n  \"doctor\",\n  \"adopt\",\n  \"adopt-all\",\n  \"activate\",\n  \"deactivate\",\n]);\n\n/**\n * Implements normalize legacy extension action syntax for the public runtime surface of this module.\n */\nexport function normalizeLegacyExtensionActionSyntax(argv: string[]): string[] {\n  const extensionIndex = argv.findIndex((token) => token === \"extension\");\n  if (extensionIndex < 0) {\n    return [...argv];\n  }\n  const actionToken = argv[extensionIndex + 1];\n  if (!actionToken || actionToken.startsWith(\"-\")) {\n    return [...argv];\n  }\n  if (!EXTENSION_ACTION_SYNTAX_TOKENS.has(actionToken as ExtensionSubcommandAction)) {\n    return [...argv];\n  }\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    return [...argv];\n  }\n  const forcedActionFlag = `--${actionToken}`;\n  if (argv.includes(forcedActionFlag)) {\n    return [...argv];\n  }\n  return [...argv.slice(0, extensionIndex + 1), forcedActionFlag, ...argv.slice(extensionIndex + 2)];\n}\n\ntype BootstrapNormalizationReason =\n  | \"legacy_extension_action\"\n  | \"command_alias\"\n  | \"flag_alias\"\n  | \"flag_typo\"\n  | \"bare_key_value\"\n  | \"list_merge\";\ntype BootstrapNormalizationConfidence = \"high\" | \"medium\";\n\n/**\n * Executable command aliases: a leading command token here is rewritten to its\n * canonical command BEFORE commander parses, so the alias actually runs instead of\n * merely being suggested. These are the highest-frequency aliases real agents type\n * (telemetry: `pm show <id>` alone is the single most common unknown-command) and\n * each target takes the same positional/flags as the alias (with `--comment`/\n * `--note`/`--learning` flag-aliased to `--add` on the target command). Keeping this\n * in one place means the alias is consistent across registration, commander dispatch,\n * telemetry, and error handling — all of which read the normalized argv.\n */\nexport const EXECUTABLE_COMMAND_ALIASES: Readonly<Record<string, string>> = {\n  show: \"get\",\n  view: \"get\",\n  comment: \"comments\",\n  note: \"notes\",\n  learning: \"learnings\",\n};\n\n/**\n * Rewrite a leading command-alias token (e.g. `show` -> `get`) in place. Only the\n * command position is considered — the same token appearing later as an argument\n * (`pm get show`) is left untouched — and only when it is not preceded by `--` or a\n * value-consuming global flag, mirroring {@link parseBootstrapCommandName}.\n */\nfunction rewriteCommandAlias(argv: string[], trace: BootstrapNormalizationEvent[]): string[] {\n  const index = findCommandTokenIndex(argv);\n  if (index === undefined) {\n    return argv;\n  }\n  const token = argv[index];\n  const canonical = EXECUTABLE_COMMAND_ALIASES[token.trim().toLowerCase()];\n  if (!canonical) {\n    return argv;\n  }\n  const rewritten = [...argv];\n  rewritten[index] = canonical;\n  trace.push({ from: token, to: [canonical], reason: \"command_alias\", confidence: \"high\" });\n  return rewritten;\n}\n\n/**\n * Documents the bootstrap normalization event payload exchanged by command, SDK, and package integrations.\n */\nexport interface BootstrapNormalizationEvent {\n  from: string;\n  to: string[];\n  reason: BootstrapNormalizationReason;\n  confidence: BootstrapNormalizationConfidence;\n}\n\n/**\n * Documents the bootstrap invocation normalization result payload exchanged by command, SDK, and package integrations.\n */\nexport interface BootstrapInvocationNormalizationResult {\n  argv: string[];\n  commandName: string | undefined;\n  trace: BootstrapNormalizationEvent[];\n}\n\ninterface FlagLookup {\n  canonicalByNormalized: Map<string, string | null>;\n  canonicalByCompact: Map<string, string | null>;\n  canonicalComparables: Array<{ canonicalFlag: string; comparable: string }>;\n  listCanonicalFlags: Set<string>;\n}\n\nfunction normalizeFlagKeyToken(raw: string): string {\n  const withoutPrefix = raw.replace(/^--?/, \"\");\n  return withoutPrefix\n    .replace(/_/g, \"-\")\n    .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\nfunction toComparableFlagKey(raw: string): string {\n  return normalizeFlagKeyToken(raw).replace(/-/g, \"\");\n}\n\nfunction markUnambiguousFlag(\n  map: Map<string, string | null>,\n  key: string,\n  canonicalFlag: string,\n): void {\n  const existing = map.get(key);\n  if (existing === undefined) {\n    map.set(key, canonicalFlag);\n    return;\n  }\n  if (existing !== canonicalFlag) {\n    map.set(key, null);\n  }\n}\n\nfunction collectLongFlagCandidates(contract: CliFlagContract): string[] {\n  const candidates: string[] = [];\n  const pushLongFlag = (value: string | undefined): void => {\n    if (typeof value !== \"string\") {\n      return;\n    }\n    if (!value.startsWith(\"--\")) {\n      return;\n    }\n    candidates.push(value);\n  };\n  pushLongFlag(contract.flag);\n  for (const alias of contract.aliases ?? []) {\n    pushLongFlag(alias);\n  }\n  return candidates;\n}\n\nfunction buildFlagLookup(\n  commandName: string | undefined,\n  contractsOverride?: CliFlagContract[],\n): FlagLookup {\n  const contracts = contractsOverride ?? resolveSubcommandFlagContractsForCommand(commandName);\n  const canonicalByNormalized = new Map<string, string | null>();\n  const canonicalByCompact = new Map<string, string | null>();\n  const canonicalComparablesMap = new Map<string, string>();\n  const listCanonicalFlags = new Set<string>();\n  for (const contract of contracts) {\n    const longCandidates = collectLongFlagCandidates(contract);\n    if (longCandidates.length === 0) {\n      continue;\n    }\n    const canonicalFlag = `--${normalizeFlagKeyToken(longCandidates[0])}`;\n    for (const candidate of longCandidates) {\n      markUnambiguousFlag(canonicalByNormalized, normalizeFlagKeyToken(candidate), canonicalFlag);\n      markUnambiguousFlag(canonicalByCompact, toComparableFlagKey(candidate), canonicalFlag);\n    }\n    const comparable = toComparableFlagKey(canonicalFlag);\n    if (!canonicalComparablesMap.has(canonicalFlag)) {\n      canonicalComparablesMap.set(canonicalFlag, comparable);\n    }\n    if (contract.list === true) {\n      listCanonicalFlags.add(canonicalFlag);\n    }\n  }\n  return {\n    canonicalByNormalized,\n    canonicalByCompact,\n    canonicalComparables: [...canonicalComparablesMap.entries()].map(([canonicalFlag, comparable]) => ({\n      canonicalFlag,\n      comparable,\n    })),\n    listCanonicalFlags,\n  };\n}\n\nfunction resolveCanonicalFlag(\n  rawKey: string,\n  lookup: FlagLookup,\n): { flag: string; reason: \"flag_alias\" | \"flag_typo\"; confidence: BootstrapNormalizationConfidence } | null {\n  const normalizedKey = normalizeFlagKeyToken(rawKey);\n  const direct = lookup.canonicalByNormalized.get(normalizedKey);\n  if (typeof direct === \"string\") {\n    return {\n      flag: direct,\n      reason: \"flag_alias\",\n      confidence: \"high\",\n    };\n  }\n  const comparableKey = normalizedKey.replace(/-/g, \"\");\n  const compactMatch = lookup.canonicalByCompact.get(comparableKey);\n  if (typeof compactMatch === \"string\") {\n    return {\n      flag: compactMatch,\n      reason: \"flag_alias\",\n      confidence: \"high\",\n    };\n  }\n  const maxDistance = comparableKey.length >= 8 ? 2 : 1;\n  let bestDistance = Number.POSITIVE_INFINITY;\n  let bestFlag: string | undefined;\n  let tied = false;\n  for (const candidate of lookup.canonicalComparables) {\n    const distance = levenshteinDistanceWithinLimit(comparableKey, candidate.comparable, maxDistance);\n    if (distance === null) {\n      continue;\n    }\n    if (distance < bestDistance) {\n      bestDistance = distance;\n      bestFlag = candidate.canonicalFlag;\n      tied = false;\n      continue;\n    }\n    if (distance === bestDistance && bestFlag !== candidate.canonicalFlag) {\n      tied = true;\n    }\n  }\n  if (!bestFlag || tied || !Number.isFinite(bestDistance) || bestDistance <= 0) {\n    return null;\n  }\n  return {\n    flag: bestFlag,\n    reason: \"flag_typo\",\n    confidence: bestDistance >= 2 ? \"medium\" : \"high\",\n  };\n}\n\n/**\n * Implements list alias plural keys for the public runtime surface of this module.\n */\nexport function listAliasPluralKeys(normalizedKey: string): string[] {\n  const candidates = [`${normalizedKey}s`];\n  if (normalizedKey.endsWith(\"y\") && normalizedKey.length > 1) {\n    candidates.push(`${normalizedKey.slice(0, -1)}ies`);\n  }\n  return candidates;\n}\n\nfunction parseBareKeyValueToken(token: string): { key: string; value: string } | null {\n  if (token.includes(\"://\")) {\n    return null;\n  }\n  const match = token.match(/^([A-Za-z][A-Za-z0-9_-]{1,63})([:=])(.*)$/);\n  if (!match) {\n    return null;\n  }\n  const key = match[1];\n  const value = match[3];\n  if (value.length === 0) {\n    return null;\n  }\n  return {\n    key,\n    value,\n  };\n}\n\nfunction normalizeLongOptionToken(\n  token: string,\n  lookup: FlagLookup,\n): { tokens: string[]; event?: BootstrapNormalizationEvent } {\n  if (!token.startsWith(\"--\")) {\n    return { tokens: [token] };\n  }\n  const equalsIndex = token.indexOf(\"=\");\n  const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;\n  const inlineValue = equalsIndex >= 0 ? token.slice(equalsIndex + 1) : undefined;\n  const resolution = resolveCanonicalFlag(key, lookup);\n  if (!resolution) {\n    return { tokens: [token] };\n  }\n  const normalizedToken = inlineValue === undefined ? resolution.flag : `${resolution.flag}=${inlineValue}`;\n  if (normalizedToken === token) {\n    return { tokens: [token] };\n  }\n  return {\n    tokens: [normalizedToken],\n    event: {\n      from: token,\n      to: [normalizedToken],\n      reason: resolution.reason,\n      confidence: resolution.confidence,\n    },\n  };\n}\n\n// Global option flags whose value may legitimately begin with \"--\" (commander\n// accepts such values). Their value token must not be reinterpreted as a list\n// flag during coalescing. `--pm-path <dir>` and its legacy `--path <dir>`\n// alias are the documented cases; other globals\n// (--json/--quiet/--no-extensions/--no-pager/--profile) are boolean.\nconst GLOBAL_VALUE_CONSUMING_FLAGS = new Set<string>([\"--pm-path\", \"--path\"]);\n\nfunction splitCanonicalListToken(token: string): { flag: string; inlineValue?: string } | null {\n  if (!token.startsWith(\"--\")) {\n    return null;\n  }\n  const equalsIndex = token.indexOf(\"=\");\n  if (equalsIndex < 0) {\n    return { flag: token };\n  }\n  return {\n    flag: token.slice(0, equalsIndex),\n    inlineValue: token.slice(equalsIndex + 1),\n  };\n}\n\ninterface ListFlagSlot {\n  outputIndex: number;\n  originalTokens: string[];\n  values: string[];\n  occurrences: number;\n}\n\ninterface ListFlagOccurrence {\n  originalTokens: string[];\n  value: string | undefined;\n  consumed: number;\n}\n\ninterface ValuedListFlagOccurrence {\n  originalTokens: string[];\n  value: string;\n}\n\nfunction copyValueConsumingFlag(argv: string[], index: number, result: (string | null)[]): number {\n  result.push(argv[index]);\n  const next = argv[index + 1];\n  if (typeof next === \"string\" && next !== \"--\") {\n    result.push(next);\n    return index + 2;\n  }\n  return index + 1;\n}\n\nfunction readListFlagOccurrence(\n  argv: string[],\n  index: number,\n  parsed: { flag: string; inlineValue?: string },\n  multiValueListFlags: Set<string>,\n): ListFlagOccurrence {\n  if (parsed.inlineValue !== undefined) {\n    return {\n      originalTokens: [argv[index]],\n      value: parsed.inlineValue,\n      consumed: 1,\n    };\n  }\n\n  const values: string[] = [];\n  let valueIndex = index + 1;\n  while (\n    valueIndex < argv.length &&\n    argv[valueIndex] !== \"--\" &&\n    !argv[valueIndex].startsWith(\"-\") &&\n    (values.length === 0 || multiValueListFlags.has(parsed.flag))\n  ) {\n    values.push(argv[valueIndex]);\n    valueIndex += 1;\n  }\n\n  const consumed = values.length === 0 ? 1 : 1 + values.length;\n  return {\n    originalTokens: argv.slice(index, index + consumed),\n    value: values.length === 0 ? undefined : values.join(\",\"),\n    consumed,\n  };\n}\n\nfunction recordListFlagOccurrence(\n  slots: Map<string, ListFlagSlot>,\n  result: (string | null)[],\n  flag: string,\n  occurrence: ValuedListFlagOccurrence,\n): void {\n  const existing = slots.get(flag);\n  if (existing) {\n    existing.values.push(occurrence.value);\n    existing.occurrences += 1;\n    return;\n  }\n\n  slots.set(flag, {\n    outputIndex: result.length,\n    originalTokens: occurrence.originalTokens,\n    values: [occurrence.value],\n    occurrences: 1,\n  });\n  // Reserve the anchor position; finalized after the walk so we know the full\n  // merged value or can restore the original token form for single uses.\n  result.push(null);\n}\n\nfunction buildListFlagCoalescingSplices(\n  slots: Map<string, ListFlagSlot>,\n  multiValueListFlags: Set<string>,\n): {\n  events: BootstrapNormalizationEvent[];\n  splices: Array<{ outputIndex: number; tokens: string[] }>;\n} {\n  const events: BootstrapNormalizationEvent[] = [];\n  const splices: Array<{ outputIndex: number; tokens: string[] }> = [];\n  for (const [flag, slot] of slots) {\n    const shouldMerge = slot.occurrences >= 2 || (multiValueListFlags.has(flag) && slot.originalTokens.length > 2);\n    if (!shouldMerge) {\n      splices.push({ outputIndex: slot.outputIndex, tokens: slot.originalTokens });\n      continue;\n    }\n    const mergedToken = `${flag}=${slot.values.join(\",\")}`;\n    splices.push({ outputIndex: slot.outputIndex, tokens: [mergedToken] });\n    events.push({\n      from: `${flag} (x${slot.occurrences})`,\n      to: [mergedToken],\n      reason: \"list_merge\",\n      confidence: \"high\",\n    });\n  }\n  return { events, splices };\n}\n\nfunction applyListFlagSplices(result: (string | null)[], splices: Array<{ outputIndex: number; tokens: string[] }>): void {\n  splices.sort((a, b) => b.outputIndex - a.outputIndex);\n  for (const splice of splices) {\n    result.splice(splice.outputIndex, 1, ...splice.tokens);\n  }\n}\n\n/**\n * Coalesce repeated occurrences of comma-separated list flags into a single\n * `--flag=v1,v2,v3` token anchored at the FIRST occurrence. Without this,\n * Commander treats these flags as scalars and silently keeps only the last\n * value (data loss). Both `--flag value` and `--flag=value` forms are merged;\n * a value-less occurrence is preserved untouched, and a `--` terminator stops\n * coalescing (remainder is passed through verbatim).\n *\n * `valueConsumingFlags` lists option flags (e.g. global `--path`) whose value\n * may itself begin with `--`. Their value token is emitted verbatim so a\n * list-flag-looking value (`--path --tags`) is never reinterpreted as a flag\n * nor allowed to swallow the following command/positional token.\n */\nexport function coalesceRepeatedListFlags(\n  argv: string[],\n  listFlags: Set<string>,\n  valueConsumingFlags: Set<string> = new Set(),\n  multiValueListFlags: Set<string> = new Set(),\n): { argv: string[]; events: BootstrapNormalizationEvent[] } {\n  if (listFlags.size === 0) {\n    return { argv: [...argv], events: [] };\n  }\n\n  const result: (string | null)[] = [];\n  const slots = new Map<string, ListFlagSlot>();\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      result.push(...argv.slice(index));\n      break;\n    }\n    // A value-consuming option in space form owns the next token as its value,\n    // even when that value begins with \"--\". Emit both verbatim so the value is\n    // never misread as a list-flag occurrence.\n    if (valueConsumingFlags.has(token)) {\n      index = copyValueConsumingFlag(argv, index, result);\n      continue;\n    }\n    const parsed = splitCanonicalListToken(token);\n    if (!parsed || !listFlags.has(parsed.flag)) {\n      result.push(token);\n      index += 1;\n      continue;\n    }\n\n    const occurrence = readListFlagOccurrence(argv, index, parsed, multiValueListFlags);\n    if (occurrence.value === undefined) {\n      // Value-less occurrence: leave untouched, do not coalesce.\n      result.push(token);\n      index += occurrence.consumed;\n      continue;\n    }\n\n    recordListFlagOccurrence(slots, result, parsed.flag, {\n      originalTokens: occurrence.originalTokens,\n      value: occurrence.value,\n    });\n    index += occurrence.consumed;\n  }\n\n  // Apply anchor splices from the end so earlier indices stay valid when a\n  // single-occurrence anchor expands back into two tokens.\n  const { events, splices } = buildListFlagCoalescingSplices(slots, multiValueListFlags);\n  applyListFlagSplices(result, splices);\n\n  return { argv: result as string[], events };\n}\n\n/**\n * Linked-test entry keys accepted in the two-token form `pm test <id> --add command\n * \"npm test -- parser\"` (GH-191). Only entry-identity keys are merged: `command`/`cmd`\n * name the shell command and `path` names the test file, so a single key=value entry is\n * meaningful for them. Other structured keys (scope, env_set, assertions, ...) cannot\n * form a valid standalone entry and are left for the normal parser to reject. `--remove`\n * matches existing entries by `command=`/`path=` only, so `cmd` is excluded there.\n * Key names mirror STRUCTURED_LINKED_TEST_KEYS in src/cli/commands/linked-test-entry.ts.\n */\nconst LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG: ReadonlyMap<string, ReadonlySet<string>> = new Map([\n  [\"--add\", new Set([\"command\", \"cmd\", \"path\"])],\n  [\"--remove\", new Set([\"command\", \"path\"])],\n]);\n\n/**\n * Sandbox-safe linked-test commands legitimately start with env assignments\n * (`PM_PATH=... PM_GLOBAL_PATH=... vitest run -- parser`), which look like bare\n * key=value settings tokens. When the two preceding tokens are a linked-test\n * flag plus a bare two-token key (`--add command <value>`), the value must be\n * left intact for mergeLinkedTestTwoTokenEntries instead of being rewritten\n * into a canonical flag (e.g. PM_PATH= -> --pm-path), which would silently\n * corrupt the command into `--add command --pm-path ...`.\n */\nfunction isLinkedTestTwoTokenValuePosition(commandName: string | undefined, emittedTokens: readonly string[]): boolean {\n  if (commandName !== \"test\" || emittedTokens.length < 2) {\n    return false;\n  }\n  const key = emittedTokens[emittedTokens.length - 1];\n  const flag = emittedTokens[emittedTokens.length - 2];\n  const keys = LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(flag);\n  return keys !== undefined && keys.has(key);\n}\n\n/**\n * Accept the two-token linked-test form `pm test <id> --add command \"npm test -- parser\"`\n * by merging the bare key token and its single quoted value into the documented\n * `--add command=...` shape. Without this merge Commander binds the bare key as the\n * option value and treats the quoted command as an excess positional, failing with\n * \"too many arguments\" (GH-191). The merge only fires when EXACTLY ONE non-flag token\n * follows the bare key, i.e. the value was quoted into one shell token — an unquoted\n * multi-token value stays ambiguous (it may swallow the item id), still fails fast, and\n * is routed to targeted quoting guidance by the commander error classifier instead.\n */\nexport function mergeLinkedTestTwoTokenEntries(\n  argv: string[],\n  commandName: string | undefined,\n  trace: BootstrapNormalizationEvent[],\n): string[] {\n  if (commandName !== \"test\") {\n    return argv;\n  }\n  const result: string[] = [];\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      result.push(...argv.slice(index));\n      return result;\n    }\n    const keys = LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(token);\n    const key = keys ? argv[index + 1] : undefined;\n    if (!keys || typeof key !== \"string\" || !keys.has(key)) {\n      result.push(token);\n      index += 1;\n      continue;\n    }\n    let runEnd = index + 2;\n    while (runEnd < argv.length && !argv[runEnd].startsWith(\"-\")) {\n      runEnd += 1;\n    }\n    if (runEnd - (index + 2) !== 1) {\n      result.push(token);\n      index += 1;\n      continue;\n    }\n    const value = argv[index + 2];\n    const mergedValue = `${key}=${value}`;\n    result.push(token, mergedValue);\n    trace.push({\n      from: `${token} ${key} ${value}`,\n      to: [token, mergedValue],\n      reason: \"bare_key_value\",\n      confidence: \"high\",\n    });\n    index += 3;\n  }\n  return result;\n}\n\n/**\n * Implements normalize bootstrap invocation for the public runtime surface of this module.\n */\nexport function normalizeBootstrapInvocation(argv: string[]): BootstrapInvocationNormalizationResult {\n  const trace: BootstrapNormalizationEvent[] = [];\n  const legacyNormalized = normalizeLegacyExtensionActionSyntax(argv);\n  if (legacyNormalized.length !== argv.length || legacyNormalized.some((token, index) => token !== argv[index])) {\n    trace.push({\n      from: argv.join(\" \"),\n      to: [...legacyNormalized],\n      reason: \"legacy_extension_action\",\n      confidence: \"high\",\n    });\n  }\n  const aliasNormalized = rewriteCommandAlias(legacyNormalized, trace);\n  const commandName = parseBootstrapCommandName(aliasNormalized);\n  const commandPathName = parseBootstrapCommandPathName(aliasNormalized);\n  const lookup = buildFlagLookup(commandPathName ?? commandName);\n  const normalizedArgv: string[] = [];\n  for (let index = 0; index < aliasNormalized.length; index += 1) {\n    const token = aliasNormalized[index];\n    if (token === \"--\") {\n      normalizedArgv.push(...aliasNormalized.slice(index));\n      break;\n    }\n    const previous = normalizedArgv[normalizedArgv.length - 1];\n    if (token.startsWith(\"--\")) {\n      const normalizedToken = normalizeLongOptionToken(token, lookup);\n      normalizedArgv.push(...normalizedToken.tokens);\n      if (normalizedToken.event) {\n        trace.push(normalizedToken.event);\n      }\n      continue;\n    }\n    const bareKeyValue = parseBareKeyValueToken(token);\n    if (\n      bareKeyValue &&\n      !(typeof previous === \"string\" && previous.startsWith(\"-\")) &&\n      !isLinkedTestTwoTokenValuePosition(commandName, normalizedArgv)\n    ) {\n      const resolution = resolveCanonicalFlag(bareKeyValue.key, lookup);\n      if (resolution) {\n        const replacement = [resolution.flag, bareKeyValue.value];\n        normalizedArgv.push(...replacement);\n        trace.push({\n          from: token,\n          to: replacement,\n          reason: \"bare_key_value\",\n          confidence: resolution.confidence,\n        });\n        continue;\n      }\n    }\n    normalizedArgv.push(token);\n  }\n  const linkedTestNormalized = mergeLinkedTestTwoTokenEntries(normalizedArgv, commandName, trace);\n  const coalesced = coalesceRepeatedListFlags(\n    linkedTestNormalized,\n    lookup.listCanonicalFlags,\n    GLOBAL_VALUE_CONSUMING_FLAGS,\n    commandName === \"create\" ? new Set([\"--tags\"]) : new Set(),\n  );\n  for (const event of coalesced.events) {\n    trace.push(event);\n  }\n  return {\n    argv: coalesced.argv,\n    commandName,\n    trace,\n  };\n}\n\nfunction parseBootstrapCommandPathName(argv: string[]): string | undefined {\n  const stripped = stripGlobalBootstrapTokens(argv);\n  const first = stripped[0]?.trim().toLowerCase();\n  const second = stripped[1]?.trim().toLowerCase();\n  if (\n    (first === \"extension\" || first === \"package\" || first === \"packages\") &&\n    typeof second === \"string\" &&\n    second.length > 0 &&\n    !second.startsWith(\"-\")\n  ) {\n    return `${first} ${second}`;\n  }\n  return first;\n}\n\n/**\n * Implements parse bootstrap type value for the public runtime surface of this module.\n */\nexport function parseBootstrapTypeValue(argv: string[]): string | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--type\") {\n      const candidate = argv[index + 1];\n      if (typeof candidate === \"string\" && candidate.trim().length > 0) {\n        return candidate.trim();\n      }\n      continue;\n    }\n    if (token.startsWith(\"--type=\")) {\n      const candidate = token.slice(\"--type=\".length).trim();\n      if (candidate.length > 0) {\n        return candidate;\n      }\n    }\n  }\n  return undefined;\n}\n\nexport const _testOnly = {\n  buildFlagLookup,\n  collectLongFlagCandidates,\n  markUnambiguousFlag,\n  normalizeLongOptionToken,\n  resolveCanonicalFlag,\n};\n","/**\n * @module cli/commands/extension/shared\n *\n * Implements extension package-management support for Shared.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { isPathWithinDirectory } from \"../../../core/fs/path-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport type { ExtensionManifest } from \"../../../core/extensions/loader.js\";\n\nexport const DEFAULT_EXTENSION_PRIORITY = 100;\n\n/**\n * Documents the validated extension directory payload exchanged by command, SDK, and package integrations.\n */\nexport interface ValidatedExtensionDirectory {\n  directory: string;\n  manifest_path: string;\n  entry_path: string;\n  manifest: ExtensionManifest;\n}\n\n/**\n * Implements normalize string list for the public runtime surface of this module.\n */\nexport function normalizeStringList(values: readonly string[]): string[] {\n  return [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) =>\n    left.localeCompare(right),\n  );\n}\n\n/**\n * Implements normalize extension name for match for the public runtime surface of this module.\n */\nexport function normalizeExtensionNameForMatch(value: string): string {\n  return value.trim().toLowerCase();\n}\n\n/**\n * Implements normalize managed directory name for the public runtime surface of this module.\n */\nexport function normalizeManagedDirectoryName(name: string): string {\n  const normalized = name\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  if (normalized.length === 0) {\n    throw new PmCliError(\"Extension manifest name must resolve to a non-empty directory name.\", EXIT_CODE.USAGE);\n  }\n  if (normalized === \".\" || normalized === \"..\") {\n    // Manifest-controlled input must resolve to a dedicated child directory, never\n    // the extensions root itself or its parent (path-traversal guard).\n    throw new PmCliError(\"Extension manifest name must not resolve to \\\".\\\" or \\\"..\\\".\", EXIT_CODE.USAGE);\n  }\n  return normalized;\n}\n\n/**\n * Implements parse extension manifest for the public runtime surface of this module.\n */\nexport function parseExtensionManifest(raw: unknown): ExtensionManifest | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const candidate = raw as Record<string, unknown>;\n  if (typeof candidate.name !== \"string\" || candidate.name.trim().length === 0) {\n    return null;\n  }\n  if (typeof candidate.version !== \"string\" || candidate.version.trim().length === 0) {\n    return null;\n  }\n  if (typeof candidate.entry !== \"string\" || candidate.entry.trim().length === 0) {\n    return null;\n  }\n\n  let priority = DEFAULT_EXTENSION_PRIORITY;\n  if (candidate.priority !== undefined && candidate.priority !== null) {\n    if (typeof candidate.priority !== \"number\" || !Number.isInteger(candidate.priority)) {\n      return null;\n    }\n    priority = candidate.priority;\n  }\n\n  let capabilities: string[] = [];\n  if (candidate.capabilities !== undefined && candidate.capabilities !== null) {\n    if (!Array.isArray(candidate.capabilities) || candidate.capabilities.some((value) => typeof value !== \"string\")) {\n      return null;\n    }\n    capabilities = normalizeStringList(candidate.capabilities.map((value) => String(value).toLowerCase()));\n  }\n\n  return {\n    name: candidate.name.trim(),\n    version: candidate.version.trim(),\n    entry: candidate.entry.trim(),\n    priority,\n    capabilities,\n  };\n}\n\n/**\n * Implements check whether canonical path within directory for the public runtime surface of this module.\n */\nexport async function isCanonicalPathWithinDirectory(directory: string, targetPath: string): Promise<boolean> {\n  const [resolvedDirectory, resolvedTargetPath] = await Promise.all([fs.realpath(directory), fs.realpath(targetPath)]);\n  return isPathWithinDirectory(resolvedDirectory, resolvedTargetPath);\n}\n\n/**\n * Implements validate extension directory for the public runtime surface of this module.\n */\nexport async function validateExtensionDirectory(directory: string): Promise<ValidatedExtensionDirectory> {\n  const manifestPath = path.join(directory, \"manifest.json\");\n  if (!(await pathExists(manifestPath))) {\n    throw new PmCliError(`Extension manifest is missing at \"${manifestPath}\".`, EXIT_CODE.USAGE);\n  }\n\n  let parsedManifest: unknown;\n  try {\n    parsedManifest = JSON.parse(await fs.readFile(manifestPath, \"utf8\")) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      `Failed to parse extension manifest at \"${manifestPath}\": ${formatManifestReadError(error)}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const manifest = parseExtensionManifest(parsedManifest);\n  if (!manifest) {\n    throw new PmCliError(`Extension manifest at \"${manifestPath}\" is invalid.`, EXIT_CODE.USAGE);\n  }\n\n  const entryPath = path.resolve(directory, manifest.entry);\n  if (!isPathWithinDirectory(directory, entryPath)) {\n    throw new PmCliError(\n      `Extension entry \"${manifest.entry}\" resolves outside extension directory \"${directory}\".`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (!(await pathExists(entryPath))) {\n    throw new PmCliError(`Extension entry file is missing at \"${entryPath}\".`, EXIT_CODE.USAGE);\n  }\n  if (!(await isCanonicalPathWithinDirectory(directory, entryPath))) {\n    throw new PmCliError(\n      `Extension entry \"${manifest.entry}\" resolves outside extension directory after symlink resolution.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  return {\n    directory,\n    manifest_path: manifestPath,\n    entry_path: entryPath,\n    manifest,\n  };\n}\n\nfunction formatManifestReadError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport const _testOnlyExtensionShared = {\n  formatManifestReadError,\n};\n"],"names":["commandPathTokens"],"mappings":"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","debugId":"bbea8d94-04ff-5f5e-9dde-660e98ee0b8c"}
+{"version":3,"sources":["../../../../../../../../cli/bootstrap-args.ts","../../../../../../../../cli/commands/extension/shared.ts"],"sourcesContent":["/**\n * @module cli/bootstrap-args\n *\n * Provides CLI runtime support for Bootstrap Args.\n */\nimport { resolveSubcommandFlagContractsForCommand, type CliFlagContract } from \"../sdk/cli-contracts.js\";\nimport { levenshteinDistanceWithinLimit } from \"../core/shared/levenshtein.js\";\n\nfunction parseBootstrapPathToken(\n  token: string,\n  next: string | undefined,\n): { consumed: number; pathValue?: string; preferred: boolean } | null {\n  if (token === \"--path\" || token === \"--pm-path\") {\n    if (typeof next === \"string\" && next.length > 0) {\n      return {\n        consumed: 2,\n        pathValue: next,\n        preferred: token === \"--pm-path\",\n      };\n    }\n    return {\n      consumed: 1,\n      preferred: token === \"--pm-path\",\n    };\n  }\n\n  const inlinePrefix = token.startsWith(\"--path=\")\n    ? \"--path=\"\n    : token.startsWith(\"--pm-path=\")\n      ? \"--pm-path=\"\n      : undefined;\n  if (!inlinePrefix) {\n    return null;\n  }\n\n  const value = token.slice(inlinePrefix.length);\n  if (value.length > 0) {\n    return {\n      consumed: 1,\n      pathValue: value,\n      preferred: inlinePrefix === \"--pm-path=\",\n    };\n  }\n  return {\n    consumed: 1,\n    preferred: inlinePrefix === \"--pm-path=\",\n  };\n}\n\n/**\n * Documents the bootstrap global options payload exchanged by command, SDK, and package integrations.\n */\nexport interface BootstrapGlobalOptions {\n  path?: string;\n  noExtensions: boolean;\n  noPager: boolean;\n  json: boolean;\n  quiet: boolean;\n}\n\n/**\n * Implements parse bootstrap global options for the public runtime surface of this module.\n */\nexport function parseBootstrapGlobalOptions(argv: string[]): BootstrapGlobalOptions {\n  let legacyPathValue: string | undefined;\n  let pmPathValue: string | undefined;\n  let noExtensions = false;\n  let noPager = false;\n  let json = false;\n  let quiet = false;\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (token === \"--no-extensions\") {\n      noExtensions = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--no-pager\") {\n      noPager = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--json\") {\n      json = true;\n      index += 1;\n      continue;\n    }\n    if (token === \"--quiet\") {\n      quiet = true;\n      index += 1;\n      continue;\n    }\n    const parsedPath = parseBootstrapPathToken(token, argv[index + 1]);\n    if (parsedPath) {\n      if (parsedPath.pathValue !== undefined) {\n        if (parsedPath.preferred) {\n          pmPathValue = parsedPath.pathValue;\n        } else {\n          legacyPathValue = parsedPath.pathValue;\n        }\n      }\n      index += parsedPath.consumed;\n      continue;\n    }\n    index += 1;\n  }\n  return {\n    path: pmPathValue ?? legacyPathValue,\n    noExtensions,\n    noPager,\n    json,\n    quiet,\n  };\n}\n\n/**\n * Implements strip global bootstrap tokens for the public runtime surface of this module.\n */\nexport function stripGlobalBootstrapTokens(argv: string[]): string[] {\n  const remaining: string[] = [];\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (\n      token === \"--json\" ||\n      token === \"--quiet\" ||\n      token === \"--no-extensions\" ||\n      token === \"--no-pager\" ||\n      token === \"--profile\" ||\n      token === \"--id-only\" ||\n      token === \"--explain\"\n    ) {\n      index += 1;\n      continue;\n    }\n    if (token === \"--path\" || token === \"--pm-path\") {\n      index += 2;\n      continue;\n    }\n    if (token.startsWith(\"--path=\") || token.startsWith(\"--pm-path=\")) {\n      index += 1;\n      continue;\n    }\n    remaining.push(token);\n    index += 1;\n  }\n  return remaining;\n}\n\n/**\n * Documents the bootstrap help request payload exchanged by command, SDK, and package integrations.\n */\nexport interface BootstrapHelpRequest {\n  requested: boolean;\n  commandPathTokens: string[];\n}\n\n/**\n * Implements parse bootstrap help request for the public runtime surface of this module.\n */\nexport function parseBootstrapHelpRequest(argv: string[]): BootstrapHelpRequest {\n  const stripped = stripGlobalBootstrapTokens(argv);\n  const first = stripped[0]?.trim().toLowerCase();\n  if (first === \"help\") {\n    const commandPathTokens: string[] = [];\n    for (let index = 1; index < stripped.length; index += 1) {\n      const token = stripped[index];\n      if (token.startsWith(\"-\")) {\n        break;\n      }\n      commandPathTokens.push(token.trim().toLowerCase());\n    }\n    return {\n      requested: true,\n      commandPathTokens,\n    };\n  }\n\n  const helpFlagIndex = stripped.findIndex((token) => token === \"--help\" || token === \"-h\");\n  if (helpFlagIndex < 0) {\n    return {\n      requested: false,\n      commandPathTokens: [],\n    };\n  }\n\n  const commandPathTokens: string[] = [];\n  for (const token of stripped) {\n    if (token.startsWith(\"-\")) {\n      break;\n    }\n    commandPathTokens.push(token.trim().toLowerCase());\n  }\n  return {\n    requested: true,\n    commandPathTokens,\n  };\n}\n\n/**\n * Index of the command token in argv — the first non-flag token, skipping the\n * value-consuming/global bootstrap flags. Returns undefined when there is none\n * (bare invocation, only global flags, or a leading `--`). Single source of truth\n * for command-position scanning shared by {@link parseBootstrapCommandName} and the\n * command-alias rewrite so their precedence rules can never drift apart.\n */\nfunction findCommandTokenIndex(argv: string[]): number | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--\") {\n      return undefined;\n    }\n    if (token === \"--path\" || token === \"--pm-path\") {\n      index += 1;\n      continue;\n    }\n    if (\n      token.startsWith(\"--path=\") ||\n      token.startsWith(\"--pm-path=\") ||\n      token === \"--json\" ||\n      token === \"--quiet\" ||\n      token === \"--no-extensions\" ||\n      token === \"--no-pager\" ||\n      token === \"--profile\" ||\n      token === \"--id-only\" ||\n      token === \"--explain\"\n    ) {\n      continue;\n    }\n    if (token.startsWith(\"-\")) {\n      continue;\n    }\n    return index;\n  }\n  return undefined;\n}\n\n/**\n * Implements parse bootstrap command name for the public runtime surface of this module.\n */\nexport function parseBootstrapCommandName(argv: string[]): string | undefined {\n  const index = findCommandTokenIndex(argv);\n  return index === undefined ? undefined : argv[index].trim().toLowerCase();\n}\n\nfunction shouldDisablePagerForInvocation(argv: string[], bootstrapGlobal: BootstrapGlobalOptions): boolean {\n  if (bootstrapGlobal.noPager) {\n    return true;\n  }\n  if (process.stdout.isTTY === true) {\n    return false;\n  }\n  const helpRequest = parseBootstrapHelpRequest(argv);\n  return helpRequest.requested;\n}\n\n/**\n * Implements apply bootstrap pager policy for the public runtime surface of this module.\n */\nexport function applyBootstrapPagerPolicy(argv: string[]): void {\n  const bootstrapGlobal = parseBootstrapGlobalOptions(argv);\n  if (!shouldDisablePagerForInvocation(argv, bootstrapGlobal)) {\n    return;\n  }\n  process.env.PAGER = \"cat\";\n  process.env.MANPAGER = \"cat\";\n  process.env.GIT_PAGER = \"cat\";\n  if (typeof process.env.LESS !== \"string\" || process.env.LESS.trim().length === 0) {\n    process.env.LESS = \"FRX\";\n  }\n}\n\ntype ExtensionSubcommandAction =\n  | \"init\"\n  | \"install\"\n  | \"uninstall\"\n  | \"explore\"\n  | \"manage\"\n  | \"doctor\"\n  | \"adopt\"\n  | \"adopt-all\"\n  | \"activate\"\n  | \"deactivate\";\n\nconst EXTENSION_ACTION_SYNTAX_TOKENS = new Set<ExtensionSubcommandAction>([\n  \"install\",\n  \"uninstall\",\n  \"explore\",\n  \"manage\",\n  \"doctor\",\n  \"adopt\",\n  \"adopt-all\",\n  \"activate\",\n  \"deactivate\",\n]);\n\n/**\n * Implements normalize legacy extension action syntax for the public runtime surface of this module.\n */\nexport function normalizeLegacyExtensionActionSyntax(argv: string[]): string[] {\n  const extensionIndex = argv.findIndex((token) => token === \"extension\");\n  if (extensionIndex < 0) {\n    return [...argv];\n  }\n  const actionToken = argv[extensionIndex + 1];\n  if (!actionToken || actionToken.startsWith(\"-\")) {\n    return [...argv];\n  }\n  if (!EXTENSION_ACTION_SYNTAX_TOKENS.has(actionToken as ExtensionSubcommandAction)) {\n    return [...argv];\n  }\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    return [...argv];\n  }\n  const forcedActionFlag = `--${actionToken}`;\n  if (argv.includes(forcedActionFlag)) {\n    return [...argv];\n  }\n  return [...argv.slice(0, extensionIndex + 1), forcedActionFlag, ...argv.slice(extensionIndex + 2)];\n}\n\ntype BootstrapNormalizationReason =\n  | \"legacy_extension_action\"\n  | \"command_alias\"\n  | \"flag_alias\"\n  | \"flag_typo\"\n  | \"bare_key_value\"\n  | \"list_merge\";\ntype BootstrapNormalizationConfidence = \"high\" | \"medium\";\n\n/**\n * Executable command aliases: a leading command token here is rewritten to its\n * canonical command BEFORE commander parses, so the alias actually runs instead of\n * merely being suggested. These are the highest-frequency aliases real agents type\n * (telemetry: `pm show <id>` alone is the single most common unknown-command) and\n * each target takes the same positional/flags as the alias (with `--comment`/\n * `--note`/`--learning` flag-aliased to `--add` on the target command). Keeping this\n * in one place means the alias is consistent across registration, commander dispatch,\n * telemetry, and error handling — all of which read the normalized argv.\n */\nexport const EXECUTABLE_COMMAND_ALIASES: Readonly<Record<string, string>> = {\n  show: \"get\",\n  view: \"get\",\n  comment: \"comments\",\n  note: \"notes\",\n  learning: \"learnings\",\n};\n\n/**\n * Rewrite a leading command-alias token (e.g. `show` -> `get`) in place. Only the\n * command position is considered — the same token appearing later as an argument\n * (`pm get show`) is left untouched — and only when it is not preceded by `--` or a\n * value-consuming global flag, mirroring {@link parseBootstrapCommandName}.\n */\nfunction rewriteCommandAlias(argv: string[], trace: BootstrapNormalizationEvent[]): string[] {\n  const index = findCommandTokenIndex(argv);\n  if (index === undefined) {\n    return argv;\n  }\n  const token = argv[index];\n  const canonical = EXECUTABLE_COMMAND_ALIASES[token.trim().toLowerCase()];\n  if (!canonical) {\n    return argv;\n  }\n  const rewritten = [...argv];\n  rewritten[index] = canonical;\n  trace.push({ from: token, to: [canonical], reason: \"command_alias\", confidence: \"high\" });\n  return rewritten;\n}\n\n/**\n * Documents the bootstrap normalization event payload exchanged by command, SDK, and package integrations.\n */\nexport interface BootstrapNormalizationEvent {\n  from: string;\n  to: string[];\n  reason: BootstrapNormalizationReason;\n  confidence: BootstrapNormalizationConfidence;\n}\n\n/**\n * Documents the bootstrap invocation normalization result payload exchanged by command, SDK, and package integrations.\n */\nexport interface BootstrapInvocationNormalizationResult {\n  argv: string[];\n  commandName: string | undefined;\n  trace: BootstrapNormalizationEvent[];\n}\n\ninterface FlagLookup {\n  canonicalByNormalized: Map<string, string | null>;\n  canonicalByCompact: Map<string, string | null>;\n  canonicalComparables: Array<{ canonicalFlag: string; comparable: string }>;\n  listCanonicalFlags: Set<string>;\n}\n\nfunction normalizeFlagKeyToken(raw: string): string {\n  const withoutPrefix = raw.replace(/^--?/, \"\");\n  return withoutPrefix\n    .replace(/_/g, \"-\")\n    .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\nfunction toComparableFlagKey(raw: string): string {\n  return normalizeFlagKeyToken(raw).replace(/-/g, \"\");\n}\n\nfunction markUnambiguousFlag(\n  map: Map<string, string | null>,\n  key: string,\n  canonicalFlag: string,\n): void {\n  const existing = map.get(key);\n  if (existing === undefined) {\n    map.set(key, canonicalFlag);\n    return;\n  }\n  if (existing !== canonicalFlag) {\n    map.set(key, null);\n  }\n}\n\nfunction collectLongFlagCandidates(contract: CliFlagContract): string[] {\n  const candidates: string[] = [];\n  const pushLongFlag = (value: string | undefined): void => {\n    if (typeof value !== \"string\") {\n      return;\n    }\n    if (!value.startsWith(\"--\")) {\n      return;\n    }\n    candidates.push(value);\n  };\n  pushLongFlag(contract.flag);\n  for (const alias of contract.aliases ?? []) {\n    pushLongFlag(alias);\n  }\n  return candidates;\n}\n\nfunction buildFlagLookup(\n  commandName: string | undefined,\n  contractsOverride?: CliFlagContract[],\n): FlagLookup {\n  const contracts = contractsOverride ?? resolveSubcommandFlagContractsForCommand(commandName);\n  const canonicalByNormalized = new Map<string, string | null>();\n  const canonicalByCompact = new Map<string, string | null>();\n  const canonicalComparablesMap = new Map<string, string>();\n  const listCanonicalFlags = new Set<string>();\n  for (const contract of contracts) {\n    const longCandidates = collectLongFlagCandidates(contract);\n    if (longCandidates.length === 0) {\n      continue;\n    }\n    const canonicalFlag = `--${normalizeFlagKeyToken(longCandidates[0])}`;\n    for (const candidate of longCandidates) {\n      markUnambiguousFlag(canonicalByNormalized, normalizeFlagKeyToken(candidate), canonicalFlag);\n      markUnambiguousFlag(canonicalByCompact, toComparableFlagKey(candidate), canonicalFlag);\n    }\n    const comparable = toComparableFlagKey(canonicalFlag);\n    if (!canonicalComparablesMap.has(canonicalFlag)) {\n      canonicalComparablesMap.set(canonicalFlag, comparable);\n    }\n    if (contract.list === true) {\n      listCanonicalFlags.add(canonicalFlag);\n    }\n  }\n  return {\n    canonicalByNormalized,\n    canonicalByCompact,\n    canonicalComparables: [...canonicalComparablesMap.entries()].map(([canonicalFlag, comparable]) => ({\n      canonicalFlag,\n      comparable,\n    })),\n    listCanonicalFlags,\n  };\n}\n\nfunction resolveCanonicalFlag(\n  rawKey: string,\n  lookup: FlagLookup,\n): { flag: string; reason: \"flag_alias\" | \"flag_typo\"; confidence: BootstrapNormalizationConfidence } | null {\n  const normalizedKey = normalizeFlagKeyToken(rawKey);\n  const direct = lookup.canonicalByNormalized.get(normalizedKey);\n  if (typeof direct === \"string\") {\n    return {\n      flag: direct,\n      reason: \"flag_alias\",\n      confidence: \"high\",\n    };\n  }\n  const comparableKey = normalizedKey.replace(/-/g, \"\");\n  const compactMatch = lookup.canonicalByCompact.get(comparableKey);\n  if (typeof compactMatch === \"string\") {\n    return {\n      flag: compactMatch,\n      reason: \"flag_alias\",\n      confidence: \"high\",\n    };\n  }\n  const maxDistance = comparableKey.length >= 8 ? 2 : 1;\n  let bestDistance = Number.POSITIVE_INFINITY;\n  let bestFlag: string | undefined;\n  let tied = false;\n  for (const candidate of lookup.canonicalComparables) {\n    const distance = levenshteinDistanceWithinLimit(comparableKey, candidate.comparable, maxDistance);\n    if (distance === null) {\n      continue;\n    }\n    if (distance < bestDistance) {\n      bestDistance = distance;\n      bestFlag = candidate.canonicalFlag;\n      tied = false;\n      continue;\n    }\n    if (distance === bestDistance && bestFlag !== candidate.canonicalFlag) {\n      tied = true;\n    }\n  }\n  if (!bestFlag || tied || !Number.isFinite(bestDistance) || bestDistance <= 0) {\n    return null;\n  }\n  return {\n    flag: bestFlag,\n    reason: \"flag_typo\",\n    confidence: bestDistance >= 2 ? \"medium\" : \"high\",\n  };\n}\n\n/**\n * Implements list alias plural keys for the public runtime surface of this module.\n */\nexport function listAliasPluralKeys(normalizedKey: string): string[] {\n  const candidates = [`${normalizedKey}s`];\n  if (normalizedKey.endsWith(\"y\") && normalizedKey.length > 1) {\n    candidates.push(`${normalizedKey.slice(0, -1)}ies`);\n  }\n  return candidates;\n}\n\nfunction parseBareKeyValueToken(token: string): { key: string; value: string } | null {\n  if (token.includes(\"://\")) {\n    return null;\n  }\n  const match = token.match(/^([A-Za-z][A-Za-z0-9_-]{1,63})([:=])(.*)$/);\n  if (!match) {\n    return null;\n  }\n  const key = match[1];\n  const value = match[3];\n  if (value.length === 0) {\n    return null;\n  }\n  return {\n    key,\n    value,\n  };\n}\n\nfunction normalizeLongOptionToken(\n  token: string,\n  lookup: FlagLookup,\n): { tokens: string[]; event?: BootstrapNormalizationEvent } {\n  if (!token.startsWith(\"--\")) {\n    return { tokens: [token] };\n  }\n  const equalsIndex = token.indexOf(\"=\");\n  const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;\n  const inlineValue = equalsIndex >= 0 ? token.slice(equalsIndex + 1) : undefined;\n  const resolution = resolveCanonicalFlag(key, lookup);\n  if (!resolution) {\n    return { tokens: [token] };\n  }\n  const normalizedToken = inlineValue === undefined ? resolution.flag : `${resolution.flag}=${inlineValue}`;\n  if (normalizedToken === token) {\n    return { tokens: [token] };\n  }\n  return {\n    tokens: [normalizedToken],\n    event: {\n      from: token,\n      to: [normalizedToken],\n      reason: resolution.reason,\n      confidence: resolution.confidence,\n    },\n  };\n}\n\n// Global option flags whose value may legitimately begin with \"--\" (commander\n// accepts such values). Their value token must not be reinterpreted as a list\n// flag during coalescing. `--pm-path <dir>` and its legacy `--path <dir>`\n// alias are the documented cases; other globals\n// (--json/--quiet/--no-extensions/--no-pager/--profile) are boolean.\nconst GLOBAL_VALUE_CONSUMING_FLAGS = new Set<string>([\"--pm-path\", \"--path\"]);\n\nfunction splitCanonicalListToken(token: string): { flag: string; inlineValue?: string } | null {\n  if (!token.startsWith(\"--\")) {\n    return null;\n  }\n  const equalsIndex = token.indexOf(\"=\");\n  if (equalsIndex < 0) {\n    return { flag: token };\n  }\n  return {\n    flag: token.slice(0, equalsIndex),\n    inlineValue: token.slice(equalsIndex + 1),\n  };\n}\n\ninterface ListFlagSlot {\n  outputIndex: number;\n  originalTokens: string[];\n  values: string[];\n  occurrences: number;\n}\n\ninterface ListFlagOccurrence {\n  originalTokens: string[];\n  value: string | undefined;\n  consumed: number;\n}\n\ninterface ValuedListFlagOccurrence {\n  originalTokens: string[];\n  value: string;\n}\n\nfunction copyValueConsumingFlag(argv: string[], index: number, result: (string | null)[]): number {\n  result.push(argv[index]);\n  const next = argv[index + 1];\n  if (typeof next === \"string\" && next !== \"--\") {\n    result.push(next);\n    return index + 2;\n  }\n  return index + 1;\n}\n\nfunction readListFlagOccurrence(\n  argv: string[],\n  index: number,\n  parsed: { flag: string; inlineValue?: string },\n  multiValueListFlags: Set<string>,\n): ListFlagOccurrence {\n  if (parsed.inlineValue !== undefined) {\n    return {\n      originalTokens: [argv[index]],\n      value: parsed.inlineValue,\n      consumed: 1,\n    };\n  }\n\n  const values: string[] = [];\n  let valueIndex = index + 1;\n  while (\n    valueIndex < argv.length &&\n    argv[valueIndex] !== \"--\" &&\n    !argv[valueIndex].startsWith(\"-\") &&\n    (values.length === 0 || multiValueListFlags.has(parsed.flag))\n  ) {\n    values.push(argv[valueIndex]);\n    valueIndex += 1;\n  }\n\n  const consumed = values.length === 0 ? 1 : 1 + values.length;\n  return {\n    originalTokens: argv.slice(index, index + consumed),\n    value: values.length === 0 ? undefined : values.join(\",\"),\n    consumed,\n  };\n}\n\nfunction recordListFlagOccurrence(\n  slots: Map<string, ListFlagSlot>,\n  result: (string | null)[],\n  flag: string,\n  occurrence: ValuedListFlagOccurrence,\n): void {\n  const existing = slots.get(flag);\n  if (existing) {\n    existing.values.push(occurrence.value);\n    existing.occurrences += 1;\n    return;\n  }\n\n  slots.set(flag, {\n    outputIndex: result.length,\n    originalTokens: occurrence.originalTokens,\n    values: [occurrence.value],\n    occurrences: 1,\n  });\n  // Reserve the anchor position; finalized after the walk so we know the full\n  // merged value or can restore the original token form for single uses.\n  result.push(null);\n}\n\nfunction buildListFlagCoalescingSplices(\n  slots: Map<string, ListFlagSlot>,\n  multiValueListFlags: Set<string>,\n): {\n  events: BootstrapNormalizationEvent[];\n  splices: Array<{ outputIndex: number; tokens: string[] }>;\n} {\n  const events: BootstrapNormalizationEvent[] = [];\n  const splices: Array<{ outputIndex: number; tokens: string[] }> = [];\n  for (const [flag, slot] of slots) {\n    const shouldMerge = slot.occurrences >= 2 || (multiValueListFlags.has(flag) && slot.originalTokens.length > 2);\n    if (!shouldMerge) {\n      splices.push({ outputIndex: slot.outputIndex, tokens: slot.originalTokens });\n      continue;\n    }\n    const mergedToken = `${flag}=${slot.values.join(\",\")}`;\n    splices.push({ outputIndex: slot.outputIndex, tokens: [mergedToken] });\n    events.push({\n      from: `${flag} (x${slot.occurrences})`,\n      to: [mergedToken],\n      reason: \"list_merge\",\n      confidence: \"high\",\n    });\n  }\n  return { events, splices };\n}\n\nfunction applyListFlagSplices(result: (string | null)[], splices: Array<{ outputIndex: number; tokens: string[] }>): void {\n  splices.sort((a, b) => b.outputIndex - a.outputIndex);\n  for (const splice of splices) {\n    result.splice(splice.outputIndex, 1, ...splice.tokens);\n  }\n}\n\n/**\n * Coalesce repeated occurrences of comma-separated list flags into a single\n * `--flag=v1,v2,v3` token anchored at the FIRST occurrence. Without this,\n * Commander treats these flags as scalars and silently keeps only the last\n * value (data loss). Both `--flag value` and `--flag=value` forms are merged;\n * a value-less occurrence is preserved untouched, and a `--` terminator stops\n * coalescing (remainder is passed through verbatim).\n *\n * `valueConsumingFlags` lists option flags (e.g. global `--path`) whose value\n * may itself begin with `--`. Their value token is emitted verbatim so a\n * list-flag-looking value (`--path --tags`) is never reinterpreted as a flag\n * nor allowed to swallow the following command/positional token.\n */\nexport function coalesceRepeatedListFlags(\n  argv: string[],\n  listFlags: Set<string>,\n  valueConsumingFlags: Set<string> = new Set(),\n  multiValueListFlags: Set<string> = new Set(),\n): { argv: string[]; events: BootstrapNormalizationEvent[] } {\n  if (listFlags.size === 0) {\n    return { argv: [...argv], events: [] };\n  }\n\n  const result: (string | null)[] = [];\n  const slots = new Map<string, ListFlagSlot>();\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      result.push(...argv.slice(index));\n      break;\n    }\n    // A value-consuming option in space form owns the next token as its value,\n    // even when that value begins with \"--\". Emit both verbatim so the value is\n    // never misread as a list-flag occurrence.\n    if (valueConsumingFlags.has(token)) {\n      index = copyValueConsumingFlag(argv, index, result);\n      continue;\n    }\n    const parsed = splitCanonicalListToken(token);\n    if (!parsed || !listFlags.has(parsed.flag)) {\n      result.push(token);\n      index += 1;\n      continue;\n    }\n\n    const occurrence = readListFlagOccurrence(argv, index, parsed, multiValueListFlags);\n    if (occurrence.value === undefined) {\n      // Value-less occurrence: leave untouched, do not coalesce.\n      result.push(token);\n      index += occurrence.consumed;\n      continue;\n    }\n\n    recordListFlagOccurrence(slots, result, parsed.flag, {\n      originalTokens: occurrence.originalTokens,\n      value: occurrence.value,\n    });\n    index += occurrence.consumed;\n  }\n\n  // Apply anchor splices from the end so earlier indices stay valid when a\n  // single-occurrence anchor expands back into two tokens.\n  const { events, splices } = buildListFlagCoalescingSplices(slots, multiValueListFlags);\n  applyListFlagSplices(result, splices);\n\n  return { argv: result as string[], events };\n}\n\n/**\n * Linked-test entry keys accepted in the two-token form `pm test <id> --add command\n * \"npm test -- parser\"` (GH-191). Only entry-identity keys are merged: `command`/`cmd`\n * name the shell command and `path` names the test file, so a single key=value entry is\n * meaningful for them. Other structured keys (scope, env_set, assertions, ...) cannot\n * form a valid standalone entry and are left for the normal parser to reject. `--remove`\n * matches existing entries by `command=`/`path=` only, so `cmd` is excluded there.\n * Key names mirror STRUCTURED_LINKED_TEST_KEYS in src/cli/commands/linked-test-entry.ts.\n */\nconst LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG: ReadonlyMap<string, ReadonlySet<string>> = new Map([\n  [\"--add\", new Set([\"command\", \"cmd\", \"path\"])],\n  [\"--remove\", new Set([\"command\", \"path\"])],\n]);\n\n/**\n * Sandbox-safe linked-test commands legitimately start with env assignments\n * (`PM_PATH=... PM_GLOBAL_PATH=... vitest run -- parser`), which look like bare\n * key=value settings tokens. When the two preceding tokens are a linked-test\n * flag plus a bare two-token key (`--add command <value>`), the value must be\n * left intact for mergeLinkedTestTwoTokenEntries instead of being rewritten\n * into a canonical flag (e.g. PM_PATH= -> --pm-path), which would silently\n * corrupt the command into `--add command --pm-path ...`.\n */\nfunction isLinkedTestTwoTokenValuePosition(commandName: string | undefined, emittedTokens: readonly string[]): boolean {\n  if (commandName !== \"test\" || emittedTokens.length < 2) {\n    return false;\n  }\n  const key = emittedTokens[emittedTokens.length - 1];\n  const flag = emittedTokens[emittedTokens.length - 2];\n  const keys = LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(flag);\n  return keys !== undefined && keys.has(key);\n}\n\n/**\n * Accept the two-token linked-test form `pm test <id> --add command \"npm test -- parser\"`\n * by merging the bare key token and its single quoted value into the documented\n * `--add command=...` shape. Without this merge Commander binds the bare key as the\n * option value and treats the quoted command as an excess positional, failing with\n * \"too many arguments\" (GH-191). The merge only fires when EXACTLY ONE non-flag token\n * follows the bare key, i.e. the value was quoted into one shell token — an unquoted\n * multi-token value stays ambiguous (it may swallow the item id), still fails fast, and\n * is routed to targeted quoting guidance by the commander error classifier instead.\n */\nexport function mergeLinkedTestTwoTokenEntries(\n  argv: string[],\n  commandName: string | undefined,\n  trace: BootstrapNormalizationEvent[],\n): string[] {\n  if (commandName !== \"test\") {\n    return argv;\n  }\n  const result: string[] = [];\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      result.push(...argv.slice(index));\n      return result;\n    }\n    const keys = LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(token);\n    const key = keys ? argv[index + 1] : undefined;\n    if (!keys || typeof key !== \"string\" || !keys.has(key)) {\n      result.push(token);\n      index += 1;\n      continue;\n    }\n    let runEnd = index + 2;\n    while (runEnd < argv.length && !argv[runEnd].startsWith(\"-\")) {\n      runEnd += 1;\n    }\n    if (runEnd - (index + 2) !== 1) {\n      result.push(token);\n      index += 1;\n      continue;\n    }\n    const value = argv[index + 2];\n    const mergedValue = `${key}=${value}`;\n    result.push(token, mergedValue);\n    trace.push({\n      from: `${token} ${key} ${value}`,\n      to: [token, mergedValue],\n      reason: \"bare_key_value\",\n      confidence: \"high\",\n    });\n    index += 3;\n  }\n  return result;\n}\n\n/**\n * Implements normalize bootstrap invocation for the public runtime surface of this module.\n */\nexport function normalizeBootstrapInvocation(argv: string[]): BootstrapInvocationNormalizationResult {\n  const trace: BootstrapNormalizationEvent[] = [];\n  const legacyNormalized = normalizeLegacyExtensionActionSyntax(argv);\n  if (legacyNormalized.length !== argv.length || legacyNormalized.some((token, index) => token !== argv[index])) {\n    trace.push({\n      from: argv.join(\" \"),\n      to: [...legacyNormalized],\n      reason: \"legacy_extension_action\",\n      confidence: \"high\",\n    });\n  }\n  const aliasNormalized = rewriteCommandAlias(legacyNormalized, trace);\n  const commandName = parseBootstrapCommandName(aliasNormalized);\n  const commandPathName = parseBootstrapCommandPathName(aliasNormalized);\n  const lookup = buildFlagLookup(commandPathName ?? commandName);\n  const normalizedArgv: string[] = [];\n  for (let index = 0; index < aliasNormalized.length; index += 1) {\n    const token = aliasNormalized[index];\n    if (token === \"--\") {\n      normalizedArgv.push(...aliasNormalized.slice(index));\n      break;\n    }\n    const previous = normalizedArgv[normalizedArgv.length - 1];\n    if (token.startsWith(\"--\")) {\n      const normalizedToken = normalizeLongOptionToken(token, lookup);\n      normalizedArgv.push(...normalizedToken.tokens);\n      if (normalizedToken.event) {\n        trace.push(normalizedToken.event);\n      }\n      continue;\n    }\n    const bareKeyValue = parseBareKeyValueToken(token);\n    if (\n      bareKeyValue &&\n      !(typeof previous === \"string\" && previous.startsWith(\"-\")) &&\n      !isLinkedTestTwoTokenValuePosition(commandName, normalizedArgv)\n    ) {\n      const resolution = resolveCanonicalFlag(bareKeyValue.key, lookup);\n      if (resolution) {\n        const replacement = [resolution.flag, bareKeyValue.value];\n        normalizedArgv.push(...replacement);\n        trace.push({\n          from: token,\n          to: replacement,\n          reason: \"bare_key_value\",\n          confidence: resolution.confidence,\n        });\n        continue;\n      }\n    }\n    normalizedArgv.push(token);\n  }\n  const linkedTestNormalized = mergeLinkedTestTwoTokenEntries(normalizedArgv, commandName, trace);\n  const coalesced = coalesceRepeatedListFlags(\n    linkedTestNormalized,\n    lookup.listCanonicalFlags,\n    GLOBAL_VALUE_CONSUMING_FLAGS,\n    commandName === \"create\" ? new Set([\"--tags\"]) : new Set(),\n  );\n  for (const event of coalesced.events) {\n    trace.push(event);\n  }\n  return {\n    argv: coalesced.argv,\n    commandName,\n    trace,\n  };\n}\n\nfunction parseBootstrapCommandPathName(argv: string[]): string | undefined {\n  const stripped = stripGlobalBootstrapTokens(argv);\n  const first = stripped[0]?.trim().toLowerCase();\n  const second = stripped[1]?.trim().toLowerCase();\n  if (\n    (first === \"extension\" || first === \"package\" || first === \"packages\") &&\n    typeof second === \"string\" &&\n    second.length > 0 &&\n    !second.startsWith(\"-\")\n  ) {\n    return `${first} ${second}`;\n  }\n  return first;\n}\n\n/**\n * Implements parse bootstrap type value for the public runtime surface of this module.\n */\nexport function parseBootstrapTypeValue(argv: string[]): string | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--type\") {\n      const candidate = argv[index + 1];\n      if (typeof candidate === \"string\" && candidate.trim().length > 0) {\n        return candidate.trim();\n      }\n      continue;\n    }\n    if (token.startsWith(\"--type=\")) {\n      const candidate = token.slice(\"--type=\".length).trim();\n      if (candidate.length > 0) {\n        return candidate;\n      }\n    }\n  }\n  return undefined;\n}\n\nexport const _testOnly = {\n  buildFlagLookup,\n  collectLongFlagCandidates,\n  markUnambiguousFlag,\n  normalizeLongOptionToken,\n  resolveCanonicalFlag,\n};\n","/**\n * @module cli/commands/extension/shared\n *\n * Implements extension package-management support for Shared.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { isPathWithinDirectory } from \"../../../core/fs/path-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport type { ExtensionManifest } from \"../../../core/extensions/loader.js\";\n\nexport const DEFAULT_EXTENSION_PRIORITY = 100;\n\n/**\n * Documents the validated extension directory payload exchanged by command, SDK, and package integrations.\n */\nexport interface ValidatedExtensionDirectory {\n  directory: string;\n  manifest_path: string;\n  entry_path: string;\n  manifest: ExtensionManifest;\n}\n\n/**\n * Implements normalize string list for the public runtime surface of this module.\n */\nexport function normalizeStringList(values: readonly string[]): string[] {\n  return [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) =>\n    left.localeCompare(right),\n  );\n}\n\n/**\n * Implements normalize extension name for match for the public runtime surface of this module.\n */\nexport function normalizeExtensionNameForMatch(value: string): string {\n  return value.trim().toLowerCase();\n}\n\n/**\n * Implements normalize managed directory name for the public runtime surface of this module.\n */\nexport function normalizeManagedDirectoryName(name: string): string {\n  const normalized = name\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  if (normalized.length === 0) {\n    throw new PmCliError(\"Extension manifest name must resolve to a non-empty directory name.\", EXIT_CODE.USAGE);\n  }\n  if (normalized === \".\" || normalized === \"..\") {\n    // Manifest-controlled input must resolve to a dedicated child directory, never\n    // the extensions root itself or its parent (path-traversal guard).\n    throw new PmCliError(\"Extension manifest name must not resolve to \\\".\\\" or \\\"..\\\".\", EXIT_CODE.USAGE);\n  }\n  return normalized;\n}\n\nfunction parseOptionalManifestPriority(value: unknown): number | null {\n  if (value === undefined || value === null) {\n    return DEFAULT_EXTENSION_PRIORITY;\n  }\n  return typeof value === \"number\" && Number.isInteger(value) ? value : null;\n}\n\nfunction parseOptionalManifestCapabilities(value: unknown): string[] | null {\n  if (value === undefined || value === null) {\n    return [];\n  }\n  if (!Array.isArray(value) || value.some((entry) => typeof entry !== \"string\")) {\n    return null;\n  }\n  return normalizeStringList(value.map((entry) => String(entry).toLowerCase()));\n}\n\n/**\n * Implements parse extension manifest for the public runtime surface of this module.\n */\nexport function parseExtensionManifest(raw: unknown): ExtensionManifest | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const candidate = raw as Record<string, unknown>;\n  if (typeof candidate.name !== \"string\" || candidate.name.trim().length === 0) {\n    return null;\n  }\n  if (typeof candidate.version !== \"string\" || candidate.version.trim().length === 0) {\n    return null;\n  }\n  if (typeof candidate.entry !== \"string\" || candidate.entry.trim().length === 0) {\n    return null;\n  }\n\n  const priority = parseOptionalManifestPriority(candidate.priority);\n  const capabilities = parseOptionalManifestCapabilities(candidate.capabilities);\n  if (priority === null || capabilities === null) {\n    return null;\n  }\n\n  return {\n    name: candidate.name.trim(),\n    version: candidate.version.trim(),\n    entry: candidate.entry.trim(),\n    priority,\n    capabilities,\n  };\n}\n\n/**\n * Implements check whether canonical path within directory for the public runtime surface of this module.\n */\nexport async function isCanonicalPathWithinDirectory(directory: string, targetPath: string): Promise<boolean> {\n  const [resolvedDirectory, resolvedTargetPath] = await Promise.all([fs.realpath(directory), fs.realpath(targetPath)]);\n  return isPathWithinDirectory(resolvedDirectory, resolvedTargetPath);\n}\n\n/**\n * Implements validate extension directory for the public runtime surface of this module.\n */\nexport async function validateExtensionDirectory(directory: string): Promise<ValidatedExtensionDirectory> {\n  const manifestPath = path.join(directory, \"manifest.json\");\n  if (!(await pathExists(manifestPath))) {\n    throw new PmCliError(`Extension manifest is missing at \"${manifestPath}\".`, EXIT_CODE.USAGE);\n  }\n\n  let parsedManifest: unknown;\n  try {\n    parsedManifest = JSON.parse(await fs.readFile(manifestPath, \"utf8\")) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      `Failed to parse extension manifest at \"${manifestPath}\": ${formatManifestReadError(error)}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const manifest = parseExtensionManifest(parsedManifest);\n  if (!manifest) {\n    throw new PmCliError(`Extension manifest at \"${manifestPath}\" is invalid.`, EXIT_CODE.USAGE);\n  }\n\n  const entryPath = path.resolve(directory, manifest.entry);\n  if (!isPathWithinDirectory(directory, entryPath)) {\n    throw new PmCliError(\n      `Extension entry \"${manifest.entry}\" resolves outside extension directory \"${directory}\".`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (!(await pathExists(entryPath))) {\n    throw new PmCliError(`Extension entry file is missing at \"${entryPath}\".`, EXIT_CODE.USAGE);\n  }\n  if (!(await isCanonicalPathWithinDirectory(directory, entryPath))) {\n    throw new PmCliError(\n      `Extension entry \"${manifest.entry}\" resolves outside extension directory after symlink resolution.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  return {\n    directory,\n    manifest_path: manifestPath,\n    entry_path: entryPath,\n    manifest,\n  };\n}\n\nfunction formatManifestReadError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport const _testOnlyExtensionShared = {\n  formatManifestReadError,\n};\n"],"names":["commandPathTokens"],"mappings":"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","debugId":"7df0fcc5-8ff4-5817-b72d-925ba746d847"}

package/dist/cli-bundle/chunks/{chunk-MDPEOIGN.js → chunk-RAHINBVP.js}

@@ -9,7 +9,7 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-RVUALSJF.js";
+} from "./chunk-KHVGM5CS.js";
 
 // dist/sdk/cli-contracts/commander-types.js
 !(function() {
@@ -865,7 +865,7 @@ function normalizeUniqueStringList(values) {
 !(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] = "ad4e11af-1bc5-5eda-8cc6-cd6e83a80749");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "eb82ab31-2042-5c86-b4b9-af5a5e3aeb96");
   } catch (e2) {
   }
 })();
@@ -931,28 +931,7 @@ var GLOBAL_FLAG_CONTRACTS = [
   ...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,
   { flag: "--version" }
 ];
-var LIST_FILTER_FLAG_CONTRACTS = [
-  { flag: "--status", list: true },
-  { flag: "--type" },
-  { flag: "--tag", aliases: ["--tags"] },
-  { flag: "--priority" },
-  { flag: "--deadline-before" },
-  { flag: "--deadline-after" },
-  { flag: "--updated-after" },
-  { flag: "--updated-before" },
-  { flag: "--created-after" },
-  { flag: "--created-before" },
-  { flag: "--ids", list: true },
-  { flag: "--assignee" },
-  { flag: "--assignee-filter" },
-  { flag: "--assignee_filter" },
-  { flag: "--parent" },
-  { flag: "--sprint" },
-  { flag: "--release" },
-  { flag: "--filter-ac-missing" },
-  { flag: "--filter-estimates-missing", aliases: ["--filter-estimate-missing"] },
-  { flag: "--filter-resolution-missing" },
-  { flag: "--filter-metadata-missing" },
+var GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS = [
   { flag: "--filter-reviewer-missing" },
   { flag: "--filter-risk-missing" },
   { flag: "--filter-confidence-missing" },
@@ -975,7 +954,59 @@ var LIST_FILTER_FLAG_CONTRACTS = [
   { flag: "--has-body" },
   { flag: "--empty-body" },
   { flag: "--has-linked-command" },
-  { flag: "--no-linked-command" },
+  { flag: "--no-linked-command" }
+];
+var MANY_GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS = [
+  { flag: "--filter-reviewer-missing" },
+  { flag: "--filter-risk-missing" },
+  { flag: "--filter-confidence-missing" },
+  { flag: "--filter-sprint-missing" },
+  { flag: "--filter-release-missing" },
+  { flag: "--filter-has-notes" },
+  { flag: "--filter-no-notes" },
+  { flag: "--filter-has-learnings" },
+  { flag: "--filter-no-learnings" },
+  { flag: "--filter-has-files" },
+  { flag: "--filter-no-files" },
+  { flag: "--filter-has-docs" },
+  { flag: "--filter-no-docs" },
+  { flag: "--filter-has-tests" },
+  { flag: "--filter-no-tests" },
+  { flag: "--filter-has-comments" },
+  { flag: "--filter-no-comments" },
+  { flag: "--filter-has-deps" },
+  { flag: "--filter-no-deps" },
+  { flag: "--filter-has-body" },
+  { flag: "--filter-empty-body" },
+  { flag: "--filter-has-linked-command" },
+  { flag: "--filter-no-linked-command" },
+  { flag: "--ids", list: true },
+  { flag: "--limit" },
+  { flag: "--offset" }
+];
+var LIST_FILTER_FLAG_CONTRACTS = [
+  { flag: "--status", list: true },
+  { flag: "--type" },
+  { flag: "--tag", aliases: ["--tags"] },
+  { flag: "--priority" },
+  { flag: "--deadline-before" },
+  { flag: "--deadline-after" },
+  { flag: "--updated-after" },
+  { flag: "--updated-before" },
+  { flag: "--created-after" },
+  { flag: "--created-before" },
+  { flag: "--ids", list: true },
+  { flag: "--assignee" },
+  { flag: "--assignee-filter" },
+  { flag: "--assignee_filter" },
+  { flag: "--parent" },
+  { flag: "--sprint" },
+  { flag: "--release" },
+  { flag: "--filter-ac-missing" },
+  { flag: "--filter-estimates-missing", aliases: ["--filter-estimate-missing"] },
+  { flag: "--filter-resolution-missing" },
+  { flag: "--filter-metadata-missing" },
+  ...GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS,
   { flag: "--limit" },
   { flag: "--offset" },
   { flag: "--no-truncate", aliases: ["--all"] },
@@ -1411,32 +1442,7 @@ var CLOSE_MANY_FLAG_CONTRACTS = [
   { flag: "--filter-parent" },
   { flag: "--filter-sprint" },
   { flag: "--filter-release" },
-  { flag: "--filter-reviewer-missing" },
-  { flag: "--filter-risk-missing" },
-  { flag: "--filter-confidence-missing" },
-  { flag: "--filter-sprint-missing" },
-  { flag: "--filter-release-missing" },
-  { flag: "--filter-has-notes" },
-  { flag: "--filter-no-notes" },
-  { flag: "--filter-has-learnings" },
-  { flag: "--filter-no-learnings" },
-  { flag: "--filter-has-files" },
-  { flag: "--filter-no-files" },
-  { flag: "--filter-has-docs" },
-  { flag: "--filter-no-docs" },
-  { flag: "--filter-has-tests" },
-  { flag: "--filter-no-tests" },
-  { flag: "--filter-has-comments" },
-  { flag: "--filter-no-comments" },
-  { flag: "--filter-has-deps" },
-  { flag: "--filter-no-deps" },
-  { flag: "--filter-has-body" },
-  { flag: "--filter-empty-body" },
-  { flag: "--filter-has-linked-command" },
-  { flag: "--filter-no-linked-command" },
-  { flag: "--ids", list: true },
-  { flag: "--limit" },
-  { flag: "--offset" },
+  ...MANY_GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS,
   { flag: "--reason" },
   { flag: "--resolution" },
   { flag: "--expected-result", aliases: ["--expected_result", "--expected"] },
@@ -1858,32 +1864,7 @@ var UPDATE_MANY_FLAG_CONTRACTS = [
   { flag: "--filter-estimates-missing", aliases: ["--filter-estimate-missing"] },
   { flag: "--filter-resolution-missing" },
   { flag: "--filter-metadata-missing" },
-  { flag: "--filter-reviewer-missing" },
-  { flag: "--filter-risk-missing" },
-  { flag: "--filter-confidence-missing" },
-  { flag: "--filter-sprint-missing" },
-  { flag: "--filter-release-missing" },
-  { flag: "--filter-has-notes" },
-  { flag: "--filter-no-notes" },
-  { flag: "--filter-has-learnings" },
-  { flag: "--filter-no-learnings" },
-  { flag: "--filter-has-files" },
-  { flag: "--filter-no-files" },
-  { flag: "--filter-has-docs" },
-  { flag: "--filter-no-docs" },
-  { flag: "--filter-has-tests" },
-  { flag: "--filter-no-tests" },
-  { flag: "--filter-has-comments" },
-  { flag: "--filter-no-comments" },
-  { flag: "--filter-has-deps" },
-  { flag: "--filter-no-deps" },
-  { flag: "--filter-has-body" },
-  { flag: "--filter-empty-body" },
-  { flag: "--filter-has-linked-command" },
-  { flag: "--filter-no-linked-command" },
-  { flag: "--ids", list: true },
-  { flag: "--limit" },
-  { flag: "--offset" },
+  ...MANY_GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS,
   { flag: "--dry-run" },
   { flag: "--rollback" },
   { flag: "--no-checkpoint" },
@@ -2130,29 +2111,7 @@ var SEARCH_FLAG_CONTRACTS = [
   { flag: "--sprint" },
   { flag: "--release" },
   { flag: "--parent" },
-  { flag: "--filter-reviewer-missing" },
-  { flag: "--filter-risk-missing" },
-  { flag: "--filter-confidence-missing" },
-  { flag: "--filter-sprint-missing" },
-  { flag: "--filter-release-missing" },
-  { flag: "--has-notes" },
-  { flag: "--no-notes" },
-  { flag: "--has-learnings" },
-  { flag: "--no-learnings" },
-  { flag: "--has-files" },
-  { flag: "--no-files" },
-  { flag: "--has-docs" },
-  { flag: "--no-docs" },
-  { flag: "--has-tests" },
-  { flag: "--no-tests" },
-  { flag: "--has-comments" },
-  { flag: "--no-comments" },
-  { flag: "--has-deps" },
-  { flag: "--no-deps" },
-  { flag: "--has-body" },
-  { flag: "--empty-body" },
-  { flag: "--has-linked-command" },
-  { flag: "--no-linked-command" }
+  ...GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS
 ];
 var CONTRACTS_FLAG_CONTRACTS = [
   { flag: "--action" },
@@ -4762,4 +4721,4 @@ export {
   resolveSubcommandFlagContractsForCommand,
   PM_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-MDPEOIGN.js.map
+//# sourceMappingURL=chunk-RAHINBVP.js.map