@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/telemetry.js

@@ -1,406 +1,2 @@
-/**
- * @module sdk/telemetry
- *
- * Implements the pm telemetry command surface and its agent-facing runtime behavior.
- */
-
-!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]="ad3110ca-e85b-5a7e-b0a1-591796c298eb")}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";
-import { createUnknownSubcommandError } from "./agent/subcommand-recovery.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;
-/** Public contract for telemetry subcommands, shared by SDK and presentation-layer consumers. */
-export const TELEMETRY_SUBCOMMANDS = [
-    "status",
-    "flush",
-    "stats",
-    "clear",
-];
-/**
- * Returns the nearest-rank percentile of an ascending-sorted, non-empty array.
- *
- * Uses the nearest-rank method (rank = ceil(fraction × n), 1-based, clamped into
- * range) so the result is always an observed sample value with no interpolation.
- */
-const nearestRankPercentile = (sortedAscending, fraction) => {
-    const rank = Math.ceil(fraction * sortedAscending.length);
-    const index = Math.min(sortedAscending.length - 1, Math.max(0, rank - 1));
-    return sortedAscending[index];
-};
-/** Normalizes optional text while substituting a stable fallback for blanks. */
-const normalizeTelemetryText = (value, fallback) => {
-    if (typeof value !== "string") {
-        return fallback;
-    }
-    return value.trim().length > 0 ? value : fallback;
-};
-/** Truncates finite numeric metadata while rejecting other runtime shapes. */
-const normalizeFiniteInteger = (value) => {
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        return undefined;
-    }
-    return Math.trunc(value);
-};
-const normalizeTelemetryQueueEntry = (entry) => {
-    return {
-        command: normalizeTelemetryText(entry.event.command, "<unknown>"),
-        eventType: normalizeTelemetryText(entry.event.event_type, "unknown"),
-        eventSchemaVersion: normalizeFiniteInteger(entry.event.schema_version),
-        clientSchemaVersion: normalizeFiniteInteger(entry.client_schema_version),
-    };
-};
-const createTelemetryStatsAccumulator = () => {
-    return {
-        count: 0,
-        max_attempts: 0,
-        event_type_counts: {},
-        event_schema_versions: new Set(),
-        client_schema_versions: new Set(),
-        finish_durations_ms: [],
-        ok_count: 0,
-        error_count: 0,
-        resolution_counts: {},
-    };
-};
-/** Keeps a finite duration sample from an optional finish payload. */
-const readTelemetryDuration = (payload) => {
-    const value = payload?.duration_ms;
-    return typeof value === "number" && Number.isFinite(value)
-        ? value
-        : undefined;
-};
-/** Keeps a non-blank resolution from an optional finish payload. */
-const readTelemetryResolution = (payload) => {
-    const value = payload?.command_resolution;
-    return normalizeTelemetryText(value, "") || undefined;
-};
-/** Increments a named counter in an object-backed frequency map. */
-const incrementTelemetryCount = (counts, key) => {
-    counts[key] = (counts[key] ?? 0) + 1;
-};
-const recordTelemetryFinishPayload = (current, payload) => {
-    const durationMs = readTelemetryDuration(payload);
-    if (durationMs !== undefined) {
-        current.finish_durations_ms.push(durationMs);
-    }
-    if (payload?.ok === true) {
-        current.ok_count += 1;
-    }
-    else {
-        current.error_count += 1;
-    }
-    const resolution = readTelemetryResolution(payload);
-    if (resolution !== undefined) {
-        incrementTelemetryCount(current.resolution_counts, resolution);
-    }
-};
-/** Normalizes retry attempts to a non-negative finite integer. */
-const normalizeTelemetryAttempts = (attempts) => Number.isFinite(attempts) ? Math.max(0, Math.trunc(attempts)) : 0;
-/** Adds a defined numeric value to a set-backed telemetry dimension. */
-const addTelemetryDimension = (values, value) => {
-    if (value !== undefined) {
-        values.add(value);
-    }
-};
-const recordTelemetryQueueEntry = (grouped, entry) => {
-    const normalized = normalizeTelemetryQueueEntry(entry);
-    const current = grouped.get(normalized.command) ?? createTelemetryStatsAccumulator();
-    current.count += 1;
-    current.max_attempts = Math.max(current.max_attempts, normalizeTelemetryAttempts(entry.attempts));
-    incrementTelemetryCount(current.event_type_counts, normalized.eventType);
-    addTelemetryDimension(current.event_schema_versions, normalized.eventSchemaVersion);
-    addTelemetryDimension(current.client_schema_versions, normalized.clientSchemaVersion);
-    if (normalized.eventType === "command_finish") {
-        recordTelemetryFinishPayload(current, entry.event.payload);
-    }
-    grouped.set(normalized.command, current);
-};
-const 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) }
-            : {}),
-    };
-};
-const normalizeTelemetrySubcommand = (value) => {
-    const normalized = (value ?? "status").trim().toLowerCase();
-    if (TELEMETRY_SUBCOMMANDS.includes(normalized)) {
-        return normalized;
-    }
-    // `value` is always a defined string here: an undefined subcommand normalizes
-    // to "status" above (a valid value) and never reaches this throw.
-    throw createUnknownSubcommandError({
-        command_path: "telemetry",
-        token: value?.trim() || "<empty>",
-        allowed: TELEMETRY_SUBCOMMANDS,
-        examples: [
-            "pm telemetry status",
-            "pm telemetry flush",
-            "pm telemetry stats --limit 10",
-            "pm telemetry clear",
-        ],
-    });
-};
-/** Throws the stable usage diagnostic for invalid telemetry stats windows. */
-const throwInvalidTelemetryLimit = () => {
-    throw new PmCliError("--limit must be a positive integer", EXIT_CODE.USAGE);
-};
-/** Validates one already-parsed stats limit. */
-const requirePositiveTelemetryLimit = (value) => {
-    if ([!Number.isFinite(value), !Number.isInteger(value), value <= 0].includes(true)) {
-        return throwInvalidTelemetryLimit();
-    }
-    return value;
-};
-/** Parses and validates the string form accepted by the CLI flag surface. */
-const parseTelemetryStringLimit = (raw) => {
-    const trimmed = raw.trim();
-    if ([trimmed.length === 0, !/^\d+$/.test(trimmed)].includes(true)) {
-        return throwInvalidTelemetryLimit();
-    }
-    return requirePositiveTelemetryLimit(Number.parseInt(trimmed, 10));
-};
-const parseTelemetryStatsLimit = (raw) => {
-    if (raw === undefined) {
-        return DEFAULT_STATS_LIMIT;
-    }
-    if (typeof raw === "number") {
-        return requirePositiveTelemetryLimit(raw);
-    }
-    if (typeof raw === "string") {
-        return parseTelemetryStringLimit(raw);
-    }
-    return throwInvalidTelemetryLimit();
-};
-/** Recognizes the persisted telemetry queue record shape. */
-const isTelemetryQueueEntry = (value) => {
-    if (typeof value !== "object" || value === null) {
-        return false;
-    }
-    const candidate = value;
-    return (typeof candidate.attempts === "number" &&
-        typeof candidate.event === "object" &&
-        candidate.event !== null);
-};
-/** Parses one non-blank queue row without leaking JSON failures. */
-const parseTelemetryQueueRow = (row) => {
-    try {
-        const parsed = JSON.parse(row);
-        return isTelemetryQueueEntry(parsed) ? parsed : undefined;
-    }
-    catch {
-        return undefined;
-    }
-};
-/** Splits queue content into non-blank persisted rows. */
-const splitTelemetryQueueRows = (raw) => {
-    if (raw === null) {
-        return [];
-    }
-    return raw
-        .split("\n")
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
-};
-const parseTelemetryQueue = (raw) => {
-    const rows = splitTelemetryQueueRows(raw);
-    const entries = [];
-    let invalidRows = 0;
-    for (const row of rows) {
-        const parsed = parseTelemetryQueueRow(row);
-        if (parsed === undefined) {
-            invalidRows += 1;
-        }
-        else {
-            entries.push(parsed);
-        }
-    }
-    return {
-        rows_total: rows.length,
-        valid_entries: entries.length,
-        invalid_rows: invalidRows,
-        entries,
-    };
-};
-/** Recognizes an object-shaped telemetry runtime state payload. */
-const isTelemetryRuntimeState = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-/** Parses observational runtime state while treating malformed content as empty. */
-const parseTelemetryRuntimeState = (raw) => {
-    try {
-        const parsed = JSON.parse(raw);
-        return isTelemetryRuntimeState(parsed) ? parsed : {};
-    }
-    catch {
-        return {};
-    }
-};
-const readTelemetryRuntimeState = async (statePath) => {
-    const stateRaw = await readFileIfExists(statePath);
-    if (stateRaw === null || stateRaw.trim().length === 0) {
-        return {};
-    }
-    return parseTelemetryRuntimeState(stateRaw);
-};
-/** Converts an optional telemetry state value to an explicit nullable field. */
-const nullableTelemetryStateValue = (value) => value ?? null;
-const buildTelemetryStatusSummary = async (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: Buffer.byteLength(queueRaw ?? "", "utf8"),
-        last_attempted_flush_at: nullableTelemetryStateValue(runtimeState.last_attempted_flush_at),
-        last_successful_flush_at: nullableTelemetryStateValue(runtimeState.last_successful_flush_at),
-        last_failed_flush_at: nullableTelemetryStateValue(runtimeState.last_failed_flush_at),
-        last_failed_flush_error: nullableTelemetryStateValue(runtimeState.last_failed_flush_error),
-    };
-};
-const buildTelemetryStatsBuckets = (entries) => {
-    const grouped = new Map();
-    for (const entry of entries) {
-        // Latency + outcome distribution come from command_finish payloads only:
-        // command_finish always carries duration_ms/ok/command_resolution at every
-        // capture level, while start/error events do not.
-        recordTelemetryQueueEntry(grouped, entry);
-    }
-    return [...grouped.entries()]
-        .map(([command, value]) => buildTelemetryStatsBucket(command, value))
-        .sort((left, right) => right.count - left.count || left.command.localeCompare(right.command));
-};
-/** Returns current telemetry queue and runtime state without mutation. */
-const runTelemetryStatus = async (_options, context) => ({
-    action: "telemetry",
-    subcommand: "status",
-    status: await buildTelemetryStatusSummary(context.globalPmRoot),
-    generated_at: nowIso(),
-});
-/** Flushes queued telemetry and reports the before/after queue state. */
-const runTelemetryFlush = async (_options, context) => {
-    const before = await buildTelemetryStatusSummary(context.globalPmRoot);
-    await flushTelemetryQueueNow(context.globalPmRoot);
-    const after = await buildTelemetryStatusSummary(context.globalPmRoot);
-    const queueEntriesDrained = Math.max(0, before.queue_entries - after.queue_entries);
-    const queueEmpty = after.queue_entries === 0;
-    return {
-        action: "telemetry",
-        subcommand: "flush",
-        queue_entries_before: before.queue_entries,
-        queue_entries_after: after.queue_entries,
-        queue_entries_drained: queueEntriesDrained,
-        queue_progressed: queueEntriesDrained > 0,
-        queue_empty: queueEmpty,
-        queue_drained: queueEmpty,
-        status: after,
-        generated_at: nowIso(),
-    };
-};
-/** Aggregates the offline telemetry queue into bounded command statistics. */
-const runTelemetryStats = async (options, context) => {
-    const limit = parseTelemetryStatsLimit(options.limit);
-    const queueRaw = await readFileIfExists(context.queuePath);
-    const queue = parseTelemetryQueue(queueRaw);
-    const buckets = buildTelemetryStatsBuckets(queue.entries);
-    const selected = buckets.slice(0, limit);
-    return {
-        action: "telemetry",
-        subcommand: "stats",
-        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(),
-    };
-};
-/** Clears local telemetry consent identifiers, queue data, and runtime state. */
-const runTelemetryClear = async (_options, context) => {
-    const settings = await readSettings(context.globalPmRoot);
-    const settingsChanged = [
-        settings.telemetry.enabled !== false,
-        settings.telemetry.installation_id !== "",
-        settings.telemetry.first_run_prompt_completed !== true,
-    ].includes(true);
-    settings.telemetry.enabled = false;
-    settings.telemetry.first_run_prompt_completed = true;
-    settings.telemetry.installation_id = "";
-    if (settingsChanged) {
-        await writeSettings(context.globalPmRoot, settings, "telemetry:clear");
-    }
-    const telemetryRuntimePath = path.join(context.globalPmRoot, TELEMETRY_RUNTIME_RELATIVE_PATH);
-    const existed = await pathExists(telemetryRuntimePath);
-    await fs.rm(telemetryRuntimePath, { recursive: true, force: true });
-    return {
-        action: "telemetry",
-        subcommand: "clear",
-        settings_changed: settingsChanged,
-        runtime_dir_removed: existed && !(await pathExists(telemetryRuntimePath)),
-        queue_exists_after: await pathExists(context.queuePath),
-        state_exists_after: await pathExists(context.statePath),
-        status: await buildTelemetryStatusSummary(context.globalPmRoot),
-        generated_at: nowIso(),
-    };
-};
-const TELEMETRY_COMMAND_HANDLERS = {
-    status: runTelemetryStatus,
-    flush: runTelemetryFlush,
-    stats: runTelemetryStats,
-    clear: runTelemetryClear,
-};
-/** Implements the telemetry runtime overloads. */
-export async function runTelemetry(options, _global) {
-    void _global;
-    const subcommand = normalizeTelemetrySubcommand(options.subcommand);
-    const globalPmRoot = resolveGlobalPmRoot(process.cwd());
-    return TELEMETRY_COMMAND_HANDLERS[subcommand](options, {
-        globalPmRoot,
-        queuePath: path.join(globalPmRoot, TELEMETRY_QUEUE_RELATIVE_PATH),
-        statePath: path.join(globalPmRoot, TELEMETRY_STATE_RELATIVE_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]="32a15ab4-82a2-546f-8519-d4e565e7b578")}catch(e2){}})();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";import{createUnknownSubcommandError}from"./agent/subcommand-recovery.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;const TELEMETRY_SUBCOMMANDS=["status","flush","stats","clear"];const nearestRankPercentile=(sortedAscending,fraction)=>{const rank=Math.ceil(fraction*sortedAscending.length);const index=Math.min(sortedAscending.length-1,Math.max(0,rank-1));return sortedAscending[index]};const normalizeTelemetryText=(value,fallback)=>{if(typeof value!=="string"){return fallback}return value.trim().length>0?value:fallback};const normalizeFiniteInteger=value=>{if(typeof value!=="number"||!Number.isFinite(value)){return void 0}return Math.trunc(value)};const normalizeTelemetryQueueEntry=entry=>{return{command:normalizeTelemetryText(entry.event.command,"<unknown>"),eventType:normalizeTelemetryText(entry.event.event_type,"unknown"),eventSchemaVersion:normalizeFiniteInteger(entry.event.schema_version),clientSchemaVersion:normalizeFiniteInteger(entry.client_schema_version)}};const createTelemetryStatsAccumulator=()=>{return{count:0,max_attempts:0,event_type_counts:{},event_schema_versions:new Set,client_schema_versions:new Set,finish_durations_ms:[],ok_count:0,error_count:0,resolution_counts:{}}};const readTelemetryDuration=payload=>{const value=payload?.duration_ms;return typeof value==="number"&&Number.isFinite(value)?value:void 0};const readTelemetryResolution=payload=>{const value=payload?.command_resolution;return normalizeTelemetryText(value,"")||void 0};const incrementTelemetryCount=(counts,key)=>{counts[key]=(counts[key]??0)+1};const recordTelemetryFinishPayload=(current,payload)=>{const durationMs=readTelemetryDuration(payload);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=readTelemetryResolution(payload);if(resolution!==void 0){incrementTelemetryCount(current.resolution_counts,resolution)}};const normalizeTelemetryAttempts=attempts=>Number.isFinite(attempts)?Math.max(0,Math.trunc(attempts)):0;const addTelemetryDimension=(values,value)=>{if(value!==void 0){values.add(value)}};const recordTelemetryQueueEntry=(grouped,entry)=>{const normalized=normalizeTelemetryQueueEntry(entry);const current=grouped.get(normalized.command)??createTelemetryStatsAccumulator();current.count+=1;current.max_attempts=Math.max(current.max_attempts,normalizeTelemetryAttempts(entry.attempts));incrementTelemetryCount(current.event_type_counts,normalized.eventType);addTelemetryDimension(current.event_schema_versions,normalized.eventSchemaVersion);addTelemetryDimension(current.client_schema_versions,normalized.clientSchemaVersion);if(normalized.eventType==="command_finish"){recordTelemetryFinishPayload(current,entry.event.payload)}grouped.set(normalized.command,current)};const 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,.5),duration_p95_ms:nearestRankPercentile(sortedDurations,.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)}:{}}};const normalizeTelemetrySubcommand=value=>{const normalized=(value??"status").trim().toLowerCase();if(TELEMETRY_SUBCOMMANDS.includes(normalized)){return normalized}throw createUnknownSubcommandError({command_path:"telemetry",token:value?.trim()||"<empty>",allowed:TELEMETRY_SUBCOMMANDS,examples:["pm telemetry status","pm telemetry flush","pm telemetry stats --limit 10","pm telemetry clear"]})};const throwInvalidTelemetryLimit=()=>{throw new PmCliError("--limit must be a positive integer",EXIT_CODE.USAGE)};const requirePositiveTelemetryLimit=value=>{if([!Number.isFinite(value),!Number.isInteger(value),value<=0].includes(true)){return throwInvalidTelemetryLimit()}return value};const parseTelemetryStringLimit=raw=>{const trimmed=raw.trim();if([trimmed.length===0,!/^\d+$/.test(trimmed)].includes(true)){return throwInvalidTelemetryLimit()}return requirePositiveTelemetryLimit(Number.parseInt(trimmed,10))};const parseTelemetryStatsLimit=raw=>{if(raw===void 0){return DEFAULT_STATS_LIMIT}if(typeof raw==="number"){return requirePositiveTelemetryLimit(raw)}if(typeof raw==="string"){return parseTelemetryStringLimit(raw)}return throwInvalidTelemetryLimit()};const isTelemetryQueueEntry=value=>{if(typeof value!=="object"||value===null){return false}const candidate=value;return typeof candidate.attempts==="number"&&typeof candidate.event==="object"&&candidate.event!==null};const parseTelemetryQueueRow=row=>{try{const parsed=JSON.parse(row);return isTelemetryQueueEntry(parsed)?parsed:void 0}catch{return void 0}};const splitTelemetryQueueRows=raw=>{if(raw===null){return[]}return raw.split("\n").map(line=>line.trim()).filter(line=>line.length>0)};const parseTelemetryQueue=raw=>{const rows=splitTelemetryQueueRows(raw);const entries=[];let invalidRows=0;for(const row of rows){const parsed=parseTelemetryQueueRow(row);if(parsed===void 0){invalidRows+=1}else{entries.push(parsed)}}return{rows_total:rows.length,valid_entries:entries.length,invalid_rows:invalidRows,entries}};const isTelemetryRuntimeState=value=>typeof value==="object"&&value!==null&&!Array.isArray(value);const parseTelemetryRuntimeState=raw=>{try{const parsed=JSON.parse(raw);return isTelemetryRuntimeState(parsed)?parsed:{}}catch{return{}}};const readTelemetryRuntimeState=async statePath=>{const stateRaw=await readFileIfExists(statePath);if(stateRaw===null||stateRaw.trim().length===0){return{}}return parseTelemetryRuntimeState(stateRaw)};const nullableTelemetryStateValue=value=>value??null;const buildTelemetryStatusSummary=async 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:Buffer.byteLength(queueRaw??"","utf8"),last_attempted_flush_at:nullableTelemetryStateValue(runtimeState.last_attempted_flush_at),last_successful_flush_at:nullableTelemetryStateValue(runtimeState.last_successful_flush_at),last_failed_flush_at:nullableTelemetryStateValue(runtimeState.last_failed_flush_at),last_failed_flush_error:nullableTelemetryStateValue(runtimeState.last_failed_flush_error)}};const buildTelemetryStatsBuckets=entries=>{const grouped=new Map;for(const entry of entries){recordTelemetryQueueEntry(grouped,entry)}return[...grouped.entries()].map(([command,value])=>buildTelemetryStatsBucket(command,value)).sort((left,right)=>right.count-left.count||left.command.localeCompare(right.command))};const runTelemetryStatus=async(_options,context)=>({action:"telemetry",subcommand:"status",status:await buildTelemetryStatusSummary(context.globalPmRoot),generated_at:nowIso()});const runTelemetryFlush=async(_options,context)=>{const before=await buildTelemetryStatusSummary(context.globalPmRoot);await flushTelemetryQueueNow(context.globalPmRoot);const after=await buildTelemetryStatusSummary(context.globalPmRoot);const queueEntriesDrained=Math.max(0,before.queue_entries-after.queue_entries);const queueEmpty=after.queue_entries===0;return{action:"telemetry",subcommand:"flush",queue_entries_before:before.queue_entries,queue_entries_after:after.queue_entries,queue_entries_drained:queueEntriesDrained,queue_progressed:queueEntriesDrained>0,queue_empty:queueEmpty,queue_drained:queueEmpty,status:after,generated_at:nowIso()}};const runTelemetryStats=async(options,context)=>{const limit=parseTelemetryStatsLimit(options.limit);const queueRaw=await readFileIfExists(context.queuePath);const queue=parseTelemetryQueue(queueRaw);const buckets=buildTelemetryStatsBuckets(queue.entries);const selected=buckets.slice(0,limit);return{action:"telemetry",subcommand:"stats",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 runTelemetryClear=async(_options,context)=>{const settings=await readSettings(context.globalPmRoot);const settingsChanged=[settings.telemetry.enabled!==false,settings.telemetry.installation_id!=="",settings.telemetry.first_run_prompt_completed!==true].includes(true);settings.telemetry.enabled=false;settings.telemetry.first_run_prompt_completed=true;settings.telemetry.installation_id="";if(settingsChanged){await writeSettings(context.globalPmRoot,settings,"telemetry:clear")}const telemetryRuntimePath=path.join(context.globalPmRoot,TELEMETRY_RUNTIME_RELATIVE_PATH);const existed=await pathExists(telemetryRuntimePath);await fs.rm(telemetryRuntimePath,{recursive:true,force:true});return{action:"telemetry",subcommand:"clear",settings_changed:settingsChanged,runtime_dir_removed:existed&&!await pathExists(telemetryRuntimePath),queue_exists_after:await pathExists(context.queuePath),state_exists_after:await pathExists(context.statePath),status:await buildTelemetryStatusSummary(context.globalPmRoot),generated_at:nowIso()}};const TELEMETRY_COMMAND_HANDLERS={status:runTelemetryStatus,flush:runTelemetryFlush,stats:runTelemetryStats,clear:runTelemetryClear};async function runTelemetry(options,_global){void _global;const subcommand=normalizeTelemetrySubcommand(options.subcommand);const globalPmRoot=resolveGlobalPmRoot(process.cwd());return TELEMETRY_COMMAND_HANDLERS[subcommand](options,{globalPmRoot,queuePath:path.join(globalPmRoot,TELEMETRY_QUEUE_RELATIVE_PATH),statePath:path.join(globalPmRoot,TELEMETRY_STATE_RELATIVE_PATH)})}export{TELEMETRY_SUBCOMMANDS,runTelemetry};
 //# sourceMappingURL=telemetry.js.map
-//# debugId=ad3110ca-e85b-5a7e-b0a1-591796c298eb