pipecraft 0.29.3 → 0.36.14

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

@@ -4,112 +4,223 @@
  * Generates the tag creation, branch promotion, and GitHub release jobs.
  */
 import { createValueFromString } from '../../../utils/ast-path-operations.js';
+import { getActionReference } from '../../../utils/action-reference.js';
 /**
  * Create tag, promote, and release job operations
  */
 export function createTagPromoteReleaseOperations(ctx) {
-    const { branchFlow, deployJobNames, remoteTestJobNames } = ctx;
+    const { branchFlow, config = {} } = ctx;
     // Provide sensible defaults if branchFlow is invalid
-    const validBranchFlow = (branchFlow && Array.isArray(branchFlow) && branchFlow.length > 0) ? branchFlow : ['main'];
-    const allDeploymentJobs = [...deployJobNames, ...remoteTestJobNames];
+    const validBranchFlow = branchFlow && Array.isArray(branchFlow) && branchFlow.length > 0 ? branchFlow : ['main'];
     const initialBranch = validBranchFlow[0];
+    // Get action references based on configuration
+    const tagActionRef = getActionReference('create-tag', config);
+    const promoteActionRef = getActionReference('promote-branch', config);
+    const releaseActionRef = getActionReference('create-release', config);
     // Build tag job conditional (should only run on initial branch, not on PRs)
+    // Now depends on the gate job instead of individual test jobs
     const tagConditions = [
         'always()',
-        'github.event_name != \'pull_request\'',
+        "github.event_name != 'pull_request'",
         `github.ref_name == '${initialBranch}'`,
-        'needs.version.result == \'success\'',
-        'needs.version.outputs.version != \'\''
+        "needs.version.result == 'success'",
+        "needs.version.outputs.version != ''",
+        "needs.gate.result == 'success'" // Gate job must succeed
     ];
-    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];
+    // Default needs: version + gate (gate already checks all test jobs)
+    const tagNeedsArray = ['version', 'gate'];
+    const defaultTagIfCondition = tagConditions.join(' && ');
     return [
-        // TAG JOB
+        // TAG JOB - Ensure the job key exists with comment (but don't overwrite existing job)
         {
             path: 'jobs.tag',
-            operation: 'overwrite',
+            operation: 'preserve',
+            spaceBefore: true,
             commentBefore: `
 =============================================================================
-TAG & PROMOTE (⚠️  Managed by Pipecraft - do not modify)
+ TAG (⚠️  Managed by Pipecraft - customizable needs and if)
 =============================================================================
-Creates git tags and promotes code through branch flow.
+ Creates git tags and promotes code through branch flow.
+ The 'needs' and 'if' fields are customizable and will be preserved.
+ All other fields (runs-on, steps) are managed by Pipecraft.
 `,
+            value: {} // Empty object - just ensures the job exists with the comment
+        },
+        // TAG JOB NEEDS - Preserve user customizations, default to version + gate
+        {
+            path: 'jobs.tag.needs',
+            operation: 'preserve',
+            value: tagNeedsArray
+        },
+        // TAG JOB IF - Preserve user customizations, default to standard conditions
+        //
+        // Now simplified: just check that gate job succeeded (gate already validates all tests)
+        //
+        // Pattern:
+        //   if: ${{
+        //     always() &&
+        //     github.event_name != 'pull_request' &&
+        //     github.ref_name == 'develop' &&
+        //     needs.version.result == 'success' &&
+        //     needs.version.outputs.version != '' &&
+        //     needs.gate.result == 'success'
+        //   }}
+        {
+            path: 'jobs.tag.if',
+            operation: 'preserve',
+            value: createValueFromString(`\${{ ${defaultTagIfCondition} }}`)
+        },
+        // TAG JOB RUNS-ON - Always managed
+        {
+            path: 'jobs.tag.runs-on',
+            operation: 'overwrite',
+            value: 'ubuntu-latest'
+        },
+        // TAG JOB STEPS - Always managed
+        {
+            path: 'jobs.tag.steps',
+            operation: 'overwrite',
             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
+          fetch-depth: \${{ env.FETCH_DEPTH_VERSIONING }}
+      - uses: ${tagActionRef}
         with:
           version: \${{ needs.version.outputs.version }}
-          commitSha: \${{ inputs.commitSha || github.sha }}
   `)
         },
         // PROMOTE JOB
         {
             path: 'jobs.promote',
             operation: 'overwrite',
+            spaceBefore: true,
+            commentBefore: `
+=============================================================================
+ PROMOTE (⚠️  Managed by Pipecraft - do not modify)
+=============================================================================
+ Promotes code from develop to staging or main via PR.
+`,
             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 ]
+    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)}) }}
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
         with:
           ref: \${{ inputs.commitSha || github.sha }}
-      - uses: ./.github/actions/promote-branch
+          fetch-depth: \${{ env.FETCH_DEPTH_VERSIONING }}
+      - uses: ${promoteActionRef}
         with:
           version: \${{ needs.version.outputs.version }}
-          currentBranch: \${{ github.ref_name }}
-          nextBranch: \${{ ${buildNextBranchExpression(validBranchFlow)} }}
-          runNumber: \${{ github.run_number }}
+          sourceBranch: \${{ github.ref_name }}
+          targetBranch: \${{ ${buildTargetBranchExpression(validBranchFlow)} }}
+          autoPromote: \${{ ${buildAutoPromoteExpression(validBranchFlow, ctx.autoPromote)} }}
+          run_number: \${{ inputs.run_number || github.run_number }}
   `)
         },
         // RELEASE JOB
         {
             path: 'jobs.release',
             operation: 'overwrite',
+            spaceBefore: true,
+            commentBefore: `
+=============================================================================
+ RELEASE (⚠️  Managed by Pipecraft - do not modify)
+=============================================================================
+ Creates a release for the version.
+`,
             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 ]
+    if: \${{ always() && github.ref_name == '${validBranchFlow[validBranchFlow.length - 1]}' && needs.version.result == 'success' && needs.version.outputs.version != '' && (needs.tag.result == 'success' || needs.tag.result == 'skipped') }}
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
         with:
           ref: \${{ inputs.commitSha || github.sha }}
-      - uses: ./.github/actions/create-release
+          fetch-depth: \${{ env.FETCH_DEPTH_VERSIONING }}
+      - uses: ${releaseActionRef}
         with:
           version: \${{ needs.version.outputs.version }}
-          commitSha: \${{ inputs.commitSha || github.sha }}
   `)
         }
     ];
 }
+/**
+ * Builds a condition that ensures at least ONE success AND NO failures for a set of jobs.
+ *
+ * This is the standard pattern for gating jobs (like tag) that depend on multiple test/deploy jobs.
+ *
+ * Pattern:
+ *   - NO failures: All jobs must not be 'failure' (skipped is OK, failure is not)
+ *   - AT LEAST ONE success: At least one job must be 'success' (skipped doesn't count as success)
+ *
+ * @param jobNames - Array of job names to check (e.g., ['test-cicd', 'test-core', 'deploy-docs'])
+ * @returns Condition string like: "(needs.job1.result != 'failure' && needs.job2.result != 'failure') && (needs.job1.result == 'success' || needs.job2.result == 'success')"
+ *
+ * @example
+ * ```typescript
+ * // For test jobs
+ * buildAtLeastOneSuccessNoFailuresCondition(['test-cicd', 'test-core', 'test-docs'])
+ * // Returns: "(needs.test-cicd.result != 'failure' && needs.test-core.result != 'failure' && needs.test-docs.result != 'failure') && (needs.test-cicd.result == 'success' || needs.test-core.result == 'success' || needs.test-docs.result == 'success')"
+ *
+ * // For deployment jobs
+ * buildAtLeastOneSuccessNoFailuresCondition(['deploy-staging', 'deploy-prod'])
+ * // Returns: "(needs.deploy-staging.result != 'failure' && needs.deploy-prod.result != 'failure') && (needs.deploy-staging.result == 'success' || needs.deploy-prod.result == 'success')"
+ * ```
+ */
+function buildAtLeastOneSuccessNoFailuresCondition(jobNames) {
+    if (jobNames.length === 0) {
+        return '';
+    }
+    // Ensure NO failures (skipped is OK, but failure is not)
+    const noFailures = jobNames.map(job => `needs.${job}.result != 'failure'`).join(' && ');
+    // Ensure AT LEAST ONE success (skipped jobs don't count as success)
+    const atLeastOneSuccess = jobNames.map(job => `needs.${job}.result == 'success'`).join(' || ');
+    return `(${noFailures}) && (${atLeastOneSuccess})`;
+}
 /**
  * Helper to build promotable branches condition
  * Returns a condition that checks if current branch is promotable (all except final branch)
+ * For single-branch workflows, returns 'false' to skip the promote job
  */
 function buildPromotableBranchesCondition(branchFlow) {
     const promotableBranches = branchFlow.slice(0, -1); // All branches except the last one
+    if (promotableBranches.length === 0) {
+        return 'false'; // Single-branch workflow - no promotion needed
+    }
     return promotableBranches.map(branch => `github.ref_name == '${branch}'`).join(' || ');
 }
 /**
- * Helper to build the nextBranch expression
+ * Helper to build the targetBranch expression
+ * Maps each source branch to its target branch
  */
-function buildNextBranchExpression(branchFlow) {
+function buildTargetBranchExpression(branchFlow) {
     if (branchFlow.length === 1)
         return `''`;
     if (branchFlow.length === 2)
         return `'${branchFlow[1]}'`;
     // For 3+ branches: develop → staging, staging → main
+    // github.ref_name == 'develop' && 'staging' || 'main'
     return `github.ref_name == '${branchFlow[0]}' && '${branchFlow[1]}' || '${branchFlow[branchFlow.length - 1]}'`;
 }
+/**
+ * Helper to build the autoPromote expression
+ * Maps each target branch to its autoPromote setting
+ */
+function buildAutoPromoteExpression(branchFlow, autoPromote) {
+    if (!autoPromote || branchFlow.length === 1)
+        return `'false'`;
+    const clauses = [];
+    for (let i = 0; i < branchFlow.length - 1; i += 1) {
+        const sourceBranch = branchFlow[i];
+        const targetBranch = branchFlow[i + 1];
+        const isEnabled = autoPromote[targetBranch] ? 'true' : 'false';
+        clauses.push(`(github.ref_name == '${sourceBranch}' && '${isEnabled}')`);
+    }
+    if (clauses.length === 0) {
+        return `'false'`;
+    }
+    return `${clauses.join(' || ')} || 'false'`;
+}
 //# sourceMappingURL=operations-tag-promote.js.map

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

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

@@ -3,11 +3,12 @@
  *
  * Generates the version calculation job that determines the next semantic version.
  */
-import { PathOperationConfig } from '../../../utils/ast-path-operations.js';
+import { type PathOperationConfig } from '../../../utils/ast-path-operations.js';
+import type { PipecraftConfig } from '../../../types/index.js';
 export interface VersionContext {
     testJobNames: string[];
-    nxEnabled?: boolean;
     baseRef?: string;
+    config?: Partial<PipecraftConfig>;
 }
 /**
  * Create the version calculation job operation

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

@@ -1 +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"}
+{"version":3,"file":"operations-version.d.ts","sourceRoot":"","sources":["../../../../src/templates/workflows/shared/operations-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,uCAAuC,CAAA;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE9D,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,cAAc,GAAG,mBAAmB,CAoDlF"}

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

@@ -4,51 +4,52 @@
  * Generates the version calculation job that determines the next semantic version.
  */
 import { createValueFromString } from '../../../utils/ast-path-operations.js';
+import { getActionReference } from '../../../utils/action-reference.js';
 /**
  * Create the version calculation job operation
  */
 export function createVersionJobOperation(ctx) {
-    const { testJobNames, nxEnabled = false, baseRef = 'main' } = ctx;
+    const { testJobNames, baseRef = 'main', config = {} } = ctx;
+    // Get the action reference based on configuration
+    const actionRef = getActionReference('calculate-version', config);
     // Build the needs array
-    const nxJobName = nxEnabled ? 'nx-ci' : null;
-    const needsArray = ['changes', nxJobName, ...testJobNames].filter(Boolean);
+    const needsArray = ['changes', ...testJobNames].filter(Boolean);
     // Build the conditional logic
-    const nxCondition = nxEnabled ? 'needs.nx-ci.result == \'success\'' : '';
     const testConditions = testJobNames.length > 0
         ? [
             `(${testJobNames.map(job => `needs.${job}.result == 'success'`).join(' || ')})`,
             testJobNames.map(job => `needs.${job}.result != 'failure'`).join(' && ')
         ]
         : [];
-    const allConditions = [
-        'always()',
-        'github.event_name != \'pull_request\'',
-        nxCondition,
-        ...testConditions
-    ].filter(Boolean).join(' && ');
+    const allConditions = ['always()', "github.event_name != 'pull_request'", ...testConditions]
+        .filter(Boolean)
+        .join(' && ');
     return {
         path: 'jobs.version',
         operation: 'overwrite',
+        spaceBefore: true,
         commentBefore: `
 =============================================================================
-VERSIONING (⚠️  Managed by Pipecraft - do not modify)
+ VERSIONING (⚠️  Managed by Pipecraft - do not modify)
 =============================================================================
-Calculates the next semantic version based on conventional commits.
-Only runs on push events (skipped on pull requests).
+ Calculates the next semantic version based on conventional commits.
+ Only runs on push events (skipped on pull requests).
 `,
         value: createValueFromString(`
-    if: \${{ ${allConditions} }}
     needs: [ ${needsArray.join(', ')} ]
+    if: \${{ ${allConditions} }}
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
         with:
           ref: \${{ inputs.commitSha || github.sha }}
-      - uses: ./.github/actions/calculate-version
+          fetch-depth: \${{ env.FETCH_DEPTH_VERSIONING }}
+      - uses: ${actionRef}
         id: version
         with:
           baseRef: \${{ inputs.baseRef || '${baseRef}' }}
-          commitSha: \${{ inputs.commitSha || github.sha }}
+          version: \${{ inputs.version }}
+          node-version: \${{ env.NODE_VERSION }}
     outputs:
       version: \${{ steps.version.outputs.version }}
   `)

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

@@ -1 +1 @@
-{"version":3,"file":"operations-version.js","sourceRoot":"","sources":["../../../../src/templates/workflows/shared/operations-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAuB,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAQlG;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAmB;IAC3D,MAAM,EAAE,YAAY,EAAE,SAAS,GAAG,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,GAAG,CAAA;IAEjE,wBAAwB;IACxB,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IAC5C,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAE1E,8BAA8B;IAC9B,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,EAAE,CAAA;IACxE,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC;QAC5C,CAAC,CAAC;YACE,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,GAAG,sBAAsB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;YAC/E,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,GAAG,sBAAsB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;SACzE;QACH,CAAC,CAAC,EAAE,CAAA;IAEN,MAAM,aAAa,GAAG;QACpB,UAAU;QACV,uCAAuC;QACvC,WAAW;QACX,GAAG,cAAc;KAClB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAE9B,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,WAAW;QACtB,aAAa,EAAE;;;;;;CAMlB;QACG,KAAK,EAAE,qBAAqB,CAAC;eAClB,aAAa;eACb,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;6CASS,OAAO;;;;GAIjD,CAAC;KACD,CAAA;AACH,CAAC"}
+{"version":3,"file":"operations-version.js","sourceRoot":"","sources":["../../../../src/templates/workflows/shared/operations-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EAEtB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AASvE;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAmB;IAC3D,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,GAAG,CAAA;IAE3D,kDAAkD;IAClD,MAAM,SAAS,GAAG,kBAAkB,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAA;IAEjE,wBAAwB;IACxB,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,GAAG,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAE/D,8BAA8B;IAC9B,MAAM,cAAc,GAClB,YAAY,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC;YACE,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,GAAG,sBAAsB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;YAC/E,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,GAAG,sBAAsB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;SACzE;QACH,CAAC,CAAC,EAAE,CAAA;IAER,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,qCAAqC,EAAE,GAAG,cAAc,CAAC;SACzF,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAA;IAEf,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,WAAW;QACtB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE;;;;;;CAMlB;QACG,KAAK,EAAE,qBAAqB,CAAC;eAClB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;eACrB,aAAa;;;;;;;gBAOZ,SAAS;;;6CAGoB,OAAO;;;;;GAKjD,CAAC;KACD,CAAA;AACH,CAAC"}

package/dist/templates/yaml-format-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yaml-format-utils.d.ts","sourceRoot":"","sources":["../../src/templates/yaml-format-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CAkCtF"}
+{"version":3,"file":"yaml-format-utils.d.ts","sourceRoot":"","sources":["../../src/templates/yaml-format-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CA0BtF"}

package/dist/templates/yaml-format-utils.js

@@ -36,11 +36,7 @@ export function formatIfConditions(yamlContent, minLength = 80) {
         // Step 2: Add line breaks for logical operators
         formatted = formatted.replace(/\s+&&\s+/g, ' &&\n        ');
         formatted = formatted.replace(/\s+\|\|\s+/g, ' ||\n        ');
-        // Step 3: Format grouping parentheses (now that function calls are protected)
-        formatted = formatted.replace(/\(\s*/g, '(\n        ');
-        formatted = formatted.replace(/\s*\)\s*(&&|\|\|)/g, '\n      ) $1');
-        formatted = formatted.replace(/\s*\)(\s*)$/g, '\n      )');
-        // Step 4: Restore function calls
+        // Step 3: Restore function calls
         functionCalls.forEach((funcCall, index) => {
             formatted = formatted.replace(`__FUNC_${index}__`, funcCall);
         });

package/dist/templates/yaml-format-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"yaml-format-utils.js","sourceRoot":"","sources":["../../src/templates/yaml-format-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,YAAoB,EAAE;IAC5E,OAAO,WAAW,CAAC,OAAO,CACxB,wBAAwB,EACxB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;QACnB,yEAAyE;QACzE,IAAI,SAAS,CAAC,MAAM,GAAG,SAAS;YAAE,OAAO,KAAK,CAAA;QAE9C,IAAI,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,CAAA;QAEhC,8EAA8E;QAC9E,MAAM,aAAa,GAAa,EAAE,CAAA;QAClC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAa,EAAE,EAAE;YAC5D,MAAM,WAAW,GAAG,UAAU,aAAa,CAAC,MAAM,IAAI,CAAA;YACtD,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACzB,OAAO,WAAW,CAAA;QACpB,CAAC,CAAC,CAAA;QAEF,gDAAgD;QAChD,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAA;QAC3D,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;QAE7D,8EAA8E;QAC9E,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;QACtD,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAA;QACnE,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;QAE1D,iCAAiC;QACjC,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;YACxC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC9D,CAAC,CAAC,CAAA;QAEF,OAAO,qBAAqB,SAAS,YAAY,CAAA;IACnD,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"yaml-format-utils.js","sourceRoot":"","sources":["../../src/templates/yaml-format-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,YAAoB,EAAE;IAC5E,OAAO,WAAW,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;QACxE,yEAAyE;QACzE,IAAI,SAAS,CAAC,MAAM,GAAG,SAAS;YAAE,OAAO,KAAK,CAAA;QAE9C,IAAI,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,CAAA;QAEhC,8EAA8E;QAC9E,MAAM,aAAa,GAAa,EAAE,CAAA;QAClC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAa,EAAE,EAAE;YAC5D,MAAM,WAAW,GAAG,UAAU,aAAa,CAAC,MAAM,IAAI,CAAA;YACtD,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACzB,OAAO,WAAW,CAAA;QACpB,CAAC,CAAC,CAAA;QAEF,gDAAgD;QAChD,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAA;QAC3D,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;QAE7D,iCAAiC;QACjC,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;YACxC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC9D,CAAC,CAAC,CAAA;QAEF,OAAO,qBAAqB,SAAS,YAAY,CAAA;IACnD,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/types/index.d.ts

@@ -34,32 +34,51 @@ export interface DomainConfig {
      * Used in workflow comments and documentation.
      */
     description: string;
+    /**
+     * Job prefixes to generate for this domain.
+     * Each prefix generates a customizable placeholder job named `{prefix}-{domain}`.
+     *
+     * For example, with domain 'core' and prefixes: ['test', 'deploy', 'lint']:
+     * - test-core (runs when core/ changes)
+     * - deploy-core (runs when core/ changes)
+     * - lint-core (runs when core/ changes)
+     *
+     * These are placeholder jobs where you add your own logic in the custom jobs section.
+     * Prefixes provide more flexibility than the boolean flags (testable, deployable, etc).
+     *
+     * @example ['test', 'deploy', 'remote-test']
+     * @example ['lint', 'build', 'test', 'deploy', 'e2e']
+     */
+    prefixes?: string[];
     /**
      * Whether this domain has tests that should be run.
      * If true, generates test jobs for this domain.
      * @default false
+     * @deprecated Use `prefixes: ['test']` instead for more flexibility
      */
     testable?: boolean;
     /**
      * Whether this domain should be deployed.
      * If true, generates deployment jobs for this domain.
      * @default false
+     * @deprecated Use `prefixes: ['deploy']` instead for more flexibility
      */
     deployable?: boolean;
     /**
      * Whether this domain should be tested remotely after deployment.
      * If true, generates remote test jobs for this domain.
      * @default false
+     * @deprecated Use `prefixes: ['remote-test']` instead for more flexibility
      */
     remoteTestable?: boolean;
 }
 /**
  * Complete PipeCraft configuration schema.
  *
- * This is the main configuration interface loaded from `.pipecraftrc.json` or
- * the `pipecraft` key in `package.json`. It defines the entire CI/CD pipeline
- * behavior including branch flow, merge strategies, domain configuration,
- * versioning, and automated actions.
+ * This is the main configuration interface loaded from `.pipecraftrc` (YAML or JSON),
+ * `.pipecraftrc.json` (legacy), or the `pipecraft` key in `package.json`.
+ * It defines the entire CI/CD pipeline behavior including branch flow, merge
+ * strategies, domain configuration, versioning, and automated actions.
  *
  * @example
  * ```typescript
@@ -70,7 +89,7 @@ export interface DomainConfig {
  *   initialBranch: 'develop',
  *   finalBranch: 'main',
  *   branchFlow: ['develop', 'staging', 'main'],
- *   autoMerge: { staging: true },
+ *   autoPromote: { staging: true },
  *   semver: {
  *     bumpRules: { feat: 'minor', fix: 'patch', breaking: 'major' }
  *   },
@@ -120,14 +139,16 @@ export interface PipecraftConfig {
      */
     branchFlow: string[];
     /**
-     * Auto-merge configuration for branch promotions.
-     * - boolean: Enable/disable auto-merge for all branches
-     * - Record: Per-branch auto-merge settings (e.g., `{ staging: true, main: false }`)
+     * Auto-promote configuration for branch promotions.
+     * - boolean: Enable/disable auto-promotion for all branches
+     * - Record: Per-branch auto-promote settings (e.g., `{ staging: true, main: false }`)
      *
-     * When enabled, PRs are automatically merged after checks pass.
+     * When enabled, code is automatically promoted (fast-forwarded) to the next branch
+     * in the flow after checks pass. When disabled, a PR is created for manual review
+     * and the promotion happens when the PR is merged.
      * @default false
      */
-    autoMerge?: boolean | Record<string, boolean>;
+    autoPromote?: boolean | Record<string, boolean>;
     /**
      * Git merge method for auto-merge operations.
      * - 'auto': Use fast-forward when possible, merge otherwise
@@ -168,57 +189,46 @@ export interface PipecraftConfig {
     domains: Record<string, DomainConfig>;
     /**
      * Package manager used for dependency installation.
-     * Auto-detected during init based on lockfile presence.
-     *
-     * - 'npm': Uses npm (with package-lock.json)
-     * - 'yarn': Uses yarn (with yarn.lock)
-     * - 'pnpm': Uses pnpm (with pnpm-lock.yaml)
      *
-     * @default 'npm'
+     * @deprecated This field is no longer used by PipeCraft workflows.
+     * It was originally intended for JavaScript/Node.js projects but
+     * PipeCraft now supports language-agnostic workflows. Existing
+     * configs with this field will continue to work, but it has no effect.
      */
     packageManager?: 'npm' | 'yarn' | 'pnpm';
     /**
-     * Nx monorepo integration configuration.
-     * When enabled, PipeCraft generates workflows that leverage Nx's dependency graph
-     * and affected detection for intelligent change-based testing.
+     * How workflows should reference PipeCraft actions.
      *
+     * - 'local': Actions copied to ./.github/actions/ (default, full control)
+     * - 'remote': Reference published marketplace actions (e.g., the-craftlab/pipecraft/actions/detect-changes@v1)
+     * - 'source': Use ./actions/ from repo root (internal use only, for PipeCraft's own CI)
+     *
+     * @default 'local'
      * @example
      * ```typescript
-     * nx: {
-     *   enabled: true,
-     *   tasks: ['lint', 'test', 'build', 'integration-test'],
-     *   baseRef: 'origin/main'
-     * }
+     * // User repos (local mode)
+     * actionSourceMode: 'local'
+     * // Generates: uses: ./.github/actions/detect-changes
+     *
+     * // User repos (remote mode)
+     * actionSourceMode: 'remote'
+     * actionVersion: 'v1.2.3'
+     * // Generates: uses: the-craftlab/pipecraft/actions/detect-changes@v1.2.3
+     *
+     * // PipeCraft repo only (source mode)
+     * actionSourceMode: 'source'
+     * // Generates: uses: ./actions/detect-changes
      * ```
      */
-    nx?: {
-        /**
-         * Whether Nx integration is enabled for this project.
-         * Auto-detected if nx.json exists in project root.
-         */
-        enabled: boolean;
-        /**
-         * Ordered list of Nx tasks to run sequentially.
-         * Tasks are executed using `nx affected --target=<task>`.
-         *
-         * @example ['lint', 'test', 'build', 'e2e']
-         */
-        tasks: string[];
-        /**
-         * Base git reference for affected detection.
-         * Used in `nx affected --base=<baseRef>`.
-         *
-         * @default 'origin/main'
-         */
-        baseRef?: string;
-        /**
-         * Whether to include Nx cache management in workflows.
-         * Speeds up subsequent runs by caching build outputs.
-         *
-         * @default true
-         */
-        enableCache?: boolean;
-    };
+    actionSourceMode?: 'local' | 'remote' | 'source';
+    /**
+     * Version/tag to use when actionSourceMode is 'remote'.
+     * Pins workflows to a specific marketplace action version.
+     *
+     * @example 'v1.2.3', 'v1', 'main'
+     * @default 'v1'
+     */
+    actionVersion?: string;
     /**
      * Idempotency and rebuild configuration.
      * Controls when workflows should be regenerated based on config/template changes.
@@ -286,8 +296,9 @@ export interface PipecraftConfig {
         changelog: boolean;
         /**
          * Mapping of commit types to version bump levels.
+         * @deprecated Use semver.bumpRules instead. This field is ignored if semver.bumpRules is present.
          */
-        bumpRules: Record<string, string>;
+        bumpRules?: Record<string, string>;
     };
 }
 /**
@@ -334,6 +345,7 @@ export interface PipecraftContext {
     domains: Record<string, {
         paths: string[];
         description: string;
+        prefixes?: string[];
         testable?: boolean;
         deployable?: boolean;
         remoteTestable?: boolean;

package/dist/types/index.d.ts.map

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