@catladder/cli 5.6.0 → 5.7.0

package/dist/packages/pipeline/src/backends/gitlab/createGitlabPipeline.js

@@ -1,20 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createGitlabPipelineWithDefaults = void 0;
+exports.createGitlabPipelineWithDefaults = exports.DEFAULT_PIPELINE_IMAGE = void 0;
 const bash_1 = require("../../../../bash/src/index.js");
 const autoStop_1 = require("../../autoStop");
+const reviewApps_1 = require("../../reviewApps");
 const rules_1 = require("../../rules");
 /**
  * gitlab requires a top-level default image for jobs that don't set their
  * own. Every catladder-generated job sets an explicit image, so this
- * fallback is never actually pulled — it just needs to be a valid,
+ * fallback is never pulled for them — it just needs to be a valid,
  * build-free image (a catladder job image would drag in a build job).
+ * Trivial jobs (the review deploy switch) reuse it explicitly.
  */
-const DEFAULT_PIPELINE_IMAGE = "node:22";
-const createGitlabPipelineWithDefaults = ({ image, variables, before_script, branchPipelines = [], autoStop, ...config }) => {
+exports.DEFAULT_PIPELINE_IMAGE = "node:22";
+const createGitlabPipelineWithDefaults = ({ image, variables, before_script, branchPipelines = [], autoStop, reviewApps, ...config }) => {
     const pinLabel = autoStop && autoStop.pinLabel;
     return {
-        image: image !== null && image !== void 0 ? image : DEFAULT_PIPELINE_IMAGE,
+        image: image !== null && image !== void 0 ? image : exports.DEFAULT_PIPELINE_IMAGE,
         variables: {
             FF_USE_FASTZIP: "true", // enable fastzip - a faster zip implementation that also supports level configuration.
             ARTIFACT_COMPRESSION_LEVEL: "fast", // we value speed over compression
@@ -52,6 +54,16 @@ const createGitlabPipelineWithDefaults = ({ image, variables, before_script, bra
                         PIPELINE_NAME: "Thinking...",
                     },
                 },
+                // reviewApps.drafts: "skip" — draft MRs get no pipeline (rules
+                // stop at the first match, so this must come first)
+                ...((reviewApps === null || reviewApps === void 0 ? void 0 : reviewApps.drafts) === "skip"
+                    ? [
+                        {
+                            if: `${rules_1.RULE_IS_MERGE_REQUEST.if} && ${reviewApps_1.GITLAB_DRAFT_MR_CONDITION}`,
+                            when: "never",
+                        },
+                    ]
+                    : []),
                 // pinned MRs (rules stop at the first match, so this must come
                 // before the plain merge-request rule)
                 ...(pinLabel

package/dist/packages/pipeline/src/backends/gitlab/createGitlabPipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"createGitlabPipeline.js","sourceRoot":"","sources":["../../../../../../../../packages/pipeline/src/backends/gitlab/createGitlabPipeline.ts"],"names":[],"mappings":";;;AACA,0CAAwD;AACxD,6CAIwB;AACxB,uCAIqB;AAGrB;;;;;GAKG;AACH,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAElC,MAAM,gCAAgC,GAAG,CAAC,EAC/C,KAAK,EACL,SAAS,EACT,aAAa,EACb,eAAe,GAAG,EAAE,EACpB,QAAQ,EACR,GAAG,MAAM,EAQV,EAAsB,EAAE;IACvB,MAAM,QAAQ,GAAG,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAC/C,OAAO;QACL,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,sBAAsB;QACtC,SAAS,EAAE;YACT,cAAc,EAAE,MAAM,EAAE,uFAAuF;YAC/G,0BAA0B,EAAE,MAAM,EAAE,kCAAkC;YACtE,uBAAuB,EAAE,MAAM,EAAE,gCAAgC;YACjE,wBAAwB,EAAE,IAAI,EAAE,0EAA0E;YAE1G,SAAS,EAAE,GAAG,EAAE,yBAAyB;YACzC,0DAA0D;YAC1D,0DAA0D;YAC1D,4CAA4C;YAC5C,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,oCAAyB,CAAC,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,EAAE,CAAC;SACrB;QACD,aAAa,EAAE;YACb,GAAG,CAAC,GAAG,4BAAqB,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACpD,MAAM,CAAC,cAAc,EAAE,CACxB;YACD,GAAG,CAAC,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,EAAE,CAAC;SACzB;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,+BAA+B;YACrC,kEAAkE;YAClE,iEAAiE;YACjE,+DAA+D;YAC/D,gEAAgE;YAChE,wCAAwC;YACxC,yDAAyD;YACzD,gEAAgE;YAChE,WAAW,EAAE,EAAE,aAAa,EAAE,eAAe,EAAE;YAC/C,KAAK,EAAE;gBACL;oBACE,EAAE,EAAE,mCAAmC;oBACvC,6DAA6D;oBAC7D,6BAA6B;oBAC7B,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;oBACtC,SAAS,EAAE;wBACT,aAAa,EAAE,IAAI;wBACnB,aAAa,EAAE,aAAa;qBAC7B;iBACF;gBACD,+DAA+D;gBAC/D,uCAAuC;gBACvC,GAAG,CAAC,QAAQ;oBACV,CAAC,CAAC;wBACE;4BACE,EAAE,EAAE,GAAG,6BAAqB,CAAC,EAAE,oCAAoC,IAAA,iCAAsB,EAAC,QAAQ,CAAC,GAAG;4BACtG,SAAS,EAAE;gCACT,aAAa,EAAE,MAAM;gCACrB,aAAa,EACX,mDAAmD;gCACrD,CAAC,oCAAyB,CAAC,EAAE,OAAO;6BACrC;yBACF;qBACF;oBACH,CAAC,CAAC,EAAE,CAAC;gBACP;oBACE,EAAE,EAAE,6BAAqB,CAAC,EAAE;oBAC5B,SAAS,EAAE;wBACT,aAAa,EAAE,MAAM;wBACrB,aAAa,EAAE,mDAAmD;qBACnE;iBACF;gBACD;oBACE,EAAE,EAAE,8BAAsB,CAAC,EAAE;oBAC7B,8DAA8D;oBAC9D,0DAA0D;oBAC1D,4DAA4D;oBAC5D,oCAAoC;oBACpC,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;oBACtC,SAAS,EAAE;wBACT,aAAa,EAAE,MAAM;wBACrB,aAAa,EAAE,wBAAwB;qBACxC;iBACF;gBACD;oBACE,EAAE,EAAE,kDAA0C,CAAC,EAAE;oBACjD,SAAS,EAAE;wBACT,aAAa,EAAE,MAAM;wBACrB,aAAa,EAAE,yBAAyB;qBACzC;iBACF;gBACD,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBAClC,EAAE,EAAE,yBAAyB,MAAM,GAAG;oBACtC,SAAS,EAAE;wBACT,aAAa,EAAE,MAAM;wBACrB,aAAa,EAAE,GAAG,MAAM,qBAAqB;qBAC9C;iBACF,CAAC,CAAC;gBAEH;oBACE,IAAI,EAAE,QAAQ,EAAE,WAAW;oBAC3B,SAAS,EAAE;wBACT,aAAa,EAAE,KAAK;wBACpB,aAAa,EAAE,SAAS;qBACzB;iBACF;aACF;SACF;QAED,GAAG,MAAM;KACV,CAAC;AACJ,CAAC,CAAC;AAvHW,QAAA,gCAAgC,oCAuH3C"}
+{"version":3,"file":"createGitlabPipeline.js","sourceRoot":"","sources":["../../../../../../../../packages/pipeline/src/backends/gitlab/createGitlabPipeline.ts"],"names":[],"mappings":";;;AACA,0CAAwD;AACxD,6CAIwB;AACxB,iDAG0B;AAC1B,uCAIqB;AAGrB;;;;;;GAMG;AACU,QAAA,sBAAsB,GAAG,SAAS,CAAC;AAEzC,MAAM,gCAAgC,GAAG,CAAC,EAC/C,KAAK,EACL,SAAS,EACT,aAAa,EACb,eAAe,GAAG,EAAE,EACpB,QAAQ,EACR,UAAU,EACV,GAAG,MAAM,EASV,EAAsB,EAAE;IACvB,MAAM,QAAQ,GAAG,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAC/C,OAAO;QACL,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,8BAAsB;QACtC,SAAS,EAAE;YACT,cAAc,EAAE,MAAM,EAAE,uFAAuF;YAC/G,0BAA0B,EAAE,MAAM,EAAE,kCAAkC;YACtE,uBAAuB,EAAE,MAAM,EAAE,gCAAgC;YACjE,wBAAwB,EAAE,IAAI,EAAE,0EAA0E;YAE1G,SAAS,EAAE,GAAG,EAAE,yBAAyB;YACzC,0DAA0D;YAC1D,0DAA0D;YAC1D,4CAA4C;YAC5C,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,oCAAyB,CAAC,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,EAAE,CAAC;SACrB;QACD,aAAa,EAAE;YACb,GAAG,CAAC,GAAG,4BAAqB,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACpD,MAAM,CAAC,cAAc,EAAE,CACxB;YACD,GAAG,CAAC,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,EAAE,CAAC;SACzB;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,+BAA+B;YACrC,kEAAkE;YAClE,iEAAiE;YACjE,+DAA+D;YAC/D,gEAAgE;YAChE,wCAAwC;YACxC,yDAAyD;YACzD,gEAAgE;YAChE,WAAW,EAAE,EAAE,aAAa,EAAE,eAAe,EAAE;YAC/C,KAAK,EAAE;gBACL;oBACE,EAAE,EAAE,mCAAmC;oBACvC,6DAA6D;oBAC7D,6BAA6B;oBAC7B,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;oBACtC,SAAS,EAAE;wBACT,aAAa,EAAE,IAAI;wBACnB,aAAa,EAAE,aAAa;qBAC7B;iBACF;gBACD,+DAA+D;gBAC/D,oDAAoD;gBACpD,GAAG,CAAC,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,MAAM,MAAK,MAAM;oBAC/B,CAAC,CAAC;wBACE;4BACE,EAAE,EAAE,GAAG,6BAAqB,CAAC,EAAE,OAAO,sCAAyB,EAAE;4BACjE,IAAI,EAAE,OAAgB;yBACvB;qBACF;oBACH,CAAC,CAAC,EAAE,CAAC;gBACP,+DAA+D;gBAC/D,uCAAuC;gBACvC,GAAG,CAAC,QAAQ;oBACV,CAAC,CAAC;wBACE;4BACE,EAAE,EAAE,GAAG,6BAAqB,CAAC,EAAE,oCAAoC,IAAA,iCAAsB,EAAC,QAAQ,CAAC,GAAG;4BACtG,SAAS,EAAE;gCACT,aAAa,EAAE,MAAM;gCACrB,aAAa,EACX,mDAAmD;gCACrD,CAAC,oCAAyB,CAAC,EAAE,OAAO;6BACrC;yBACF;qBACF;oBACH,CAAC,CAAC,EAAE,CAAC;gBACP;oBACE,EAAE,EAAE,6BAAqB,CAAC,EAAE;oBAC5B,SAAS,EAAE;wBACT,aAAa,EAAE,MAAM;wBACrB,aAAa,EAAE,mDAAmD;qBACnE;iBACF;gBACD;oBACE,EAAE,EAAE,8BAAsB,CAAC,EAAE;oBAC7B,8DAA8D;oBAC9D,0DAA0D;oBAC1D,4DAA4D;oBAC5D,oCAAoC;oBACpC,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;oBACtC,SAAS,EAAE;wBACT,aAAa,EAAE,MAAM;wBACrB,aAAa,EAAE,wBAAwB;qBACxC;iBACF;gBACD;oBACE,EAAE,EAAE,kDAA0C,CAAC,EAAE;oBACjD,SAAS,EAAE;wBACT,aAAa,EAAE,MAAM;wBACrB,aAAa,EAAE,yBAAyB;qBACzC;iBACF;gBACD,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBAClC,EAAE,EAAE,yBAAyB,MAAM,GAAG;oBACtC,SAAS,EAAE;wBACT,aAAa,EAAE,MAAM;wBACrB,aAAa,EAAE,GAAG,MAAM,qBAAqB;qBAC9C;iBACF,CAAC,CAAC;gBAEH;oBACE,IAAI,EAAE,QAAQ,EAAE,WAAW;oBAC3B,SAAS,EAAE;wBACT,aAAa,EAAE,KAAK;wBACpB,aAAa,EAAE,SAAS;qBACzB;iBACF;aACF;SACF;QAED,GAAG,MAAM;KACV,CAAC;AACJ,CAAC,CAAC;AAnIW,QAAA,gCAAgC,oCAmI3C"}

package/dist/packages/pipeline/src/backends/gitlab/reviewDeployGate.d.ts

@@ -0,0 +1,26 @@
+import type { AllCatladderJobs } from "../../pipeline/createAllJobs";
+import { type ResolvedReviewAppsConfig } from "../../reviewApps";
+import type { GitlabJobDef } from "../../types";
+export declare const REVIEW_DEPLOY_GATE_JOB_NAME = "\uD83D\uDE80 deploy review";
+/**
+ * the review deploy switch of a merge request (see reviewApps.ts): ONE
+ * job per MR pipeline that unlocks the delivery chains (docker → deploy
+ * → verify) of all components' review apps, instead of a manual job per
+ * component — or a docker build per component in every pipeline.
+ *
+ * The chain heads `needs` the switch. It is a no-op job with
+ * `allow_failure: true`: while it is unplayed, gitlab marks its
+ * dependents skipped and the pipeline still passes ("Pipelines must
+ * succeed" keeps working); playing it resets them to created, so it
+ * can be played any time — early clicks wait for the builds and tests
+ * like the chains always did (the same mechanism as the release
+ * button).
+ *
+ * The label/draft policy decides whether it starts on its own. Label
+ * changes only apply to the next pipeline (gitlab doesn't start one for
+ * them) — `catladder mr review-app-on` sets the label and triggers one.
+ *
+ * Mutates the needs of the gated jobs; returns the switch job, or
+ * nothing when review deploys aren't gated (or nothing deploys).
+ */
+export declare const addGitlabReviewDeployGate: (allJobs: AllCatladderJobs, reviewApps: ResolvedReviewAppsConfig) => GitlabJobDef | undefined;

package/dist/packages/pipeline/src/backends/gitlab/reviewDeployGate.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addGitlabReviewDeployGate = exports.REVIEW_DEPLOY_GATE_JOB_NAME = void 0;
+const reviewApps_1 = require("../../reviewApps");
+const rules_1 = require("../../rules");
+const createGitlabPipeline_1 = require("./createGitlabPipeline");
+exports.REVIEW_DEPLOY_GATE_JOB_NAME = "🚀 deploy review";
+/**
+ * the review deploy switch of a merge request (see reviewApps.ts): ONE
+ * job per MR pipeline that unlocks the delivery chains (docker → deploy
+ * → verify) of all components' review apps, instead of a manual job per
+ * component — or a docker build per component in every pipeline.
+ *
+ * The chain heads `needs` the switch. It is a no-op job with
+ * `allow_failure: true`: while it is unplayed, gitlab marks its
+ * dependents skipped and the pipeline still passes ("Pipelines must
+ * succeed" keeps working); playing it resets them to created, so it
+ * can be played any time — early clicks wait for the builds and tests
+ * like the chains always did (the same mechanism as the release
+ * button).
+ *
+ * The label/draft policy decides whether it starts on its own. Label
+ * changes only apply to the next pipeline (gitlab doesn't start one for
+ * them) — `catladder mr review-app-on` sets the label and triggers one.
+ *
+ * Mutates the needs of the gated jobs; returns the switch job, or
+ * nothing when review deploys aren't gated (or nothing deploys).
+ */
+const addGitlabReviewDeployGate = (allJobs, reviewApps) => {
+    var _a;
+    if (!(0, reviewApps_1.isReviewDeployGated)(reviewApps)) {
+        return undefined;
+    }
+    let gated = false;
+    for (const { context, jobs } of allJobs.components) {
+        for (const job of jobs) {
+            // the chain heads: verify follows its deploy anyway
+            if ((0, reviewApps_1.isReviewDeliveryJob)(context, job) && job.stage !== "verify") {
+                job.needs = [
+                    ...((_a = job.needs) !== null && _a !== void 0 ? _a : []),
+                    { job: exports.REVIEW_DEPLOY_GATE_JOB_NAME, artifacts: false, global: true },
+                ];
+                gated = true;
+            }
+        }
+    }
+    if (!gated) {
+        return undefined;
+    }
+    const isMr = rules_1.RULE_IS_MERGE_REQUEST.if;
+    const manual = { when: "manual", allow_failure: true };
+    const auto = { when: "on_success" };
+    const policyRules = reviewApps.deploy === "optIn"
+        ? [
+            {
+                if: `${isMr} && $CI_MERGE_REQUEST_LABELS =~ ${(0, reviewApps_1.getGitlabLabelRegex)(reviewApps.label)}`,
+                ...auto,
+            },
+            { if: isMr, ...manual },
+        ]
+        : reviewApps.deploy === "optOut"
+            ? [
+                {
+                    if: `${isMr} && $CI_MERGE_REQUEST_LABELS =~ ${(0, reviewApps_1.getGitlabLabelRegex)(reviewApps.skipLabel)}`,
+                    ...manual,
+                },
+                { if: isMr, ...auto },
+            ]
+            : reviewApps.deploy === "manual"
+                ? [{ if: isMr, ...manual }]
+                : [{ if: isMr, ...auto }];
+    return {
+        stage: "setup",
+        image: createGitlabPipeline_1.DEFAULT_PIPELINE_IMAGE,
+        variables: { GIT_STRATEGY: "none" },
+        needs: [],
+        interruptible: true,
+        allow_failure: true,
+        script: [
+            `echo "review apps unlocked — the docker → deploy → verify chains of all components run as soon as their builds and tests succeeded"`,
+        ],
+        rules: [
+            rules_1.RULE_NEVER_ON_AGENT_TRIGGER,
+            // drafts never deploy on their own (drafts: "skip" has no
+            // pipeline at all, see the workflow rules)
+            ...(reviewApps.drafts !== "likeReady"
+                ? [{ if: `${isMr} && ${reviewApps_1.GITLAB_DRAFT_MR_CONDITION}`, ...manual }]
+                : []),
+            ...policyRules,
+        ],
+    };
+};
+exports.addGitlabReviewDeployGate = addGitlabReviewDeployGate;
+//# sourceMappingURL=reviewDeployGate.js.map

package/dist/packages/pipeline/src/backends/gitlab/reviewDeployGate.js.map

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

package/dist/packages/pipeline/src/deploy/base/deploy.js

@@ -7,6 +7,7 @@ const jobs_1 = require("../../types/jobs");
 const utils_1 = require("../utils");
 const autoStop_1 = require("../../autoStop");
 const stop_1 = require("./stop");
+const reviewApps_1 = require("../../reviewApps");
 const variables_1 = require("./variables");
 exports.DEPLOY_JOB_NAME = "🚀 Deploy";
 class DeployJob extends jobs_1.CatladderJob {
@@ -43,9 +44,15 @@ class DeployJob extends jobs_1.CatladderJob {
             : ((_b = context.componentConfig.env) === null || _b === void 0 ? void 0 : _b.stage) === false
                 ? "auto" // is prod, but no staging, auto deploy
                 : "manual"; // manually deploy
-        const whenDeploy = whenDeployDefined
-            ? whenDeployDefined
-            : whenDeployDefault;
+        // gated review apps: one switch per MR/PR unlocks the whole delivery
+        // chain (see reviewApps.ts), the deploy itself then runs on its own
+        const isGatedReviewApp = context.environment.instance.type === "review" &&
+            (0, reviewApps_1.isReviewDeployGated)((0, reviewApps_1.getReviewAppsConfig)(context.fullConfig));
+        const whenDeploy = isGatedReviewApp
+            ? "auto"
+            : whenDeployDefined
+                ? whenDeployDefined
+                : whenDeployDefault;
         // wait for the deployment of other components first
         const waitForRequirements = (_d = (_c = deployConfig === null || deployConfig === void 0 ? void 0 : deployConfig.waitFor) === null || _c === void 0 ? void 0 : _c.map((c) => ({
             capability: "deployment",

package/dist/packages/pipeline/src/deploy/base/deploy.js.map

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

package/dist/packages/pipeline/src/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./pipeline";
 export * from "./autoStop";
+export * from "./reviewApps";
 export * from "./backends";
 export * from "./types";
 export * from "./rules";

package/dist/packages/pipeline/src/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./pipeline"), exports);
 __exportStar(require("./autoStop"), exports);
+__exportStar(require("./reviewApps"), exports);
 __exportStar(require("./backends"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./rules"), exports);

package/dist/packages/pipeline/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/pipeline/src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B;AAC3B,6CAA2B;AAC3B,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,+DAA6C;AAC7C,+DAA6C;AAC7C,2CAAyB;AACzB,0CAAwB;AACxB,4CAA0B;AAC1B,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,kDAAgC;AAChC,4CAA0B;AAC1B,qDAAmC;AACnC,sDAAoC;AACpC,kDAAgC;AAChC,2CAAyB;AACzB,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/pipeline/src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B;AAC3B,+CAA6B;AAC7B,6CAA2B;AAC3B,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,+DAA6C;AAC7C,+DAA6C;AAC7C,2CAAyB;AACzB,0CAAwB;AACxB,4CAA0B;AAC1B,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,kDAAgC;AAChC,4CAA0B;AAC1B,qDAAmC;AACnC,sDAAoC;AACpC,kDAAgC;AAChC,2CAAyB;AACzB,gDAA8B"}

package/dist/packages/pipeline/src/pipeline/resolveRequirements.d.ts

@@ -1,4 +1,6 @@
+import type { CapabilityName, CatladderJob } from "../types/jobs";
 import type { AllCatladderJobs } from "./createAllJobs";
+export declare const providesCapability: (job: CatladderJob, capability: CapabilityName) => boolean;
 /**
  * the planner: resolves the semantic `requires` declarations of all jobs
  * to concrete job dependencies (`needs`), now that all jobs of the

package/dist/packages/pipeline/src/pipeline/resolveRequirements.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveRequirements = void 0;
+exports.resolveRequirements = exports.providesCapability = void 0;
 /**
  * jobs that don't declare `provides` get a capability derived from
  * their stage. This keeps e.g. custom jobs in the test stage acting
@@ -31,6 +31,7 @@ const providesCapability = (job, capability) => {
             ((_a = CAPABILITY_IMPLICATIONS[c]) !== null && _a !== void 0 ? _a : []).includes(capability);
     });
 };
+exports.providesCapability = providesCapability;
 /**
  * the planner: resolves the semantic `requires` declarations of all jobs
  * to concrete job dependencies (`needs`), now that all jobs of the
@@ -72,7 +73,7 @@ const expandRequirement = (context, job, requirement, allJobs) => {
                 c.context.env === env;
         })
             .flatMap((c) => c.jobs);
-    const providers = candidates.filter((candidate) => candidate !== job && providesCapability(candidate, capability));
+    const providers = candidates.filter((candidate) => candidate !== job && (0, exports.providesCapability)(candidate, capability));
     // consuming artifacts from nobody is almost always a broken config
     const isStrict = (_b = strict !== null && strict !== void 0 ? strict : artifacts) !== null && _b !== void 0 ? _b : false;
     if (isStrict && providers.length === 0) {

package/dist/packages/pipeline/src/pipeline/resolveRequirements.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveRequirements.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/pipeline/resolveRequirements.ts"],"names":[],"mappings":";;;AAUA;;;;GAIG;AACH,MAAM,0BAA0B,GAA+C;IAC7E,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,aAAa;IACnB,YAAY,EAAE,aAAa;IAC3B,MAAM,EAAE,YAAY;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,uBAAuB,GAEzB;IACF,cAAc,EAAE,CAAC,OAAO,CAAC;IACzB,WAAW,EAAE,CAAC,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,GAAiB,EAAE,UAA0B,EAAE,EAAE;;IAC3E,MAAM,YAAY,GAAG,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,MAAA,GAAG,CAAC,QAAQ,mCAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtE,OAAO,QAAQ,CAAC,IAAI,CAClB,CAAC,CAAC,EAAE,EAAE;;QACJ,OAAA,CAAC,KAAK,UAAU;YAChB,CAAC,MAAA,uBAAuB,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;KAAA,CAC1D,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;GAOG;AACI,MAAM,mBAAmB,GAAG,CACjC,OAAyB,EACP,EAAE;IACpB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAC/C,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAC5D,CAAC;IACF,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAC/C,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAC5D,CAAC;IACF,qCAAqC;IAErC,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAZW,QAAA,mBAAmB,uBAY9B;AAEF,MAAM,aAAa,GAAG,CACpB,OAA4C,EAC5C,GAAiB,EACjB,OAAyB,EACzB,EAAE;;IACF,IAAI,CAAC,CAAA,MAAA,GAAG,CAAC,QAAQ,0CAAE,MAAM,CAAA,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CACpD,iBAAiB,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CACtD,CAAC;IACF,kEAAkE;IAClE,oCAAoC;IACpC,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,CAAC,MAAA,GAAG,CAAC,KAAK,mCAAI,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACxB,OAA4C,EAC5C,GAAiB,EACjB,WAAwB,EACxB,OAAyB,EACL,EAAE;;IACtB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAExB,MAAM,aAAa,GACjB,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,mCACf,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAErE,MAAM,UAAU,GAAG,aAAa;QAC9B,CAAC,CAAC,OAAO,CAAC,UAAU;aACf,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,CACjE;aACA,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3B,CAAC,CAAC,OAAO,CAAC,UAAU;aACf,MAAM,CACL,CAAC,CAAC,EAAE,EAAE;;YACJ,OAAA,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,mCAAI,OAAO,CAAC,IAAI,CAAC;gBACpD,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,CAAA;SAAA,CACxB;aACA,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CACjC,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,KAAK,GAAG,IAAI,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,CACjE,CAAC;IAEF,mEAAmE;IACnE,MAAM,QAAQ,GAAG,MAAA,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,SAAS,mCAAI,KAAK,CAAC;IAE9C,IAAI,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,oBAAoB,UAAU,SAAS,GAAG,IACxC,MAAA,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,mCAAI,OAAO,CAAC,IAC9C,mBAAmB,GAAG,CAAC,IAAI,SAAS,OAAO,CAAC,IAAI,IAAI,CACrD,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;;QAChC,OAAA,aAAa;YACX,CAAC,CAAC;gBACE,GAAG,EAAE,QAAQ,CAAC,IAAI;gBAClB,SAAS,EAAE,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,KAAK;gBAC7B,aAAa;aACd;YACH,CAAC,CAAC;gBACE,GAAG,EAAE,QAAQ,CAAC,IAAI;gBAClB,SAAS,EAAE,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,KAAK;gBAC7B,aAAa,EAAE,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,mCAAI,OAAO,CAAC,IAAI;aAC/C,CAAA;KAAA,CACN,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"resolveRequirements.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/pipeline/resolveRequirements.ts"],"names":[],"mappings":";;;AAUA;;;;GAIG;AACH,MAAM,0BAA0B,GAA+C;IAC7E,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,aAAa;IACnB,YAAY,EAAE,aAAa;IAC3B,MAAM,EAAE,YAAY;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,uBAAuB,GAEzB;IACF,cAAc,EAAE,CAAC,OAAO,CAAC;IACzB,WAAW,EAAE,CAAC,OAAO,CAAC;CACvB,CAAC;AAEK,MAAM,kBAAkB,GAAG,CAChC,GAAiB,EACjB,UAA0B,EAC1B,EAAE;;IACF,MAAM,YAAY,GAAG,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,MAAA,GAAG,CAAC,QAAQ,mCAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtE,OAAO,QAAQ,CAAC,IAAI,CAClB,CAAC,CAAC,EAAE,EAAE;;QACJ,OAAA,CAAC,KAAK,UAAU;YAChB,CAAC,MAAA,uBAAuB,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;KAAA,CAC1D,CAAC;AACJ,CAAC,CAAC;AAXW,QAAA,kBAAkB,sBAW7B;AAEF;;;;;;;GAOG;AACI,MAAM,mBAAmB,GAAG,CACjC,OAAyB,EACP,EAAE;IACpB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAC/C,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAC5D,CAAC;IACF,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAC/C,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAC5D,CAAC;IACF,qCAAqC;IAErC,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAZW,QAAA,mBAAmB,uBAY9B;AAEF,MAAM,aAAa,GAAG,CACpB,OAA4C,EAC5C,GAAiB,EACjB,OAAyB,EACzB,EAAE;;IACF,IAAI,CAAC,CAAA,MAAA,GAAG,CAAC,QAAQ,0CAAE,MAAM,CAAA,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CACpD,iBAAiB,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CACtD,CAAC;IACF,kEAAkE;IAClE,oCAAoC;IACpC,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,CAAC,MAAA,GAAG,CAAC,KAAK,mCAAI,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACxB,OAA4C,EAC5C,GAAiB,EACjB,WAAwB,EACxB,OAAyB,EACL,EAAE;;IACtB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAExB,MAAM,aAAa,GACjB,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,mCACf,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAErE,MAAM,UAAU,GAAG,aAAa;QAC9B,CAAC,CAAC,OAAO,CAAC,UAAU;aACf,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,CACjE;aACA,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3B,CAAC,CAAC,OAAO,CAAC,UAAU;aACf,MAAM,CACL,CAAC,CAAC,EAAE,EAAE;;YACJ,OAAA,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,mCAAI,OAAO,CAAC,IAAI,CAAC;gBACpD,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,CAAA;SAAA,CACxB;aACA,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CACjC,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,KAAK,GAAG,IAAI,IAAA,0BAAkB,EAAC,SAAS,EAAE,UAAU,CAAC,CACjE,CAAC;IAEF,mEAAmE;IACnE,MAAM,QAAQ,GAAG,MAAA,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,SAAS,mCAAI,KAAK,CAAC;IAE9C,IAAI,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,oBAAoB,UAAU,SAAS,GAAG,IACxC,MAAA,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,mCAAI,OAAO,CAAC,IAC9C,mBAAmB,GAAG,CAAC,IAAI,SAAS,OAAO,CAAC,IAAI,IAAI,CACrD,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;;QAChC,OAAA,aAAa;YACX,CAAC,CAAC;gBACE,GAAG,EAAE,QAAQ,CAAC,IAAI;gBAClB,SAAS,EAAE,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,KAAK;gBAC7B,aAAa;aACd;YACH,CAAC,CAAC;gBACE,GAAG,EAAE,QAAQ,CAAC,IAAI;gBAClB,SAAS,EAAE,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,KAAK;gBAC7B,aAAa,EAAE,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,mCAAI,OAAO,CAAC,IAAI;aAC/C,CAAA;KAAA,CACN,CAAC;AACJ,CAAC,CAAC"}

package/dist/packages/pipeline/src/reviewApps.d.ts

@@ -0,0 +1,38 @@
+import { type ResolvedReviewAppsConfig } from "./reviewAppsPolicy";
+import type { Config } from "./types";
+import type { Context } from "./types/context";
+import type { CatladderJob } from "./types/jobs";
+export * from "./reviewAppsPolicy";
+export declare const getReviewAppsConfig: (config: Config) => ResolvedReviewAppsConfig;
+/**
+ * whether the review deploys sit behind the per-MR/PR deploy switch
+ * instead of running in every pipeline
+ */
+export declare const isReviewDeployGated: (config: ResolvedReviewAppsConfig) => boolean;
+/**
+ * the label whose change switches the review apps on (`labeled` on
+ * opt-in, `unlabeled` on opt-out) or off (the inverse), if the mode is
+ * label-driven at all
+ */
+export declare const getReviewAppsSwitchLabel: (config: ResolvedReviewAppsConfig) => {
+    label: string;
+    deployOn: "labeled" | "unlabeled";
+    stopOn: string;
+} | undefined;
+/**
+ * gitlab: matches a label inside `$CI_MERGE_REQUEST_LABELS`
+ * (comma-separated) — anchored so `x` never matches `no-x`
+ */
+export declare const getGitlabLabelRegex: (label: string) => string;
+/**
+ * gitlab: a draft MR, by its title prefix — the only draft signal every
+ * gitlab version exposes to rules
+ */
+export declare const GITLAB_DRAFT_MR_CONDITION = "$CI_MERGE_REQUEST_TITLE =~ /^\\s*(\\[draft\\]|\\(draft\\)|draft:)/i";
+/**
+ * whether a job belongs to the delivery chain of a review app — the
+ * docker image, the deploy and the post-deploy verification. These jobs
+ * sit behind the review deploy switch; quality jobs (lint, test, audit)
+ * and the app build never do.
+ */
+export declare const isReviewDeliveryJob: (context: Context, job: CatladderJob) => boolean;

package/dist/packages/pipeline/src/reviewApps.js

@@ -0,0 +1,86 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isReviewDeliveryJob = exports.GITLAB_DRAFT_MR_CONDITION = exports.getGitlabLabelRegex = exports.getReviewAppsSwitchLabel = exports.isReviewDeployGated = exports.getReviewAppsConfig = void 0;
+const autoStop_1 = require("./autoStop");
+const reviewAppsPolicy_1 = require("./reviewAppsPolicy");
+__exportStar(require("./reviewAppsPolicy"), exports);
+const getReviewAppsConfig = (config) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    return ({
+        deploy: (_b = (_a = config.reviewApps) === null || _a === void 0 ? void 0 : _a.deploy) !== null && _b !== void 0 ? _b : "auto",
+        // single colon on purpose: gitlab treats `a::b` labels as scoped and
+        // mutually exclusive, which would make this label and the
+        // `catladder::pin-review` pin label displace each other
+        label: (_d = (_c = config.reviewApps) === null || _c === void 0 ? void 0 : _c.label) !== null && _d !== void 0 ? _d : reviewAppsPolicy_1.DEFAULT_REVIEW_APP_LABEL,
+        skipLabel: (_f = (_e = config.reviewApps) === null || _e === void 0 ? void 0 : _e.skipLabel) !== null && _f !== void 0 ? _f : reviewAppsPolicy_1.DEFAULT_NO_REVIEW_APP_LABEL,
+        drafts: (_h = (_g = config.reviewApps) === null || _g === void 0 ? void 0 : _g.drafts) !== null && _h !== void 0 ? _h : "likeReady",
+    });
+};
+exports.getReviewAppsConfig = getReviewAppsConfig;
+/**
+ * whether the review deploys sit behind the per-MR/PR deploy switch
+ * instead of running in every pipeline
+ */
+const isReviewDeployGated = (config) => config.deploy !== "auto" || config.drafts === "checksOnly";
+exports.isReviewDeployGated = isReviewDeployGated;
+/**
+ * the label whose change switches the review apps on (`labeled` on
+ * opt-in, `unlabeled` on opt-out) or off (the inverse), if the mode is
+ * label-driven at all
+ */
+const getReviewAppsSwitchLabel = (config) => {
+    switch (config.deploy) {
+        case "optIn":
+            return { label: config.label, deployOn: "labeled", stopOn: "unlabeled" };
+        case "optOut":
+            return {
+                label: config.skipLabel,
+                deployOn: "unlabeled",
+                stopOn: "labeled",
+            };
+        default:
+            return undefined;
+    }
+};
+exports.getReviewAppsSwitchLabel = getReviewAppsSwitchLabel;
+/**
+ * gitlab: matches a label inside `$CI_MERGE_REQUEST_LABELS`
+ * (comma-separated) — anchored so `x` never matches `no-x`
+ */
+const getGitlabLabelRegex = (label) => `/${(0, autoStop_1.getPinLabelRegexSource)(label)}/`;
+exports.getGitlabLabelRegex = getGitlabLabelRegex;
+/**
+ * gitlab: a draft MR, by its title prefix — the only draft signal every
+ * gitlab version exposes to rules
+ */
+exports.GITLAB_DRAFT_MR_CONDITION = "$CI_MERGE_REQUEST_TITLE =~ /^\\s*(\\[draft\\]|\\(draft\\)|draft:)/i";
+/**
+ * whether a job belongs to the delivery chain of a review app — the
+ * docker image, the deploy and the post-deploy verification. These jobs
+ * sit behind the review deploy switch; quality jobs (lint, test, audit)
+ * and the app build never do.
+ */
+const isReviewDeliveryJob = (context, job) => {
+    var _a;
+    return context.type === "component" &&
+        context.environment.instance.type === "review" &&
+        (job.stage === "deploy" ||
+            job.stage === "verify" ||
+            ((_a = job.provides) !== null && _a !== void 0 ? _a : []).includes("dockerImage"));
+};
+exports.isReviewDeliveryJob = isReviewDeliveryJob;
+//# sourceMappingURL=reviewApps.js.map

package/dist/packages/pipeline/src/reviewApps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewApps.js","sourceRoot":"","sources":["../../../../../../packages/pipeline/src/reviewApps.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,yCAAoD;AACpD,yDAI4B;AAK5B,qDAAmC;AAE5B,MAAM,mBAAmB,GAAG,CACjC,MAAc,EACY,EAAE;;IAAC,OAAA,CAAC;QAC9B,MAAM,EAAE,MAAA,MAAA,MAAM,CAAC,UAAU,0CAAE,MAAM,mCAAI,MAAM;QAC3C,qEAAqE;QACrE,0DAA0D;QAC1D,wDAAwD;QACxD,KAAK,EAAE,MAAA,MAAA,MAAM,CAAC,UAAU,0CAAE,KAAK,mCAAI,2CAAwB;QAC3D,SAAS,EAAE,MAAA,MAAA,MAAM,CAAC,UAAU,0CAAE,SAAS,mCAAI,8CAA2B;QACtE,MAAM,EAAE,MAAA,MAAA,MAAM,CAAC,UAAU,0CAAE,MAAM,mCAAI,WAAW;KACjD,CAAC,CAAA;CAAA,CAAC;AAVU,QAAA,mBAAmB,uBAU7B;AAEH;;;GAGG;AACI,MAAM,mBAAmB,GAAG,CAAC,MAAgC,EAAE,EAAE,CACtE,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,CAAC;AADhD,QAAA,mBAAmB,uBAC6B;AAE7D;;;;GAIG;AACI,MAAM,wBAAwB,GAAG,CACtC,MAAgC,EAGpB,EAAE;IACd,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,OAAO;YACV,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC3E,KAAK,QAAQ;YACX,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,SAAS;gBACvB,QAAQ,EAAE,WAAW;gBACrB,MAAM,EAAE,SAAS;aAClB,CAAC;QACJ;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC,CAAC;AAjBW,QAAA,wBAAwB,4BAiBnC;AAEF;;;GAGG;AACI,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAU,EAAE,CAC3D,IAAI,IAAA,iCAAsB,EAAC,KAAK,CAAC,GAAG,CAAC;AAD1B,QAAA,mBAAmB,uBACO;AAEvC;;;GAGG;AACU,QAAA,yBAAyB,GACpC,qEAAqE,CAAC;AAExE;;;;;GAKG;AACI,MAAM,mBAAmB,GAAG,CAAC,OAAgB,EAAE,GAAiB,EAAE,EAAE;;IACzE,OAAA,OAAO,CAAC,IAAI,KAAK,WAAW;QAC5B,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ;QAC9C,CAAC,GAAG,CAAC,KAAK,KAAK,QAAQ;YACrB,GAAG,CAAC,KAAK,KAAK,QAAQ;YACtB,CAAC,MAAA,GAAG,CAAC,QAAQ,mCAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAA;CAAA,CAAC;AALrC,QAAA,mBAAmB,uBAKkB"}

package/dist/packages/pipeline/src/reviewAppsPolicy.d.ts

@@ -0,0 +1,46 @@
+/**
+ * the review-app deploy policy — dependency-free, so catci (the CI
+ * companion bundle) can import it without dragging in the pipeline.
+ */
+/**
+ * when the review apps of a merge request / pull request deploy:
+ * - auto: every MR/PR deploys its review apps (default)
+ * - manual: never on their own — one "deploy review" switch per MR/PR
+ *   (gitlab: a manual job in the pipeline, github: a dispatch workflow)
+ * - optIn: only while the MR/PR carries the `label`
+ * - optOut: unless the MR/PR carries the `skipLabel`
+ */
+export type ReviewAppsDeployMode = "auto" | "manual" | "optIn" | "optOut";
+/**
+ * what a draft MR/PR runs:
+ * - likeReady: the same as a ready one, review apps included (default)
+ * - checksOnly: tests, lint and audit only — the review apps deploy once it is
+ *   marked ready
+ * - skip: no pipeline at all
+ */
+export type ReviewAppsDraftsMode = "likeReady" | "checksOnly" | "skip";
+export declare const DEFAULT_REVIEW_APP_LABEL = "catladder:review-app";
+export declare const DEFAULT_NO_REVIEW_APP_LABEL = "catladder:no-review-app";
+export type ResolvedReviewAppsConfig = {
+    deploy: ReviewAppsDeployMode;
+    label: string;
+    skipLabel: string;
+    drafts: ReviewAppsDraftsMode;
+};
+/**
+ * the state of a merge request / pull request the deploy decision
+ * depends on
+ */
+export type ReviewAppsMrState = {
+    labels: string[];
+    draft: boolean;
+};
+/**
+ * whether the review apps of an MR/PR in the given state deploy
+ * automatically. An explicit request (playing the gate job, dispatching
+ * the deploy workflow) always deploys and doesn't consult this.
+ */
+export declare const shouldAutoDeployReviewApps: (config: ResolvedReviewAppsConfig, { labels, draft }: ReviewAppsMrState) => {
+    deploy: boolean;
+    reason: string;
+};

package/dist/packages/pipeline/src/reviewAppsPolicy.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldAutoDeployReviewApps = exports.DEFAULT_NO_REVIEW_APP_LABEL = exports.DEFAULT_REVIEW_APP_LABEL = void 0;
+exports.DEFAULT_REVIEW_APP_LABEL = "catladder:review-app";
+exports.DEFAULT_NO_REVIEW_APP_LABEL = "catladder:no-review-app";
+/**
+ * whether the review apps of an MR/PR in the given state deploy
+ * automatically. An explicit request (playing the gate job, dispatching
+ * the deploy workflow) always deploys and doesn't consult this.
+ */
+const shouldAutoDeployReviewApps = (config, { labels, draft }) => {
+    if (draft && config.drafts !== "likeReady") {
+        return { deploy: false, reason: "drafts don't deploy review apps" };
+    }
+    switch (config.deploy) {
+        case "auto":
+            return { deploy: true, reason: "review apps deploy automatically" };
+        case "manual":
+            return {
+                deploy: false,
+                reason: "review apps only deploy on request (deploy: manual)",
+            };
+        case "optIn":
+            return labels.includes(config.label)
+                ? { deploy: true, reason: `the '${config.label}' label is set` }
+                : { deploy: false, reason: `the '${config.label}' label is not set` };
+        case "optOut":
+            return labels.includes(config.skipLabel)
+                ? { deploy: false, reason: `the '${config.skipLabel}' label is set` }
+                : {
+                    deploy: true,
+                    reason: `the '${config.skipLabel}' label is not set`,
+                };
+    }
+};
+exports.shouldAutoDeployReviewApps = shouldAutoDeployReviewApps;
+//# sourceMappingURL=reviewAppsPolicy.js.map

package/dist/packages/pipeline/src/reviewAppsPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewAppsPolicy.js","sourceRoot":"","sources":["../../../../../../packages/pipeline/src/reviewAppsPolicy.ts"],"names":[],"mappings":";;;AAuBa,QAAA,wBAAwB,GAAG,sBAAsB,CAAC;AAClD,QAAA,2BAA2B,GAAG,yBAAyB,CAAC;AAkBrE;;;;GAIG;AACI,MAAM,0BAA0B,GAAG,CACxC,MAAgC,EAChC,EAAE,MAAM,EAAE,KAAK,EAAqB,EACC,EAAE;IACvC,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;IACtE,CAAC;IACD,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;QACtE,KAAK,QAAQ;YACX,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,qDAAqD;aAC9D,CAAC;QACJ,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;gBAClC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,MAAM,CAAC,KAAK,gBAAgB,EAAE;gBAChE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,MAAM,CAAC,KAAK,oBAAoB,EAAE,CAAC;QAC1E,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;gBACtC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,MAAM,CAAC,SAAS,gBAAgB,EAAE;gBACrE,CAAC,CAAC;oBACE,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,QAAQ,MAAM,CAAC,SAAS,oBAAoB;iBACrD,CAAC;IACV,CAAC;AACH,CAAC,CAAC;AA3BW,QAAA,0BAA0B,8BA2BrC"}

package/dist/packages/pipeline/src/types/config.d.ts

@@ -11,6 +11,7 @@ import type { CatladderStore } from "../store";
 import type { AgentSkillsConfig } from "../agentSkills/types";
 import type { ProjectImageConfig } from "../customImages/projectImages";
 import type { VerifyConfig } from "../verify/types";
+import type { ReviewAppsDeployMode, ReviewAppsDraftsMode } from "../reviewAppsPolicy";
 export declare const ALL_PIPELINE_TRIGGERS: readonly ["mainBranch", "mr", "taggedRelease"];
 export type PipelineTrigger = (typeof ALL_PIPELINE_TRIGGERS)[number];
 /**
@@ -492,6 +493,60 @@ export type Config<C extends ConfigProps = never> = {
          */
         pinLabel?: string | false;
     };
+    /**
+     * when merge requests / pull requests deploy their review apps —
+     * useful when many MRs/PRs are opened (e.g. by agents) and most of
+     * them don't need a running instance.
+     *
+     * With anything but the defaults, the delivery chain of every
+     * component's review app (docker image → deploy → verify) waits for
+     * ONE switch per MR/PR instead of running in every pipeline; tests,
+     * lint and audit always run:
+     * - gitlab: a `🚀 deploy review` job (manual, or automatic when the
+     *   label policy says so). Label changes only apply to the next
+     *   pipeline — `catladder mr review-app-on/off` sets the label and
+     *   triggers one.
+     * - github: the review workflow decides at its start (labels, draft)
+     *   and deploys in the same run when the policy says so. Later
+     *   changes go through a `▶️ catladder deploy review` workflow,
+     *   dispatched by the review workflow once green (when the policy now
+     *   says deploy), by adding/removing the label, or by hand with the
+     *   PR number. Switching the label off stops the review apps.
+     *
+     * Per-component `deploy.when` of the review env is ignored then — the
+     * switch covers all components.
+     */
+    reviewApps?: {
+        /**
+         * - auto: every MR/PR deploys (default)
+         * - manual: only on request (play the gate job / dispatch the
+         *   workflow)
+         * - optIn: only while the MR/PR carries `label`
+         * - optOut: unless the MR/PR carries `skipLabel`
+         * @defaultValue "auto"
+         */
+        deploy?: ReviewAppsDeployMode;
+        /**
+         * the opt-in label
+         * @defaultValue "catladder:review-app"
+         */
+        label?: string;
+        /**
+         * the opt-out label
+         * @defaultValue "catladder:no-review-app"
+         */
+        skipLabel?: string;
+        /**
+         * what draft MRs/PRs run:
+         * - likeReady: the same as ready ones (default)
+         * - checksOnly: tests, lint and audit — the review apps deploy once the
+         *   MR/PR is marked ready
+         * - skip: nothing (gitlab: marking an MR ready doesn't start a
+         *   pipeline, the next push does)
+         * @defaultValue "likeReady"
+         */
+        drafts?: ReviewAppsDraftsMode;
+    };
     /**
      * additional vars only for the runner in all jobs.
      */

package/dist/packages/pipeline/src/types/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/config.ts"],"names":[],"mappings":";;;AAea,QAAA,qBAAqB,GAAG;IACnC,YAAY;IACZ,IAAI;IACJ,eAAe;CACP,CAAC;AAoBJ,MAAM,eAAe,GAAG,CAC7B,OAA2B,EACO,EAAE,CACpC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,IAAI,OAAO,CAAC;AAH5D,QAAA,eAAe,mBAG6C;AAElE,MAAM,gBAAgB,GAAG,CAC9B,CAA0B,EAC1B,CAAqB,EACZ,EAAE;IACX,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,IAAA,uBAAe,EAAC,CAAC,CAAC;QAAE,OAAO,IAAA,uBAAe,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC,CAAC;AAPW,QAAA,gBAAgB,oBAO3B;AAEF;;;GAGG;AACU,QAAA,SAAS,GAAG;IACvB,GAAG,EAAE;QACH,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,CAAC,eAAe,CAAC;KAC5B;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC,eAAe,CAAC;KAC5B;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,EAAE;KACb;CACO,CAAC;AAEE,QAAA,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAS,CAAC,CAAC;AACtC,QAAA,iBAAiB,GAAG,oBAAyB,CAAC;AAGpD,MAAM,aAAa,GAAG,CAAC,GAAW,EAAkB,EAAE;IAC3D,OAAO,GAAG,IAAI,iBAAS,CAAC;AAC1B,CAAC,CAAC;AAFW,QAAA,aAAa,iBAExB;AAmMF;;;GAGG;AACI,MAAM,oBAAoB,GAAG,CAClC,YAA4C,EAC5C,GAAW,EACoB,EAAE,CAAC,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAG,GAAG,CAAC,KAAI,SAAS,CAAC;AAHxD,QAAA,oBAAoB,wBAGoC;AAE9D,MAAM,qBAAqB,GAAG,CACnC,YAA4C,EAC5C,GAAW,EACF,EAAE,CAAC,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAG,GAAG,CAAC,MAAK,KAAK,CAAC;AAH/B,QAAA,qBAAqB,yBAGU"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/config.ts"],"names":[],"mappings":";;;AAmBa,QAAA,qBAAqB,GAAG;IACnC,YAAY;IACZ,IAAI;IACJ,eAAe;CACP,CAAC;AAoBJ,MAAM,eAAe,GAAG,CAC7B,OAA2B,EACO,EAAE,CACpC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,IAAI,OAAO,CAAC;AAH5D,QAAA,eAAe,mBAG6C;AAElE,MAAM,gBAAgB,GAAG,CAC9B,CAA0B,EAC1B,CAAqB,EACZ,EAAE;IACX,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,IAAA,uBAAe,EAAC,CAAC,CAAC;QAAE,OAAO,IAAA,uBAAe,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC,CAAC;AAPW,QAAA,gBAAgB,oBAO3B;AAEF;;;GAGG;AACU,QAAA,SAAS,GAAG;IACvB,GAAG,EAAE;QACH,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,CAAC,eAAe,CAAC;KAC5B;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC,eAAe,CAAC;KAC5B;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,EAAE;KACb;CACO,CAAC;AAEE,QAAA,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAS,CAAC,CAAC;AACtC,QAAA,iBAAiB,GAAG,oBAAyB,CAAC;AAGpD,MAAM,aAAa,GAAG,CAAC,GAAW,EAAkB,EAAE;IAC3D,OAAO,GAAG,IAAI,iBAAS,CAAC;AAC1B,CAAC,CAAC;AAFW,QAAA,aAAa,iBAExB;AAmMF;;;GAGG;AACI,MAAM,oBAAoB,GAAG,CAClC,YAA4C,EAC5C,GAAW,EACoB,EAAE,CAAC,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAG,GAAG,CAAC,KAAI,SAAS,CAAC;AAHxD,QAAA,oBAAoB,wBAGoC;AAE9D,MAAM,qBAAqB,GAAG,CACnC,YAA4C,EAC5C,GAAW,EACF,EAAE,CAAC,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAG,GAAG,CAAC,MAAK,KAAK,CAAC;AAH/B,QAAA,qBAAqB,yBAGU"}