@unbrained/pm-cli 2026.3.12 → 2026.5.1

package/dist/core/telemetry/consent.js

@@ -0,0 +1,79 @@
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { resolveGlobalPmRoot } from "../store/paths.js";
+import { readSettings, writeSettings } from "../store/settings.js";
+const TELEMETRY_PROMPT_DISABLE_ENV = "PM_TELEMETRY_PROMPT";
+const TELEMETRY_PROMPT_DISABLE_VALUES = new Set(["0", "false", "no", "off"]);
+const TELEMETRY_PROMPT_SKIPPED_COMMANDS = new Set(["init", "completion", "completion-tags"]);
+function parseBooleanLike(value) {
+    if (typeof value !== "string") {
+        return false;
+    }
+    return TELEMETRY_PROMPT_DISABLE_VALUES.has(value.trim().toLowerCase());
+}
+function shouldSkipTelemetryPrompt(commandPath, globalOptions) {
+    if (globalOptions.json === true || globalOptions.quiet === true) {
+        return true;
+    }
+    if (process.stdin.isTTY !== true || process.stdout.isTTY !== true) {
+        return true;
+    }
+    if (parseBooleanLike(process.env[TELEMETRY_PROMPT_DISABLE_ENV])) {
+        return true;
+    }
+    if (parseBooleanLike(process.env.CI)) {
+        return true;
+    }
+    const normalizedCommandPath = commandPath.trim().toLowerCase();
+    if (normalizedCommandPath.length === 0) {
+        return true;
+    }
+    return TELEMETRY_PROMPT_SKIPPED_COMMANDS.has(normalizedCommandPath);
+}
+function parseTelemetryPromptAnswer(answer) {
+    const normalized = answer.trim().toLowerCase();
+    if (normalized === "n" || normalized === "no") {
+        return false;
+    }
+    return true;
+}
+async function promptTelemetryConsent(currentDefault) {
+    const defaultLabel = currentDefault ? "Y/n" : "y/N";
+    const prompt = `pm telemetry helps improve reliability and usage diagnostics.\n` +
+        `It is enabled by default and can be changed anytime via:\n` +
+        `pm config global set telemetry-tracking --policy disabled\n` +
+        `Enable telemetry now? [${defaultLabel}] `;
+    const rl = readline.createInterface({ input, output });
+    try {
+        const answer = await rl.question(prompt);
+        if (answer.trim().length === 0) {
+            return currentDefault;
+        }
+        return parseTelemetryPromptAnswer(answer);
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function maybeRunFirstUseTelemetryPrompt(commandPath, globalOptions) {
+    if (shouldSkipTelemetryPrompt(commandPath, globalOptions)) {
+        return;
+    }
+    try {
+        const globalPmRoot = resolveGlobalPmRoot(process.cwd());
+        const settings = await readSettings(globalPmRoot);
+        if (settings.telemetry.first_run_prompt_completed) {
+            return;
+        }
+        const enabled = await promptTelemetryConsent(settings.telemetry.enabled);
+        settings.telemetry.enabled = enabled;
+        settings.telemetry.first_run_prompt_completed = true;
+        await writeSettings(globalPmRoot, settings, "telemetry:first_run_prompt");
+        output.write(`Telemetry ${enabled ? "enabled" : "disabled"} for this CLI install. ` +
+            `Update any time with pm config global set telemetry-tracking --policy ${enabled ? "disabled" : "enabled"}.\n`);
+    }
+    catch {
+        // Prompt and persistence failures should never block command execution.
+    }
+}
+//# sourceMappingURL=consent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../../src/core/telemetry/consent.ts"],"names":[],"mappings":"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"}

package/dist/core/telemetry/runtime.d.ts

@@ -0,0 +1,38 @@
+import type { GlobalOptions } from "../shared/command-types.js";
+declare const PM_TELEMETRY_SOURCE_CONTEXT_VALUES: readonly ["user", "automation", "test", "dogfood", "audit_smoke"];
+type TelemetryCaptureLevel = "minimal" | "redacted" | "max";
+type TelemetrySourceContext = (typeof PM_TELEMETRY_SOURCE_CONTEXT_VALUES)[number];
+type TelemetrySourceContextSource = "inferred" | "env_override";
+export interface ActiveTelemetryCommand {
+    started_at: string;
+    started_at_ms: number;
+    command: string;
+    pm_version: string;
+    source_context: TelemetrySourceContext;
+    source_context_source: TelemetrySourceContextSource;
+    installation_id: string;
+    pm_root_hash: string;
+    cwd_hash: string;
+    endpoint: string;
+    retention_days: number;
+    global_pm_root: string;
+    capture_level: TelemetryCaptureLevel;
+    otel_traces_endpoint?: string;
+    otel_trace_id?: string;
+    otel_span_id?: string;
+}
+export interface TelemetryCommandContext {
+    command: string;
+    pm_version: string;
+    args: string[];
+    options: Record<string, unknown>;
+    global: GlobalOptions;
+    pm_root: string;
+}
+export declare function startTelemetryCommand(context: TelemetryCommandContext): Promise<ActiveTelemetryCommand | null>;
+export declare function finishTelemetryCommand(activeCommand: ActiveTelemetryCommand | null, outcome: {
+    ok: boolean;
+    error?: string;
+    result?: unknown;
+}): Promise<void>;
+export {};