@unbrained/pm-cli 2026.5.18 → 2026.5.27

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

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sources":["core/shared/constants.ts"],"sourceRoot":"/","sourcesContent":["import type { BuiltinItemType, GovernancePreset, GovernanceSettings, ItemFrontMatter, PmSettings } from \"../../types/index.js\";\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  \"index\",\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  \"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    parent_reference: \"warn\",\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    parent_reference: \"warn\",\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    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\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: [\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    fields: [],\n    workflow: {\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    unknown_field_policy: \"allow\",\n  },\n  extensions: {\n    enabled: [],\n    disabled: [],\n    policy: {\n      mode: \"off\",\n      trust_mode: \"off\",\n      require_provenance: false,\n      trusted_extensions: [],\n      default_sandbox_profile: \"none\",\n      allowed_extensions: [],\n      blocked_extensions: [],\n      allowed_capabilities: [],\n      blocked_capabilities: [],\n      allowed_surfaces: [],\n      blocked_surfaces: [],\n      allowed_commands: [],\n      blocked_commands: [],\n      allowed_actions: [],\n      blocked_actions: [],\n      allowed_services: [],\n      blocked_services: [],\n      extension_overrides: [],\n    },\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  },\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      blockers: true,\n      files: true,\n      workload: true,\n      staleness: true,\n      tests: true,\n    },\n  },\n  vector_store: {\n    adapter: \"\",\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":"eaae02cf-f02a-5928-abdb-9bcd9a7842bc"}
+{"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  \"index\",\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  \"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    parent_reference: \"warn\",\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    parent_reference: \"warn\",\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    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  },\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      blockers: true,\n      files: true,\n      workload: true,\n      staleness: true,\n      tests: true,\n    },\n  },\n  vector_store: {\n    adapter: \"\",\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":"7ad6d040-d32b-5ce2-adf9-3c5cc6cf13de"}

package/dist/core/shared/lazy-module.d.ts

@@ -0,0 +1 @@
+export declare function createLazyModule<T>(importer: () => Promise<T>): () => Promise<T>;

package/dist/core/shared/lazy-module.js

@@ -0,0 +1,11 @@
+
+!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]="8a197e16-769b-582e-833f-997a66d98407")}catch(e){}}();
+export function createLazyModule(importer) {
+    let promise = null;
+    return () => {
+        promise ??= importer();
+        return promise;
+    };
+}
+//# sourceMappingURL=lazy-module.js.map
+//# debugId=8a197e16-769b-582e-833f-997a66d98407

package/dist/core/shared/lazy-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-module.js","sources":["core/shared/lazy-module.ts"],"sourceRoot":"/","sourcesContent":["export function createLazyModule<T>(importer: () => Promise<T>): () => Promise<T> {\n  let promise: Promise<T> | null = null;\n  return () => {\n    promise ??= importer();\n    return promise;\n  };\n}\n"],"names":[],"mappings":";;AAAA,MAAM,UAAU,gBAAgB,CAAI,QAA0B;IAC5D,IAAI,OAAO,GAAsB,IAAI,CAAC;IACtC,OAAO,GAAG,EAAE;QACV,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC","debugId":"8a197e16-769b-582e-833f-997a66d98407"}

package/dist/core/shared/option-alias-visibility.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Helpers for deciding whether a CLI option alias is a pure snake_case
+ * underscore-duplicate of an existing kebab-case flag.
+ *
+ * Mutation commands historically register every `--foo-bar` flag together with
+ * a `--foo_bar` alias so agents are never blocked by a snake/kebab mismatch.
+ * Those underscore duplicates roughly double the option list of every
+ * `--help` and waste agent context. We keep them functional as parse-time
+ * aliases but hide them from the rendered `--help` text.
+ *
+ * The rule is intentionally narrow: an alias is hidden ONLY when its long flag
+ * is exactly the underscore form of an existing kebab flag (for example
+ * `--create_mode` is the `-`→`_` form of `--create-mode`). Semantically-distinct
+ * aliases (for example `--fail-on-warn` for `--strict-exit`, `--local` for
+ * `--project`, `--ac` for `--acceptance-criteria`) are NOT snake duplicates and
+ * stay visible.
+ */
+/**
+ * Extract every long flag (for example `--create-mode`) from a commander flag
+ * spec that may include short aliases and a value placeholder. A spec can list
+ * more than one long flag, for example `"--estimate, --estimated-minutes
+ * <value>"` → `["--estimate", "--estimated-minutes"]`.
+ */
+export declare function extractLongFlags(flagSpec: string): string[];
+/**
+ * Extract the first long flag from a commander flag spec, or null when none is
+ * present.
+ */
+export declare function extractLongFlag(flagSpec: string): string | null;
+/**
+ * Returns true when `aliasFlagSpec` differs from `canonicalFlagSpec` ONLY by
+ * substituting one or more interior hyphens with underscores — i.e. it is a
+ * pure snake_case underscore-duplicate of the canonical kebab flag.
+ *
+ * Examples that match (alias hidden):
+ *   --create-mode            <- --create_mode
+ *   --filter-assignee-filter <- --filter-assignee_filter
+ *
+ * Examples that do NOT match (alias stays visible):
+ *   --acceptance-criteria    <- --ac      (different identifier)
+ *   --order                  <- --rank    (different identifier)
+ *   --strict-exit            <- --fail-on-warn (semantically distinct)
+ */
+export declare function isPureSnakeCaseAlias(canonicalFlagSpec: string, aliasFlagSpec: string): boolean;

package/dist/core/shared/option-alias-visibility.js

@@ -0,0 +1,76 @@
+/**
+ * Helpers for deciding whether a CLI option alias is a pure snake_case
+ * underscore-duplicate of an existing kebab-case flag.
+ *
+ * Mutation commands historically register every `--foo-bar` flag together with
+ * a `--foo_bar` alias so agents are never blocked by a snake/kebab mismatch.
+ * Those underscore duplicates roughly double the option list of every
+ * `--help` and waste agent context. We keep them functional as parse-time
+ * aliases but hide them from the rendered `--help` text.
+ *
+ * The rule is intentionally narrow: an alias is hidden ONLY when its long flag
+ * is exactly the underscore form of an existing kebab flag (for example
+ * `--create_mode` is the `-`→`_` form of `--create-mode`). Semantically-distinct
+ * aliases (for example `--fail-on-warn` for `--strict-exit`, `--local` for
+ * `--project`, `--ac` for `--acceptance-criteria`) are NOT snake duplicates and
+ * stay visible.
+ */
+/**
+ * Extract every long flag (for example `--create-mode`) from a commander flag
+ * spec that may include short aliases and a value placeholder. A spec can list
+ * more than one long flag, for example `"--estimate, --estimated-minutes
+ * <value>"` → `["--estimate", "--estimated-minutes"]`.
+ */
+
+!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]="9682a7a8-88b3-512a-9c6b-d2dfbe6bc2fb")}catch(e){}}();
+export function extractLongFlags(flagSpec) {
+    return flagSpec
+        .split(/[\s,|]+/)
+        .map((token) => token.trim())
+        .filter((token) => token.startsWith("--"));
+}
+/**
+ * Extract the first long flag from a commander flag spec, or null when none is
+ * present.
+ */
+export function extractLongFlag(flagSpec) {
+    return extractLongFlags(flagSpec)[0] ?? null;
+}
+/**
+ * Returns true when `aliasFlagSpec` differs from `canonicalFlagSpec` ONLY by
+ * substituting one or more interior hyphens with underscores — i.e. it is a
+ * pure snake_case underscore-duplicate of the canonical kebab flag.
+ *
+ * Examples that match (alias hidden):
+ *   --create-mode            <- --create_mode
+ *   --filter-assignee-filter <- --filter-assignee_filter
+ *
+ * Examples that do NOT match (alias stays visible):
+ *   --acceptance-criteria    <- --ac      (different identifier)
+ *   --order                  <- --rank    (different identifier)
+ *   --strict-exit            <- --fail-on-warn (semantically distinct)
+ */
+export function isPureSnakeCaseAlias(canonicalFlagSpec, aliasFlagSpec) {
+    const aliasLong = extractLongFlag(aliasFlagSpec);
+    if (aliasLong === null) {
+        return false;
+    }
+    const normalize = (long) => long.slice(2).replaceAll("-", "_");
+    // The canonical spec may declare multiple long flags (e.g.
+    // "--estimate, --estimated-minutes <value>"); the alias is hidden when it is
+    // the underscore form of ANY of them.
+    return extractLongFlags(canonicalFlagSpec).some((canonicalLong) => {
+        if (!canonicalLong.slice(2).includes("-")) {
+            // No interior hyphen to convert, so there is no kebab form to snake-duplicate.
+            return false;
+        }
+        if (aliasLong === canonicalLong) {
+            // Identical flags are not aliases of one another.
+            return false;
+        }
+        // Reachable from the canonical purely by hyphen→underscore substitution.
+        return normalize(aliasLong) === normalize(canonicalLong);
+    });
+}
+//# sourceMappingURL=option-alias-visibility.js.map
+//# debugId=9682a7a8-88b3-512a-9c6b-d2dfbe6bc2fb

package/dist/core/shared/option-alias-visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-alias-visibility.js","sources":["core/shared/option-alias-visibility.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Helpers for deciding whether a CLI option alias is a pure snake_case\n * underscore-duplicate of an existing kebab-case flag.\n *\n * Mutation commands historically register every `--foo-bar` flag together with\n * a `--foo_bar` alias so agents are never blocked by a snake/kebab mismatch.\n * Those underscore duplicates roughly double the option list of every\n * `--help` and waste agent context. We keep them functional as parse-time\n * aliases but hide them from the rendered `--help` text.\n *\n * The rule is intentionally narrow: an alias is hidden ONLY when its long flag\n * is exactly the underscore form of an existing kebab flag (for example\n * `--create_mode` is the `-`→`_` form of `--create-mode`). Semantically-distinct\n * aliases (for example `--fail-on-warn` for `--strict-exit`, `--local` for\n * `--project`, `--ac` for `--acceptance-criteria`) are NOT snake duplicates and\n * stay visible.\n */\n\n/**\n * Extract every long flag (for example `--create-mode`) from a commander flag\n * spec that may include short aliases and a value placeholder. A spec can list\n * more than one long flag, for example `\"--estimate, --estimated-minutes\n * <value>\"` → `[\"--estimate\", \"--estimated-minutes\"]`.\n */\nexport function extractLongFlags(flagSpec: string): string[] {\n  return flagSpec\n    .split(/[\\s,|]+/)\n    .map((token) => token.trim())\n    .filter((token) => token.startsWith(\"--\"));\n}\n\n/**\n * Extract the first long flag from a commander flag spec, or null when none is\n * present.\n */\nexport function extractLongFlag(flagSpec: string): string | null {\n  return extractLongFlags(flagSpec)[0] ?? null;\n}\n\n/**\n * Returns true when `aliasFlagSpec` differs from `canonicalFlagSpec` ONLY by\n * substituting one or more interior hyphens with underscores — i.e. it is a\n * pure snake_case underscore-duplicate of the canonical kebab flag.\n *\n * Examples that match (alias hidden):\n *   --create-mode            <- --create_mode\n *   --filter-assignee-filter <- --filter-assignee_filter\n *\n * Examples that do NOT match (alias stays visible):\n *   --acceptance-criteria    <- --ac      (different identifier)\n *   --order                  <- --rank    (different identifier)\n *   --strict-exit            <- --fail-on-warn (semantically distinct)\n */\nexport function isPureSnakeCaseAlias(canonicalFlagSpec: string, aliasFlagSpec: string): boolean {\n  const aliasLong = extractLongFlag(aliasFlagSpec);\n  if (aliasLong === null) {\n    return false;\n  }\n  const normalize = (long: string): string => long.slice(2).replaceAll(\"-\", \"_\");\n  // The canonical spec may declare multiple long flags (e.g.\n  // \"--estimate, --estimated-minutes <value>\"); the alias is hidden when it is\n  // the underscore form of ANY of them.\n  return extractLongFlags(canonicalFlagSpec).some((canonicalLong) => {\n    if (!canonicalLong.slice(2).includes(\"-\")) {\n      // No interior hyphen to convert, so there is no kebab form to snake-duplicate.\n      return false;\n    }\n    if (aliasLong === canonicalLong) {\n      // Identical flags are not aliases of one another.\n      return false;\n    }\n    // Reachable from the canonical purely by hyphen→underscore substitution.\n    return normalize(aliasLong) === normalize(canonicalLong);\n  });\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;GAKG;;;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ;SACZ,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,iBAAyB,EAAE,aAAqB;IACnF,MAAM,SAAS,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IACjD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/E,2DAA2D;IAC3D,6EAA6E;IAC7E,sCAAsC;IACtC,OAAO,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE;QAChE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,+EAA+E;YAC/E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;YAChC,kDAAkD;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,yEAAyE;QACzE,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC,aAAa,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC","debugId":"9682a7a8-88b3-512a-9c6b-d2dfbe6bc2fb"}

package/dist/core/shared/primitives.d.ts

@@ -11,3 +11,26 @@ export declare function toNonEmptyStringOrUndefined(value: unknown): string | un
 export declare function trimTrailingSlashes(value: string): string;
 export declare function isFiniteNumberArray(value: unknown): value is number[];
 export declare function toErrorMessage(error: unknown): string;
+/**
+ * Narrow a value to a plain object, returning `null` for non-objects,
+ * `null`, and arrays. Returns the original reference (no clone).
+ *
+ * Matches the historical `asRecord` in src/cli/main.ts.
+ */
+export declare function asRecordOrNull(value: unknown): Record<string, unknown> | null;
+/**
+ * Narrow a value to a plain object, returning `null` only for non-objects and
+ * `null` while accepting arrays (arrays are objects). Returns the original
+ * reference (no clone).
+ *
+ * Matches the historical `asRecord` in src/core/extensions/loader.ts, which
+ * intentionally omits the array guard.
+ */
+export declare function asRecordLoose(value: unknown): Record<string, unknown> | null;
+/**
+ * Narrow a value to a plain object, returning an empty object for non-objects,
+ * `null`, and arrays. Returns a shallow clone of the source object.
+ *
+ * Matches the historical `asRecord` in src/mcp/server.ts.
+ */
+export declare function asRecordClone(value: unknown): Record<string, unknown>;

package/dist/core/shared/primitives.js

@@ -7,7 +7,7 @@
  * several CLI command modules.
  */
 
-!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]="2da8cf4a-1ec7-5aa8-a813-07fcc0ede9da")}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]="f8eed493-93bf-5473-9c1a-90a791333b5e")}catch(e){}}();
 export function toNonEmptyString(value) {
     if (typeof value !== "string") {
         return null;
@@ -32,5 +32,42 @@ export function toErrorMessage(error) {
     }
     return String(error);
 }
+/**
+ * Narrow a value to a plain object, returning `null` for non-objects,
+ * `null`, and arrays. Returns the original reference (no clone).
+ *
+ * Matches the historical `asRecord` in src/cli/main.ts.
+ */
+export function asRecordOrNull(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+/**
+ * Narrow a value to a plain object, returning `null` only for non-objects and
+ * `null` while accepting arrays (arrays are objects). Returns the original
+ * reference (no clone).
+ *
+ * Matches the historical `asRecord` in src/core/extensions/loader.ts, which
+ * intentionally omits the array guard.
+ */
+export function asRecordLoose(value) {
+    if (typeof value !== "object" || value === null) {
+        return null;
+    }
+    return value;
+}
+/**
+ * Narrow a value to a plain object, returning an empty object for non-objects,
+ * `null`, and arrays. Returns a shallow clone of the source object.
+ *
+ * Matches the historical `asRecord` in src/mcp/server.ts.
+ */
+export function asRecordClone(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? { ...value }
+        : {};
+}
 //# sourceMappingURL=primitives.js.map
-//# debugId=2da8cf4a-1ec7-5aa8-a813-07fcc0ede9da
+//# debugId=f8eed493-93bf-5473-9c1a-90a791333b5e

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

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sources":["core/shared/primitives.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Common primitive utility functions shared across core modules.\n *\n * These reduce duplication of trivial helpers like string-presence checks,\n * error message extraction, and numeric array guards that were previously\n * duplicated in providers.ts, vector-stores.ts, lock.ts, cache.ts, and\n * several CLI command modules.\n */\n\nexport function toNonEmptyString(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : null;\n}\n\nexport function toNonEmptyStringOrUndefined(value: unknown): string | undefined {\n  const result = toNonEmptyString(value);\n  return result ?? undefined;\n}\n\nexport function trimTrailingSlashes(value: string): string {\n  return value.replaceAll(/\\/+$/g, \"\");\n}\n\nexport function isFiniteNumberArray(value: unknown): value is number[] {\n  return Array.isArray(value) && value.every((entry) => typeof entry === \"number\" && Number.isFinite(entry));\n}\n\nexport function toErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    const message = error.message.trim();\n    return message.length > 0 ? message : error.name;\n  }\n  return String(error);\n}\n"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;;AAEH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,MAAM,IAAI,SAAS,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7G,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC","debugId":"2da8cf4a-1ec7-5aa8-a813-07fcc0ede9da"}
+{"version":3,"file":"primitives.js","sources":["core/shared/primitives.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Common primitive utility functions shared across core modules.\n *\n * These reduce duplication of trivial helpers like string-presence checks,\n * error message extraction, and numeric array guards that were previously\n * duplicated in providers.ts, vector-stores.ts, lock.ts, cache.ts, and\n * several CLI command modules.\n */\n\nexport function toNonEmptyString(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : null;\n}\n\nexport function toNonEmptyStringOrUndefined(value: unknown): string | undefined {\n  const result = toNonEmptyString(value);\n  return result ?? undefined;\n}\n\nexport function trimTrailingSlashes(value: string): string {\n  return value.replaceAll(/\\/+$/g, \"\");\n}\n\nexport function isFiniteNumberArray(value: unknown): value is number[] {\n  return Array.isArray(value) && value.every((entry) => typeof entry === \"number\" && Number.isFinite(entry));\n}\n\nexport function toErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    const message = error.message.trim();\n    return message.length > 0 ? message : error.name;\n  }\n  return String(error);\n}\n\n/**\n * Narrow a value to a plain object, returning `null` for non-objects,\n * `null`, and arrays. Returns the original reference (no clone).\n *\n * Matches the historical `asRecord` in src/cli/main.ts.\n */\nexport function asRecordOrNull(value: unknown): Record<string, unknown> | null {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return null;\n  }\n  return value as Record<string, unknown>;\n}\n\n/**\n * Narrow a value to a plain object, returning `null` only for non-objects and\n * `null` while accepting arrays (arrays are objects). Returns the original\n * reference (no clone).\n *\n * Matches the historical `asRecord` in src/core/extensions/loader.ts, which\n * intentionally omits the array guard.\n */\nexport function asRecordLoose(value: unknown): Record<string, unknown> | null {\n  if (typeof value !== \"object\" || value === null) {\n    return null;\n  }\n  return value as Record<string, unknown>;\n}\n\n/**\n * Narrow a value to a plain object, returning an empty object for non-objects,\n * `null`, and arrays. Returns a shallow clone of the source object.\n *\n * Matches the historical `asRecord` in src/mcp/server.ts.\n */\nexport function asRecordClone(value: unknown): Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? ({ ...value } as Record<string, unknown>)\n    : {};\n}\n"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;;AAEH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,MAAM,IAAI,SAAS,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7G,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,EAAE,GAAG,KAAK,EAA8B;QAC3C,CAAC,CAAC,EAAE,CAAC;AACT,CAAC","debugId":"f8eed493-93bf-5473-9c1a-90a791333b5e"}

package/dist/core/shared/text-normalization.d.ts

@@ -1,4 +1,3 @@
 export declare function normalizeLowercaseWhitespace(value: string): string;
 export declare function tokenizeAlphaNumeric(value: string): string[];
-export declare function uniqueTokens(value: string): string[];
 export declare function jaccardSimilarity(leftTokens: string[], rightTokens: string[]): number;

package/dist/core/shared/text-normalization.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]="519934fd-169a-536b-94a8-67607aac500c")}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]="1109b938-c421-5517-9671-2cebd7e10309")}catch(e){}}();
 export function normalizeLowercaseWhitespace(value) {
     return value
         .trim()
@@ -11,9 +11,6 @@ export function tokenizeAlphaNumeric(value) {
         .split(/[^a-z0-9]+/)
         .filter((token) => token.length > 0);
 }
-export function uniqueTokens(value) {
-    return [...new Set(tokenizeAlphaNumeric(value))];
-}
 export function jaccardSimilarity(leftTokens, rightTokens) {
     if (leftTokens.length === 0 && rightTokens.length === 0) {
         return 1;
@@ -33,4 +30,4 @@ export function jaccardSimilarity(leftTokens, rightTokens) {
     return union === 0 ? 0 : intersection / union;
 }
 //# sourceMappingURL=text-normalization.js.map
-//# debugId=519934fd-169a-536b-94a8-67607aac500c
+//# debugId=1109b938-c421-5517-9671-2cebd7e10309

package/dist/core/shared/text-normalization.js.map

@@ -1 +1 @@
-{"version":3,"file":"text-normalization.js","sources":["core/shared/text-normalization.ts"],"sourceRoot":"/","sourcesContent":["export function normalizeLowercaseWhitespace(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/\\s+/g, \" \");\n}\n\nexport function tokenizeAlphaNumeric(value: string): string[] {\n  return normalizeLowercaseWhitespace(value)\n    .split(/[^a-z0-9]+/)\n    .filter((token) => token.length > 0);\n}\n\nexport function uniqueTokens(value: string): string[] {\n  return [...new Set(tokenizeAlphaNumeric(value))];\n}\n\nexport function jaccardSimilarity(leftTokens: string[], rightTokens: string[]): number {\n  if (leftTokens.length === 0 && rightTokens.length === 0) {\n    return 1;\n  }\n  if (leftTokens.length === 0 || rightTokens.length === 0) {\n    return 0;\n  }\n  const leftSet = new Set(leftTokens);\n  const rightSet = new Set(rightTokens);\n  let intersection = 0;\n  for (const token of leftSet) {\n    if (rightSet.has(token)) {\n      intersection += 1;\n    }\n  }\n  const union = new Set([...leftSet, ...rightSet]).size;\n  return union === 0 ? 0 : intersection / union;\n}\n"],"names":[],"mappings":";;AAAA,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,OAAO,KAAK;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,4BAA4B,CAAC,KAAK,CAAC;SACvC,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAoB,EAAE,WAAqB;IAC3E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,YAAY,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC;AAChD,CAAC","debugId":"519934fd-169a-536b-94a8-67607aac500c"}
+{"version":3,"file":"text-normalization.js","sources":["core/shared/text-normalization.ts"],"sourceRoot":"/","sourcesContent":["export function normalizeLowercaseWhitespace(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/\\s+/g, \" \");\n}\n\nexport function tokenizeAlphaNumeric(value: string): string[] {\n  return normalizeLowercaseWhitespace(value)\n    .split(/[^a-z0-9]+/)\n    .filter((token) => token.length > 0);\n}\n\nexport function jaccardSimilarity(leftTokens: string[], rightTokens: string[]): number {\n  if (leftTokens.length === 0 && rightTokens.length === 0) {\n    return 1;\n  }\n  if (leftTokens.length === 0 || rightTokens.length === 0) {\n    return 0;\n  }\n  const leftSet = new Set(leftTokens);\n  const rightSet = new Set(rightTokens);\n  let intersection = 0;\n  for (const token of leftSet) {\n    if (rightSet.has(token)) {\n      intersection += 1;\n    }\n  }\n  const union = new Set([...leftSet, ...rightSet]).size;\n  return union === 0 ? 0 : intersection / union;\n}\n"],"names":[],"mappings":";;AAAA,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,OAAO,KAAK;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,4BAA4B,CAAC,KAAK,CAAC;SACvC,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAoB,EAAE,WAAqB;IAC3E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,YAAY,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC;AAChD,CAAC","debugId":"1109b938-c421-5517-9671-2cebd7e10309"}

package/dist/core/store/front-matter-cache.d.ts

@@ -5,9 +5,23 @@ export interface CachedDocumentCandidate {
     item_format: ItemFormat;
     item_path: string;
 }
+export interface ListCacheOptions {
+    /**
+     * When false, item bodies are neither loaded from nor written to the separate
+     * body cache. Metadata-only callers (`pm list`, stats, deps, activity, …) skip
+     * the large body cache entirely; only body consumers (search/reindex) pay for it.
+     */
+    includeBody?: boolean;
+}
 /**
  * List all item documents using a persistent on-disk metadata cache.
- * Only parses files whose mtime/size have changed since the last cached run.
+ *
+ * Metadata and bodies are stored in two separate cache files so the hot path
+ * (`pm list` and friends, which discard bodies) never loads or rewrites the much
+ * larger body payload. Each file is rewritten only when its contents actually
+ * change, and per-file onRead hooks are dispatched only when an extension
+ * registers one. Only files whose mtime/ctime/size changed since the last run are
+ * re-parsed.
  */
-export declare function listAllDocumentCandidatesCached(pmRoot: string, preferredFormat: ItemFormat | undefined, typeToFolder: Record<string, string>, warnings: string[] | undefined, schema: RuntimeSchemaSettings | undefined): Promise<CachedDocumentCandidate[]>;
+export declare function listAllDocumentCandidatesCached(pmRoot: string, preferredFormat: ItemFormat | undefined, typeToFolder: Record<string, string>, warnings: string[] | undefined, schema: RuntimeSchemaSettings | undefined, options?: ListCacheOptions): Promise<CachedDocumentCandidate[]>;
 export declare function listAllDocumentsCached(pmRoot: string, preferredFormat: ItemFormat | undefined, typeToFolder: Record<string, string>, warnings: string[] | undefined, schema: RuntimeSchemaSettings | undefined): Promise<ItemDocument[]>;