@unbrained/pm-cli 2026.6.24 → 2026.7.1

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

@@ -1 +1 @@
-{"version":3,"file":"observability.js","sources":["core/telemetry/observability.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/telemetry/observability\n *\n * Captures consent-aware telemetry and observability events for Observability.\n */\nimport { EXIT_CODE, type TelemetryErrorCategory } from \"../shared/constants.js\";\n\n/**\n * Restricts telemetry resolution stage values accepted by command, SDK, and storage contracts.\n */\nexport type TelemetryResolutionStage = \"parse\" | \"preflight\" | \"execute\" | \"unknown\";\n\n/**\n * Restricts telemetry command resolution values accepted by command, SDK, and storage contracts.\n */\nexport type TelemetryCommandResolution =\n  | \"success\"\n  | \"nonexistent_command\"\n  | \"invalid_option\"\n  | \"missing_required_option\"\n  | \"missing_required_argument\"\n  | \"invalid_usage\"\n  | \"validation_failed\"\n  | \"health_findings\"\n  | \"validation_findings\"\n  | \"conflict\"\n  | \"runtime_failed\"\n  | \"unknown_failed\";\n\n/**\n * Documents the telemetry command taxonomy payload exchanged by command, SDK, and package integrations.\n */\nexport interface TelemetryCommandTaxonomy {\n  command_path: string;\n  command_root: string;\n  command_leaf: string;\n  command_depth: number;\n  command_family: \"setup\" | \"query\" | \"mutation\" | \"testing\" | \"extension\" | \"diagnostics\" | \"other\";\n}\n\ninterface InferTelemetryErrorCodeParams {\n  ok: boolean;\n  errorCode?: string;\n  errorMessage?: string;\n  exitCode?: number;\n}\n\nconst SETUP_ROOT_COMMANDS = new Set([\"init\", \"config\", \"completion\", \"completion-statuses\", \"completion-tags\", \"completion-types\"]);\nconst QUERY_ROOT_COMMANDS = new Set([\n  \"list\",\n  \"list-all\",\n  \"list-open\",\n  \"list-in-progress\",\n  \"list-blocked\",\n  \"list-closed\",\n  \"list-canceled\",\n  \"list-draft\",\n  \"search\",\n  \"get\",\n  \"context\",\n  \"calendar\",\n  \"history\",\n  \"activity\",\n  \"aggregate\",\n  \"deps\",\n  \"contracts\",\n  \"stats\",\n  \"dedupe-audit\",\n]);\nconst MUTATION_ROOT_COMMANDS = new Set([\n  \"create\",\n  \"update\",\n  \"update-many\",\n  \"close-many\",\n  \"append\",\n  \"close\",\n  \"delete\",\n  \"restore\",\n  \"claim\",\n  \"release\",\n  \"comments\",\n  \"notes\",\n  \"learnings\",\n  \"files\",\n  \"docs\",\n  \"start-task\",\n  \"pause-task\",\n  \"close-task\",\n]);\nconst TESTING_ROOT_COMMANDS = new Set([\"test\", \"test-all\", \"test-runs\", \"test-verify\", \"trace-test\", \"test-ping\"]);\nconst DIAGNOSTICS_ROOT_COMMANDS = new Set([\"health\", \"validate\", \"normalize\", \"reindex\", \"gc\", \"telemetry\", \"extension-doctor\"]);\n\nfunction normalizeCommandPath(commandPath: string): string {\n  return commandPath\n    .trim()\n    .replaceAll(/\\s+/g, \" \")\n    .toLowerCase();\n}\n\nfunction normalizeErrorCode(errorCode: string | undefined): string | undefined {\n  const normalized = errorCode?.trim().toLowerCase();\n  return normalized && normalized.length > 0 ? normalized : undefined;\n}\n\n/**\n * Implements derive telemetry command taxonomy for the public runtime surface of this module.\n */\nexport function deriveTelemetryCommandTaxonomy(commandPath: string): TelemetryCommandTaxonomy {\n  const normalizedPath = normalizeCommandPath(commandPath);\n  // tokens always has at least one element (the fallback [\"<unknown>\"]), so the\n  // first/last lookups are never undefined.\n  const tokens = normalizedPath.length > 0 ? normalizedPath.split(\" \") : [\"<unknown>\"];\n  const root = tokens[0] as string;\n  const leaf = tokens[tokens.length - 1] as string;\n\n  let family: TelemetryCommandTaxonomy[\"command_family\"] = \"other\";\n  if (SETUP_ROOT_COMMANDS.has(root)) {\n    family = \"setup\";\n  } else if (QUERY_ROOT_COMMANDS.has(root)) {\n    family = \"query\";\n  } else if (MUTATION_ROOT_COMMANDS.has(root)) {\n    family = \"mutation\";\n  } else if (TESTING_ROOT_COMMANDS.has(root)) {\n    family = \"testing\";\n  } else if (root === \"extension\") {\n    family = \"extension\";\n  } else if (DIAGNOSTICS_ROOT_COMMANDS.has(root)) {\n    family = \"diagnostics\";\n  }\n\n  return {\n    command_path: normalizedPath.length > 0 ? normalizedPath : \"<unknown>\",\n    command_root: root,\n    command_leaf: leaf,\n    command_depth: tokens.length,\n    command_family: family,\n  };\n}\n\n/**\n * Implements infer telemetry error code for the public runtime surface of this module.\n */\nexport function inferTelemetryErrorCode(params: InferTelemetryErrorCodeParams): string | undefined {\n  if (params.ok) {\n    return undefined;\n  }\n\n  const explicit = normalizeErrorCode(params.errorCode);\n  if (explicit) {\n    return explicit;\n  }\n\n  const message = (params.errorMessage ?? \"\").trim().toLowerCase();\n  if (message.includes(\"unknown command\")) {\n    return \"unknown_command\";\n  }\n  if (message.includes(\"unknown option\")) {\n    return \"unknown_option\";\n  }\n  if (message.includes(\"missing required options\") || message.includes(\"missing required option\")) {\n    return \"missing_required_option\";\n  }\n  if (message.includes(\"missing required argument\")) {\n    return \"missing_required_argument\";\n  }\n  if (message.includes(\"no update flags provided\")) {\n    return \"no_update_fields\";\n  }\n  if (message.includes(\"is assigned to\") && message.includes(\"use --force\")) {\n    return \"ownership_conflict\";\n  }\n  if (message.includes(\"is locked\")) {\n    return \"lock_conflict\";\n  }\n  if (message.includes(\"already terminal\") && message.includes(\"use --force\")) {\n    return \"terminal_state_conflict\";\n  }\n  if (message.includes(\"tracker is not initialized\")) {\n    return \"tracker_not_initialized\";\n  }\n  if (message.includes(\" not found\")) {\n    return \"item_not_found\";\n  }\n  if (\n    message.includes(\"use \\\"pm close <id> <text>\\\" to close an item\") ||\n    (message.includes(\"invalid --status value\") && message.includes(\"\\\"closed\\\"\"))\n  ) {\n    return \"close_through_update\";\n  }\n  if (message.startsWith(\"invalid \") || message.includes(\" must be \") || message.includes(\" requires \")) {\n    return \"invalid_argument_value\";\n  }\n  // NOTE: A \"strict create mode requires concrete values for --\" message is always\n  // classified as invalid_argument_value by the ` requires ` check above, so a\n  // dedicated branch here would be unreachable and is intentionally omitted.\n  if (message.includes(\"either as positional\") && message.includes(\"not both\")) {\n    return \"invalid_command_usage\";\n  }\n\n  const exitCode = Number.isFinite(params.exitCode) ? Math.max(0, Math.trunc(params.exitCode as number)) : undefined;\n  if (exitCode === EXIT_CODE.USAGE) {\n    return \"invalid_command_usage\";\n  }\n  if (exitCode === EXIT_CODE.NOT_FOUND) {\n    return \"item_not_found\";\n  }\n  if (exitCode === EXIT_CODE.CONFLICT) {\n    return \"lock_conflict\";\n  }\n  if (exitCode === EXIT_CODE.DEPENDENCY_FAILED) {\n    return \"dependency_failed\";\n  }\n  return \"command_failed\";\n}\n\n/**\n * Implements derive telemetry command resolution for the public runtime surface of this module.\n */\nexport function deriveTelemetryCommandResolution(params: {\n  ok: boolean;\n  errorCode?: string;\n  errorCategory?: TelemetryErrorCategory;\n}): TelemetryCommandResolution {\n  if (params.ok) {\n    return \"success\";\n  }\n\n  const normalizedCode = normalizeErrorCode(params.errorCode);\n  if (normalizedCode === \"unknown_command\") {\n    return \"nonexistent_command\";\n  }\n  if (normalizedCode === \"unknown_option\") {\n    return \"invalid_option\";\n  }\n  if (normalizedCode === \"missing_required_option\") {\n    return \"missing_required_option\";\n  }\n  if (normalizedCode === \"missing_required_argument\") {\n    return \"missing_required_argument\";\n  }\n  if (normalizedCode === \"health_findings\") {\n    return \"health_findings\";\n  }\n  if (normalizedCode === \"validation_findings\") {\n    return \"validation_findings\";\n  }\n\n  if (params.errorCategory === \"usage\") {\n    return \"invalid_usage\";\n  }\n  if (params.errorCategory === \"validation\") {\n    return \"validation_failed\";\n  }\n  if (params.errorCategory === \"conflict\") {\n    return \"conflict\";\n  }\n  if (params.errorCategory === \"runtime\") {\n    return \"runtime_failed\";\n  }\n  return \"unknown_failed\";\n}\n"],"names":[],"mappings":"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","debugId":"4c03b7be-f7c0-5da3-ad78-cca945ab108c"}
+{"version":3,"file":"observability.js","sources":["core/telemetry/observability.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/telemetry/observability\n *\n * Captures consent-aware telemetry and observability events for Observability.\n */\nimport { EXIT_CODE, type TelemetryErrorCategory } from \"../shared/constants.js\";\n\n/**\n * Restricts telemetry resolution stage values accepted by command, SDK, and storage contracts.\n */\nexport type TelemetryResolutionStage = \"parse\" | \"preflight\" | \"execute\" | \"unknown\";\n\n/**\n * Restricts telemetry command resolution values accepted by command, SDK, and storage contracts.\n */\nexport type TelemetryCommandResolution =\n  | \"success\"\n  | \"nonexistent_command\"\n  | \"invalid_option\"\n  | \"missing_required_option\"\n  | \"missing_required_argument\"\n  | \"invalid_usage\"\n  | \"validation_failed\"\n  | \"health_findings\"\n  | \"validation_findings\"\n  | \"conflict\"\n  | \"runtime_failed\"\n  | \"unknown_failed\";\n\n/**\n * Documents the telemetry command taxonomy payload exchanged by command, SDK, and package integrations.\n */\nexport interface TelemetryCommandTaxonomy {\n  command_path: string;\n  command_root: string;\n  command_leaf: string;\n  command_depth: number;\n  command_family: \"setup\" | \"query\" | \"mutation\" | \"testing\" | \"extension\" | \"diagnostics\" | \"other\";\n}\n\ninterface InferTelemetryErrorCodeParams {\n  ok: boolean;\n  errorCode?: string;\n  errorMessage?: string;\n  exitCode?: number;\n}\n\ninterface TelemetryErrorMessageClassifier {\n  code: string;\n  matches: (message: string) => boolean;\n}\n\nconst SETUP_ROOT_COMMANDS = new Set([\"init\", \"config\", \"completion\", \"completion-statuses\", \"completion-tags\", \"completion-types\"]);\nconst QUERY_ROOT_COMMANDS = new Set([\n  \"list\",\n  \"list-all\",\n  \"list-open\",\n  \"list-in-progress\",\n  \"list-blocked\",\n  \"list-closed\",\n  \"list-canceled\",\n  \"list-draft\",\n  \"search\",\n  \"get\",\n  \"context\",\n  \"calendar\",\n  \"history\",\n  \"activity\",\n  \"aggregate\",\n  \"deps\",\n  \"contracts\",\n  \"stats\",\n  \"dedupe-audit\",\n]);\nconst MUTATION_ROOT_COMMANDS = new Set([\n  \"create\",\n  \"update\",\n  \"update-many\",\n  \"close-many\",\n  \"append\",\n  \"close\",\n  \"delete\",\n  \"restore\",\n  \"claim\",\n  \"release\",\n  \"comments\",\n  \"notes\",\n  \"learnings\",\n  \"files\",\n  \"docs\",\n  \"start-task\",\n  \"pause-task\",\n  \"close-task\",\n]);\nconst TESTING_ROOT_COMMANDS = new Set([\"test\", \"test-all\", \"test-runs\", \"test-verify\", \"trace-test\", \"test-ping\"]);\nconst DIAGNOSTICS_ROOT_COMMANDS = new Set([\"health\", \"validate\", \"normalize\", \"reindex\", \"gc\", \"telemetry\", \"extension-doctor\"]);\n\nfunction normalizeCommandPath(commandPath: string): string {\n  return commandPath\n    .trim()\n    .replaceAll(/\\s+/g, \" \")\n    .toLowerCase();\n}\n\nfunction normalizeErrorCode(errorCode: string | undefined): string | undefined {\n  const normalized = errorCode?.trim().toLowerCase();\n  return normalized && normalized.length > 0 ? normalized : undefined;\n}\n\nconst TELEMETRY_ERROR_MESSAGE_CLASSIFIERS: readonly TelemetryErrorMessageClassifier[] = [\n  { code: \"unknown_command\", matches: (message) => message.includes(\"unknown command\") },\n  { code: \"unknown_option\", matches: (message) => message.includes(\"unknown option\") },\n  {\n    code: \"missing_required_option\",\n    matches: (message) => message.includes(\"missing required options\") || message.includes(\"missing required option\"),\n  },\n  { code: \"missing_required_argument\", matches: (message) => message.includes(\"missing required argument\") },\n  { code: \"no_update_fields\", matches: (message) => message.includes(\"no update flags provided\") },\n  {\n    code: \"ownership_conflict\",\n    matches: (message) => message.includes(\"is assigned to\") && message.includes(\"use --force\"),\n  },\n  { code: \"lock_conflict\", matches: (message) => message.includes(\"is locked\") },\n  {\n    code: \"terminal_state_conflict\",\n    matches: (message) => message.includes(\"already terminal\") && message.includes(\"use --force\"),\n  },\n  { code: \"tracker_not_initialized\", matches: (message) => message.includes(\"tracker is not initialized\") },\n  { code: \"item_not_found\", matches: (message) => message.includes(\" not found\") },\n  {\n    code: \"close_through_update\",\n    matches: (message) =>\n      message.includes(\"use \\\"pm close <id> <text>\\\" to close an item\") ||\n      (message.includes(\"invalid --status value\") && message.includes(\"\\\"closed\\\"\")),\n  },\n  {\n    code: \"invalid_argument_value\",\n    matches: (message) => message.startsWith(\"invalid \") || message.includes(\" must be \") || message.includes(\" requires \"),\n  },\n  {\n    code: \"invalid_command_usage\",\n    matches: (message) => message.includes(\"either as positional\") && message.includes(\"not both\"),\n  },\n];\n\nconst TELEMETRY_EXIT_CODE_FALLBACKS: ReadonlyMap<number, string> = new Map([\n  [EXIT_CODE.USAGE, \"invalid_command_usage\"],\n  [EXIT_CODE.NOT_FOUND, \"item_not_found\"],\n  [EXIT_CODE.CONFLICT, \"lock_conflict\"],\n  [EXIT_CODE.DEPENDENCY_FAILED, \"dependency_failed\"],\n]);\n\n/**\n * Implements derive telemetry command taxonomy for the public runtime surface of this module.\n */\nexport function deriveTelemetryCommandTaxonomy(commandPath: string): TelemetryCommandTaxonomy {\n  const normalizedPath = normalizeCommandPath(commandPath);\n  // tokens always has at least one element (the fallback [\"<unknown>\"]), so the\n  // first/last lookups are never undefined.\n  const tokens = normalizedPath.length > 0 ? normalizedPath.split(\" \") : [\"<unknown>\"];\n  const root = tokens[0] as string;\n  const leaf = tokens[tokens.length - 1] as string;\n\n  let family: TelemetryCommandTaxonomy[\"command_family\"] = \"other\";\n  if (SETUP_ROOT_COMMANDS.has(root)) {\n    family = \"setup\";\n  } else if (QUERY_ROOT_COMMANDS.has(root)) {\n    family = \"query\";\n  } else if (MUTATION_ROOT_COMMANDS.has(root)) {\n    family = \"mutation\";\n  } else if (TESTING_ROOT_COMMANDS.has(root)) {\n    family = \"testing\";\n  } else if (root === \"extension\") {\n    family = \"extension\";\n  } else if (DIAGNOSTICS_ROOT_COMMANDS.has(root)) {\n    family = \"diagnostics\";\n  }\n\n  return {\n    command_path: normalizedPath.length > 0 ? normalizedPath : \"<unknown>\",\n    command_root: root,\n    command_leaf: leaf,\n    command_depth: tokens.length,\n    command_family: family,\n  };\n}\n\n/**\n * Implements infer telemetry error code for the public runtime surface of this module.\n */\nexport function inferTelemetryErrorCode(params: InferTelemetryErrorCodeParams): string | undefined {\n  if (params.ok) {\n    return undefined;\n  }\n\n  const explicit = normalizeErrorCode(params.errorCode);\n  if (explicit) {\n    return explicit;\n  }\n\n  const message = (params.errorMessage ?? \"\").trim().toLowerCase();\n  // NOTE: A \"strict create mode requires concrete values for --\" message is always\n  // classified as invalid_argument_value by the ordered ` requires ` classifier,\n  // so a dedicated branch would be unreachable and is intentionally omitted.\n  for (const classifier of TELEMETRY_ERROR_MESSAGE_CLASSIFIERS) {\n    if (classifier.matches(message)) {\n      return classifier.code;\n    }\n  }\n\n  const exitCode = Number.isFinite(params.exitCode) ? Math.max(0, Math.trunc(params.exitCode as number)) : undefined;\n  if (exitCode !== undefined) {\n    return TELEMETRY_EXIT_CODE_FALLBACKS.get(exitCode) ?? \"command_failed\";\n  }\n  return \"command_failed\";\n}\n\n/**\n * Implements derive telemetry command resolution for the public runtime surface of this module.\n */\nexport function deriveTelemetryCommandResolution(params: {\n  ok: boolean;\n  errorCode?: string;\n  errorCategory?: TelemetryErrorCategory;\n}): TelemetryCommandResolution {\n  if (params.ok) {\n    return \"success\";\n  }\n\n  const normalizedCode = normalizeErrorCode(params.errorCode);\n  if (normalizedCode === \"unknown_command\") {\n    return \"nonexistent_command\";\n  }\n  if (normalizedCode === \"unknown_option\") {\n    return \"invalid_option\";\n  }\n  if (normalizedCode === \"missing_required_option\") {\n    return \"missing_required_option\";\n  }\n  if (normalizedCode === \"missing_required_argument\") {\n    return \"missing_required_argument\";\n  }\n  if (normalizedCode === \"health_findings\") {\n    return \"health_findings\";\n  }\n  if (normalizedCode === \"validation_findings\") {\n    return \"validation_findings\";\n  }\n\n  if (params.errorCategory === \"usage\") {\n    return \"invalid_usage\";\n  }\n  if (params.errorCategory === \"validation\") {\n    return \"validation_failed\";\n  }\n  if (params.errorCategory === \"conflict\") {\n    return \"conflict\";\n  }\n  if (params.errorCategory === \"runtime\") {\n    return \"runtime_failed\";\n  }\n  return \"unknown_failed\";\n}\n"],"names":[],"mappings":"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","debugId":"1a034a5f-bb30-5cea-8926-4d11eb3b9c5f"}

package/dist/core/telemetry/runtime.js

@@ -4,7 +4,7 @@
  * Captures consent-aware telemetry and observability events for Runtime.
  */
 
-!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]="dbba82ab-8052-5828-babf-094b3f066810")}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]="761a82c5-659b-5d4d-bc1a-0e93f36f8b56")}catch(e){}}();
 import crypto from "node:crypto";
 import { spawn } from "node:child_process";
 import { mkdirSync, rmSync, statSync } from "node:fs";
@@ -1547,6 +1547,15 @@ function scheduleTelemetryFlush(globalPmRoot, endpoint, retentionDays) {
                 [PM_TELEMETRY_FLUSH_CHILD_ENV]: "1",
             },
         });
+        // A detached spawn can fail asynchronously — the runtime cannot launch the
+        // executable (locked-down Windows runners, missing flush runner, EACCES).
+        // Node re-throws an 'error' event with no listener as an uncaught exception,
+        // which would crash the foreground CLI and, under the test runner, the
+        // vitest worker during teardown (GH-348). Flush is strictly best effort, so
+        // swallow the failure and release the spawn gate to permit a later retry.
+        child.on("error", () => {
+            releaseTelemetryFlushSpawnGate(globalPmRoot);
+        });
         child.unref();
     }
     catch {
@@ -1792,4 +1801,4 @@ export async function emitTelemetryErrorEvent(context) {
     }
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=dbba82ab-8052-5828-babf-094b3f066810
+//# debugId=761a82c5-659b-5d4d-bc1a-0e93f36f8b56