@unbrained/pm-cli 2026.6.10 → 2026.6.12

package/dist/core/shared/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sources":["core/shared/constants.ts"],"sourceRoot":"/","sourcesContent":["import type {\n  BuiltinItemType,\n  GovernancePreset,\n  GovernanceSettings,\n  ItemFrontMatter,\n  PmSettings,\n  RuntimeStatusDefinition,\n  RuntimeWorkflowDefinition,\n} from \"../../types/index.js\";\nimport { createDefaultExtensionGovernancePolicy } from \"../extensions/extension-types.js\";\n\n/**\n * Canonical default lifecycle status model and workflow role mapping.\n *\n * Single source of truth: `SETTINGS_DEFAULTS.schema` references these, and\n * `src/core/schema/runtime-schema.ts` re-exports them as\n * `DEFAULT_RUNTIME_STATUS_DEFINITIONS` / `DEFAULT_RUNTIME_WORKFLOW`.\n */\nexport const DEFAULT_STATUS_DEFINITIONS: ReadonlyArray<RuntimeStatusDefinition> = Object.freeze([\n  {\n    id: \"draft\",\n    roles: [\"draft\"],\n  },\n  {\n    id: \"open\",\n    roles: [\"active\", \"default_open\"],\n  },\n  {\n    id: \"in_progress\",\n    aliases: [\"in-progress\"],\n    roles: [\"active\"],\n  },\n  {\n    id: \"blocked\",\n    roles: [\"blocked\"],\n  },\n  {\n    id: \"closed\",\n    roles: [\"terminal\", \"terminal_done\", \"default_close\"],\n  },\n  {\n    id: \"canceled\",\n    aliases: [\"cancelled\"],\n    roles: [\"terminal\", \"terminal_canceled\", \"default_cancel\"],\n  },\n]);\n\nexport const DEFAULT_WORKFLOW_DEFINITION: RuntimeWorkflowDefinition = Object.freeze({\n  draft_status: \"draft\",\n  open_status: \"open\",\n  in_progress_status: \"in_progress\",\n  blocked_status: \"blocked\",\n  close_status: \"closed\",\n  canceled_status: \"canceled\",\n});\n\nexport const PM_DIRNAME = \".agents/pm\";\nexport const SETTINGS_FILENAME = \"settings.json\";\n\nexport const PM_CORE_REQUIRED_SUBDIRS = [\n  \"\",\n  \"epics\",\n  \"features\",\n  \"tasks\",\n  \"chores\",\n  \"issues\",\n  \"schema\",\n  \"history\",\n  \"search\",\n  \"extensions\",\n  \"locks\",\n] as const;\n\nexport const PM_OPTIONAL_TYPE_SUBDIRS = [\n  \"decisions\",\n  \"events\",\n  \"reminders\",\n  \"milestones\",\n  \"meetings\",\n  \"plans\",\n] as const;\n\nexport const PM_REQUIRED_SUBDIRS = [...PM_CORE_REQUIRED_SUBDIRS, ...PM_OPTIONAL_TYPE_SUBDIRS] as const;\n\nexport const TYPE_TO_FOLDER: Record<BuiltinItemType, string> = {\n  Epic: \"epics\",\n  Feature: \"features\",\n  Task: \"tasks\",\n  Chore: \"chores\",\n  Issue: \"issues\",\n  Decision: \"decisions\",\n  Event: \"events\",\n  Reminder: \"reminders\",\n  Milestone: \"milestones\",\n  Meeting: \"meetings\",\n  Plan: \"plans\",\n};\n\nexport const FRONT_MATTER_KEY_ORDER: ReadonlyArray<string> = [\n  \"id\",\n  \"title\",\n  \"description\",\n  \"type\",\n  \"source_type\",\n  \"type_options\",\n  \"status\",\n  \"priority\",\n  \"tags\",\n  \"created_at\",\n  \"updated_at\",\n  \"deadline\",\n  \"reminders\",\n  \"events\",\n  \"closed_at\",\n  \"assignee\",\n  \"source_owner\",\n  \"author\",\n  \"estimated_minutes\",\n  \"acceptance_criteria\",\n  \"design\",\n  \"external_ref\",\n  \"definition_of_ready\",\n  \"order\",\n  \"goal\",\n  \"objective\",\n  \"value\",\n  \"impact\",\n  \"outcome\",\n  \"why_now\",\n  \"parent\",\n  \"reviewer\",\n  \"risk\",\n  \"confidence\",\n  \"sprint\",\n  \"release\",\n  \"blocked_by\",\n  \"blocked_reason\",\n  \"unblock_note\",\n  \"reporter\",\n  \"severity\",\n  \"environment\",\n  \"repro_steps\",\n  \"resolution\",\n  \"expected_result\",\n  \"actual_result\",\n  \"affected_version\",\n  \"fixed_version\",\n  \"component\",\n  \"regression\",\n  \"customer_impact\",\n  \"dependencies\",\n  \"comments\",\n  \"notes\",\n  \"learnings\",\n  \"files\",\n  \"tests\",\n  \"test_runs\",\n  \"docs\",\n  \"close_reason\",\n  \"duplicate_of\",\n  \"plan_mode\",\n  \"plan_scope\",\n  \"plan_harness\",\n  \"plan_resume_context\",\n  \"plan_validation\",\n  \"plan_decisions\",\n  \"plan_discoveries\",\n  \"plan_steps\",\n];\n\ntype BuiltinGovernancePreset = Exclude<GovernancePreset, \"custom\">;\n\nexport const GOVERNANCE_PRESET_DEFAULTS: Record<BuiltinGovernancePreset, Omit<GovernanceSettings, \"preset\">> = {\n  minimal: {\n    ownership_enforcement: \"none\",\n    create_mode_default: \"progressive\",\n    close_validation_default: \"off\",\n    require_close_reason: true,\n    parent_reference: \"strict_error\",\n    metadata_profile: \"core\",\n    force_required_for_stale_lock: false,\n  },\n  default: {\n    ownership_enforcement: \"warn\",\n    create_mode_default: \"progressive\",\n    close_validation_default: \"warn\",\n    require_close_reason: true,\n    parent_reference: \"strict_error\",\n    metadata_profile: \"core\",\n    force_required_for_stale_lock: true,\n  },\n  strict: {\n    ownership_enforcement: \"strict\",\n    create_mode_default: \"strict\",\n    close_validation_default: \"strict\",\n    require_close_reason: true,\n    parent_reference: \"strict_error\",\n    metadata_profile: \"strict\",\n    force_required_for_stale_lock: true,\n  },\n};\n\nexport const DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS = [\n  \"no active blocker\",\n  \"ready for planned execution sequencing\",\n  \"work completed\",\n  \"work is closed\",\n] as const;\n\nexport const DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS = {\n  blocked_reason: [\"no active blocker because work is closed\", \"work is closed\"],\n  resolution: [\"closed with implementation evidence\", \"closed with verification evidence\", \"work completed and recorded\", \"work is closed\"],\n  actual_result: [\"closed and recorded\", \"work completed\", \"work completed and recorded\"],\n} as const;\n\nfunction cloneOptionalArray<T>(values: readonly T[] | undefined): T[] | undefined {\n  return values ? [...values] : undefined;\n}\n\nexport const SETTINGS_DEFAULTS: PmSettings = {\n  version: 1,\n  id_prefix: \"pm-\",\n  author_default: \"\",\n  item_format: \"toon\",\n  locks: {\n    ttl_seconds: 1800,\n  },\n  output: {\n    default_format: \"toon\",\n  },\n  history: {\n    missing_stream: \"auto_create\",\n  },\n  validation: {\n    sprint_release_format: \"warn\",\n    parent_reference: \"warn\",\n    metadata_profile: \"core\",\n    metadata_required_fields: [],\n    lifecycle_stale_blocker_reason_patterns: [...DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS],\n    lifecycle_closure_like_blocked_reason_patterns: [\n      ...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.blocked_reason,\n    ],\n    lifecycle_closure_like_resolution_patterns: [...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.resolution],\n    lifecycle_closure_like_actual_result_patterns: [\n      ...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.actual_result,\n    ],\n  },\n  governance: {\n    preset: \"minimal\",\n    ...GOVERNANCE_PRESET_DEFAULTS.minimal,\n  },\n  workflow: {\n    definition_of_done: [],\n  },\n  testing: {\n    record_results_to_items: false,\n  },\n  telemetry: {\n    enabled: true,\n    first_run_prompt_completed: false,\n    capture_level: \"redacted\",\n    endpoint: \"https://pm-cli.unbrained.dev/v1/events\",\n    installation_id: \"\",\n    retention_days: 365,\n  },\n  agent_guidance: {\n    prompt_completed: false,\n    declined: false,\n    declined_at: \"\",\n    template_version: 1,\n    last_checked_files: [],\n  },\n  item_types: {\n    definitions: [],\n  },\n  schema: {\n    version: 1,\n    files: {\n      types: \"schema/types.json\",\n      statuses: \"schema/statuses.json\",\n      fields: \"schema/fields.json\",\n      workflows: \"schema/workflows.json\",\n    },\n    statuses: DEFAULT_STATUS_DEFINITIONS.map((definition) => ({\n      ...definition,\n      aliases: cloneOptionalArray(definition.aliases),\n      roles: cloneOptionalArray(definition.roles),\n    })),\n    fields: [],\n    workflow: { ...DEFAULT_WORKFLOW_DEFINITION },\n    unknown_field_policy: \"allow\",\n  },\n  extensions: {\n    enabled: [],\n    disabled: [],\n    policy: createDefaultExtensionGovernancePolicy(),\n  },\n  search: {\n    score_threshold: 0,\n    hybrid_semantic_weight: 0.7,\n    max_results: 50,\n    embedding_model: \"\",\n    embedding_batch_size: 32,\n    embedding_timeout_ms: 30_000,\n    scanner_max_batch_retries: 3,\n    provider: \"\",\n    mutation_refresh_policy: \"semantic_configured\",\n    query_expansion: {\n      enabled: false,\n      provider: \"\",\n    },\n    rerank: {\n      enabled: false,\n      model: \"\",\n      top_k: 20,\n    },\n  },\n  providers: {\n    openai: {\n      base_url: \"\",\n      api_key: \"\",\n      model: \"\",\n    },\n    ollama: {\n      base_url: \"\",\n      model: \"\",\n    },\n  },\n  context: {\n    default_depth: \"brief\",\n    activity_limit: 10,\n    stale_threshold_days: 7,\n    sections: {\n      hierarchy: true,\n      activity: true,\n      progress: true,\n      recently_created: true,\n      unparented: true,\n      blockers: true,\n      files: true,\n      workload: true,\n      staleness: true,\n      tests: true,\n    },\n  },\n  vector_store: {\n    adapter: \"\",\n    collection_name: \"pm_items\",\n    qdrant: {\n      url: \"\",\n      api_key: \"\",\n    },\n    lancedb: {\n      path: \"\",\n    },\n  },\n};\n\nexport const EMPTY_CANONICAL_DOCUMENT = {\n  metadata: {},\n  body: \"\",\n};\n\nexport const EXIT_CODE = {\n  SUCCESS: 0,\n  GENERIC_FAILURE: 1,\n  USAGE: 2,\n  NOT_FOUND: 3,\n  CONFLICT: 4,\n  DEPENDENCY_FAILED: 5,\n} as const;\n\nexport type TelemetryErrorCategory = \"usage\" | \"validation\" | \"conflict\" | \"runtime\" | \"unknown\";\n\nexport const TELEMETRY_ERROR_CATEGORY_BY_CODE: Readonly<Record<string, TelemetryErrorCategory>> = Object.freeze({\n  unknown_command: \"usage\",\n  unknown_option: \"usage\",\n  missing_required_option: \"usage\",\n  missing_required_argument: \"usage\",\n  invalid_command_usage: \"usage\",\n  invalid_argument_value: \"validation\",\n  health_findings: \"validation\",\n  validation_findings: \"validation\",\n  close_through_update: \"validation\",\n  no_update_fields: \"validation\",\n  unsupported_update_option: \"validation\",\n  tracker_not_initialized: \"validation\",\n  item_not_found: \"validation\",\n  ownership_conflict: \"conflict\",\n  lock_conflict: \"conflict\",\n  terminal_state_conflict: \"conflict\",\n  dependency_failed: \"runtime\",\n  command_failed: \"runtime\",\n  unknown_error: \"runtime\",\n});\n\nexport function resolveTelemetryErrorCategory(errorCode: string | undefined): TelemetryErrorCategory {\n  const normalized = (errorCode ?? \"\").trim().toLowerCase();\n  if (normalized.length === 0) {\n    return \"unknown\";\n  }\n  const explicit = TELEMETRY_ERROR_CATEGORY_BY_CODE[normalized];\n  if (typeof explicit === \"string\") {\n    return explicit;\n  }\n  if (normalized.includes(\"conflict\") || normalized.includes(\"locked\")) {\n    return \"conflict\";\n  }\n  if (normalized.startsWith(\"unknown_\") || normalized.startsWith(\"missing_required_\")) {\n    return \"usage\";\n  }\n  if (normalized.startsWith(\"invalid_\") || normalized.endsWith(\"_not_found\") || normalized.includes(\"validation\")) {\n    return \"validation\";\n  }\n  if (normalized.endsWith(\"_error\") || normalized.endsWith(\"_failed\")) {\n    return \"runtime\";\n  }\n  return \"unknown\";\n}\n"],"names":[],"mappings":"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","debugId":"e3d8f708-ea81-58a5-920a-ee9f27c436ab"}
+{"version":3,"file":"constants.js","sources":["core/shared/constants.ts"],"sourceRoot":"/","sourcesContent":["import type {\n  BuiltinItemType,\n  GovernancePreset,\n  GovernanceSettings,\n  ItemFrontMatter,\n  PmSettings,\n  RuntimeStatusDefinition,\n  RuntimeWorkflowDefinition,\n} from \"../../types/index.js\";\nimport { createDefaultExtensionGovernancePolicy } from \"../extensions/extension-types.js\";\n\n/**\n * Canonical default lifecycle status model and workflow role mapping.\n *\n * Single source of truth: `SETTINGS_DEFAULTS.schema` references these, and\n * `src/core/schema/runtime-schema.ts` re-exports them as\n * `DEFAULT_RUNTIME_STATUS_DEFINITIONS` / `DEFAULT_RUNTIME_WORKFLOW`.\n */\nexport const DEFAULT_STATUS_DEFINITIONS: ReadonlyArray<RuntimeStatusDefinition> = Object.freeze([\n  {\n    id: \"draft\",\n    roles: [\"draft\"],\n  },\n  {\n    id: \"open\",\n    roles: [\"active\", \"default_open\"],\n  },\n  {\n    id: \"in_progress\",\n    aliases: [\"in-progress\"],\n    roles: [\"active\"],\n  },\n  {\n    id: \"blocked\",\n    roles: [\"blocked\"],\n  },\n  {\n    id: \"closed\",\n    roles: [\"terminal\", \"terminal_done\", \"default_close\"],\n  },\n  {\n    id: \"canceled\",\n    aliases: [\"cancelled\"],\n    roles: [\"terminal\", \"terminal_canceled\", \"default_cancel\"],\n  },\n]);\n\nexport const DEFAULT_WORKFLOW_DEFINITION: RuntimeWorkflowDefinition = Object.freeze({\n  draft_status: \"draft\",\n  open_status: \"open\",\n  in_progress_status: \"in_progress\",\n  blocked_status: \"blocked\",\n  close_status: \"closed\",\n  canceled_status: \"canceled\",\n});\n\nexport const PM_DIRNAME = \".agents/pm\";\nexport const SETTINGS_FILENAME = \"settings.json\";\n\nexport const PM_CORE_REQUIRED_SUBDIRS = [\n  \"\",\n  \"epics\",\n  \"features\",\n  \"tasks\",\n  \"chores\",\n  \"issues\",\n  \"schema\",\n  \"history\",\n  \"search\",\n  \"extensions\",\n  \"locks\",\n] as const;\n\nexport const PM_OPTIONAL_TYPE_SUBDIRS = [\n  \"decisions\",\n  \"events\",\n  \"reminders\",\n  \"milestones\",\n  \"meetings\",\n  \"plans\",\n] as const;\n\nexport const PM_REQUIRED_SUBDIRS = [...PM_CORE_REQUIRED_SUBDIRS, ...PM_OPTIONAL_TYPE_SUBDIRS] as const;\n\nexport const TYPE_TO_FOLDER: Record<BuiltinItemType, string> = {\n  Epic: \"epics\",\n  Feature: \"features\",\n  Task: \"tasks\",\n  Chore: \"chores\",\n  Issue: \"issues\",\n  Decision: \"decisions\",\n  Event: \"events\",\n  Reminder: \"reminders\",\n  Milestone: \"milestones\",\n  Meeting: \"meetings\",\n  Plan: \"plans\",\n};\n\nexport const FRONT_MATTER_KEY_ORDER: ReadonlyArray<string> = [\n  \"id\",\n  \"title\",\n  \"description\",\n  \"type\",\n  \"source_type\",\n  \"type_options\",\n  \"status\",\n  \"priority\",\n  \"tags\",\n  \"created_at\",\n  \"updated_at\",\n  \"deadline\",\n  \"reminders\",\n  \"events\",\n  \"closed_at\",\n  \"assignee\",\n  \"source_owner\",\n  \"author\",\n  \"estimated_minutes\",\n  \"acceptance_criteria\",\n  \"design\",\n  \"external_ref\",\n  \"definition_of_ready\",\n  \"order\",\n  \"goal\",\n  \"objective\",\n  \"value\",\n  \"impact\",\n  \"outcome\",\n  \"why_now\",\n  \"parent\",\n  \"reviewer\",\n  \"risk\",\n  \"confidence\",\n  \"sprint\",\n  \"release\",\n  \"blocked_by\",\n  \"blocked_reason\",\n  \"unblock_note\",\n  \"reporter\",\n  \"severity\",\n  \"environment\",\n  \"repro_steps\",\n  \"resolution\",\n  \"expected_result\",\n  \"actual_result\",\n  \"affected_version\",\n  \"fixed_version\",\n  \"component\",\n  \"regression\",\n  \"customer_impact\",\n  \"dependencies\",\n  \"comments\",\n  \"notes\",\n  \"learnings\",\n  \"files\",\n  \"tests\",\n  \"test_runs\",\n  \"docs\",\n  \"close_reason\",\n  \"duplicate_of\",\n  \"plan_mode\",\n  \"plan_scope\",\n  \"plan_harness\",\n  \"plan_resume_context\",\n  \"plan_validation\",\n  \"plan_decisions\",\n  \"plan_discoveries\",\n  \"plan_steps\",\n];\n\ntype BuiltinGovernancePreset = Exclude<GovernancePreset, \"custom\">;\n\nexport const GOVERNANCE_PRESET_DEFAULTS: Record<BuiltinGovernancePreset, Omit<GovernanceSettings, \"preset\">> = {\n  minimal: {\n    ownership_enforcement: \"none\",\n    create_mode_default: \"progressive\",\n    close_validation_default: \"off\",\n    require_close_reason: true,\n    parent_reference: \"strict_error\",\n    metadata_profile: \"core\",\n    force_required_for_stale_lock: false,\n  },\n  default: {\n    ownership_enforcement: \"warn\",\n    create_mode_default: \"progressive\",\n    close_validation_default: \"warn\",\n    require_close_reason: true,\n    parent_reference: \"strict_error\",\n    metadata_profile: \"core\",\n    force_required_for_stale_lock: true,\n  },\n  strict: {\n    ownership_enforcement: \"strict\",\n    create_mode_default: \"strict\",\n    close_validation_default: \"strict\",\n    require_close_reason: true,\n    parent_reference: \"strict_error\",\n    metadata_profile: \"strict\",\n    force_required_for_stale_lock: true,\n  },\n};\n\nexport const DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS = [\n  \"no active blocker\",\n  \"ready for planned execution sequencing\",\n  \"work completed\",\n  \"work is closed\",\n] as const;\n\nexport const DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS = {\n  blocked_reason: [\"no active blocker because work is closed\", \"work is closed\"],\n  resolution: [\"closed with implementation evidence\", \"closed with verification evidence\", \"work completed and recorded\", \"work is closed\"],\n  actual_result: [\"closed and recorded\", \"work completed\", \"work completed and recorded\"],\n} as const;\n\nfunction cloneOptionalArray<T>(values: readonly T[] | undefined): T[] | undefined {\n  return values ? [...values] : undefined;\n}\n\nexport const SETTINGS_DEFAULTS: PmSettings = {\n  version: 1,\n  id_prefix: \"pm-\",\n  author_default: \"\",\n  item_format: \"toon\",\n  locks: {\n    ttl_seconds: 1800,\n  },\n  output: {\n    default_format: \"toon\",\n  },\n  history: {\n    missing_stream: \"auto_create\",\n  },\n  validation: {\n    sprint_release_format: \"warn\",\n    parent_reference: \"warn\",\n    metadata_profile: \"core\",\n    metadata_required_fields: [],\n    lifecycle_stale_blocker_reason_patterns: [...DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS],\n    lifecycle_closure_like_blocked_reason_patterns: [\n      ...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.blocked_reason,\n    ],\n    lifecycle_closure_like_resolution_patterns: [...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.resolution],\n    lifecycle_closure_like_actual_result_patterns: [\n      ...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.actual_result,\n    ],\n  },\n  governance: {\n    preset: \"minimal\",\n    ...GOVERNANCE_PRESET_DEFAULTS.minimal,\n  },\n  workflow: {\n    definition_of_done: [],\n  },\n  testing: {\n    record_results_to_items: false,\n  },\n  telemetry: {\n    enabled: true,\n    first_run_prompt_completed: false,\n    capture_level: \"redacted\",\n    endpoint: \"https://pm-cli.unbrained.dev/v1/events\",\n    installation_id: \"\",\n    retention_days: 365,\n  },\n  agent_guidance: {\n    prompt_completed: false,\n    declined: false,\n    declined_at: \"\",\n    template_version: 1,\n    last_checked_files: [],\n  },\n  item_types: {\n    definitions: [],\n  },\n  schema: {\n    version: 1,\n    files: {\n      types: \"schema/types.json\",\n      statuses: \"schema/statuses.json\",\n      fields: \"schema/fields.json\",\n      workflows: \"schema/workflows.json\",\n    },\n    statuses: DEFAULT_STATUS_DEFINITIONS.map((definition) => ({\n      ...definition,\n      aliases: cloneOptionalArray(definition.aliases),\n      roles: cloneOptionalArray(definition.roles),\n    })),\n    fields: [],\n    workflow: { ...DEFAULT_WORKFLOW_DEFINITION },\n    unknown_field_policy: \"allow\",\n  },\n  extensions: {\n    enabled: [],\n    disabled: [],\n    policy: createDefaultExtensionGovernancePolicy(),\n  },\n  search: {\n    score_threshold: 0,\n    hybrid_semantic_weight: 0.7,\n    max_results: 50,\n    embedding_model: \"\",\n    embedding_batch_size: 32,\n    embedding_timeout_ms: 30_000,\n    scanner_max_batch_retries: 3,\n    provider: \"\",\n    mutation_refresh_policy: \"semantic_configured\",\n    query_expansion: {\n      enabled: false,\n      provider: \"\",\n    },\n    rerank: {\n      enabled: false,\n      model: \"\",\n      top_k: 20,\n    },\n  },\n  providers: {\n    openai: {\n      base_url: \"\",\n      api_key: \"\",\n      model: \"\",\n    },\n    ollama: {\n      base_url: \"\",\n      model: \"\",\n    },\n  },\n  context: {\n    default_depth: \"brief\",\n    activity_limit: 10,\n    stale_threshold_days: 7,\n    sections: {\n      hierarchy: true,\n      activity: true,\n      progress: true,\n      recently_created: true,\n      unparented: true,\n      blockers: true,\n      files: true,\n      workload: true,\n      staleness: true,\n      tests: true,\n    },\n  },\n  vector_store: {\n    adapter: \"\",\n    collection_name: \"pm_items\",\n    qdrant: {\n      url: \"\",\n      api_key: \"\",\n    },\n    lancedb: {\n      path: \"\",\n    },\n  },\n};\n\nexport const EMPTY_CANONICAL_DOCUMENT = {\n  metadata: {},\n  body: \"\",\n};\n\nexport const EXIT_CODE = {\n  SUCCESS: 0,\n  GENERIC_FAILURE: 1,\n  USAGE: 2,\n  NOT_FOUND: 3,\n  CONFLICT: 4,\n  DEPENDENCY_FAILED: 5,\n} as const;\n\nexport type TelemetryErrorCategory = \"usage\" | \"validation\" | \"conflict\" | \"runtime\" | \"unknown\";\n\nexport const TELEMETRY_ERROR_CATEGORY_BY_CODE: Readonly<Record<string, TelemetryErrorCategory>> = Object.freeze({\n  unknown_command: \"usage\",\n  unknown_option: \"usage\",\n  missing_required_option: \"usage\",\n  missing_required_argument: \"usage\",\n  invalid_command_usage: \"usage\",\n  linked_test_value_not_quoted: \"usage\",\n  invalid_argument_value: \"validation\",\n  health_findings: \"validation\",\n  validation_findings: \"validation\",\n  close_through_update: \"validation\",\n  no_update_fields: \"validation\",\n  unsupported_update_option: \"validation\",\n  tracker_not_initialized: \"validation\",\n  item_not_found: \"validation\",\n  ownership_conflict: \"conflict\",\n  lock_conflict: \"conflict\",\n  terminal_state_conflict: \"conflict\",\n  dependency_failed: \"runtime\",\n  command_failed: \"runtime\",\n  unknown_error: \"runtime\",\n});\n\nexport function resolveTelemetryErrorCategory(errorCode: string | undefined): TelemetryErrorCategory {\n  const normalized = (errorCode ?? \"\").trim().toLowerCase();\n  if (normalized.length === 0) {\n    return \"unknown\";\n  }\n  const explicit = TELEMETRY_ERROR_CATEGORY_BY_CODE[normalized];\n  if (typeof explicit === \"string\") {\n    return explicit;\n  }\n  if (normalized.includes(\"conflict\") || normalized.includes(\"locked\")) {\n    return \"conflict\";\n  }\n  if (normalized.startsWith(\"unknown_\") || normalized.startsWith(\"missing_required_\")) {\n    return \"usage\";\n  }\n  if (normalized.startsWith(\"invalid_\") || normalized.endsWith(\"_not_found\") || normalized.includes(\"validation\")) {\n    return \"validation\";\n  }\n  if (normalized.endsWith(\"_error\") || normalized.endsWith(\"_failed\")) {\n    return \"runtime\";\n  }\n  return \"unknown\";\n}\n"],"names":[],"mappings":"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","debugId":"aaaabb17-ee0f-5c5d-8111-3406542035c3"}

package/dist/core/telemetry/consent.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c965da5d-6609-5258-ba49-a57475f7f2ef")}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]="7804d4bf-ff46-50af-9af5-533f83c3d445")}catch(e){}}();
 import readline from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 import { resolveGlobalPmRoot } from "../store/paths.js";
@@ -13,6 +13,21 @@ function parseBooleanLike(value) {
     }
     return TELEMETRY_PROMPT_DISABLE_VALUES.has(value.trim().toLowerCase());
 }
+// pm-0hx2: the CI guard must fire when CI is SET to a truthy value (CI=true,
+// CI=1, ...). An unset or empty CI behaves as "not CI", and the conventional
+// falsy spellings ("0", "false", "no", "off") explicitly opt back out of the
+// guard. This is intentionally NOT parseBooleanLike, which matches only the
+// disable set and would invert the check.
+function isTruthyEnvValue(value) {
+    if (typeof value !== "string") {
+        return false;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized.length === 0) {
+        return false;
+    }
+    return !TELEMETRY_PROMPT_DISABLE_VALUES.has(normalized);
+}
 function shouldSkipTelemetryPrompt(commandPath, globalOptions) {
     if (globalOptions.json === true || globalOptions.quiet === true) {
         return true;
@@ -23,7 +38,7 @@ function shouldSkipTelemetryPrompt(commandPath, globalOptions) {
     if (parseBooleanLike(process.env[TELEMETRY_PROMPT_DISABLE_ENV])) {
         return true;
     }
-    if (parseBooleanLike(process.env.CI)) {
+    if (isTruthyEnvValue(process.env.CI)) {
         return true;
     }
     const normalizedCommandPath = commandPath.trim().toLowerCase();
@@ -79,4 +94,4 @@ export async function maybeRunFirstUseTelemetryPrompt(commandPath, globalOptions
     }
 }
 //# sourceMappingURL=consent.js.map
-//# debugId=c965da5d-6609-5258-ba49-a57475f7f2ef
+//# debugId=7804d4bf-ff46-50af-9af5-533f83c3d445

package/dist/core/telemetry/consent.js.map

@@ -1 +1 @@
-{"version":3,"file":"consent.js","sources":["core/telemetry/consent.ts"],"sourceRoot":"/","sourcesContent":["import readline from \"node:readline/promises\";\nimport { stdin as input, stdout as output } from \"node:process\";\nimport type { GlobalOptions } from \"../shared/command-types.js\";\nimport { resolveGlobalPmRoot } from \"../store/paths.js\";\nimport { readSettings, writeSettings } from \"../store/settings.js\";\n\nconst TELEMETRY_PROMPT_DISABLE_ENV = \"PM_TELEMETRY_PROMPT\";\nconst TELEMETRY_PROMPT_DISABLE_VALUES = new Set([\"0\", \"false\", \"no\", \"off\"]);\nconst TELEMETRY_PROMPT_SKIPPED_COMMANDS = new Set([\"init\", \"completion\", \"completion-statuses\", \"completion-tags\", \"completion-types\"]);\n\nfunction parseBooleanLike(value: string | undefined): boolean {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n  return TELEMETRY_PROMPT_DISABLE_VALUES.has(value.trim().toLowerCase());\n}\n\nfunction shouldSkipTelemetryPrompt(commandPath: string, globalOptions: GlobalOptions): boolean {\n  if (globalOptions.json === true || globalOptions.quiet === true) {\n    return true;\n  }\n  if (process.stdin.isTTY !== true || process.stdout.isTTY !== true) {\n    return true;\n  }\n  if (parseBooleanLike(process.env[TELEMETRY_PROMPT_DISABLE_ENV])) {\n    return true;\n  }\n  if (parseBooleanLike(process.env.CI)) {\n    return true;\n  }\n  const normalizedCommandPath = commandPath.trim().toLowerCase();\n  if (normalizedCommandPath.length === 0) {\n    return true;\n  }\n  return TELEMETRY_PROMPT_SKIPPED_COMMANDS.has(normalizedCommandPath);\n}\n\nfunction parseTelemetryPromptAnswer(answer: string): boolean {\n  const normalized = answer.trim().toLowerCase();\n  if (normalized === \"n\" || normalized === \"no\") {\n    return false;\n  }\n  return true;\n}\n\nasync function promptTelemetryConsent(currentDefault: boolean): Promise<boolean> {\n  const defaultLabel = currentDefault ? \"Y/n\" : \"y/N\";\n  const prompt =\n    `pm telemetry helps improve reliability and usage diagnostics.\\n` +\n    `It is enabled by default and can be changed anytime via:\\n` +\n    `pm config global set telemetry-tracking --policy disabled\\n` +\n    `Enable telemetry now? [${defaultLabel}] `;\n  const rl = readline.createInterface({ input, output });\n  try {\n    const answer = await rl.question(prompt);\n    if (answer.trim().length === 0) {\n      return currentDefault;\n    }\n    return parseTelemetryPromptAnswer(answer);\n  } finally {\n    rl.close();\n  }\n}\n\nexport async function maybeRunFirstUseTelemetryPrompt(commandPath: string, globalOptions: GlobalOptions): Promise<void> {\n  if (shouldSkipTelemetryPrompt(commandPath, globalOptions)) {\n    return;\n  }\n  try {\n    const globalPmRoot = resolveGlobalPmRoot(process.cwd());\n    const settings = await readSettings(globalPmRoot);\n    if (settings.telemetry.first_run_prompt_completed) {\n      return;\n    }\n    const enabled = await promptTelemetryConsent(settings.telemetry.enabled);\n    settings.telemetry.enabled = enabled;\n    settings.telemetry.first_run_prompt_completed = true;\n    await writeSettings(globalPmRoot, settings, \"telemetry:first_run_prompt\");\n    output.write(\n      `Telemetry ${enabled ? \"enabled\" : \"disabled\"} for this CLI install. ` +\n        `Update any time with pm config global set telemetry-tracking --policy ${enabled ? \"disabled\" : \"enabled\"}.\\n`,\n    );\n  } catch {\n    // Prompt and persistence failures should never block command execution.\n  }\n}\n"],"names":[],"mappings":"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","debugId":"c965da5d-6609-5258-ba49-a57475f7f2ef"}
+{"version":3,"file":"consent.js","sources":["core/telemetry/consent.ts"],"sourceRoot":"/","sourcesContent":["import readline from \"node:readline/promises\";\nimport { stdin as input, stdout as output } from \"node:process\";\nimport type { GlobalOptions } from \"../shared/command-types.js\";\nimport { resolveGlobalPmRoot } from \"../store/paths.js\";\nimport { readSettings, writeSettings } from \"../store/settings.js\";\n\nconst TELEMETRY_PROMPT_DISABLE_ENV = \"PM_TELEMETRY_PROMPT\";\nconst TELEMETRY_PROMPT_DISABLE_VALUES = new Set([\"0\", \"false\", \"no\", \"off\"]);\nconst TELEMETRY_PROMPT_SKIPPED_COMMANDS = new Set([\"init\", \"completion\", \"completion-statuses\", \"completion-tags\", \"completion-types\"]);\n\nfunction parseBooleanLike(value: string | undefined): boolean {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n  return TELEMETRY_PROMPT_DISABLE_VALUES.has(value.trim().toLowerCase());\n}\n\n// pm-0hx2: the CI guard must fire when CI is SET to a truthy value (CI=true,\n// CI=1, ...). An unset or empty CI behaves as \"not CI\", and the conventional\n// falsy spellings (\"0\", \"false\", \"no\", \"off\") explicitly opt back out of the\n// guard. This is intentionally NOT parseBooleanLike, which matches only the\n// disable set and would invert the check.\nfunction isTruthyEnvValue(value: string | undefined): boolean {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n  const normalized = value.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return false;\n  }\n  return !TELEMETRY_PROMPT_DISABLE_VALUES.has(normalized);\n}\n\nfunction shouldSkipTelemetryPrompt(commandPath: string, globalOptions: GlobalOptions): boolean {\n  if (globalOptions.json === true || globalOptions.quiet === true) {\n    return true;\n  }\n  if (process.stdin.isTTY !== true || process.stdout.isTTY !== true) {\n    return true;\n  }\n  if (parseBooleanLike(process.env[TELEMETRY_PROMPT_DISABLE_ENV])) {\n    return true;\n  }\n  if (isTruthyEnvValue(process.env.CI)) {\n    return true;\n  }\n  const normalizedCommandPath = commandPath.trim().toLowerCase();\n  if (normalizedCommandPath.length === 0) {\n    return true;\n  }\n  return TELEMETRY_PROMPT_SKIPPED_COMMANDS.has(normalizedCommandPath);\n}\n\nfunction parseTelemetryPromptAnswer(answer: string): boolean {\n  const normalized = answer.trim().toLowerCase();\n  if (normalized === \"n\" || normalized === \"no\") {\n    return false;\n  }\n  return true;\n}\n\nasync function promptTelemetryConsent(currentDefault: boolean): Promise<boolean> {\n  const defaultLabel = currentDefault ? \"Y/n\" : \"y/N\";\n  const prompt =\n    `pm telemetry helps improve reliability and usage diagnostics.\\n` +\n    `It is enabled by default and can be changed anytime via:\\n` +\n    `pm config global set telemetry-tracking --policy disabled\\n` +\n    `Enable telemetry now? [${defaultLabel}] `;\n  const rl = readline.createInterface({ input, output });\n  try {\n    const answer = await rl.question(prompt);\n    if (answer.trim().length === 0) {\n      return currentDefault;\n    }\n    return parseTelemetryPromptAnswer(answer);\n  } finally {\n    rl.close();\n  }\n}\n\nexport async function maybeRunFirstUseTelemetryPrompt(commandPath: string, globalOptions: GlobalOptions): Promise<void> {\n  if (shouldSkipTelemetryPrompt(commandPath, globalOptions)) {\n    return;\n  }\n  try {\n    const globalPmRoot = resolveGlobalPmRoot(process.cwd());\n    const settings = await readSettings(globalPmRoot);\n    if (settings.telemetry.first_run_prompt_completed) {\n      return;\n    }\n    const enabled = await promptTelemetryConsent(settings.telemetry.enabled);\n    settings.telemetry.enabled = enabled;\n    settings.telemetry.first_run_prompt_completed = true;\n    await writeSettings(globalPmRoot, settings, \"telemetry:first_run_prompt\");\n    output.write(\n      `Telemetry ${enabled ? \"enabled\" : \"disabled\"} for this CLI install. ` +\n        `Update any time with pm config global set telemetry-tracking --policy ${enabled ? \"disabled\" : \"enabled\"}.\\n`,\n    );\n  } catch {\n    // Prompt and persistence failures should never block command execution.\n  }\n}\n"],"names":[],"mappings":"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","debugId":"7804d4bf-ff46-50af-9af5-533f83c3d445"}

package/dist/core/validate/fix-planning.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Fix planning for `pm validate --auto-fix` / `--prune-missing` (pm-c3sz,
+ * pm-8jss, pm-0v2m).
+ *
+ * Pure module: planners turn check findings into declarative
+ * {@link ValidateFixRecord}s; the validate command decides whether to apply
+ * them (apply mode), preview them (`--dry-run`), or withhold gated fixes
+ * (lifecycle structural changes require an explicit `--fix-scope lifecycle`).
+ *
+ * Safety invariants:
+ * - Every planned fix is deterministic and non-destructive: it only sets a
+ *   derivable field value or removes a stale LINK (never a real file).
+ * - No fix ever closes, deletes, or cancels an item.
+ * - Lifecycle fixes (reparent / unset parent) are structural, so they are
+ *   planned with `gate: "lifecycle"` and only applied when that scope was
+ *   explicitly granted.
+ */
+export type ValidateFixCheck = "metadata" | "resolution" | "lifecycle" | "files";
+export type ValidateFixKind = "set_resolution" | "set_close_reason" | "reparent" | "unset_parent" | "prune_file_link" | "prune_doc_link";
+export type ValidateFixScope = "metadata" | "resolution" | "lifecycle";
+/** Scopes auto-applied without an explicit `--fix-scope` (safe field backfills). */
+export declare const DEFAULT_GRANTED_FIX_SCOPES: readonly ValidateFixScope[];
+/** Scopes accepted by `--fix-scope` (lifecycle is the opt-in structural scope). */
+export declare const SUPPORTED_FIX_SCOPES: readonly ValidateFixScope[];
+export interface ValidateFixRecord {
+    /** Item the fix targets. */
+    item_id: string;
+    /** Validate check the finding came from. */
+    check: ValidateFixCheck;
+    /** Front-matter field (or link list) the fix changes. */
+    field: string;
+    /** Declarative fix kind the applier dispatches on. */
+    kind: ValidateFixKind;
+    /** Equivalent standalone `pm` command for the fix. */
+    command: string;
+    /** New value for set-field fixes. */
+    value?: string;
+    /** Stale link path for prune fixes. */
+    path?: string;
+    /** Target parent id for reparent fixes. */
+    parent_id?: string;
+    /**
+     * Fix scope the `--fix-scope` allowlist must grant for the fix to be
+     * applied. Every `--auto-fix` record carries one (the granted default is
+     * metadata+resolution; lifecycle must be named explicitly). Absent only on
+     * `--prune-missing` records, which are governed by their own flag.
+     */
+    gate?: ValidateFixScope;
+}
+/** Default resolution backfilled onto closed items with no derivable source text. */
+export declare const DEFAULT_RESOLUTION_BACKFILL_VALUE = "completed";
+export interface ResolutionBackfillRow {
+    id: string;
+    /** Resolution-check missing field keys for this closed item. */
+    missing_fields: readonly string[];
+    /** The item's close_reason, when present (preferred derivation source). */
+    close_reason?: string;
+}
+/**
+ * Plan resolution backfills for closed items flagged by the resolution check.
+ * Only the `resolution` field is mechanical enough to auto-fix: it derives
+ * from the item's own `close_reason` when present and falls back to the
+ * `"completed"` default. `expected_result` / `actual_result` stay hint-only —
+ * no deterministic source text exists for them.
+ */
+export declare function planResolutionBackfillFixes(rows: readonly ResolutionBackfillRow[]): ValidateFixRecord[];
+export interface CloseReasonBackfillRow {
+    id: string;
+    /** The item's resolution, when present (the only derivation source). */
+    resolution?: string;
+}
+/**
+ * Plan close_reason backfills for closed items flagged by the metadata check.
+ * Only derivable when the item already carries a resolution; items missing
+ * both stay hint-only (any synthesized reason would be fabricated, not
+ * derived).
+ */
+export declare function planCloseReasonBackfillFixes(rows: readonly CloseReasonBackfillRow[]): ValidateFixRecord[];
+export interface TerminalParentFixRow {
+    id: string;
+    parent_id: string;
+    /** The terminal parent's own parent, when one exists. */
+    grandparent_id?: string;
+    /** True when the grandparent exists and is NOT terminal (safe reparent target). */
+    grandparent_active?: boolean;
+}
+/**
+ * Plan lifecycle fixes for active items whose parent is terminal (pm-8jss /
+ * GH-168). When the terminal parent has an active grandparent, the child is
+ * reparented one level up (it stays inside the same hierarchy); otherwise the
+ * parent link is cleared so the item surfaces as unparented active work.
+ * Either way the item itself is never closed or mutated beyond `parent` —
+ * and every fix carries `gate: "lifecycle"` so it is only applied under an
+ * explicit `--fix-scope lifecycle`.
+ */
+export declare function planTerminalParentFixes(rows: readonly TerminalParentFixRow[]): ValidateFixRecord[];
+export interface StaleLinkPruneRow {
+    item_id: string;
+    path: string;
+    link_kind: "files" | "docs";
+    classification: "moved" | "deleted";
+}
+/**
+ * Plan link prunes for `--prune-missing` (pm-0v2m / GH-184). Only links whose
+ * stale path classified as `deleted` are pruned; `moved` links keep their
+ * relink candidates in the files-check details instead of being dropped, so
+ * recoverable link information is never destroyed. Link removal only — real
+ * files are never touched.
+ */
+export declare function planStaleLinkPruneFixes(rows: readonly StaleLinkPruneRow[]): ValidateFixRecord[];
+/**
+ * Resolve the granted `--fix-scope` set (repeatable and/or comma-separated).
+ * With no explicit scopes the safe field-backfill scopes (metadata,
+ * resolution) are granted; lifecycle must always be named explicitly. Unknown
+ * values fail fast with the supported list.
+ */
+export declare function resolveGrantedFixScopes(rawScopes: readonly string[] | undefined): Set<ValidateFixScope>;
+/**
+ * Split a fix plan into the records that may be applied under the granted
+ * scopes and the gated records that were withheld. `--fix-scope` is an exact
+ * allowlist: every `--auto-fix` record requires its gate scope in `granted`.
+ * Ungated records (`--prune-missing` link prunes, governed by their own flag)
+ * are always applicable.
+ */
+export declare function partitionFixesByGrant(fixes: readonly ValidateFixRecord[], granted: ReadonlySet<ValidateFixScope>): {
+    applicable: ValidateFixRecord[];
+    gated: ValidateFixRecord[];
+};
+/** Compact serialization of a fix for planned/applied output rows. */
+export declare function toFixOutputRow(fix: ValidateFixRecord): Record<string, unknown>;

package/dist/core/validate/fix-planning.js

@@ -0,0 +1,202 @@
+/**
+ * Fix planning for `pm validate --auto-fix` / `--prune-missing` (pm-c3sz,
+ * pm-8jss, pm-0v2m).
+ *
+ * Pure module: planners turn check findings into declarative
+ * {@link ValidateFixRecord}s; the validate command decides whether to apply
+ * them (apply mode), preview them (`--dry-run`), or withhold gated fixes
+ * (lifecycle structural changes require an explicit `--fix-scope lifecycle`).
+ *
+ * Safety invariants:
+ * - Every planned fix is deterministic and non-destructive: it only sets a
+ *   derivable field value or removes a stale LINK (never a real file).
+ * - No fix ever closes, deletes, or cancels an item.
+ * - Lifecycle fixes (reparent / unset parent) are structural, so they are
+ *   planned with `gate: "lifecycle"` and only applied when that scope was
+ *   explicitly granted.
+ */
+
+!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]="7163fbbf-1a9c-52e0-a1d5-6034abefc50f")}catch(e){}}();
+import { EXIT_CODE } from "../shared/constants.js";
+import { PmCliError } from "../shared/errors.js";
+/** Scopes auto-applied without an explicit `--fix-scope` (safe field backfills). */
+export const DEFAULT_GRANTED_FIX_SCOPES = ["metadata", "resolution"];
+/** Scopes accepted by `--fix-scope` (lifecycle is the opt-in structural scope). */
+export const SUPPORTED_FIX_SCOPES = ["metadata", "resolution", "lifecycle"];
+/** Default resolution backfilled onto closed items with no derivable source text. */
+export const DEFAULT_RESOLUTION_BACKFILL_VALUE = "completed";
+function quoteForCommand(value) {
+    return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
+}
+function toMeaningfulValue(value) {
+    const trimmed = value?.trim();
+    return trimmed !== undefined && trimmed.length > 0 ? trimmed : undefined;
+}
+/**
+ * Plan resolution backfills for closed items flagged by the resolution check.
+ * Only the `resolution` field is mechanical enough to auto-fix: it derives
+ * from the item's own `close_reason` when present and falls back to the
+ * `"completed"` default. `expected_result` / `actual_result` stay hint-only —
+ * no deterministic source text exists for them.
+ */
+export function planResolutionBackfillFixes(rows) {
+    const fixes = [];
+    for (const row of rows) {
+        if (!row.missing_fields.includes("resolution")) {
+            continue;
+        }
+        const value = toMeaningfulValue(row.close_reason) ?? DEFAULT_RESOLUTION_BACKFILL_VALUE;
+        fixes.push({
+            item_id: row.id,
+            check: "resolution",
+            field: "resolution",
+            kind: "set_resolution",
+            value,
+            command: `pm update ${row.id} --resolution ${quoteForCommand(value)}`,
+            gate: "resolution",
+        });
+    }
+    return fixes;
+}
+/**
+ * Plan close_reason backfills for closed items flagged by the metadata check.
+ * Only derivable when the item already carries a resolution; items missing
+ * both stay hint-only (any synthesized reason would be fabricated, not
+ * derived).
+ */
+export function planCloseReasonBackfillFixes(rows) {
+    const fixes = [];
+    for (const row of rows) {
+        const value = toMeaningfulValue(row.resolution);
+        if (value === undefined) {
+            continue;
+        }
+        fixes.push({
+            item_id: row.id,
+            check: "metadata",
+            field: "close_reason",
+            kind: "set_close_reason",
+            value,
+            command: `pm update ${row.id} --close-reason ${quoteForCommand(value)}`,
+            gate: "metadata",
+        });
+    }
+    return fixes;
+}
+/**
+ * Plan lifecycle fixes for active items whose parent is terminal (pm-8jss /
+ * GH-168). When the terminal parent has an active grandparent, the child is
+ * reparented one level up (it stays inside the same hierarchy); otherwise the
+ * parent link is cleared so the item surfaces as unparented active work.
+ * Either way the item itself is never closed or mutated beyond `parent` —
+ * and every fix carries `gate: "lifecycle"` so it is only applied under an
+ * explicit `--fix-scope lifecycle`.
+ */
+export function planTerminalParentFixes(rows) {
+    return rows.map((row) => {
+        if (row.grandparent_id !== undefined && row.grandparent_active === true) {
+            return {
+                item_id: row.id,
+                check: "lifecycle",
+                field: "parent",
+                kind: "reparent",
+                parent_id: row.grandparent_id,
+                command: `pm update ${row.id} --parent ${row.grandparent_id}`,
+                gate: "lifecycle",
+            };
+        }
+        return {
+            item_id: row.id,
+            check: "lifecycle",
+            field: "parent",
+            kind: "unset_parent",
+            command: `pm update ${row.id} --unset parent`,
+            gate: "lifecycle",
+        };
+    });
+}
+/**
+ * Plan link prunes for `--prune-missing` (pm-0v2m / GH-184). Only links whose
+ * stale path classified as `deleted` are pruned; `moved` links keep their
+ * relink candidates in the files-check details instead of being dropped, so
+ * recoverable link information is never destroyed. Link removal only — real
+ * files are never touched.
+ */
+export function planStaleLinkPruneFixes(rows) {
+    const fixes = [];
+    for (const row of rows) {
+        if (row.classification !== "deleted") {
+            continue;
+        }
+        const noun = row.link_kind === "files" ? "files" : "docs";
+        fixes.push({
+            item_id: row.item_id,
+            check: "files",
+            field: row.link_kind,
+            kind: row.link_kind === "files" ? "prune_file_link" : "prune_doc_link",
+            path: row.path,
+            command: `pm ${noun} ${row.item_id} --remove ${quoteForCommand(row.path)}`,
+        });
+    }
+    return fixes;
+}
+/**
+ * Resolve the granted `--fix-scope` set (repeatable and/or comma-separated).
+ * With no explicit scopes the safe field-backfill scopes (metadata,
+ * resolution) are granted; lifecycle must always be named explicitly. Unknown
+ * values fail fast with the supported list.
+ */
+export function resolveGrantedFixScopes(rawScopes) {
+    const tokens = (rawScopes ?? [])
+        .flatMap((raw) => raw.split(","))
+        .map((raw) => raw.trim())
+        .filter((raw) => raw.length > 0);
+    if (tokens.length === 0) {
+        if (rawScopes !== undefined && rawScopes.length > 0) {
+            throw new PmCliError(`--fix-scope values must not be empty. Supported values: ${SUPPORTED_FIX_SCOPES.join(", ")}.`, EXIT_CODE.USAGE);
+        }
+        return new Set(DEFAULT_GRANTED_FIX_SCOPES);
+    }
+    const granted = new Set();
+    for (const raw of tokens) {
+        const normalized = raw.toLowerCase().replaceAll("-", "_");
+        if (SUPPORTED_FIX_SCOPES.includes(normalized)) {
+            granted.add(normalized);
+            continue;
+        }
+        throw new PmCliError(`Unknown --fix-scope value "${raw}". Supported values: ${SUPPORTED_FIX_SCOPES.join(", ")}.`, EXIT_CODE.USAGE);
+    }
+    return granted;
+}
+/**
+ * Split a fix plan into the records that may be applied under the granted
+ * scopes and the gated records that were withheld. `--fix-scope` is an exact
+ * allowlist: every `--auto-fix` record requires its gate scope in `granted`.
+ * Ungated records (`--prune-missing` link prunes, governed by their own flag)
+ * are always applicable.
+ */
+export function partitionFixesByGrant(fixes, granted) {
+    const applicable = [];
+    const gated = [];
+    for (const fix of fixes) {
+        if (fix.gate !== undefined && !granted.has(fix.gate)) {
+            gated.push(fix);
+        }
+        else {
+            applicable.push(fix);
+        }
+    }
+    return { applicable, gated };
+}
+/** Compact serialization of a fix for planned/applied output rows. */
+export function toFixOutputRow(fix) {
+    return {
+        item_id: fix.item_id,
+        check: fix.check,
+        field: fix.field,
+        command: fix.command,
+        ...(fix.gate !== undefined ? { gate: fix.gate } : {}),
+    };
+}
+//# sourceMappingURL=fix-planning.js.map
+//# debugId=7163fbbf-1a9c-52e0-a1d5-6034abefc50f

package/dist/core/validate/fix-planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-planning.js","sources":["core/validate/fix-planning.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Fix planning for `pm validate --auto-fix` / `--prune-missing` (pm-c3sz,\n * pm-8jss, pm-0v2m).\n *\n * Pure module: planners turn check findings into declarative\n * {@link ValidateFixRecord}s; the validate command decides whether to apply\n * them (apply mode), preview them (`--dry-run`), or withhold gated fixes\n * (lifecycle structural changes require an explicit `--fix-scope lifecycle`).\n *\n * Safety invariants:\n * - Every planned fix is deterministic and non-destructive: it only sets a\n *   derivable field value or removes a stale LINK (never a real file).\n * - No fix ever closes, deletes, or cancels an item.\n * - Lifecycle fixes (reparent / unset parent) are structural, so they are\n *   planned with `gate: \"lifecycle\"` and only applied when that scope was\n *   explicitly granted.\n */\n\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nexport type ValidateFixCheck = \"metadata\" | \"resolution\" | \"lifecycle\" | \"files\";\n\nexport type ValidateFixKind =\n  | \"set_resolution\"\n  | \"set_close_reason\"\n  | \"reparent\"\n  | \"unset_parent\"\n  | \"prune_file_link\"\n  | \"prune_doc_link\";\n\nexport type ValidateFixScope = \"metadata\" | \"resolution\" | \"lifecycle\";\n\n/** Scopes auto-applied without an explicit `--fix-scope` (safe field backfills). */\nexport const DEFAULT_GRANTED_FIX_SCOPES: readonly ValidateFixScope[] = [\"metadata\", \"resolution\"];\n\n/** Scopes accepted by `--fix-scope` (lifecycle is the opt-in structural scope). */\nexport const SUPPORTED_FIX_SCOPES: readonly ValidateFixScope[] = [\"metadata\", \"resolution\", \"lifecycle\"];\n\nexport interface ValidateFixRecord {\n  /** Item the fix targets. */\n  item_id: string;\n  /** Validate check the finding came from. */\n  check: ValidateFixCheck;\n  /** Front-matter field (or link list) the fix changes. */\n  field: string;\n  /** Declarative fix kind the applier dispatches on. */\n  kind: ValidateFixKind;\n  /** Equivalent standalone `pm` command for the fix. */\n  command: string;\n  /** New value for set-field fixes. */\n  value?: string;\n  /** Stale link path for prune fixes. */\n  path?: string;\n  /** Target parent id for reparent fixes. */\n  parent_id?: string;\n  /**\n   * Fix scope the `--fix-scope` allowlist must grant for the fix to be\n   * applied. Every `--auto-fix` record carries one (the granted default is\n   * metadata+resolution; lifecycle must be named explicitly). Absent only on\n   * `--prune-missing` records, which are governed by their own flag.\n   */\n  gate?: ValidateFixScope;\n}\n\n/** Default resolution backfilled onto closed items with no derivable source text. */\nexport const DEFAULT_RESOLUTION_BACKFILL_VALUE = \"completed\";\n\nfunction quoteForCommand(value: string): string {\n  return `\"${value.replaceAll(\"\\\\\", \"\\\\\\\\\").replaceAll('\"', '\\\\\"')}\"`;\n}\n\nfunction toMeaningfulValue(value: string | undefined): string | undefined {\n  const trimmed = value?.trim();\n  return trimmed !== undefined && trimmed.length > 0 ? trimmed : undefined;\n}\n\nexport interface ResolutionBackfillRow {\n  id: string;\n  /** Resolution-check missing field keys for this closed item. */\n  missing_fields: readonly string[];\n  /** The item's close_reason, when present (preferred derivation source). */\n  close_reason?: string;\n}\n\n/**\n * Plan resolution backfills for closed items flagged by the resolution check.\n * Only the `resolution` field is mechanical enough to auto-fix: it derives\n * from the item's own `close_reason` when present and falls back to the\n * `\"completed\"` default. `expected_result` / `actual_result` stay hint-only —\n * no deterministic source text exists for them.\n */\nexport function planResolutionBackfillFixes(rows: readonly ResolutionBackfillRow[]): ValidateFixRecord[] {\n  const fixes: ValidateFixRecord[] = [];\n  for (const row of rows) {\n    if (!row.missing_fields.includes(\"resolution\")) {\n      continue;\n    }\n    const value = toMeaningfulValue(row.close_reason) ?? DEFAULT_RESOLUTION_BACKFILL_VALUE;\n    fixes.push({\n      item_id: row.id,\n      check: \"resolution\",\n      field: \"resolution\",\n      kind: \"set_resolution\",\n      value,\n      command: `pm update ${row.id} --resolution ${quoteForCommand(value)}`,\n      gate: \"resolution\",\n    });\n  }\n  return fixes;\n}\n\nexport interface CloseReasonBackfillRow {\n  id: string;\n  /** The item's resolution, when present (the only derivation source). */\n  resolution?: string;\n}\n\n/**\n * Plan close_reason backfills for closed items flagged by the metadata check.\n * Only derivable when the item already carries a resolution; items missing\n * both stay hint-only (any synthesized reason would be fabricated, not\n * derived).\n */\nexport function planCloseReasonBackfillFixes(rows: readonly CloseReasonBackfillRow[]): ValidateFixRecord[] {\n  const fixes: ValidateFixRecord[] = [];\n  for (const row of rows) {\n    const value = toMeaningfulValue(row.resolution);\n    if (value === undefined) {\n      continue;\n    }\n    fixes.push({\n      item_id: row.id,\n      check: \"metadata\",\n      field: \"close_reason\",\n      kind: \"set_close_reason\",\n      value,\n      command: `pm update ${row.id} --close-reason ${quoteForCommand(value)}`,\n      gate: \"metadata\",\n    });\n  }\n  return fixes;\n}\n\nexport interface TerminalParentFixRow {\n  id: string;\n  parent_id: string;\n  /** The terminal parent's own parent, when one exists. */\n  grandparent_id?: string;\n  /** True when the grandparent exists and is NOT terminal (safe reparent target). */\n  grandparent_active?: boolean;\n}\n\n/**\n * Plan lifecycle fixes for active items whose parent is terminal (pm-8jss /\n * GH-168). When the terminal parent has an active grandparent, the child is\n * reparented one level up (it stays inside the same hierarchy); otherwise the\n * parent link is cleared so the item surfaces as unparented active work.\n * Either way the item itself is never closed or mutated beyond `parent` —\n * and every fix carries `gate: \"lifecycle\"` so it is only applied under an\n * explicit `--fix-scope lifecycle`.\n */\nexport function planTerminalParentFixes(rows: readonly TerminalParentFixRow[]): ValidateFixRecord[] {\n  return rows.map((row) => {\n    if (row.grandparent_id !== undefined && row.grandparent_active === true) {\n      return {\n        item_id: row.id,\n        check: \"lifecycle\" as const,\n        field: \"parent\",\n        kind: \"reparent\" as const,\n        parent_id: row.grandparent_id,\n        command: `pm update ${row.id} --parent ${row.grandparent_id}`,\n        gate: \"lifecycle\" as const,\n      };\n    }\n    return {\n      item_id: row.id,\n      check: \"lifecycle\" as const,\n      field: \"parent\",\n      kind: \"unset_parent\" as const,\n      command: `pm update ${row.id} --unset parent`,\n      gate: \"lifecycle\" as const,\n    };\n  });\n}\n\nexport interface StaleLinkPruneRow {\n  item_id: string;\n  path: string;\n  link_kind: \"files\" | \"docs\";\n  classification: \"moved\" | \"deleted\";\n}\n\n/**\n * Plan link prunes for `--prune-missing` (pm-0v2m / GH-184). Only links whose\n * stale path classified as `deleted` are pruned; `moved` links keep their\n * relink candidates in the files-check details instead of being dropped, so\n * recoverable link information is never destroyed. Link removal only — real\n * files are never touched.\n */\nexport function planStaleLinkPruneFixes(rows: readonly StaleLinkPruneRow[]): ValidateFixRecord[] {\n  const fixes: ValidateFixRecord[] = [];\n  for (const row of rows) {\n    if (row.classification !== \"deleted\") {\n      continue;\n    }\n    const noun = row.link_kind === \"files\" ? \"files\" : \"docs\";\n    fixes.push({\n      item_id: row.item_id,\n      check: \"files\",\n      field: row.link_kind,\n      kind: row.link_kind === \"files\" ? \"prune_file_link\" : \"prune_doc_link\",\n      path: row.path,\n      command: `pm ${noun} ${row.item_id} --remove ${quoteForCommand(row.path)}`,\n    });\n  }\n  return fixes;\n}\n\n/**\n * Resolve the granted `--fix-scope` set (repeatable and/or comma-separated).\n * With no explicit scopes the safe field-backfill scopes (metadata,\n * resolution) are granted; lifecycle must always be named explicitly. Unknown\n * values fail fast with the supported list.\n */\nexport function resolveGrantedFixScopes(rawScopes: readonly string[] | undefined): Set<ValidateFixScope> {\n  const tokens = (rawScopes ?? [])\n    .flatMap((raw) => raw.split(\",\"))\n    .map((raw) => raw.trim())\n    .filter((raw) => raw.length > 0);\n  if (tokens.length === 0) {\n    if (rawScopes !== undefined && rawScopes.length > 0) {\n      throw new PmCliError(\n        `--fix-scope values must not be empty. Supported values: ${SUPPORTED_FIX_SCOPES.join(\", \")}.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return new Set(DEFAULT_GRANTED_FIX_SCOPES);\n  }\n  const granted = new Set<ValidateFixScope>();\n  for (const raw of tokens) {\n    const normalized = raw.toLowerCase().replaceAll(\"-\", \"_\");\n    if ((SUPPORTED_FIX_SCOPES as readonly string[]).includes(normalized)) {\n      granted.add(normalized as ValidateFixScope);\n      continue;\n    }\n    throw new PmCliError(\n      `Unknown --fix-scope value \"${raw}\". Supported values: ${SUPPORTED_FIX_SCOPES.join(\", \")}.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return granted;\n}\n\n/**\n * Split a fix plan into the records that may be applied under the granted\n * scopes and the gated records that were withheld. `--fix-scope` is an exact\n * allowlist: every `--auto-fix` record requires its gate scope in `granted`.\n * Ungated records (`--prune-missing` link prunes, governed by their own flag)\n * are always applicable.\n */\nexport function partitionFixesByGrant(\n  fixes: readonly ValidateFixRecord[],\n  granted: ReadonlySet<ValidateFixScope>,\n): { applicable: ValidateFixRecord[]; gated: ValidateFixRecord[] } {\n  const applicable: ValidateFixRecord[] = [];\n  const gated: ValidateFixRecord[] = [];\n  for (const fix of fixes) {\n    if (fix.gate !== undefined && !granted.has(fix.gate)) {\n      gated.push(fix);\n    } else {\n      applicable.push(fix);\n    }\n  }\n  return { applicable, gated };\n}\n\n/** Compact serialization of a fix for planned/applied output rows. */\nexport function toFixOutputRow(fix: ValidateFixRecord): Record<string, unknown> {\n  return {\n    item_id: fix.item_id,\n    check: fix.check,\n    field: fix.field,\n    command: fix.command,\n    ...(fix.gate !== undefined ? { gate: fix.gate } : {}),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"7163fbbf-1a9c-52e0-a1d5-6034abefc50f"}

package/dist/core/validate/missing-by-type.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Per-item-type grouping of missing-required-field counts for
+ * `pm validate --check-metadata` (pm-pmyq / GH-172).
+ *
+ * Pure module: callers stream `(item_type, field)` pairs — one per missing
+ * required field occurrence — and receive a compact, deterministically sorted
+ * `missing_by_type` map of counts (never row dumps), e.g.
+ * `{ Task: { close_reason: 3, reviewer: 1 } }`.
+ */
+export interface MissingFieldOccurrence {
+    /** Item type name as stored in front matter (e.g. "Task"). */
+    item_type: string;
+    /** Required metadata field that is missing on the item. */
+    field: string;
+}
+/**
+ * Aggregate missing-field occurrences into `{ type: { field: count } }` with
+ * both levels sorted lexicographically for stable, diff-friendly output.
+ * Zero counts never appear (only observed occurrences are aggregated).
+ */
+export declare function buildMissingByTypeCounts(occurrences: Iterable<MissingFieldOccurrence>): Record<string, Record<string, number>>;

package/dist/core/validate/missing-by-type.js

@@ -0,0 +1,39 @@
+/**
+ * Per-item-type grouping of missing-required-field counts for
+ * `pm validate --check-metadata` (pm-pmyq / GH-172).
+ *
+ * Pure module: callers stream `(item_type, field)` pairs — one per missing
+ * required field occurrence — and receive a compact, deterministically sorted
+ * `missing_by_type` map of counts (never row dumps), e.g.
+ * `{ Task: { close_reason: 3, reviewer: 1 } }`.
+ */
+/**
+ * Aggregate missing-field occurrences into `{ type: { field: count } }` with
+ * both levels sorted lexicographically for stable, diff-friendly output.
+ * Zero counts never appear (only observed occurrences are aggregated).
+ */
+
+!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]="16988d98-5a10-5e0a-952c-0a6289ab5935")}catch(e){}}();
+export function buildMissingByTypeCounts(occurrences) {
+    const countsByType = new Map();
+    for (const occurrence of occurrences) {
+        let fieldCounts = countsByType.get(occurrence.item_type);
+        if (!fieldCounts) {
+            fieldCounts = new Map();
+            countsByType.set(occurrence.item_type, fieldCounts);
+        }
+        fieldCounts.set(occurrence.field, (fieldCounts.get(occurrence.field) ?? 0) + 1);
+    }
+    const result = {};
+    for (const type of [...countsByType.keys()].sort((left, right) => left.localeCompare(right))) {
+        const fieldCounts = countsByType.get(type);
+        const fields = {};
+        for (const field of [...fieldCounts.keys()].sort((left, right) => left.localeCompare(right))) {
+            fields[field] = fieldCounts.get(field);
+        }
+        result[type] = fields;
+    }
+    return result;
+}
+//# sourceMappingURL=missing-by-type.js.map
+//# debugId=16988d98-5a10-5e0a-952c-0a6289ab5935

package/dist/core/validate/missing-by-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-by-type.js","sources":["core/validate/missing-by-type.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Per-item-type grouping of missing-required-field counts for\n * `pm validate --check-metadata` (pm-pmyq / GH-172).\n *\n * Pure module: callers stream `(item_type, field)` pairs — one per missing\n * required field occurrence — and receive a compact, deterministically sorted\n * `missing_by_type` map of counts (never row dumps), e.g.\n * `{ Task: { close_reason: 3, reviewer: 1 } }`.\n */\n\nexport interface MissingFieldOccurrence {\n  /** Item type name as stored in front matter (e.g. \"Task\"). */\n  item_type: string;\n  /** Required metadata field that is missing on the item. */\n  field: string;\n}\n\n/**\n * Aggregate missing-field occurrences into `{ type: { field: count } }` with\n * both levels sorted lexicographically for stable, diff-friendly output.\n * Zero counts never appear (only observed occurrences are aggregated).\n */\nexport function buildMissingByTypeCounts(\n  occurrences: Iterable<MissingFieldOccurrence>,\n): Record<string, Record<string, number>> {\n  const countsByType = new Map<string, Map<string, number>>();\n  for (const occurrence of occurrences) {\n    let fieldCounts = countsByType.get(occurrence.item_type);\n    if (!fieldCounts) {\n      fieldCounts = new Map<string, number>();\n      countsByType.set(occurrence.item_type, fieldCounts);\n    }\n    fieldCounts.set(occurrence.field, (fieldCounts.get(occurrence.field) ?? 0) + 1);\n  }\n\n  const result: Record<string, Record<string, number>> = {};\n  for (const type of [...countsByType.keys()].sort((left, right) => left.localeCompare(right))) {\n    const fieldCounts = countsByType.get(type)!;\n    const fields: Record<string, number> = {};\n    for (const field of [...fieldCounts.keys()].sort((left, right) => left.localeCompare(right))) {\n      fields[field] = fieldCounts.get(field)!;\n    }\n    result[type] = fields;\n  }\n  return result;\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;GAIG;;;AACH,MAAM,UAAU,wBAAwB,CACtC,WAA6C;IAE7C,MAAM,YAAY,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC5D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;YACxC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtD,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,MAAM,GAA2C,EAAE,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC7F,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QAC5C,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7F,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","debugId":"16988d98-5a10-5e0a-952c-0a6289ab5935"}