@proletariat/cli 0.3.52 → 0.3.54

package/dist/lib/signal-handler.js

@@ -0,0 +1,156 @@
+/**
+ * Centralized signal handler for graceful CLI shutdown
+ *
+ * Manages SIGINT (Ctrl+C) and SIGTERM handling across the CLI:
+ * - Runs registered cleanup callbacks in LIFO order
+ * - Kills tracked child processes
+ * - Exits with code 130 (standard Unix SIGINT convention)
+ * - Prevents ERR_USE_AFTER_CLOSE from dangling inquirer prompts
+ *
+ * Usage:
+ * ```typescript
+ * import { onShutdown, trackChildProcess } from '../lib/signal-handler.js'
+ *
+ * // Register cleanup (returns unregister function)
+ * const unregister = onShutdown(async () => {
+ *   db.close()
+ * })
+ *
+ * // Track a child process for automatic cleanup
+ * trackChildProcess(childProc)
+ * ```
+ */
+const cleanupCallbacks = [];
+const trackedProcesses = new Set();
+let isShuttingDown = false;
+let installed = false;
+/**
+ * Run all cleanup callbacks and exit.
+ * Called on SIGINT or SIGTERM.
+ */
+async function shutdown() {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    // Kill tracked child processes first
+    for (const child of trackedProcesses) {
+        try {
+            if (child.pid && !child.killed) {
+                child.kill('SIGTERM');
+            }
+        }
+        catch {
+            // Process may have already exited
+        }
+    }
+    trackedProcesses.clear();
+    // Run cleanup callbacks in LIFO order (most recent first)
+    const callbacks = [...cleanupCallbacks].reverse();
+    for (const cb of callbacks) {
+        try {
+            await cb();
+        }
+        catch {
+            // Swallow errors during cleanup
+        }
+    }
+    cleanupCallbacks.length = 0;
+    // Exit with 130 = 128 + 2 (SIGINT)
+    process.exit(130);
+}
+/**
+ * Install global signal handlers. Called once at CLI startup.
+ * Safe to call multiple times (idempotent).
+ */
+export function installSignalHandlers() {
+    if (installed)
+        return;
+    installed = true;
+    process.on('SIGINT', () => {
+        // Write a newline to avoid dangling prompt characters
+        if (process.stdout.isTTY) {
+            process.stdout.write('\n');
+        }
+        void shutdown();
+    });
+    process.on('SIGTERM', () => {
+        void shutdown();
+    });
+}
+/**
+ * Register a cleanup callback to run on shutdown.
+ * Callbacks run in LIFO order (most recently registered runs first).
+ *
+ * @returns Unregister function to remove the callback
+ */
+export function onShutdown(fn) {
+    cleanupCallbacks.push(fn);
+    return () => {
+        const idx = cleanupCallbacks.indexOf(fn);
+        if (idx !== -1) {
+            cleanupCallbacks.splice(idx, 1);
+        }
+    };
+}
+/**
+ * Track a child process for automatic cleanup on shutdown.
+ * The process will receive SIGTERM when the CLI exits.
+ *
+ * Automatically removes itself from tracking when it exits.
+ */
+export function trackChildProcess(child) {
+    trackedProcesses.add(child);
+    child.on('exit', () => {
+        trackedProcesses.delete(child);
+    });
+    child.on('error', () => {
+        trackedProcesses.delete(child);
+    });
+}
+/**
+ * Check if the process is currently shutting down.
+ * Useful for avoiding work after SIGINT.
+ */
+export function isExiting() {
+    return isShuttingDown;
+}
+/**
+ * Wrap an inquirer prompt call to handle SIGINT gracefully.
+ * On SIGINT during a prompt, triggers the shutdown sequence
+ * instead of letting inquirer throw ERR_USE_AFTER_CLOSE.
+ *
+ * @param promptFn - Function that calls inquirer.prompt()
+ * @returns The prompt result
+ */
+export async function withSignalSafePrompt(promptFn) {
+    if (isShuttingDown) {
+        // If already shutting down, just exit
+        process.exit(130);
+    }
+    try {
+        return await promptFn();
+    }
+    catch (error) {
+        // Check if this is a prompt close error from SIGINT
+        if (isShuttingDown) {
+            // We're already in shutdown, just wait for it
+            await new Promise(() => {
+                // Never resolves - shutdown() will call process.exit
+            });
+            // Unreachable, but satisfies TypeScript
+            throw error;
+        }
+        // Check for readline/inquirer close errors that indicate SIGINT
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes('ERR_USE_AFTER_CLOSE') ||
+            message.includes('readline was closed')) {
+            // Inquirer's readline was closed by SIGINT - trigger clean shutdown
+            void shutdown();
+            await new Promise(() => { });
+            throw error; // Unreachable
+        }
+        // Re-throw other errors normally
+        throw error;
+    }
+}
+//# sourceMappingURL=signal-handler.js.map

package/dist/lib/signal-handler.js.map

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

package/dist/lib/string-utils.js

@@ -14,3 +14,4 @@ export function visualPadEnd(str, width) {
         return str;
     return str + ' '.repeat(width - visWidth);
 }
+//# sourceMappingURL=string-utils.js.map

package/dist/lib/string-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../src/lib/string-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,WAAW,MAAM,cAAc,CAAA;AAEtC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAAa;IACrD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,QAAQ,IAAI,KAAK;QAAE,OAAO,GAAG,CAAA;IACjC,OAAO,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAA;AAC3C,CAAC"}

package/dist/lib/styles.js

@@ -266,3 +266,4 @@ export function getPrefix(type) {
     }
     return prefix[type];
 }
+//# sourceMappingURL=styles.js.map

package/dist/lib/styles.js.map

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

package/dist/lib/telemetry/analytics.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Product Analytics (Statsig) & Event Tracking
+ *
+ * Provides anonymous usage analytics for the CLI using Statsig client SDK.
+ * All data is anonymous — identified by a machine UUID only, no PII is ever sent.
+ *
+ * Telemetry can be disabled via:
+ * - `prlt telemetry disable`
+ * - `DO_NOT_TRACK=1` environment variable
+ * - `PRLT_TELEMETRY_DISABLED=1` environment variable
+ *
+ * Privacy:
+ * - Anonymous machine ID (UUID) stored in ~/.proletariat/telemetry.json
+ * - No file paths, usernames, or ticket content ever sent
+ * - Events are fired async and never block command execution
+ */
+/**
+ * Check if telemetry is disabled by environment variables or config.
+ */
+export declare function isTelemetryEnabled(): boolean;
+/**
+ * Enable telemetry.
+ */
+export declare function enableTelemetry(): void;
+/**
+ * Disable telemetry.
+ */
+export declare function disableTelemetry(): void;
+/**
+ * Get current telemetry status for display.
+ */
+export declare function getTelemetryStatus(): {
+    enabled: boolean;
+    machineId: string;
+    envOverride: boolean;
+    envVar?: string;
+};
+/**
+ * Get the anonymous machine ID for this installation.
+ */
+export declare function getMachineId(): string;
+/**
+ * Initialize the Statsig SDK. Called from the init hook.
+ * No-op if telemetry is disabled.
+ */
+export declare function initAnalytics(version: string): Promise<void>;
+/**
+ * Track an analytics event. Fire-and-forget — never blocks.
+ *
+ * @param eventName - Event name (e.g., 'command_run')
+ * @param value - Optional numeric or string value
+ * @param metadata - Event-specific metadata
+ */
+export declare function trackEvent(eventName: string, value?: string | number | null, metadata?: Record<string, unknown> | null): void;
+/**
+ * Track a command execution.
+ */
+export declare function trackCommandRun(options: {
+    command: string;
+    durationMs: number;
+    success: boolean;
+    flags?: string[];
+}): void;
+/**
+ * Track an agent being spawned.
+ */
+export declare function trackAgentSpawned(options: {
+    executor: string;
+    environment: string;
+    action: string;
+    ephemeral: boolean;
+}): void;
+/**
+ * Track an orchestrator being started.
+ */
+export declare function trackOrchestratorStarted(options: {
+    executor: string;
+    name: string;
+    displayMode: string;
+}): void;
+/**
+ * Track work being completed.
+ */
+export declare function trackWorkCompleted(options: {
+    durationMs: number;
+    prCreated: boolean;
+}): void;
+/**
+ * Track a PR being created.
+ */
+export declare function trackPRCreated(options: {
+    source: 'prlt' | 'manual';
+}): void;
+/**
+ * Track an MCP tool call.
+ */
+export declare function trackMCPToolCalled(options: {
+    toolName: string;
+    success: boolean;
+}): void;
+/**
+ * Flush pending events and shut down the Statsig client.
+ * Called from the postrun hook. Times out to avoid blocking CLI exit.
+ */
+export declare function shutdownAnalytics(): Promise<void>;

package/dist/lib/telemetry/analytics.js

@@ -0,0 +1,289 @@
+/**
+ * Product Analytics (Statsig) & Event Tracking
+ *
+ * Provides anonymous usage analytics for the CLI using Statsig client SDK.
+ * All data is anonymous — identified by a machine UUID only, no PII is ever sent.
+ *
+ * Telemetry can be disabled via:
+ * - `prlt telemetry disable`
+ * - `DO_NOT_TRACK=1` environment variable
+ * - `PRLT_TELEMETRY_DISABLED=1` environment variable
+ *
+ * Privacy:
+ * - Anonymous machine ID (UUID) stored in ~/.proletariat/telemetry.json
+ * - No file paths, usernames, or ticket content ever sent
+ * - Events are fired async and never block command execution
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+import { getMachineConfigDir, ensureMachineConfigDir } from '../machine-config.js';
+// Statsig client SDK key (public — safe to embed in open source repos)
+const STATSIG_CLIENT_KEY = 'client-kvxMxRhn9NFSmH8orl7e2W9nYTfWVS7Kjf7yRTdIecc';
+// Flush timeout — don't let analytics delay CLI exit
+const FLUSH_TIMEOUT_MS = 2000;
+// Module-level state
+let statsigClient = null;
+let telemetryConfig = null;
+let cliVersion = null;
+// ─── Telemetry Config ────────────────────────────────────────────────────────
+function getTelemetryConfigPath() {
+    return path.join(getMachineConfigDir(), 'telemetry.json');
+}
+function readTelemetryConfig() {
+    if (telemetryConfig)
+        return telemetryConfig;
+    const configPath = getTelemetryConfigPath();
+    if (fs.existsSync(configPath)) {
+        try {
+            const content = fs.readFileSync(configPath, 'utf-8');
+            telemetryConfig = JSON.parse(content);
+            return telemetryConfig;
+        }
+        catch {
+            // Fall through to create new config
+        }
+    }
+    // Create new config with generated machine ID
+    telemetryConfig = {
+        enabled: true,
+        noticeShown: false,
+        machineId: crypto.randomUUID(),
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+    };
+    writeTelemetryConfig(telemetryConfig);
+    return telemetryConfig;
+}
+function writeTelemetryConfig(config) {
+    ensureMachineConfigDir();
+    const configPath = getTelemetryConfigPath();
+    const tempPath = `${configPath}.tmp.${process.pid}`;
+    try {
+        fs.writeFileSync(tempPath, JSON.stringify(config, null, 2), 'utf-8');
+        fs.renameSync(tempPath, configPath);
+    }
+    catch {
+        try {
+            if (fs.existsSync(tempPath))
+                fs.unlinkSync(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+// ─── Opt-out Detection ───────────────────────────────────────────────────────
+/**
+ * Check if telemetry is disabled by environment variables or config.
+ */
+export function isTelemetryEnabled() {
+    // Environment variable opt-outs (standard + prlt-specific)
+    if (process.env.DO_NOT_TRACK === '1' || process.env.DO_NOT_TRACK === 'true')
+        return false;
+    if (process.env.PRLT_TELEMETRY_DISABLED === '1' || process.env.PRLT_TELEMETRY_DISABLED === 'true')
+        return false;
+    // Config-based opt-out
+    const config = readTelemetryConfig();
+    return config.enabled;
+}
+/**
+ * Enable telemetry.
+ */
+export function enableTelemetry() {
+    const config = readTelemetryConfig();
+    config.enabled = true;
+    config.updatedAt = new Date().toISOString();
+    telemetryConfig = config;
+    writeTelemetryConfig(config);
+}
+/**
+ * Disable telemetry.
+ */
+export function disableTelemetry() {
+    const config = readTelemetryConfig();
+    config.enabled = false;
+    config.updatedAt = new Date().toISOString();
+    telemetryConfig = config;
+    writeTelemetryConfig(config);
+}
+/**
+ * Get current telemetry status for display.
+ */
+export function getTelemetryStatus() {
+    const config = readTelemetryConfig();
+    // Check for env var overrides
+    if (process.env.DO_NOT_TRACK === '1' || process.env.DO_NOT_TRACK === 'true') {
+        return { enabled: false, machineId: config.machineId, envOverride: true, envVar: 'DO_NOT_TRACK' };
+    }
+    if (process.env.PRLT_TELEMETRY_DISABLED === '1' || process.env.PRLT_TELEMETRY_DISABLED === 'true') {
+        return { enabled: false, machineId: config.machineId, envOverride: true, envVar: 'PRLT_TELEMETRY_DISABLED' };
+    }
+    return { enabled: config.enabled, machineId: config.machineId, envOverride: false };
+}
+// ─── First-Run Notice ────────────────────────────────────────────────────────
+/**
+ * Show a one-time notice that telemetry is active.
+ * Only shown in interactive TTY sessions.
+ */
+function showTelemetryNotice() {
+    const config = readTelemetryConfig();
+    if (config.noticeShown)
+        return;
+    if (!process.stdout.isTTY) {
+        // Mark as shown so we don't try again, but don't print in non-TTY
+        config.noticeShown = true;
+        writeTelemetryConfig(config);
+        return;
+    }
+    console.log('');
+    console.log('Proletariat collects anonymous usage analytics to improve the CLI.');
+    console.log('Only command names and durations are tracked — no values, arguments, or personal data.');
+    console.log('You can opt out at any time:');
+    console.log('');
+    console.log('  prlt telemetry disable');
+    console.log('');
+    config.noticeShown = true;
+    telemetryConfig = config;
+    writeTelemetryConfig(config);
+}
+// ─── Machine ID ──────────────────────────────────────────────────────────────
+/**
+ * Get the anonymous machine ID for this installation.
+ */
+export function getMachineId() {
+    return readTelemetryConfig().machineId;
+}
+// ─── Statsig Client ──────────────────────────────────────────────────────────
+/**
+ * Initialize the Statsig SDK. Called from the init hook.
+ * No-op if telemetry is disabled.
+ */
+export async function initAnalytics(version) {
+    cliVersion = version;
+    if (!isTelemetryEnabled())
+        return;
+    showTelemetryNotice();
+    try {
+        const { StatsigClient: StatsigClientClass } = await import('@statsig/js-client');
+        const client = new StatsigClientClass(STATSIG_CLIENT_KEY, { userID: getMachineId(), custom: { cli_version: version } });
+        await client.initializeAsync();
+        statsigClient = client;
+        // Share Statsig client with feature-flags for synchronous gate checks
+        const { setStatsigClient } = await import('./feature-flags.js');
+        setStatsigClient(client);
+    }
+    catch {
+        // If Statsig can't initialize, fail silently — analytics should never break the CLI
+        statsigClient = null;
+    }
+}
+// ─── Event Tracking ──────────────────────────────────────────────────────────
+/**
+ * Track an analytics event. Fire-and-forget — never blocks.
+ *
+ * @param eventName - Event name (e.g., 'command_run')
+ * @param value - Optional numeric or string value
+ * @param metadata - Event-specific metadata
+ */
+export function trackEvent(eventName, value, metadata) {
+    if (!statsigClient || !isTelemetryEnabled())
+        return;
+    try {
+        // Convert metadata values to strings as required by the client SDK
+        const stringMetadata = metadata
+            ? Object.fromEntries(Object.entries({ ...metadata, cli_version: cliVersion }).map(([k, v]) => [k, String(v)]))
+            : cliVersion
+                ? { cli_version: cliVersion }
+                : null;
+        statsigClient.logEvent(eventName, value, stringMetadata);
+    }
+    catch {
+        // Never let analytics errors affect the CLI
+    }
+}
+/**
+ * Track a command execution.
+ */
+export function trackCommandRun(options) {
+    trackEvent('command_run', options.durationMs, {
+        command: options.command,
+        success: options.success,
+        flags_used: (options.flags ?? []).join(','),
+    });
+}
+/**
+ * Track an agent being spawned.
+ */
+export function trackAgentSpawned(options) {
+    trackEvent('agent_spawned', null, {
+        executor: options.executor,
+        environment: options.environment,
+        action: options.action,
+        ephemeral: String(options.ephemeral),
+    });
+}
+/**
+ * Track an orchestrator being started.
+ */
+export function trackOrchestratorStarted(options) {
+    trackEvent('orchestrator_started', null, {
+        executor: options.executor,
+        name: options.name,
+        display_mode: options.displayMode,
+    });
+}
+/**
+ * Track work being completed.
+ */
+export function trackWorkCompleted(options) {
+    trackEvent('work_completed', options.durationMs, {
+        pr_created: String(options.prCreated),
+    });
+}
+/**
+ * Track a PR being created.
+ */
+export function trackPRCreated(options) {
+    trackEvent('pr_created', null, {
+        source: options.source,
+    });
+}
+/**
+ * Track an MCP tool call.
+ */
+export function trackMCPToolCalled(options) {
+    trackEvent('mcp_tool_called', null, {
+        tool_name: options.toolName,
+        success: String(options.success),
+    });
+}
+// ─── Shutdown ────────────────────────────────────────────────────────────────
+/**
+ * Flush pending events and shut down the Statsig client.
+ * Called from the postrun hook. Times out to avoid blocking CLI exit.
+ */
+export async function shutdownAnalytics() {
+    if (!statsigClient)
+        return;
+    try {
+        // Give the client a moment to flush, but don't block the CLI
+        await new Promise((resolve) => setTimeout(resolve, FLUSH_TIMEOUT_MS));
+        statsigClient.shutdown();
+    }
+    catch {
+        // Never let shutdown errors affect the CLI
+    }
+    finally {
+        statsigClient = null;
+        // Clear feature-flags module reference
+        try {
+            const { setStatsigClient } = await import('./feature-flags.js');
+            setStatsigClient(null);
+        }
+        catch {
+            // Ignore
+        }
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/lib/telemetry/analytics.js.map

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

package/dist/lib/telemetry/feature-flags.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Feature Flags (Statsig Feature Gates)
+ *
+ * Wraps Statsig feature gate checks with a simple API for the CLI.
+ * Feature flags are evaluated locally after SDK initialization,
+ * so checks are near-instant after the initial fetch.
+ *
+ * Usage:
+ *   import { isEnabled } from '../lib/telemetry/feature-flags.js'
+ *   if (isEnabled('new_board_view')) { ... }
+ *
+ * Feature flags require Statsig to be initialized (via initAnalytics).
+ * If Statsig is unavailable or telemetry is disabled, all flags return false.
+ */
+interface StatsigClientRef {
+    checkGate(gateName: string): boolean;
+    getDynamicConfig(configName: string): {
+        get(key: string, defaultValue: unknown): unknown;
+    };
+}
+/**
+ * Set the Statsig client reference (called from analytics.ts after init).
+ * @internal
+ */
+export declare function setStatsigClient(client: StatsigClientRef | null): void;
+/**
+ * Check if a feature gate is enabled for the current machine.
+ *
+ * Uses Statsig's local evaluation (near-zero latency after init).
+ * Returns false if Statsig is not initialized or telemetry is disabled.
+ *
+ * @param gateName - The feature gate name (e.g., 'new_board_view')
+ * @returns Whether the gate is enabled
+ */
+export declare function isEnabled(gateName: string): boolean;
+/**
+ * Get a dynamic config value from Statsig.
+ *
+ * Useful for remote configuration (not just boolean flags).
+ * Returns the default value if Statsig is unavailable.
+ *
+ * @param configName - The dynamic config name
+ * @param key - The key within the config
+ * @param defaultValue - Default value if unavailable
+ * @returns The config value, or the default
+ */
+export declare function getConfigValue<T>(configName: string, key: string, defaultValue: T): T;
+/**
+ * Clear the local flag cache.
+ * Useful for testing or when you want to force re-evaluation.
+ */
+export declare function clearFlagCache(): void;
+export {};