@convext/cli 1.0.15 → 1.0.17

package/dist/utils/telemetry.d.ts

@@ -0,0 +1,58 @@
+export interface TelemetryEvent {
+    timestamp: string;
+    event_type: string;
+    source: string;
+    project_slug?: string;
+    rule_slug?: string;
+    rule_title?: string;
+    action?: string;
+    result?: 'blocked' | 'passed' | 'warned';
+    file?: string;
+    tool?: string;
+    payload?: Record<string, unknown>;
+}
+export interface TelemetrySummary {
+    total_events: number;
+    violations_blocked: number;
+    violations_warned: number;
+    compliance_checks: number;
+    tasks_completed: number;
+    by_rule: Record<string, {
+        blocked: number;
+        warned: number;
+        passed: number;
+    }>;
+    by_source: Record<string, number>;
+    by_day: Record<string, number>;
+    period_start?: string;
+    period_end?: string;
+}
+/**
+ * Log a telemetry event to the local JSONL file
+ */
+export declare function logEvent(event: Omit<TelemetryEvent, 'timestamp'>, cwd?: string): void;
+/**
+ * Read all events from the telemetry file
+ */
+export declare function readEvents(cwd?: string): TelemetryEvent[];
+/**
+ * Read events within a date range
+ */
+export declare function readEventsInRange(startDate: Date, endDate: Date, cwd?: string): TelemetryEvent[];
+/**
+ * Archive old events and clear the current telemetry file
+ */
+export declare function rotateLog(cwd?: string): string | null;
+/**
+ * Generate a summary of telemetry events
+ */
+export declare function summarizeEvents(events: TelemetryEvent[]): TelemetrySummary;
+/**
+ * Clear all telemetry data
+ */
+export declare function clearTelemetry(cwd?: string): void;
+/**
+ * Get the count of events in the telemetry file
+ */
+export declare function getEventCount(cwd?: string): number;
+//# 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":"AAGA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoBD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAUrF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAiBzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,EACb,GAAG,CAAC,EAAE,MAAM,GACX,cAAc,EAAE,CAMlB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAerD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,gBAAgB,CAgE1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAKjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CASlD"}

package/dist/utils/telemetry.js

@@ -0,0 +1,156 @@
+import { existsSync, readFileSync, writeFileSync, appendFileSync, renameSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+const TELEMETRY_DIR = '.convext';
+const TELEMETRY_FILE = 'telemetry.jsonl';
+const ARCHIVE_DIR = 'telemetry-archive';
+function getTelemetryPath(cwd = process.cwd()) {
+    return join(cwd, TELEMETRY_DIR, TELEMETRY_FILE);
+}
+function getArchivePath(cwd = process.cwd()) {
+    return join(cwd, TELEMETRY_DIR, ARCHIVE_DIR);
+}
+function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Log a telemetry event to the local JSONL file
+ */
+export function logEvent(event, cwd) {
+    const telemetryPath = getTelemetryPath(cwd);
+    ensureDir(dirname(telemetryPath));
+    const fullEvent = {
+        ...event,
+        timestamp: new Date().toISOString(),
+    };
+    appendFileSync(telemetryPath, JSON.stringify(fullEvent) + '\n', 'utf-8');
+}
+/**
+ * Read all events from the telemetry file
+ */
+export function readEvents(cwd) {
+    const telemetryPath = getTelemetryPath(cwd);
+    if (!existsSync(telemetryPath)) {
+        return [];
+    }
+    const content = readFileSync(telemetryPath, 'utf-8');
+    const lines = content.trim().split('\n').filter(Boolean);
+    return lines.map((line) => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            return null;
+        }
+    }).filter((e) => e !== null);
+}
+/**
+ * Read events within a date range
+ */
+export function readEventsInRange(startDate, endDate, cwd) {
+    const events = readEvents(cwd);
+    return events.filter((e) => {
+        const eventDate = new Date(e.timestamp);
+        return eventDate >= startDate && eventDate <= endDate;
+    });
+}
+/**
+ * Archive old events and clear the current telemetry file
+ */
+export function rotateLog(cwd) {
+    const telemetryPath = getTelemetryPath(cwd);
+    if (!existsSync(telemetryPath)) {
+        return null;
+    }
+    const archiveDir = getArchivePath(cwd);
+    ensureDir(archiveDir);
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const archiveFile = join(archiveDir, `telemetry-${timestamp}.jsonl`);
+    renameSync(telemetryPath, archiveFile);
+    return archiveFile;
+}
+/**
+ * Generate a summary of telemetry events
+ */
+export function summarizeEvents(events) {
+    const summary = {
+        total_events: events.length,
+        violations_blocked: 0,
+        violations_warned: 0,
+        compliance_checks: 0,
+        tasks_completed: 0,
+        by_rule: {},
+        by_source: {},
+        by_day: {},
+    };
+    if (events.length === 0) {
+        return summary;
+    }
+    // Sort events by timestamp
+    const sorted = [...events].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    summary.period_start = sorted[0].timestamp;
+    summary.period_end = sorted[sorted.length - 1].timestamp;
+    for (const event of events) {
+        // Count by event type
+        if (event.event_type === 'violation') {
+            if (event.result === 'blocked') {
+                summary.violations_blocked++;
+            }
+            else if (event.result === 'warned') {
+                summary.violations_warned++;
+            }
+        }
+        else if (event.event_type === 'compliance_check') {
+            summary.compliance_checks++;
+        }
+        else if (event.event_type === 'task_complete') {
+            summary.tasks_completed++;
+        }
+        // Count by rule
+        const ruleKey = event.rule_title || event.rule_slug || 'unknown';
+        if (event.event_type === 'violation' && ruleKey !== 'unknown') {
+            if (!summary.by_rule[ruleKey]) {
+                summary.by_rule[ruleKey] = { blocked: 0, warned: 0, passed: 0 };
+            }
+            if (event.result === 'blocked') {
+                summary.by_rule[ruleKey].blocked++;
+            }
+            else if (event.result === 'warned') {
+                summary.by_rule[ruleKey].warned++;
+            }
+            else {
+                summary.by_rule[ruleKey].passed++;
+            }
+        }
+        // Count by source
+        if (event.source) {
+            summary.by_source[event.source] = (summary.by_source[event.source] || 0) + 1;
+        }
+        // Count by day
+        const day = event.timestamp.split('T')[0];
+        summary.by_day[day] = (summary.by_day[day] || 0) + 1;
+    }
+    return summary;
+}
+/**
+ * Clear all telemetry data
+ */
+export function clearTelemetry(cwd) {
+    const telemetryPath = getTelemetryPath(cwd);
+    if (existsSync(telemetryPath)) {
+        writeFileSync(telemetryPath, '', 'utf-8');
+    }
+}
+/**
+ * Get the count of events in the telemetry file
+ */
+export function getEventCount(cwd) {
+    const telemetryPath = getTelemetryPath(cwd);
+    if (!existsSync(telemetryPath)) {
+        return 0;
+    }
+    const content = readFileSync(telemetryPath, 'utf-8');
+    return content.trim().split('\n').filter(Boolean).length;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/utils/telemetry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@convext/cli",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "CLI for Convext - sync engineering rules and standards to your project",
   "type": "module",
   "main": "dist/index.js",