@unbrained/pm-cli 2026.6.5 → 2026.6.7

package/dist/cli/commands/stats.js

@@ -1,10 +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]="565baafc-ab35-53fa-93fa-6f3faa4d779c")}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]="02809425-3f94-5445-91ea-bdc968f9f64b")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { getActiveExtensionRegistrations, runActiveOnReadHooks } from "../../core/extensions/index.js";
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { enforceHistoryStreamPolicyForItems } from "../../core/history/history-stream-policy.js";
+import { computeHistoryStorageStats } from "../../core/history/history-storage-stats.js";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
 import { resolveRuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
@@ -34,13 +35,10 @@ function countNonEmptyLines(raw) {
         .filter((line) => line.trim().length > 0)
         .length;
 }
-async function readHistorySummary(pmRoot) {
+async function readHistoryStreamContents(pmRoot) {
     const historyDir = path.join(pmRoot, "history");
     if (!(await pathExists(historyDir))) {
-        return {
-            history_streams: 0,
-            history_entries: 0,
-        };
+        return [];
     }
     await runActiveOnReadHooks({
         path: historyDir,
@@ -49,7 +47,7 @@ async function readHistorySummary(pmRoot) {
     const historyFiles = (await fs.readdir(historyDir))
         .filter((entry) => entry.endsWith(".jsonl"))
         .sort((a, b) => a.localeCompare(b));
-    let historyEntries = 0;
+    const streams = [];
     for (const file of historyFiles) {
         const historyPath = path.join(historyDir, file);
         const raw = await fs.readFile(historyPath, "utf8");
@@ -57,14 +55,11 @@ async function readHistorySummary(pmRoot) {
             path: historyPath,
             scope: "project",
         });
-        historyEntries += countNonEmptyLines(raw);
+        streams.push({ id: file.slice(0, -".jsonl".length), raw });
     }
-    return {
-        history_streams: historyFiles.length,
-        history_entries: historyEntries,
-    };
+    return streams;
 }
-export async function runStats(global) {
+export async function runStats(global, options = {}) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     if (!(await pathExists(getSettingsPath(pmRoot)))) {
         throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
@@ -91,17 +86,23 @@ export async function runStats(global) {
         }
         byStatus[item.status] += 1;
     }
-    const historySummary = await readHistorySummary(pmRoot);
+    const streams = await readHistoryStreamContents(pmRoot);
+    let historyEntries = 0;
+    for (const stream of streams) {
+        historyEntries += countNonEmptyLines(stream.raw);
+    }
+    const storage = options.storage ? computeHistoryStorageStats(streams) : undefined;
     return {
         totals: {
             items: items.length,
-            history_streams: historySummary.history_streams,
-            history_entries: historySummary.history_entries,
+            history_streams: streams.length,
+            history_entries: historyEntries,
         },
         by_type: byType,
         by_status: byStatus,
+        ...(storage ? { storage } : {}),
         generated_at: nowIso(),
     };
 }
 //# sourceMappingURL=stats.js.map
-//# debugId=565baafc-ab35-53fa-93fa-6f3faa4d779c
+//# debugId=02809425-3f94-5445-91ea-bdc968f9f64b

package/dist/cli/commands/stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"stats.js","sources":["cli/commands/stats.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getActiveExtensionRegistrations, runActiveOnReadHooks } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { enforceHistoryStreamPolicyForItems } from \"../../core/history/history-stream-policy.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } from \"../../core/schema/runtime-schema.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 { listAllFrontMatterLight } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemStatus, ItemType } from \"../../types/index.js\";\n\nexport interface StatsResult {\n  totals: {\n    items: number;\n    history_streams: number;\n    history_entries: number;\n  };\n  by_type: Record<ItemType, number>;\n  by_status: Record<ItemStatus, number>;\n  generated_at: string;\n}\n\nfunction zeroByType(itemTypes: string[]): Record<ItemType, number> {\n  return itemTypes.reduce(\n    (acc, value) => {\n      acc[value] = 0;\n      return acc;\n    },\n    {} as Record<ItemType, number>,\n  );\n}\n\nfunction zeroByStatus(statuses: string[]): Record<ItemStatus, number> {\n  return statuses.reduce(\n    (acc, value) => {\n      acc[value] = 0;\n      return acc;\n    },\n    {} as Record<ItemStatus, number>,\n  );\n}\n\nfunction countNonEmptyLines(raw: string): number {\n  if (raw.trim().length === 0) {\n    return 0;\n  }\n  return raw\n    .split(/\\r?\\n/u)\n    .filter((line) => line.trim().length > 0)\n    .length;\n}\n\nasync function readHistorySummary(pmRoot: string): Promise<{ history_streams: number; history_entries: number }> {\n  const historyDir = path.join(pmRoot, \"history\");\n  if (!(await pathExists(historyDir))) {\n    return {\n      history_streams: 0,\n      history_entries: 0,\n    };\n  }\n\n  await runActiveOnReadHooks({\n    path: historyDir,\n    scope: \"project\",\n  });\n  const historyFiles = (await fs.readdir(historyDir))\n    .filter((entry) => entry.endsWith(\".jsonl\"))\n    .sort((a, b) => a.localeCompare(b));\n\n  let historyEntries = 0;\n  for (const file of historyFiles) {\n    const historyPath = path.join(historyDir, file);\n    const raw = await fs.readFile(historyPath, \"utf8\");\n    await runActiveOnReadHooks({\n      path: historyPath,\n      scope: \"project\",\n    });\n    historyEntries += countNonEmptyLines(raw);\n  }\n\n  return {\n    history_streams: historyFiles.length,\n    history_entries: historyEntries,\n  };\n}\n\nexport async function runStats(global: GlobalOptions): Promise<StatsResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);\n  await enforceHistoryStreamPolicyForItems({\n    pmRoot,\n    settings,\n    itemIds: items.map((item) => item.id),\n    commandLabel: \"stats\",\n  });\n\n  const byType = zeroByType(typeRegistry.types);\n  const byStatus = zeroByStatus(statusRegistry.definitions.map((definition) => definition.id));\n  for (const item of items) {\n    if (byType[item.type] === undefined) {\n      byType[item.type] = 0;\n    }\n    byType[item.type] += 1;\n    if (byStatus[item.status] === undefined) {\n      byStatus[item.status] = 0;\n    }\n    byStatus[item.status] += 1;\n  }\n\n  const historySummary = await readHistorySummary(pmRoot);\n\n  return {\n    totals: {\n      items: items.length,\n      history_streams: historySummary.history_streams,\n      history_entries: historySummary.history_entries,\n    },\n    by_type: byType,\n    by_status: byStatus,\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"565baafc-ab35-53fa-93fa-6f3faa4d779c"}
+{"version":3,"file":"stats.js","sources":["cli/commands/stats.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getActiveExtensionRegistrations, runActiveOnReadHooks } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { enforceHistoryStreamPolicyForItems } from \"../../core/history/history-stream-policy.js\";\nimport { computeHistoryStorageStats, type HistoryStorageStats } from \"../../core/history/history-storage-stats.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } from \"../../core/schema/runtime-schema.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 { listAllFrontMatterLight } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemStatus, ItemType } from \"../../types/index.js\";\n\nexport interface StatsCommandOptions {\n  /** Include aggregate per-stream history storage metrics (sizes, depth, oldest/newest). */\n  storage?: boolean;\n}\n\nexport interface StatsResult {\n  totals: {\n    items: number;\n    history_streams: number;\n    history_entries: number;\n  };\n  by_type: Record<ItemType, number>;\n  by_status: Record<ItemStatus, number>;\n  /** Present only with --storage: aggregate history-stream metrics for compaction/planning. */\n  storage?: HistoryStorageStats;\n  generated_at: string;\n}\n\nfunction zeroByType(itemTypes: string[]): Record<ItemType, number> {\n  return itemTypes.reduce(\n    (acc, value) => {\n      acc[value] = 0;\n      return acc;\n    },\n    {} as Record<ItemType, number>,\n  );\n}\n\nfunction zeroByStatus(statuses: string[]): Record<ItemStatus, number> {\n  return statuses.reduce(\n    (acc, value) => {\n      acc[value] = 0;\n      return acc;\n    },\n    {} as Record<ItemStatus, number>,\n  );\n}\n\nfunction countNonEmptyLines(raw: string): number {\n  if (raw.trim().length === 0) {\n    return 0;\n  }\n  return raw\n    .split(/\\r?\\n/u)\n    .filter((line) => line.trim().length > 0)\n    .length;\n}\n\nasync function readHistoryStreamContents(pmRoot: string): Promise<Array<{ id: string; raw: string }>> {\n  const historyDir = path.join(pmRoot, \"history\");\n  if (!(await pathExists(historyDir))) {\n    return [];\n  }\n\n  await runActiveOnReadHooks({\n    path: historyDir,\n    scope: \"project\",\n  });\n  const historyFiles = (await fs.readdir(historyDir))\n    .filter((entry) => entry.endsWith(\".jsonl\"))\n    .sort((a, b) => a.localeCompare(b));\n\n  const streams: Array<{ id: string; raw: string }> = [];\n  for (const file of historyFiles) {\n    const historyPath = path.join(historyDir, file);\n    const raw = await fs.readFile(historyPath, \"utf8\");\n    await runActiveOnReadHooks({\n      path: historyPath,\n      scope: \"project\",\n    });\n    streams.push({ id: file.slice(0, -\".jsonl\".length), raw });\n  }\n\n  return streams;\n}\n\nexport async function runStats(global: GlobalOptions, options: StatsCommandOptions = {}): Promise<StatsResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);\n  await enforceHistoryStreamPolicyForItems({\n    pmRoot,\n    settings,\n    itemIds: items.map((item) => item.id),\n    commandLabel: \"stats\",\n  });\n\n  const byType = zeroByType(typeRegistry.types);\n  const byStatus = zeroByStatus(statusRegistry.definitions.map((definition) => definition.id));\n  for (const item of items) {\n    if (byType[item.type] === undefined) {\n      byType[item.type] = 0;\n    }\n    byType[item.type] += 1;\n    if (byStatus[item.status] === undefined) {\n      byStatus[item.status] = 0;\n    }\n    byStatus[item.status] += 1;\n  }\n\n  const streams = await readHistoryStreamContents(pmRoot);\n  let historyEntries = 0;\n  for (const stream of streams) {\n    historyEntries += countNonEmptyLines(stream.raw);\n  }\n  const storage = options.storage ? computeHistoryStorageStats(streams) : undefined;\n\n  return {\n    totals: {\n      items: items.length,\n      history_streams: streams.length,\n      history_entries: historyEntries,\n    },\n    by_type: byType,\n    by_status: byStatus,\n    ...(storage ? { storage } : {}),\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"02809425-3f94-5445-91ea-bdc968f9f64b"}

package/dist/cli/commands/telemetry.d.ts

@@ -0,0 +1,8 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+export declare const TELEMETRY_SUBCOMMANDS: readonly ["status", "flush", "stats", "clear"];
+export type TelemetrySubcommand = (typeof TELEMETRY_SUBCOMMANDS)[number];
+export interface TelemetryCommandOptions {
+    subcommand?: string;
+    limit?: string | number;
+}
+export declare function runTelemetry(options: TelemetryCommandOptions, _global: GlobalOptions): Promise<Record<string, unknown>>;

package/dist/cli/commands/telemetry.js

@@ -0,0 +1,253 @@
+
+!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]="4d50d256-348c-5406-a377-ea98099b9ec6")}catch(e){}}();
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathExists, readFileIfExists } from "../../core/fs/fs-utils.js";
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { nowIso } from "../../core/shared/time.js";
+import { resolveGlobalPmRoot } from "../../core/store/paths.js";
+import { readSettings, writeSettings } from "../../core/store/settings.js";
+import { flushTelemetryQueueNow } from "../../core/telemetry/runtime.js";
+const TELEMETRY_QUEUE_RELATIVE_PATH = path.join("runtime", "telemetry", "events.jsonl");
+const TELEMETRY_STATE_RELATIVE_PATH = path.join("runtime", "telemetry", "state.json");
+const TELEMETRY_RUNTIME_RELATIVE_PATH = path.join("runtime", "telemetry");
+const DEFAULT_STATS_LIMIT = 20;
+export const TELEMETRY_SUBCOMMANDS = ["status", "flush", "stats", "clear"];
+function normalizeTelemetrySubcommand(value) {
+    const normalized = (value ?? "status").trim().toLowerCase();
+    if (TELEMETRY_SUBCOMMANDS.includes(normalized)) {
+        return normalized;
+    }
+    throw new PmCliError(`Unknown pm telemetry subcommand "${value ?? ""}". Allowed: ${TELEMETRY_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, {
+        code: "unknown_subcommand",
+        examples: [
+            "pm telemetry status",
+            "pm telemetry flush",
+            "pm telemetry stats --limit 10",
+            "pm telemetry clear",
+        ],
+    });
+}
+function parseTelemetryStatsLimit(raw) {
+    if (raw === undefined) {
+        return DEFAULT_STATS_LIMIT;
+    }
+    if (typeof raw === "number") {
+        if (!Number.isFinite(raw) || !Number.isInteger(raw) || raw <= 0) {
+            throw new PmCliError("--limit must be a positive integer", EXIT_CODE.USAGE);
+        }
+        return raw;
+    }
+    const trimmed = raw.trim();
+    if (trimmed.length === 0 || !/^\d+$/.test(trimmed)) {
+        throw new PmCliError("--limit must be a positive integer", EXIT_CODE.USAGE);
+    }
+    const parsed = Number.parseInt(trimmed, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new PmCliError("--limit must be a positive integer", EXIT_CODE.USAGE);
+    }
+    return parsed;
+}
+function parseTelemetryQueue(raw) {
+    if (raw === null || raw.trim().length === 0) {
+        return {
+            rows_total: 0,
+            valid_entries: 0,
+            invalid_rows: 0,
+            entries: [],
+        };
+    }
+    const entries = [];
+    let rowsTotal = 0;
+    let invalidRows = 0;
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0) {
+            continue;
+        }
+        rowsTotal += 1;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (typeof parsed === "object" &&
+                parsed !== null &&
+                typeof parsed.attempts === "number" &&
+                typeof parsed.event === "object" &&
+                parsed.event !== null) {
+                entries.push(parsed);
+            }
+            else {
+                invalidRows += 1;
+            }
+        }
+        catch {
+            invalidRows += 1;
+        }
+    }
+    return {
+        rows_total: rowsTotal,
+        valid_entries: entries.length,
+        invalid_rows: invalidRows,
+        entries,
+    };
+}
+async function readTelemetryRuntimeState(statePath) {
+    const stateRaw = await readFileIfExists(statePath);
+    if (stateRaw === null || stateRaw.trim().length === 0) {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(stateRaw);
+        if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // Ignore malformed state files; status command is observational.
+    }
+    return {};
+}
+async function buildTelemetryStatusSummary(globalPmRoot) {
+    const settings = await readSettings(globalPmRoot);
+    const queuePath = path.join(globalPmRoot, TELEMETRY_QUEUE_RELATIVE_PATH);
+    const statePath = path.join(globalPmRoot, TELEMETRY_STATE_RELATIVE_PATH);
+    const queueRaw = await readFileIfExists(queuePath);
+    const queue = parseTelemetryQueue(queueRaw);
+    const runtimeState = await readTelemetryRuntimeState(statePath);
+    return {
+        enabled: settings.telemetry.enabled,
+        endpoint: settings.telemetry.endpoint,
+        queue_path: queuePath,
+        state_path: statePath,
+        queue_rows_total: queue.rows_total,
+        queue_entries: queue.valid_entries,
+        queue_invalid_rows: queue.invalid_rows,
+        queue_size_bytes: queueRaw === null ? 0 : Buffer.byteLength(queueRaw, "utf8"),
+        last_attempted_flush_at: runtimeState.last_attempted_flush_at ?? null,
+        last_successful_flush_at: runtimeState.last_successful_flush_at ?? null,
+        last_failed_flush_at: runtimeState.last_failed_flush_at ?? null,
+        last_failed_flush_error: runtimeState.last_failed_flush_error ?? null,
+    };
+}
+function buildTelemetryStatsBuckets(entries) {
+    const grouped = 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)
+            : undefined;
+        const clientSchemaVersion = typeof entry.client_schema_version === "number" && Number.isFinite(entry.client_schema_version)
+            ? Math.trunc(entry.client_schema_version)
+            : undefined;
+        const current = grouped.get(command) ?? {
+            count: 0,
+            max_attempts: 0,
+            event_type_counts: {},
+            event_schema_versions: new Set(),
+            client_schema_versions: new Set(),
+        };
+        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 !== undefined) {
+            current.event_schema_versions.add(eventSchemaVersion);
+        }
+        if (clientSchemaVersion !== undefined) {
+            current.client_schema_versions.add(clientSchemaVersion);
+        }
+        grouped.set(command, current);
+    }
+    return [...grouped.entries()]
+        .map(([command, value]) => ({
+        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),
+    }))
+        .sort((left, right) => right.count - left.count || left.command.localeCompare(right.command));
+}
+export async function runTelemetry(options, _global) {
+    void _global;
+    const subcommand = normalizeTelemetrySubcommand(options.subcommand);
+    const globalPmRoot = resolveGlobalPmRoot(process.cwd());
+    const queuePath = path.join(globalPmRoot, TELEMETRY_QUEUE_RELATIVE_PATH);
+    const statePath = path.join(globalPmRoot, TELEMETRY_STATE_RELATIVE_PATH);
+    if (subcommand === "status") {
+        return {
+            action: "telemetry",
+            subcommand,
+            status: await buildTelemetryStatusSummary(globalPmRoot),
+            generated_at: nowIso(),
+        };
+    }
+    if (subcommand === "flush") {
+        const before = await buildTelemetryStatusSummary(globalPmRoot);
+        await flushTelemetryQueueNow(globalPmRoot);
+        const after = await buildTelemetryStatusSummary(globalPmRoot);
+        return {
+            action: "telemetry",
+            subcommand,
+            queue_entries_before: before.queue_entries,
+            queue_entries_after: after.queue_entries,
+            queue_drained: after.queue_entries < before.queue_entries,
+            status: after,
+            generated_at: nowIso(),
+        };
+    }
+    if (subcommand === "stats") {
+        const limit = parseTelemetryStatsLimit(options.limit);
+        const queueRaw = await readFileIfExists(queuePath);
+        const queue = parseTelemetryQueue(queueRaw);
+        const buckets = buildTelemetryStatsBuckets(queue.entries);
+        const selected = buckets.slice(0, limit);
+        return {
+            action: "telemetry",
+            subcommand,
+            limit,
+            total_commands: buckets.length,
+            queue_entries: queue.valid_entries,
+            queue_invalid_rows: queue.invalid_rows,
+            queue_rows_total: queue.rows_total,
+            truncated: buckets.length > selected.length,
+            stats: selected,
+            generated_at: nowIso(),
+        };
+    }
+    const settings = await readSettings(globalPmRoot);
+    const previousEnabled = settings.telemetry.enabled;
+    const previousInstallationId = settings.telemetry.installation_id;
+    const previousFirstRunPromptCompleted = settings.telemetry.first_run_prompt_completed;
+    settings.telemetry.enabled = false;
+    settings.telemetry.first_run_prompt_completed = true;
+    settings.telemetry.installation_id = "";
+    const settingsChanged = previousEnabled !== settings.telemetry.enabled ||
+        previousInstallationId !== settings.telemetry.installation_id ||
+        previousFirstRunPromptCompleted !== settings.telemetry.first_run_prompt_completed;
+    if (settingsChanged) {
+        await writeSettings(globalPmRoot, settings, "telemetry:clear");
+    }
+    const telemetryRuntimePath = path.join(globalPmRoot, TELEMETRY_RUNTIME_RELATIVE_PATH);
+    const existed = await pathExists(telemetryRuntimePath);
+    await fs.rm(telemetryRuntimePath, { recursive: true, force: true });
+    const queueExistsAfter = await pathExists(queuePath);
+    const stateExistsAfter = await pathExists(statePath);
+    return {
+        action: "telemetry",
+        subcommand,
+        settings_changed: settingsChanged,
+        runtime_dir_removed: existed && !(await pathExists(telemetryRuntimePath)),
+        queue_exists_after: queueExistsAfter,
+        state_exists_after: stateExistsAfter,
+        status: await buildTelemetryStatusSummary(globalPmRoot),
+        generated_at: nowIso(),
+    };
+}
+//# sourceMappingURL=telemetry.js.map
+//# debugId=4d50d256-348c-5406-a377-ea98099b9ec6

package/dist/cli/commands/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sources":["cli/commands/telemetry.ts"],"sourceRoot":"/","sourcesContent":["import 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;\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  };\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\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\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  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<\n    string,\n    {\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    }\n  >();\n  for (const entry of entries) {\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    const current = grouped.get(command) ?? {\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    };\n    current.count += 1;\n    current.max_attempts = Math.max(current.max_attempts, Math.max(0, Math.trunc(entry.attempts)));\n    current.event_type_counts[eventType] = (current.event_type_counts[eventType] ?? 0) + 1;\n    if (eventSchemaVersion !== undefined) {\n      current.event_schema_versions.add(eventSchemaVersion);\n    }\n    if (clientSchemaVersion !== undefined) {\n      current.client_schema_versions.add(clientSchemaVersion);\n    }\n    grouped.set(command, current);\n  }\n  return [...grouped.entries()]\n    .map(([command, value]) => ({\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    }))\n    .sort((left, right) => right.count - left.count || left.command.localeCompare(right.command));\n}\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":";;AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,MAAM,6BAA6B,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AACxF,MAAM,6BAA6B,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AACtF,MAAM,+BAA+B,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAC1E,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AA2DpF,SAAS,4BAA4B,CAAC,KAAyB;IAC7D,MAAM,UAAU,GAAG,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5D,IAAK,qBAA2C,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACtE,OAAO,UAAiC,CAAC;IAC3C,CAAC;IACD,MAAM,IAAI,UAAU,CAClB,oCAAoC,KAAK,IAAI,EAAE,eAAe,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAChG,SAAS,CAAC,KAAK,EACf;QACE,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE;YACR,qBAAqB;YACrB,oBAAoB;YACpB,+BAA+B;YAC/B,oBAAoB;SACrB;KACF,CACF,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAgC;IAChE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,UAAU,CAAC,oCAAoC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,UAAU,CAAC,oCAAoC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,UAAU,CAAC,oCAAoC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAkB;IAC7C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO;YACL,UAAU,EAAE,CAAC;YACb,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,CAAC;YACf,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QACD,SAAS,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA+B,CAAC;YACjE,IACE,OAAO,MAAM,KAAK,QAAQ;gBAC1B,MAAM,KAAK,IAAI;gBACf,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;gBACnC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;gBAChC,MAAM,CAAC,KAAK,KAAK,IAAI,EACrB,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,WAAW,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,WAAW,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,OAAO,CAAC,MAAM;QAC7B,YAAY,EAAE,WAAW;QACzB,OAAO;KACR,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,yBAAyB,CAAC,SAAiB;IACxD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAgC,CAAC;QACnE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5E,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,2BAA2B,CAAC,YAAoB;IAC7D,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,6BAA6B,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,6BAA6B,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,MAAM,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAChE,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,OAAO;QACnC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,QAAQ;QACrC,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,SAAS;QACrB,gBAAgB,EAAE,KAAK,CAAC,UAAU;QAClC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,kBAAkB,EAAE,KAAK,CAAC,YAAY;QACtC,gBAAgB,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC7E,uBAAuB,EAAE,YAAY,CAAC,uBAAuB,IAAI,IAAI;QACrE,wBAAwB,EAAE,YAAY,CAAC,wBAAwB,IAAI,IAAI;QACvE,oBAAoB,EAAE,YAAY,CAAC,oBAAoB,IAAI,IAAI;QAC/D,uBAAuB,EAAE,YAAY,CAAC,uBAAuB,IAAI,IAAI;KACtE,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,OAAqC;IACvE,MAAM,OAAO,GAAG,IAAI,GAAG,EASpB,CAAC;IACJ,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAC9F,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO;YACrB,CAAC,CAAC,WAAW,CAAC;QAChB,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YACtG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU;YACxB,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,kBAAkB,GAAG,OAAO,KAAK,CAAC,KAAK,CAAC,cAAc,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC;YACtH,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC;YACxC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,mBAAmB,GACvB,OAAO,KAAK,CAAC,qBAAqB,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,qBAAqB,CAAC;YAC7F,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC;YACzC,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI;YACtC,KAAK,EAAE,CAAC;YACR,YAAY,EAAE,CAAC;YACf,iBAAiB,EAAE,EAAE;YACrB,qBAAqB,EAAE,IAAI,GAAG,EAAU;YACxC,sBAAsB,EAAE,IAAI,GAAG,EAAU;SAC1C,CAAC;QACF,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC/F,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACvF,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;SAC1B,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,iBAAiB,EAAE,MAAM,CAAC,WAAW,CACnC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAC/F;QACD,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,qBAAqB,EAAE,CAAC,GAAG,KAAK,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC;QAC3F,sBAAsB,EAAE,CAAC,GAAG,KAAK,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC;KAC9F,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAgC,EAAE,OAAsB;IACzF,KAAK,OAAO,CAAC;IACb,MAAM,UAAU,GAAG,4BAA4B,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,6BAA6B,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,6BAA6B,CAAC,CAAC;IACzE,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,UAAU;YACV,MAAM,EAAE,MAAM,2BAA2B,CAAC,YAAY,CAAC;YACvD,YAAY,EAAE,MAAM,EAAE;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAC/D,MAAM,sBAAsB,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAC9D,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,UAAU;YACV,oBAAoB,EAAE,MAAM,CAAC,aAAa;YAC1C,mBAAmB,EAAE,KAAK,CAAC,aAAa;YACxC,aAAa,EAAE,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa;YACzD,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,MAAM,EAAE;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,0BAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzC,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,UAAU;YACV,KAAK;YACL,cAAc,EAAE,OAAO,CAAC,MAAM;YAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,kBAAkB,EAAE,KAAK,CAAC,YAAY;YACtC,gBAAgB,EAAE,KAAK,CAAC,UAAU;YAClC,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM;YAC3C,KAAK,EAAE,QAAQ;YACf,YAAY,EAAE,MAAM,EAAE;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC;IACnD,MAAM,sBAAsB,GAAG,QAAQ,CAAC,SAAS,CAAC,eAAe,CAAC;IAClE,MAAM,+BAA+B,GAAG,QAAQ,CAAC,SAAS,CAAC,0BAA0B,CAAC;IACtF,QAAQ,CAAC,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,0BAA0B,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,SAAS,CAAC,eAAe,GAAG,EAAE,CAAC;IACxC,MAAM,eAAe,GACnB,eAAe,KAAK,QAAQ,CAAC,SAAS,CAAC,OAAO;QAC9C,sBAAsB,KAAK,QAAQ,CAAC,SAAS,CAAC,eAAe;QAC7D,+BAA+B,KAAK,QAAQ,CAAC,SAAS,CAAC,0BAA0B,CAAC;IACpF,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,aAAa,CAAC,YAAY,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,+BAA+B,CAAC,CAAC;IACtF,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,MAAM,gBAAgB,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;IACrD,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,UAAU;QACV,gBAAgB,EAAE,eAAe;QACjC,mBAAmB,EAAE,OAAO,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,oBAAoB,CAAC,CAAC;QACzE,kBAAkB,EAAE,gBAAgB;QACpC,kBAAkB,EAAE,gBAAgB;QACpC,MAAM,EAAE,MAAM,2BAA2B,CAAC,YAAY,CAAC;QACvD,YAAY,EAAE,MAAM,EAAE;KACvB,CAAC;AACJ,CAAC","debugId":"4d50d256-348c-5406-a377-ea98099b9ec6"}

package/dist/cli/error-guidance.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]="883618a4-a53f-5506-ab97-d734647806e7")}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]="004f0f48-f016-51b6-b587-30101f5bb77f")}catch(e){}}();
 import { renderPmCommand } from "./argv-utils.js";
 function errorType(code) {
     return `urn:pm-cli:error:${code}`;
@@ -63,6 +63,21 @@ function normalizeRecoveryPayload(payload) {
     if (typeof payload.suggested_retry === "string" && payload.suggested_retry.trim().length > 0) {
         normalized.suggested_retry = payload.suggested_retry.trim();
     }
+    if (Array.isArray(payload.fallback_candidates)) {
+        const fallbackCandidates = payload.fallback_candidates
+            .map((entry) => ({
+            source: typeof entry?.source === "string" ? entry.source.trim() : "",
+            command: typeof entry?.command === "string" ? entry.command.trim() : "",
+            reason: typeof entry?.reason === "string" ? entry.reason.trim() : "",
+        }))
+            .filter((entry) => entry.source.length > 0 && entry.command.length > 0 && entry.reason.length > 0);
+        if (fallbackCandidates.length > 0) {
+            normalized.fallback_candidates = fallbackCandidates;
+        }
+    }
+    if (typeof payload.next_best_command === "string" && payload.next_best_command.trim().length > 0) {
+        normalized.next_best_command = payload.next_best_command.trim();
+    }
     return Object.keys(normalized).length > 0 ? normalized : undefined;
 }
 function renderRecoveryBundle(recovery) {
@@ -86,6 +101,15 @@ function renderRecoveryBundle(recovery) {
     if (normalized.suggested_retry) {
         lines.push(`  suggested_retry: ${normalized.suggested_retry}`);
     }
+    if (normalized.next_best_command) {
+        lines.push(`  next_best_command: ${normalized.next_best_command}`);
+    }
+    if (normalized.fallback_candidates && normalized.fallback_candidates.length > 0) {
+        lines.push("  fallback_candidates:");
+        for (const candidate of normalized.fallback_candidates) {
+            lines.push(`    - ${candidate.source}: ${candidate.command} (${candidate.reason})`);
+        }
+    }
     return lines;
 }
 export function renderGuidanceMessage(message) {
@@ -645,4 +669,4 @@ export function classifyUnknownError(rawMessage) {
     return guidanceToClassification(buildUnknownErrorGuidance(rawMessage));
 }
 //# sourceMappingURL=error-guidance.js.map
-//# debugId=883618a4-a53f-5506-ab97-d734647806e7
+//# debugId=004f0f48-f016-51b6-b587-30101f5bb77f