@unbrained/pm-cli 2026.7.14 → 2026.7.15

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["core/sentry/helpers.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/sentry/helpers\n *\n * Integrates Sentry instrumentation and release diagnostics for Helpers.\n */\nimport { 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 {\n    setAttribute?: (\n      attrKey: string,\n      attrValue: string | number | boolean,\n    ) => void;\n  };\n  if (typeof attributeTarget.setAttribute === \"function\") {\n    attributeTarget.setAttribute(key, value);\n  }\n}\n\nfunction setSentryTagIfPresent(\n  Sentry: NonNullable<ReturnType<typeof getSentry>>,\n  key: string,\n  value: string | undefined,\n): void {\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    Sentry.setTag(key, value);\n  }\n}\n\nfunction setSentryCommandFinishTags(\n  Sentry: NonNullable<ReturnType<typeof getSentry>>,\n  normalizedOk: string,\n  metadata: Parameters<typeof sentryFinishCommandSpan>[2],\n): void {\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  setSentryTagIfPresent(Sentry, \"pm.error_code\", metadata?.error_code);\n  setSentryTagIfPresent(Sentry, \"pm.error_category\", metadata?.error_category);\n  setSentryTagIfPresent(\n    Sentry,\n    \"pm.command_resolution\",\n    metadata?.command_resolution,\n  );\n  setSentryTagIfPresent(\n    Sentry,\n    \"pm.resolution_stage\",\n    metadata?.resolution_stage,\n  );\n}\n\nfunction setCommandSpanFinishAttributes(\n  span: Span,\n  normalizedOk: string,\n  normalizedExitCode: string | undefined,\n  metadata: Parameters<typeof sentryFinishCommandSpan>[2],\n): void {\n  setSpanAttribute(span, \"pm.ok\", normalizedOk);\n  setSpanAttribute(span, \"pm.command_ok\", normalizedOk);\n  setSpanAttribute(span, \"pm.exit_code\", normalizedExitCode);\n  setSpanAttribute(span, \"pm.command_exit_code\", normalizedExitCode);\n  setSpanAttribute(span, \"pm.error_code\", metadata?.error_code);\n  setSpanAttribute(span, \"pm.error_category\", metadata?.error_category);\n  setSpanAttribute(span, \"pm.command_resolution\", metadata?.command_resolution);\n  setSpanAttribute(span, \"pm.resolution_stage\", metadata?.resolution_stage);\n}\n\n/** Implements sentry set command context for the public runtime surface of this module. */\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 (\n    typeof metadata?.source_context === \"string\" &&\n    metadata.source_context.trim().length > 0\n  ) {\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\n/** Implements sentry start command span for the public runtime surface of this module. */\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\n/** Implements sentry finish command span for the public runtime surface of this module. */\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 =\n    typeof metadata?.exit_code === \"number\"\n      ? String(metadata.exit_code)\n      : undefined;\n  const Sentry = getSentry();\n  if (Sentry) {\n    setSentryCommandFinishTags(Sentry, normalizedOk, metadata);\n  }\n  setCommandSpanFinishAttributes(\n    activeCommandSpan,\n    normalizedOk,\n    normalizedExitCode,\n    metadata,\n  );\n  activeCommandSpan.setStatus(\n    ok ? { code: 1 } : { code: 2, message: error ?? \"command_failed\" },\n  );\n  activeCommandSpan.end();\n  activeCommandSpan = undefined;\n}\n\n/** Implements sentry capture cli error for the public runtime surface of this module. */\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 (\n      \"exitCode\" in error &&\n      typeof (error as { exitCode: unknown }).exitCode === \"number\"\n    ) {\n      extras.exit_code = (error as { exitCode: number }).exitCode;\n    }\n    if (\n      \"context\" in error &&\n      typeof (error as { context: unknown }).context === \"object\"\n    ) {\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\n/** Implements sentry log cli usage error for the public runtime surface of this module. */\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 = (\n    Sentry as unknown as {\n      logger?: {\n        warn?: (message: string, attributes?: Record<string, unknown>) => void;\n      };\n    }\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\n/** Implements should capture cli error for the public runtime surface of this module. */\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\n/** Implements sentry flush for the public runtime surface of this module. */\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":"b9353ece-0a99-5a54-85c7-573fc71856ec"}
+{"version":3,"file":"helpers.js","sources":["core/sentry/helpers.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/sentry/helpers\n *\n * Integrates Sentry instrumentation and release diagnostics for Helpers.\n */\nimport { 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 {\n    setAttribute?: (\n      attrKey: string,\n      attrValue: string | number | boolean,\n    ) => void;\n  };\n  if (typeof attributeTarget.setAttribute === \"function\") {\n    attributeTarget.setAttribute(key, value);\n  }\n}\n\nfunction setSentryTagIfPresent(\n  Sentry: NonNullable<ReturnType<typeof getSentry>>,\n  key: string,\n  value: string | undefined,\n): void {\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    Sentry.setTag(key, value);\n  }\n}\n\nfunction setSentryCommandFinishTags(\n  Sentry: NonNullable<ReturnType<typeof getSentry>>,\n  normalizedOk: string,\n  metadata: Parameters<typeof sentryFinishCommandSpan>[2],\n): void {\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  setSentryTagIfPresent(Sentry, \"pm.error_code\", metadata?.error_code);\n  setSentryTagIfPresent(Sentry, \"pm.error_category\", metadata?.error_category);\n  setSentryTagIfPresent(\n    Sentry,\n    \"pm.command_resolution\",\n    metadata?.command_resolution,\n  );\n  setSentryTagIfPresent(\n    Sentry,\n    \"pm.resolution_stage\",\n    metadata?.resolution_stage,\n  );\n}\n\nfunction setCommandSpanFinishAttributes(\n  span: Span,\n  normalizedOk: string,\n  normalizedExitCode: string | undefined,\n  metadata: Parameters<typeof sentryFinishCommandSpan>[2],\n): void {\n  setSpanAttribute(span, \"pm.ok\", normalizedOk);\n  setSpanAttribute(span, \"pm.command_ok\", normalizedOk);\n  setSpanAttribute(span, \"pm.exit_code\", normalizedExitCode);\n  setSpanAttribute(span, \"pm.command_exit_code\", normalizedExitCode);\n  setSpanAttribute(span, \"pm.error_code\", metadata?.error_code);\n  setSpanAttribute(span, \"pm.error_category\", metadata?.error_category);\n  setSpanAttribute(span, \"pm.command_resolution\", metadata?.command_resolution);\n  setSpanAttribute(span, \"pm.resolution_stage\", metadata?.resolution_stage);\n}\n\n/** Implements sentry set command context for the public runtime surface of this module. */\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 (\n    typeof metadata?.source_context === \"string\" &&\n    metadata.source_context.trim().length > 0\n  ) {\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\n/** Implements sentry start command span for the public runtime surface of this module. */\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\n/** Implements sentry finish command span for the public runtime surface of this module. */\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 =\n    typeof metadata?.exit_code === \"number\"\n      ? String(metadata.exit_code)\n      : undefined;\n  const Sentry = getSentry();\n  if (Sentry) {\n    setSentryCommandFinishTags(Sentry, normalizedOk, metadata);\n  }\n  setCommandSpanFinishAttributes(\n    activeCommandSpan,\n    normalizedOk,\n    normalizedExitCode,\n    metadata,\n  );\n  activeCommandSpan.setStatus(\n    ok ? { code: 1 } : { code: 2, message: error ?? \"command_failed\" },\n  );\n  activeCommandSpan.end();\n  activeCommandSpan = undefined;\n}\n\n/** Implements sentry capture cli error for the public runtime surface of this module. */\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 (\n      \"exitCode\" in error &&\n      typeof (error as { exitCode: unknown }).exitCode === \"number\"\n    ) {\n      extras.exit_code = (error as { exitCode: number }).exitCode;\n    }\n    if (\n      \"context\" in error &&\n      typeof (error as { context: unknown }).context === \"object\"\n    ) {\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\n/** Implements sentry log cli usage error for the public runtime surface of this module. */\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 = (\n    Sentry as unknown as {\n      logger?: {\n        warn?: (message: string, attributes?: Record<string, unknown>) => void;\n      };\n    }\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\n/** Implements should capture cli error for the public runtime surface of this module. */\nexport function shouldCaptureCliError(error: unknown): boolean {\n  if (error instanceof PmCliError) {\n    return false;\n  }\n  if (\n    error instanceof Error &&\n    error.name === \"AbortError\" &&\n    /(?:ctrl\\+c|sigint|user[- ]initiated)/i.test(error.message)\n  ) {\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    if (error instanceof Error && error.name === \"CommandError\") {\n      return false;\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\n/** Implements sentry flush for the public runtime surface of this module. */\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":"AAAA;;;;GAIG;;;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAA+B,MAAM,wBAAwB,CAAC;AAChF,OAAO,EACL,gCAAgC,EAChC,8BAA8B,GAG/B,MAAM,+BAA+B,CAAC;AAGvC,IAAI,iBAAmC,CAAC;AAExC,SAAS,gBAAgB,CACvB,IAAU,EACV,GAAW,EACX,KAA4C;IAE5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IACD,MAAM,eAAe,GAAG,IAKvB,CAAC;IACF,IAAI,OAAO,eAAe,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QACvD,eAAe,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAAiD,EACjD,GAAW,EACX,KAAyB;IAEzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CACjC,MAAiD,EACjD,YAAoB,EACpB,QAAuD;IAEvD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACrC,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAC7C,IAAI,OAAO,QAAQ,EAAE,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrE,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC7E,qBAAqB,CACnB,MAAM,EACN,uBAAuB,EACvB,QAAQ,EAAE,kBAAkB,CAC7B,CAAC;IACF,qBAAqB,CACnB,MAAM,EACN,qBAAqB,EACrB,QAAQ,EAAE,gBAAgB,CAC3B,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CACrC,IAAU,EACV,YAAoB,EACpB,kBAAsC,EACtC,QAAuD;IAEvD,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IAC9C,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;IACtD,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAC3D,gBAAgB,CAAC,IAAI,EAAE,sBAAsB,EAAE,kBAAkB,CAAC,CAAC;IACnE,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC9D,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IACtE,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAC9E,gBAAgB,CAAC,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAC5E,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,IAAc,EACd,OAAgC,EAChC,QAGC;IAED,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,QAAQ,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;IAEzD,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC5D,IACE,OAAO,QAAQ,EAAE,cAAc,KAAK,QAAQ;QAC5C,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EACzC,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAChC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAC/C,CAAC;IAEF,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE;QAC9B,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,QAAQ,CAAC,YAAY;QAC3B,IAAI,EAAE,QAAQ,CAAC,YAAY;QAC3B,MAAM,EAAE,QAAQ,CAAC,cAAc;QAC/B,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;QACxC,cAAc,EAAE,QAAQ,EAAE,cAAc;QACxC,qBAAqB,EAAE,QAAQ,EAAE,qBAAqB;KACvD,CAAC,CAAC;IAEH,MAAM,CAAC,aAAa,CAAC;QACnB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,MAAM,OAAO,EAAE;QACxB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,cAAc,EAAE,QAAQ,EAAE,cAAc;SACzC;KACF,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAC3C,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,MAAM,OAAO,EAAE;QACrB,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;AACL,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CACrC,EAAW,EACX,KAAc,EACd,QAMC;IAED,IAAI,CAAC,iBAAiB;QAAE,OAAO;IAC/B,MAAM,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3C,MAAM,kBAAkB,GACtB,OAAO,QAAQ,EAAE,SAAS,KAAK,QAAQ;QACrC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC5B,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,EAAE,CAAC;QACX,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;IACD,8BAA8B,CAC5B,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,QAAQ,CACT,CAAC;IACF,iBAAiB,CAAC,SAAS,CACzB,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,gBAAgB,EAAE,CACnE,CAAC;IACF,iBAAiB,CAAC,GAAG,EAAE,CAAC;IACxB,iBAAiB,GAAG,SAAS,CAAC;AAChC,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC;QAAE,OAAO;IAE1C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,IACE,UAAU,IAAI,KAAK;YACnB,OAAQ,KAA+B,CAAC,QAAQ,KAAK,QAAQ,EAC7D,CAAC;YACD,MAAM,CAAC,SAAS,GAAI,KAA8B,CAAC,QAAQ,CAAC;QAC9D,CAAC;QACD,IACE,SAAS,IAAI,KAAK;YAClB,OAAQ,KAA8B,CAAC,OAAO,KAAK,QAAQ,EAC3D,CAAC;YACD,MAAM,CAAC,aAAa,GAAI,KAA8B,CAAC,OAAO,CAAC;QACjE,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,sBAAsB,CAAC,MAStC;IACC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,yBAAyB,GAC7B,MAAM,CAAC,kBAAkB;QACzB,gCAAgC,CAAC;YAC/B,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,MAAM,CAAC,UAAU;YAC5B,aAAa,EAAE,MAAM,CAAC,cAAc;SACrC,CAAC,CAAC;IACL,MAAM,uBAAuB,GAAG,MAAM,CAAC,gBAAgB,IAAI,SAAS,CAAC;IAErE,MAAM,OAAO,GAAG;QACd,YAAY,EAAE,MAAM,CAAC,OAAO;QAC5B,eAAe,EAAE,MAAM,CAAC,UAAU;QAClC,mBAAmB,EAAE,MAAM,CAAC,cAAc;QAC1C,cAAc,EAAE,MAAM,CAAC,SAAS;QAChC,kBAAkB,EAAE,MAAM,CAAC,aAAa;QACxC,uBAAuB,EAAE,yBAAyB;QAClD,qBAAqB,EAAE,uBAAuB;QAC9C,mBAAmB,EAAE,MAAM,CAAC,cAAc,IAAI,EAAE;KACjD,CAAC;IACF,MAAM,eAAe,GACnB,MAKD,CAAC,MAAM,CAAC;IACT,IAAI,eAAe,IAAI,OAAO,eAAe,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAClE,eAAe,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO;IACT,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,sBAAsB,MAAM,CAAC,UAAU,EAAE,EAAE;QAC/D,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE;YACJ,YAAY,EAAE,MAAM,CAAC,OAAO;YAC5B,eAAe,EAAE,MAAM,CAAC,UAAU;YAClC,mBAAmB,EAAE,MAAM,CAAC,cAAc;YAC1C,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YACxC,uBAAuB,EAAE,yBAAyB;YAClD,qBAAqB,EAAE,uBAAuB;YAC9C,mBAAmB,EAAE,MAAM,CAAC,cAAc,IAAI,SAAS;SACxD;QACD,KAAK,EAAE,OAAO;KACf,CAAC,CAAC;AACL,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IACE,KAAK,YAAY,KAAK;QACtB,KAAK,CAAC,IAAI,KAAK,YAAY;QAC3B,uCAAuC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAC3D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,UAAU,IAAI,KAAK;QACnB,OAAQ,KAAgC,CAAC,QAAQ,KAAK,QAAQ,EAC9D,CAAC;QACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAE,KAA8B,CAAC,QAAQ,CAAC,CAAC;QACtE,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC;YACrD,SAAS,CAAC,OAAO;YACjB,SAAS,CAAC,KAAK;YACf,SAAS,CAAC,SAAS;YACnB,SAAS,CAAC,QAAQ;SACnB,CAAC,CAAC;QACH,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAS,GAAG,IAAI;IAChD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;AACH,CAAC","debugId":"d955a7f2-a85b-5200-8108-58c6684cb23a"}

package/dist/core/shared/command-types.d.ts

@@ -21,6 +21,8 @@ export interface GlobalOptions {
     noPager?: boolean;
     /** Value that configures or reports profile for this contract. */
     profile?: boolean;
+    /** Invocation-wide mutation author override. */
+    author?: string;
     /** Fallback output format used when callers do not provide an override. */
     defaultOutputFormat?: "toon" | "json";
 }

package/dist/core/shared/command-types.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]="1b444f46-acce-55e7-846e-7e7f275e0f97")}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]="72935348-56f4-54f4-85c9-4b88cd66bca9")}catch(e){}}();
 export {};
 //# sourceMappingURL=command-types.js.map
-//# debugId=1b444f46-acce-55e7-846e-7e7f275e0f97
+//# debugId=72935348-56f4-54f4-85c9-4b88cd66bca9

package/dist/core/shared/command-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-types.js","sources":["core/shared/command-types.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/shared/command-types\n *\n * Provides shared primitives and utilities for Command Types.\n */\n/** Carries process-wide CLI options shared by command handlers and runtime adapters. */\nexport interface GlobalOptions {\n  /** Value that configures or reports json for this contract. */\n  json?: boolean;\n  /** Value that configures or reports quiet for this contract. */\n  quiet?: boolean;\n  /** Value that configures or reports no changed fields for this contract. */\n  noChangedFields?: boolean;\n  /** Value that configures or reports id only for this contract. */\n  idOnly?: boolean;\n  /** Filesystem path used for path resolution. */\n  path?: string;\n  /** Value that configures or reports no extensions for this contract. */\n  noExtensions?: boolean;\n  /** Value that configures or reports no pager for this contract. */\n  noPager?: boolean;\n  /** Value that configures or reports profile for this contract. */\n  profile?: boolean;\n  /** Fallback output format used when callers do not provide an override. */\n  defaultOutputFormat?: \"toon\" | \"json\";\n}\n"],"names":[],"mappings":"","debugId":"1b444f46-acce-55e7-846e-7e7f275e0f97"}
+{"version":3,"file":"command-types.js","sources":["core/shared/command-types.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/shared/command-types\n *\n * Provides shared primitives and utilities for Command Types.\n */\n/** Carries process-wide CLI options shared by command handlers and runtime adapters. */\nexport interface GlobalOptions {\n  /** Value that configures or reports json for this contract. */\n  json?: boolean;\n  /** Value that configures or reports quiet for this contract. */\n  quiet?: boolean;\n  /** Value that configures or reports no changed fields for this contract. */\n  noChangedFields?: boolean;\n  /** Value that configures or reports id only for this contract. */\n  idOnly?: boolean;\n  /** Filesystem path used for path resolution. */\n  path?: string;\n  /** Value that configures or reports no extensions for this contract. */\n  noExtensions?: boolean;\n  /** Value that configures or reports no pager for this contract. */\n  noPager?: boolean;\n  /** Value that configures or reports profile for this contract. */\n  profile?: boolean;\n  /** Invocation-wide mutation author override. */\n  author?: string;\n  /** Fallback output format used when callers do not provide an override. */\n  defaultOutputFormat?: \"toon\" | \"json\";\n}\n"],"names":[],"mappings":"","debugId":"72935348-56f4-54f4-85c9-4b88cd66bca9"}

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

@@ -46,6 +46,17 @@ export interface PmCliErrorContext {
     examples?: string[];
     /** Value that configures or reports next steps for this contract. */
     nextSteps?: string[];
+    /** Available history bounds for a failed point-in-time read or restore target. */
+    valid_range?: {
+        /** Earliest available one-based version, or null for an empty stream. */
+        first_version: number | null;
+        /** Latest available one-based version, or null for an empty stream. */
+        last_version: number | null;
+        /** Earliest available history timestamp, or null for an empty stream. */
+        first_timestamp: string | null;
+        /** Latest available history timestamp, or null for an empty stream. */
+        last_timestamp: string | null;
+    };
     /** Value that configures or reports recovery for this contract. */
     recovery?: PmCliErrorRecoveryPayload;
 }

package/dist/core/shared/errors.js

@@ -1,6 +1,6 @@
 /** Implements the exported pm cli error runtime abstraction for core/shared/errors.ts. */
 
-!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]="7d8e4ad4-e69b-5e3b-96fc-fd0dd2e8be73")}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]="c6a1b360-921c-5a84-b085-4c4e772c3b82")}catch(e){}}();
 export class PmCliError extends Error {
     /** Value that configures or reports exit code for this contract. */
     exitCode;
@@ -15,4 +15,4 @@ export class PmCliError extends Error {
     }
 }
 //# sourceMappingURL=errors.js.map
-//# debugId=7d8e4ad4-e69b-5e3b-96fc-fd0dd2e8be73
+//# debugId=c6a1b360-921c-5a84-b085-4c4e772c3b82

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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sources":["core/shared/errors.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/shared/errors\n *\n * Provides shared primitives and utilities for Errors.\n */\n/** Carries structured recovery guidance attached to expected pm CLI errors. */\nexport interface PmCliErrorRecoveryPayload {\n  /** Strategy used to control recovery behavior. */\n  recovery_mode?: \"compact\";\n  /** Value that configures or reports attempted command for this contract. */\n  attempted_command?: string;\n  /** Value that configures or reports normalized args for this contract. */\n  normalized_args?: string[];\n  /** Value that configures or reports provided fields for this contract. */\n  provided_fields?: string[];\n  /** Value that configures or reports missing for this contract. */\n  missing?: string[];\n  /** Value that configures or reports missing required fields for this contract. */\n  missing_required_fields?: string[];\n  /** Value that configures or reports suggested flags for this contract. */\n  suggested_flags?: string[];\n  /** Value that configures or reports suggested retry for this contract. */\n  suggested_retry?: string;\n  /** Elapsed time in milliseconds for retry after. */\n  retry_after_ms?: number;\n  /** Value that configures or reports fallback candidates for this contract. */\n  fallback_candidates?: Array<{\n    source: string;\n    command: string;\n    reason: string;\n  }>;\n  /** Value that configures or reports next best command for this contract. */\n  next_best_command?: string;\n}\n\n/** Documents the pm cli error context payload exchanged by command, SDK, and package integrations. */\nexport interface PmCliErrorContext {\n  /** Value that configures or reports code for this contract. */\n  code?: string;\n  /** Schema type that determines the shape and validation rules for this value. */\n  type?: string;\n  /** Value that configures or reports required for this contract. */\n  required?: string;\n  /** Value that configures or reports why for this contract. */\n  why?: string;\n  /** Value that configures or reports examples for this contract. */\n  examples?: string[];\n  /** Value that configures or reports next steps for this contract. */\n  nextSteps?: string[];\n  /** Value that configures or reports recovery for this contract. */\n  recovery?: PmCliErrorRecoveryPayload;\n}\n\n/** Implements the exported pm cli error runtime abstraction for core/shared/errors.ts. */\nexport class PmCliError extends Error {\n  /** Value that configures or reports exit code for this contract. */\n  public readonly exitCode: number;\n  /** Value that configures or reports context for this contract. */\n  public readonly context: PmCliErrorContext;\n\n  /** Value that configures or reports constructor for this contract. */\n  constructor(\n    message: string,\n    exitCode: number,\n    context: PmCliErrorContext = {},\n  ) {\n    super(message);\n    this.name = \"PmCliError\";\n    this.exitCode = exitCode;\n    this.context = context;\n  }\n}\n"],"names":[],"mappings":"AAqDA,0FAA0F;;;AAC1F,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,oEAAoE;IACpD,QAAQ,CAAS;IACjC,kEAAkE;IAClD,OAAO,CAAoB;IAE3C,sEAAsE;IACtE,YACE,OAAe,EACf,QAAgB,EAChB,UAA6B,EAAE;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF","debugId":"7d8e4ad4-e69b-5e3b-96fc-fd0dd2e8be73"}
+{"version":3,"file":"errors.js","sources":["core/shared/errors.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/shared/errors\n *\n * Provides shared primitives and utilities for Errors.\n */\n/** Carries structured recovery guidance attached to expected pm CLI errors. */\nexport interface PmCliErrorRecoveryPayload {\n  /** Strategy used to control recovery behavior. */\n  recovery_mode?: \"compact\";\n  /** Value that configures or reports attempted command for this contract. */\n  attempted_command?: string;\n  /** Value that configures or reports normalized args for this contract. */\n  normalized_args?: string[];\n  /** Value that configures or reports provided fields for this contract. */\n  provided_fields?: string[];\n  /** Value that configures or reports missing for this contract. */\n  missing?: string[];\n  /** Value that configures or reports missing required fields for this contract. */\n  missing_required_fields?: string[];\n  /** Value that configures or reports suggested flags for this contract. */\n  suggested_flags?: string[];\n  /** Value that configures or reports suggested retry for this contract. */\n  suggested_retry?: string;\n  /** Elapsed time in milliseconds for retry after. */\n  retry_after_ms?: number;\n  /** Value that configures or reports fallback candidates for this contract. */\n  fallback_candidates?: Array<{\n    source: string;\n    command: string;\n    reason: string;\n  }>;\n  /** Value that configures or reports next best command for this contract. */\n  next_best_command?: string;\n}\n\n/** Documents the pm cli error context payload exchanged by command, SDK, and package integrations. */\nexport interface PmCliErrorContext {\n  /** Value that configures or reports code for this contract. */\n  code?: string;\n  /** Schema type that determines the shape and validation rules for this value. */\n  type?: string;\n  /** Value that configures or reports required for this contract. */\n  required?: string;\n  /** Value that configures or reports why for this contract. */\n  why?: string;\n  /** Value that configures or reports examples for this contract. */\n  examples?: string[];\n  /** Value that configures or reports next steps for this contract. */\n  nextSteps?: string[];\n  /** Available history bounds for a failed point-in-time read or restore target. */\n  valid_range?: {\n    /** Earliest available one-based version, or null for an empty stream. */\n    first_version: number | null;\n    /** Latest available one-based version, or null for an empty stream. */\n    last_version: number | null;\n    /** Earliest available history timestamp, or null for an empty stream. */\n    first_timestamp: string | null;\n    /** Latest available history timestamp, or null for an empty stream. */\n    last_timestamp: string | null;\n  };\n  /** Value that configures or reports recovery for this contract. */\n  recovery?: PmCliErrorRecoveryPayload;\n}\n\n/** Implements the exported pm cli error runtime abstraction for core/shared/errors.ts. */\nexport class PmCliError extends Error {\n  /** Value that configures or reports exit code for this contract. */\n  public readonly exitCode: number;\n  /** Value that configures or reports context for this contract. */\n  public readonly context: PmCliErrorContext;\n\n  /** Value that configures or reports constructor for this contract. */\n  constructor(\n    message: string,\n    exitCode: number,\n    context: PmCliErrorContext = {},\n  ) {\n    super(message);\n    this.name = \"PmCliError\";\n    this.exitCode = exitCode;\n    this.context = context;\n  }\n}\n"],"names":[],"mappings":"AAgEA,0FAA0F;;;AAC1F,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,oEAAoE;IACpD,QAAQ,CAAS;IACjC,kEAAkE;IAClD,OAAO,CAAoB;IAE3C,sEAAsE;IACtE,YACE,OAAe,EACf,QAAgB,EAChB,UAA6B,EAAE;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF","debugId":"c6a1b360-921c-5a84-b085-4c4e772c3b82"}

package/dist/mcp/server.d.ts

@@ -33,8 +33,8 @@ export declare const _testOnly: {
     readonly normalizeMcpUpdateOptions: (options: Record<string, unknown>) => Record<string, unknown>;
     readonly optionsWithAuthor: (args: Record<string, unknown>, action?: string) => Record<string, unknown>;
     readonly readRequiredString: typeof readRequiredString;
-    readonly readScalarString: (args: Record<string, unknown>, key: string) => string | undefined;
-    readonly readScalarStringAllowBlank: (args: Record<string, unknown>, key: string) => string | undefined;
+    readonly readScalarString: typeof import("../sdk/runtime-input.js").readRuntimeScalarString;
+    readonly readScalarStringAllowBlank: typeof import("../sdk/runtime-input.js").readRuntimeScalarStringAllowBlank;
     readonly readStringArray: (value: unknown) => string[];
     runAction: typeof runAction;
     readonly updateManyOptionsFromFlat: (options: Record<string, unknown>) => import("../cli/commands/update-many.js").UpdateManyCommandOptions;

package/dist/mcp/tool-definitions.js

@@ -4,7 +4,7 @@
  * Defines the Tool Definitions module for pm CLI source.
  */
 
-!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]="7365c8ff-f8c3-535e-ac57-f580b9d0e159")}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]="478bf194-a9d0-5c6a-b70e-d15164927fda")}catch(e){}}();
 import { PM_TOOL_ACTIONS } from "../sdk/cli-contracts/enum-contracts.js";
 import { COPY_FLAG_CONTRACTS } from "../sdk/cli-contracts/flag-contracts.js";
 import { RUNTIME_STATUS_ROLE_VALUES } from "../types.js";
@@ -167,12 +167,12 @@ export const TOOLS = [
     },
     {
         name: "pm_get",
-        description: "Read one pm item. Pass options.depth='brief' or options.fields='id,title,status' for low-token inspection.",
+        description: "Read one pm item with shared SDK projections. Pass options.depth='brief' or options.fields='id,title,status' for low-token inspection, options.fields='id,schedule.start_at' for schedule context, or options.at='7' / an ISO timestamp for a verified mutation-free historical read. Parent results include bounded child counts, samples, and continuation metadata.",
         inputSchema: objectSchema({
             id: idSchema,
             options: {
                 type: "object",
-                description: "Get options such as depth=brief|standard|deep|full or fields=id,title,status.",
+                description: "Get options such as depth=brief|standard|deep|full, fields=id,title,status, or at=<version|ISO timestamp>.",
             },
         }, ["id"]),
     },
@@ -336,7 +336,7 @@ export const TOOLS = [
     },
     {
         name: "pm_deps",
-        description: "List, add, or remove dependencies for a pm item. Use options.add to declare a dependency and options.remove to drop one; omit both to list current dependencies.",
+        description: "Read dependency trees/graphs or one bounded explainable relationship context packet. Use options.format=context with depth, node, edge, token, and cursor bounds.",
         inputSchema: objectSchema({ id: idSchema, options: { type: "object" } }, [
             "id",
         ]),
@@ -571,4 +571,4 @@ export function buildMcpToolContracts() {
     }).sort((left, right) => left.name.localeCompare(right.name));
 }
 //# sourceMappingURL=tool-definitions.js.map
-//# debugId=7365c8ff-f8c3-535e-ac57-f580b9d0e159
+//# debugId=478bf194-a9d0-5c6a-b70e-d15164927fda

package/dist/mcp/tool-definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-definitions.js","sources":["mcp/tool-definitions.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module mcp/tool-definitions\n *\n * Defines the Tool Definitions module for pm CLI source.\n */\nimport { PM_TOOL_ACTIONS } from \"../sdk/cli-contracts/enum-contracts.js\";\nimport { COPY_FLAG_CONTRACTS } from \"../sdk/cli-contracts/flag-contracts.js\";\nimport { RUNTIME_STATUS_ROLE_VALUES } from \"../types.js\";\n\n/**\n * Static MCP tool surface for the pm MCP server.\n *\n * Kept as a dependency-light data module (only the enum contract import) so the\n * `pm contracts` command can snapshot the tool surface into the contract\n * golden file (pm-4os2) without importing the full MCP server runtime, and so\n * the server itself stays the single consumer of the dispatch handlers.\n */\nexport interface ToolDefinition {\n  /** Value that configures or reports name for this contract. */\n  name: string;\n  /** Value that configures or reports description for this contract. */\n  description: string;\n  /** Value that configures or reports input schema for this contract. */\n  inputSchema: Record<string, unknown>;\n}\n\nconst TOOL_SCHEMA_BASE = {\n  type: \"object\",\n  properties: {\n    cwd: {\n      type: \"string\",\n      description:\n        \"Workspace directory to run the native pm operation in. Defaults to the MCP server process cwd.\",\n    },\n    path: {\n      type: \"string\",\n      description:\n        \"Optional pm data root, equivalent to PM_PATH/global --path. Leave unset for real repository tracking.\",\n    },\n    author: {\n      type: \"string\",\n      description:\n        \"Mutation author. Defaults to PM_AUTHOR or pm settings when supported by the underlying operation.\",\n    },\n  },\n  additionalProperties: true,\n} as const;\n\nconst idSchema = {\n  type: \"string\",\n  description: \"pm item id, for example pm-abc1.\",\n};\n\n// pm-fd8n: derive the pm_run action enumeration from the canonical\n// PM_TOOL_ACTIONS contract instead of a hand-maintained prose list, so the\n// MCP-facing description can never drift from the actual supported actions.\nconst PM_RUN_ACTION_DESCRIPTION =\n  `Operation name (one of): ${PM_TOOL_ACTIONS.join(\", \")}. ` +\n  \"Package-owned actions are available dynamically when their provider package is installed.\";\n\nconst LIST_TOP_LEVEL_OPTION_PROPERTIES: Record<string, unknown> = {\n  status: { type: \"string\", description: \"Alias for options.status.\" },\n  type: { type: \"string\", description: \"Alias for options.type.\" },\n  tag: { type: \"string\", description: \"Alias for options.tag.\" },\n  priority: { type: \"string\", description: \"Alias for options.priority.\" },\n  limit: {\n    type: [\"string\", \"number\"],\n    description: \"Alias for options.limit.\",\n  },\n  offset: {\n    type: [\"string\", \"number\"],\n    description: \"Alias for options.offset.\",\n  },\n};\n\nconst SEARCH_TOP_LEVEL_OPTION_PROPERTIES: Record<string, unknown> = {\n  mode: { type: \"string\", description: \"Alias for options.mode.\" },\n  status: { type: \"string\", description: \"Alias for options.status.\" },\n  type: { type: \"string\", description: \"Alias for options.type.\" },\n  tag: { type: \"string\", description: \"Alias for options.tag.\" },\n  priority: { type: \"string\", description: \"Alias for options.priority.\" },\n  limit: {\n    type: [\"string\", \"number\"],\n    description: \"Alias for options.limit.\",\n  },\n};\n\nconst COPY_TOP_LEVEL_OPTION_PROPERTIES: Record<string, unknown> = Object.fromEntries(\n  COPY_FLAG_CONTRACTS.filter(({ flag }) => flag !== \"--author\").map(({ flag }) => [\n    flag.slice(2),\n    { type: \"string\", description: `Alias for options.${flag.slice(2).replaceAll(\"-\", \"_\")}.` },\n  ]),\n);\n\nfunction objectSchema(\n  properties: Record<string, unknown>,\n  required: string[] = [],\n): Record<string, unknown> {\n  return {\n    ...TOOL_SCHEMA_BASE,\n    properties: {\n      ...TOOL_SCHEMA_BASE.properties,\n      ...properties,\n    },\n    required,\n  };\n}\n\n/** Public contract for tools, shared by SDK and presentation-layer consumers. */\nexport const TOOLS: ToolDefinition[] = [\n  {\n    name: \"pm_run\",\n    description:\n      \"Run any supported pm operation natively through the pm library. Use this for commands not covered by narrower pm_* tools.\",\n    inputSchema: objectSchema(\n      {\n        action: {\n          type: \"string\",\n          description: PM_RUN_ACTION_DESCRIPTION,\n        },\n        id: idSchema,\n        query: {\n          type: \"string\",\n          description: \"Search query for action=search.\",\n        },\n        reason: {\n          type: \"string\",\n          description: \"Close reason for action=close.\",\n        },\n        force: {\n          type: \"boolean\",\n          description:\n            \"Force ownership/terminal-state override when supported.\",\n        },\n        // pm-v68d: the schema-specific subcommand enum and add-type/add-status\n        // properties migrated to the dedicated pm_schema tool. action=schema\n        // still accepts them as passthrough, but agents should prefer pm_schema.\n        subcommand: {\n          type: \"string\",\n          description:\n            \"Subcommand selector for actions that take one (for example telemetry, or schema — prefer the dedicated pm_schema tool for schema operations).\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Underlying pm command options using camelCase keys.\",\n        },\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"For mutation actions, return the full changed_fields array instead of the default changed_field_count.\",\n        },\n        idOnly: {\n          type: \"boolean\",\n          description:\n            \"For single-item mutation actions, return only id and status.\",\n        },\n      },\n      [\"action\"],\n    ),\n  },\n  {\n    name: \"pm_context\",\n    description:\n      \"Return the agent-oriented project context snapshot. \" +\n      \"Pass options.depth=brief|standard|deep|full (full = every section with no per-section row cap), \" +\n      \"options.parent='<id>' to scope the snapshot to one item's subtree (the item plus all descendants), \" +\n      \"options.fields='id,title,priority' to project focus rows to a field subset for low-token reads, \" +\n      \"or options.section=['hierarchy','progress',...] to pick sections.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_next\",\n    description:\n      \"Recommend the next actionable work item: the single highest-priority READY item \" +\n      \"(active status, no open blockers, no open children; completed containers surface only when no concrete leaf work is ready) plus the ranked ready and blocked queues. \" +\n      \"The recommended item carries a rationale and each blocked item lists the open blockers gating it. \" +\n      \"Pass options.parent='<id>' to scope to one subtree, options.limit=N to cap ready rows, \" +\n      \"options.readyOnly=true to omit the blocked list, or filters (options.type/tag/priority/assignee/sprint/release). \" +\n      \"The most token-efficient 'what should I do now?' read for agents.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_search\",\n    description:\n      \"Search pm items with keyword, semantic, or hybrid search. \" +\n      \"Defaults to a compact projection for token efficiency. \" +\n      \"Pass options.mode=keyword|semantic|hybrid, options.limit=N to cap hits, \" +\n      \"options.status='all' for no lifecycle restriction, \" +\n      \"options.fields='id,title,score' for a custom projection, or options.full=true for full item bodies (can be large). \" +\n      \"The result echoes the applied filters and projection mode in query_summary.\",\n    inputSchema: objectSchema(\n      {\n        query: { type: \"string\" },\n        options: { type: \"object\" },\n        ...SEARCH_TOP_LEVEL_OPTION_PROPERTIES,\n      },\n      [\"query\"],\n    ),\n  },\n  {\n    name: \"pm_list\",\n    description:\n      \"List pm items with status/type/tag/priority filters. Defaults to compact projection for token efficiency. \" +\n      \"options.status accepts CSV (all,open,in_progress). \" +\n      \"Pass options.compact=false or options.includeBody=true for full bodies/comments. \" +\n      \"Pass options.brief=true for ultra-terse (id/status/type/title only). \" +\n      \"Pass options.fields='id,title,priority' for custom projection. \" +\n      \"Pass options.limit=N to cap row count. \" +\n      \"The result echoes the applied filters and projection mode in query_summary.\",\n    inputSchema: objectSchema({\n      options: { type: \"object\" },\n      ...LIST_TOP_LEVEL_OPTION_PROPERTIES,\n    }),\n  },\n  {\n    name: \"pm_get\",\n    description:\n      \"Read one pm item. Pass options.depth='brief' or options.fields='id,title,status' for low-token inspection.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        options: {\n          type: \"object\",\n          description:\n            \"Get options such as depth=brief|standard|deep|full or fields=id,title,status.\",\n        },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_create\",\n    description:\n      \"Create a pm item natively and write pm history. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count for token efficiency); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"Return full changed_fields instead of changed_field_count.\",\n        },\n        allowMissingParent: {\n          type: \"boolean\",\n          description:\n            \"Allow unresolved parent references and emit a validation warning.\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Create options. title and description are required.\",\n        },\n      },\n      [\"options\"],\n    ),\n  },\n  {\n    name: \"pm_copy\",\n    description:\n      \"Copy an existing pm item into a new id while resetting lifecycle fields. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        ...COPY_TOP_LEVEL_OPTION_PROPERTIES,\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"Return full changed_fields instead of changed_field_count.\",\n        },\n        idOnly: {\n          type: \"boolean\",\n          description: \"Return only id and status.\",\n        },\n        options: {\n          type: \"object\",\n          description:\n            \"Copy options such as title override, author, and message.\",\n        },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_focus\",\n    description:\n      \"Set, clear, or show the session focused item. When focused, pm_create defaults its parent to the focused item \" +\n      \"(an explicit parent still overrides). Pass id to focus an item, options.clear=true to clear, or neither to show current focus.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        clear: {\n          type: \"boolean\",\n          description: \"Clear the focused item (cannot be combined with id).\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Focus options such as clear (boolean).\",\n        },\n      },\n      [],\n    ),\n  },\n  {\n    name: \"pm_update\",\n    description:\n      \"Update pm item metadata/body/dependencies/log seeds natively. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields delta.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"Return full changed_fields instead of changed_field_count.\",\n        },\n        options: { type: \"object\" },\n      },\n      [\"id\", \"options\"],\n    ),\n  },\n  {\n    name: \"pm_append\",\n    description:\n      \"Append markdown text to a pm item body and write pm history. Useful for seeding evidence/log entries before close. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        body: {\n          type: \"string\",\n          description:\n            \"Markdown text to append to the item body. Required here or as options.body.\",\n        },\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"Return full changed_fields instead of changed_field_count.\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Append options such as body, author, and message.\",\n        },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_claim\",\n    description: \"Claim a pm item.\",\n    inputSchema: objectSchema(\n      { id: idSchema, force: { type: \"boolean\" }, options: { type: \"object\" } },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_release\",\n    description: \"Release a pm item claim.\",\n    inputSchema: objectSchema(\n      { id: idSchema, force: { type: \"boolean\" }, options: { type: \"object\" } },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_close\",\n    description:\n      \"Close a pm item with optional close reason and optional close validation (reason requirement follows governance settings). \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        reason: {\n          type: \"string\",\n          description:\n            \"Close reason text when provided or required by governance settings.\",\n        },\n        duplicateOf: {\n          type: \"string\",\n          description:\n            \"Canonical item id when closing this item as a duplicate.\",\n        },\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"Return full changed_fields instead of changed_field_count.\",\n        },\n        idOnly: { type: \"boolean\", description: \"Return only id and status.\" },\n        options: { type: \"object\" },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_comments\",\n    description:\n      \"List, add, edit, or delete comments on a pm item. Use options.add to append, options.edit=<1-based index> with replacement text to fix a comment, or options.delete=<1-based index> to remove one. \" +\n      \"List calls default to the most recent 20 comments with total_count/has_more metadata for token efficiency. \" +\n      \"Pass options.limit=N to choose a page size, options.limit=0 for summary-only metadata, or options.full=true for full history.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_files\",\n    description:\n      \"List, add, remove, or validate linked files for a pm item.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_docs\",\n    description: \"List, add, or remove linked docs for a pm item.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_notes\",\n    description:\n      \"List or add structured notes on a pm item. Use options.add to append a note; omit it to list existing notes.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_learnings\",\n    description:\n      \"List or add learnings on a pm item. Use options.add to capture a learning/insight; omit it to list existing learnings.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_deps\",\n    description:\n      \"List, add, or remove dependencies for a pm item. Use options.add to declare a dependency and options.remove to drop one; omit both to list current dependencies.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_test\",\n    description: \"List, add, remove, or run linked tests for a pm item.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_validate\",\n    description: \"Run pm validation checks.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_health\",\n    description:\n      \"Run pm health diagnostics. Pass options.brief=true for compact low-token details, options.skipIntegrity=true, options.skipDrift=true, options.skipVectors=true for a fast status-only check, or options.full=true for the complete deep check.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_contracts\",\n    description:\n      \"Inspect pm command, flag, schema, and availability contracts.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_schema\",\n    description:\n      \"Inspect or modify the workspace item-type/status/field schema (pm schema). \" +\n      \"subcommand selects the operation; name carries the item type name (show/add-type/remove-type), status id (show-status/add-status/remove-status), or field key (show-field/add-field/remove-field). \" +\n      \"apply-preset adopts a domain type preset; add-type with infer=true derives types from title-prefix conventions. \" +\n      \"Schema mutations write workspace config files, not item history.\",\n    inputSchema: objectSchema(\n      {\n        subcommand: {\n          type: \"string\",\n          enum: [\n            \"list\",\n            \"show\",\n            \"show-status\",\n            \"add-type\",\n            \"remove-type\",\n            \"add-status\",\n            \"remove-status\",\n            \"add-field\",\n            \"remove-field\",\n            \"list-fields\",\n            \"show-field\",\n            \"apply-preset\",\n          ],\n          description: \"Schema subcommand to run.\",\n        },\n        name: {\n          type: \"string\",\n          description:\n            \"Item type name (show/add-type/remove-type), status id (show-status/add-status/remove-status), or custom field key (show-field/add-field/remove-field). Required for those subcommands.\",\n        },\n        description: {\n          type: \"string\",\n          description:\n            \"Custom item type, status, or field description for add-type/add-status/add-field.\",\n        },\n        defaultStatus: {\n          type: \"string\",\n          description: \"Default status for add-type.\",\n        },\n        folder: { type: \"string\", description: \"Storage folder for add-type.\" },\n        alias: {\n          type: \"array\",\n          items: { type: \"string\" },\n          description:\n            \"Aliases for add-type/add-status, or extra CLI flag aliases for add-field.\",\n        },\n        role: {\n          type: \"array\",\n          items: { type: \"string\", enum: [...RUNTIME_STATUS_ROLE_VALUES] },\n          description: `Lifecycle roles for add-status: ${RUNTIME_STATUS_ROLE_VALUES.join(\", \")}.`,\n        },\n        order: {\n          type: \"number\",\n          description: \"Display/sort order for add-status.\",\n        },\n        fieldType: {\n          type: \"string\",\n          enum: [\"string\", \"number\", \"boolean\", \"string_array\"],\n          description: \"Value type for a custom field (add-field).\",\n        },\n        commands: {\n          type: \"array\",\n          items: { type: \"string\" },\n          description:\n            \"Commands a custom field is wired onto (add-field): create, update, update_many, list, search, calendar, context.\",\n        },\n        cliFlag: {\n          type: \"string\",\n          description:\n            \"Override the auto-derived CLI flag for a custom field (add-field).\",\n        },\n        required: {\n          type: \"boolean\",\n          description: \"Mark a custom field as always required (add-field).\",\n        },\n        requiredOnCreate: {\n          type: \"boolean\",\n          description:\n            \"Mark a custom field as required at create time (add-field).\",\n        },\n        allowUnset: {\n          type: \"boolean\",\n          description:\n            \"Whether a custom field may be cleared via --unset (add-field); defaults to true.\",\n        },\n        requiredTypes: {\n          type: \"array\",\n          items: { type: \"string\" },\n          description:\n            \"Restrict a custom field's requirement to specific item types (add-field).\",\n        },\n        typePreset: {\n          type: \"string\",\n          enum: [\"agile\", \"ops\", \"research\"],\n          description: \"Domain type preset to adopt (apply-preset).\",\n        },\n        infer: {\n          type: \"boolean\",\n          description:\n            \"Infer item types from title-prefix conventions (add-type); previews unless apply is true.\",\n        },\n        minCount: {\n          type: \"number\",\n          description:\n            \"Minimum items sharing a prefix for add-type inference (default 10).\",\n        },\n        apply: {\n          type: \"boolean\",\n          description:\n            \"Register inferred types (add-type infer); without it the call previews only.\",\n        },\n        force: {\n          type: \"boolean\",\n          description:\n            \"Override removal guardrails for destructive schema changes when supported.\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Additional schema options using camelCase keys.\",\n        },\n      },\n      [\"subcommand\"],\n    ),\n  },\n  {\n    name: \"pm_profile\",\n    description:\n      \"List, show, apply, or lint project profiles (pm profile) — archetype bundles that stage item types, statuses, fields, per-type workflows, config knobs, create templates, and recommended packages. \" +\n      \"subcommand selects the operation; name carries the profile name (agile, ops, research) for show/apply/lint. \" +\n      \"apply stages every dimension idempotently; dryRun previews the diff without writing; lint reports author-time consistency findings (graded error/warning) without touching the tracker. Profile staging writes workspace config/schema files, not item history.\",\n    inputSchema: objectSchema(\n      {\n        subcommand: {\n          type: \"string\",\n          enum: [\"list\", \"show\", \"apply\", \"lint\"],\n          description: \"Profile subcommand to run.\",\n        },\n        name: {\n          type: \"string\",\n          description:\n            \"Profile name for show/apply/lint. Required for those subcommands. Built-ins are agile, ops, and research; an active extension can contribute additional archetype names that resolve here too.\",\n        },\n        dryRun: {\n          type: \"boolean\",\n          description:\n            \"Preview the apply diff without writing any files (apply).\",\n        },\n        author: { type: \"string\", description: \"Mutation author for apply.\" },\n        force: {\n          type: \"boolean\",\n          description: \"Force ownership/lock override for apply.\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Additional profile options using camelCase keys.\",\n        },\n      },\n      [\"subcommand\"],\n    ),\n  },\n  {\n    name: \"pm_config\",\n    description:\n      \"Read or write pm workspace configuration (pm config). \" +\n      \"configAction selects get/set/list/export; key/value address a single setting for get/set. \" +\n      \"scope chooses the project (default) or global settings file.\",\n    inputSchema: objectSchema(\n      {\n        configAction: {\n          type: \"string\",\n          enum: [\"get\", \"set\", \"list\", \"export\"],\n          description:\n            \"Config operation to perform. get/set require key; list/export dump the resolved settings surface.\",\n        },\n        key: {\n          type: \"string\",\n          description:\n            \"Settings key for get/set, for example governance-require-close-reason, telemetry-tracking, or a nested leaf such as search_provider (dash and underscore variants accepted; configAction=get without a key lists supported keys in the error).\",\n        },\n        value: {\n          type: \"string\",\n          description: \"New value for configAction=set.\",\n        },\n        scope: {\n          type: \"string\",\n          enum: [\"project\", \"global\"],\n          description: \"Settings scope to read or write. Defaults to project.\",\n        },\n        options: {\n          type: \"object\",\n          description:\n            \"Additional config options such as criterion, clearCriteria, format, or policy.\",\n        },\n      },\n      [\"configAction\"],\n    ),\n  },\n  {\n    name: \"pm_plan\",\n    description:\n      \"Run agent-optimized Plan workflows. options.subcommand selects: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize. Provide id for all non-create subcommands; provide stepRef for step lifecycle subcommands. Plans store agent-readable steps with dependencies, decisions, discoveries, validation, and resume context.\",\n    inputSchema: objectSchema({\n      id: {\n        type: \"string\",\n        description: \"Plan id (required for all subcommands except create).\",\n      },\n      stepRef: {\n        type: \"string\",\n        description: \"Step id or order for step lifecycle subcommands.\",\n      },\n      reorderTo: { type: \"number\", description: \"New order for reorder-step.\" },\n      options: {\n        type: \"object\",\n        description:\n          \"Plan options including subcommand, stepRef, stepStatus, link, depth, etc.\",\n      },\n    }),\n  },\n];\n\n/** Stable projection of one MCP tool definition for the contract golden file (pm-4os2): tool name, description, required top-level fields, and the full inputSchema shape. Any drift (typo'd property, dropped required field, changed TOOL_SCHEMA_BASE) shows up in `pnpm contracts:check`. */\nexport interface McpToolContract {\n  /** Value that configures or reports name for this contract. */\n  name: string;\n  /** Value that configures or reports description for this contract. */\n  description: string;\n  /** Value that configures or reports required for this contract. */\n  required: string[];\n  /** Value that configures or reports input schema for this contract. */\n  input_schema: Record<string, unknown>;\n}\n\n/** Implements build mcp tool contracts for the public runtime surface of this module. */\nexport function buildMcpToolContracts(): McpToolContract[] {\n  return TOOLS.map((tool) => {\n    const schemaRequired = tool.inputSchema[\"required\"];\n    const required = Array.isArray(schemaRequired)\n      ? schemaRequired\n          .map((entry) => String(entry))\n          .sort((left, right) => left.localeCompare(right))\n      : [];\n    return {\n      name: tool.name,\n      description: tool.description,\n      required,\n      input_schema: tool.inputSchema,\n    };\n  }).sort((left, right) => left.name.localeCompare(right.name));\n}\n"],"names":[],"mappings":"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","debugId":"7365c8ff-f8c3-535e-ac57-f580b9d0e159"}
+{"version":3,"file":"tool-definitions.js","sources":["mcp/tool-definitions.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module mcp/tool-definitions\n *\n * Defines the Tool Definitions module for pm CLI source.\n */\nimport { PM_TOOL_ACTIONS } from \"../sdk/cli-contracts/enum-contracts.js\";\nimport { COPY_FLAG_CONTRACTS } from \"../sdk/cli-contracts/flag-contracts.js\";\nimport { RUNTIME_STATUS_ROLE_VALUES } from \"../types.js\";\n\n/**\n * Static MCP tool surface for the pm MCP server.\n *\n * Kept as a dependency-light data module (only the enum contract import) so the\n * `pm contracts` command can snapshot the tool surface into the contract\n * golden file (pm-4os2) without importing the full MCP server runtime, and so\n * the server itself stays the single consumer of the dispatch handlers.\n */\nexport interface ToolDefinition {\n  /** Value that configures or reports name for this contract. */\n  name: string;\n  /** Value that configures or reports description for this contract. */\n  description: string;\n  /** Value that configures or reports input schema for this contract. */\n  inputSchema: Record<string, unknown>;\n}\n\nconst TOOL_SCHEMA_BASE = {\n  type: \"object\",\n  properties: {\n    cwd: {\n      type: \"string\",\n      description:\n        \"Workspace directory to run the native pm operation in. Defaults to the MCP server process cwd.\",\n    },\n    path: {\n      type: \"string\",\n      description:\n        \"Optional pm data root, equivalent to PM_PATH/global --path. Leave unset for real repository tracking.\",\n    },\n    author: {\n      type: \"string\",\n      description:\n        \"Mutation author. Defaults to PM_AUTHOR or pm settings when supported by the underlying operation.\",\n    },\n  },\n  additionalProperties: true,\n} as const;\n\nconst idSchema = {\n  type: \"string\",\n  description: \"pm item id, for example pm-abc1.\",\n};\n\n// pm-fd8n: derive the pm_run action enumeration from the canonical\n// PM_TOOL_ACTIONS contract instead of a hand-maintained prose list, so the\n// MCP-facing description can never drift from the actual supported actions.\nconst PM_RUN_ACTION_DESCRIPTION =\n  `Operation name (one of): ${PM_TOOL_ACTIONS.join(\", \")}. ` +\n  \"Package-owned actions are available dynamically when their provider package is installed.\";\n\nconst LIST_TOP_LEVEL_OPTION_PROPERTIES: Record<string, unknown> = {\n  status: { type: \"string\", description: \"Alias for options.status.\" },\n  type: { type: \"string\", description: \"Alias for options.type.\" },\n  tag: { type: \"string\", description: \"Alias for options.tag.\" },\n  priority: { type: \"string\", description: \"Alias for options.priority.\" },\n  limit: {\n    type: [\"string\", \"number\"],\n    description: \"Alias for options.limit.\",\n  },\n  offset: {\n    type: [\"string\", \"number\"],\n    description: \"Alias for options.offset.\",\n  },\n};\n\nconst SEARCH_TOP_LEVEL_OPTION_PROPERTIES: Record<string, unknown> = {\n  mode: { type: \"string\", description: \"Alias for options.mode.\" },\n  status: { type: \"string\", description: \"Alias for options.status.\" },\n  type: { type: \"string\", description: \"Alias for options.type.\" },\n  tag: { type: \"string\", description: \"Alias for options.tag.\" },\n  priority: { type: \"string\", description: \"Alias for options.priority.\" },\n  limit: {\n    type: [\"string\", \"number\"],\n    description: \"Alias for options.limit.\",\n  },\n};\n\nconst COPY_TOP_LEVEL_OPTION_PROPERTIES: Record<string, unknown> = Object.fromEntries(\n  COPY_FLAG_CONTRACTS.filter(({ flag }) => flag !== \"--author\").map(({ flag }) => [\n    flag.slice(2),\n    { type: \"string\", description: `Alias for options.${flag.slice(2).replaceAll(\"-\", \"_\")}.` },\n  ]),\n);\n\nfunction objectSchema(\n  properties: Record<string, unknown>,\n  required: string[] = [],\n): Record<string, unknown> {\n  return {\n    ...TOOL_SCHEMA_BASE,\n    properties: {\n      ...TOOL_SCHEMA_BASE.properties,\n      ...properties,\n    },\n    required,\n  };\n}\n\n/** Public contract for tools, shared by SDK and presentation-layer consumers. */\nexport const TOOLS: ToolDefinition[] = [\n  {\n    name: \"pm_run\",\n    description:\n      \"Run any supported pm operation natively through the pm library. Use this for commands not covered by narrower pm_* tools.\",\n    inputSchema: objectSchema(\n      {\n        action: {\n          type: \"string\",\n          description: PM_RUN_ACTION_DESCRIPTION,\n        },\n        id: idSchema,\n        query: {\n          type: \"string\",\n          description: \"Search query for action=search.\",\n        },\n        reason: {\n          type: \"string\",\n          description: \"Close reason for action=close.\",\n        },\n        force: {\n          type: \"boolean\",\n          description:\n            \"Force ownership/terminal-state override when supported.\",\n        },\n        // pm-v68d: the schema-specific subcommand enum and add-type/add-status\n        // properties migrated to the dedicated pm_schema tool. action=schema\n        // still accepts them as passthrough, but agents should prefer pm_schema.\n        subcommand: {\n          type: \"string\",\n          description:\n            \"Subcommand selector for actions that take one (for example telemetry, or schema — prefer the dedicated pm_schema tool for schema operations).\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Underlying pm command options using camelCase keys.\",\n        },\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"For mutation actions, return the full changed_fields array instead of the default changed_field_count.\",\n        },\n        idOnly: {\n          type: \"boolean\",\n          description:\n            \"For single-item mutation actions, return only id and status.\",\n        },\n      },\n      [\"action\"],\n    ),\n  },\n  {\n    name: \"pm_context\",\n    description:\n      \"Return the agent-oriented project context snapshot. \" +\n      \"Pass options.depth=brief|standard|deep|full (full = every section with no per-section row cap), \" +\n      \"options.parent='<id>' to scope the snapshot to one item's subtree (the item plus all descendants), \" +\n      \"options.fields='id,title,priority' to project focus rows to a field subset for low-token reads, \" +\n      \"or options.section=['hierarchy','progress',...] to pick sections.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_next\",\n    description:\n      \"Recommend the next actionable work item: the single highest-priority READY item \" +\n      \"(active status, no open blockers, no open children; completed containers surface only when no concrete leaf work is ready) plus the ranked ready and blocked queues. \" +\n      \"The recommended item carries a rationale and each blocked item lists the open blockers gating it. \" +\n      \"Pass options.parent='<id>' to scope to one subtree, options.limit=N to cap ready rows, \" +\n      \"options.readyOnly=true to omit the blocked list, or filters (options.type/tag/priority/assignee/sprint/release). \" +\n      \"The most token-efficient 'what should I do now?' read for agents.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_search\",\n    description:\n      \"Search pm items with keyword, semantic, or hybrid search. \" +\n      \"Defaults to a compact projection for token efficiency. \" +\n      \"Pass options.mode=keyword|semantic|hybrid, options.limit=N to cap hits, \" +\n      \"options.status='all' for no lifecycle restriction, \" +\n      \"options.fields='id,title,score' for a custom projection, or options.full=true for full item bodies (can be large). \" +\n      \"The result echoes the applied filters and projection mode in query_summary.\",\n    inputSchema: objectSchema(\n      {\n        query: { type: \"string\" },\n        options: { type: \"object\" },\n        ...SEARCH_TOP_LEVEL_OPTION_PROPERTIES,\n      },\n      [\"query\"],\n    ),\n  },\n  {\n    name: \"pm_list\",\n    description:\n      \"List pm items with status/type/tag/priority filters. Defaults to compact projection for token efficiency. \" +\n      \"options.status accepts CSV (all,open,in_progress). \" +\n      \"Pass options.compact=false or options.includeBody=true for full bodies/comments. \" +\n      \"Pass options.brief=true for ultra-terse (id/status/type/title only). \" +\n      \"Pass options.fields='id,title,priority' for custom projection. \" +\n      \"Pass options.limit=N to cap row count. \" +\n      \"The result echoes the applied filters and projection mode in query_summary.\",\n    inputSchema: objectSchema({\n      options: { type: \"object\" },\n      ...LIST_TOP_LEVEL_OPTION_PROPERTIES,\n    }),\n  },\n  {\n    name: \"pm_get\",\n    description:\n      \"Read one pm item with shared SDK projections. Pass options.depth='brief' or options.fields='id,title,status' for low-token inspection, options.fields='id,schedule.start_at' for schedule context, or options.at='7' / an ISO timestamp for a verified mutation-free historical read. Parent results include bounded child counts, samples, and continuation metadata.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        options: {\n          type: \"object\",\n          description:\n            \"Get options such as depth=brief|standard|deep|full, fields=id,title,status, or at=<version|ISO timestamp>.\",\n        },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_create\",\n    description:\n      \"Create a pm item natively and write pm history. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count for token efficiency); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"Return full changed_fields instead of changed_field_count.\",\n        },\n        allowMissingParent: {\n          type: \"boolean\",\n          description:\n            \"Allow unresolved parent references and emit a validation warning.\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Create options. title and description are required.\",\n        },\n      },\n      [\"options\"],\n    ),\n  },\n  {\n    name: \"pm_copy\",\n    description:\n      \"Copy an existing pm item into a new id while resetting lifecycle fields. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        ...COPY_TOP_LEVEL_OPTION_PROPERTIES,\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"Return full changed_fields instead of changed_field_count.\",\n        },\n        idOnly: {\n          type: \"boolean\",\n          description: \"Return only id and status.\",\n        },\n        options: {\n          type: \"object\",\n          description:\n            \"Copy options such as title override, author, and message.\",\n        },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_focus\",\n    description:\n      \"Set, clear, or show the session focused item. When focused, pm_create defaults its parent to the focused item \" +\n      \"(an explicit parent still overrides). Pass id to focus an item, options.clear=true to clear, or neither to show current focus.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        clear: {\n          type: \"boolean\",\n          description: \"Clear the focused item (cannot be combined with id).\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Focus options such as clear (boolean).\",\n        },\n      },\n      [],\n    ),\n  },\n  {\n    name: \"pm_update\",\n    description:\n      \"Update pm item metadata/body/dependencies/log seeds natively. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields delta.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"Return full changed_fields instead of changed_field_count.\",\n        },\n        options: { type: \"object\" },\n      },\n      [\"id\", \"options\"],\n    ),\n  },\n  {\n    name: \"pm_append\",\n    description:\n      \"Append markdown text to a pm item body and write pm history. Useful for seeding evidence/log entries before close. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        body: {\n          type: \"string\",\n          description:\n            \"Markdown text to append to the item body. Required here or as options.body.\",\n        },\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"Return full changed_fields instead of changed_field_count.\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Append options such as body, author, and message.\",\n        },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_claim\",\n    description: \"Claim a pm item.\",\n    inputSchema: objectSchema(\n      { id: idSchema, force: { type: \"boolean\" }, options: { type: \"object\" } },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_release\",\n    description: \"Release a pm item claim.\",\n    inputSchema: objectSchema(\n      { id: idSchema, force: { type: \"boolean\" }, options: { type: \"object\" } },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_close\",\n    description:\n      \"Close a pm item with optional close reason and optional close validation (reason requirement follows governance settings). \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        reason: {\n          type: \"string\",\n          description:\n            \"Close reason text when provided or required by governance settings.\",\n        },\n        duplicateOf: {\n          type: \"string\",\n          description:\n            \"Canonical item id when closing this item as a duplicate.\",\n        },\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"Return full changed_fields instead of changed_field_count.\",\n        },\n        idOnly: { type: \"boolean\", description: \"Return only id and status.\" },\n        options: { type: \"object\" },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_comments\",\n    description:\n      \"List, add, edit, or delete comments on a pm item. Use options.add to append, options.edit=<1-based index> with replacement text to fix a comment, or options.delete=<1-based index> to remove one. \" +\n      \"List calls default to the most recent 20 comments with total_count/has_more metadata for token efficiency. \" +\n      \"Pass options.limit=N to choose a page size, options.limit=0 for summary-only metadata, or options.full=true for full history.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_files\",\n    description:\n      \"List, add, remove, or validate linked files for a pm item.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_docs\",\n    description: \"List, add, or remove linked docs for a pm item.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_notes\",\n    description:\n      \"List or add structured notes on a pm item. Use options.add to append a note; omit it to list existing notes.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_learnings\",\n    description:\n      \"List or add learnings on a pm item. Use options.add to capture a learning/insight; omit it to list existing learnings.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_deps\",\n    description:\n      \"Read dependency trees/graphs or one bounded explainable relationship context packet. Use options.format=context with depth, node, edge, token, and cursor bounds.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_test\",\n    description: \"List, add, remove, or run linked tests for a pm item.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\n      \"id\",\n    ]),\n  },\n  {\n    name: \"pm_validate\",\n    description: \"Run pm validation checks.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_health\",\n    description:\n      \"Run pm health diagnostics. Pass options.brief=true for compact low-token details, options.skipIntegrity=true, options.skipDrift=true, options.skipVectors=true for a fast status-only check, or options.full=true for the complete deep check.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_contracts\",\n    description:\n      \"Inspect pm command, flag, schema, and availability contracts.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_schema\",\n    description:\n      \"Inspect or modify the workspace item-type/status/field schema (pm schema). \" +\n      \"subcommand selects the operation; name carries the item type name (show/add-type/remove-type), status id (show-status/add-status/remove-status), or field key (show-field/add-field/remove-field). \" +\n      \"apply-preset adopts a domain type preset; add-type with infer=true derives types from title-prefix conventions. \" +\n      \"Schema mutations write workspace config files, not item history.\",\n    inputSchema: objectSchema(\n      {\n        subcommand: {\n          type: \"string\",\n          enum: [\n            \"list\",\n            \"show\",\n            \"show-status\",\n            \"add-type\",\n            \"remove-type\",\n            \"add-status\",\n            \"remove-status\",\n            \"add-field\",\n            \"remove-field\",\n            \"list-fields\",\n            \"show-field\",\n            \"apply-preset\",\n          ],\n          description: \"Schema subcommand to run.\",\n        },\n        name: {\n          type: \"string\",\n          description:\n            \"Item type name (show/add-type/remove-type), status id (show-status/add-status/remove-status), or custom field key (show-field/add-field/remove-field). Required for those subcommands.\",\n        },\n        description: {\n          type: \"string\",\n          description:\n            \"Custom item type, status, or field description for add-type/add-status/add-field.\",\n        },\n        defaultStatus: {\n          type: \"string\",\n          description: \"Default status for add-type.\",\n        },\n        folder: { type: \"string\", description: \"Storage folder for add-type.\" },\n        alias: {\n          type: \"array\",\n          items: { type: \"string\" },\n          description:\n            \"Aliases for add-type/add-status, or extra CLI flag aliases for add-field.\",\n        },\n        role: {\n          type: \"array\",\n          items: { type: \"string\", enum: [...RUNTIME_STATUS_ROLE_VALUES] },\n          description: `Lifecycle roles for add-status: ${RUNTIME_STATUS_ROLE_VALUES.join(\", \")}.`,\n        },\n        order: {\n          type: \"number\",\n          description: \"Display/sort order for add-status.\",\n        },\n        fieldType: {\n          type: \"string\",\n          enum: [\"string\", \"number\", \"boolean\", \"string_array\"],\n          description: \"Value type for a custom field (add-field).\",\n        },\n        commands: {\n          type: \"array\",\n          items: { type: \"string\" },\n          description:\n            \"Commands a custom field is wired onto (add-field): create, update, update_many, list, search, calendar, context.\",\n        },\n        cliFlag: {\n          type: \"string\",\n          description:\n            \"Override the auto-derived CLI flag for a custom field (add-field).\",\n        },\n        required: {\n          type: \"boolean\",\n          description: \"Mark a custom field as always required (add-field).\",\n        },\n        requiredOnCreate: {\n          type: \"boolean\",\n          description:\n            \"Mark a custom field as required at create time (add-field).\",\n        },\n        allowUnset: {\n          type: \"boolean\",\n          description:\n            \"Whether a custom field may be cleared via --unset (add-field); defaults to true.\",\n        },\n        requiredTypes: {\n          type: \"array\",\n          items: { type: \"string\" },\n          description:\n            \"Restrict a custom field's requirement to specific item types (add-field).\",\n        },\n        typePreset: {\n          type: \"string\",\n          enum: [\"agile\", \"ops\", \"research\"],\n          description: \"Domain type preset to adopt (apply-preset).\",\n        },\n        infer: {\n          type: \"boolean\",\n          description:\n            \"Infer item types from title-prefix conventions (add-type); previews unless apply is true.\",\n        },\n        minCount: {\n          type: \"number\",\n          description:\n            \"Minimum items sharing a prefix for add-type inference (default 10).\",\n        },\n        apply: {\n          type: \"boolean\",\n          description:\n            \"Register inferred types (add-type infer); without it the call previews only.\",\n        },\n        force: {\n          type: \"boolean\",\n          description:\n            \"Override removal guardrails for destructive schema changes when supported.\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Additional schema options using camelCase keys.\",\n        },\n      },\n      [\"subcommand\"],\n    ),\n  },\n  {\n    name: \"pm_profile\",\n    description:\n      \"List, show, apply, or lint project profiles (pm profile) — archetype bundles that stage item types, statuses, fields, per-type workflows, config knobs, create templates, and recommended packages. \" +\n      \"subcommand selects the operation; name carries the profile name (agile, ops, research) for show/apply/lint. \" +\n      \"apply stages every dimension idempotently; dryRun previews the diff without writing; lint reports author-time consistency findings (graded error/warning) without touching the tracker. Profile staging writes workspace config/schema files, not item history.\",\n    inputSchema: objectSchema(\n      {\n        subcommand: {\n          type: \"string\",\n          enum: [\"list\", \"show\", \"apply\", \"lint\"],\n          description: \"Profile subcommand to run.\",\n        },\n        name: {\n          type: \"string\",\n          description:\n            \"Profile name for show/apply/lint. Required for those subcommands. Built-ins are agile, ops, and research; an active extension can contribute additional archetype names that resolve here too.\",\n        },\n        dryRun: {\n          type: \"boolean\",\n          description:\n            \"Preview the apply diff without writing any files (apply).\",\n        },\n        author: { type: \"string\", description: \"Mutation author for apply.\" },\n        force: {\n          type: \"boolean\",\n          description: \"Force ownership/lock override for apply.\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Additional profile options using camelCase keys.\",\n        },\n      },\n      [\"subcommand\"],\n    ),\n  },\n  {\n    name: \"pm_config\",\n    description:\n      \"Read or write pm workspace configuration (pm config). \" +\n      \"configAction selects get/set/list/export; key/value address a single setting for get/set. \" +\n      \"scope chooses the project (default) or global settings file.\",\n    inputSchema: objectSchema(\n      {\n        configAction: {\n          type: \"string\",\n          enum: [\"get\", \"set\", \"list\", \"export\"],\n          description:\n            \"Config operation to perform. get/set require key; list/export dump the resolved settings surface.\",\n        },\n        key: {\n          type: \"string\",\n          description:\n            \"Settings key for get/set, for example governance-require-close-reason, telemetry-tracking, or a nested leaf such as search_provider (dash and underscore variants accepted; configAction=get without a key lists supported keys in the error).\",\n        },\n        value: {\n          type: \"string\",\n          description: \"New value for configAction=set.\",\n        },\n        scope: {\n          type: \"string\",\n          enum: [\"project\", \"global\"],\n          description: \"Settings scope to read or write. Defaults to project.\",\n        },\n        options: {\n          type: \"object\",\n          description:\n            \"Additional config options such as criterion, clearCriteria, format, or policy.\",\n        },\n      },\n      [\"configAction\"],\n    ),\n  },\n  {\n    name: \"pm_plan\",\n    description:\n      \"Run agent-optimized Plan workflows. options.subcommand selects: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize. Provide id for all non-create subcommands; provide stepRef for step lifecycle subcommands. Plans store agent-readable steps with dependencies, decisions, discoveries, validation, and resume context.\",\n    inputSchema: objectSchema({\n      id: {\n        type: \"string\",\n        description: \"Plan id (required for all subcommands except create).\",\n      },\n      stepRef: {\n        type: \"string\",\n        description: \"Step id or order for step lifecycle subcommands.\",\n      },\n      reorderTo: { type: \"number\", description: \"New order for reorder-step.\" },\n      options: {\n        type: \"object\",\n        description:\n          \"Plan options including subcommand, stepRef, stepStatus, link, depth, etc.\",\n      },\n    }),\n  },\n];\n\n/** Stable projection of one MCP tool definition for the contract golden file (pm-4os2): tool name, description, required top-level fields, and the full inputSchema shape. Any drift (typo'd property, dropped required field, changed TOOL_SCHEMA_BASE) shows up in `pnpm contracts:check`. */\nexport interface McpToolContract {\n  /** Value that configures or reports name for this contract. */\n  name: string;\n  /** Value that configures or reports description for this contract. */\n  description: string;\n  /** Value that configures or reports required for this contract. */\n  required: string[];\n  /** Value that configures or reports input schema for this contract. */\n  input_schema: Record<string, unknown>;\n}\n\n/** Implements build mcp tool contracts for the public runtime surface of this module. */\nexport function buildMcpToolContracts(): McpToolContract[] {\n  return TOOLS.map((tool) => {\n    const schemaRequired = tool.inputSchema[\"required\"];\n    const required = Array.isArray(schemaRequired)\n      ? schemaRequired\n          .map((entry) => String(entry))\n          .sort((left, right) => left.localeCompare(right))\n      : [];\n    return {\n      name: tool.name,\n      description: tool.description,\n      required,\n      input_schema: tool.inputSchema,\n    };\n  }).sort((left, right) => left.name.localeCompare(right.name));\n}\n"],"names":[],"mappings":"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","debugId":"478bf194-a9d0-5c6a-b70e-d15164927fda"}

package/dist/sdk/author-attribution.d.ts

@@ -0,0 +1,35 @@
+/** First release-governance anchor after which unknown authors require remediation. */
+export declare const HISTORY_AUTHOR_ATTRIBUTION_BASELINE = "2026-07-15T06:22:12.276Z";
+/** Identifies one history event whose mutation author is absent or explicitly unknown. */
+export interface UnknownAuthorHistoryEvent {
+    /** Item whose history stream contains the event. */
+    item_id: string;
+    /** One-based JSONL line number. */
+    line: number;
+}
+/** Summarizes mutation-author provenance across all readable tracker history streams. */
+export interface HistoryAuthorAttributionScan {
+    /** Number of readable history streams inspected. */
+    checked_streams: number;
+    /** Number of non-empty history events inspected. */
+    checked_events: number;
+    /** Number of events without attributable authorship. */
+    unknown_event_count: number;
+    /** Immutable pre-baseline events retained as historical information. */
+    legacy_unknown_event_count: number;
+    /** Timestamped post-baseline events that require author-attribution fixes. */
+    actionable_unknown_event_count: number;
+    /** Stable, sorted item ids containing unknown-author events. */
+    affected_item_ids: string[];
+    /** Bounded examples suitable for diagnostic output. */
+    samples: UnknownAuthorHistoryEvent[];
+}
+/** Classifies one parsed history event by author provenance and baseline age. */
+export declare const classifyHistoryAuthorEvent: (parsed: unknown) => "attributed" | "legacy_unknown" | "actionable_unknown";
+/** Inspect one readable JSONL stream without performing filesystem I/O. */
+export declare const inspectHistoryAuthorStream: (itemId: string, raw: string, sampleLimit?: number) => Pick<HistoryAuthorAttributionScan, "checked_events" | "unknown_event_count" | "legacy_unknown_event_count" | "actionable_unknown_event_count" | "samples">;
+/**
+ * Scan append-only tracker history for missing or `unknown` author values.
+ * Malformed and unreadable streams are deliberately left to integrity diagnostics.
+ */
+export declare const scanHistoryAuthorAttribution: (pmRoot: string, sampleLimit?: number) => Promise<HistoryAuthorAttributionScan>;

package/dist/sdk/author-attribution.js

@@ -0,0 +1,118 @@
+/**
+ * @module sdk/author-attribution
+ *
+ * Provides reusable diagnostics for mutation-author provenance in tracker history.
+ */
+
+!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]="d34bc045-ebaa-5085-ab4e-7866236c2d52")}catch(e){}}();
+import fs from "node:fs/promises";
+import path from "node:path";
+/** First release-governance anchor after which unknown authors require remediation. */
+export const HISTORY_AUTHOR_ATTRIBUTION_BASELINE = "2026-07-15T06:22:12.276Z";
+/** Parsed epoch for the immutable attribution baseline used by every stream scan. */
+const HISTORY_AUTHOR_ATTRIBUTION_BASELINE_MS = Date.parse(HISTORY_AUTHOR_ATTRIBUTION_BASELINE);
+/** Attribution policy indexed by unknown-author and post-baseline flags. */
+const HISTORY_AUTHOR_EVENT_CLASSIFICATIONS = [
+    ["attributed", "attributed"],
+    ["legacy_unknown", "actionable_unknown"],
+];
+/** Return history string fields unchanged while normalizing other values to empty text. */
+const historyStringValue = (value) => typeof value === "string" ? value : "";
+/** Classifies one parsed history event by author provenance and baseline age. */
+export const classifyHistoryAuthorEvent = (parsed) => {
+    const record = (parsed ?? {});
+    const author = historyStringValue(record.author).trim().toLowerCase();
+    const authorClass = Number(["", "unknown"].includes(author));
+    const timestampClass = Number(Date.parse(historyStringValue(record.ts)) >=
+        HISTORY_AUTHOR_ATTRIBUTION_BASELINE_MS);
+    return HISTORY_AUTHOR_EVENT_CLASSIFICATIONS[authorClass][timestampClass];
+};
+/** Inspect one readable JSONL stream without performing filesystem I/O. */
+export const inspectHistoryAuthorStream = (itemId, raw, sampleLimit = 20) => {
+    const samples = [];
+    const unknownCounts = {
+        legacy_unknown: 0,
+        actionable_unknown: 0,
+    };
+    const boundedSampleLimit = Math.max(0, sampleLimit);
+    let checkedEvents = 0;
+    for (const [index, line] of raw.split(/\r?\n/).entries()) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        checkedEvents += 1;
+        const classification = classifyHistoryAuthorEvent(parsed);
+        if (classification === "attributed") {
+            continue;
+        }
+        unknownCounts[classification] += 1;
+        if (samples.length < boundedSampleLimit) {
+            samples.push({ item_id: itemId, line: index + 1 });
+        }
+    }
+    return {
+        checked_events: checkedEvents,
+        unknown_event_count: unknownCounts.legacy_unknown + unknownCounts.actionable_unknown,
+        legacy_unknown_event_count: unknownCounts.legacy_unknown,
+        actionable_unknown_event_count: unknownCounts.actionable_unknown,
+        samples,
+    };
+};
+/**
+ * Scan append-only tracker history for missing or `unknown` author values.
+ * Malformed and unreadable streams are deliberately left to integrity diagnostics.
+ */
+export const scanHistoryAuthorAttribution = async (pmRoot, sampleLimit = 20) => {
+    const historyDirectory = path.join(pmRoot, "history");
+    let fileNames;
+    try {
+        fileNames = (await fs.readdir(historyDirectory))
+            .filter((fileName) => fileName.endsWith(".jsonl"))
+            .sort((left, right) => left.localeCompare(right));
+    }
+    catch {
+        fileNames = [];
+    }
+    const affectedItemIds = new Set();
+    const samples = [];
+    let checkedStreams = 0;
+    let checkedEvents = 0;
+    let unknownEventCount = 0;
+    let legacyUnknownEventCount = 0;
+    let actionableUnknownEventCount = 0;
+    for (const fileName of fileNames) {
+        let raw;
+        try {
+            raw = await fs.readFile(path.join(historyDirectory, fileName), "utf8");
+        }
+        catch {
+            continue;
+        }
+        const itemId = fileName.slice(0, -".jsonl".length);
+        const inspected = inspectHistoryAuthorStream(itemId, raw, sampleLimit - samples.length);
+        checkedStreams += 1;
+        checkedEvents += inspected.checked_events;
+        unknownEventCount += inspected.unknown_event_count;
+        legacyUnknownEventCount += inspected.legacy_unknown_event_count;
+        actionableUnknownEventCount += inspected.actionable_unknown_event_count;
+        if (inspected.unknown_event_count > 0) {
+            affectedItemIds.add(itemId);
+        }
+        samples.push(...inspected.samples);
+    }
+    return {
+        checked_streams: checkedStreams,
+        checked_events: checkedEvents,
+        unknown_event_count: unknownEventCount,
+        legacy_unknown_event_count: legacyUnknownEventCount,
+        actionable_unknown_event_count: actionableUnknownEventCount,
+        affected_item_ids: [...affectedItemIds].sort((left, right) => left.localeCompare(right)),
+        samples,
+    };
+};
+//# sourceMappingURL=author-attribution.js.map
+//# debugId=d34bc045-ebaa-5085-ab4e-7866236c2d52