pipecraft 0.29.2 → 0.36.2

package/dist/utils/idempotency.js

@@ -1,304 +0,0 @@
-/**
- * Idempotency and Caching Utilities
- *
- * This module implements intelligent caching to avoid unnecessary workflow regeneration.
- * It tracks file hashes and modification times for:
- * - Configuration files (.pipecraftrc.json)
- * - Template source files (src/templates/)
- * - Generator code (src/generators/)
- *
- * Workflows are only regenerated when relevant source files have changed,
- * significantly improving performance during iterative development.
- *
- * The cache is stored in `.pipecraft-cache.json` and contains hashes
- * of all tracked files along with metadata.
- *
- * @module utils/idempotency
- */
-import { createHash } from 'crypto';
-import { readFileSync, existsSync, writeFileSync, statSync } from 'fs';
-/**
- * Manager for idempotent workflow generation through intelligent caching.
- *
- * This class tracks changes to configuration and template files to determine
- * when workflows need to be regenerated. It creates cryptographic hashes of
- * files and directories to detect changes efficiently.
- *
- * @example
- * ```typescript
- * const manager = new IdempotencyManager(config)
- *
- * if (await manager.hasChanges()) {
- *   // Generate workflows
- *   await generateWorkflows()
- *   // Update cache after successful generation
- *   await manager.updateCache()
- * } else {
- *   console.log('No changes detected, skipping regeneration')
- * }
- * ```
- */
-export class IdempotencyManager {
-    cacheFile;
-    config;
-    /**
-     * Create a new IdempotencyManager instance.
-     *
-     * @param config - PipeCraft configuration object
-     * @param cacheFile - Path to cache file (default: .pipecraft-cache.json)
-     */
-    constructor(config, cacheFile = '.pipecraft-cache.json') {
-        this.config = config;
-        this.cacheFile = cacheFile;
-    }
-    /**
-     * Calculate cryptographic hash for a file or directory.
-     *
-     * For files: Hashes content + mtime + size to detect any changes
-     * For directories: Recursively hashes all files within
-     *
-     * Returns empty string if the path doesn't exist.
-     *
-     * @param filePath - Path to file or directory to hash
-     * @param algorithm - Hashing algorithm (default: sha256)
-     * @returns Hex-encoded hash string
-     *
-     * @example
-     * ```typescript
-     * const configHash = await manager.calculateHash('.pipecraftrc.json')
-     * const templateHash = await manager.calculateHash('src/templates')
-     * ```
-     */
-    async calculateHash(filePath, algorithm = 'sha256') {
-        if (!existsSync(filePath)) {
-            return '';
-        }
-        const stats = statSync(filePath);
-        if (stats.isDirectory()) {
-            // For directories, hash all files recursively
-            return await this.hashDirectory(filePath, algorithm);
-        }
-        else {
-            // For files, hash content + metadata
-            // Including mtime and size ensures any change is detected
-            const content = readFileSync(filePath);
-            const hash = createHash(algorithm);
-            hash.update(content);
-            hash.update(stats.mtime.toString());
-            hash.update(stats.size.toString());
-            return hash.digest('hex');
-        }
-    }
-    /**
-     * Hash directory contents recursively.
-     *
-     * Traverses all files in the directory tree and combines their hashes
-     * along with metadata into a single directory hash. This allows detecting
-     * when any file within the directory structure has changed.
-     *
-     * @param dirPath - Path to directory to hash
-     * @param algorithm - Hashing algorithm
-     * @returns Hex-encoded hash string representing the entire directory
-     * @private
-     */
-    async hashDirectory(dirPath, algorithm) {
-        const fs = await import('fs');
-        const path = await import('path');
-        const hash = createHash(algorithm);
-        // Recursively hash all files in the directory tree
-        const hashDir = (dir) => {
-            const items = fs.readdirSync(dir);
-            for (const item of items) {
-                const itemPath = path.join(dir, item);
-                const stats = fs.statSync(itemPath);
-                if (stats.isDirectory()) {
-                    hashDir(itemPath);
-                }
-                else {
-                    // Include file content and metadata in hash
-                    const content = fs.readFileSync(itemPath);
-                    hash.update(content);
-                    hash.update(stats.mtime.toString());
-                    hash.update(stats.size.toString());
-                }
-            }
-        };
-        hashDir(dirPath);
-        return hash.digest('hex');
-    }
-    /**
-     * Load rebuild cache from filesystem.
-     *
-     * Reads and parses the cache file containing previous generation state.
-     * Returns null if cache doesn't exist or can't be parsed.
-     *
-     * @returns Parsed cache object or null if unavailable
-     */
-    loadCache() {
-        if (!existsSync(this.cacheFile)) {
-            return null;
-        }
-        try {
-            const content = readFileSync(this.cacheFile, 'utf8');
-            return JSON.parse(content);
-        }
-        catch (error) {
-            console.warn(`Failed to load cache file: ${error.message}`);
-            return null;
-        }
-    }
-    /**
-     * Save rebuild cache to filesystem.
-     *
-     * Writes the cache object to disk as formatted JSON.
-     * Failures are logged as warnings but don't throw errors.
-     *
-     * @param cache - Cache object to persist
-     */
-    saveCache(cache) {
-        try {
-            writeFileSync(this.cacheFile, JSON.stringify(cache, null, 2));
-        }
-        catch (error) {
-            console.warn(`Failed to save cache file: ${error.message}`);
-        }
-    }
-    /**
-     * Check if any tracked files have changed since last generation.
-     *
-     * Compares current file hashes against cached values to detect changes in:
-     * - Configuration file (.pipecraftrc.json)
-     * - Template source files (src/templates/)
-     * - Generator code (src/generators/)
-     *
-     * Returns true if:
-     * - Rebuild is disabled (always regenerate)
-     * - Force regenerate flag is set
-     * - No cache exists
-     * - Any tracked file has changed
-     *
-     * @returns true if workflows should be regenerated
-     *
-     * @example
-     * ```typescript
-     * if (await manager.hasChanges()) {
-     *   console.log('Changes detected, regenerating workflows...')
-     *   await generateWorkflows()
-     *   await manager.updateCache()
-     * }
-     * ```
-     */
-    async hasChanges() {
-        // Always regenerate if idempotency is disabled
-        if (!this.config.rebuild?.enabled) {
-            return true;
-        }
-        // Always regenerate if force flag is set
-        if (this.config.rebuild?.forceRegenerate) {
-            return true;
-        }
-        const cache = this.loadCache();
-        if (!cache) {
-            return true; // No cache exists, need to generate
-        }
-        // Check if configuration file has changed
-        const configHash = await this.calculateHash('.pipecraftrc.json');
-        if (cache.configHash !== configHash) {
-            return true;
-        }
-        // Check if template source files have changed
-        const templateDir = 'src/templates';
-        if (existsSync(templateDir)) {
-            const templateHash = await this.calculateHash(templateDir);
-            if (cache.files[templateDir]?.hash !== templateHash) {
-                return true;
-            }
-        }
-        // Check if generator source files have changed
-        const sourceDir = 'src/generators';
-        if (existsSync(sourceDir)) {
-            const sourceHash = await this.calculateHash(sourceDir);
-            if (cache.files[sourceDir]?.hash !== sourceHash) {
-                return true;
-            }
-        }
-        return false;
-    }
-    /**
-     * Update cache with current file states after successful generation.
-     *
-     * Should be called after workflows are successfully generated to save
-     * the current state of all tracked files. This allows future runs to
-     * skip regeneration if nothing has changed.
-     *
-     * @example
-     * ```typescript
-     * await generateWorkflows()
-     * await manager.updateCache() // Save current state
-     * ```
-     */
-    async updateCache() {
-        const cache = {
-            files: {},
-            configHash: await this.calculateHash('.pipecraftrc.json'),
-            lastGenerated: Date.now(),
-            version: '1.0.0'
-        };
-        // Cache template directory state
-        const templateDir = 'src/templates';
-        if (existsSync(templateDir)) {
-            cache.files[templateDir] = {
-                path: templateDir,
-                hash: await this.calculateHash(templateDir),
-                mtime: statSync(templateDir).mtime.getTime(),
-                size: 0 // Directory size not meaningful
-            };
-        }
-        // Cache generator directory state
-        const sourceDir = 'src/generators';
-        if (existsSync(sourceDir)) {
-            cache.files[sourceDir] = {
-                path: sourceDir,
-                hash: await this.calculateHash(sourceDir),
-                mtime: statSync(sourceDir).mtime.getTime(),
-                size: 0
-            };
-        }
-        this.saveCache(cache);
-    }
-    /**
-     * Check if a specific file should be regenerated.
-     *
-     * Similar to hasChanges() but checks a single file instead of the
-     * entire project. Useful for selective regeneration.
-     *
-     * @param filePath - Path to file to check
-     * @returns true if file should be regenerated
-     *
-     * @example
-     * ```typescript
-     * if (await manager.shouldRegenerateFile('.github/workflows/pipeline.yml')) {
-     *   await generatePipeline()
-     * }
-     * ```
-     */
-    async shouldRegenerateFile(filePath) {
-        if (!this.config.rebuild?.enabled) {
-            return true;
-        }
-        if (this.config.rebuild?.forceRegenerate) {
-            return true;
-        }
-        const cache = this.loadCache();
-        if (!cache) {
-            return true;
-        }
-        const currentHash = await this.calculateHash(filePath);
-        const cachedFile = cache.files[filePath];
-        if (!cachedFile) {
-            return true; // File not in cache, needs generation
-        }
-        return cachedFile.hash !== currentHash;
-    }
-}
-//# sourceMappingURL=idempotency.js.map

package/dist/utils/idempotency.js.map

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