@unbrained/pm-cli 2026.7.1 → 2026.7.3

package/dist/cli-bundle/chunks/{search-KILGT37L.js → search-R227JOL6.js}

@@ -7,17 +7,17 @@ import {
   resolveSearchScoreThreshold,
   resolveSearchTuning,
   runSearch
-} from "./chunk-BZCEN4JA.js";
+} from "./chunk-PULUSQAV.js";
 import "./chunk-VPLDQMW2.js";
-import "./chunk-4DSGXSBL.js";
-import "./chunk-3S2KT7NG.js";
+import "./chunk-XRYSCRZR.js";
+import "./chunk-ZFTKYWIF.js";
 import "./chunk-R23CSHGI.js";
-import "./chunk-NFDPYAIP.js";
-import "./chunk-4DUVCVLZ.js";
-import "./chunk-3K2M5OYU.js";
-import "./chunk-BHO33VBQ.js";
-import "./chunk-WYDHYJPO.js";
-import "./chunk-RVUALSJF.js";
+import "./chunk-YVKZ3ANP.js";
+import "./chunk-4PFVUUYV.js";
+import "./chunk-6KRFL33E.js";
+import "./chunk-3W2HJKJX.js";
+import "./chunk-AJHYQCBJ.js";
+import "./chunk-KHVGM5CS.js";
 export {
   _testOnlySearchCommand,
   classifyImplicitSemanticFallbackReason,
@@ -28,4 +28,4 @@ export {
   resolveSearchTuning,
   runSearch
 };
-//# sourceMappingURL=search-KILGT37L.js.map
+//# sourceMappingURL=search-R227JOL6.js.map

package/dist/cli-bundle/chunks/{stats-W5KNVJWQ.js → stats-FAG7COEH.js}

@@ -5,16 +5,16 @@ import {
   computeMetadataCoverage,
   groupItemsByDimension,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-NFDPYAIP.js";
+} from "./chunk-YVKZ3ANP.js";
 import {
   enforceHistoryStreamPolicyForItems,
   listAllFrontMatterLight,
   listAllFrontMatterWithBody
-} from "./chunk-3K2M5OYU.js";
-import "./chunk-BHO33VBQ.js";
+} from "./chunk-6KRFL33E.js";
+import "./chunk-3W2HJKJX.js";
 import {
   nowIso
-} from "./chunk-WYDHYJPO.js";
+} from "./chunk-AJHYQCBJ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -26,7 +26,7 @@ import {
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   runActiveOnReadHooks
-} from "./chunk-RVUALSJF.js";
+} from "./chunk-KHVGM5CS.js";
 
 // dist/cli/commands/stats.js
 import fs from "node:fs/promises";
@@ -244,4 +244,4 @@ export {
   _testOnly,
   runStats
 };
-//# sourceMappingURL=stats-W5KNVJWQ.js.map
+//# sourceMappingURL=stats-FAG7COEH.js.map

package/dist/cli-bundle/chunks/{stats-PSYVVTNZ.js → stats-MCK7PLYS.js}

@@ -7,16 +7,16 @@ import {
   computeMetadataCoverage,
   groupItemsByDimension,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-3VGN2UWE.js";
+} from "./chunk-QCDTQCMW.js";
 import {
   enforceHistoryStreamPolicyForItems,
   listAllFrontMatterLight,
   listAllFrontMatterWithBody
-} from "./chunk-JSU5P7VS.js";
-import "./chunk-QCWF6IYD.js";
+} from "./chunk-4WB6S4YX.js";
+import "./chunk-YSDFIY7N.js";
 import {
   nowIso
-} from "./chunk-AXIDKKAT.js";
+} from "./chunk-CXR3CMBQ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -28,7 +28,7 @@ import {
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   runActiveOnReadHooks
-} from "./chunk-7R4QEMZZ.js";
+} from "./chunk-L4SLHV6G.js";
 
 // dist/cli/commands/stats.js
 import fs from "node:fs/promises";
@@ -232,6 +232,6 @@ export {
   _testOnly,
   runStats
 };
-//# sourceMappingURL=stats-PSYVVTNZ.js.map
+//# sourceMappingURL=stats-MCK7PLYS.js.map
 
 //# debugId=67063306-59b8-53f5-8715-fd2e7f8705dd

package/dist/cli-bundle/chunks/{telemetry-GAHHQTOS.js → telemetry-DRPDZMAO.js}

@@ -1,9 +1,9 @@
 import {
   flushTelemetryQueueNow
-} from "./chunk-GJ326ZKX.js";
+} from "./chunk-ER4ME5U2.js";
 import {
   nowIso
-} from "./chunk-WYDHYJPO.js";
+} from "./chunk-AJHYQCBJ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -12,7 +12,7 @@ import {
   readSettings,
   resolveGlobalPmRoot,
   writeSettings
-} from "./chunk-RVUALSJF.js";
+} from "./chunk-KHVGM5CS.js";
 
 // dist/cli/commands/telemetry.js
 import fs from "node:fs/promises";
@@ -20,7 +20,7 @@ import path from "node:path";
 !(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] = "859d6b37-ab86-5c58-9fa1-4417222c238c");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "73a9de9c-dca7-5204-98b7-0b422515da56");
   } catch (e2) {
   }
 })();
@@ -34,6 +34,83 @@ function nearestRankPercentile(sortedAscending, fraction) {
   const index = Math.min(sortedAscending.length - 1, Math.max(0, rank - 1));
   return sortedAscending[index];
 }
+function normalizeTelemetryQueueEntry(entry) {
+  const command = typeof entry.event.command === "string" && entry.event.command.trim().length > 0 ? entry.event.command : "<unknown>";
+  const eventType = typeof entry.event.event_type === "string" && entry.event.event_type.trim().length > 0 ? entry.event.event_type : "unknown";
+  const eventSchemaVersion = typeof entry.event.schema_version === "number" && Number.isFinite(entry.event.schema_version) ? Math.trunc(entry.event.schema_version) : void 0;
+  const clientSchemaVersion = typeof entry.client_schema_version === "number" && Number.isFinite(entry.client_schema_version) ? Math.trunc(entry.client_schema_version) : void 0;
+  return { command, eventType, eventSchemaVersion, clientSchemaVersion };
+}
+function createTelemetryStatsAccumulator() {
+  return {
+    count: 0,
+    max_attempts: 0,
+    event_type_counts: {},
+    event_schema_versions: /* @__PURE__ */ new Set(),
+    client_schema_versions: /* @__PURE__ */ new Set(),
+    finish_durations_ms: [],
+    ok_count: 0,
+    error_count: 0,
+    resolution_counts: {}
+  };
+}
+function recordTelemetryFinishPayload(current, payload) {
+  const durationMs = typeof payload?.duration_ms === "number" && Number.isFinite(payload.duration_ms) ? payload.duration_ms : void 0;
+  if (durationMs !== void 0) {
+    current.finish_durations_ms.push(durationMs);
+  }
+  if (payload?.ok === true) {
+    current.ok_count += 1;
+  } else {
+    current.error_count += 1;
+  }
+  const resolution = typeof payload?.command_resolution === "string" && payload.command_resolution.trim().length > 0 ? payload.command_resolution : void 0;
+  if (resolution !== void 0) {
+    current.resolution_counts[resolution] = (current.resolution_counts[resolution] ?? 0) + 1;
+  }
+}
+function recordTelemetryQueueEntry(grouped, entry) {
+  const normalized = normalizeTelemetryQueueEntry(entry);
+  const current = grouped.get(normalized.command) ?? createTelemetryStatsAccumulator();
+  const attempts = Number.isFinite(entry.attempts) ? Math.max(0, Math.trunc(entry.attempts)) : 0;
+  current.count += 1;
+  current.max_attempts = Math.max(current.max_attempts, attempts);
+  current.event_type_counts[normalized.eventType] = (current.event_type_counts[normalized.eventType] ?? 0) + 1;
+  if (normalized.eventSchemaVersion !== void 0) {
+    current.event_schema_versions.add(normalized.eventSchemaVersion);
+  }
+  if (normalized.clientSchemaVersion !== void 0) {
+    current.client_schema_versions.add(normalized.clientSchemaVersion);
+  }
+  if (normalized.eventType === "command_finish") {
+    recordTelemetryFinishPayload(current, entry.event.payload);
+  }
+  grouped.set(normalized.command, current);
+}
+function buildTelemetryStatsBucket(command, value) {
+  const finishCount = value.ok_count + value.error_count;
+  const sortedDurations = [...value.finish_durations_ms].sort((left, right) => left - right);
+  const resolutionEntries = Object.entries(value.resolution_counts).sort((left, right) => left[0].localeCompare(right[0]));
+  return {
+    command,
+    count: value.count,
+    event_type_counts: Object.fromEntries(Object.entries(value.event_type_counts).sort((left, right) => left[0].localeCompare(right[0]))),
+    max_attempts: value.max_attempts,
+    event_schema_versions: [...value.event_schema_versions].sort((left, right) => left - right),
+    client_schema_versions: [...value.client_schema_versions].sort((left, right) => left - right),
+    ...sortedDurations.length > 0 ? {
+      duration_p50_ms: nearestRankPercentile(sortedDurations, 0.5),
+      duration_p95_ms: nearestRankPercentile(sortedDurations, 0.95),
+      duration_max_ms: sortedDurations[sortedDurations.length - 1]
+    } : {},
+    ...finishCount > 0 ? {
+      ok_count: value.ok_count,
+      error_count: value.error_count,
+      error_rate: value.error_count / finishCount
+    } : {},
+    ...resolutionEntries.length > 0 ? { command_resolution_counts: Object.fromEntries(resolutionEntries) } : {}
+  };
+}
 function normalizeTelemetrySubcommand(value) {
   const normalized = (value ?? "status").trim().toLowerCase();
   if (TELEMETRY_SUBCOMMANDS.includes(normalized)) {
@@ -144,72 +221,9 @@ async function buildTelemetryStatusSummary(globalPmRoot) {
 function buildTelemetryStatsBuckets(entries) {
   const grouped = /* @__PURE__ */ new Map();
   for (const entry of entries) {
-    const command = typeof entry.event.command === "string" && entry.event.command.trim().length > 0 ? entry.event.command : "<unknown>";
-    const eventType = typeof entry.event.event_type === "string" && entry.event.event_type.trim().length > 0 ? entry.event.event_type : "unknown";
-    const eventSchemaVersion = typeof entry.event.schema_version === "number" && Number.isFinite(entry.event.schema_version) ? Math.trunc(entry.event.schema_version) : void 0;
-    const clientSchemaVersion = typeof entry.client_schema_version === "number" && Number.isFinite(entry.client_schema_version) ? Math.trunc(entry.client_schema_version) : void 0;
-    const current = grouped.get(command) ?? {
-      count: 0,
-      max_attempts: 0,
-      event_type_counts: {},
-      event_schema_versions: /* @__PURE__ */ new Set(),
-      client_schema_versions: /* @__PURE__ */ new Set(),
-      finish_durations_ms: [],
-      ok_count: 0,
-      error_count: 0,
-      resolution_counts: {}
-    };
-    current.count += 1;
-    current.max_attempts = Math.max(current.max_attempts, Math.max(0, Math.trunc(entry.attempts)));
-    current.event_type_counts[eventType] = (current.event_type_counts[eventType] ?? 0) + 1;
-    if (eventSchemaVersion !== void 0) {
-      current.event_schema_versions.add(eventSchemaVersion);
-    }
-    if (clientSchemaVersion !== void 0) {
-      current.client_schema_versions.add(clientSchemaVersion);
-    }
-    if (eventType === "command_finish") {
-      const payload = entry.event.payload;
-      const durationMs = typeof payload?.duration_ms === "number" && Number.isFinite(payload.duration_ms) ? payload.duration_ms : void 0;
-      if (durationMs !== void 0) {
-        current.finish_durations_ms.push(durationMs);
-      }
-      if (payload?.ok === true) {
-        current.ok_count += 1;
-      } else {
-        current.error_count += 1;
-      }
-      const resolution = typeof payload?.command_resolution === "string" && payload.command_resolution.trim().length > 0 ? payload.command_resolution : void 0;
-      if (resolution !== void 0) {
-        current.resolution_counts[resolution] = (current.resolution_counts[resolution] ?? 0) + 1;
-      }
-    }
-    grouped.set(command, current);
+    recordTelemetryQueueEntry(grouped, entry);
   }
-  return [...grouped.entries()].map(([command, value]) => {
-    const finishCount = value.ok_count + value.error_count;
-    const sortedDurations = [...value.finish_durations_ms].sort((left, right) => left - right);
-    const resolutionEntries = Object.entries(value.resolution_counts).sort((left, right) => left[0].localeCompare(right[0]));
-    return {
-      command,
-      count: value.count,
-      event_type_counts: Object.fromEntries(Object.entries(value.event_type_counts).sort((left, right) => left[0].localeCompare(right[0]))),
-      max_attempts: value.max_attempts,
-      event_schema_versions: [...value.event_schema_versions].sort((left, right) => left - right),
-      client_schema_versions: [...value.client_schema_versions].sort((left, right) => left - right),
-      ...sortedDurations.length > 0 ? {
-        duration_p50_ms: nearestRankPercentile(sortedDurations, 0.5),
-        duration_p95_ms: nearestRankPercentile(sortedDurations, 0.95),
-        duration_max_ms: sortedDurations[sortedDurations.length - 1]
-      } : {},
-      ...finishCount > 0 ? {
-        ok_count: value.ok_count,
-        error_count: value.error_count,
-        error_rate: value.error_count / finishCount
-      } : {},
-      ...resolutionEntries.length > 0 ? { command_resolution_counts: Object.fromEntries(resolutionEntries) } : {}
-    };
-  }).sort((left, right) => right.count - left.count || left.command.localeCompare(right.command));
+  return [...grouped.entries()].map(([command, value]) => buildTelemetryStatsBucket(command, value)).sort((left, right) => right.count - left.count || left.command.localeCompare(right.command));
 }
 async function runTelemetry(options, _global) {
   void _global;
@@ -289,4 +303,4 @@ export {
   TELEMETRY_SUBCOMMANDS,
   runTelemetry
 };
-//# sourceMappingURL=telemetry-GAHHQTOS.js.map
+//# sourceMappingURL=telemetry-DRPDZMAO.js.map

package/dist/cli-bundle/chunks/telemetry-DRPDZMAO.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/telemetry.ts"],
+  "sourcesContent": ["/**\n * @module cli/commands/telemetry\n *\n * Implements the pm telemetry command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists, readFileIfExists } from \"../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { resolveGlobalPmRoot } from \"../../core/store/paths.js\";\nimport { readSettings, writeSettings } from \"../../core/store/settings.js\";\nimport { flushTelemetryQueueNow } from \"../../core/telemetry/runtime.js\";\n\nconst TELEMETRY_QUEUE_RELATIVE_PATH = path.join(\"runtime\", \"telemetry\", \"events.jsonl\");\nconst TELEMETRY_STATE_RELATIVE_PATH = path.join(\"runtime\", \"telemetry\", \"state.json\");\nconst TELEMETRY_RUNTIME_RELATIVE_PATH = path.join(\"runtime\", \"telemetry\");\nconst DEFAULT_STATS_LIMIT = 20;\n\nexport const TELEMETRY_SUBCOMMANDS = [\"status\", \"flush\", \"stats\", \"clear\"] as const;\n/**\n * Restricts telemetry subcommand values accepted by command, SDK, and storage contracts.\n */\nexport type TelemetrySubcommand = (typeof TELEMETRY_SUBCOMMANDS)[number];\n\ninterface TelemetryRuntimeStateRecord {\n  endpoint?: string;\n  queue_entries?: number;\n  last_attempted_flush_at?: string;\n  last_successful_flush_at?: string;\n  last_failed_flush_at?: string;\n  last_failed_flush_error?: string;\n}\n\ninterface QueuedTelemetryEventRecord {\n  attempts: number;\n  client_schema_version?: number;\n  event: {\n    event_id?: string;\n    event_type?: string;\n    schema_version?: number;\n    command?: string;\n    payload?: Record<string, unknown>;\n  };\n}\n\ninterface ParsedTelemetryQueue {\n  rows_total: number;\n  valid_entries: number;\n  invalid_rows: number;\n  entries: QueuedTelemetryEventRecord[];\n}\n\ninterface TelemetryStatusSummary {\n  enabled: boolean;\n  endpoint: string;\n  queue_path: string;\n  state_path: string;\n  queue_rows_total: number;\n  queue_entries: number;\n  queue_invalid_rows: number;\n  queue_size_bytes: number;\n  last_attempted_flush_at: string | null;\n  last_successful_flush_at: string | null;\n  last_failed_flush_at: string | null;\n  last_failed_flush_error: string | null;\n}\n\n/**\n * Documents the telemetry command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface TelemetryCommandOptions {\n  subcommand?: string;\n  limit?: string | number;\n}\n\ninterface TelemetryStatsBucket {\n  command: string;\n  count: number;\n  event_type_counts: Record<string, number>;\n  max_attempts: number;\n  event_schema_versions: number[];\n  client_schema_versions: number[];\n  /**\n   * Latency percentiles (nearest-rank) over `duration_ms` from the bucket's\n   * `command_finish` events. Present only when at least one finish event carries\n   * a finite `duration_ms`; `command_start`/`command_error` events are excluded.\n   */\n  duration_p50_ms?: number;\n  duration_p95_ms?: number;\n  duration_max_ms?: number;\n  /**\n   * Success/failure tally derived from `command_finish` payload `ok`. A finish\n   * event whose `ok` is missing or not strictly `true` is counted as an error\n   * (conservative). Present only when the bucket has at least one finish event;\n   * `ok_count + error_count` equals that finish-event count.\n   */\n  ok_count?: number;\n  error_count?: number;\n  error_rate?: number;\n  /** Distribution of `command_resolution` over `command_finish` events; present only when non-empty. */\n  command_resolution_counts?: Record<string, number>;\n}\n\ninterface TelemetryStatsBucketAccumulator {\n  count: number;\n  max_attempts: number;\n  event_type_counts: Record<string, number>;\n  event_schema_versions: Set<number>;\n  client_schema_versions: Set<number>;\n  finish_durations_ms: number[];\n  ok_count: number;\n  error_count: number;\n  resolution_counts: Record<string, number>;\n}\n\ninterface NormalizedTelemetryQueueEntry {\n  command: string;\n  eventType: string;\n  eventSchemaVersion: number | undefined;\n  clientSchemaVersion: number | undefined;\n}\n\n/**\n * Returns the nearest-rank percentile of an ascending-sorted, non-empty array.\n *\n * Uses the nearest-rank method (rank = ceil(fraction × n), 1-based, clamped into\n * range) so the result is always an observed sample value with no interpolation.\n */\nfunction nearestRankPercentile(sortedAscending: number[], fraction: number): number {\n  const rank = Math.ceil(fraction * sortedAscending.length);\n  const index = Math.min(sortedAscending.length - 1, Math.max(0, rank - 1));\n  return sortedAscending[index];\n}\n\nfunction normalizeTelemetryQueueEntry(entry: QueuedTelemetryEventRecord): NormalizedTelemetryQueueEntry {\n  const command = typeof entry.event.command === \"string\" && entry.event.command.trim().length > 0\n    ? entry.event.command\n    : \"<unknown>\";\n  const eventType = typeof entry.event.event_type === \"string\" && entry.event.event_type.trim().length > 0\n    ? entry.event.event_type\n    : \"unknown\";\n  const eventSchemaVersion = typeof entry.event.schema_version === \"number\" && Number.isFinite(entry.event.schema_version)\n    ? Math.trunc(entry.event.schema_version)\n    : undefined;\n  const clientSchemaVersion =\n    typeof entry.client_schema_version === \"number\" && Number.isFinite(entry.client_schema_version)\n      ? Math.trunc(entry.client_schema_version)\n      : undefined;\n  return { command, eventType, eventSchemaVersion, clientSchemaVersion };\n}\n\nfunction createTelemetryStatsAccumulator(): TelemetryStatsBucketAccumulator {\n  return {\n    count: 0,\n    max_attempts: 0,\n    event_type_counts: {},\n    event_schema_versions: new Set<number>(),\n    client_schema_versions: new Set<number>(),\n    finish_durations_ms: [],\n    ok_count: 0,\n    error_count: 0,\n    resolution_counts: {},\n  };\n}\n\nfunction recordTelemetryFinishPayload(current: TelemetryStatsBucketAccumulator, payload: Record<string, unknown> | undefined): void {\n  const durationMs = typeof payload?.duration_ms === \"number\" && Number.isFinite(payload.duration_ms)\n    ? payload.duration_ms\n    : undefined;\n  if (durationMs !== undefined) {\n    current.finish_durations_ms.push(durationMs);\n  }\n  if (payload?.ok === true) {\n    current.ok_count += 1;\n  } else {\n    current.error_count += 1;\n  }\n  const resolution = typeof payload?.command_resolution === \"string\" && payload.command_resolution.trim().length > 0\n    ? payload.command_resolution\n    : undefined;\n  if (resolution !== undefined) {\n    current.resolution_counts[resolution] = (current.resolution_counts[resolution] ?? 0) + 1;\n  }\n}\n\nfunction recordTelemetryQueueEntry(\n  grouped: Map<string, TelemetryStatsBucketAccumulator>,\n  entry: QueuedTelemetryEventRecord,\n): void {\n  const normalized = normalizeTelemetryQueueEntry(entry);\n  const current = grouped.get(normalized.command) ?? createTelemetryStatsAccumulator();\n  const attempts = Number.isFinite(entry.attempts) ? Math.max(0, Math.trunc(entry.attempts)) : 0;\n  current.count += 1;\n  current.max_attempts = Math.max(current.max_attempts, attempts);\n  current.event_type_counts[normalized.eventType] = (current.event_type_counts[normalized.eventType] ?? 0) + 1;\n  if (normalized.eventSchemaVersion !== undefined) {\n    current.event_schema_versions.add(normalized.eventSchemaVersion);\n  }\n  if (normalized.clientSchemaVersion !== undefined) {\n    current.client_schema_versions.add(normalized.clientSchemaVersion);\n  }\n  if (normalized.eventType === \"command_finish\") {\n    recordTelemetryFinishPayload(current, entry.event.payload);\n  }\n  grouped.set(normalized.command, current);\n}\n\nfunction buildTelemetryStatsBucket(command: string, value: TelemetryStatsBucketAccumulator): TelemetryStatsBucket {\n  const finishCount = value.ok_count + value.error_count;\n  const sortedDurations = [...value.finish_durations_ms].sort((left, right) => left - right);\n  const resolutionEntries = Object.entries(value.resolution_counts).sort((left, right) => left[0].localeCompare(right[0]));\n  return {\n    command,\n    count: value.count,\n    event_type_counts: Object.fromEntries(\n      Object.entries(value.event_type_counts).sort((left, right) => left[0].localeCompare(right[0])),\n    ),\n    max_attempts: value.max_attempts,\n    event_schema_versions: [...value.event_schema_versions].sort((left, right) => left - right),\n    client_schema_versions: [...value.client_schema_versions].sort((left, right) => left - right),\n    ...(sortedDurations.length > 0\n      ? {\n          duration_p50_ms: nearestRankPercentile(sortedDurations, 0.5),\n          duration_p95_ms: nearestRankPercentile(sortedDurations, 0.95),\n          duration_max_ms: sortedDurations[sortedDurations.length - 1],\n        }\n      : {}),\n    ...(finishCount > 0\n      ? {\n          ok_count: value.ok_count,\n          error_count: value.error_count,\n          error_rate: value.error_count / finishCount,\n        }\n      : {}),\n    ...(resolutionEntries.length > 0 ? { command_resolution_counts: Object.fromEntries(resolutionEntries) } : {}),\n  };\n}\n\nfunction normalizeTelemetrySubcommand(value: string | undefined): TelemetrySubcommand {\n  const normalized = (value ?? \"status\").trim().toLowerCase();\n  if ((TELEMETRY_SUBCOMMANDS as readonly string[]).includes(normalized)) {\n    return normalized as TelemetrySubcommand;\n  }\n  // `value` is always a defined string here: an undefined subcommand normalizes\n  // to \"status\" above (a valid value) and never reaches this throw.\n  throw new PmCliError(\n    `Unknown pm telemetry subcommand \"${value}\". Allowed: ${TELEMETRY_SUBCOMMANDS.join(\", \")}`,\n    EXIT_CODE.USAGE,\n    {\n      code: \"unknown_subcommand\",\n      examples: [\n        \"pm telemetry status\",\n        \"pm telemetry flush\",\n        \"pm telemetry stats --limit 10\",\n        \"pm telemetry clear\",\n      ],\n    },\n  );\n}\n\nfunction parseTelemetryStatsLimit(raw: string | number | undefined): number {\n  if (raw === undefined) {\n    return DEFAULT_STATS_LIMIT;\n  }\n  if (typeof raw === \"number\") {\n    if (!Number.isFinite(raw) || !Number.isInteger(raw) || raw <= 0) {\n      throw new PmCliError(\"--limit must be a positive integer\", EXIT_CODE.USAGE);\n    }\n    return raw;\n  }\n  const trimmed = raw.trim();\n  if (trimmed.length === 0 || !/^\\d+$/.test(trimmed)) {\n    throw new PmCliError(\"--limit must be a positive integer\", EXIT_CODE.USAGE);\n  }\n  const parsed = Number.parseInt(trimmed, 10);\n  if (!Number.isFinite(parsed) || parsed <= 0) {\n    throw new PmCliError(\"--limit must be a positive integer\", EXIT_CODE.USAGE);\n  }\n  return parsed;\n}\n\nfunction parseTelemetryQueue(raw: string | null): ParsedTelemetryQueue {\n  if (raw === null || raw.trim().length === 0) {\n    return {\n      rows_total: 0,\n      valid_entries: 0,\n      invalid_rows: 0,\n      entries: [],\n    };\n  }\n  const entries: QueuedTelemetryEventRecord[] = [];\n  let rowsTotal = 0;\n  let invalidRows = 0;\n  for (const line of raw.split(\"\\n\")) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    rowsTotal += 1;\n    try {\n      const parsed = JSON.parse(trimmed) as QueuedTelemetryEventRecord;\n      if (\n        typeof parsed === \"object\" &&\n        parsed !== null &&\n        typeof parsed.attempts === \"number\" &&\n        typeof parsed.event === \"object\" &&\n        parsed.event !== null\n      ) {\n        entries.push(parsed);\n      } else {\n        invalidRows += 1;\n      }\n    } catch {\n      invalidRows += 1;\n    }\n  }\n  return {\n    rows_total: rowsTotal,\n    valid_entries: entries.length,\n    invalid_rows: invalidRows,\n    entries,\n  };\n}\n\nasync function readTelemetryRuntimeState(statePath: string): Promise<TelemetryRuntimeStateRecord> {\n  const stateRaw = await readFileIfExists(statePath);\n  if (stateRaw === null || stateRaw.trim().length === 0) {\n    return {};\n  }\n  try {\n    const parsed = JSON.parse(stateRaw) as TelemetryRuntimeStateRecord;\n    if (typeof parsed === \"object\" && parsed !== null && !Array.isArray(parsed)) {\n      return parsed;\n    }\n  } catch {\n    // Ignore malformed state files; status command is observational.\n  }\n  return {};\n}\n\nasync function buildTelemetryStatusSummary(globalPmRoot: string): Promise<TelemetryStatusSummary> {\n  const settings = await readSettings(globalPmRoot);\n  const queuePath = path.join(globalPmRoot, TELEMETRY_QUEUE_RELATIVE_PATH);\n  const statePath = path.join(globalPmRoot, TELEMETRY_STATE_RELATIVE_PATH);\n  const queueRaw = await readFileIfExists(queuePath);\n  const queue = parseTelemetryQueue(queueRaw);\n  const runtimeState = await readTelemetryRuntimeState(statePath);\n  return {\n    enabled: settings.telemetry.enabled,\n    endpoint: settings.telemetry.endpoint,\n    queue_path: queuePath,\n    state_path: statePath,\n    queue_rows_total: queue.rows_total,\n    queue_entries: queue.valid_entries,\n    queue_invalid_rows: queue.invalid_rows,\n    queue_size_bytes: queueRaw === null ? 0 : Buffer.byteLength(queueRaw, \"utf8\"),\n    last_attempted_flush_at: runtimeState.last_attempted_flush_at ?? null,\n    last_successful_flush_at: runtimeState.last_successful_flush_at ?? null,\n    last_failed_flush_at: runtimeState.last_failed_flush_at ?? null,\n    last_failed_flush_error: runtimeState.last_failed_flush_error ?? null,\n  };\n}\n\nfunction buildTelemetryStatsBuckets(entries: QueuedTelemetryEventRecord[]): TelemetryStatsBucket[] {\n  const grouped = new Map<string, TelemetryStatsBucketAccumulator>();\n  for (const entry of entries) {\n    // Latency + outcome distribution come from command_finish payloads only:\n    // command_finish always carries duration_ms/ok/command_resolution at every\n    // capture level, while start/error events do not.\n    recordTelemetryQueueEntry(grouped, entry);\n  }\n  return [...grouped.entries()]\n    .map(([command, value]) => buildTelemetryStatsBucket(command, value))\n    .sort((left, right) => right.count - left.count || left.command.localeCompare(right.command));\n}\n\n/**\n * Implements run telemetry for the public runtime surface of this module.\n */\nexport async function runTelemetry(options: TelemetryCommandOptions, _global: GlobalOptions): Promise<Record<string, unknown>> {\n  void _global;\n  const subcommand = normalizeTelemetrySubcommand(options.subcommand);\n  const globalPmRoot = resolveGlobalPmRoot(process.cwd());\n  const queuePath = path.join(globalPmRoot, TELEMETRY_QUEUE_RELATIVE_PATH);\n  const statePath = path.join(globalPmRoot, TELEMETRY_STATE_RELATIVE_PATH);\n  if (subcommand === \"status\") {\n    return {\n      action: \"telemetry\",\n      subcommand,\n      status: await buildTelemetryStatusSummary(globalPmRoot),\n      generated_at: nowIso(),\n    };\n  }\n\n  if (subcommand === \"flush\") {\n    const before = await buildTelemetryStatusSummary(globalPmRoot);\n    await flushTelemetryQueueNow(globalPmRoot);\n    const after = await buildTelemetryStatusSummary(globalPmRoot);\n    return {\n      action: \"telemetry\",\n      subcommand,\n      queue_entries_before: before.queue_entries,\n      queue_entries_after: after.queue_entries,\n      queue_drained: after.queue_entries < before.queue_entries,\n      status: after,\n      generated_at: nowIso(),\n    };\n  }\n\n  if (subcommand === \"stats\") {\n    const limit = parseTelemetryStatsLimit(options.limit);\n    const queueRaw = await readFileIfExists(queuePath);\n    const queue = parseTelemetryQueue(queueRaw);\n    const buckets = buildTelemetryStatsBuckets(queue.entries);\n    const selected = buckets.slice(0, limit);\n    return {\n      action: \"telemetry\",\n      subcommand,\n      limit,\n      total_commands: buckets.length,\n      queue_entries: queue.valid_entries,\n      queue_invalid_rows: queue.invalid_rows,\n      queue_rows_total: queue.rows_total,\n      truncated: buckets.length > selected.length,\n      stats: selected,\n      generated_at: nowIso(),\n    };\n  }\n\n  const settings = await readSettings(globalPmRoot);\n  const previousEnabled = settings.telemetry.enabled;\n  const previousInstallationId = settings.telemetry.installation_id;\n  const previousFirstRunPromptCompleted = settings.telemetry.first_run_prompt_completed;\n  settings.telemetry.enabled = false;\n  settings.telemetry.first_run_prompt_completed = true;\n  settings.telemetry.installation_id = \"\";\n  const settingsChanged =\n    previousEnabled !== settings.telemetry.enabled ||\n    previousInstallationId !== settings.telemetry.installation_id ||\n    previousFirstRunPromptCompleted !== settings.telemetry.first_run_prompt_completed;\n  if (settingsChanged) {\n    await writeSettings(globalPmRoot, settings, \"telemetry:clear\");\n  }\n\n  const telemetryRuntimePath = path.join(globalPmRoot, TELEMETRY_RUNTIME_RELATIVE_PATH);\n  const existed = await pathExists(telemetryRuntimePath);\n  await fs.rm(telemetryRuntimePath, { recursive: true, force: true });\n  const queueExistsAfter = await pathExists(queuePath);\n  const stateExistsAfter = await pathExists(statePath);\n  return {\n    action: \"telemetry\",\n    subcommand,\n    settings_changed: settingsChanged,\n    runtime_dir_removed: existed && !(await pathExists(telemetryRuntimePath)),\n    queue_exists_after: queueExistsAfter,\n    state_exists_after: stateExistsAfter,\n    status: await buildTelemetryStatusSummary(globalPmRoot),\n    generated_at: nowIso(),\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cli-bundle/chunks/{telemetry-BZUF6H7G.js → telemetry-GVVUQSJQ.js}

@@ -1,11 +1,11 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="15b48ad8-a1a0-5365-be25-0b8682a800f8")}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]="fdec6e18-ebbc-5924-b761-36a1fbf0b092")}catch(e){}}();
 import {
   flushTelemetryQueueNow
-} from "./chunk-AVEE5EHK.js";
+} from "./chunk-Z7RPDF2Y.js";
 import {
   nowIso
-} from "./chunk-AXIDKKAT.js";
+} from "./chunk-CXR3CMBQ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -14,7 +14,7 @@ import {
   readSettings,
   resolveGlobalPmRoot,
   writeSettings
-} from "./chunk-7R4QEMZZ.js";
+} from "./chunk-L4SLHV6G.js";
 
 // dist/cli/commands/telemetry.js
 import fs from "node:fs/promises";
@@ -29,6 +29,83 @@ function nearestRankPercentile(sortedAscending, fraction) {
   const index = Math.min(sortedAscending.length - 1, Math.max(0, rank - 1));
   return sortedAscending[index];
 }
+function normalizeTelemetryQueueEntry(entry) {
+  const command = typeof entry.event.command === "string" && entry.event.command.trim().length > 0 ? entry.event.command : "<unknown>";
+  const eventType = typeof entry.event.event_type === "string" && entry.event.event_type.trim().length > 0 ? entry.event.event_type : "unknown";
+  const eventSchemaVersion = typeof entry.event.schema_version === "number" && Number.isFinite(entry.event.schema_version) ? Math.trunc(entry.event.schema_version) : void 0;
+  const clientSchemaVersion = typeof entry.client_schema_version === "number" && Number.isFinite(entry.client_schema_version) ? Math.trunc(entry.client_schema_version) : void 0;
+  return { command, eventType, eventSchemaVersion, clientSchemaVersion };
+}
+function createTelemetryStatsAccumulator() {
+  return {
+    count: 0,
+    max_attempts: 0,
+    event_type_counts: {},
+    event_schema_versions: /* @__PURE__ */ new Set(),
+    client_schema_versions: /* @__PURE__ */ new Set(),
+    finish_durations_ms: [],
+    ok_count: 0,
+    error_count: 0,
+    resolution_counts: {}
+  };
+}
+function recordTelemetryFinishPayload(current, payload) {
+  const durationMs = typeof payload?.duration_ms === "number" && Number.isFinite(payload.duration_ms) ? payload.duration_ms : void 0;
+  if (durationMs !== void 0) {
+    current.finish_durations_ms.push(durationMs);
+  }
+  if (payload?.ok === true) {
+    current.ok_count += 1;
+  } else {
+    current.error_count += 1;
+  }
+  const resolution = typeof payload?.command_resolution === "string" && payload.command_resolution.trim().length > 0 ? payload.command_resolution : void 0;
+  if (resolution !== void 0) {
+    current.resolution_counts[resolution] = (current.resolution_counts[resolution] ?? 0) + 1;
+  }
+}
+function recordTelemetryQueueEntry(grouped, entry) {
+  const normalized = normalizeTelemetryQueueEntry(entry);
+  const current = grouped.get(normalized.command) ?? createTelemetryStatsAccumulator();
+  const attempts = Number.isFinite(entry.attempts) ? Math.max(0, Math.trunc(entry.attempts)) : 0;
+  current.count += 1;
+  current.max_attempts = Math.max(current.max_attempts, attempts);
+  current.event_type_counts[normalized.eventType] = (current.event_type_counts[normalized.eventType] ?? 0) + 1;
+  if (normalized.eventSchemaVersion !== void 0) {
+    current.event_schema_versions.add(normalized.eventSchemaVersion);
+  }
+  if (normalized.clientSchemaVersion !== void 0) {
+    current.client_schema_versions.add(normalized.clientSchemaVersion);
+  }
+  if (normalized.eventType === "command_finish") {
+    recordTelemetryFinishPayload(current, entry.event.payload);
+  }
+  grouped.set(normalized.command, current);
+}
+function buildTelemetryStatsBucket(command, value) {
+  const finishCount = value.ok_count + value.error_count;
+  const sortedDurations = [...value.finish_durations_ms].sort((left, right) => left - right);
+  const resolutionEntries = Object.entries(value.resolution_counts).sort((left, right) => left[0].localeCompare(right[0]));
+  return {
+    command,
+    count: value.count,
+    event_type_counts: Object.fromEntries(Object.entries(value.event_type_counts).sort((left, right) => left[0].localeCompare(right[0]))),
+    max_attempts: value.max_attempts,
+    event_schema_versions: [...value.event_schema_versions].sort((left, right) => left - right),
+    client_schema_versions: [...value.client_schema_versions].sort((left, right) => left - right),
+    ...sortedDurations.length > 0 ? {
+      duration_p50_ms: nearestRankPercentile(sortedDurations, 0.5),
+      duration_p95_ms: nearestRankPercentile(sortedDurations, 0.95),
+      duration_max_ms: sortedDurations[sortedDurations.length - 1]
+    } : {},
+    ...finishCount > 0 ? {
+      ok_count: value.ok_count,
+      error_count: value.error_count,
+      error_rate: value.error_count / finishCount
+    } : {},
+    ...resolutionEntries.length > 0 ? { command_resolution_counts: Object.fromEntries(resolutionEntries) } : {}
+  };
+}
 function normalizeTelemetrySubcommand(value) {
   const normalized = (value ?? "status").trim().toLowerCase();
   if (TELEMETRY_SUBCOMMANDS.includes(normalized)) {
@@ -139,72 +216,9 @@ async function buildTelemetryStatusSummary(globalPmRoot) {
 function buildTelemetryStatsBuckets(entries) {
   const grouped = /* @__PURE__ */ new Map();
   for (const entry of entries) {
-    const command = typeof entry.event.command === "string" && entry.event.command.trim().length > 0 ? entry.event.command : "<unknown>";
-    const eventType = typeof entry.event.event_type === "string" && entry.event.event_type.trim().length > 0 ? entry.event.event_type : "unknown";
-    const eventSchemaVersion = typeof entry.event.schema_version === "number" && Number.isFinite(entry.event.schema_version) ? Math.trunc(entry.event.schema_version) : void 0;
-    const clientSchemaVersion = typeof entry.client_schema_version === "number" && Number.isFinite(entry.client_schema_version) ? Math.trunc(entry.client_schema_version) : void 0;
-    const current = grouped.get(command) ?? {
-      count: 0,
-      max_attempts: 0,
-      event_type_counts: {},
-      event_schema_versions: /* @__PURE__ */ new Set(),
-      client_schema_versions: /* @__PURE__ */ new Set(),
-      finish_durations_ms: [],
-      ok_count: 0,
-      error_count: 0,
-      resolution_counts: {}
-    };
-    current.count += 1;
-    current.max_attempts = Math.max(current.max_attempts, Math.max(0, Math.trunc(entry.attempts)));
-    current.event_type_counts[eventType] = (current.event_type_counts[eventType] ?? 0) + 1;
-    if (eventSchemaVersion !== void 0) {
-      current.event_schema_versions.add(eventSchemaVersion);
-    }
-    if (clientSchemaVersion !== void 0) {
-      current.client_schema_versions.add(clientSchemaVersion);
-    }
-    if (eventType === "command_finish") {
-      const payload = entry.event.payload;
-      const durationMs = typeof payload?.duration_ms === "number" && Number.isFinite(payload.duration_ms) ? payload.duration_ms : void 0;
-      if (durationMs !== void 0) {
-        current.finish_durations_ms.push(durationMs);
-      }
-      if (payload?.ok === true) {
-        current.ok_count += 1;
-      } else {
-        current.error_count += 1;
-      }
-      const resolution = typeof payload?.command_resolution === "string" && payload.command_resolution.trim().length > 0 ? payload.command_resolution : void 0;
-      if (resolution !== void 0) {
-        current.resolution_counts[resolution] = (current.resolution_counts[resolution] ?? 0) + 1;
-      }
-    }
-    grouped.set(command, current);
+    recordTelemetryQueueEntry(grouped, entry);
   }
-  return [...grouped.entries()].map(([command, value]) => {
-    const finishCount = value.ok_count + value.error_count;
-    const sortedDurations = [...value.finish_durations_ms].sort((left, right) => left - right);
-    const resolutionEntries = Object.entries(value.resolution_counts).sort((left, right) => left[0].localeCompare(right[0]));
-    return {
-      command,
-      count: value.count,
-      event_type_counts: Object.fromEntries(Object.entries(value.event_type_counts).sort((left, right) => left[0].localeCompare(right[0]))),
-      max_attempts: value.max_attempts,
-      event_schema_versions: [...value.event_schema_versions].sort((left, right) => left - right),
-      client_schema_versions: [...value.client_schema_versions].sort((left, right) => left - right),
-      ...sortedDurations.length > 0 ? {
-        duration_p50_ms: nearestRankPercentile(sortedDurations, 0.5),
-        duration_p95_ms: nearestRankPercentile(sortedDurations, 0.95),
-        duration_max_ms: sortedDurations[sortedDurations.length - 1]
-      } : {},
-      ...finishCount > 0 ? {
-        ok_count: value.ok_count,
-        error_count: value.error_count,
-        error_rate: value.error_count / finishCount
-      } : {},
-      ...resolutionEntries.length > 0 ? { command_resolution_counts: Object.fromEntries(resolutionEntries) } : {}
-    };
-  }).sort((left, right) => right.count - left.count || left.command.localeCompare(right.command));
+  return [...grouped.entries()].map(([command, value]) => buildTelemetryStatsBucket(command, value)).sort((left, right) => right.count - left.count || left.command.localeCompare(right.command));
 }
 async function runTelemetry(options, _global) {
   void _global;
@@ -284,6 +298,6 @@ export {
   TELEMETRY_SUBCOMMANDS,
   runTelemetry
 };
-//# sourceMappingURL=telemetry-BZUF6H7G.js.map
+//# sourceMappingURL=telemetry-GVVUQSJQ.js.map
 
-//# debugId=15b48ad8-a1a0-5365-be25-0b8682a800f8
+//# debugId=fdec6e18-ebbc-5924-b761-36a1fbf0b092

package/dist/cli-bundle/chunks/telemetry-GVVUQSJQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/telemetry.ts"],"sourcesContent":["/**\n * @module cli/commands/telemetry\n *\n * Implements the pm telemetry command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists, readFileIfExists } from \"../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { resolveGlobalPmRoot } from \"../../core/store/paths.js\";\nimport { readSettings, writeSettings } from \"../../core/store/settings.js\";\nimport { flushTelemetryQueueNow } from \"../../core/telemetry/runtime.js\";\n\nconst TELEMETRY_QUEUE_RELATIVE_PATH = path.join(\"runtime\", \"telemetry\", \"events.jsonl\");\nconst TELEMETRY_STATE_RELATIVE_PATH = path.join(\"runtime\", \"telemetry\", \"state.json\");\nconst TELEMETRY_RUNTIME_RELATIVE_PATH = path.join(\"runtime\", \"telemetry\");\nconst DEFAULT_STATS_LIMIT = 20;\n\nexport const TELEMETRY_SUBCOMMANDS = [\"status\", \"flush\", \"stats\", \"clear\"] as const;\n/**\n * Restricts telemetry subcommand values accepted by command, SDK, and storage contracts.\n */\nexport type TelemetrySubcommand = (typeof TELEMETRY_SUBCOMMANDS)[number];\n\ninterface TelemetryRuntimeStateRecord {\n  endpoint?: string;\n  queue_entries?: number;\n  last_attempted_flush_at?: string;\n  last_successful_flush_at?: string;\n  last_failed_flush_at?: string;\n  last_failed_flush_error?: string;\n}\n\ninterface QueuedTelemetryEventRecord {\n  attempts: number;\n  client_schema_version?: number;\n  event: {\n    event_id?: string;\n    event_type?: string;\n    schema_version?: number;\n    command?: string;\n    payload?: Record<string, unknown>;\n  };\n}\n\ninterface ParsedTelemetryQueue {\n  rows_total: number;\n  valid_entries: number;\n  invalid_rows: number;\n  entries: QueuedTelemetryEventRecord[];\n}\n\ninterface TelemetryStatusSummary {\n  enabled: boolean;\n  endpoint: string;\n  queue_path: string;\n  state_path: string;\n  queue_rows_total: number;\n  queue_entries: number;\n  queue_invalid_rows: number;\n  queue_size_bytes: number;\n  last_attempted_flush_at: string | null;\n  last_successful_flush_at: string | null;\n  last_failed_flush_at: string | null;\n  last_failed_flush_error: string | null;\n}\n\n/**\n * Documents the telemetry command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface TelemetryCommandOptions {\n  subcommand?: string;\n  limit?: string | number;\n}\n\ninterface TelemetryStatsBucket {\n  command: string;\n  count: number;\n  event_type_counts: Record<string, number>;\n  max_attempts: number;\n  event_schema_versions: number[];\n  client_schema_versions: number[];\n  /**\n   * Latency percentiles (nearest-rank) over `duration_ms` from the bucket's\n   * `command_finish` events. Present only when at least one finish event carries\n   * a finite `duration_ms`; `command_start`/`command_error` events are excluded.\n   */\n  duration_p50_ms?: number;\n  duration_p95_ms?: number;\n  duration_max_ms?: number;\n  /**\n   * Success/failure tally derived from `command_finish` payload `ok`. A finish\n   * event whose `ok` is missing or not strictly `true` is counted as an error\n   * (conservative). Present only when the bucket has at least one finish event;\n   * `ok_count + error_count` equals that finish-event count.\n   */\n  ok_count?: number;\n  error_count?: number;\n  error_rate?: number;\n  /** Distribution of `command_resolution` over `command_finish` events; present only when non-empty. */\n  command_resolution_counts?: Record<string, number>;\n}\n\ninterface TelemetryStatsBucketAccumulator {\n  count: number;\n  max_attempts: number;\n  event_type_counts: Record<string, number>;\n  event_schema_versions: Set<number>;\n  client_schema_versions: Set<number>;\n  finish_durations_ms: number[];\n  ok_count: number;\n  error_count: number;\n  resolution_counts: Record<string, number>;\n}\n\ninterface NormalizedTelemetryQueueEntry {\n  command: string;\n  eventType: string;\n  eventSchemaVersion: number | undefined;\n  clientSchemaVersion: number | undefined;\n}\n\n/**\n * Returns the nearest-rank percentile of an ascending-sorted, non-empty array.\n *\n * Uses the nearest-rank method (rank = ceil(fraction × n), 1-based, clamped into\n * range) so the result is always an observed sample value with no interpolation.\n */\nfunction nearestRankPercentile(sortedAscending: number[], fraction: number): number {\n  const rank = Math.ceil(fraction * sortedAscending.length);\n  const index = Math.min(sortedAscending.length - 1, Math.max(0, rank - 1));\n  return sortedAscending[index];\n}\n\nfunction normalizeTelemetryQueueEntry(entry: QueuedTelemetryEventRecord): NormalizedTelemetryQueueEntry {\n  const command = typeof entry.event.command === \"string\" && entry.event.command.trim().length > 0\n    ? entry.event.command\n    : \"<unknown>\";\n  const eventType = typeof entry.event.event_type === \"string\" && entry.event.event_type.trim().length > 0\n    ? entry.event.event_type\n    : \"unknown\";\n  const eventSchemaVersion = typeof entry.event.schema_version === \"number\" && Number.isFinite(entry.event.schema_version)\n    ? Math.trunc(entry.event.schema_version)\n    : undefined;\n  const clientSchemaVersion =\n    typeof entry.client_schema_version === \"number\" && Number.isFinite(entry.client_schema_version)\n      ? Math.trunc(entry.client_schema_version)\n      : undefined;\n  return { command, eventType, eventSchemaVersion, clientSchemaVersion };\n}\n\nfunction createTelemetryStatsAccumulator(): TelemetryStatsBucketAccumulator {\n  return {\n    count: 0,\n    max_attempts: 0,\n    event_type_counts: {},\n    event_schema_versions: new Set<number>(),\n    client_schema_versions: new Set<number>(),\n    finish_durations_ms: [],\n    ok_count: 0,\n    error_count: 0,\n    resolution_counts: {},\n  };\n}\n\nfunction recordTelemetryFinishPayload(current: TelemetryStatsBucketAccumulator, payload: Record<string, unknown> | undefined): void {\n  const durationMs = typeof payload?.duration_ms === \"number\" && Number.isFinite(payload.duration_ms)\n    ? payload.duration_ms\n    : undefined;\n  if (durationMs !== undefined) {\n    current.finish_durations_ms.push(durationMs);\n  }\n  if (payload?.ok === true) {\n    current.ok_count += 1;\n  } else {\n    current.error_count += 1;\n  }\n  const resolution = typeof payload?.command_resolution === \"string\" && payload.command_resolution.trim().length > 0\n    ? payload.command_resolution\n    : undefined;\n  if (resolution !== undefined) {\n    current.resolution_counts[resolution] = (current.resolution_counts[resolution] ?? 0) + 1;\n  }\n}\n\nfunction recordTelemetryQueueEntry(\n  grouped: Map<string, TelemetryStatsBucketAccumulator>,\n  entry: QueuedTelemetryEventRecord,\n): void {\n  const normalized = normalizeTelemetryQueueEntry(entry);\n  const current = grouped.get(normalized.command) ?? createTelemetryStatsAccumulator();\n  const attempts = Number.isFinite(entry.attempts) ? Math.max(0, Math.trunc(entry.attempts)) : 0;\n  current.count += 1;\n  current.max_attempts = Math.max(current.max_attempts, attempts);\n  current.event_type_counts[normalized.eventType] = (current.event_type_counts[normalized.eventType] ?? 0) + 1;\n  if (normalized.eventSchemaVersion !== undefined) {\n    current.event_schema_versions.add(normalized.eventSchemaVersion);\n  }\n  if (normalized.clientSchemaVersion !== undefined) {\n    current.client_schema_versions.add(normalized.clientSchemaVersion);\n  }\n  if (normalized.eventType === \"command_finish\") {\n    recordTelemetryFinishPayload(current, entry.event.payload);\n  }\n  grouped.set(normalized.command, current);\n}\n\nfunction buildTelemetryStatsBucket(command: string, value: TelemetryStatsBucketAccumulator): TelemetryStatsBucket {\n  const finishCount = value.ok_count + value.error_count;\n  const sortedDurations = [...value.finish_durations_ms].sort((left, right) => left - right);\n  const resolutionEntries = Object.entries(value.resolution_counts).sort((left, right) => left[0].localeCompare(right[0]));\n  return {\n    command,\n    count: value.count,\n    event_type_counts: Object.fromEntries(\n      Object.entries(value.event_type_counts).sort((left, right) => left[0].localeCompare(right[0])),\n    ),\n    max_attempts: value.max_attempts,\n    event_schema_versions: [...value.event_schema_versions].sort((left, right) => left - right),\n    client_schema_versions: [...value.client_schema_versions].sort((left, right) => left - right),\n    ...(sortedDurations.length > 0\n      ? {\n          duration_p50_ms: nearestRankPercentile(sortedDurations, 0.5),\n          duration_p95_ms: nearestRankPercentile(sortedDurations, 0.95),\n          duration_max_ms: sortedDurations[sortedDurations.length - 1],\n        }\n      : {}),\n    ...(finishCount > 0\n      ? {\n          ok_count: value.ok_count,\n          error_count: value.error_count,\n          error_rate: value.error_count / finishCount,\n        }\n      : {}),\n    ...(resolutionEntries.length > 0 ? { command_resolution_counts: Object.fromEntries(resolutionEntries) } : {}),\n  };\n}\n\nfunction normalizeTelemetrySubcommand(value: string | undefined): TelemetrySubcommand {\n  const normalized = (value ?? \"status\").trim().toLowerCase();\n  if ((TELEMETRY_SUBCOMMANDS as readonly string[]).includes(normalized)) {\n    return normalized as TelemetrySubcommand;\n  }\n  // `value` is always a defined string here: an undefined subcommand normalizes\n  // to \"status\" above (a valid value) and never reaches this throw.\n  throw new PmCliError(\n    `Unknown pm telemetry subcommand \"${value}\". Allowed: ${TELEMETRY_SUBCOMMANDS.join(\", \")}`,\n    EXIT_CODE.USAGE,\n    {\n      code: \"unknown_subcommand\",\n      examples: [\n        \"pm telemetry status\",\n        \"pm telemetry flush\",\n        \"pm telemetry stats --limit 10\",\n        \"pm telemetry clear\",\n      ],\n    },\n  );\n}\n\nfunction parseTelemetryStatsLimit(raw: string | number | undefined): number {\n  if (raw === undefined) {\n    return DEFAULT_STATS_LIMIT;\n  }\n  if (typeof raw === \"number\") {\n    if (!Number.isFinite(raw) || !Number.isInteger(raw) || raw <= 0) {\n      throw new PmCliError(\"--limit must be a positive integer\", EXIT_CODE.USAGE);\n    }\n    return raw;\n  }\n  const trimmed = raw.trim();\n  if (trimmed.length === 0 || !/^\\d+$/.test(trimmed)) {\n    throw new PmCliError(\"--limit must be a positive integer\", EXIT_CODE.USAGE);\n  }\n  const parsed = Number.parseInt(trimmed, 10);\n  if (!Number.isFinite(parsed) || parsed <= 0) {\n    throw new PmCliError(\"--limit must be a positive integer\", EXIT_CODE.USAGE);\n  }\n  return parsed;\n}\n\nfunction parseTelemetryQueue(raw: string | null): ParsedTelemetryQueue {\n  if (raw === null || raw.trim().length === 0) {\n    return {\n      rows_total: 0,\n      valid_entries: 0,\n      invalid_rows: 0,\n      entries: [],\n    };\n  }\n  const entries: QueuedTelemetryEventRecord[] = [];\n  let rowsTotal = 0;\n  let invalidRows = 0;\n  for (const line of raw.split(\"\\n\")) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    rowsTotal += 1;\n    try {\n      const parsed = JSON.parse(trimmed) as QueuedTelemetryEventRecord;\n      if (\n        typeof parsed === \"object\" &&\n        parsed !== null &&\n        typeof parsed.attempts === \"number\" &&\n        typeof parsed.event === \"object\" &&\n        parsed.event !== null\n      ) {\n        entries.push(parsed);\n      } else {\n        invalidRows += 1;\n      }\n    } catch {\n      invalidRows += 1;\n    }\n  }\n  return {\n    rows_total: rowsTotal,\n    valid_entries: entries.length,\n    invalid_rows: invalidRows,\n    entries,\n  };\n}\n\nasync function readTelemetryRuntimeState(statePath: string): Promise<TelemetryRuntimeStateRecord> {\n  const stateRaw = await readFileIfExists(statePath);\n  if (stateRaw === null || stateRaw.trim().length === 0) {\n    return {};\n  }\n  try {\n    const parsed = JSON.parse(stateRaw) as TelemetryRuntimeStateRecord;\n    if (typeof parsed === \"object\" && parsed !== null && !Array.isArray(parsed)) {\n      return parsed;\n    }\n  } catch {\n    // Ignore malformed state files; status command is observational.\n  }\n  return {};\n}\n\nasync function buildTelemetryStatusSummary(globalPmRoot: string): Promise<TelemetryStatusSummary> {\n  const settings = await readSettings(globalPmRoot);\n  const queuePath = path.join(globalPmRoot, TELEMETRY_QUEUE_RELATIVE_PATH);\n  const statePath = path.join(globalPmRoot, TELEMETRY_STATE_RELATIVE_PATH);\n  const queueRaw = await readFileIfExists(queuePath);\n  const queue = parseTelemetryQueue(queueRaw);\n  const runtimeState = await readTelemetryRuntimeState(statePath);\n  return {\n    enabled: settings.telemetry.enabled,\n    endpoint: settings.telemetry.endpoint,\n    queue_path: queuePath,\n    state_path: statePath,\n    queue_rows_total: queue.rows_total,\n    queue_entries: queue.valid_entries,\n    queue_invalid_rows: queue.invalid_rows,\n    queue_size_bytes: queueRaw === null ? 0 : Buffer.byteLength(queueRaw, \"utf8\"),\n    last_attempted_flush_at: runtimeState.last_attempted_flush_at ?? null,\n    last_successful_flush_at: runtimeState.last_successful_flush_at ?? null,\n    last_failed_flush_at: runtimeState.last_failed_flush_at ?? null,\n    last_failed_flush_error: runtimeState.last_failed_flush_error ?? null,\n  };\n}\n\nfunction buildTelemetryStatsBuckets(entries: QueuedTelemetryEventRecord[]): TelemetryStatsBucket[] {\n  const grouped = new Map<string, TelemetryStatsBucketAccumulator>();\n  for (const entry of entries) {\n    // Latency + outcome distribution come from command_finish payloads only:\n    // command_finish always carries duration_ms/ok/command_resolution at every\n    // capture level, while start/error events do not.\n    recordTelemetryQueueEntry(grouped, entry);\n  }\n  return [...grouped.entries()]\n    .map(([command, value]) => buildTelemetryStatsBucket(command, value))\n    .sort((left, right) => right.count - left.count || left.command.localeCompare(right.command));\n}\n\n/**\n * Implements run telemetry for the public runtime surface of this module.\n */\nexport async function runTelemetry(options: TelemetryCommandOptions, _global: GlobalOptions): Promise<Record<string, unknown>> {\n  void _global;\n  const subcommand = normalizeTelemetrySubcommand(options.subcommand);\n  const globalPmRoot = resolveGlobalPmRoot(process.cwd());\n  const queuePath = path.join(globalPmRoot, TELEMETRY_QUEUE_RELATIVE_PATH);\n  const statePath = path.join(globalPmRoot, TELEMETRY_STATE_RELATIVE_PATH);\n  if (subcommand === \"status\") {\n    return {\n      action: \"telemetry\",\n      subcommand,\n      status: await buildTelemetryStatusSummary(globalPmRoot),\n      generated_at: nowIso(),\n    };\n  }\n\n  if (subcommand === \"flush\") {\n    const before = await buildTelemetryStatusSummary(globalPmRoot);\n    await flushTelemetryQueueNow(globalPmRoot);\n    const after = await buildTelemetryStatusSummary(globalPmRoot);\n    return {\n      action: \"telemetry\",\n      subcommand,\n      queue_entries_before: before.queue_entries,\n      queue_entries_after: after.queue_entries,\n      queue_drained: after.queue_entries < before.queue_entries,\n      status: after,\n      generated_at: nowIso(),\n    };\n  }\n\n  if (subcommand === \"stats\") {\n    const limit = parseTelemetryStatsLimit(options.limit);\n    const queueRaw = await readFileIfExists(queuePath);\n    const queue = parseTelemetryQueue(queueRaw);\n    const buckets = buildTelemetryStatsBuckets(queue.entries);\n    const selected = buckets.slice(0, limit);\n    return {\n      action: \"telemetry\",\n      subcommand,\n      limit,\n      total_commands: buckets.length,\n      queue_entries: queue.valid_entries,\n      queue_invalid_rows: queue.invalid_rows,\n      queue_rows_total: queue.rows_total,\n      truncated: buckets.length > selected.length,\n      stats: selected,\n      generated_at: nowIso(),\n    };\n  }\n\n  const settings = await readSettings(globalPmRoot);\n  const previousEnabled = settings.telemetry.enabled;\n  const previousInstallationId = settings.telemetry.installation_id;\n  const previousFirstRunPromptCompleted = settings.telemetry.first_run_prompt_completed;\n  settings.telemetry.enabled = false;\n  settings.telemetry.first_run_prompt_completed = true;\n  settings.telemetry.installation_id = \"\";\n  const settingsChanged =\n    previousEnabled !== settings.telemetry.enabled ||\n    previousInstallationId !== settings.telemetry.installation_id ||\n    previousFirstRunPromptCompleted !== settings.telemetry.first_run_prompt_completed;\n  if (settingsChanged) {\n    await writeSettings(globalPmRoot, settings, \"telemetry:clear\");\n  }\n\n  const telemetryRuntimePath = path.join(globalPmRoot, TELEMETRY_RUNTIME_RELATIVE_PATH);\n  const existed = await pathExists(telemetryRuntimePath);\n  await fs.rm(telemetryRuntimePath, { recursive: true, force: true });\n  const queueExistsAfter = await pathExists(queuePath);\n  const stateExistsAfter = await pathExists(statePath);\n  return {\n    action: \"telemetry\",\n    subcommand,\n    settings_changed: settingsChanged,\n    runtime_dir_removed: existed && !(await pathExists(telemetryRuntimePath)),\n    queue_exists_after: queueExistsAfter,\n    state_exists_after: stateExistsAfter,\n    status: await buildTelemetryStatusSummary(globalPmRoot),\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"fdec6e18-ebbc-5924-b761-36a1fbf0b092"}