pipecraft 0.28.2 → 0.29.0

package/dist/templates/workflows/shared/index.js

@@ -0,0 +1,11 @@
+/**
+ * Shared Pipeline Operations
+ *
+ * Export all shared operation generators for building workflow templates.
+ */
+export * from './operations-header.js';
+export * from './operations-changes.js';
+export * from './operations-domain-jobs.js';
+export * from './operations-version.js';
+export * from './operations-tag-promote.js';
+//# sourceMappingURL=index.js.map

package/dist/templates/workflows/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/templates/workflows/shared/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA"}

package/dist/templates/workflows/shared/operations-changes.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared Changes Detection Job Operations
+ *
+ * Generates the changes detection job that identifies which domains have changed.
+ * Supports both Nx-based detection (using dependency graph) and path-based detection.
+ */
+import { PathOperationConfig } from '../../../utils/ast-path-operations.js';
+export interface ChangesContext {
+    domains: Record<string, any>;
+    useNx?: boolean;
+    baseRef?: string;
+}
+/**
+ * Create the changes detection job operation
+ */
+export declare function createChangesJobOperation(ctx: ChangesContext): PathOperationConfig;
+//# sourceMappingURL=operations-changes.d.ts.map

package/dist/templates/workflows/shared/operations-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations-changes.d.ts","sourceRoot":"","sources":["../../../../src/templates/workflows/shared/operations-changes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAyB,MAAM,uCAAuC,CAAA;AAElG,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,cAAc,GAAG,mBAAmB,CA0ClF"}

package/dist/templates/workflows/shared/operations-changes.js

@@ -0,0 +1,49 @@
+/**
+ * Shared Changes Detection Job Operations
+ *
+ * Generates the changes detection job that identifies which domains have changed.
+ * Supports both Nx-based detection (using dependency graph) and path-based detection.
+ */
+import { createValueFromString } from '../../../utils/ast-path-operations.js';
+/**
+ * Create the changes detection job operation
+ */
+export function createChangesJobOperation(ctx) {
+    const { domains, useNx = false, baseRef = 'main' } = ctx;
+    const action = useNx ? 'detect-changes-nx' : 'detect-changes';
+    const sortedDomains = Object.keys(domains).sort();
+    const comment = `
+=============================================================================
+CHANGES DETECTION (⚠️  Managed by Pipecraft - do not modify)
+=============================================================================
+${useNx
+        ? 'Detects which domains have changed using Nx dependency graph and path-based fallback'
+        : 'Detects which domains have changed using path-based detection'}
+`;
+    const outputsSection = sortedDomains.map(domain => `      ${domain}: \${{ steps.detect.outputs.${domain} }}`).join('\n');
+    const nxOutputs = useNx
+        ? `      nxAvailable: \${{ steps.detect.outputs.nxAvailable }}
+      affectedProjects: \${{ steps.detect.outputs.affectedProjects }}`
+        : '';
+    return {
+        path: 'jobs.changes',
+        operation: 'overwrite',
+        commentBefore: comment,
+        value: createValueFromString(`
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: \${{ inputs.commitSha || github.sha }}
+          fetch-depth: 0
+      - uses: ./.github/actions/${action}
+        id: detect
+        with:
+          baseRef: \${{ inputs.baseRef || '${baseRef}' }}${useNx ? '\n          useNx: \'true\'' : ''}
+    outputs:
+${outputsSection}
+${nxOutputs}
+  `)
+    };
+}
+//# sourceMappingURL=operations-changes.js.map

package/dist/templates/workflows/shared/operations-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations-changes.js","sourceRoot":"","sources":["../../../../src/templates/workflows/shared/operations-changes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAuB,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAQlG;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAmB;IAC3D,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,GAAG,CAAA;IACxD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB,CAAA;IAC7D,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;IAEjD,MAAM,OAAO,GAAG;;;;EAIhB,KAAK;QACH,CAAC,CAAC,sFAAsF;QACxF,CAAC,CAAC,+DACN;CACC,CAAA;IAEC,MAAM,cAAc,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,MAAM,+BAA+B,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAExH,MAAM,SAAS,GAAG,KAAK;QACrB,CAAC,CAAC;sEACgE;QAClE,CAAC,CAAC,EAAE,CAAA;IAEN,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,WAAW;QACtB,aAAa,EAAE,OAAO;QACtB,KAAK,EAAE,qBAAqB,CAAC;;;;;;;kCAOC,MAAM;;;6CAGK,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,EAAE;;EAEnG,cAAc;EACd,SAAS;GACR,CAAC;KACD,CAAA;AACH,CAAC"}

package/dist/templates/workflows/shared/operations-domain-jobs.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared Domain Job Operations
+ *
+ * Generates test, deploy, and remote-test jobs for each domain.
+ * These jobs are marked as 'preserve' so users can customize them.
+ */
+import { PathOperationConfig } from '../../../utils/ast-path-operations.js';
+export interface DomainJobsContext {
+    domains: Record<string, any>;
+}
+/**
+ * Create test job operations for each domain
+ */
+export declare function createDomainTestJobOperations(ctx: DomainJobsContext): PathOperationConfig[];
+/**
+ * Create deploy job operations for deployable domains
+ */
+export declare function createDomainDeployJobOperations(ctx: DomainJobsContext): PathOperationConfig[];
+/**
+ * Create remote test job operations for remotely testable domains
+ */
+export declare function createDomainRemoteTestJobOperations(ctx: DomainJobsContext): PathOperationConfig[];
+/**
+ * Get list of all domain job names for dependency management
+ */
+export declare function getDomainJobNames(domains: Record<string, any>): {
+    testJobs: string[];
+    deployJobs: string[];
+    remoteTestJobs: string[];
+};
+//# sourceMappingURL=operations-domain-jobs.d.ts.map

package/dist/templates/workflows/shared/operations-domain-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations-domain-jobs.d.ts","sourceRoot":"","sources":["../../../../src/templates/workflows/shared/operations-domain-jobs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAyB,MAAM,uCAAuC,CAAA;AAElG,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC7B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAuC3F;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAuC7F;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAwCjG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB,CAMA"}

package/dist/templates/workflows/shared/operations-domain-jobs.js

@@ -0,0 +1,139 @@
+/**
+ * Shared Domain Job Operations
+ *
+ * Generates test, deploy, and remote-test jobs for each domain.
+ * These jobs are marked as 'preserve' so users can customize them.
+ */
+import { createValueFromString } from '../../../utils/ast-path-operations.js';
+/**
+ * Create test job operations for each domain
+ */
+export function createDomainTestJobOperations(ctx) {
+    const { domains } = ctx;
+    const operations = [];
+    const testableDomains = Object.keys(domains).sort().filter(d => domains[d].testable !== false);
+    testableDomains.forEach((domain, index) => {
+        operations.push({
+            path: `jobs.test-${domain}`,
+            operation: 'preserve', // User can customize this job!
+            // Only add comment to the first test job
+            ...(index === 0 && {
+                commentBefore: `
+=============================================================================
+TESTING JOBS (✅ Customize these with your test logic)
+=============================================================================
+These jobs run tests for each domain when changes are detected.
+Replace the TODO comments with your actual test commands.
+`
+            }),
+            value: createValueFromString(`
+    needs: changes
+    if: \${{ needs.changes.outputs.${domain} == 'true' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: \${{ inputs.commitSha || github.sha }}
+      # TODO: Replace with your ${domain} test logic
+      - name: Run ${domain} tests
+        run: |
+          echo "Running tests for ${domain} domain"
+          echo "Replace this with your actual test commands"
+          # Example: npm test -- --testPathPattern=${domain}
+  `)
+        });
+    });
+    return operations;
+}
+/**
+ * Create deploy job operations for deployable domains
+ */
+export function createDomainDeployJobOperations(ctx) {
+    const { domains } = ctx;
+    const operations = [];
+    const deployableDomains = Object.keys(domains).sort().filter(d => domains[d].deployable === true);
+    deployableDomains.forEach((domain, index) => {
+        operations.push({
+            path: `jobs.deploy-${domain}`,
+            operation: 'preserve', // User can customize this job!
+            // Only add comment to the first deploy job
+            ...(index === 0 && {
+                commentBefore: `
+=============================================================================
+DEPLOYMENT JOBS (✅ Customize these with your deploy logic)
+=============================================================================
+These jobs deploy each domain when changes are detected and tests pass.
+Replace the TODO comments with your actual deployment commands.
+`
+            }),
+            value: createValueFromString(`
+    needs: [ version, changes ]
+    if: \${{ always() && needs.version.result == 'success' && needs.changes.outputs.${domain} == 'true' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: \${{ inputs.commitSha || github.sha }}
+      # TODO: Replace with your ${domain} deployment logic
+      - name: Deploy ${domain}
+        run: |
+          echo "Deploying ${domain} with version \${{ needs.version.outputs.version }}"
+          echo "Replace this with your actual deploy commands"
+          # Example: npm run deploy:${domain}
+  `)
+        });
+    });
+    return operations;
+}
+/**
+ * Create remote test job operations for remotely testable domains
+ */
+export function createDomainRemoteTestJobOperations(ctx) {
+    const { domains } = ctx;
+    const operations = [];
+    const remoteTestableDomains = Object.keys(domains).sort().filter(d => domains[d].remoteTestable === true);
+    remoteTestableDomains.forEach((domain, index) => {
+        operations.push({
+            path: `jobs.remote-test-${domain}`,
+            operation: 'preserve', // User can customize this job!
+            // Only add comment to the first remote test job
+            ...(index === 0 && {
+                commentBefore: `
+=============================================================================
+REMOTE TESTING JOBS (✅ Customize these with your remote test logic)
+=============================================================================
+These jobs test deployed services remotely after deployment succeeds.
+Replace the TODO comments with your actual remote testing commands.
+`
+            }),
+            value: createValueFromString(`
+    needs: [ deploy-${domain}, changes ]
+    if: \${{ always() }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: \${{ inputs.commitSha || github.sha }}
+      # TODO: Replace with your ${domain} remote testing logic
+      - name: Test ${domain} remotely
+        if: \${{ needs.changes.outputs.${domain} == 'true' && needs.deploy-${domain}.result == 'success' }}
+        run: |
+          echo "Testing ${domain} remotely"
+          echo "Replace this with your actual remote test commands"
+          # Example: npm run test:remote:${domain}
+  `)
+        });
+    });
+    return operations;
+}
+/**
+ * Get list of all domain job names for dependency management
+ */
+export function getDomainJobNames(domains) {
+    return {
+        testJobs: Object.keys(domains).sort().filter(d => domains[d].testable !== false).map(d => `test-${d}`),
+        deployJobs: Object.keys(domains).sort().filter(d => domains[d].deployable === true).map(d => `deploy-${d}`),
+        remoteTestJobs: Object.keys(domains).sort().filter(d => domains[d].remoteTestable === true).map(d => `remote-test-${d}`)
+    };
+}
+//# sourceMappingURL=operations-domain-jobs.js.map

package/dist/templates/workflows/shared/operations-domain-jobs.js.map

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

package/dist/templates/workflows/shared/operations-header.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared Header Operations
+ *
+ * Generates workflow header operations (name, run-name, on triggers) that are
+ * common to both Nx and path-based pipeline templates.
+ */
+import { PathOperationConfig } from '../../../utils/ast-path-operations.js';
+export interface HeaderContext {
+    branchFlow: string[];
+}
+/**
+ * Create workflow header operations (name, run-name, on triggers)
+ */
+export declare function createHeaderOperations(ctx: HeaderContext): PathOperationConfig[];
+//# sourceMappingURL=operations-header.d.ts.map

package/dist/templates/workflows/shared/operations-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations-header.d.ts","sourceRoot":"","sources":["../../../../src/templates/workflows/shared/operations-header.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAA;AAG3E,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,mBAAmB,EAAE,CA2JhF"}

package/dist/templates/workflows/shared/operations-header.js

@@ -0,0 +1,158 @@
+/**
+ * Shared Header Operations
+ *
+ * Generates workflow header operations (name, run-name, on triggers) that are
+ * common to both Nx and path-based pipeline templates.
+ */
+import { Scalar } from 'yaml';
+/**
+ * Create workflow header operations (name, run-name, on triggers)
+ */
+export function createHeaderOperations(ctx) {
+    const { branchFlow } = ctx;
+    // Provide sensible defaults if branchFlow is invalid
+    const validBranchFlow = (branchFlow && Array.isArray(branchFlow) && branchFlow.length > 0) ? branchFlow : ['main'];
+    const branchList = validBranchFlow.join(',');
+    return [
+        // =============================================================================
+        // WORKFLOW NAME
+        // =============================================================================
+        {
+            path: 'name',
+            operation: 'preserve',
+            value: (() => {
+                const nameScalar = new Scalar('Pipeline');
+                nameScalar.type = Scalar.QUOTE_DOUBLE;
+                return nameScalar;
+            })(),
+            required: true
+        },
+        // =============================================================================
+        // RUN NAME - Display name for workflow runs
+        // =============================================================================
+        {
+            path: 'run-name',
+            operation: 'preserve',
+            value: (() => {
+                const runNameScalar = new Scalar(`\${{ github.event_name == 'pull_request' && !contains('${branchList}', github.head_ref) && github.event.pull_request.title || github.ref_name }} #\${{ inputs.run_number || github.run_number }}\${{ inputs.version && format(' - {0}', inputs.version) || '' }}`);
+                runNameScalar.type = Scalar.QUOTE_DOUBLE;
+                return runNameScalar;
+            })(),
+            required: true,
+            spaceBefore: true
+        },
+        // =============================================================================
+        // WORKFLOW TRIGGERS
+        // =============================================================================
+        {
+            path: 'on',
+            operation: 'set',
+            value: {},
+            required: true,
+            spaceBefore: true
+        },
+        // workflow_dispatch inputs
+        {
+            path: 'on.workflow_dispatch.inputs.version',
+            operation: 'set',
+            value: {
+                description: 'The version to deploy',
+                required: false,
+                type: 'string'
+            },
+            required: true
+        },
+        {
+            path: 'on.workflow_dispatch.inputs.baseRef',
+            operation: 'set',
+            value: {
+                description: 'The base reference for comparison',
+                required: false,
+                type: 'string'
+            },
+            required: true
+        },
+        {
+            path: 'on.workflow_dispatch.inputs.run_number',
+            operation: 'set',
+            value: {
+                description: 'The original run number from develop branch',
+                required: false,
+                type: 'string'
+            },
+            required: true
+        },
+        {
+            path: 'on.workflow_dispatch.inputs.commitSha',
+            operation: 'set',
+            value: {
+                description: 'The exact commit SHA to checkout and test',
+                required: false,
+                type: 'string'
+            },
+            required: true
+        },
+        // workflow_call inputs (same as workflow_dispatch)
+        {
+            path: 'on.workflow_call.inputs.version',
+            operation: 'set',
+            value: {
+                description: 'The version to deploy',
+                required: false,
+                type: 'string'
+            },
+            required: true
+        },
+        {
+            path: 'on.workflow_call.inputs.baseRef',
+            operation: 'set',
+            value: {
+                description: 'The base reference for comparison',
+                required: false,
+                type: 'string'
+            },
+            required: true
+        },
+        {
+            path: 'on.workflow_call.inputs.run_number',
+            operation: 'set',
+            value: {
+                description: 'The original run number from develop branch',
+                required: false,
+                type: 'string'
+            },
+            required: true
+        },
+        {
+            path: 'on.workflow_call.inputs.commitSha',
+            operation: 'set',
+            value: {
+                description: 'The exact commit SHA to checkout and test',
+                required: false,
+                type: 'string'
+            },
+            required: true
+        },
+        // push trigger
+        {
+            path: 'on.push.branches',
+            operation: 'set',
+            value: validBranchFlow,
+            required: true
+        },
+        // pull_request trigger
+        {
+            path: 'on.pull_request.types',
+            operation: 'set',
+            value: ['opened', 'synchronize', 'reopened'],
+            required: true
+        },
+        {
+            path: 'on.pull_request.branches',
+            operation: 'set',
+            value: [validBranchFlow[0]], // Only target initial branch
+            required: true
+        }
+    ];
+}
+//# sourceMappingURL=operations-header.js.map

package/dist/templates/workflows/shared/operations-header.js.map

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

package/dist/templates/workflows/shared/operations-tag-promote.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared Tag, Promote, and Release Job Operations
+ *
+ * Generates the tag creation, branch promotion, and GitHub release jobs.
+ */
+import { PathOperationConfig } from '../../../utils/ast-path-operations.js';
+export interface TagPromoteContext {
+    branchFlow: string[];
+    deployJobNames: string[];
+    remoteTestJobNames: string[];
+}
+/**
+ * Create tag, promote, and release job operations
+ */
+export declare function createTagPromoteReleaseOperations(ctx: TagPromoteContext): PathOperationConfig[];
+//# sourceMappingURL=operations-tag-promote.d.ts.map

package/dist/templates/workflows/shared/operations-tag-promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations-tag-promote.d.ts","sourceRoot":"","sources":["../../../../src/templates/workflows/shared/operations-tag-promote.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAyB,MAAM,uCAAuC,CAAA;AAElG,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAC7B;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CA2F/F"}

package/dist/templates/workflows/shared/operations-tag-promote.js

@@ -0,0 +1,115 @@
+/**
+ * Shared Tag, Promote, and Release Job Operations
+ *
+ * Generates the tag creation, branch promotion, and GitHub release jobs.
+ */
+import { createValueFromString } from '../../../utils/ast-path-operations.js';
+/**
+ * Create tag, promote, and release job operations
+ */
+export function createTagPromoteReleaseOperations(ctx) {
+    const { branchFlow, deployJobNames, remoteTestJobNames } = ctx;
+    // Provide sensible defaults if branchFlow is invalid
+    const validBranchFlow = (branchFlow && Array.isArray(branchFlow) && branchFlow.length > 0) ? branchFlow : ['main'];
+    const allDeploymentJobs = [...deployJobNames, ...remoteTestJobNames];
+    const initialBranch = validBranchFlow[0];
+    // Build tag job conditional (should only run on initial branch, not on PRs)
+    const tagConditions = [
+        'always()',
+        'github.event_name != \'pull_request\'',
+        `github.ref_name == '${initialBranch}'`,
+        'needs.version.result == \'success\'',
+        'needs.version.outputs.version != \'\''
+    ];
+    if (allDeploymentJobs.length > 0) {
+        const noFailures = allDeploymentJobs.map(job => `needs.${job}.result != 'failure'`).join(' && ');
+        const atLeastOneSuccess = allDeploymentJobs.map(job => `needs.${job}.result == 'success'`).join(' || ');
+        tagConditions.push(`(${noFailures})`);
+        tagConditions.push(`(${atLeastOneSuccess})`);
+    }
+    const tagNeedsArray = ['version', ...allDeploymentJobs];
+    return [
+        // TAG JOB
+        {
+            path: 'jobs.tag',
+            operation: 'overwrite',
+            commentBefore: `
+=============================================================================
+TAG & PROMOTE (⚠️  Managed by Pipecraft - do not modify)
+=============================================================================
+Creates git tags and promotes code through branch flow.
+`,
+            value: createValueFromString(`
+    if: \${{ ${tagConditions.join(' && ')} }}
+    needs: [ ${tagNeedsArray.join(', ')} ]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: \${{ inputs.commitSha || github.sha }}
+      - uses: ./.github/actions/create-tag
+        with:
+          version: \${{ needs.version.outputs.version }}
+          commitSha: \${{ inputs.commitSha || github.sha }}
+  `)
+        },
+        // PROMOTE JOB
+        {
+            path: 'jobs.promote',
+            operation: 'overwrite',
+            value: createValueFromString(`
+    if: \${{ always() && (github.event_name == 'push' || github.event_name == 'workflow_dispatch') && needs.version.result == 'success' && needs.version.outputs.version != '' && (needs.tag.result == 'success' || needs.tag.result == 'skipped') && (${buildPromotableBranchesCondition(validBranchFlow)}) }}
+    needs: [ version, tag ]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: \${{ inputs.commitSha || github.sha }}
+      - uses: ./.github/actions/promote-branch
+        with:
+          version: \${{ needs.version.outputs.version }}
+          currentBranch: \${{ github.ref_name }}
+          nextBranch: \${{ ${buildNextBranchExpression(validBranchFlow)} }}
+          runNumber: \${{ github.run_number }}
+  `)
+        },
+        // RELEASE JOB
+        {
+            path: 'jobs.release',
+            operation: 'overwrite',
+            value: createValueFromString(`
+    if: \${{ always() && github.ref_name == '${validBranchFlow[validBranchFlow.length - 1]}' && needs.version.result == 'success' && needs.version.outputs.version != '' && needs.tag.result == 'success' }}
+    needs: [ tag, version ]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: \${{ inputs.commitSha || github.sha }}
+      - uses: ./.github/actions/create-release
+        with:
+          version: \${{ needs.version.outputs.version }}
+          commitSha: \${{ inputs.commitSha || github.sha }}
+  `)
+        }
+    ];
+}
+/**
+ * Helper to build promotable branches condition
+ * Returns a condition that checks if current branch is promotable (all except final branch)
+ */
+function buildPromotableBranchesCondition(branchFlow) {
+    const promotableBranches = branchFlow.slice(0, -1); // All branches except the last one
+    return promotableBranches.map(branch => `github.ref_name == '${branch}'`).join(' || ');
+}
+/**
+ * Helper to build the nextBranch expression
+ */
+function buildNextBranchExpression(branchFlow) {
+    if (branchFlow.length === 1)
+        return `''`;
+    if (branchFlow.length === 2)
+        return `'${branchFlow[1]}'`;
+    // For 3+ branches: develop → staging, staging → main
+    return `github.ref_name == '${branchFlow[0]}' && '${branchFlow[1]}' || '${branchFlow[branchFlow.length - 1]}'`;
+}
+//# sourceMappingURL=operations-tag-promote.js.map

package/dist/templates/workflows/shared/operations-tag-promote.js.map

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

package/dist/templates/workflows/shared/operations-version.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared Version Job Operation
+ *
+ * Generates the version calculation job that determines the next semantic version.
+ */
+import { PathOperationConfig } from '../../../utils/ast-path-operations.js';
+export interface VersionContext {
+    testJobNames: string[];
+    nxEnabled?: boolean;
+    baseRef?: string;
+}
+/**
+ * Create the version calculation job operation
+ */
+export declare function createVersionJobOperation(ctx: VersionContext): PathOperationConfig;
+//# sourceMappingURL=operations-version.d.ts.map

package/dist/templates/workflows/shared/operations-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations-version.d.ts","sourceRoot":"","sources":["../../../../src/templates/workflows/shared/operations-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAyB,MAAM,uCAAuC,CAAA;AAElG,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,cAAc,GAAG,mBAAmB,CAkDlF"}