sandstream-kit 1.0.0

package/dist/id-generator.js

@@ -0,0 +1,47 @@
+/**
+ * Centralized ID generation utility
+ * Consolidates Date.now() + random pattern used across services
+ */
+/**
+ * Generate unique ID with optional prefix
+ * Pattern: prefix + timestamp-randomString (max 255 chars)
+ */
+export function generateId(prefix = "") {
+    const id = `${prefix}${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    return id.slice(0, 255);
+}
+/**
+ * Generate prefixed IDs for domain entities
+ */
+export const IdGenerators = {
+    partner: (suffix) => generateId(`partner-${suffix || ""}`),
+    agreement: (suffix) => generateId(`agree-${suffix || ""}`),
+    apiKey: (suffix) => generateId(`key-${suffix || ""}`),
+    coPlugin: (suffix) => generateId(`coplugin-${suffix || ""}`),
+    featured: (suffix) => generateId(`featured-${suffix || ""}`),
+    feedback: (suffix) => generateId(`feedback-${suffix || ""}`),
+    betaDev: (suffix) => generateId(`betadev-${suffix || ""}`),
+    refine: (suffix) => generateId(`refine-${suffix || ""}`),
+    payout: (suffix) => generateId(`payout-${suffix || ""}`),
+    grant: (suffix) => generateId(`grant-${suffix || ""}`),
+    approval: (suffix) => generateId(`approval-${suffix || ""}`),
+    alert: (suffix) => generateId(`alert-${suffix || ""}`),
+    trace: (suffix) => generateId(`trace-${suffix || ""}`),
+    span: (suffix) => generateId(`span-${suffix || ""}`),
+    notification: (suffix) => generateId(`notif-${suffix || ""}`),
+    publish: (suffix) => generateId(`pub-${suffix || ""}`),
+    documentation: (suffix) => generateId(`doc-${suffix || ""}`),
+    error: (suffix) => generateId(`error-${suffix || ""}`),
+    errorGroup: (suffix) => generateId(`group-${suffix || ""}`),
+    search: (suffix) => generateId(`search-${suffix || ""}`),
+    review: (suffix) => generateId(`review-${suffix || ""}`),
+    report: (suffix) => generateId(`report-${suffix || ""}`),
+    modAction: (suffix) => generateId(`action-${suffix || ""}`),
+    appeal: (suffix) => generateId(`appeal-${suffix || ""}`),
+    audit: (suffix) => generateId(`audit-${suffix || ""}`),
+    policy: (suffix) => generateId(`policy-${suffix || ""}`),
+    transaction: (suffix) => generateId(`txn-${suffix || ""}`),
+    sla: (suffix) => generateId(`sla-${suffix || ""}`),
+    breach: (suffix) => generateId(`breach-${suffix || ""}`),
+};
+//# sourceMappingURL=id-generator.js.map

package/dist/id-generator.js.map

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

package/dist/image-optimizer.d.ts

@@ -0,0 +1,92 @@
+export interface ImageMetadata {
+    filename: string;
+    originalSize: number;
+    optimizedSize: number;
+    width: number;
+    height: number;
+    format: "jpeg" | "png" | "webp" | "avif";
+    quality: number;
+    compressionRatio: number;
+}
+export interface OptimizationProfile {
+    name: string;
+    maxWidth: number;
+    maxHeight: number;
+    quality: number;
+    format: string;
+}
+export interface ResponsiveVariant {
+    width: number;
+    height: number;
+    url: string;
+    size: number;
+}
+export declare class ImageOptimizer {
+    private optimizationStats;
+    private profiles;
+    private thumbnailCache;
+    /**
+     * Create optimization profile.
+     */
+    createProfile(profile: OptimizationProfile): void;
+    /**
+     * Get optimization profile.
+     */
+    getProfile(profileName: string): OptimizationProfile | null;
+    /**
+     * Get all profiles.
+     */
+    getAllProfiles(): OptimizationProfile[];
+    /**
+     * Delete profile.
+     */
+    deleteProfile(profileName: string): boolean;
+    /**
+     * Optimize image.
+     */
+    optimizeImage(filename: string, originalSize: number, width: number, height: number, profile: OptimizationProfile): ImageMetadata;
+    /**
+     * Generate responsive image variants.
+     */
+    generateResponsiveVariants(filename: string, baseUrl: string, widths?: number[]): ResponsiveVariant[];
+    /**
+     * Get responsive variants for image.
+     */
+    getResponsiveVariants(filename: string): ResponsiveVariant[];
+    /**
+     * Generate lazy loading markup.
+     */
+    generateLazyLoadMarkup(filename: string, baseUrl: string, alt: string): string;
+    /**
+     * Generate picture element with srcset.
+     */
+    generatePictureElement(filename: string, baseUrl: string, alt: string): string;
+    /**
+     * Recommend best format for image.
+     */
+    recommendFormat(originalFormat: string, targetQuality: number): "webp" | "avif" | "jpeg" | "png";
+    /**
+     * Check if format supports transparency.
+     */
+    supportsTransparency(format: string): boolean;
+    /**
+     * Get optimization statistics.
+     */
+    getOptimizationStats(): {
+        totalImages: number;
+        totalOriginalSize: number;
+        totalOptimizedSize: number;
+        averageCompressionRatio: number;
+    };
+    /**
+     * Get metadata for image.
+     */
+    getImageMetadata(filename: string): ImageMetadata | null;
+    /**
+     * Get all optimized images.
+     */
+    getAllOptimizedImages(): ImageMetadata[];
+    getOptimizationCache(): Map<string, ImageMetadata>;
+    getProfilesCache(): Map<string, OptimizationProfile>;
+    getThumbnailCache(): Map<string, ResponsiveVariant[]>;
+}

package/dist/image-optimizer.js

@@ -0,0 +1,202 @@
+// ─── Types ────────────────────────────────────────────────────────────────────
+// ─── ImageOptimizer ───────────────────────────────────────────────────────────
+export class ImageOptimizer {
+    optimizationStats = new Map();
+    profiles = new Map();
+    thumbnailCache = new Map();
+    // ─── Optimization Profiles ────────────────────────────────────────────────
+    /**
+     * Create optimization profile.
+     */
+    createProfile(profile) {
+        this.profiles.set(profile.name, profile);
+    }
+    /**
+     * Get optimization profile.
+     */
+    getProfile(profileName) {
+        return this.profiles.get(profileName) || null;
+    }
+    /**
+     * Get all profiles.
+     */
+    getAllProfiles() {
+        return [...this.profiles.values()];
+    }
+    /**
+     * Delete profile.
+     */
+    deleteProfile(profileName) {
+        return this.profiles.delete(profileName);
+    }
+    // ─── Image Optimization ───────────────────────────────────────────────────
+    /**
+     * Optimize image.
+     */
+    optimizeImage(filename, originalSize, width, height, profile) {
+        // Calculate new dimensions based on profile
+        let newWidth = width;
+        let newHeight = height;
+        if (width > profile.maxWidth) {
+            const ratio = profile.maxWidth / width;
+            newWidth = profile.maxWidth;
+            newHeight = Math.round(height * ratio);
+        }
+        if (newHeight > profile.maxHeight) {
+            const ratio = profile.maxHeight / newHeight;
+            newHeight = profile.maxHeight;
+            newWidth = Math.round(newWidth * ratio);
+        }
+        // Estimate optimized size based on compression
+        const optimizedSize = Math.round(originalSize * (0.5 + (profile.quality / 100) * 0.5));
+        const metadata = {
+            filename,
+            originalSize,
+            optimizedSize,
+            width: newWidth,
+            height: newHeight,
+            format: (profile.format || "webp"),
+            quality: profile.quality,
+            compressionRatio: Math.round((1 - optimizedSize / originalSize) * 100),
+        };
+        this.optimizationStats.set(filename, metadata);
+        return metadata;
+    }
+    /**
+     * Generate responsive image variants.
+     */
+    generateResponsiveVariants(filename, baseUrl, widths = [320, 640, 1024]) {
+        const variants = [];
+        const cached = this.thumbnailCache.get(filename);
+        if (cached) {
+            return cached;
+        }
+        for (const width of widths) {
+            const variant = {
+                width,
+                height: Math.round((width / 16) * 9), // 16:9 aspect ratio
+                url: `${baseUrl}/${filename}?w=${width}`,
+                size: Math.round(50 * (width / 320)), // Rough size estimate
+            };
+            variants.push(variant);
+        }
+        this.thumbnailCache.set(filename, variants);
+        return variants;
+    }
+    /**
+     * Get responsive variants for image.
+     */
+    getResponsiveVariants(filename) {
+        return this.thumbnailCache.get(filename) || [];
+    }
+    // ─── Lazy Loading ────────────────────────────────────────────────────────
+    /**
+     * Generate lazy loading markup.
+     */
+    generateLazyLoadMarkup(filename, baseUrl, alt) {
+        const metadata = this.optimizationStats.get(filename);
+        if (!metadata)
+            return "";
+        const placeholderUrl = `${baseUrl}/${filename}?w=20&blur=5`;
+        const mainUrl = `${baseUrl}/${filename}`;
+        return `
+<img
+  src="${placeholderUrl}"
+  alt="${alt}"
+  width="${metadata.width}"
+  height="${metadata.height}"
+  loading="lazy"
+  data-src="${mainUrl}"
+  class="lazy-image"
+/>`.trim();
+    }
+    /**
+     * Generate picture element with srcset.
+     */
+    generatePictureElement(filename, baseUrl, alt) {
+        const variants = this.getResponsiveVariants(filename);
+        const metadata = this.optimizationStats.get(filename);
+        if (!metadata || variants.length === 0)
+            return "";
+        const srcset = variants
+            .map((v) => `${v.url} ${v.width}w`)
+            .join(", ");
+        return `
+<picture>
+  <source srcset="${srcset}" type="image/webp" />
+  <img
+    src="${baseUrl}/${filename}"
+    alt="${alt}"
+    width="${metadata.width}"
+    height="${metadata.height}"
+    loading="lazy"
+  />
+</picture>`.trim();
+    }
+    // ─── Format Conversion ─────────────────────────────────────────────────────
+    /**
+     * Recommend best format for image.
+     */
+    recommendFormat(originalFormat, targetQuality) {
+        // AVIF: better compression, newer format (highest quality first)
+        if (targetQuality >= 90)
+            return "avif";
+        // WebP: good compression, broad support
+        if (targetQuality >= 75)
+            return "webp";
+        // JPEG: legacy support, good quality
+        if (originalFormat === "jpeg")
+            return "jpeg";
+        return "webp";
+    }
+    /**
+     * Check if format supports transparency.
+     */
+    supportsTransparency(format) {
+        return ["png", "webp", "avif"].includes(format.toLowerCase());
+    }
+    // ─── Statistics ────────────────────────────────────────────────────────────
+    /**
+     * Get optimization statistics.
+     */
+    getOptimizationStats() {
+        let totalOriginal = 0;
+        let totalOptimized = 0;
+        for (const meta of this.optimizationStats.values()) {
+            totalOriginal += meta.originalSize;
+            totalOptimized += meta.optimizedSize;
+        }
+        const avgCompressionRatio = this.optimizationStats.size > 0
+            ? Math.round(((totalOriginal - totalOptimized) / totalOriginal) * 100)
+            : 0;
+        return {
+            totalImages: this.optimizationStats.size,
+            totalOriginalSize: totalOriginal,
+            totalOptimizedSize: totalOptimized,
+            averageCompressionRatio: avgCompressionRatio,
+        };
+    }
+    /**
+     * Get metadata for image.
+     */
+    getImageMetadata(filename) {
+        return this.optimizationStats.get(filename) || null;
+    }
+    /**
+     * Get all optimized images.
+     */
+    getAllOptimizedImages() {
+        return [...this.optimizationStats.values()];
+    }
+    // ─── Cache helpers ────────────────────────────────────────────────────────
+    getOptimizationCache() {
+        return this.optimizationStats;
+    }
+    getProfilesCache() {
+        return this.profiles;
+    }
+    getThumbnailCache() {
+        return this.thumbnailCache;
+    }
+}
+//# sourceMappingURL=image-optimizer.js.map

package/dist/image-optimizer.js.map

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

package/dist/install.d.ts

@@ -0,0 +1,15 @@
+import type { ToolConfig } from "./config.js";
+import { type ToolStatus } from "./check-tools.js";
+export interface InstallResult {
+    name: string;
+    action: "installed" | "already_ok" | "failed";
+    detail: string;
+}
+export interface InstallDeps {
+    checkTools: (tools: ToolConfig) => Promise<ToolStatus[]>;
+    miseInstall: (tool: string, version: string) => Promise<{
+        ok: boolean;
+        detail: string;
+    }>;
+}
+export declare function installTools(tools: ToolConfig, deps?: InstallDeps): Promise<InstallResult[]>;

package/dist/install.js

@@ -0,0 +1,59 @@
+import { checkTools } from "./check-tools.js";
+import { exec } from "./utils/exec.js";
+async function miseInstall(tool, version) {
+    const versionArg = version === "latest" ? "latest" : version;
+    try {
+        await exec("mise", ["install", `${tool}@${versionArg}`], {
+            timeout: 120_000,
+            env: { ...process.env },
+        });
+        // Activate the tool in the current project
+        await exec("mise", ["use", `${tool}@${versionArg}`], {
+            timeout: 30_000,
+            env: { ...process.env },
+        });
+        return { ok: true, detail: `Installed ${tool}@${versionArg} via mise` };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, detail: message.split("\n")[0] };
+    }
+}
+const defaultDeps = { checkTools, miseInstall };
+export async function installTools(tools, deps = defaultDeps) {
+    const statuses = await deps.checkTools(tools);
+    const results = [];
+    for (const status of statuses) {
+        if (status.ok) {
+            results.push({
+                name: status.name,
+                action: "already_ok",
+                detail: `${status.installed} satisfies ${status.required}`,
+            });
+            continue;
+        }
+        const { ok, detail } = await deps.miseInstall(status.name, status.required);
+        if (!ok) {
+            results.push({ name: status.name, action: "failed", detail });
+            continue;
+        }
+        // Re-check that installed version satisfies requirement
+        const [verified] = await deps.checkTools({ [status.name]: status.required });
+        if (verified.ok) {
+            results.push({
+                name: status.name,
+                action: "installed",
+                detail: `${verified.installed} satisfies ${status.required}`,
+            });
+        }
+        else {
+            results.push({
+                name: status.name,
+                action: "failed",
+                detail: `Installed ${verified.installed ?? "unknown"} but need ${status.required}`,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/lock.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Lock file management for kit
+ * Tracks exact versions of skills and CLI tools
+ */
+export interface SkillsLock {
+    version: number;
+    kit?: string;
+    skills: Record<string, SkillLockEntry>;
+}
+export interface SkillLockEntry {
+    source: string;
+    sourceType: "clawhub" | "github" | "github-private" | "local";
+    computedHash: string;
+    auth?: string;
+    installedAt: string;
+}
+export interface CliLock {
+    version: number;
+    tools: Record<string, CliLockEntry>;
+}
+export interface CliLockEntry {
+    version: string;
+    source: "mise" | "npm" | "pip" | "manual";
+    auth?: string;
+    installedAt: string;
+}
+/**
+ * kit metadata - identifies which kit this project uses
+ */
+export interface kitMeta {
+    name: string;
+    version: string;
+}
+/**
+ * Read skills lock file
+ */
+export declare function readSkillsLock(): Promise<SkillsLock | null>;
+/**
+ * Write skills lock file
+ */
+export declare function writeSkillsLock(lock: SkillsLock): Promise<void>;
+/**
+ * Read CLI lock file
+ */
+export declare function readCliLock(): Promise<CliLock | null>;
+/**
+ * Write CLI lock file
+ */
+export declare function writeCliLock(lock: CliLock): Promise<void>;
+/**
+ * Read kit metadata file
+ */
+export declare function readkitMeta(): Promise<kitMeta | null>;
+/**
+ * Write kit metadata file
+ */
+export declare function writekitMeta(meta: kitMeta): Promise<void>;
+/**
+ * Update skills lock with installed skills
+ * Accepts version strings and converts to hash-based format
+ */
+export declare function updateSkillsLock(skills: Record<string, string>, kit?: string): Promise<void>;
+/**
+ * Update CLI lock with installed tools
+ */
+export declare function updateCliLock(tools: Record<string, {
+    version: string;
+    source: CliLockEntry["source"];
+    auth?: string;
+}>): Promise<void>;
+/**
+ * Check if lock files are in sync with config
+ */
+export interface LockStatus {
+    skillsLockExists: boolean;
+    cliLockExists: boolean;
+    skillsInSync: boolean;
+    cliInSync: boolean;
+    missingSkills: string[];
+    missingTools: string[];
+}
+export declare function checkLockStatus(configSkills: Record<string, string>, configTools: Record<string, string>): Promise<LockStatus>;