@lyse-labs/lyse 0.1.0-alpha.2

package/dist/telemetry/consent.js

@@ -0,0 +1,139 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import prompts from "prompts";
+const CONSENT_DIR = ".lyse";
+const CONSENT_FILE = "consent.json";
+const SCHEMA_VERSION = "1.0.0";
+function resolveHome(deps) {
+    return (deps.homeDir ?? homedir)();
+}
+export function consentFilePath(deps = {}) {
+    return join(resolveHome(deps), CONSENT_DIR, CONSENT_FILE);
+}
+function isValidRecord(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return (typeof v["accepted"] === "boolean" &&
+        (v["attempt"] === 1 || v["attempt"] === 2) &&
+        typeof v["decided_at"] === "string" &&
+        v["version"] === SCHEMA_VERSION);
+}
+export function readConsent(deps = {}) {
+    const path = consentFilePath(deps);
+    if (!existsSync(path))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        return isValidRecord(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeConsent(record, deps = {}) {
+    const path = consentFilePath(deps);
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    const tmpPath = `${path}.tmp.${process.pid}`;
+    writeFileSync(tmpPath, JSON.stringify(record, null, 2) + "\n", { mode: 0o600 });
+    renameSync(tmpPath, path);
+}
+const CONSENT_MESSAGE = `Lyse can send anonymous benchmark data to help improve the tool and
+power the public Health Score bench. Data sent (only on audit completion):
+  - Your Health Score (0-100)
+  - Per-axis scores
+  - Audit duration
+  - Hashed repo identifier (irreversible)
+What is never sent: source code, file paths, file content, IP, User-Agent.
+Full notice: https://github.com/lyse-labs/lyse/blob/main/PRIVACY.md`;
+export async function promptForConsent() {
+    if (!process.stdout.isTTY)
+        return "skip";
+    process.stdout.write(CONSENT_MESSAGE + "\n");
+    const result = await prompts({
+        type: "confirm",
+        name: "accepted",
+        message: "Enable anonymous bench?",
+        initial: false,
+    });
+    if (typeof result["accepted"] !== "boolean")
+        return "skip";
+    return result["accepted"] ? "yes" : "no";
+}
+let _cachedConsent = false;
+let _cacheInitialised = false;
+export function resetConsentCache() {
+    _cachedConsent = false;
+    _cacheInitialised = false;
+}
+/**
+ * Test-only: seed the per-process consent cache directly, bypassing disk
+ * I/O. Used by consumer-side tests (ndjson-store, sender, local-log) that
+ * need to assert behavior under "consent accepted" or "consent declined"
+ * without writing a consent.json to disk.
+ *
+ * CONCURRENCY: writes module-level mutable state. Safe under vitest's
+ * default per-file isolation, but UNSAFE inside `describe.concurrent` /
+ * `test.concurrent` (multiple tests in the same worker would race on the
+ * cache). For new tests that need concurrent execution, use the
+ * `{ homeDir: () => tmpHome }` deps-injection path instead.
+ *
+ * PRODUCTION GUARD: throws if called outside a test runner — privacy-
+ * sensitive code must never bypass disk-resident consent silently.
+ */
+export function __setCacheForTest(state) {
+    if (process.env["VITEST"] !== "true" && process.env["NODE_ENV"] !== "test") {
+        throw new Error("__setCacheForTest may only be called from a test runner (VITEST or NODE_ENV=test). " +
+            "Production code must use writeConsent / readConsent / ensureConsentDecision.");
+    }
+    _cachedConsent = state.accepted;
+    _cacheInitialised = state.initialised;
+}
+export function getCachedConsent(deps = {}) {
+    if (_cacheInitialised)
+        return _cachedConsent;
+    const existing = readConsent(deps);
+    if (existing) {
+        _cachedConsent = existing.accepted;
+        _cacheInitialised = true;
+    }
+    return _cachedConsent;
+}
+export async function ensureConsentDecision(deps = {}) {
+    const existing = readConsent(deps);
+    if (!existing && process.env["LYSE_TELEMETRY"] === "1") {
+        writeConsent({
+            accepted: true,
+            attempt: 1,
+            decided_at: new Date().toISOString(),
+            version: "1.0.0",
+        }, deps);
+        _cachedConsent = true;
+        _cacheInitialised = true;
+        return { accepted: true, justAsked: false };
+    }
+    if (existing && (existing.accepted || existing.attempt === 2)) {
+        _cachedConsent = existing.accepted;
+        _cacheInitialised = true;
+        return { accepted: existing.accepted, justAsked: false };
+    }
+    if (!process.stdout.isTTY) {
+        _cachedConsent = false;
+        _cacheInitialised = true;
+        return { accepted: false, justAsked: false };
+    }
+    const outcome = await promptForConsent();
+    const accepted = outcome === "yes";
+    const nextAttempt = existing ? 2 : 1;
+    writeConsent({
+        accepted,
+        attempt: nextAttempt,
+        decided_at: new Date().toISOString(),
+        version: "1.0.0",
+    }, deps);
+    _cachedConsent = accepted;
+    _cacheInitialised = true;
+    return { accepted, justAsked: true };
+}
+//# sourceMappingURL=consent.js.map

package/dist/telemetry/consent.js.map

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

package/dist/telemetry/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./local-log.js";
+export * from "./consent.js";

package/dist/telemetry/index.js

@@ -0,0 +1,3 @@
+export * from "./local-log.js";
+export * from "./consent.js";
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/telemetry/local-log.d.ts

@@ -0,0 +1,64 @@
+import type { AuditResult, Finding } from "../types.js";
+export declare const EVENT_SCHEMA_VERSION = "1.0.0";
+export declare function telemetryEnabled(): boolean;
+/**
+ * Compact ID: strip dashes from UUID v4 and take first 26 chars.
+ * Fits the schema's event_id / session_id constraint (minLength: 16, maxLength: 32).
+ */
+export declare function generateId(): string;
+interface BaseEvent {
+    schema_version: string;
+    source: "user";
+    event_id: string;
+    event_type: "audit.started" | "audit.completed" | "finding.discovered";
+    ts: string;
+    session_id: string;
+    repo_bucket: string;
+    sdk_version: string;
+}
+export interface AuditStartedEvent extends BaseEvent {
+    event_type: "audit.started";
+    rules_version: string;
+    stack: {
+        framework?: string;
+        ds_detected?: string;
+    };
+}
+export interface AuditCompletedEvent extends BaseEvent {
+    event_type: "audit.completed";
+    audit: {
+        duration_ms: number;
+        score: number | null;
+        axes: Record<string, number | "N/A">;
+        violations: {
+            error: number;
+            warning: number;
+            info: number;
+        };
+    };
+}
+export interface FindingDiscoveredEvent extends BaseEvent {
+    event_type: "finding.discovered";
+    finding: {
+        rule_id: string;
+        severity: "error" | "warning" | "info";
+        /** sha256(filepath + "|" + salt)[:8] — no path leakage */
+        file_hash: string;
+    };
+}
+export type TelemetryEvent = AuditStartedEvent | AuditCompletedEvent | FindingDiscoveredEvent;
+export interface LogContext {
+    repoRoot: string;
+    sessionId: string;
+    repoBucket: string;
+    sdkVersion: string;
+    rulesVersion: string;
+    /** Salt used for file_hash. Pass BUCKET_SALT from identity module for consistency. */
+    salt: string;
+}
+export declare function logAuditStarted(ctx: LogContext, stack: AuditStartedEvent["stack"]): void;
+export declare function logAuditCompleted(ctx: LogContext, durationMs: number, result: AuditResult): void;
+export declare function logFindingDiscovered(ctx: LogContext, finding: Finding): void;
+/** Test helper: read all events back from the NDJSON log. */
+export declare function readEvents(repoRoot: string): TelemetryEvent[];
+export {};

package/dist/telemetry/local-log.js

@@ -0,0 +1,123 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+import { getCachedConsent } from "./consent.js";
+export const EVENT_SCHEMA_VERSION = "1.0.0";
+const EVENTS_DIR = ".lyse";
+const EVENTS_FILE = "events.ndjson";
+export function telemetryEnabled() {
+    return getCachedConsent();
+}
+/**
+ * Compact ID: strip dashes from UUID v4 and take first 26 chars.
+ * Fits the schema's event_id / session_id constraint (minLength: 16, maxLength: 32).
+ */
+export function generateId() {
+    return randomUUID().replace(/-/g, "").slice(0, 26);
+}
+function fileHash(filepath, salt) {
+    return createHash("sha256")
+        .update(filepath)
+        .update("|")
+        .update(salt)
+        .digest("hex")
+        .slice(0, 8);
+}
+function eventsFilePath(repoRoot) {
+    return join(repoRoot, EVENTS_DIR, EVENTS_FILE);
+}
+function ensureGitignored(repoRoot) {
+    const gitignorePath = join(repoRoot, ".gitignore");
+    const entry = ".lyse/";
+    if (!existsSync(gitignorePath)) {
+        writeFileSync(gitignorePath, `# Lyse local telemetry\n${entry}\n`);
+        return;
+    }
+    const current = readFileSync(gitignorePath, "utf8");
+    if (current.includes(entry) || current.includes(".lyse"))
+        return;
+    appendFileSync(gitignorePath, `\n# Lyse local telemetry\n${entry}\n`);
+}
+function writeEvent(repoRoot, event) {
+    const filepath = eventsFilePath(repoRoot);
+    mkdirSync(dirname(filepath), { recursive: true });
+    appendFileSync(filepath, JSON.stringify(event) + "\n");
+}
+export function logAuditStarted(ctx, stack) {
+    if (!telemetryEnabled())
+        return;
+    ensureGitignored(ctx.repoRoot);
+    const event = {
+        schema_version: EVENT_SCHEMA_VERSION,
+        source: "user",
+        event_id: generateId(),
+        event_type: "audit.started",
+        ts: new Date().toISOString(),
+        session_id: ctx.sessionId,
+        repo_bucket: ctx.repoBucket,
+        sdk_version: ctx.sdkVersion,
+        rules_version: ctx.rulesVersion,
+        stack,
+    };
+    writeEvent(ctx.repoRoot, event);
+}
+export function logAuditCompleted(ctx, durationMs, result) {
+    if (!telemetryEnabled())
+        return;
+    const violations = { error: 0, warning: 0, info: 0 };
+    for (const f of result.findings)
+        violations[f.severity]++;
+    const axes = {};
+    for (const a of result.axes)
+        axes[a.axis] = a.score;
+    const event = {
+        schema_version: EVENT_SCHEMA_VERSION,
+        source: "user",
+        event_id: generateId(),
+        event_type: "audit.completed",
+        ts: new Date().toISOString(),
+        session_id: ctx.sessionId,
+        repo_bucket: ctx.repoBucket,
+        sdk_version: ctx.sdkVersion,
+        audit: {
+            duration_ms: durationMs,
+            score: typeof result.finalScore === "number" ? result.finalScore : null,
+            axes,
+            violations,
+        },
+    };
+    writeEvent(ctx.repoRoot, event);
+}
+export function logFindingDiscovered(ctx, finding) {
+    if (!telemetryEnabled())
+        return;
+    const event = {
+        schema_version: EVENT_SCHEMA_VERSION,
+        source: "user",
+        event_id: generateId(),
+        event_type: "finding.discovered",
+        ts: new Date().toISOString(),
+        session_id: ctx.sessionId,
+        repo_bucket: ctx.repoBucket,
+        sdk_version: ctx.sdkVersion,
+        finding: {
+            rule_id: finding.ruleId,
+            severity: finding.severity,
+            file_hash: fileHash(finding.location.file, ctx.salt),
+        },
+    };
+    writeEvent(ctx.repoRoot, event);
+}
+/** Test helper: read all events back from the NDJSON log. */
+export function readEvents(repoRoot) {
+    const filepath = eventsFilePath(repoRoot);
+    if (!existsSync(filepath))
+        return [];
+    const content = readFileSync(filepath, "utf8");
+    return content
+        .trim()
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => JSON.parse(line));
+}
+//# sourceMappingURL=local-log.js.map

package/dist/telemetry/local-log.js.map

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

package/dist/tokens/dtcg-model.d.ts

@@ -0,0 +1,53 @@
+export type DtcgType = "color" | "dimension" | "fontFamily" | "fontWeight" | "duration" | "cubicBezier" | "shadow" | "gradient" | "typography" | "transition" | "border" | "strokeStyle" | "number" | "string";
+export type DtcgAlias = string;
+export interface DtcgTokenBase {
+    $type?: DtcgType;
+    $description?: string;
+    $extensions?: Record<string, unknown>;
+    $deprecated?: boolean | string;
+}
+export interface DtcgToken<TValue = unknown> extends DtcgTokenBase {
+    $value: TValue | DtcgAlias;
+}
+export interface DtcgShadowValue {
+    color: string;
+    offsetX: string;
+    offsetY: string;
+    blur: string;
+    spread?: string;
+    inset?: boolean;
+}
+export interface DtcgTypographyValue {
+    fontFamily?: string | string[];
+    fontSize?: string;
+    fontWeight?: string | number;
+    lineHeight?: string | number;
+    letterSpacing?: string;
+}
+export interface DtcgTransitionValue {
+    duration: string;
+    delay?: string;
+    timingFunction: number[] | string;
+}
+export interface DtcgBorderValue {
+    color: string;
+    width: string;
+    style: string;
+}
+export interface DtcgGradientStop {
+    color: string;
+    position: number;
+}
+export type DtcgGradientValue = DtcgGradientStop[];
+export type DtcgCubicBezierValue = [number, number, number, number];
+export interface DtcgGroup {
+    $type?: DtcgType;
+    $description?: string;
+    $extensions?: Record<string, unknown>;
+    [key: string]: DtcgGroup | DtcgToken<unknown> | DtcgType | string | Record<string, unknown> | undefined;
+}
+export type DtcgDocument = DtcgGroup;
+export declare function isDtcgToken(entry: unknown): entry is DtcgToken<unknown>;
+export declare function isDtcgGroup(entry: unknown): entry is DtcgGroup;
+export declare function isDtcgAlias(value: unknown): value is DtcgAlias;
+export declare function parseAliasPath(alias: DtcgAlias): string[];

package/dist/tokens/dtcg-model.js

@@ -0,0 +1,18 @@
+export function isDtcgToken(entry) {
+    return typeof entry === "object" && entry !== null && "$value" in entry;
+}
+export function isDtcgGroup(entry) {
+    return (typeof entry === "object" &&
+        entry !== null &&
+        !Array.isArray(entry) &&
+        !("$value" in entry));
+}
+const ALIAS_RE = /^\{[^{}]+\}$/;
+export function isDtcgAlias(value) {
+    return typeof value === "string" && ALIAS_RE.test(value.trim());
+}
+export function parseAliasPath(alias) {
+    const inner = alias.trim().slice(1, -1);
+    return inner.split(".").map((s) => s.trim()).filter((s) => s.length > 0);
+}
+//# sourceMappingURL=dtcg-model.js.map

package/dist/tokens/dtcg-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtcg-model.js","sourceRoot":"","sources":["../../src/tokens/dtcg-model.ts"],"names":[],"mappings":"AA4EA,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,IAAK,KAAiC,CAAC;AACvG,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,CAAC,CAAC,QAAQ,IAAK,KAAiC,CAAC,CAClD,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEhC,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAgB;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/tokens/normalizer.d.ts

@@ -0,0 +1,17 @@
+import type { DtcgDocument, DtcgType } from "./dtcg-model.js";
+export type NormalizerSource = "tailwind-v3" | "tailwind-v4" | "css-vars" | "theme-ts" | "dtcg";
+export interface NormalizerInput {
+    source: NormalizerSource;
+    data: unknown;
+}
+export interface NormalizedTokens {
+    document: DtcgDocument;
+    source: NormalizerSource;
+    warnings: string[];
+}
+export declare function classifyTailwindV4Prop(prop: string): {
+    group: string;
+    type: DtcgType;
+    name: string;
+} | null;
+export declare function normalizeToDtcg(input: NormalizerInput): NormalizedTokens;