@unbrained/pm-cli 2026.5.28 → 2026.5.30

package/dist/core/sentry/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["core/sentry/helpers.ts"],"sourceRoot":"/","sourcesContent":["import { getSentry } from \"./instrument.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { EXIT_CODE, type TelemetryErrorCategory } from \"../shared/constants.js\";\nimport {\n  deriveTelemetryCommandResolution,\n  deriveTelemetryCommandTaxonomy,\n  type TelemetryCommandResolution,\n  type TelemetryResolutionStage,\n} from \"../telemetry/observability.js\";\nimport type { Span } from \"@sentry/node\";\n\nlet activeCommandSpan: Span | undefined;\n\nfunction setSpanAttribute(\n  span: Span,\n  key: string,\n  value: string | number | boolean | undefined,\n): void {\n  if (value === undefined) {\n    return;\n  }\n  const attributeTarget = span as unknown as { setAttribute?: (attrKey: string, attrValue: string | number | boolean) => void };\n  if (typeof attributeTarget.setAttribute === \"function\") {\n    attributeTarget.setAttribute(key, value);\n  }\n}\n\nexport function sentrySetCommandContext(\n  command: string,\n  args: string[],\n  options: Record<string, unknown>,\n  metadata?: {\n    source_context?: string;\n    source_context_source?: string;\n  },\n): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n  const taxonomy = deriveTelemetryCommandTaxonomy(command);\n\n  Sentry.setTag(\"pm.command\", command);\n  Sentry.setTag(\"pm.command_root\", taxonomy.command_root);\n  Sentry.setTag(\"pm.command_family\", taxonomy.command_family);\n  if (typeof metadata?.source_context === \"string\" && metadata.source_context.trim().length > 0) {\n    Sentry.setTag(\"pm.source_context\", metadata.source_context);\n  }\n\n  const safeArgs = args.map((arg) =>\n    arg.startsWith(\"--\") ? arg.split(\"=\")[0] : arg,\n  );\n\n  Sentry.setContext(\"pm.command\", {\n    name: command,\n    root: taxonomy.command_root,\n    leaf: taxonomy.command_leaf,\n    family: taxonomy.command_family,\n    args: safeArgs,\n    option_keys: Object.keys(options).sort(),\n    source_context: metadata?.source_context,\n    source_context_source: metadata?.source_context_source,\n  });\n\n  Sentry.addBreadcrumb({\n    category: \"pm.command\",\n    message: `pm ${command}`,\n    level: \"info\",\n    data: {\n      args: safeArgs,\n      command_root: taxonomy.command_root,\n      command_family: taxonomy.command_family,\n      source_context: metadata?.source_context,\n    },\n  });\n}\n\nexport function sentryStartCommandSpan(command: string): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  activeCommandSpan = Sentry.startInactiveSpan({\n    op: \"pm.command\",\n    name: `pm ${command}`,\n    forceTransaction: true,\n  });\n}\n\nexport function sentryFinishCommandSpan(\n  ok: boolean,\n  error?: string,\n  metadata?: {\n    error_code?: string;\n    error_category?: TelemetryErrorCategory;\n    exit_code?: number;\n    command_resolution?: TelemetryCommandResolution;\n    resolution_stage?: TelemetryResolutionStage;\n  },\n): void {\n  if (!activeCommandSpan) return;\n  const normalizedOk = ok ? \"true\" : \"false\";\n  const normalizedExitCode = typeof metadata?.exit_code === \"number\" ? String(metadata.exit_code) : undefined;\n  const Sentry = getSentry();\n  if (Sentry) {\n    Sentry.setTag(\"pm.ok\", normalizedOk);\n    Sentry.setTag(\"pm.command_ok\", normalizedOk);\n    if (typeof metadata?.exit_code === \"number\") {\n      Sentry.setTag(\"pm.exit_code\", String(metadata.exit_code));\n      Sentry.setTag(\"pm.command_exit_code\", String(metadata.exit_code));\n    }\n    if (typeof metadata?.error_code === \"string\" && metadata.error_code.trim().length > 0) {\n      Sentry.setTag(\"pm.error_code\", metadata.error_code);\n    }\n    if (typeof metadata?.error_category === \"string\" && metadata.error_category.trim().length > 0) {\n      Sentry.setTag(\"pm.error_category\", metadata.error_category);\n    }\n    if (typeof metadata?.command_resolution === \"string\" && metadata.command_resolution.trim().length > 0) {\n      Sentry.setTag(\"pm.command_resolution\", metadata.command_resolution);\n    }\n    if (typeof metadata?.resolution_stage === \"string\" && metadata.resolution_stage.trim().length > 0) {\n      Sentry.setTag(\"pm.resolution_stage\", metadata.resolution_stage);\n    }\n  }\n  setSpanAttribute(activeCommandSpan, \"pm.ok\", normalizedOk);\n  setSpanAttribute(activeCommandSpan, \"pm.command_ok\", normalizedOk);\n  setSpanAttribute(activeCommandSpan, \"pm.exit_code\", normalizedExitCode);\n  setSpanAttribute(activeCommandSpan, \"pm.command_exit_code\", normalizedExitCode);\n  setSpanAttribute(activeCommandSpan, \"pm.error_code\", metadata?.error_code);\n  setSpanAttribute(activeCommandSpan, \"pm.error_category\", metadata?.error_category);\n  setSpanAttribute(activeCommandSpan, \"pm.command_resolution\", metadata?.command_resolution);\n  setSpanAttribute(activeCommandSpan, \"pm.resolution_stage\", metadata?.resolution_stage);\n  activeCommandSpan.setStatus(ok ? { code: 1 } : { code: 2, message: error ?? \"command_failed\" });\n  activeCommandSpan.end();\n  activeCommandSpan = undefined;\n}\n\nexport function sentryCaptureCliError(error: unknown): void {\n  if (!shouldCaptureCliError(error)) return;\n\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  if (error instanceof Error) {\n    const extras: Record<string, unknown> = {};\n    if (\"exitCode\" in error && typeof (error as { exitCode: unknown }).exitCode === \"number\") {\n      extras.exit_code = (error as { exitCode: number }).exitCode;\n    }\n    if (\"context\" in error && typeof (error as { context: unknown }).context === \"object\") {\n      extras.error_context = (error as { context: unknown }).context;\n    }\n    Sentry.captureException(error, { extra: extras });\n  } else {\n    Sentry.captureException(new Error(String(error)));\n  }\n}\n\nexport function sentryLogCliUsageError(params: {\n  command: string;\n  error_code: string;\n  error_category: TelemetryErrorCategory;\n  exit_code: number;\n  error_message: string;\n  command_resolution?: TelemetryCommandResolution;\n  resolution_stage?: TelemetryResolutionStage;\n  source_context?: string;\n}): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n  const resolvedCommandResolution =\n    params.command_resolution ??\n    deriveTelemetryCommandResolution({\n      ok: false,\n      errorCode: params.error_code,\n      errorCategory: params.error_category,\n    });\n  const resolvedResolutionStage = params.resolution_stage ?? \"unknown\";\n\n  const payload = {\n    \"pm.command\": params.command,\n    \"pm.error_code\": params.error_code,\n    \"pm.error_category\": params.error_category,\n    \"pm.exit_code\": params.exit_code,\n    \"pm.error_message\": params.error_message,\n    \"pm.command_resolution\": resolvedCommandResolution,\n    \"pm.resolution_stage\": resolvedResolutionStage,\n    \"pm.source_context\": params.source_context ?? \"\",\n  };\n  const loggerCandidate = (Sentry as unknown as { logger?: { warn?: (message: string, attributes?: Record<string, unknown>) => void } })\n    .logger;\n  if (loggerCandidate && typeof loggerCandidate.warn === \"function\") {\n    loggerCandidate.warn(\"pm_cli_usage_error\", payload);\n    return;\n  }\n\n  Sentry.captureMessage(`pm_cli_usage_error:${params.error_code}`, {\n    level: \"warning\",\n    tags: {\n      \"pm.command\": params.command,\n      \"pm.error_code\": params.error_code,\n      \"pm.error_category\": params.error_category,\n      \"pm.exit_code\": String(params.exit_code),\n      \"pm.command_resolution\": resolvedCommandResolution,\n      \"pm.resolution_stage\": resolvedResolutionStage,\n      \"pm.source_context\": params.source_context ?? \"unknown\",\n    },\n    extra: payload,\n  });\n}\n\nexport function shouldCaptureCliError(error: unknown): boolean {\n  if (error instanceof PmCliError) {\n    return false;\n  }\n  if (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"exitCode\" in error &&\n    typeof (error as { exitCode?: unknown }).exitCode === \"number\"\n  ) {\n    const exitCode = Math.trunc((error as { exitCode: number }).exitCode);\n    const expectedExitCodes: ReadonlySet<number> = new Set([\n      EXIT_CODE.SUCCESS,\n      EXIT_CODE.USAGE,\n      EXIT_CODE.NOT_FOUND,\n      EXIT_CODE.CONFLICT,\n    ]);\n    return !expectedExitCodes.has(exitCode);\n  }\n  return true;\n}\n\nexport async function sentryFlush(): Promise<void> {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  try {\n    await Sentry.flush(3000);\n  } catch {\n    // Sentry flush must never block CLI exit.\n  }\n}\n"],"names":[],"mappings":"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","debugId":"901908ed-f774-5833-91fc-7d143bc10f0a"}
+{"version":3,"file":"helpers.js","sources":["core/sentry/helpers.ts"],"sourceRoot":"/","sourcesContent":["import { getSentry } from \"./instrument.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { EXIT_CODE, type TelemetryErrorCategory } from \"../shared/constants.js\";\nimport {\n  deriveTelemetryCommandResolution,\n  deriveTelemetryCommandTaxonomy,\n  type TelemetryCommandResolution,\n  type TelemetryResolutionStage,\n} from \"../telemetry/observability.js\";\nimport type { Span } from \"@sentry/node\";\n\nlet activeCommandSpan: Span | undefined;\n\nfunction setSpanAttribute(\n  span: Span,\n  key: string,\n  value: string | number | boolean | undefined,\n): void {\n  if (value === undefined) {\n    return;\n  }\n  const attributeTarget = span as unknown as { setAttribute?: (attrKey: string, attrValue: string | number | boolean) => void };\n  if (typeof attributeTarget.setAttribute === \"function\") {\n    attributeTarget.setAttribute(key, value);\n  }\n}\n\nexport function sentrySetCommandContext(\n  command: string,\n  args: string[],\n  options: Record<string, unknown>,\n  metadata?: {\n    source_context?: string;\n    source_context_source?: string;\n  },\n): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n  const taxonomy = deriveTelemetryCommandTaxonomy(command);\n\n  Sentry.setTag(\"pm.command\", command);\n  Sentry.setTag(\"pm.command_root\", taxonomy.command_root);\n  Sentry.setTag(\"pm.command_family\", taxonomy.command_family);\n  if (typeof metadata?.source_context === \"string\" && metadata.source_context.trim().length > 0) {\n    Sentry.setTag(\"pm.source_context\", metadata.source_context);\n  }\n\n  const safeArgs = args.map((arg) =>\n    arg.startsWith(\"--\") ? arg.split(\"=\")[0] : arg,\n  );\n\n  Sentry.setContext(\"pm.command\", {\n    name: command,\n    root: taxonomy.command_root,\n    leaf: taxonomy.command_leaf,\n    family: taxonomy.command_family,\n    args: safeArgs,\n    option_keys: Object.keys(options).sort(),\n    source_context: metadata?.source_context,\n    source_context_source: metadata?.source_context_source,\n  });\n\n  Sentry.addBreadcrumb({\n    category: \"pm.command\",\n    message: `pm ${command}`,\n    level: \"info\",\n    data: {\n      args: safeArgs,\n      command_root: taxonomy.command_root,\n      command_family: taxonomy.command_family,\n      source_context: metadata?.source_context,\n    },\n  });\n}\n\nexport function sentryStartCommandSpan(command: string): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  activeCommandSpan = Sentry.startInactiveSpan({\n    op: \"pm.command\",\n    name: `pm ${command}`,\n    forceTransaction: true,\n  });\n}\n\nexport function sentryFinishCommandSpan(\n  ok: boolean,\n  error?: string,\n  metadata?: {\n    error_code?: string;\n    error_category?: TelemetryErrorCategory;\n    exit_code?: number;\n    command_resolution?: TelemetryCommandResolution;\n    resolution_stage?: TelemetryResolutionStage;\n  },\n): void {\n  if (!activeCommandSpan) return;\n  const normalizedOk = ok ? \"true\" : \"false\";\n  const normalizedExitCode = typeof metadata?.exit_code === \"number\" ? String(metadata.exit_code) : undefined;\n  const Sentry = getSentry();\n  if (Sentry) {\n    Sentry.setTag(\"pm.ok\", normalizedOk);\n    Sentry.setTag(\"pm.command_ok\", normalizedOk);\n    if (typeof metadata?.exit_code === \"number\") {\n      Sentry.setTag(\"pm.exit_code\", String(metadata.exit_code));\n      Sentry.setTag(\"pm.command_exit_code\", String(metadata.exit_code));\n    }\n    if (typeof metadata?.error_code === \"string\" && metadata.error_code.trim().length > 0) {\n      Sentry.setTag(\"pm.error_code\", metadata.error_code);\n    }\n    if (typeof metadata?.error_category === \"string\" && metadata.error_category.trim().length > 0) {\n      Sentry.setTag(\"pm.error_category\", metadata.error_category);\n    }\n    if (typeof metadata?.command_resolution === \"string\" && metadata.command_resolution.trim().length > 0) {\n      Sentry.setTag(\"pm.command_resolution\", metadata.command_resolution);\n    }\n    if (typeof metadata?.resolution_stage === \"string\" && metadata.resolution_stage.trim().length > 0) {\n      Sentry.setTag(\"pm.resolution_stage\", metadata.resolution_stage);\n    }\n  }\n  setSpanAttribute(activeCommandSpan, \"pm.ok\", normalizedOk);\n  setSpanAttribute(activeCommandSpan, \"pm.command_ok\", normalizedOk);\n  setSpanAttribute(activeCommandSpan, \"pm.exit_code\", normalizedExitCode);\n  setSpanAttribute(activeCommandSpan, \"pm.command_exit_code\", normalizedExitCode);\n  setSpanAttribute(activeCommandSpan, \"pm.error_code\", metadata?.error_code);\n  setSpanAttribute(activeCommandSpan, \"pm.error_category\", metadata?.error_category);\n  setSpanAttribute(activeCommandSpan, \"pm.command_resolution\", metadata?.command_resolution);\n  setSpanAttribute(activeCommandSpan, \"pm.resolution_stage\", metadata?.resolution_stage);\n  activeCommandSpan.setStatus(ok ? { code: 1 } : { code: 2, message: error ?? \"command_failed\" });\n  activeCommandSpan.end();\n  activeCommandSpan = undefined;\n}\n\nexport function sentryCaptureCliError(error: unknown): void {\n  if (!shouldCaptureCliError(error)) return;\n\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  if (error instanceof Error) {\n    const extras: Record<string, unknown> = {};\n    if (\"exitCode\" in error && typeof (error as { exitCode: unknown }).exitCode === \"number\") {\n      extras.exit_code = (error as { exitCode: number }).exitCode;\n    }\n    if (\"context\" in error && typeof (error as { context: unknown }).context === \"object\") {\n      extras.error_context = (error as { context: unknown }).context;\n    }\n    Sentry.captureException(error, { extra: extras });\n  } else {\n    Sentry.captureException(new Error(String(error)));\n  }\n}\n\nexport function sentryLogCliUsageError(params: {\n  command: string;\n  error_code: string;\n  error_category: TelemetryErrorCategory;\n  exit_code: number;\n  error_message: string;\n  command_resolution?: TelemetryCommandResolution;\n  resolution_stage?: TelemetryResolutionStage;\n  source_context?: string;\n}): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n  const resolvedCommandResolution =\n    params.command_resolution ??\n    deriveTelemetryCommandResolution({\n      ok: false,\n      errorCode: params.error_code,\n      errorCategory: params.error_category,\n    });\n  const resolvedResolutionStage = params.resolution_stage ?? \"unknown\";\n\n  const payload = {\n    \"pm.command\": params.command,\n    \"pm.error_code\": params.error_code,\n    \"pm.error_category\": params.error_category,\n    \"pm.exit_code\": params.exit_code,\n    \"pm.error_message\": params.error_message,\n    \"pm.command_resolution\": resolvedCommandResolution,\n    \"pm.resolution_stage\": resolvedResolutionStage,\n    \"pm.source_context\": params.source_context ?? \"\",\n  };\n  const loggerCandidate = (Sentry as unknown as { logger?: { warn?: (message: string, attributes?: Record<string, unknown>) => void } })\n    .logger;\n  if (loggerCandidate && typeof loggerCandidate.warn === \"function\") {\n    loggerCandidate.warn(\"pm_cli_usage_error\", payload);\n    return;\n  }\n\n  Sentry.captureMessage(`pm_cli_usage_error:${params.error_code}`, {\n    level: \"warning\",\n    tags: {\n      \"pm.command\": params.command,\n      \"pm.error_code\": params.error_code,\n      \"pm.error_category\": params.error_category,\n      \"pm.exit_code\": String(params.exit_code),\n      \"pm.command_resolution\": resolvedCommandResolution,\n      \"pm.resolution_stage\": resolvedResolutionStage,\n      \"pm.source_context\": params.source_context ?? \"unknown\",\n    },\n    extra: payload,\n  });\n}\n\nexport function shouldCaptureCliError(error: unknown): boolean {\n  if (error instanceof PmCliError) {\n    return false;\n  }\n  if (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"exitCode\" in error &&\n    typeof (error as { exitCode?: unknown }).exitCode === \"number\"\n  ) {\n    const exitCode = Math.trunc((error as { exitCode: number }).exitCode);\n    const expectedExitCodes: ReadonlySet<number> = new Set([\n      EXIT_CODE.SUCCESS,\n      EXIT_CODE.USAGE,\n      EXIT_CODE.NOT_FOUND,\n      EXIT_CODE.CONFLICT,\n    ]);\n    return !expectedExitCodes.has(exitCode);\n  }\n  return true;\n}\n\nexport async function sentryFlush(timeoutMs = 3000): Promise<void> {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  try {\n    await Sentry.flush(timeoutMs);\n  } catch {\n    // Sentry flush must never block CLI exit.\n  }\n}\n"],"names":[],"mappings":"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","debugId":"92efd73f-f305-5695-8211-81b579afe53d"}

package/dist/core/shared/constants.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]="7ad6d040-d32b-5ce2-adf9-3c5cc6cf13de")}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]="0658378d-3fa8-59fa-ab4a-8f1bba265e01")}catch(e){}}();
 import { createDefaultExtensionGovernancePolicy } from "../extensions/extension-types.js";
 /**
  * Canonical default lifecycle status model and workflow role mapping.
@@ -279,6 +279,7 @@ export const SETTINGS_DEFAULTS = {
         embedding_timeout_ms: 30_000,
         scanner_max_batch_retries: 3,
         provider: "",
+        mutation_refresh_policy: "semantic_configured",
     },
     providers: {
         openai: {
@@ -374,4 +375,4 @@ export function resolveTelemetryErrorCategory(errorCode) {
     return "unknown";
 }
 //# sourceMappingURL=constants.js.map
-//# debugId=7ad6d040-d32b-5ce2-adf9-3c5cc6cf13de
+//# debugId=0658378d-3fa8-59fa-ab4a-8f1bba265e01

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  \"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"}
+{"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    mutation_refresh_policy: \"semantic_configured\",\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":"0658378d-3fa8-59fa-ab4a-8f1bba265e01"}

package/dist/core/shared/html-entity-decode.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Decode the five core HTML entities (`<`, `>`, `"`, `'`,
+ * `&`) in a single pass — but only when the input contains `<` or
+ * `>`. Returns the input unchanged otherwise so the function is a no-op for
+ * normal text and idempotent on already-decoded strings.
+ *
+ * Single-pass semantics guarantee `<` decodes to `<` (literal) rather
+ * than collapsing to `<`, preserving any intentional double-encoding.
+ */
+export declare function decodeHtmlEntitiesIfEscaped(input: string): string;
+/**
+ * Walk an arbitrary value (string / array / plain object) and apply
+ * {@link decodeHtmlEntitiesIfEscaped} to every string leaf. Non-string scalars
+ * (numbers, booleans, null, undefined) and non-plain values pass through
+ * untouched.
+ *
+ * The walker mutates a fresh shallow copy at each level so the caller's input
+ * is not modified. Cycles are not expected (MCP arguments arrive as JSON), but
+ * a WeakMap is used as defensive protection against accidental cycles and
+ * repeated references.
+ */
+export declare function decodeHtmlEntitiesInOptions<T>(options: T): T;

package/dist/core/shared/html-entity-decode.js

@@ -0,0 +1,127 @@
+// Defensive HTML-entity decode for free-text fields arriving over the MCP boundary.
+// Background (pm-ydkl 2026-05-28): when Claude / the Anthropic MCP SDK forwards
+// tool arguments containing `<` or `>`, the upstream platform HTML-encodes those
+// characters before they reach pm-cli. The result is stored pm text containing
+// literal `&lt;type&gt;` instead of `<type>`. Direct CLI calls do NOT have this
+// issue — only the MCP path — so the decode is applied exclusively at the MCP
+// server boundary on incoming tool-call arguments.
+//
+// We decode only the five core HTML entities and ONLY when `&lt;` or `&gt;` is
+// present in the string (the signal that something upstream HTML-encoded it).
+// That makes the function a true no-op for normal text. All replacements run in
+// a single non-greedy pass via a lookup map so we never double-decode — most
+// importantly `&amp;lt;` stays as the literal `&lt;` (because `&amp;` is the
+// last entity resolved in the pass), preserving any text that was already
+// double-encoded upstream.
+
+!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]="34d22aab-8ac6-5f82-b625-f7fd5673e13f")}catch(e){}}();
+const ENTITY_MAP = Object.freeze({
+    "&lt;": "<",
+    "&gt;": ">",
+    "&quot;": '"',
+    "&#39;": "'",
+    "&amp;": "&",
+});
+// Pattern order is important for documentation only: the alternation matches
+// the leftmost occurrence at each position, and the map lookup resolves each
+// match independently. Crucially, `&amp;` is matched as a whole token, so a
+// substring like `&amp;lt;` matches `&amp;` once → `&lt;` (literal) and the
+// regex engine then advances past the inserted text without re-scanning it.
+const ENTITY_PATTERN = /&(?:lt|gt|quot|#39|amp);/g;
+/**
+ * Decode the five core HTML entities (`&lt;`, `&gt;`, `&quot;`, `&#39;`,
+ * `&amp;`) in a single pass — but only when the input contains `&lt;` or
+ * `&gt;`. Returns the input unchanged otherwise so the function is a no-op for
+ * normal text and idempotent on already-decoded strings.
+ *
+ * Single-pass semantics guarantee `&amp;lt;` decodes to `&lt;` (literal) rather
+ * than collapsing to `<`, preserving any intentional double-encoding.
+ */
+export function decodeHtmlEntitiesIfEscaped(input) {
+    if (typeof input !== "string") {
+        return input;
+    }
+    // Activation signal is INTENTIONALLY narrow: only `&lt;` / `&gt;` trigger
+    // decoding. Rationale: the observed MCP-platform behavior only encodes
+    // angle brackets (the characters that risk display-time HTML
+    // misinterpretation upstream). Widening to `&amp;` / `&quot;` / `&#39;`
+    // would risk altering legitimate text that contains those literal token
+    // sequences for unrelated reasons (a URL containing `&amp;`, a snippet
+    // of HTML being intentionally stored as escaped, etc.). If upstream
+    // changes its encoding policy to cover `&` / `"` / `'` standalone, the
+    // signal-guard here will need to be widened in lockstep — covered by
+    // tests `&amp;-only is no-op` and `&quot;-only is no-op`.
+    if (!input.includes("&lt;") && !input.includes("&gt;")) {
+        return input;
+    }
+    // The regex only matches keys present in ENTITY_MAP, so the lookup is total.
+    return input.replace(ENTITY_PATTERN, (match) => ENTITY_MAP[match]);
+}
+/**
+ * Walk an arbitrary value (string / array / plain object) and apply
+ * {@link decodeHtmlEntitiesIfEscaped} to every string leaf. Non-string scalars
+ * (numbers, booleans, null, undefined) and non-plain values pass through
+ * untouched.
+ *
+ * The walker mutates a fresh shallow copy at each level so the caller's input
+ * is not modified. Cycles are not expected (MCP arguments arrive as JSON), but
+ * a WeakMap is used as defensive protection against accidental cycles and
+ * repeated references.
+ */
+export function decodeHtmlEntitiesInOptions(options) {
+    return decodeValue(options, new WeakMap());
+}
+function decodeValue(value, seen) {
+    if (typeof value === "string") {
+        return decodeHtmlEntitiesIfEscaped(value);
+    }
+    if (Array.isArray(value)) {
+        if (seen.has(value)) {
+            return seen.get(value);
+        }
+        const result = [];
+        seen.set(value, result);
+        for (const entry of value) {
+            result.push(decodeValue(entry, seen));
+        }
+        return result;
+    }
+    if (value !== null && typeof value === "object") {
+        // Only traverse plain objects (`{}` and `Object.create(null)` literals).
+        // Class instances (Date, RegExp, Map, Set, Buffer, etc.) and `null`-proto
+        // objects with no proto would lose their prototype and methods if we
+        // rebuilt them as a `Record<string, unknown>` here, so we pass them through.
+        if (!isPlainObject(value)) {
+            return value;
+        }
+        if (seen.has(value)) {
+            return seen.get(value);
+        }
+        const source = value;
+        // Preserve the original prototype so downstream callers can still rely on
+        // standard methods like `.hasOwnProperty` on plain objects.
+        const result = Object.create(Object.getPrototypeOf(value));
+        seen.set(value, result);
+        // Use Object.defineProperty (not bracket assignment) for ALL keys so a
+        // smuggled `__proto__` / `constructor` / `prototype` key from an MCP
+        // caller becomes a regular own property — never triggers JS's special
+        // prototype-chain assignment semantics that would otherwise pollute
+        // Object.prototype. This preserves legitimate data while staying safe.
+        for (const [key, entry] of Object.entries(source)) {
+            Object.defineProperty(result, key, {
+                value: decodeValue(entry, seen),
+                enumerable: true,
+                writable: true,
+                configurable: true,
+            });
+        }
+        return result;
+    }
+    return value;
+}
+function isPlainObject(value) {
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+//# sourceMappingURL=html-entity-decode.js.map
+//# debugId=34d22aab-8ac6-5f82-b625-f7fd5673e13f

package/dist/core/shared/html-entity-decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-entity-decode.js","sources":["core/shared/html-entity-decode.ts"],"sourceRoot":"/","sourcesContent":["// Defensive HTML-entity decode for free-text fields arriving over the MCP boundary.\n// Background (pm-ydkl 2026-05-28): when Claude / the Anthropic MCP SDK forwards\n// tool arguments containing `<` or `>`, the upstream platform HTML-encodes those\n// characters before they reach pm-cli. The result is stored pm text containing\n// literal `&lt;type&gt;` instead of `<type>`. Direct CLI calls do NOT have this\n// issue — only the MCP path — so the decode is applied exclusively at the MCP\n// server boundary on incoming tool-call arguments.\n//\n// We decode only the five core HTML entities and ONLY when `&lt;` or `&gt;` is\n// present in the string (the signal that something upstream HTML-encoded it).\n// That makes the function a true no-op for normal text. All replacements run in\n// a single non-greedy pass via a lookup map so we never double-decode — most\n// importantly `&amp;lt;` stays as the literal `&lt;` (because `&amp;` is the\n// last entity resolved in the pass), preserving any text that was already\n// double-encoded upstream.\n\nconst ENTITY_MAP: Readonly<Record<string, string>> = Object.freeze({\n  \"&lt;\": \"<\",\n  \"&gt;\": \">\",\n  \"&quot;\": '\"',\n  \"&#39;\": \"'\",\n  \"&amp;\": \"&\",\n});\n\n// Pattern order is important for documentation only: the alternation matches\n// the leftmost occurrence at each position, and the map lookup resolves each\n// match independently. Crucially, `&amp;` is matched as a whole token, so a\n// substring like `&amp;lt;` matches `&amp;` once → `&lt;` (literal) and the\n// regex engine then advances past the inserted text without re-scanning it.\nconst ENTITY_PATTERN = /&(?:lt|gt|quot|#39|amp);/g;\n\n/**\n * Decode the five core HTML entities (`&lt;`, `&gt;`, `&quot;`, `&#39;`,\n * `&amp;`) in a single pass — but only when the input contains `&lt;` or\n * `&gt;`. Returns the input unchanged otherwise so the function is a no-op for\n * normal text and idempotent on already-decoded strings.\n *\n * Single-pass semantics guarantee `&amp;lt;` decodes to `&lt;` (literal) rather\n * than collapsing to `<`, preserving any intentional double-encoding.\n */\nexport function decodeHtmlEntitiesIfEscaped(input: string): string {\n  if (typeof input !== \"string\") {\n    return input;\n  }\n  // Activation signal is INTENTIONALLY narrow: only `&lt;` / `&gt;` trigger\n  // decoding. Rationale: the observed MCP-platform behavior only encodes\n  // angle brackets (the characters that risk display-time HTML\n  // misinterpretation upstream). Widening to `&amp;` / `&quot;` / `&#39;`\n  // would risk altering legitimate text that contains those literal token\n  // sequences for unrelated reasons (a URL containing `&amp;`, a snippet\n  // of HTML being intentionally stored as escaped, etc.). If upstream\n  // changes its encoding policy to cover `&` / `\"` / `'` standalone, the\n  // signal-guard here will need to be widened in lockstep — covered by\n  // tests `&amp;-only is no-op` and `&quot;-only is no-op`.\n  if (!input.includes(\"&lt;\") && !input.includes(\"&gt;\")) {\n    return input;\n  }\n  // The regex only matches keys present in ENTITY_MAP, so the lookup is total.\n  return input.replace(ENTITY_PATTERN, (match) => ENTITY_MAP[match] as string);\n}\n\n/**\n * Walk an arbitrary value (string / array / plain object) and apply\n * {@link decodeHtmlEntitiesIfEscaped} to every string leaf. Non-string scalars\n * (numbers, booleans, null, undefined) and non-plain values pass through\n * untouched.\n *\n * The walker mutates a fresh shallow copy at each level so the caller's input\n * is not modified. Cycles are not expected (MCP arguments arrive as JSON), but\n * a WeakMap is used as defensive protection against accidental cycles and\n * repeated references.\n */\nexport function decodeHtmlEntitiesInOptions<T>(options: T): T {\n  return decodeValue(options, new WeakMap<object, unknown>()) as T;\n}\n\nfunction decodeValue(value: unknown, seen: WeakMap<object, unknown>): unknown {\n  if (typeof value === \"string\") {\n    return decodeHtmlEntitiesIfEscaped(value);\n  }\n  if (Array.isArray(value)) {\n    if (seen.has(value)) {\n      return seen.get(value);\n    }\n    const result: unknown[] = [];\n    seen.set(value, result);\n    for (const entry of value) {\n      result.push(decodeValue(entry, seen));\n    }\n    return result;\n  }\n  if (value !== null && typeof value === \"object\") {\n    // Only traverse plain objects (`{}` and `Object.create(null)` literals).\n    // Class instances (Date, RegExp, Map, Set, Buffer, etc.) and `null`-proto\n    // objects with no proto would lose their prototype and methods if we\n    // rebuilt them as a `Record<string, unknown>` here, so we pass them through.\n    if (!isPlainObject(value)) {\n      return value;\n    }\n    if (seen.has(value as object)) {\n      return seen.get(value as object);\n    }\n    const source = value as Record<string, unknown>;\n    // Preserve the original prototype so downstream callers can still rely on\n    // standard methods like `.hasOwnProperty` on plain objects.\n    const result: Record<string, unknown> = Object.create(Object.getPrototypeOf(value as object));\n    seen.set(value as object, result);\n    // Use Object.defineProperty (not bracket assignment) for ALL keys so a\n    // smuggled `__proto__` / `constructor` / `prototype` key from an MCP\n    // caller becomes a regular own property — never triggers JS's special\n    // prototype-chain assignment semantics that would otherwise pollute\n    // Object.prototype. This preserves legitimate data while staying safe.\n    for (const [key, entry] of Object.entries(source)) {\n      Object.defineProperty(result, key, {\n        value: decodeValue(entry, seen),\n        enumerable: true,\n        writable: true,\n        configurable: true,\n      });\n    }\n    return result;\n  }\n  return value;\n}\n\nfunction isPlainObject(value: object): boolean {\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n"],"names":[],"mappings":"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","debugId":"34d22aab-8ac6-5f82-b625-f7fd5673e13f"}

package/dist/core/shared/split-comma-list.d.ts

@@ -0,0 +1,20 @@
+export interface SplitCommaListOptions {
+    /** Separator pattern. Defaults to `/,/`. */
+    separators?: RegExp | string;
+    /** De-duplicate entries while preserving first-seen order. Defaults to `true`. */
+    unique?: boolean;
+    /** Sort entries lexicographically (default JS string sort). Defaults to `false`. */
+    sort?: boolean;
+}
+/**
+ * Split a comma-separated (or custom-separator) string into trimmed, non-empty entries.
+ *
+ * Default behaviour:
+ *   - Splits on `,`.
+ *   - Trims each entry and discards empty results (collapsing leading/trailing/duplicate separators).
+ *   - De-duplicates while preserving first-seen order.
+ *   - Does not sort.
+ *
+ * Returns `[]` for `undefined`/`null` input. Pure, dependency-free.
+ */
+export declare function splitCommaList(raw: string | undefined | null, options?: SplitCommaListOptions): string[];

package/dist/core/shared/split-comma-list.js

@@ -0,0 +1,29 @@
+/**
+ * Split a comma-separated (or custom-separator) string into trimmed, non-empty entries.
+ *
+ * Default behaviour:
+ *   - Splits on `,`.
+ *   - Trims each entry and discards empty results (collapsing leading/trailing/duplicate separators).
+ *   - De-duplicates while preserving first-seen order.
+ *   - Does not sort.
+ *
+ * Returns `[]` for `undefined`/`null` input. Pure, dependency-free.
+ */
+
+!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]="e5a31927-2a55-5d1d-97e4-b6190988caa1")}catch(e){}}();
+export function splitCommaList(raw, options) {
+    if (raw === undefined || raw === null) {
+        return [];
+    }
+    const separators = options?.separators ?? /,/;
+    const parts = raw.split(separators);
+    const trimmed = parts.map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+    const unique = options?.unique !== false;
+    const deduped = unique ? Array.from(new Set(trimmed)) : trimmed;
+    if (options?.sort === true) {
+        return [...deduped].sort();
+    }
+    return deduped;
+}
+//# sourceMappingURL=split-comma-list.js.map
+//# debugId=e5a31927-2a55-5d1d-97e4-b6190988caa1

package/dist/core/shared/split-comma-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-comma-list.js","sources":["core/shared/split-comma-list.ts"],"sourceRoot":"/","sourcesContent":["export interface SplitCommaListOptions {\n  /** Separator pattern. Defaults to `/,/`. */\n  separators?: RegExp | string;\n  /** De-duplicate entries while preserving first-seen order. Defaults to `true`. */\n  unique?: boolean;\n  /** Sort entries lexicographically (default JS string sort). Defaults to `false`. */\n  sort?: boolean;\n}\n\n/**\n * Split a comma-separated (or custom-separator) string into trimmed, non-empty entries.\n *\n * Default behaviour:\n *   - Splits on `,`.\n *   - Trims each entry and discards empty results (collapsing leading/trailing/duplicate separators).\n *   - De-duplicates while preserving first-seen order.\n *   - Does not sort.\n *\n * Returns `[]` for `undefined`/`null` input. Pure, dependency-free.\n */\nexport function splitCommaList(raw: string | undefined | null, options?: SplitCommaListOptions): string[] {\n  if (raw === undefined || raw === null) {\n    return [];\n  }\n  const separators = options?.separators ?? /,/;\n  const parts = raw.split(separators as never);\n  const trimmed = parts.map((entry) => entry.trim()).filter((entry) => entry.length > 0);\n  const unique = options?.unique !== false;\n  const deduped = unique ? Array.from(new Set(trimmed)) : trimmed;\n  if (options?.sort === true) {\n    return [...deduped].sort();\n  }\n  return deduped;\n}\n"],"names":[],"mappings":"AASA;;;;;;;;;;GAUG;;;AACH,MAAM,UAAU,cAAc,CAAC,GAA8B,EAAE,OAA+B;IAC5F,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,GAAG,CAAC;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,UAAmB,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,IAAI,OAAO,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","debugId":"e5a31927-2a55-5d1d-97e4-b6190988caa1"}

package/dist/core/shared/time.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]="a29d4357-1ae1-52f9-97ee-85b5fda86e40")}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]="b41467c9-6c80-5391-b9eb-3d13f170a105")}catch(e){}}();
 import { PmCliError } from "./errors.js";
 import { EXIT_CODE } from "./constants.js";
 const RELATIVE_DEADLINE = /^([+-]?)(\d+)([hdwm])$/i;
@@ -89,6 +89,55 @@ function parseTimestampWithFallbacks(input) {
 function daysInUtcMonth(year, monthIndex) {
     return new Date(Date.UTC(year, monthIndex + 1, 0)).getUTCDate();
 }
+const MONTH_NAMES = [
+    "January",
+    "February",
+    "March",
+    "April",
+    "May",
+    "June",
+    "July",
+    "August",
+    "September",
+    "October",
+    "November",
+    "December",
+];
+// Leading literal calendar date in either hyphenated (`2026-02-30`) or compact
+// (`20260230`) form, optionally followed by any time/zone component. We validate
+// the digits the caller actually typed — not the parsed instant — so timezone
+// offsets never produce a false "impossible date" rejection. The hyphenated form
+// is unambiguous, so anything may follow (`T`/space time, `Z`, `+/-` offset). The
+// compact form must be followed by end-of-string or a time digit (with an optional
+// `T`/space separator) so a no-separator compact datetime like `20260230135900Z`
+// is still guarded and a 7-digit non-date is not misread as a date.
+const LEADING_HYPHEN_DATE = /^(\d{4})-(\d{2})-(\d{2})/;
+const LEADING_COMPACT_DATE = /^(\d{4})(\d{2})(\d{2})(?:[T ]?\d{2}|$)/;
+/**
+ * Reject literal calendar dates whose day cannot exist (e.g. `2026-02-30`, which JS
+ * `Date` silently rolls forward to March 2). Without this, agents that pass an
+ * impossible deadline get a silently-wrong stored date instead of an actionable
+ * error. Only triggers on a leading literal date; relative tokens, "now", and pure
+ * times are untouched. Month 00 / >12 is also rejected with a clear message rather
+ * than falling through to the generic "invalid value" path.
+ */
+function assertRealCalendarDate(originalInput, trimmed, fieldLabel) {
+    const match = LEADING_HYPHEN_DATE.exec(trimmed) ?? LEADING_COMPACT_DATE.exec(trimmed);
+    if (!match) {
+        return;
+    }
+    const year = Number.parseInt(match[1], 10);
+    const month = Number.parseInt(match[2], 10);
+    const day = Number.parseInt(match[3], 10);
+    const label = fieldLabel?.trim() || "deadline";
+    if (month < 1 || month > 12) {
+        throw new PmCliError(`Invalid ${label} value "${originalInput}". Month "${match[2]}" is out of range — use a month between 01 and 12.`, EXIT_CODE.USAGE);
+    }
+    const maxDay = daysInUtcMonth(year, month - 1);
+    if (day < 1 || day > maxDay) {
+        throw new PmCliError(`Invalid ${label} value "${originalInput}". ${MONTH_NAMES[month - 1]} ${year} has ${maxDay} days, so day "${match[3]}" does not exist. Use a real YYYY-MM-DD calendar date.`, EXIT_CODE.USAGE);
+    }
+}
 function addUtcMonths(now, amount) {
     const result = new Date(now.getTime());
     const startDay = result.getUTCDate();
@@ -115,6 +164,7 @@ export function resolveIsoOrRelative(input, now = new Date(), fieldLabel = "dead
         const msPerUnit = unit === "h" ? 60 * 60 * 1000 : unit === "d" ? 24 * 60 * 60 * 1000 : 7 * 24 * 60 * 60 * 1000;
         return new Date(now.getTime() + amount * msPerUnit).toISOString();
     }
+    assertRealCalendarDate(input, trimmed, fieldLabel);
     const timestamp = parseTimestampWithFallbacks(trimmed);
     if (!Number.isFinite(timestamp)) {
         const normalizedLabel = fieldLabel.trim().length > 0 ? fieldLabel.trim() : "deadline";
@@ -126,4 +176,4 @@ export function resolveIsoOrRelative(input, now = new Date(), fieldLabel = "dead
     return new Date(timestamp).toISOString();
 }
 //# sourceMappingURL=time.js.map
-//# debugId=a29d4357-1ae1-52f9-97ee-85b5fda86e40
+//# debugId=b41467c9-6c80-5391-b9eb-3d13f170a105

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

@@ -1 +1 @@
-{"version":3,"file":"time.js","sources":["core/shared/time.ts"],"sourceRoot":"/","sourcesContent":["import { PmCliError } from \"./errors.js\";\nimport { EXIT_CODE } from \"./constants.js\";\n\nconst RELATIVE_DEADLINE = /^([+-]?)(\\d+)([hdwm])$/i;\nconst COMPOUND_RELATIVE_DEADLINE = /^[+-]?\\d+[hdwm](?:[+-]\\d+[hdwm])+$/i;\nconst COMPACT_DATE = /^(\\d{4})(\\d{2})(\\d{2})$/;\nconst COMPACT_DATETIME = /^(\\d{4})(\\d{2})(\\d{2})(?:[T\\s]?)(\\d{2})(\\d{2})(\\d{2})?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\nconst HYPHEN_TIME = /^(\\d{4}-\\d{2}-\\d{2})[T\\s](\\d{2})-(\\d{2})(?:-(\\d{2}))?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\nconst COMPACT_TIME = /^(\\d{4}-\\d{2}-\\d{2})[T\\s](\\d{2})(\\d{2})(\\d{2})?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\n\nexport function nowIso(): string {\n  return new Date().toISOString();\n}\n\nexport function isTimestampLiteral(input: string): boolean {\n  return Number.isFinite(Date.parse(input));\n}\n\nexport function compareTimestampStrings(left: string, right: string): number {\n  const leftMs = Date.parse(left);\n  const rightMs = Date.parse(right);\n  if (Number.isFinite(leftMs) && Number.isFinite(rightMs) && leftMs !== rightMs) {\n    return leftMs - rightMs;\n  }\n  return left.localeCompare(right);\n}\n\nfunction normalizeFraction(raw: string | undefined): string {\n  if (!raw) return \"\";\n  const digits = raw.slice(1);\n  return `.${digits.padEnd(3, \"0\").slice(0, 3)}`;\n}\n\nfunction normalizeOffset(raw: string | undefined): string {\n  if (!raw) return \"\";\n  if (raw.toUpperCase() === \"Z\") return \"Z\";\n  const compact = /^([+-]\\d{2})(\\d{2})$/.exec(raw);\n  if (compact) return `${compact[1]}:${compact[2]}`;\n  return raw;\n}\n\nfunction normalizeTimestampCandidates(input: string): string[] {\n  const candidates: string[] = [];\n  const push = (value: string | undefined): void => {\n    if (!value || value === input || candidates.includes(value)) return;\n    candidates.push(value);\n  };\n\n  const compactDate = COMPACT_DATE.exec(input);\n  if (compactDate) {\n    const [, year, month, day] = compactDate;\n    push(`${year}-${month}-${day}`);\n  }\n\n  const compactDateTime = COMPACT_DATETIME.exec(input);\n  if (compactDateTime) {\n    const [, year, month, day, hour, minute, secondRaw, fractionRaw, offsetRaw] = compactDateTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(\n      `${year}-${month}-${day}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`,\n    );\n  }\n\n  const hyphenTime = HYPHEN_TIME.exec(input);\n  if (hyphenTime) {\n    const [, datePart, hour, minute, secondRaw, fractionRaw, offsetRaw] = hyphenTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(`${datePart}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`);\n  }\n\n  const compactTime = COMPACT_TIME.exec(input);\n  if (compactTime) {\n    const [, datePart, hour, minute, secondRaw, fractionRaw, offsetRaw] = compactTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(`${datePart}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`);\n  }\n\n  const spaceDateTime = /^(\\d{4}-\\d{2}-\\d{2})\\s+(.+)$/.exec(input);\n  if (spaceDateTime) {\n    const [, datePart, timePart] = spaceDateTime;\n    push(`${datePart}T${timePart}`);\n  }\n\n  return candidates;\n}\n\nfunction parseTimestampWithFallbacks(input: string): number {\n  const direct = Date.parse(input);\n  if (Number.isFinite(direct)) return direct;\n  for (const candidate of normalizeTimestampCandidates(input)) {\n    const parsed = Date.parse(candidate);\n    if (Number.isFinite(parsed)) return parsed;\n  }\n  return Number.NaN;\n}\n\nfunction daysInUtcMonth(year: number, monthIndex: number): number {\n  return new Date(Date.UTC(year, monthIndex + 1, 0)).getUTCDate();\n}\n\nfunction addUtcMonths(now: Date, amount: number): Date {\n  const result = new Date(now.getTime());\n  const startDay = result.getUTCDate();\n  const targetMonthIndex = result.getUTCMonth() + amount;\n  const targetYear = result.getUTCFullYear() + Math.floor(targetMonthIndex / 12);\n  const targetMonth = ((targetMonthIndex % 12) + 12) % 12;\n  const day = Math.min(startDay, daysInUtcMonth(targetYear, targetMonth));\n  result.setUTCFullYear(targetYear, targetMonth, day);\n  return result;\n}\n\nexport function resolveIsoOrRelative(\n  input: string,\n  now: Date = new Date(),\n  fieldLabel = \"deadline\",\n): string {\n  const trimmed = input.trim();\n  if (trimmed.toLowerCase() === \"now\") {\n    return now.toISOString();\n  }\n  const relative = RELATIVE_DEADLINE.exec(trimmed);\n  if (relative) {\n    const sign = relative[1] === \"-\" ? -1 : 1;\n    const amount = Number.parseInt(relative[2], 10) * sign;\n    const unit = relative[3].toLowerCase();\n    if (unit === \"m\") {\n      return addUtcMonths(now, amount).toISOString();\n    }\n    const msPerUnit = unit === \"h\" ? 60 * 60 * 1000 : unit === \"d\" ? 24 * 60 * 60 * 1000 : 7 * 24 * 60 * 60 * 1000;\n    return new Date(now.getTime() + amount * msPerUnit).toISOString();\n  }\n\n  const timestamp = parseTimestampWithFallbacks(trimmed);\n  if (!Number.isFinite(timestamp)) {\n    const normalizedLabel = fieldLabel.trim().length > 0 ? fieldLabel.trim() : \"deadline\";\n    const guidance = COMPOUND_RELATIVE_DEADLINE.test(trimmed)\n      ? \"Compound relative expressions like +3d+1h are not supported; use a single relative token (for example +3d) or an ISO/date string.\"\n      : 'Use ISO/date string input, \"now\", or relative +6h/-6h/+1d/-1d/+2w/-2w/+6m/-6m.';\n    throw new PmCliError(\n      `Invalid ${normalizedLabel} value \"${input}\". ${guidance}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return new Date(timestamp).toISOString();\n}\n"],"names":[],"mappings":"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","debugId":"a29d4357-1ae1-52f9-97ee-85b5fda86e40"}
+{"version":3,"file":"time.js","sources":["core/shared/time.ts"],"sourceRoot":"/","sourcesContent":["import { PmCliError } from \"./errors.js\";\nimport { EXIT_CODE } from \"./constants.js\";\n\nconst RELATIVE_DEADLINE = /^([+-]?)(\\d+)([hdwm])$/i;\nconst COMPOUND_RELATIVE_DEADLINE = /^[+-]?\\d+[hdwm](?:[+-]\\d+[hdwm])+$/i;\nconst COMPACT_DATE = /^(\\d{4})(\\d{2})(\\d{2})$/;\nconst COMPACT_DATETIME = /^(\\d{4})(\\d{2})(\\d{2})(?:[T\\s]?)(\\d{2})(\\d{2})(\\d{2})?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\nconst HYPHEN_TIME = /^(\\d{4}-\\d{2}-\\d{2})[T\\s](\\d{2})-(\\d{2})(?:-(\\d{2}))?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\nconst COMPACT_TIME = /^(\\d{4}-\\d{2}-\\d{2})[T\\s](\\d{2})(\\d{2})(\\d{2})?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\n\nexport function nowIso(): string {\n  return new Date().toISOString();\n}\n\nexport function isTimestampLiteral(input: string): boolean {\n  return Number.isFinite(Date.parse(input));\n}\n\nexport function compareTimestampStrings(left: string, right: string): number {\n  const leftMs = Date.parse(left);\n  const rightMs = Date.parse(right);\n  if (Number.isFinite(leftMs) && Number.isFinite(rightMs) && leftMs !== rightMs) {\n    return leftMs - rightMs;\n  }\n  return left.localeCompare(right);\n}\n\nfunction normalizeFraction(raw: string | undefined): string {\n  if (!raw) return \"\";\n  const digits = raw.slice(1);\n  return `.${digits.padEnd(3, \"0\").slice(0, 3)}`;\n}\n\nfunction normalizeOffset(raw: string | undefined): string {\n  if (!raw) return \"\";\n  if (raw.toUpperCase() === \"Z\") return \"Z\";\n  const compact = /^([+-]\\d{2})(\\d{2})$/.exec(raw);\n  if (compact) return `${compact[1]}:${compact[2]}`;\n  return raw;\n}\n\nfunction normalizeTimestampCandidates(input: string): string[] {\n  const candidates: string[] = [];\n  const push = (value: string | undefined): void => {\n    if (!value || value === input || candidates.includes(value)) return;\n    candidates.push(value);\n  };\n\n  const compactDate = COMPACT_DATE.exec(input);\n  if (compactDate) {\n    const [, year, month, day] = compactDate;\n    push(`${year}-${month}-${day}`);\n  }\n\n  const compactDateTime = COMPACT_DATETIME.exec(input);\n  if (compactDateTime) {\n    const [, year, month, day, hour, minute, secondRaw, fractionRaw, offsetRaw] = compactDateTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(\n      `${year}-${month}-${day}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`,\n    );\n  }\n\n  const hyphenTime = HYPHEN_TIME.exec(input);\n  if (hyphenTime) {\n    const [, datePart, hour, minute, secondRaw, fractionRaw, offsetRaw] = hyphenTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(`${datePart}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`);\n  }\n\n  const compactTime = COMPACT_TIME.exec(input);\n  if (compactTime) {\n    const [, datePart, hour, minute, secondRaw, fractionRaw, offsetRaw] = compactTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(`${datePart}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`);\n  }\n\n  const spaceDateTime = /^(\\d{4}-\\d{2}-\\d{2})\\s+(.+)$/.exec(input);\n  if (spaceDateTime) {\n    const [, datePart, timePart] = spaceDateTime;\n    push(`${datePart}T${timePart}`);\n  }\n\n  return candidates;\n}\n\nfunction parseTimestampWithFallbacks(input: string): number {\n  const direct = Date.parse(input);\n  if (Number.isFinite(direct)) return direct;\n  for (const candidate of normalizeTimestampCandidates(input)) {\n    const parsed = Date.parse(candidate);\n    if (Number.isFinite(parsed)) return parsed;\n  }\n  return Number.NaN;\n}\n\nfunction daysInUtcMonth(year: number, monthIndex: number): number {\n  return new Date(Date.UTC(year, monthIndex + 1, 0)).getUTCDate();\n}\n\nconst MONTH_NAMES = [\n  \"January\",\n  \"February\",\n  \"March\",\n  \"April\",\n  \"May\",\n  \"June\",\n  \"July\",\n  \"August\",\n  \"September\",\n  \"October\",\n  \"November\",\n  \"December\",\n] as const;\n\n// Leading literal calendar date in either hyphenated (`2026-02-30`) or compact\n// (`20260230`) form, optionally followed by any time/zone component. We validate\n// the digits the caller actually typed — not the parsed instant — so timezone\n// offsets never produce a false \"impossible date\" rejection. The hyphenated form\n// is unambiguous, so anything may follow (`T`/space time, `Z`, `+/-` offset). The\n// compact form must be followed by end-of-string or a time digit (with an optional\n// `T`/space separator) so a no-separator compact datetime like `20260230135900Z`\n// is still guarded and a 7-digit non-date is not misread as a date.\nconst LEADING_HYPHEN_DATE = /^(\\d{4})-(\\d{2})-(\\d{2})/;\nconst LEADING_COMPACT_DATE = /^(\\d{4})(\\d{2})(\\d{2})(?:[T ]?\\d{2}|$)/;\n\n/**\n * Reject literal calendar dates whose day cannot exist (e.g. `2026-02-30`, which JS\n * `Date` silently rolls forward to March 2). Without this, agents that pass an\n * impossible deadline get a silently-wrong stored date instead of an actionable\n * error. Only triggers on a leading literal date; relative tokens, \"now\", and pure\n * times are untouched. Month 00 / >12 is also rejected with a clear message rather\n * than falling through to the generic \"invalid value\" path.\n */\nfunction assertRealCalendarDate(originalInput: string, trimmed: string, fieldLabel: string): void {\n  const match = LEADING_HYPHEN_DATE.exec(trimmed) ?? LEADING_COMPACT_DATE.exec(trimmed);\n  if (!match) {\n    return;\n  }\n  const year = Number.parseInt(match[1], 10);\n  const month = Number.parseInt(match[2], 10);\n  const day = Number.parseInt(match[3], 10);\n  const label = fieldLabel?.trim() || \"deadline\";\n  if (month < 1 || month > 12) {\n    throw new PmCliError(\n      `Invalid ${label} value \"${originalInput}\". Month \"${match[2]}\" is out of range — use a month between 01 and 12.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const maxDay = daysInUtcMonth(year, month - 1);\n  if (day < 1 || day > maxDay) {\n    throw new PmCliError(\n      `Invalid ${label} value \"${originalInput}\". ${MONTH_NAMES[month - 1]} ${year} has ${maxDay} days, so day \"${match[3]}\" does not exist. Use a real YYYY-MM-DD calendar date.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\nfunction addUtcMonths(now: Date, amount: number): Date {\n  const result = new Date(now.getTime());\n  const startDay = result.getUTCDate();\n  const targetMonthIndex = result.getUTCMonth() + amount;\n  const targetYear = result.getUTCFullYear() + Math.floor(targetMonthIndex / 12);\n  const targetMonth = ((targetMonthIndex % 12) + 12) % 12;\n  const day = Math.min(startDay, daysInUtcMonth(targetYear, targetMonth));\n  result.setUTCFullYear(targetYear, targetMonth, day);\n  return result;\n}\n\nexport function resolveIsoOrRelative(\n  input: string,\n  now: Date = new Date(),\n  fieldLabel = \"deadline\",\n): string {\n  const trimmed = input.trim();\n  if (trimmed.toLowerCase() === \"now\") {\n    return now.toISOString();\n  }\n  const relative = RELATIVE_DEADLINE.exec(trimmed);\n  if (relative) {\n    const sign = relative[1] === \"-\" ? -1 : 1;\n    const amount = Number.parseInt(relative[2], 10) * sign;\n    const unit = relative[3].toLowerCase();\n    if (unit === \"m\") {\n      return addUtcMonths(now, amount).toISOString();\n    }\n    const msPerUnit = unit === \"h\" ? 60 * 60 * 1000 : unit === \"d\" ? 24 * 60 * 60 * 1000 : 7 * 24 * 60 * 60 * 1000;\n    return new Date(now.getTime() + amount * msPerUnit).toISOString();\n  }\n\n  assertRealCalendarDate(input, trimmed, fieldLabel);\n\n  const timestamp = parseTimestampWithFallbacks(trimmed);\n  if (!Number.isFinite(timestamp)) {\n    const normalizedLabel = fieldLabel.trim().length > 0 ? fieldLabel.trim() : \"deadline\";\n    const guidance = COMPOUND_RELATIVE_DEADLINE.test(trimmed)\n      ? \"Compound relative expressions like +3d+1h are not supported; use a single relative token (for example +3d) or an ISO/date string.\"\n      : 'Use ISO/date string input, \"now\", or relative +6h/-6h/+1d/-1d/+2w/-2w/+6m/-6m.';\n    throw new PmCliError(\n      `Invalid ${normalizedLabel} value \"${input}\". ${guidance}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return new Date(timestamp).toISOString();\n}\n"],"names":[],"mappings":"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","debugId":"b41467c9-6c80-5391-b9eb-3d13f170a105"}

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

@@ -1,4 +1,13 @@
 import type { ItemDocument, ItemFormat, ItemMetadata, RuntimeSchemaSettings } from "../../types/index.js";
+/**
+ * Heavy "collection" front-matter fields. These arrays dominate the on-disk cache
+ * (e.g. a single item's comment thread can be hundreds of KB) yet the hot list path
+ * (`pm list`, stats, deps, activity, calendar, close) never reads them. They are
+ * stored in a separate collections cache that is parsed only when a caller opts in
+ * (`includeCollections`), keeping the always-loaded light cache an order of magnitude
+ * smaller and its JSON.parse correspondingly cheaper.
+ */
+export declare const HEAVY_METADATA_KEYS: readonly ["comments", "notes", "learnings", "files", "tests", "test_runs", "docs"];
 export interface CachedDocumentCandidate {
     metadata: ItemMetadata;
     body?: string;
@@ -12,6 +21,14 @@ export interface ListCacheOptions {
      * the large body cache entirely; only body consumers (search/reindex) pay for it.
      */
     includeBody?: boolean;
+    /**
+     * When false, heavy collection fields (comments/notes/learnings/files/tests/
+     * test_runs/docs) are neither loaded from nor written to the separate collections
+     * cache, and are absent from the returned metadata. Light-only callers (`pm list`
+     * compact, stats, deps, activity, calendar, close) skip the large collections cache
+     * entirely. Defaults to true so any caller that does read those fields stays correct.
+     */
+    includeCollections?: boolean;
 }
 /**
  * List all item documents using a persistent on-disk metadata cache.
@@ -25,3 +42,10 @@ export interface ListCacheOptions {
  */
 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[]>;
+/**
+ * Light variant of {@link listAllDocumentsCached}: returns metadata WITHOUT the heavy
+ * collection fields (comments/notes/learnings/files/tests/test_runs/docs), skipping the
+ * large collections cache entirely. Only safe for callers that read just the light
+ * scalar/small fields (id/title/status/type/priority/parent/tags/dates/dependencies/…).
+ */
+export declare function listAllDocumentsCachedLight(pmRoot: string, preferredFormat: ItemFormat | undefined, typeToFolder: Record<string, string>, warnings: string[] | undefined, schema: RuntimeSchemaSettings | undefined): Promise<ItemDocument[]>;