tryassay 0.23.0 → 0.27.0

package/dist/lib/telemetry.d.ts

@@ -0,0 +1,39 @@
+export interface TelemetryEvent {
+    event_type: 'assess_complete' | 'assess_error';
+    package_version: string;
+    node_version: string;
+    os_platform: string;
+    os_arch: string;
+    repo_name?: string;
+    frameworks?: string[];
+    file_count?: number;
+    claim_count?: number;
+    bug_count?: number;
+    score?: number;
+    duration_ms?: number;
+    top_bug_categories?: Array<{
+        category: string;
+        count: number;
+    }>;
+    error_code?: string;
+    session_id: string;
+}
+/**
+ * Check if telemetry is enabled.
+ * Disabled by ASSAY_TELEMETRY=0 env var or --no-telemetry CLI flag.
+ */
+export declare function isTelemetryEnabled(): boolean;
+/**
+ * Show first-run telemetry notice (once per project).
+ * Creates .assay/telemetry-notice-shown marker file.
+ */
+export declare function showTelemetryNotice(targetPath: string): Promise<void>;
+/**
+ * Fire-and-forget telemetry event.
+ * Never blocks the CLI, never throws.
+ */
+export declare function sendTelemetryEvent(data: Omit<TelemetryEvent, 'session_id'>): void;
+/**
+ * Get package version from package.json.
+ */
+export declare function getPackageVersion(): Promise<string>;

package/dist/lib/telemetry.js

@@ -0,0 +1,69 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { randomUUID } from 'node:crypto';
+const TELEMETRY_URL = 'https://api.trylucid.dev/api/v1/telemetry';
+const TELEMETRY_TIMEOUT_MS = 3_000;
+/**
+ * Check if telemetry is enabled.
+ * Disabled by ASSAY_TELEMETRY=0 env var or --no-telemetry CLI flag.
+ */
+export function isTelemetryEnabled() {
+    return process.env.ASSAY_TELEMETRY !== '0';
+}
+/**
+ * Show first-run telemetry notice (once per project).
+ * Creates .assay/telemetry-notice-shown marker file.
+ */
+export async function showTelemetryNotice(targetPath) {
+    const markerPath = resolve(targetPath, '.assay', 'telemetry-notice-shown');
+    try {
+        await readFile(markerPath);
+        return; // Already shown
+    }
+    catch {
+        // Not shown yet
+    }
+    console.log('\n  Note: Assay collects anonymous usage stats (no code or file paths).' +
+        '\n  Disable: ASSAY_TELEMETRY=0 or --no-telemetry\n');
+    try {
+        await mkdir(resolve(targetPath, '.assay'), { recursive: true });
+        await writeFile(markerPath, new Date().toISOString());
+    }
+    catch {
+        // Non-critical — skip silently
+    }
+}
+/**
+ * Fire-and-forget telemetry event.
+ * Never blocks the CLI, never throws.
+ */
+export function sendTelemetryEvent(data) {
+    const payload = {
+        ...data,
+        session_id: randomUUID(),
+    };
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), TELEMETRY_TIMEOUT_MS);
+    fetch(TELEMETRY_URL, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+        signal: controller.signal,
+    })
+        .catch(() => { }) // Silently ignore failures
+        .finally(() => clearTimeout(timeout));
+}
+/**
+ * Get package version from package.json.
+ */
+export async function getPackageVersion() {
+    try {
+        const pkgPath = new URL('../../package.json', import.meta.url);
+        const pkg = JSON.parse(await readFile(pkgPath, 'utf-8'));
+        return pkg.version || 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/lib/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/lib/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,aAAa,GAAG,2CAA2C,CAAC;AAClE,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAoBnC;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,wBAAwB,CAAC,CAAC;IAC3E,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC3B,OAAO,CAAC,gBAAgB;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CACT,yEAAyE;QACzE,oDAAoD,CACrD,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAwC;IACzE,MAAM,OAAO,GAAmB;QAC9B,GAAG,IAAI;QACP,UAAU,EAAE,UAAU,EAAE;KACzB,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAE3E,KAAK,CAAC,aAAa,EAAE;QACnB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAC;SACC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,2BAA2B;SAC3C,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/lib/user-config.d.ts

@@ -0,0 +1,17 @@
+export interface UserConfig {
+    email?: string;
+    email_hash?: string;
+    api_key?: string;
+}
+export interface Identity {
+    email_hash?: string;
+    api_key?: string;
+}
+export declare function loadUserConfig(): Promise<UserConfig>;
+export declare function saveUserConfig(config: UserConfig): Promise<void>;
+export declare function hashEmail(email: string): string;
+/**
+ * Resolve identity from config + environment.
+ * Priority: ASSAY_API_KEY env > config api_key > config email_hash
+ */
+export declare function getIdentity(config: UserConfig): Identity;

package/dist/lib/user-config.js

@@ -0,0 +1,34 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { createHash } from 'node:crypto';
+const CONFIG_DIR = join(homedir(), '.assay');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+export async function loadUserConfig() {
+    try {
+        const data = await readFile(CONFIG_FILE, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return {};
+    }
+}
+export async function saveUserConfig(config) {
+    await mkdir(CONFIG_DIR, { recursive: true });
+    await writeFile(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
+}
+export function hashEmail(email) {
+    return createHash('sha256').update(email.toLowerCase().trim()).digest('hex');
+}
+/**
+ * Resolve identity from config + environment.
+ * Priority: ASSAY_API_KEY env > config api_key > config email_hash
+ */
+export function getIdentity(config) {
+    const envKey = process.env.ASSAY_API_KEY;
+    return {
+        api_key: envKey || config.api_key,
+        email_hash: config.email_hash,
+    };
+}
+//# sourceMappingURL=user-config.js.map

package/dist/lib/user-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.js","sourceRoot":"","sources":["../../src/lib/user-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAapD,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAkB;IACrD,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAkB;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,OAAO;QACL,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC,OAAO;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -45,6 +45,7 @@ export interface ClaimSuppression {
 }
 export interface OverridesConfig {
     suppressions: ClaimSuppression[];
+    gapSuppressions?: import('./lib/intent-types.js').IntentGapSuppression[];
 }
 export type Verdict = 'PASS' | 'PARTIAL' | 'FAIL' | 'N/A';
 export interface Evidence {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tryassay",
-  "version": "0.23.0",
+  "version": "0.27.0",
   "description": "AI code verification CLI — find bugs that tests miss, linters ignore, and code review overlooks",
   "type": "module",
   "main": "./dist/index.js",