@sudosandwich/limps-headless 0.1.3

package/dist/cache/index.js

@@ -0,0 +1,176 @@
+/**
+ * Cache module for Radix primitive data.
+ *
+ * Provides version-aware caching with TTL for:
+ * - ExtractedPrimitive data
+ * - BehaviorSignature data
+ * - "Latest" version resolution
+ */
+import { getCacheDir, getCachePath, readFromFile, writeToFile, deleteFile, deleteDir, listCachedVersions, listCachedPrimitives, } from './storage.js';
+import { isVersionDataExpired, isSignatureExpired, TTL } from './ttl.js';
+import * as path from 'node:path';
+// Re-export storage and TTL utilities
+export * from './storage.js';
+export * from './ttl.js';
+/**
+ * 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 async function getFromCache(primitive, version, options = {}) {
+    const cachePath = getCachePath(primitive, version, 'data', options.baseDir);
+    const data = await readFromFile(cachePath);
+    if (!data) {
+        return null;
+    }
+    // Check expiration unless ignored
+    if (!options.ignoreExpired && isVersionDataExpired(data.extractedAt)) {
+        return null;
+    }
+    return data;
+}
+/**
+ * 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 async function saveToCache(primitive, version, data, options = {}) {
+    const cachePath = getCachePath(primitive, version, 'data', options.baseDir);
+    await writeToFile(cachePath, data);
+}
+/**
+ * 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 async function getSignatureFromCache(primitive, version, options = {}) {
+    const cachePath = getCachePath(primitive, version, 'sig', options.baseDir);
+    // BehaviorSignature doesn't have a timestamp, so we check the ExtractedPrimitive
+    const extractedPath = getCachePath(primitive, version, 'data', options.baseDir);
+    const extracted = await readFromFile(extractedPath);
+    // If no extracted data exists, signature is orphaned
+    if (!extracted && !options.ignoreExpired) {
+        return null;
+    }
+    // Check expiration based on extracted data timestamp
+    if (extracted && !options.ignoreExpired && isSignatureExpired(extracted.extractedAt)) {
+        return null;
+    }
+    return readFromFile(cachePath);
+}
+/**
+ * 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 async function saveSignatureToCache(primitive, version, signature, options = {}) {
+    const cachePath = getCachePath(primitive, version, 'sig', options.baseDir);
+    await writeToFile(cachePath, signature);
+}
+/**
+ * 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 async function getLatestResolution(primitive, options = {}) {
+    const cacheDir = getCacheDir(options.baseDir);
+    const latestPath = path.join(cacheDir, 'latest-resolved.json');
+    const cache = await readFromFile(latestPath);
+    if (!cache || !cache[primitive]) {
+        return null;
+    }
+    const resolution = cache[primitive];
+    // Check expiration
+    if (!options.ignoreExpired) {
+        const resolvedTime = new Date(resolution.resolvedAt).getTime();
+        const now = Date.now();
+        if (now - resolvedTime >= TTL.LATEST_RESOLUTION) {
+            return null;
+        }
+    }
+    return resolution;
+}
+/**
+ * Save a "latest" version resolution.
+ * @param primitive - Primitive name
+ * @param version - Resolved version string
+ * @param options - Cache options
+ */
+export async function saveLatestResolution(primitive, version, options = {}) {
+    const cacheDir = getCacheDir(options.baseDir);
+    const latestPath = path.join(cacheDir, 'latest-resolved.json');
+    // Read existing cache
+    let cache = await readFromFile(latestPath);
+    if (!cache) {
+        cache = {};
+    }
+    // Update entry
+    cache[primitive] = {
+        version,
+        resolvedAt: new Date().toISOString(),
+    };
+    await writeToFile(latestPath, cache);
+}
+/**
+ * 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 async function clearCache(primitive, version, options = {}) {
+    const cacheDir = getCacheDir(options.baseDir);
+    // Clear everything
+    if (!primitive) {
+        await deleteDir(cacheDir);
+        return;
+    }
+    // Clear specific primitive in specific version
+    if (version) {
+        await deleteFile(getCachePath(primitive, version, 'data', options.baseDir));
+        await deleteFile(getCachePath(primitive, version, 'sig', options.baseDir));
+        return;
+    }
+    // Clear specific primitive in all versions
+    const versions = await listCachedVersions(options.baseDir);
+    for (const v of versions) {
+        await deleteFile(getCachePath(primitive, v, 'data', options.baseDir));
+        await deleteFile(getCachePath(primitive, v, 'sig', options.baseDir));
+    }
+}
+/**
+ * Get cache statistics.
+ * @param options - Cache options
+ * @returns Cache statistics
+ */
+export async function getCacheStats(options = {}) {
+    const versions = await listCachedVersions(options.baseDir);
+    let primitiveCount = 0;
+    let signatureCount = 0;
+    for (const version of versions) {
+        const primitives = await listCachedPrimitives(version, options.baseDir);
+        primitiveCount += primitives.length;
+        // Count signatures (files ending in .sig.json)
+        for (const primitive of primitives) {
+            const sigPath = getCachePath(primitive, version, 'sig', options.baseDir);
+            const sig = await readFromFile(sigPath);
+            if (sig) {
+                signatureCount++;
+            }
+        }
+    }
+    return {
+        versions,
+        primitiveCount,
+        signatureCount,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,sCAAsC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AA0CzB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,OAAe,EACf,UAA2B,EAAE;IAE7B,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,MAAM,YAAY,CAAqB,SAAS,CAAC,CAAC;IAE/D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,OAAe,EACf,IAAwB,EACxB,UAA4B,EAAE;IAE9B,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,MAAM,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAiB,EACjB,OAAe,EACf,UAA2B,EAAE;IAE7B,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3E,iFAAiF;IACjF,MAAM,aAAa,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAChF,MAAM,SAAS,GAAG,MAAM,YAAY,CAAqB,aAAa,CAAC,CAAC;IAExE,qDAAqD;IACrD,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qDAAqD;IACrD,IAAI,SAAS,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,kBAAkB,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QACrF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,YAAY,CAAoB,SAAS,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,OAAe,EACf,SAA4B,EAC5B,UAA4B,EAAE;IAE9B,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,MAAM,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAiB,EACjB,UAA2B,EAAE;IAE7B,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAE/D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAwB,UAAU,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IAEpC,mBAAmB;IACnB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,YAAY,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,OAAe,EACf,UAA4B,EAAE;IAE9B,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAE/D,sBAAsB;IACtB,IAAI,KAAK,GAAG,MAAM,YAAY,CAAwB,UAAU,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,EAAE,CAAC;IACb,CAAC;IAED,eAAe;IACf,KAAK,CAAC,SAAS,CAAC,GAAG;QACjB,OAAO;QACP,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;IAEF,MAAM,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,SAAkB,EAClB,OAAgB,EAChB,UAA4B,EAAE;IAE9B,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9C,mBAAmB;IACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,+CAA+C;IAC/C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,UAAU,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5E,MAAM,UAAU,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,UAAU,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACtE,MAAM,UAAU,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAA2B,EAAE;IAK/D,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACxE,cAAc,IAAI,UAAU,CAAC,MAAM,CAAC;QAEpC,+CAA+C;QAC/C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACzE,MAAM,GAAG,GAAG,MAAM,YAAY,CAAoB,OAAO,CAAC,CAAC;YAC3D,IAAI,GAAG,EAAE,CAAC;gBACR,cAAc,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,cAAc;QACd,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/cache/storage.d.ts

@@ -0,0 +1,73 @@
+/**
+ * File-based cache storage for Radix primitive data.
+ *
+ * Cache structure:
+ * ~/.limps-headless/
+ *   cache/
+ *     1.0.5/
+ *       dialog.json          # ExtractedPrimitive
+ *       dialog.sig.json      # BehaviorSignature
+ *     1.1.0/
+ *       ...
+ *     latest-resolved.json   # { primitive: { version: "1.1.2", resolvedAt: "..." } }
+ */
+/**
+ * Get the cache directory path.
+ * @param baseDir - Optional base directory (defaults to home directory)
+ * @returns Absolute path to the cache directory
+ */
+export declare function getCacheDir(baseDir?: string): string;
+/**
+ * Get the versioned cache directory path.
+ * @param version - The Radix version
+ * @param baseDir - Optional base directory
+ * @returns Absolute path to the versioned cache directory
+ */
+export declare function getVersionedCacheDir(version: string, baseDir?: string): string;
+/**
+ * Get the path for a cached primitive file.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param type - Type of cache ('data' for ExtractedPrimitive, 'sig' for BehaviorSignature)
+ * @param baseDir - Optional base directory
+ * @returns Absolute file path
+ */
+export declare function getCachePath(primitive: string, version: string, type: 'data' | 'sig', baseDir?: string): string;
+/**
+ * Read data from a cache file.
+ * @param cachePath - Full path to the cache file
+ * @returns Parsed JSON data or null if file doesn't exist or is invalid
+ */
+export declare function readFromFile<T>(cachePath: string): Promise<T | null>;
+/**
+ * Write data to a cache file.
+ * @param cachePath - Full path to the cache file
+ * @param data - Data to write
+ */
+export declare function writeToFile<T>(cachePath: string, data: T): Promise<void>;
+/**
+ * Delete a cache file.
+ * @param cachePath - Full path to the cache file
+ * @returns True if file was deleted, false if it didn't exist
+ */
+export declare function deleteFile(cachePath: string): Promise<boolean>;
+/**
+ * Delete a directory and all its contents.
+ * @param dirPath - Directory path to delete
+ * @returns True if directory was deleted, false if it didn't exist
+ */
+export declare function deleteDir(dirPath: string): Promise<boolean>;
+/**
+ * List all versioned cache directories.
+ * @param baseDir - Optional base directory
+ * @returns Array of version strings that have cached data
+ */
+export declare function listCachedVersions(baseDir?: string): Promise<string[]>;
+/**
+ * List all cached primitives for a version.
+ * @param version - Version string
+ * @param baseDir - Optional base directory
+ * @returns Array of primitive names that have cached data
+ */
+export declare function listCachedPrimitives(version: string, baseDir?: string): Promise<string[]>;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/cache/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgBH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,KAAK,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAOR;AAUD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAa1E;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9E;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUjE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAc5E;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB"}

package/dist/cache/storage.js

@@ -0,0 +1,176 @@
+/**
+ * File-based cache storage for Radix primitive data.
+ *
+ * Cache structure:
+ * ~/.limps-headless/
+ *   cache/
+ *     1.0.5/
+ *       dialog.json          # ExtractedPrimitive
+ *       dialog.sig.json      # BehaviorSignature
+ *     1.1.0/
+ *       ...
+ *     latest-resolved.json   # { primitive: { version: "1.1.2", resolvedAt: "..." } }
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+/**
+ * Default cache directory name.
+ */
+const CACHE_DIR_NAME = '.limps-headless';
+/**
+ * Sub-directory for versioned cache data.
+ */
+const CACHE_SUBDIR = 'cache';
+/**
+ * Get the cache directory path.
+ * @param baseDir - Optional base directory (defaults to home directory)
+ * @returns Absolute path to the cache directory
+ */
+export function getCacheDir(baseDir) {
+    const base = baseDir || os.homedir();
+    return path.join(base, CACHE_DIR_NAME, CACHE_SUBDIR);
+}
+/**
+ * Get the versioned cache directory path.
+ * @param version - The Radix version
+ * @param baseDir - Optional base directory
+ * @returns Absolute path to the versioned cache directory
+ */
+export function getVersionedCacheDir(version, baseDir) {
+    return path.join(getCacheDir(baseDir), version);
+}
+/**
+ * Get the path for a cached primitive file.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param type - Type of cache ('data' for ExtractedPrimitive, 'sig' for BehaviorSignature)
+ * @param baseDir - Optional base directory
+ * @returns Absolute file path
+ */
+export function getCachePath(primitive, version, type, baseDir) {
+    const dir = getVersionedCacheDir(version, baseDir);
+    const fileName = type === 'sig'
+        ? `${primitive.toLowerCase()}.sig.json`
+        : `${primitive.toLowerCase()}.json`;
+    return path.join(dir, fileName);
+}
+/**
+ * Ensure the cache directory exists.
+ * @param dirPath - Directory path to create
+ */
+async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+/**
+ * Read data from a cache file.
+ * @param cachePath - Full path to the cache file
+ * @returns Parsed JSON data or null if file doesn't exist or is invalid
+ */
+export async function readFromFile(cachePath) {
+    try {
+        const content = await fs.readFile(cachePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        // File doesn't exist or parse error
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        // Log parse errors but return null
+        console.warn(`Cache read error for ${cachePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Write data to a cache file.
+ * @param cachePath - Full path to the cache file
+ * @param data - Data to write
+ */
+export async function writeToFile(cachePath, data) {
+    const dir = path.dirname(cachePath);
+    await ensureDir(dir);
+    const content = JSON.stringify(data, null, 2);
+    await fs.writeFile(cachePath, content, 'utf-8');
+}
+/**
+ * Delete a cache file.
+ * @param cachePath - Full path to the cache file
+ * @returns True if file was deleted, false if it didn't exist
+ */
+export async function deleteFile(cachePath) {
+    try {
+        await fs.unlink(cachePath);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return false;
+        }
+        throw error;
+    }
+}
+/**
+ * Delete a directory and all its contents.
+ * @param dirPath - Directory path to delete
+ * @returns True if directory was deleted, false if it didn't exist
+ */
+export async function deleteDir(dirPath) {
+    try {
+        await fs.rm(dirPath, { recursive: true, force: true });
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return false;
+        }
+        throw error;
+    }
+}
+/**
+ * List all versioned cache directories.
+ * @param baseDir - Optional base directory
+ * @returns Array of version strings that have cached data
+ */
+export async function listCachedVersions(baseDir) {
+    const cacheDir = getCacheDir(baseDir);
+    try {
+        const entries = await fs.readdir(cacheDir, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .filter((name) => /^\d+\.\d+\.\d+/.test(name)); // Only semver-like directories
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+/**
+ * List all cached primitives for a version.
+ * @param version - Version string
+ * @param baseDir - Optional base directory
+ * @returns Array of primitive names that have cached data
+ */
+export async function listCachedPrimitives(version, baseDir) {
+    const versionDir = getVersionedCacheDir(version, baseDir);
+    try {
+        const entries = await fs.readdir(versionDir);
+        return entries
+            .filter((name) => name.endsWith('.json') && !name.endsWith('.sig.json'))
+            .map((name) => {
+            // Convert filename back to primitive name (capitalize first letter)
+            const baseName = name.replace('.json', '');
+            return baseName.charAt(0).toUpperCase() + baseName.slice(1);
+        });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/cache/storage.js.map

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

package/dist/cache/ttl.d.ts

@@ -0,0 +1,62 @@
+/**
+ * TTL (Time-To-Live) checking logic for cache expiration.
+ */
+/**
+ * TTL constants in milliseconds.
+ */
+export declare const TTL: {
+    /**
+     * TTL for versioned primitive data (7 days).
+     * Versioned data is stable and can be cached longer.
+     */
+    readonly VERSION_DATA: number;
+    /**
+     * TTL for "latest" version resolution (1 hour).
+     * Latest version can change frequently, so we check more often.
+     */
+    readonly LATEST_RESOLUTION: number;
+    /**
+     * TTL for signature data (same as version data).
+     * Signatures derived from versioned data inherit the same TTL.
+     */
+    readonly SIGNATURE_DATA: number;
+};
+/**
+ * Check if a timestamp has expired based on TTL.
+ * @param timestamp - ISO timestamp string
+ * @param ttlMs - Time-to-live in milliseconds
+ * @returns True if the data has expired
+ */
+export declare function isExpired(timestamp: string, ttlMs: number): boolean;
+/**
+ * Check if version data has expired.
+ * @param timestamp - ISO timestamp string (extractedAt)
+ * @returns True if the version data has expired
+ */
+export declare function isVersionDataExpired(timestamp: string): boolean;
+/**
+ * Check if "latest" resolution has expired.
+ * @param timestamp - ISO timestamp string (resolvedAt)
+ * @returns True if the latest resolution has expired
+ */
+export declare function isLatestResolutionExpired(timestamp: string): boolean;
+/**
+ * Check if signature data has expired.
+ * @param timestamp - ISO timestamp string
+ * @returns True if the signature data has expired
+ */
+export declare function isSignatureExpired(timestamp: string): boolean;
+/**
+ * Get the remaining TTL for cached data.
+ * @param timestamp - ISO timestamp string
+ * @param ttlMs - Time-to-live in milliseconds
+ * @returns Remaining time in milliseconds (negative if expired)
+ */
+export declare function getRemainingTtl(timestamp: string, ttlMs: number): number;
+/**
+ * Format remaining TTL as human-readable string.
+ * @param remainingMs - Remaining time in milliseconds
+ * @returns Human-readable string like "2 days", "3 hours", "expired"
+ */
+export declare function formatRemainingTtl(remainingMs: number): string;
+//# sourceMappingURL=ttl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../src/cache/ttl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,GAAG;IACd;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAKnE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAoB9D"}

package/dist/cache/ttl.js

@@ -0,0 +1,96 @@
+/**
+ * TTL (Time-To-Live) checking logic for cache expiration.
+ */
+/**
+ * TTL constants in milliseconds.
+ */
+export const TTL = {
+    /**
+     * TTL for versioned primitive data (7 days).
+     * Versioned data is stable and can be cached longer.
+     */
+    VERSION_DATA: 7 * 24 * 60 * 60 * 1000,
+    /**
+     * TTL for "latest" version resolution (1 hour).
+     * Latest version can change frequently, so we check more often.
+     */
+    LATEST_RESOLUTION: 60 * 60 * 1000,
+    /**
+     * TTL for signature data (same as version data).
+     * Signatures derived from versioned data inherit the same TTL.
+     */
+    SIGNATURE_DATA: 7 * 24 * 60 * 60 * 1000,
+};
+/**
+ * Check if a timestamp has expired based on TTL.
+ * @param timestamp - ISO timestamp string
+ * @param ttlMs - Time-to-live in milliseconds
+ * @returns True if the data has expired
+ */
+export function isExpired(timestamp, ttlMs) {
+    const cachedTime = new Date(timestamp).getTime();
+    const now = Date.now();
+    const age = now - cachedTime;
+    return age >= ttlMs;
+}
+/**
+ * Check if version data has expired.
+ * @param timestamp - ISO timestamp string (extractedAt)
+ * @returns True if the version data has expired
+ */
+export function isVersionDataExpired(timestamp) {
+    return isExpired(timestamp, TTL.VERSION_DATA);
+}
+/**
+ * Check if "latest" resolution has expired.
+ * @param timestamp - ISO timestamp string (resolvedAt)
+ * @returns True if the latest resolution has expired
+ */
+export function isLatestResolutionExpired(timestamp) {
+    return isExpired(timestamp, TTL.LATEST_RESOLUTION);
+}
+/**
+ * Check if signature data has expired.
+ * @param timestamp - ISO timestamp string
+ * @returns True if the signature data has expired
+ */
+export function isSignatureExpired(timestamp) {
+    return isExpired(timestamp, TTL.SIGNATURE_DATA);
+}
+/**
+ * Get the remaining TTL for cached data.
+ * @param timestamp - ISO timestamp string
+ * @param ttlMs - Time-to-live in milliseconds
+ * @returns Remaining time in milliseconds (negative if expired)
+ */
+export function getRemainingTtl(timestamp, ttlMs) {
+    const cachedTime = new Date(timestamp).getTime();
+    const now = Date.now();
+    const age = now - cachedTime;
+    return ttlMs - age;
+}
+/**
+ * Format remaining TTL as human-readable string.
+ * @param remainingMs - Remaining time in milliseconds
+ * @returns Human-readable string like "2 days", "3 hours", "expired"
+ */
+export function formatRemainingTtl(remainingMs) {
+    if (remainingMs <= 0) {
+        return 'expired';
+    }
+    const seconds = Math.floor(remainingMs / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0) {
+        return `${days} day${days === 1 ? '' : 's'}`;
+    }
+    if (hours > 0) {
+        return `${hours} hour${hours === 1 ? '' : 's'}`;
+    }
+    if (minutes > 0) {
+        return `${minutes} minute${minutes === 1 ? '' : 's'}`;
+    }
+    return `${seconds} second${seconds === 1 ? '' : 's'}`;
+}
+//# sourceMappingURL=ttl.js.map

package/dist/cache/ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.js","sourceRoot":"","sources":["../../src/cache/ttl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB;;;OAGG;IACH,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IAErC;;;OAGG;IACH,iBAAiB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IAEjC;;;OAGG;IACH,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CAC/B,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,KAAa;IACxD,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,GAAG,GAAG,UAAU,CAAC;IAC7B,OAAO,GAAG,IAAI,KAAK,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,OAAO,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,KAAa;IAC9D,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,GAAG,GAAG,UAAU,CAAC;IAC7B,OAAO,KAAK,GAAG,GAAG,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAEpC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,GAAG,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACxD,CAAC"}

package/dist/cli/commands/analyze.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI command for analyzing components.
+ */
+import type { Command } from 'commander';
+export declare function registerAnalyzeCommand(program: Command): void;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/cli/commands/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6B7D"}

package/dist/cli/commands/analyze.js

@@ -0,0 +1,43 @@
+/**
+ * CLI command for analyzing components.
+ */
+import { handleAnalyzeComponent } from '../../tools/analyze-component.js';
+function printJson(text, json) {
+    if (json) {
+        console.log(text);
+        return;
+    }
+    const data = JSON.parse(text);
+    console.log(`${data.component} (${data.filePath})`);
+    console.log(`Action: ${data.recommendation.action}`);
+    console.log(`Confidence: ${data.recommendation.confidence}`);
+    console.log(`Reason: ${data.recommendation.reason}`);
+    if (data.isAmbiguous) {
+        console.log('Ambiguous: true');
+    }
+}
+export function registerAnalyzeCommand(program) {
+    program
+        .command('analyze')
+        .description('Analyze a React component for legacy Radix matches to inform Base UI migration (run from project dir; path is relative to cwd)')
+        .argument('<file>', 'Path to a .ts/.tsx component (relative to cwd)')
+        .option('-v, --version <version>', 'Radix version to compare against', 'latest')
+        .option('-t, --threshold <number>', 'Minimum confidence threshold', '40')
+        .option('-p, --provider <provider>', 'Component library provider', 'radix')
+        .option('--ruleset <ruleset>', 'Ruleset selection: base-ui, radix-legacy, or both', 'base-ui')
+        .option('--evidence <level>', 'Evidence verbosity: summary or verbose', 'summary')
+        .option('--json', 'Output raw JSON')
+        .action(async (filePath, options) => {
+        const response = await handleAnalyzeComponent({
+            filePath,
+            radixVersion: options.version,
+            threshold: Number(options.threshold),
+            provider: options.provider,
+            ruleset: options.ruleset,
+            evidence: options.evidence,
+        });
+        const text = response.content[0]?.text ?? '{}';
+        printJson(text, Boolean(options.json));
+    });
+}
+//# sourceMappingURL=analyze.js.map