@nockdev/cli 1.0.0

package/dist/utils/constants.js

@@ -0,0 +1,13 @@
+// packages/cli/src/utils/constants.ts
+// Single Source of Truth for CLI constants
+/** CLI version - SSoT */
+export const CLI_VERSION = "1.0.0";
+/** CLI name */
+export const CLI_NAME = "@nockdev/cli";
+/** Default plugins directory name */
+export const PLUGINS_DIR_NAME = "plugins";
+/** Manifest file name */
+export const MANIFEST_FILE = "plugins.json";
+/** NOCK home directory name */
+export const NOCK_DIR_NAME = ".nock";
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,2CAA2C;AAE3C,yBAAyB;AACzB,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,eAAe;AACf,MAAM,CAAC,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEvC,qCAAqC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAE1C,yBAAyB;AACzB,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,+BAA+B;AAC/B,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Display a usage error with consistent formatting
+ */
+export declare function showUsageError(message: string, usage: string, example?: string): void;
+/**
+ * Display a warning message
+ */
+export declare function showWarning(message: string): void;
+/**
+ * Display an info message
+ */
+export declare function showInfo(message: string): void;
+/**
+ * Display a success message
+ */
+export declare function showSuccess(message: string): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAMrF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD"}

package/dist/utils/errors.js

@@ -0,0 +1,32 @@
+// packages/cli/src/utils/errors.ts
+// Error handling utilities
+import pc from "picocolors";
+/**
+ * Display a usage error with consistent formatting
+ */
+export function showUsageError(message, usage, example) {
+    console.error(pc.red(`Error: ${message}`));
+    console.log(pc.dim(`Usage: ${usage}`));
+    if (example) {
+        console.log(pc.dim(`Example: ${example}`));
+    }
+}
+/**
+ * Display a warning message
+ */
+export function showWarning(message) {
+    console.warn(pc.yellow(`⚠ ${message}`));
+}
+/**
+ * Display an info message
+ */
+export function showInfo(message) {
+    console.log(pc.dim(message));
+}
+/**
+ * Display a success message
+ */
+export function showSuccess(message) {
+    console.log(pc.green(`✔ ${message}`));
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,2BAA2B;AAE3B,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,KAAa,EAAE,OAAgB;IAC7E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC;IACvC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/utils/exit-codes.d.ts

@@ -0,0 +1,22 @@
+export declare const EXIT_CODES: {
+    /** Successful execution */
+    readonly SUCCESS: 0;
+    /** General error */
+    readonly GENERAL_ERROR: 1;
+    /** Invalid command or arguments */
+    readonly INVALID_COMMAND: 2;
+    /** User cancelled operation (SIGINT) */
+    readonly USER_CANCEL: 130;
+    /** Plugin-related error */
+    readonly PLUGIN_ERROR: 10;
+    /** Network error */
+    readonly NETWORK_ERROR: 11;
+    /** Permission denied */
+    readonly PERMISSION_ERROR: 12;
+    /** Resource not found */
+    readonly NOT_FOUND: 13;
+    /** Configuration error */
+    readonly CONFIG_ERROR: 14;
+};
+export type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/utils/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/utils/exit-codes.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU;IACrB,2BAA2B;;IAE3B,oBAAoB;;IAEpB,mCAAmC;;IAEnC,wCAAwC;;IAExC,2BAA2B;;IAE3B,oBAAoB;;IAEpB,wBAAwB;;IAExB,yBAAyB;;IAEzB,0BAA0B;;CAElB,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}

package/dist/utils/exit-codes.js

@@ -0,0 +1,23 @@
+// packages/cli/src/utils/exit-codes.ts
+// Standard POSIX exit codes for CLI
+export const EXIT_CODES = {
+    /** Successful execution */
+    SUCCESS: 0,
+    /** General error */
+    GENERAL_ERROR: 1,
+    /** Invalid command or arguments */
+    INVALID_COMMAND: 2,
+    /** User cancelled operation (SIGINT) */
+    USER_CANCEL: 130,
+    /** Plugin-related error */
+    PLUGIN_ERROR: 10,
+    /** Network error */
+    NETWORK_ERROR: 11,
+    /** Permission denied */
+    PERMISSION_ERROR: 12,
+    /** Resource not found */
+    NOT_FOUND: 13,
+    /** Configuration error */
+    CONFIG_ERROR: 14,
+};
+//# sourceMappingURL=exit-codes.js.map

package/dist/utils/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/utils/exit-codes.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,oCAAoC;AAEpC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2BAA2B;IAC3B,OAAO,EAAE,CAAC;IACV,oBAAoB;IACpB,aAAa,EAAE,CAAC;IAChB,mCAAmC;IACnC,eAAe,EAAE,CAAC;IAClB,wCAAwC;IACxC,WAAW,EAAE,GAAG;IAChB,2BAA2B;IAC3B,YAAY,EAAE,EAAE;IAChB,oBAAoB;IACpB,aAAa,EAAE,EAAE;IACjB,wBAAwB;IACxB,gBAAgB,EAAE,EAAE;IACpB,yBAAyB;IACzB,SAAS,EAAE,EAAE;IACb,0BAA0B;IAC1B,YAAY,EAAE,EAAE;CACR,CAAC"}

package/dist/utils/manifest-cache.d.ts

@@ -0,0 +1,71 @@
+interface CachedCommand {
+    id: string;
+    name: string;
+    description: string;
+    aliases?: string[];
+    topic: string;
+}
+interface CachedPlugin {
+    name: string;
+    version: string;
+    topic: string;
+    description: string;
+    commands: CachedCommand[];
+    path: string;
+}
+export declare class ManifestCacheManager {
+    private cachePath;
+    private cache;
+    constructor();
+    /**
+     * Check if cache exists and is valid
+     */
+    isValid(): boolean;
+    /**
+     * Get cached plugins (fast lookup)
+     */
+    getPlugins(): CachedPlugin[] | null;
+    /**
+     * Get all commands from cache (fast lookup)
+     */
+    getCommands(): CachedCommand[] | null;
+    /**
+     * Find command by name or alias (O(n) but from cache)
+     */
+    findCommand(topic: string, name: string): CachedCommand | null;
+    /**
+     * Update cache with plugin data
+     */
+    update(plugins: Array<{
+        name: string;
+        version: string;
+        topic: string;
+        description: string;
+        commands: Array<{
+            name: string;
+            id: string;
+            description: string;
+            aliases?: string[];
+        }>;
+        path: string;
+    }>): void;
+    /**
+     * Invalidate cache (force reload on next run)
+     */
+    invalidate(): void;
+    /**
+     * Get cache stats for debugging
+     */
+    stats(): {
+        exists: boolean;
+        valid: boolean;
+        pluginCount: number;
+        commandCount: number;
+        age: string;
+    };
+    private read;
+    private write;
+}
+export declare const manifestCache: ManifestCacheManager;
+export {};
+//# sourceMappingURL=manifest-cache.d.ts.map

package/dist/utils/manifest-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-cache.d.ts","sourceRoot":"","sources":["../../src/utils/manifest-cache.ts"],"names":[],"mappings":"AAQA,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAWD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAA8B;;IAM3C;;OAEG;IACH,OAAO,IAAI,OAAO;IAelB;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE,GAAG,IAAI;IAKnC;;OAEG;IACH,WAAW,IAAI,aAAa,EAAE,GAAG,IAAI;IAMrC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAc9D;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;SACpB,CAAC,CAAC;QACH,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,GACD,IAAI;IAwBP;;OAEG;IACH,UAAU,IAAI,IAAI;IAWlB;;OAEG;IACH,KAAK,IAAI;QACP,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;KACb;IA4BD,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,KAAK;CAYd;AAGD,eAAO,MAAM,aAAa,sBAA6B,CAAC"}

package/dist/utils/manifest-cache.js

@@ -0,0 +1,154 @@
+// packages/cli/src/utils/manifest-cache.ts
+// Manifest Cache v1.0.0 - Fast Command Discovery
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { homedir } from "node:os";
+import { NOCK_DIR_NAME, CLI_VERSION } from "./constants.js";
+const MANIFEST_CACHE_FILE = "nock.manifest.json";
+export class ManifestCacheManager {
+    cachePath;
+    cache = null;
+    constructor() {
+        this.cachePath = path.join(homedir(), NOCK_DIR_NAME, MANIFEST_CACHE_FILE);
+    }
+    /**
+     * Check if cache exists and is valid
+     */
+    isValid() {
+        const cache = this.read();
+        if (!cache)
+            return false;
+        // Invalidate if CLI version changed
+        if (cache.cliVersion !== CLI_VERSION)
+            return false;
+        // Cache is valid for 24 hours
+        const lastUpdated = new Date(cache.lastUpdated).getTime();
+        const now = Date.now();
+        const maxAge = 24 * 60 * 60 * 1000; // 24 hours
+        return now - lastUpdated < maxAge;
+    }
+    /**
+     * Get cached plugins (fast lookup)
+     */
+    getPlugins() {
+        const cache = this.read();
+        return cache?.plugins || null;
+    }
+    /**
+     * Get all commands from cache (fast lookup)
+     */
+    getCommands() {
+        const plugins = this.getPlugins();
+        if (!plugins)
+            return null;
+        return plugins.flatMap((p) => p.commands);
+    }
+    /**
+     * Find command by name or alias (O(n) but from cache)
+     */
+    findCommand(topic, name) {
+        const plugins = this.getPlugins();
+        if (!plugins)
+            return null;
+        const plugin = plugins.find((p) => p.topic === topic);
+        if (!plugin)
+            return null;
+        return (plugin.commands.find((c) => c.name === name || c.aliases?.includes(name)) || null);
+    }
+    /**
+     * Update cache with plugin data
+     */
+    update(plugins) {
+        const cache = {
+            version: "1.0.0",
+            cliVersion: CLI_VERSION,
+            lastUpdated: new Date().toISOString(),
+            plugins: plugins.map((p) => ({
+                name: p.name,
+                version: p.version,
+                topic: p.topic,
+                description: p.description,
+                path: p.path,
+                commands: p.commands.map((c) => ({
+                    id: c.id,
+                    name: c.name,
+                    description: c.description,
+                    aliases: c.aliases,
+                    topic: p.topic,
+                })),
+            })),
+        };
+        this.write(cache);
+    }
+    /**
+     * Invalidate cache (force reload on next run)
+     */
+    invalidate() {
+        try {
+            if (fs.existsSync(this.cachePath)) {
+                fs.unlinkSync(this.cachePath);
+            }
+            this.cache = null;
+        }
+        catch {
+            // Ignore delete errors
+        }
+    }
+    /**
+     * Get cache stats for debugging
+     */
+    stats() {
+        const cache = this.read();
+        if (!cache) {
+            return {
+                exists: false,
+                valid: false,
+                pluginCount: 0,
+                commandCount: 0,
+                age: "N/A",
+            };
+        }
+        const lastUpdated = new Date(cache.lastUpdated);
+        const now = new Date();
+        const ageMs = now.getTime() - lastUpdated.getTime();
+        const ageMins = Math.floor(ageMs / 60000);
+        return {
+            exists: true,
+            valid: this.isValid(),
+            pluginCount: cache.plugins.length,
+            commandCount: cache.plugins.reduce((sum, p) => sum + p.commands.length, 0),
+            age: ageMins < 60 ? `${ageMins}m` : `${Math.floor(ageMins / 60)}h`,
+        };
+    }
+    // Private methods
+    read() {
+        if (this.cache)
+            return this.cache;
+        try {
+            if (fs.existsSync(this.cachePath)) {
+                this.cache = JSON.parse(fs.readFileSync(this.cachePath, "utf-8"));
+                return this.cache;
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+        return null;
+    }
+    write(cache) {
+        try {
+            const dir = path.dirname(this.cachePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(this.cachePath, JSON.stringify(cache, null, 2));
+            this.cache = cache;
+        }
+        catch {
+            // Ignore write errors
+        }
+    }
+}
+// Singleton instance
+export const manifestCache = new ManifestCacheManager();
+//# sourceMappingURL=manifest-cache.js.map

package/dist/utils/manifest-cache.js.map

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

package/dist/utils/official-plugins.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Official plugins that can be auto-installed when user tries to use them
+ */
+export declare const OFFICIAL_PLUGINS: Record<string, string>;
+/**
+ * Check if topic matches an official plugin
+ */
+export declare function getOfficialPlugin(topic: string): string | null;
+/**
+ * Get all official plugin topics
+ */
+export declare function getOfficialTopics(): string[];
+//# sourceMappingURL=official-plugins.d.ts.map

package/dist/utils/official-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-plugins.d.ts","sourceRoot":"","sources":["../../src/utils/official-plugins.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMnD,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C"}

package/dist/utils/official-plugins.js

@@ -0,0 +1,25 @@
+// packages/cli/src/utils/official-plugins.ts
+// Official Plugins Registry - Auto-install support
+/**
+ * Official plugins that can be auto-installed when user tries to use them
+ */
+export const OFFICIAL_PLUGINS = {
+    // Topic -> npm package name
+    awf: "@nockdev/awf", // AI Workflow Framework
+    hsa: "@nockdev/hsa", // Hierarchical Smart Agent (MCP Server)
+    // Future plugins:
+    // ui: "@nockdev/ui",     // UI Components
+};
+/**
+ * Check if topic matches an official plugin
+ */
+export function getOfficialPlugin(topic) {
+    return OFFICIAL_PLUGINS[topic] || null;
+}
+/**
+ * Get all official plugin topics
+ */
+export function getOfficialTopics() {
+    return Object.keys(OFFICIAL_PLUGINS);
+}
+//# sourceMappingURL=official-plugins.js.map

package/dist/utils/official-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-plugins.js","sourceRoot":"","sources":["../../src/utils/official-plugins.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,mDAAmD;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,4BAA4B;IAC5B,GAAG,EAAE,cAAc,EAAM,wBAAwB;IACjD,GAAG,EAAE,cAAc,EAAM,wCAAwC;IACjE,kBAAkB;IAClB,0CAA0C;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AACvC,CAAC"}

package/dist/utils/telemetry.d.ts

@@ -0,0 +1,58 @@
+interface TelemetryEvent {
+    event: string;
+    properties?: Record<string, unknown>;
+    timestamp: string;
+}
+export declare class Telemetry {
+    private configPath;
+    private eventsPath;
+    private config;
+    private startTime;
+    constructor();
+    /**
+     * Check if telemetry is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Enable telemetry
+     */
+    enable(): void;
+    /**
+     * Disable telemetry
+     */
+    disable(): void;
+    /**
+     * Get current status
+     */
+    status(): {
+        enabled: boolean;
+        eventCount: number;
+    };
+    /**
+     * Track command execution start
+     */
+    trackStart(_command: string): void;
+    /**
+     * Track command execution end
+     */
+    trackEnd(command: string, exitCode?: number): void;
+    /**
+     * Track custom event
+     */
+    track(event: string, properties?: Record<string, unknown>): void;
+    /**
+     * Flush events (for future remote sending)
+     */
+    flush(): TelemetryEvent[];
+    private getConfig;
+    private createDefaultConfig;
+    private saveConfig;
+    private getEvents;
+    private addEvent;
+    private clearEvents;
+    private generateAnonymousId;
+    private isCI;
+}
+export declare const telemetry: Telemetry;
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/utils/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/utils/telemetry.ts"],"names":[],"mappings":"AAQA,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AA0BD,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,SAAS,CAAa;;IAQ9B;;OAEG;IACH,SAAS,IAAI,OAAO;IAKpB;;OAEG;IACH,MAAM,IAAI,IAAI;IAMd;;OAEG;IACH,OAAO,IAAI,IAAI;IAUf;;OAEG;IACH,MAAM,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAOlD;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,IAAI;IAwBrD;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUhE;;OAEG;IACH,KAAK,IAAI,cAAc,EAAE;IAQzB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,IAAI;CAUb;AAGD,eAAO,MAAM,SAAS,WAAkB,CAAC"}

package/dist/utils/telemetry.js

@@ -0,0 +1,191 @@
+// packages/cli/src/utils/telemetry.ts
+// Telemetry System v1.0.0 - Opt-in Anonymous Analytics
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { homedir, platform, release, arch } from "node:os";
+import { NOCK_DIR_NAME, CLI_VERSION } from "./constants.js";
+const TELEMETRY_FILE = "telemetry.json";
+const EVENTS_FILE = "telemetry-events.json";
+const MAX_EVENTS = 100; // Buffer before sending
+export class Telemetry {
+    configPath;
+    eventsPath;
+    config = null;
+    startTime = 0;
+    constructor() {
+        const nockDir = path.join(homedir(), NOCK_DIR_NAME);
+        this.configPath = path.join(nockDir, TELEMETRY_FILE);
+        this.eventsPath = path.join(nockDir, EVENTS_FILE);
+    }
+    /**
+     * Check if telemetry is enabled
+     */
+    isEnabled() {
+        const config = this.getConfig();
+        return config?.enabled ?? false;
+    }
+    /**
+     * Enable telemetry
+     */
+    enable() {
+        const config = this.getConfig() || this.createDefaultConfig();
+        config.enabled = true;
+        this.saveConfig(config);
+    }
+    /**
+     * Disable telemetry
+     */
+    disable() {
+        const config = this.getConfig();
+        if (config) {
+            config.enabled = false;
+            this.saveConfig(config);
+        }
+        // Also clear buffered events
+        this.clearEvents();
+    }
+    /**
+     * Get current status
+     */
+    status() {
+        return {
+            enabled: this.isEnabled(),
+            eventCount: this.getEvents().length,
+        };
+    }
+    /**
+     * Track command execution start
+     */
+    trackStart(_command) {
+        if (!this.isEnabled())
+            return;
+        this.startTime = Date.now();
+    }
+    /**
+     * Track command execution end
+     */
+    trackEnd(command, exitCode = 0) {
+        if (!this.isEnabled())
+            return;
+        const duration = this.startTime ? Date.now() - this.startTime : undefined;
+        const data = {
+            command,
+            cliVersion: CLI_VERSION,
+            os: platform(),
+            osVersion: release(),
+            arch: arch(),
+            nodeVersion: process.version,
+            isCI: this.isCI(),
+            duration,
+            exitCode,
+        };
+        this.addEvent({
+            event: "command_executed",
+            properties: data,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Track custom event
+     */
+    track(event, properties) {
+        if (!this.isEnabled())
+            return;
+        this.addEvent({
+            event,
+            properties,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Flush events (for future remote sending)
+     */
+    flush() {
+        const events = this.getEvents();
+        this.clearEvents();
+        return events;
+    }
+    // Private methods
+    getConfig() {
+        if (this.config)
+            return this.config;
+        try {
+            if (fs.existsSync(this.configPath)) {
+                this.config = JSON.parse(fs.readFileSync(this.configPath, "utf-8"));
+                return this.config;
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+        return null;
+    }
+    createDefaultConfig() {
+        return {
+            enabled: false,
+            anonymousId: this.generateAnonymousId(),
+            firstRun: new Date().toISOString(),
+        };
+    }
+    saveConfig(config) {
+        this.config = config;
+        try {
+            const dir = path.dirname(this.configPath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(this.configPath, JSON.stringify(config, null, 2));
+        }
+        catch {
+            // Ignore write errors
+        }
+    }
+    getEvents() {
+        try {
+            if (fs.existsSync(this.eventsPath)) {
+                return JSON.parse(fs.readFileSync(this.eventsPath, "utf-8"));
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+        return [];
+    }
+    addEvent(event) {
+        try {
+            const events = this.getEvents();
+            events.push(event);
+            // Keep only last MAX_EVENTS
+            const trimmed = events.slice(-MAX_EVENTS);
+            fs.writeFileSync(this.eventsPath, JSON.stringify(trimmed, null, 2));
+        }
+        catch {
+            // Ignore write errors
+        }
+    }
+    clearEvents() {
+        try {
+            if (fs.existsSync(this.eventsPath)) {
+                fs.unlinkSync(this.eventsPath);
+            }
+        }
+        catch {
+            // Ignore delete errors
+        }
+    }
+    generateAnonymousId() {
+        // Simple random ID (no PII)
+        return "anon_" + Math.random().toString(36).substring(2, 15);
+    }
+    isCI() {
+        return !!(process.env.CI ||
+            process.env.CONTINUOUS_INTEGRATION ||
+            process.env.GITHUB_ACTIONS ||
+            process.env.GITLAB_CI ||
+            process.env.CIRCLECI ||
+            process.env.TRAVIS);
+    }
+}
+// Singleton instance
+export const telemetry = new Telemetry();
+//# sourceMappingURL=telemetry.js.map