pipecraft 0.29.3 → 0.36.14

package/dist/templates/workflows/pipeline-nx.yml.tpl.js

@@ -1,196 +0,0 @@
-/**
- * Nx Pipeline Template
- *
- * Generates an Nx-optimized workflow that uses `nx affected` to intelligently test
- * only changed projects. Runs all Nx tasks sequentially in a single job, leveraging
- * Nx's built-in caching and parallel execution.
- *
- * This is Option 1 (Sequential Strategy) - simple, fast, and leverages Nx's intelligence.
- */
-import { renderTemplate, toFile } from '@featherscloud/pinion';
-import { parseDocument, stringify } from 'yaml';
-import fs from 'fs';
-import { logger } from '../../utils/logger.js';
-import { applyPathOperations, createValueFromString } from '../../utils/ast-path-operations.js';
-import { createHeaderOperations, createChangesJobOperation, createDomainTestJobOperations, createDomainDeployJobOperations, createDomainRemoteTestJobOperations, createVersionJobOperation, createTagPromoteReleaseOperations, getDomainJobNames } from './shared/index.js';
-import { formatIfConditions } from '../yaml-format-utils.js';
-/**
- * Create the nx-ci job operation (Nx-specific)
- */
-function createNxCiJobOperation(ctx) {
-    const { config } = ctx;
-    const nxConfig = config.nx;
-    const packageManager = config.packageManager || 'npm';
-    const enableCache = nxConfig.enableCache !== false;
-    const taskSteps = nxConfig.tasks
-        .map(task => `      - name: Run Nx Affected - ${task}
-        run: npx nx affected --target=${task} --base=\${{ inputs.baseRef || '${nxConfig.baseRef || 'origin/main'}' }}`)
-        .join('\n');
-    const cacheStep = enableCache
-        ? `
-      - name: Cache Nx
-        uses: actions/cache@v4
-        with:
-          path: .nx/cache
-          # Cache key includes run_number to allow saving updated cache on each run
-          # Nx cache accumulates computation results, so we want to save after every run
-          # restore-keys ensure we start from the most recent cache on this branch
-          key: nx-\${{ runner.os }}-\${{ hashFiles('package-lock.json') }}-\${{ github.ref_name }}-\${{ github.run_number }}
-          restore-keys: |
-            nx-\${{ runner.os }}-\${{ hashFiles('package-lock.json') }}-\${{ github.ref_name }}-
-            nx-\${{ runner.os }}-\${{ hashFiles('package-lock.json') }}-
-            nx-\${{ runner.os }}-
-`
-        : '';
-    return {
-        path: 'jobs.nx-ci',
-        operation: 'overwrite',
-        commentBefore: `
-=============================================================================
-NX CI - All Tasks Sequential (⚠️  Managed by Pipecraft - do not modify)
-=============================================================================
-This job runs all Nx tasks sequentially using \`nx affected\`.
-Nx handles dependency detection, caching, and parallel execution internally.
-`,
-        value: createValueFromString(`
-    needs: changes
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout Code
-        uses: actions/checkout@v4
-        with:
-          ref: \${{ inputs.commitSha || github.sha }}
-          fetch-depth: 0
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '24'
-
-      - name: Install Dependencies
-        run: |
-          case "${packageManager}" in
-            pnpm)
-              corepack enable
-              pnpm install --frozen-lockfile || pnpm install
-              ;;
-            yarn)
-              yarn install --frozen-lockfile || yarn install
-              ;;
-            npm)
-              npm ci || npm install
-              ;;
-            *)
-              npm install
-              ;;
-          esac
-        env:
-          packageManager: ${packageManager}
-${cacheStep}
-${taskSteps}
-  `)
-    };
-}
-/**
- * Main generator that handles merging with existing workflow
- */
-export const generate = (ctx) => Promise.resolve(ctx)
-    .then(ctx => {
-    const filePath = `${ctx.cwd || process.cwd()}/.github/workflows/pipeline.yml`;
-    const { config, branchFlow } = ctx;
-    const domains = config.domains || {};
-    const nxConfig = config.nx;
-    // Get domain job names for dependency management
-    const { testJobs, deployJobs, remoteTestJobs } = getDomainJobNames(domains);
-    // Build operations array
-    const operations = [
-        // Header (name, run-name, on triggers)
-        ...createHeaderOperations({ branchFlow }),
-        // Changes detection (Nx-enabled)
-        createChangesJobOperation({
-            domains,
-            useNx: true,
-            baseRef: nxConfig.baseRef || 'origin/main'
-        }),
-        // Nx CI job (Nx-specific!)
-        createNxCiJobOperation(ctx),
-        // Domain test jobs (preserved for user customization)
-        ...createDomainTestJobOperations({ domains }),
-        // Version calculation
-        createVersionJobOperation({
-            testJobNames: testJobs,
-            nxEnabled: true,
-            baseRef: nxConfig.baseRef || 'origin/main'
-        }),
-        // Domain deploy jobs (preserved for user customization)
-        ...createDomainDeployJobOperations({ domains }),
-        // Domain remote test jobs (preserved for user customization)
-        ...createDomainRemoteTestJobOperations({ domains }),
-        // Tag, promote, release
-        ...createTagPromoteReleaseOperations({
-            branchFlow,
-            deployJobNames: deployJobs,
-            remoteTestJobNames: remoteTestJobs
-        })
-    ];
-    // Check if file exists
-    if (!fs.existsSync(filePath)) {
-        logger.verbose('📝 Creating new Nx pipeline');
-        // Create new document with empty YAML map
-        const doc = parseDocument('{}');
-        if (doc.contents) {
-            applyPathOperations(doc.contents, operations, doc);
-        }
-        const yamlContent = stringify(doc, { lineWidth: 0, minContentWidth: 0 });
-        const formattedContent = formatIfConditions(yamlContent);
-        return { ...ctx, yamlContent: formattedContent, mergeStatus: 'created' };
-    }
-    // Parse existing file
-    const existingContent = fs.readFileSync(filePath, 'utf8');
-    const doc = parseDocument(existingContent);
-    // Get managed jobs (always overwritten)
-    const managedJobs = new Set(['changes', 'nx-ci', 'version', 'tag', 'promote', 'release']);
-    // Extract user jobs from existing (preserves comments!)
-    const userJobs = new Map();
-    const existingJobs = doc.contents && doc.contents.get ? doc.contents.get('jobs') : null;
-    if (existingJobs && existingJobs.items) {
-        for (const item of existingJobs.items) {
-            const jobName = item.key?.toString();
-            if (jobName && !managedJobs.has(jobName) && !testJobs.includes(jobName) && !deployJobs.includes(jobName) && !remoteTestJobs.includes(jobName)) {
-                // This is a custom user job - preserve it completely
-                userJobs.set(jobName, item);
-            }
-        }
-    }
-    // Clear all jobs before applying operations to prevent duplicates
-    if (existingJobs && existingJobs.items) {
-        ;
-        existingJobs.items = [];
-    }
-    // Apply operations to update managed jobs
-    if (doc.contents) {
-        applyPathOperations(doc.contents, operations, doc);
-    }
-    // Add back user jobs (preserves their comments!)
-    if (userJobs.size > 0) {
-        logger.verbose(`📋 Preserving ${userJobs.size} user jobs: ${Array.from(userJobs.keys()).join(', ')}`);
-        const jobsNode = doc.contents.get('jobs');
-        if (jobsNode && jobsNode.items) {
-            for (const [_, item] of userJobs) {
-                jobsNode.items.push(item);
-            }
-        }
-    }
-    const status = userJobs.size > 0 ? 'merged' : 'updated';
-    const yamlContent = stringify(doc, { lineWidth: 0, minContentWidth: 0 });
-    const formattedContent = formatIfConditions(yamlContent);
-    return { ...ctx, yamlContent: formattedContent, mergeStatus: status };
-})
-    .then(ctx => {
-    const outputPath = ctx.outputPipelinePath || '.github/workflows/pipeline.yml';
-    const status = ctx.mergeStatus === 'merged' ? '🔄 Merged with existing' : ctx.mergeStatus === 'updated' ? '🔄 Updated existing' : '📝 Created new';
-    logger.verbose(`${status} ${outputPath}`);
-    return ctx;
-})
-    .then(renderTemplate((ctx) => ctx.yamlContent, toFile((ctx) => ctx.outputPipelinePath || '.github/workflows/pipeline.yml')));
-//# sourceMappingURL=pipeline-nx.yml.tpl.js.map

package/dist/templates/workflows/pipeline-nx.yml.tpl.js.map

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

package/dist/utils/idempotency.d.ts

@@ -1,187 +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 { PipecraftConfig } from '../types/index.js';
-/**
- * Metadata and hash information for a tracked file.
- */
-export interface FileHash {
-    /** Relative path to the file */
-    path: string;
-    /** Cryptographic hash of file content and metadata */
-    hash: string;
-    /** Last modification time (Unix timestamp in milliseconds) */
-    mtime: number;
-    /** File size in bytes */
-    size: number;
-}
-/**
- * Complete rebuild cache structure stored in .pipecraft-cache.json.
- *
- * This cache enables idempotent workflow generation by tracking when
- * configuration or template files change.
- */
-export interface RebuildCache {
-    /** Map of file paths to their hash metadata */
-    files: Record<string, FileHash>;
-    /** Hash of the configuration file (.pipecraftrc.json) */
-    configHash: string;
-    /** Timestamp when workflows were last generated */
-    lastGenerated: number;
-    /** Cache format version for future migration compatibility */
-    version: string;
-}
-/**
- * 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 declare class IdempotencyManager {
-    private cacheFile;
-    private config;
-    /**
-     * Create a new IdempotencyManager instance.
-     *
-     * @param config - PipeCraft configuration object
-     * @param cacheFile - Path to cache file (default: .pipecraft-cache.json)
-     */
-    constructor(config: PipecraftConfig, cacheFile?: string);
-    /**
-     * 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')
-     * ```
-     */
-    calculateHash(filePath: string, algorithm?: string): Promise<string>;
-    /**
-     * 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
-     */
-    private hashDirectory;
-    /**
-     * 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(): RebuildCache | 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: RebuildCache): void;
-    /**
-     * 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()
-     * }
-     * ```
-     */
-    hasChanges(): Promise<boolean>;
-    /**
-     * 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
-     * ```
-     */
-    updateCache(): Promise<void>;
-    /**
-     * 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()
-     * }
-     * ```
-     */
-    shouldRegenerateFile(filePath: string): Promise<boolean>;
-}
-//# sourceMappingURL=idempotency.d.ts.map

package/dist/utils/idempotency.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../src/utils/idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAA;IAEZ,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IAEZ,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAA;IAEb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAE/B,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAA;IAElB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAA;IAErB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,MAAM,CAAiB;IAE/B;;;;;OAKG;gBACS,MAAM,EAAE,eAAe,EAAE,SAAS,SAA0B;IAKxE;;;;;;;;;;;;;;;;;OAiBG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBpF;;;;;;;;;;;OAWG;YACW,aAAa;IA4B3B;;;;;;;OAOG;IACH,SAAS,IAAI,YAAY,GAAG,IAAI;IAchC;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAQpC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IA2CpC;;;;;;;;;;;;OAYG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAiClC;;;;;;;;;;;;;;;OAeG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAuB/D"}