@sudosandwich/limps-headless 0.1.3

package/dist/audit/run-audit.js

@@ -0,0 +1,287 @@
+/**
+ * Orchestrate analysis, diff, update-check and report generation.
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { rcompare, valid as validSemver } from 'semver';
+import { analyzeComponent, scoreAgainstSignatures, disambiguate, isAmbiguous } from '../analyzer/index.js';
+import { getSignatureFromCache, getLatestResolution, listCachedPrimitives, listCachedVersions } from '../cache/index.js';
+import { diffVersions } from '../differ/index.js';
+import { resolvePackageVersion } from '../fetcher/npm-registry.js';
+import { createModuleGraph } from '../analysis/module-graph.js';
+import { discoverComponents } from './discover-components.js';
+import { generateReport } from './generate-report.js';
+import { baseUiRuleset, evaluateRuleset, radixLegacyRuleset } from '../rules/index.js';
+/** Reference primitive for version resolution (Radix: dialog). */
+const REFERENCE_PRIMITIVE = 'dialog';
+/** Minimum confidence to include a match in analysis results. */
+const DEFAULT_ANALYSIS_THRESHOLD = 40;
+/** Max confidence for NO_LEGACY_RADIX_MATCH (below this = custom/Base). */
+const CONFIDENCE_CUSTOM_OK_MAX = 50;
+/** Min confidence for LEGACY_RADIX_MATCH_STRONG (above this = strong match). */
+const CONFIDENCE_ADOPT_MIN = 70;
+function serializeAnalysis(analysis) {
+    return {
+        ...analysis,
+        propsInterface: Object.fromEntries(analysis.propsInterface.entries()),
+    };
+}
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+function resolveTsconfig(cwd) {
+    const candidate = path.join(cwd, 'tsconfig.json');
+    return fs.existsSync(candidate) ? candidate : undefined;
+}
+function applyEvidenceVerbosity(analysis, evidence) {
+    if (!analysis.ir || evidence === 'verbose') {
+        return analysis;
+    }
+    const trimmedEvidence = analysis.ir.evidence.map(({ id, source, strength, weight }) => ({
+        id,
+        source,
+        strength,
+        weight,
+    }));
+    return {
+        ...analysis,
+        ir: {
+            ...analysis.ir,
+            evidence: trimmedEvidence,
+        },
+    };
+}
+function selectRules(rules, ruleset) {
+    if (!rules)
+        return undefined;
+    if (ruleset === 'base-ui') {
+        return { baseUi: rules.baseUi };
+    }
+    if (ruleset === 'radix-legacy') {
+        return { radixLegacy: rules.radixLegacy };
+    }
+    return rules;
+}
+async function loadSignatures(version) {
+    const signatures = [];
+    const primitivesList = await listCachedPrimitives(version);
+    for (const p of primitivesList) {
+        const sig = await getSignatureFromCache(p, version);
+        if (sig)
+            signatures.push(sig);
+    }
+    return signatures;
+}
+async function analyzeFiles(files, signatures, options, moduleGraph = createModuleGraph({
+    tsconfigPath: resolveTsconfig(process.cwd()),
+    cwd: process.cwd(),
+    rootDir: process.cwd(),
+})) {
+    const threshold = DEFAULT_ANALYSIS_THRESHOLD;
+    const results = [];
+    const cwd = process.cwd();
+    for (const file of files) {
+        const absolute = path.resolve(file);
+        const relative = path.relative(cwd, absolute);
+        if (relative.startsWith('..') || path.isAbsolute(relative)) {
+            continue;
+        }
+        if (absolute.endsWith('.d.ts') || !/\.(ts|tsx)$/.test(absolute)) {
+            continue;
+        }
+        try {
+            const analysis = await analyzeComponent(absolute, { moduleGraph });
+            const rules = analysis.ir
+                ? {
+                    baseUi: evaluateRuleset(analysis.ir, baseUiRuleset),
+                    radixLegacy: evaluateRuleset(analysis.ir, radixLegacyRuleset),
+                }
+                : undefined;
+            const analysisForOutput = applyEvidenceVerbosity(analysis, options.evidence);
+            const rulesForOutput = selectRules(rules, options.ruleset);
+            let recommendation;
+            let matches = signatures.length > 0 ? scoreAgainstSignatures(analysis, signatures) : [];
+            matches = matches.filter((m) => m.confidence >= threshold);
+            const ambiguous = isAmbiguous(matches);
+            const bestMatch = matches.length > 0 ? disambiguate(matches, analysis) : null;
+            if (!bestMatch || bestMatch.confidence < CONFIDENCE_CUSTOM_OK_MAX) {
+                recommendation = {
+                    primitive: null,
+                    package: null,
+                    confidence: bestMatch?.confidence ?? 0,
+                    action: 'NO_LEGACY_RADIX_MATCH',
+                    reason: bestMatch?.confidence
+                        ? `Low confidence (${bestMatch.confidence}) - likely custom or already Base UI`
+                        : 'No legacy Radix match detected',
+                };
+            }
+            else if (bestMatch.confidence >= CONFIDENCE_ADOPT_MIN) {
+                recommendation = {
+                    primitive: bestMatch.primitive,
+                    package: bestMatch.package,
+                    confidence: bestMatch.confidence,
+                    action: 'LEGACY_RADIX_MATCH_STRONG',
+                    reason: `High confidence legacy Radix match (${bestMatch.confidence}) - prioritize Base UI migration`,
+                };
+            }
+            else {
+                recommendation = {
+                    primitive: bestMatch.primitive,
+                    package: bestMatch.package,
+                    confidence: bestMatch.confidence,
+                    action: 'LEGACY_RADIX_MATCH_POSSIBLE',
+                    reason: `Moderate confidence legacy Radix match (${bestMatch.confidence}) - review for Base UI migration`,
+                };
+            }
+            const result = {
+                component: analysis.name,
+                filePath: relative,
+                recommendation,
+                matches,
+                analysis: analysisForOutput,
+                isAmbiguous: ambiguous,
+                rules: rulesForOutput,
+            };
+            results.push(result);
+        }
+        catch (err) {
+            console.warn(`[run-audit] Skipped ${relative}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return results;
+}
+function persistInventory(outputDir, components) {
+    const inventoryPath = path.join(outputDir, 'component-inventory.json');
+    fs.writeFileSync(inventoryPath, JSON.stringify({ components }, null, 2), 'utf-8');
+    return inventoryPath;
+}
+/**
+ * Run full audit: optional analysis on files, diff, update-check, then generate report.
+ */
+export async function runAudit(input) {
+    const outputDir = path.resolve(input.outputDir ?? '.limps-headless/reports');
+    ensureDir(outputDir);
+    const format = input.format ?? 'both';
+    const primitives = input.scope?.primitives;
+    let inventoryPath;
+    let analysisPath;
+    let irPath;
+    let files = input.scope?.files ?? [];
+    let discovered = [];
+    let legacyRadixCount = 0;
+    const didDiscover = files.length === 0;
+    if (didDiscover) {
+        discovered = await discoverComponents(input.discovery);
+        inventoryPath = persistInventory(outputDir, discovered);
+        files = discovered.map((c) => c.path);
+        legacyRadixCount = discovered.filter((component) => component.backend === 'radix' || component.mixedUsage).length;
+    }
+    if (files.length > 0) {
+        let resolvedVersion = input.radixVersion ?? 'latest';
+        if (resolvedVersion === 'latest') {
+            const latestResolution = await getLatestResolution(REFERENCE_PRIMITIVE);
+            if (latestResolution) {
+                resolvedVersion = latestResolution.version;
+            }
+            else {
+                const versions = await listCachedVersions();
+                if (versions.length > 0) {
+                    const validVersions = versions.filter((v) => validSemver(v));
+                    resolvedVersion =
+                        validVersions.length > 0
+                            ? validVersions.sort(rcompare)[0]
+                            : versions.sort().reverse()[0];
+                }
+            }
+        }
+        const signatures = await loadSignatures(resolvedVersion);
+        const results = await analyzeFiles(files, signatures, {
+            ruleset: input.ruleset ?? 'base-ui',
+            evidence: input.evidence ?? 'summary',
+        });
+        const serializable = results.map((r) => ({
+            ...r,
+            analysis: serializeAnalysis(r.analysis),
+        }));
+        analysisPath = path.join(outputDir, 'analysis.json');
+        fs.writeFileSync(analysisPath, JSON.stringify({ results: serializable }, null, 2), 'utf-8');
+        if (input.debugIr) {
+            irPath = path.join(outputDir, 'ir.json');
+            const irDump = results.map((r) => ({
+                component: r.component,
+                filePath: r.filePath,
+                ir: r.analysis.ir ?? null,
+            }));
+            fs.writeFileSync(irPath, JSON.stringify({ components: irDump }, null, 2), 'utf-8');
+        }
+    }
+    else {
+        analysisPath = path.join(outputDir, 'analysis.json');
+        fs.writeFileSync(analysisPath, JSON.stringify({ results: [] }, null, 2), 'utf-8');
+    }
+    const shouldSkipRadixDiff = didDiscover && (discovered.length === 0 || legacyRadixCount === 0);
+    let diffPath;
+    let updatesPath;
+    if (shouldSkipRadixDiff) {
+        const diff = {
+            fromVersion: 'n/a',
+            toVersion: 'n/a',
+            hasBreakingChanges: false,
+            summary: { totalChanges: 0, breaking: 0, warnings: 0, info: 0 },
+            changes: [],
+        };
+        diffPath = path.join(outputDir, 'diff.json');
+        fs.writeFileSync(diffPath, JSON.stringify(diff, null, 2), 'utf-8');
+        const updates = {
+            currentVersion: 'n/a',
+            latestVersion: 'n/a',
+            hasUpdate: false,
+        };
+        updatesPath = path.join(outputDir, 'updates.json');
+        fs.writeFileSync(updatesPath, JSON.stringify(updates, null, 2), 'utf-8');
+    }
+    else {
+        const currentResolution = await getLatestResolution(REFERENCE_PRIMITIVE);
+        const currentVersion = currentResolution?.version;
+        const packageName = `@radix-ui/react-${REFERENCE_PRIMITIVE}`;
+        const latestVersion = await resolvePackageVersion(packageName, 'latest');
+        const fromVersion = currentVersion ?? input.radixVersion ?? latestVersion;
+        const diff = await diffVersions(fromVersion, latestVersion, primitives);
+        diffPath = path.join(outputDir, 'diff.json');
+        fs.writeFileSync(diffPath, JSON.stringify(diff, null, 2), 'utf-8');
+        const hasUpdate = currentVersion !== undefined && currentVersion !== latestVersion;
+        const updates = {
+            currentVersion: currentVersion ?? latestVersion,
+            latestVersion,
+            hasUpdate,
+        };
+        if (hasUpdate) {
+            updates.diff = diff;
+        }
+        updatesPath = path.join(outputDir, 'updates.json');
+        fs.writeFileSync(updatesPath, JSON.stringify(updates, null, 2), 'utf-8');
+    }
+    const gen = generateReport({
+        inputs: {
+            analysis: analysisPath,
+            diff: diffPath,
+            checkUpdates: updatesPath,
+            inventory: inventoryPath,
+        },
+        outputDir,
+        format,
+        title: 'Radix Audit Report',
+        policy: input.policy,
+    });
+    return {
+        ...gen,
+        analysisPath,
+        irPath,
+        diffPath,
+        updatesPath,
+        inventoryPath,
+    };
+}
+//# sourceMappingURL=run-audit.js.map

package/dist/audit/run-audit.js.map

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

package/dist/audit/types.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Type definitions for the audit report pipeline.
+ */
+/**
+ * Priority levels for report issues.
+ */
+export type IssuePriority = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Backend identifier for headless UI libraries (Agent 1 #1).
+ */
+export type HeadlessBackend = 'radix' | 'base' | 'mixed' | 'unknown';
+/**
+ * Issue category for backend provider analysis (Agent 1 #2).
+ */
+export type IssueCategory = 'accessibility' | 'performance' | 'dependencies' | 'storybook' | 'migration';
+/**
+ * Migration readiness levels based on Radix percentage in codebase.
+ */
+export type MigrationReadiness = 'excellent' | 'good' | 'needs-work' | 'urgent';
+/**
+ * Issue from backend provider analysis (Agent 1 #2).
+ */
+export interface Issue {
+    component?: string;
+    category: IssueCategory;
+    severity: IssuePriority;
+    message: string;
+    suggestion?: string;
+    evidence?: string[];
+}
+/**
+ * Severity for contraventions (policy/version drift).
+ */
+export type ContraventionSeverity = 'high' | 'medium' | 'low';
+/**
+ * Policy options for audit (Agent 0 #5).
+ */
+export type BackendMode = 'auto' | 'base' | 'radix-legacy';
+export type MigrationThreshold = 'low' | 'medium' | 'high';
+export interface RunAuditOptions {
+    backendMode: BackendMode;
+    migrationThreshold: MigrationThreshold;
+    failOnMixed: boolean;
+    includeLegacy: boolean;
+}
+/**
+ * Options for component discovery.
+ */
+export interface DiscoveryOptions {
+    rootDir?: string;
+    includePatterns?: string[];
+    excludePatterns?: string[];
+}
+/**
+ * Metadata for a discovered component (Agent 1 #1 - extended with backend detection).
+ */
+export interface ComponentMetadata {
+    path: string;
+    name: string;
+    exportType?: 'default' | 'named' | 'both';
+    propsInterface?: string;
+    dependencies?: string[];
+    /** Detected backend library (radix, base, mixed, unknown). */
+    backend: HeadlessBackend;
+    /** True if component uses both Radix and Base imports. */
+    mixedUsage: boolean;
+    /** Import sources that matched backend detection (e.g. "@radix-ui/react-dialog"). */
+    importSources: string[];
+    /** Pattern evidence found (e.g. "asChild", "render"). */
+    evidence: string[];
+    /** True if component exports a React component. */
+    exportsComponent: boolean;
+    /** Names of exported identifiers. */
+    exportedNames: string[];
+}
+export interface ComponentInventory {
+    components: ComponentMetadata[];
+}
+/**
+ * A single contravention (e.g. legacy package usage, non-tree-shaking).
+ */
+export interface Contravention {
+    id: string;
+    type: string;
+    severity: ContraventionSeverity;
+    description: string;
+    recommendation: string;
+    location?: string;
+}
+/**
+ * A single issue from analysis or diff.
+ */
+export interface AuditIssue {
+    id: string;
+    category: string;
+    priority: IssuePriority;
+    description: string;
+    recommendation: string;
+    location?: string;
+}
+/**
+ * Audit report output shape.
+ */
+export interface AuditReport {
+    metadata: {
+        version: string;
+        generatedAt: string;
+        generatedBy: string;
+        /** Policy used for this audit (when provided). */
+        policy?: Partial<RunAuditOptions>;
+    };
+    summary: {
+        totalComponents: number;
+        issuesByPriority: Record<IssuePriority, number>;
+        contraventions: number;
+        /** Backend counts when inventory is available (optional for backward compat). */
+        backendCounts?: Record<HeadlessBackend, number>;
+        /** Count of components using legacy Radix (radix + mixed). */
+        legacyRadixCount?: number;
+        /** Migration readiness indicator. */
+        migrationReadiness?: MigrationReadiness;
+    };
+    inventory?: ComponentMetadata[];
+    compliance?: Array<{
+        path: string;
+        name: string;
+        primitive: string | null;
+        confidence: number;
+        status: 'pass' | 'partial' | 'fail';
+    }>;
+    contraventions: Contravention[];
+    issues: AuditIssue[];
+    recommendations: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/audit/types.d.ts.map

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

package/dist/audit/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the audit report pipeline.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/audit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cache/index.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Cache module for Radix primitive data.
+ *
+ * Provides version-aware caching with TTL for:
+ * - ExtractedPrimitive data
+ * - BehaviorSignature data
+ * - "Latest" version resolution
+ */
+import type { ExtractedPrimitive, BehaviorSignature } from '../types/index.js';
+export * from './storage.js';
+export * from './ttl.js';
+/**
+ * Latest version resolution cache entry.
+ */
+export interface LatestResolution {
+    version: string;
+    resolvedAt: string;
+}
+/**
+ * Latest resolution cache file content.
+ */
+export interface LatestResolutionCache {
+    [primitive: string]: LatestResolution;
+}
+/**
+ * Cache options for get operations.
+ */
+export interface CacheGetOptions {
+    /**
+     * Skip TTL check and return cached data even if expired.
+     */
+    ignoreExpired?: boolean;
+    /**
+     * Base directory for cache (for testing).
+     */
+    baseDir?: string;
+}
+/**
+ * Cache options for save operations.
+ */
+export interface CacheSaveOptions {
+    /**
+     * Base directory for cache (for testing).
+     */
+    baseDir?: string;
+}
+/**
+ * Get cached ExtractedPrimitive data.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param options - Cache options
+ * @returns Cached data or null if not found or expired
+ */
+export declare function getFromCache(primitive: string, version: string, options?: CacheGetOptions): Promise<ExtractedPrimitive | null>;
+/**
+ * Save ExtractedPrimitive data to cache.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param data - Data to cache
+ * @param options - Cache options
+ */
+export declare function saveToCache(primitive: string, version: string, data: ExtractedPrimitive, options?: CacheSaveOptions): Promise<void>;
+/**
+ * Get cached BehaviorSignature data.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param options - Cache options
+ * @returns Cached signature or null if not found or expired
+ */
+export declare function getSignatureFromCache(primitive: string, version: string, options?: CacheGetOptions): Promise<BehaviorSignature | null>;
+/**
+ * Save BehaviorSignature data to cache.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param signature - Signature to cache
+ * @param options - Cache options
+ */
+export declare function saveSignatureToCache(primitive: string, version: string, signature: BehaviorSignature, options?: CacheSaveOptions): Promise<void>;
+/**
+ * Get the "latest" version resolution for a primitive.
+ * @param primitive - Primitive name
+ * @param options - Cache options
+ * @returns Latest resolution or null if not found or expired
+ */
+export declare function getLatestResolution(primitive: string, options?: CacheGetOptions): Promise<LatestResolution | null>;
+/**
+ * Save a "latest" version resolution.
+ * @param primitive - Primitive name
+ * @param version - Resolved version string
+ * @param options - Cache options
+ */
+export declare function saveLatestResolution(primitive: string, version: string, options?: CacheSaveOptions): Promise<void>;
+/**
+ * Clear cache for a specific primitive and version, or all cache.
+ * @param primitive - Optional primitive name (clears all if not provided)
+ * @param version - Optional version (clears all versions of primitive if not provided)
+ * @param options - Cache options
+ */
+export declare function clearCache(primitive?: string, version?: string, options?: CacheSaveOptions): Promise<void>;
+/**
+ * Get cache statistics.
+ * @param options - Cache options
+ * @returns Cache statistics
+ */
+export declare function getCacheStats(options?: CacheGetOptions): Promise<{
+    versions: string[];
+    primitiveCount: number;
+    signatureCount: number;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAe/E,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAcpC;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAkBnC;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAqBlC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC;IAC1E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAyBD"}